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 통해 지정해야 합니다. 이 헤더가 제공되지 않으면 최신 버전이 사용됩니다.

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일

DB 리소스 Cosmos

다음 문서에서는 각 리소스 종류에 대해 지원되는 REST API에 대해 설명합니다. 리소스 모델에 대한 일반적인 내용은 리소스 모델Cosmos DB 리소스 URI를 참조하세요.

요청에 권한을 부여하는 방법은 Access 제어 를 참조하세요. 요청 및 응답 옵션에 대한 일반적인 내용은 다음 문서를 참조하세요.

참고 항목