HTTP 상태 코드(Azure Cognitive Search)

이 페이지에서는 Azure Cognitive Search API를 사용할 때 자주 반환되는 HTTP 상태 코드를 설명합니다.

일반 HTTP 상태 코드

코드 Description
200 정상 GET, PUT 또는 POST가 성공했습니다. 성공적인 응답을 위해 반환됩니다. 인덱싱하는 동안 이 코드는 모든 항목이 지속적으로 저장되었으며 인덱싱되기 시작했음을 나타냅니다. 인덱싱은 백그라운드에서 실행되며 인덱싱 작업이 완료된 후 몇 초 후에 새 문서를 쿼리하고 검색할 수 있습니다.
201 생성됨 PUT 또는 POST가 성공했습니다. 개체를 만들거나 업데이트했습니다.
204 수락됨 PUT 또는 POST가 성공했습니다. 인덱스나 문서가 정상적으로 업로드되었습니다.
207 다중 상태 PUT 또는 POST가 일부분 성공했습니다. 즉, 일부 문서에 대한 작업은 성공했지만 문서 하나 이상에 대한 작업이 실패했습니다.
400 잘못된 요청 요청 URI, 헤더 또는 본문에 오류가 있으면 반환됩니다. 응답 본문에는 구체적인 문제를 설명하는 오류 메시지가 포함됩니다.
403 사용할 수 없음 잘못된 api-key를 전달하면 반환됩니다.
404 찾을 수 없음 리소스가 서버에 없으면 반환됩니다. 인덱스를 관리하거나 쿼리하고 있다면 구문을 점검하여 인덱스 이름이 올바르게 지정되어 있는지 확인합니다.
409 충돌 쓰기 작업이 충돌할 때 반환됩니다. 이 오류는 리소스 업데이트 또는 두 프로세스가 동일한 문서를 동시에 업데이트하려고 할 때 인덱싱하는 동안 반환됩니다. Azure Cognitive Search 리소스 업데이트에 대한 동시성 관리를 제공합니다. 자세한 내용은 Azure Cognitive Search 동시성을 관리하는 방법을 참조하세요.
412 사전 조건 실패 If-Match 또는 If-None-Match 헤더의 조건이 false로 평가되면 반환됩니다. 인덱스 정의, 인덱서 또는 데이터 원본에 대한 HTTP 요청을 보낼 때 낙관적 동시성 제어 를 사용하는 것과 관련이 있습니다.
429 요청이 너무 많음 인덱스를 만들 때 이 오류가 발생하면 가격 책정 계층에서 허용되는 인덱스가 최대 수에 이미 도달한 것입니다. Azure Cognitive Search 저장된 인덱스의 수는 Azure Portal 검색 서비스 대시보드에 표시됩니다. 이름으로 인덱스를 보려면 인덱스 타일을 클릭합니다. 또는 인덱스 목록 작업을 사용하여 이름으로 인덱스 목록을 가져올 수도 있습니다. 자세한 내용은 인덱스 나열 을 참조하세요.

문서 업로드 중에 이 오류가 발생하면 인덱스당 문서 수에 대한 할당량을 초과했음을 나타냅니다. 이 경우에는 새 인덱스를 만들거나 업그레이드를 통해 용량 제한을 높여야 합니다.
499 클라이언트 폐쇄 요청 이 오류는 응답에 반환되지 않지만 검색 트래픽 분석 및 Azure Monitor에서 기록된 로그 항목에 표시될 수 있습니다. 서비스에서 응답을 반환하기 전에 클라이언트가 연결을 닫은 것을 나타냅니다. Azure Cognitive Search 서비스 쪽 코드에서 요청되지 않았거나 클라이언트가 더 이상 존재하지 않는 취소를 감지하면 499 오류가 기록됩니다.
502 잘못된 게이트웨이 연결에서 HTTPS가 아닌 HTTP를 입력하면 이 오류가 발생합니다.
503 서비스를 사용할 수 없음 이 오류는 시스템의 사용량이 많아 지금 요청을 처리할 수 없다는 것을 나타냅니다. 중요: 이 경우 클라이언트 코드를 다시 해제하고 다시 시도하기 전에 기다리는 것이 좋습니다. 이렇게 하면 시스템이 복구할 시간을 제공하여 이후 요청이 성공할 가능성이 높아집니다. 신속하게 요청을 다시 시도하면 이 상황만 연장됩니다.
504: 게이트웨이 시간 제한 Azure Cognitive Search HTTPS 포트 443에서 수신 대기합니다. 검색 서비스 URL에 HTTPS 대신 HTTP가 포함된 경우 504 상태 코드가 반환됩니다.

참고 항목