HTTP 상태 코드(Azure AI Search)
이 페이지에서는 Azure AI Search API를 사용할 때 자주 반환되는 HTTP 상태 코드에 대해 설명합니다.
일반 HTTP 상태 코드
| 코드 | Description |
|---|---|
| 200 정상 | GET, PUT 또는 POST가 성공했습니다. 성공적인 응답을 위해 반환됩니다. 인덱싱하는 동안 이 코드는 모든 항목이 영구적으로 저장되었으며 인덱싱되기 시작했음을 나타냅니다. 인덱싱은 백그라운드에서 실행되며 인덱싱 작업이 완료된 후 몇 초 후에 새 문서를 쿼리하고 검색할 수 있습니다. |
| 201 생성됨 | PUT 또는 POST가 성공했습니다. 개체를 만들거나 업데이트했습니다. |
| 204 수락됨 | PUT 또는 POST가 성공했습니다. 인덱스나 문서가 정상적으로 업로드되었습니다. |
| 207 다중 상태 | PUT 또는 POST가 일부분 성공했습니다. 즉, 일부 문서에 대한 작업은 성공했지만 문서 하나 이상에 대한 작업이 실패했습니다. |
| 400 잘못된 요청 | 요청 URI, 헤더 또는 본문에 오류가 있을 때 반환됩니다. 응답 본문에는 특정 문제가 무엇인지 설명하는 오류 메시지가 포함되어 있습니다. |
| 403 사용할 수 없음 | 잘못된 api-key를 전달하면 반환됩니다. |
| 404 찾을 수 없음 | 리소스가 서버에 없을 때 반환됩니다. 인덱스를 관리하거나 쿼리하는 경우 구문을 검사 인덱스 이름이 올바르게 지정되었는지 확인합니다. |
| 405 메서드가 지원되지 않음 | 요청이 인식되지만 지원되지 않는 메서드를 지정하면 반환됩니다. 인덱스를 쿼리하는 경우 해당 요청의 공식에는 엔드포인트, 인덱스 컬렉션 및 인덱스, docs 컬렉션 및 검색 메서드(예: https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30)가 포함됩니다. |
| 409 충돌 | 쓰기 작업이 충돌할 때 반환됩니다. 이 오류는 리소스 업데이트 또는 인덱싱 중에 두 프로세스가 동일한 문서를 동시에 업데이트하려고 할 때 반환됩니다. Azure AI Search는 리소스 업데이트에 대한 동시성 관리를 제공합니다. 자세한 내용은 Azure AI Search에서 동시성을 관리하는 방법을 참조하세요. |
| 412 사전 조건 실패 | If-Match 또는 If-None-Match 헤더의 조건이 false로 평가되면 반환됩니다. 인덱스 정의, 인덱서 또는 데이터 원본에 대한 HTTP 요청을 보낼 때 낙관적 동시성 제어 를 사용하는 것과 관련이 있습니다. |
| 429 요청이 너무 많음 | 인덱스를 만드는 동안 이 오류가 발생하는 경우 가격 책정 계층에 허용되는 최대 인덱스 수가 이미 있는 것입니다. Azure AI Search에 저장된 인덱스의 수는 Azure Portal 검색 서비스 dashboard 표시됩니다. 이름으로 인덱스를 보려면 인덱스 타일을 선택합니다. 또는 인덱스 나열 작업을 사용하여 이름으로 인덱스 목록을 가져올 수도 있습니다. 자세한 내용은 인덱스 나열 을 참조하세요.
문서 업로드 중에 이 오류가 발생하면 인덱스당 문서 수에 대한 할당량을 초과했음을 나타냅니다. 이 경우에는 새 인덱스를 만들거나 업그레이드를 통해 용량 제한을 높여야 합니다. |
| 499 클라이언트 닫힘 요청 | 이 오류는 응답에서 반환되지 않지만 검색 트래픽 분석 및 Azure Monitor에서 기록한 로그 항목에 표시될 수 있습니다. 서비스에서 응답을 반환하기 전에 클라이언트가 연결을 닫은 것을 나타냅니다. Azure AI Search가 서비스 쪽 코드에서 요청하지 않았거나 클라이언트가 더 이상 존재하지 않는 취소를 감지하면 499 오류가 기록됩니다. |
| 502 잘못된 게이트웨이 | 연결에서 HTTPS가 아닌 HTTP를 입력하면 이 오류가 발생합니다. |
| 503 서비스를 사용할 수 없음 | 이 오류는 시스템의 사용량이 많아 지금 요청을 처리할 수 없다는 것을 나타냅니다. 중요: 이 경우 클라이언트 코드를 다시 해제하고 다시 시도하기 전에 기다리는 것이 좋습니다. 이렇게 하면 시스템이 복구할 시간을 제공하여 이후 요청이 성공할 가능성이 높아집니다. 신속하게 요청을 다시 시도하면 이 상황만 연장됩니다. 제한 및 이 조건을 방지하는 방법에 대한 자세한 내용은 성능 분석을 참조하세요. |
| 504: 게이트웨이 시간 제한 | Azure AI Search는 HTTPS 포트 443에서 수신 대기합니다. 검색 서비스 URL에 HTTPS 대신 HTTP가 포함된 경우 504 상태 코드가 반환됩니다. |