Azure Cosmos DB: REST API 참조
Azure Cosmos DB 는 문서, 그래프 및 키-값 데이터 모델을 지원하는 전역적으로 분산된 다중 모델 데이터베이스입니다. 이 섹션의 내용은 REST를 통해 SQL API 를 사용하여 문서 리소스를 만들고, 쿼리하고, 관리하기 위한 것입니다.
Azure Cosmos DB REST API는 Azure Cosmos DB 리소스에 대한 프로그래밍 방식 액세스를 제공하여 데이터베이스, 문서 컬렉션 및 문서를 만들고, 쿼리하고, 삭제합니다. Azure Cosmos DB 리소스에서 작업을 수행하려면 지원되는 메서드GET인 , , POSTPUT또는 리소스 컬렉션 또는 DELETE 특정 리소스를 대상으로 하는 엔드포인트로 HTTPS 요청을 보냅니다. 이 섹션에서는 REST API를 사용하여 리소스를 사용하는 방법을 설명합니다.
참고
이러한 API 참조 문서에서는 Azure Cosmos DB 데이터 평면 API를 사용하여 리소스를 만드는 방법을 보여 줍니다. 데이터 평면 API를 사용하면 Cosmos DB SDK와 마찬가지로 인덱싱 정책, 파티션 키와 같은 기본 옵션을 구성할 수 있습니다. 모든 Azure Cosmos DB 리소스에 대한 완전한 기능 지원이 필요한 경우 Cosmos DB 리소스 공급자를 사용하는 것이 좋습니다. API 참조 문서는 아래에 나열되어 있습니다.
지원되는 REST API 버전
다음 표에서는 Azure Cosmos DB 서비스에서 지원되는 REST API 버전을 나열합니다. 버전은 모든 요청의 헤더를 x-ms-version 통해 지정해야 합니다. 이 헤더가 제공되지 않으면 최신 버전이 사용됩니다.
| 버전 | 변경이 도입됨 | 사용 중지 날짜 |
|---|---|---|
| 2018-12-31 | 분할된 컬렉션 자동 마이그레이션 | |
| 2018-09-17 | 복합 및 추가 공간 인덱싱 | |
| 2018-08-31 | 동적 컬렉션 크기 조정 개선 사항 | |
| 2018-06-18 | 다중 지역 쓰기 지원 | |
| 2017-11-15 | 다중 지역 강력한 일관성 | |
| 2017-05-03 | 큰 파티션 키 | |
| 2017-02-22 | 일관적인 접두사 | |
| 2017-01-19 | 분할된 컬렉션의 최소 처리량을 2500RU/s로 낮추기 | |
| 2016-07-11 | 변경 피드 | |
| 2015-12-16 | 분할된 컬렉션 | |
| 2015-08-06 | Upsert | |
| 2015-06-03 | Order By 지원 | |
| 2015-04-08 | DocumentDB 일반 공급(현재 Azure Cosmos DB의 일부) | |
| 2014-08-21 | DocumentDB 공개 미리 보기(현재 Azure Cosmos DB의 일부) | 2016년 2월 29일 |
Cosmos DB 리소스
다음 문서에서는 각 리소스 종류에 대해 지원되는 REST API에 대해 설명합니다. 리소스 모델에 대한 일반적인 내용은 리소스 모델 및 Cosmos DB 리소스 URI를 참조하세요.
요청에 권한을 부여하는 방법은 액세스 제어 를 참조하세요. 요청 및 응답 옵션에 대한 일반적인 내용은 다음 문서를 참조하세요.