페이징 구문

API 검색 요청인 HTTP GET에서 반환되는 결과를 제한하기 위해 대부분의 IBM® QRadar® 리소스 목록을 반환하는 API 엔드포인트는 Range 헤더 매개변수를 지원합니다.

Range 매개변수 구문은 이를 지원하는 모든 엔드포인트에 대해 일관됩니다. Range 매개변수가 이에 적용되는지 여부를 판별하려면 엔드포인트에 대한 문서를 참조하십시오. Range 구문에 대한 제한사항이 해당 엔드포인트의 설명에 포함됩니다.

참고: Range 매개변수는 sort, filter및 fields 매개변수와 달리 항상 헤더 매개변수로 전송됩니다. 이러한 매개변수는 일반적으로 조회 매개변수입니다.

기본적으로 대화식 API 문서 페이지에서 Range 매개변수에 대해 처음 50개 레코드만이 리턴됩니다. 엔드포인트의 Range 값을 변경할 수 있습니다. 그러나 큰 결과 세트를 요청하는 경우에는 대화식 API 문서 페이지의 성능에 부정적인 영향을 미칠 수도 있습니다.

Range 헤더 매개변수

페이징 요청은 Range 헤더 매개변수로 지정됩니다. 다음 0으로 인덱싱된 구문을 사용하십시오.

Range: items=x-y

페이징을 사용하는 요청에 대한 응답은 Content-Range 헤더를 포함합니다. 헤더는 다음 형식으로 컨텐츠 범위 내에 리턴된 레코드 수를 표시합니다.

Content-Range: items x-y/total number of records received

예를 들어, 처음 5개 레코드를 리턴하려면 요청 헤더에는 다음 매개변수가 포함됩니다.

"Range: items= 0-4"

해당 요청의 응답 헤더는 다음 정보를 리턴합니다.

Content-Range: items 0-4/5

요청된 범위가 레코드 수를 초과하면 언급된 범위 내의 모든 레코드가 리턴됩니다. 다음 예제에서는 처음 100개 레코드가 요청됩니다.

"Range: items= 0-99"

그러나 총 12개의 레코드만이 있습니다. 응답은 언급된 범위 내의 모든 레코드를 리턴합니다.

Content-Range: items 0-11/12

요청된 범위가 레코드 양의 한계를 넘으면 레코드가 리턴되지 않습니다. 다음 예제에서는 처음 3-5개의 레코드가 요청됩니다.

"Range: items = 3-5"

그러나 3개보다 적은 수의 레코드가 있으므로 레코드가 리턴되지 않습니다.

Content-Range: items */3