일반적인 응답 코드 검토
Azure Cosmos DB for NoSQL를 사용하는 가장 일반적인 요청 작업은 컨테이너 문서를 작성, 쿼리 또는 관리하는 것입니다. 각 요청은 작업의 상태에 대한 HTTP 상태 코드를 반환합니다. 이 코드는 작업이 성공적으로 수행되었는지 여부를 알려 주는 데 도움이 될 수 있습니다. 코드를 통해 요청이 실패했음을 확인하고, 잘못되었을 가능성이 있는 부분에 대한 인사이트를 얻을 수도 있습니다. 이 섹션에서는 다음과 같은 요청 유형에서 반환되는 가장 일반적인 HTTP 상태 코드 중 일부를 검토합니다.
- 문서 만들기
- 문서 나열
- 문서 가져오기
- 문서 바꾸기
- 문서 패치
- 문서 삭제
- 문서 쿼리
모든 유형의 작업에 대한 일반적인 상태 코드
400, 403 및 404와 같은 일부 상태 코드는 서로 다른 작업 유형 간에 공유되지만 설명은 약간 다르며 이 표에 나열되지 않습니다.
| 상태 코드 | 이름 | 작업 유형 | 설명 |
|---|---|---|---|
| 200 | 정상 | List, Get, Replace, Patch, Query | 작업이 완료되었습니다. |
문서 만들기
문서 만들기 작업은 컬렉션에 새 문서를 만듭니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 201 | 생성일 | 작업이 완료되었습니다. |
| 400 | 잘못된 요청 | JSON 본문이 잘못되었습니다. |
| 403 | 사용할 수 없음 | 파티션의 저장 한도에 도달하여 작업을 완료할 수 없습니다. |
| 409 | 충돌 | 새 문서에 제공된 id가 기존 문서에서 사용되었습니다. |
| 413 | Entity Too Large | 요청의 문서 크기가 허용 가능한 문서 크기를 초과했습니다. |
ReadFeed를 사용하여 컬렉션 아래에 있는 문서 나열
ReadFeed를 사용하여 모든 문서를 검색하거나 컬렉션 내의 문서에 대한 증분식 변경만 검색할 수 있습니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 400 | 잘못된 요청 | x-ms-consistency-level에 설정된 재정의 수준이 계정을 만드는 동안 설정된 수준보다 더 높습니다. 예를 들어 일관성 수준이 Session인 경우 Strong 또는 Bounded로 재정의할 수는 없습니다. |
문서 가져오기
문서 가져오기 작업은 파티션 키와 문서 키로 문서를 검색합니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 304 | 수정 안 됨 | If-Match 헤더에 지정된 eTag 값 이후에 요청된 문서가 수정되지 않았습니다. 서비스에서 빈 응답 본문을 반환합니다. |
| 400 | 잘못된 요청 | x-ms-consistency-level 헤더에 설정된 재정의가 계정을 만드는 동안 설정된 수준보다 강합니다. 예를 들어 일관성 수준이 Session인 경우 Strong 또는 Bounded로 재정의할 수는 없습니다. |
| 404 | 찾을 수 없음 | 문서가 더 이상 리소스가 아닙니다. 즉, 문서가 삭제되었습니다. |
문서 바꾸기
문서 바꾸기 작업은 문서의 전체 내용을 바꿉니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 400 | 잘못된 요청 | JSON 본문이 잘못되었습니다. 누락된 중괄호나 따옴표를 확인하세요. |
| 404 | 찾을 수 없음 | 문서가 더 이상 존재하지 않습니다. 즉, 문서가 삭제되었습니다. |
| 409 | 충돌 | 새 문서에 제공된 id가 기존 문서에서 사용되었습니다. |
| 413 | Entity Too Large | 요청의 문서 크기가 허용 가능한 문서 크기를 초과했습니다. |
문서 패치
문서 패치 작업은 단일 문서의 특정 파일/속성에 대한 경로 수준 업데이트를 수행합니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 400 | 잘못된 요청 | JSON 본문이 잘못되었습니다. |
| 412 | 사전 조건 실패 | 지정된 사전 조건이 충족되지 않았습니다. |
문서 삭제
문서 삭제 작업은 컬렉션에서 기존 문서를 삭제합니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 204 | 내용 없음 | 삭제 작업에 성공했습니다. |
| 404 | 찾을 수 없음 | 문서를 찾을 수 없습니다. |
문서 쿼리
Azure Cosmos DB SQL 쿼리를 사용하여 컬렉션 문서를 쿼리할 수 있습니다. 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 400 | 잘못된 요청 | 요청이 잘못된 SQL 구문으로 지정되었거나 필수 헤더가 누락되었습니다. |
Azure Cosmos DB 요청에서 반환할 수 있는 기타 중요 상태 코드
또한 일부 실패한 상태 코드가 예외에 대한 참조입니다. 다음 섹션에서 이러한 몇 가지 상태 코드에 대해 자세히 설명하지만, 검토할 몇 가지 일반적인 상태 코드는 다음과 같습니다.
| 상태 코드 | 작업 유형 | 설명 |
|---|---|---|
| 408 | 요청 시간 초과 | 요청이 할당된 시간 내에 완료되지 않았습니다. 쿼리 내의 저장 프로시저, 트리거 또는 UDF 실행이 최대 실행 시간 이내에 완료되지 않으면 이 코드가 반환됩니다. |
| 429 | 너무 많은 요청 | 컬렉션이 프로비전된 처리량 한도를 초과했습니다. 서버에서 일정 시간이 경과하면 지정한 서버에서 다시 시도한 후 요청을 다시 시도합니다. 자세한 내용은 요청 단위를 참조하세요. |
| 500 | 내부 서버 오류 | 예기치 않은 서비스 오류로 인해 작업이 실패했습니다. 지원에 문의 |
| 503 | 서비스를 사용할 수 없음 | 서비스를 사용할 수 없으므로 작업을 완료할 수 없습니다. 네트워크 연결 또는 서비스 가용성 문제로 인해 이러한 상황이 발생할 수 있습니다. 작업을 다시 시도하는 것이 안전합니다. 문제가 지속되면 고객 지원 팀에 문의하세요. |