인덱스 통계 가져오기(미리 보기 REST API)

적용 : 2023-07-01-Preview. 이 버전은 더 이상 지원되지 않습니다. 업그레이드는 즉시 최신 버전으로.

중요하다

2023-07-01-Preview는 vectorIndexSize 인덱스에 추가합니다.

인덱스 통계 가져오기 작업은 현재 인덱스에 대한 문서 수와 인덱스 올업에서 사용되는 총 스토리지 양 및 해당 벡터 데이터에서 사용된 스토리지 양을 반환합니다. 검색 서비스에는 Get Service Statistics보고된 벡터 스토리지의 양에 대한 전체 제한이 있습니다. "vectorIndexSize" 메트릭은 현재 검색 인덱스의 벡터 필드에 사용되는 벡터 스토리지의 양을 알려줍니다.

메모

문서 수 및 스토리지 크기에 대한 통계는 실시간으로 수집되지 않고 몇 분마다 수집됩니다. 따라서 이 API에서 반환된 통계는 최근 인덱싱 작업으로 인한 변경 내용을 반영하지 않을 수 있습니다.

GET https://[service name].search.windows.net/indexes/[index name]/stats?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin key]   

URI 매개 변수

매개 변수	묘사
서비스 이름	필수. 이 값을 검색 서비스의 고유한 사용자 정의 이름으로 설정합니다.
인덱스 이름	필수. 요청 URI는 통계가 반환되어야 하는 인덱스의 이름을 지정합니다.
api-version	필수. 더 많은 버전은 API 버전 참조하세요.

요청 헤더

다음 표에서는 필수 및 선택적 요청 헤더에 대해 설명합니다.

필드	묘사
Content-Type	필수. 이 값을 application/json
api-key	Azure 역할 사용하고 요청에 전달자 토큰이 제공된 경우 선택 사항입니다. 그렇지 않으면 키가 필요합니다. api-key는 검색 서비스에 대한 요청을 인증하는 고유한 시스템 생성 문자열입니다. 개체 정의에 대한 가져오기 요청에는 쿼리 키가 아니라 관리 키로 설정된 api-key 필드가 포함되어야 합니다. 자세한 내용은 키 인증 사용하여 Azure AI Search에 연결을 참조하세요.

요청 본문

없음.

응답

상태 코드: 성공적인 응답을 위해 "200 OK"가 반환됩니다. 응답 본문은 다음과 같은 형식입니다.

{  
  "documentCount": number,  
  "storageSize": number (size of the index in bytes), 
  "vectorIndexSize": number (size of the index in bytes) 
}

인덱스에 벡터 필드가 없으면 "vectorIndexSize"는 0입니다.

참고 항목

• Azure AI Search REST API
• 서비스 제한