이 페이지에서는 Azure AI Search REST API를 사용할 때 자주 반환되는 HTTP 상태 코드에 대해 설명합니다.
일반 HTTP 상태 코드
| 코드 | 설명 |
|---|---|
| 200 OK (요청이 성공적으로 처리되었습니다) | GET, PUT 또는 POST의 성공 성공적인 응답을 위해 반환됩니다. |
| 201 생성됨 | PUT 또는 POST의 성공. 개체를 성공적으로 만들었습니다. |
| 202 수락됨 | PUT 또는 POST의 성공. 이 상태 코드는 실행 인덱서 요청에 대해 반환됩니다. |
| 204 콘텐츠 없음 | PUT 또는 POST의 성공. 업데이트가 성공했지만 응답에 반환할 정보가 없습니다. |
| 206 부분 콘텐츠 | 에이전트 검색 워크플로에서 기술 자료 검색 을 위한 GET 또는 POST에서 부분적으로 성공했습니다. 요청이 성공했지만 검색 또는 순위 지정 프로세스의 중요하지 않은 특정 구성 요소가 실패하여 전체 관련성 점수를 반영하지 않을 수 있는 불완전한 결과 또는 순위가 발생할 때 반환됩니다. |
| 207 다중 상태 | PUT 또는 POST에서 부분적으로 성공했습니다. 일부 문서는 성공했지만 하나 이상의 문서가 실패했습니다. |
| 400 잘못된 요청 | 요청 URI, 헤더 또는 본문에 오류가 있을 때 반환됩니다. 응답 본문에는 특정 문제가 무엇인지 설명하는 오류 메시지가 포함되어 있습니다. |
| 401 권한 없음 | 자격 증명이 누락되면 반환됩니다. 역할 기반 액세스 제어를 사용하는 경우 사용자 또는 검색 서비스에 역할 할당이 없습니다. Azure AI Search에 액세스하는 데 문제가 있는 경우 역할을 사용하여 Azure AI Search에 연결을 참조하세요. 다른 리소스에 대한 검색 연결에 대한 자세한 내용은 관리 ID를 사용하여 연결하도록 검색 서비스 구성을 참조하세요. |
| 402 결제 필요 | 무료 의미 체계 랭커 요청의 월별 할당이 소진되면 반환됩니다. "해당 월의 무료 쿼리 의미 체계 사용량을 초과했습니다. 시맨틱 검색을 계속 사용하려면 시맨틱 청구https://aka.ms/SemanticPriceDocPage"를 활성화하십시오. 오류를 해결하려면 무료 플랜에서 표준 결제로 전환하세요. |
| 403 금지됨 | 권한 부여가 실패할 때 반환됩니다. |
| 404 찾을 수 없음 | 리소스가 서버에 없을 때 반환됩니다. |
| 405 메서드가 지원되지 않음 | 서비스에서 지원되지 않는 메서드를 인식할 때 반환됩니다. 인덱스를 쿼리하는 경우 해당 요청의 공식화에는 엔드포인트, 인덱스 컬렉션 및 인덱스, docs 컬렉션 및 검색 메서드(예: https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01)가 포함됩니다. |
| 409 충돌 | 쓰기 작업이 충돌할 때 반환됩니다. 이 상태 코드는 리소스 업데이트에 대해 반환되거나 두 프로세스가 동일한 문서를 동시에 업데이트하려고 할 때 인덱싱하는 동안 반환됩니다. Azure AI Search는 리소스 업데이트를 위한 동시성 관리를 제공합니다. 자세한 내용은 Azure AI Search에서 동시성을 관리하는 방법을 참조하세요. |
| 412 사전 조건 실패 | If-Match 또는 If-None-Match 헤더의 조건이 false로 평가되면 반환됩니다. 인덱스 정의, 인덱서, 기술 세트 또는 데이터 원본에 대한 HTTP 요청을 보낼 때 낙관적 동시성 제어 를 사용하는 것과 관련이 있습니다. |
| 415 지원되지 않는 미디어 유형 | 이 오류는 CURL이나 커맨드라인 액션을 사용해 객체 정의나 요청에서 JSON 파일을 전달할 때, request 헤더에 application/json의 콘텐츠 타입이 지정되어 있지 않을 때 발생할 수 있습니다. CURL의 경우, 플래그(기본값은 x-www-form-urlencoded)를 사용 -d 한다면, 그 플래그를 (기본값은 application/json)로 --json 대체하거나, -H "Content-Type: application/json". |
| 429 요청이 너무 많음 | 개체를 만드는 동안 이 상태 코드를 가져오는 경우 서비스 계층에 허용되는 최대 개체 수가 있습니다. 활성 인덱스에서 이 오류 코드가 표시되면 일반적으로 스토리지가 부족하다는 의미입니다. 스토리지 한도에 가까워지면 일부 문서를 삭제할 때까지 서비스를 추가하거나 업데이트할 수 없는 상태가 될 수 있습니다. 자세한 내용은 더 많은 스토리지를 원하는 경우 용량 계획 및 관리를 참조하거나 문서를 삭제하여 공간을 확보하려는 경우 콘텐츠를 업데이트 하세요. |
| 499 클라이언트 폐쇄 요청 | 이 상태 코드는 응답에서 반환되지 않지만 검색 트래픽 분석 및 Azure Monitor에서 기록된 로그 항목에 표시될 수 있습니다. 서비스에서 응답을 반환하기 전에 클라이언트가 연결을 닫은 것을 나타냅니다. Azure AI Search가 서비스 쪽 코드에서 요청되지 않았거나 클라이언트가 더 이상 존재하지 않는 취소를 감지하면 499가 기록됩니다. |
| 502 잘못된 게이트웨이 | 이 상태 코드는 연결에서 HTTPS 대신 HTTP를 입력할 때 발생합니다. |
| 503 서비스를 사용할 수 없음 | 이 상태 코드는 시스템이 부하가 많고 요청을 처리할 수 없다는 것을 의미합니다. 완화에는 재시도 논리에 대기 시간을 추가하거나 용량을 늘리는 것이 포함됩니다. 최신 서비스에는 더 많은 스토리지 및 컴퓨팅 성능이 자동으로 제공됩니다. 성능 튜닝에 대한 자세한 내용은 Azure AI Search에서 성능 분석을 참조하세요. |
| 504: 게이트웨이 시간 제한 | Azure AI Search는 HTTPS 포트 443에서 수신 대기합니다. 검색 서비스 URL에 HTTPS 대신 HTTP가 포함된 경우 504 상태 코드가 반환됩니다. |