데이터베이스 만들기

Create Database 이 작업은 데이터베이스 계정에 새 데이터베이스를 만듭니다.

비고

이러한 API 참조 문서에서는 Azure Cosmos DB 데이터 평면 API를 사용하여 리소스를 만드는 방법을 보여 줍니다. 데이터 평면 API를 사용하면 Cosmos DB SDK(소프트웨어 개발 키트)와 마찬가지로 인덱싱 정책, 파티션 키와 같은 기본 옵션을 구성할 수 있습니다. 모든 Azure Cosmos DB 리소스에 대한 전체 기능 지원이 필요한 경우 Cosmos DB 리소스 공급자를 사용하는 것이 좋습니다.

요청

메서드	URI 요청	설명
게시하기	`https://{databaseaccount}.documents.azure.com/dbs`	{databaseaccount}는 구독에서 만든 Azure Cosmos DB 계정의 이름입니다.

헤더

모든 Azure Cosmos DB 요청에서 사용하는 헤더는 일반적인 Azure Cosmos DB REST 요청 헤더를 참조하세요.

재산	필수	유형	설명
x-ms-제안 처리량	선택적	숫자	사용자가 데이터베이스에 대해 지정한 수동 처리량(RU/s)은 초당 100 요청 단위로 표시됩니다. 최소값은 400에서 최대 1,000,000(또는 한도 증가를 요청하여 그 이상)입니다. 또는 `x-ms-cosmos-offer-autopilot-settings` 중 `x-ms-offer-throughput` 하나만 지정해야 합니다. 이러한 헤더는 함께 지정할 수 없습니다.
x-ms-cosmos-offer-autopilot-settings	선택적	JSON (자바스크립트 객체 표기법)	사용자가 데이터베이스의 최대 RU/초 자동 크기 조정을 지정했습니다. 값은 속성이 있는 `maxThroughput`JSON입니다. 예: `{"maxThroughput": 4000}`. 또는 `x-ms-cosmos-offer-autopilot-settings` 중 `x-ms-offer-throughput` 하나만 지정해야 합니다. 이러한 헤더는 함께 지정할 수 없습니다.

비고

데이터베이스에 처리량을 설정하면 그 안의 모든 컬렉션이 프로비전된 처리량을 공유하는 공유 처리량 데이터베이스 가 만들어집니다. 공유 처리량 데이터베이스에는 25개의 컨테이너로 제한됩니다. 공유 처리량 데이터베이스를 사용하지 않으려면 처리량 헤더를 설정하지 않고 데이터베이스를 만듭니다. 자세히알아보세요.

몸

재산	필수	유형	설명
아이디	필수	문자열	데이터베이스에 대해 사용자가 생성한 고유 이름입니다. 255자를 넘지 않아야 하는 문자열입니다.

{  
  "id": "volcanodb2"  
}

응답

헤더

모든 Azure Cosmos DB 응답에서 반환되는 헤더는 일반적인 Azure Cosmos DB REST 응답 헤더를 참조하세요.

상태 코드

다음 표에서는 이 작업에서 반환하는 일반적인 상태 코드를 나열합니다. 상태 코드의 전체 목록은 http 상태 코드 참조하세요.

HTTP 상태 코드	설명
201 생성됨	작업이 성공하면 반환됩니다.
400 잘못된 요청	JSON 본문이 유효하지 않을 때 반환됩니다. 누락된 중괄호나 따옴표를 확인하세요.
409 충돌	새 데이터베이스에 제공된 ID가 기존 데이터베이스에서 사용된 경우 반환됩니다.

몸

재산	설명
아이디	데이터베이스에 대해 사용자가 생성한 고유 이름입니다.
_제거	시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택당 계층 구조인 고유 식별자입니다. 데이터베이스 자원을 배치하고 탐색하기 위해 내부적으로 사용됩니다.
_ts	시스템에서 생성된 속성입니다. 리소스의 마지막으로 업데이트된 타임스탬프를 지정합니다. 값은 타임스탬프입니다.
_자신	시스템에서 생성된 속성입니다. 리소스에 대한 고유한 주소 지정 가능 URI입니다.
_etag	낙관적 동시성 제어에 필요한 리소스 etag 를 지정하는 시스템 생성 속성입니다.
_colls	컬렉션 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다.
_사용자	사용자 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다.

{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

예제 1

다음 예제에서는 데이터베이스를 만듭니다.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}

HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT  
etag: "00000a00-0000-0000-0000-56672f920000"  
x-ms-resource-quota: databases=100;  
x-ms-resource-usage: databases=15;  
x-ms-schemaversion: 1.1  
x-ms-quorum-acked-lsn: 859  
x-ms-session-token: 860  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: f171e571-994e-4dc2-b443-7c3d5fa4a293  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:29:21 GMT  
Content-Length: 169  
  
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

예제 2

다음 예제에서는 수동 처리량이 400RU/s인 공유 처리량 데이터베이스 를 만듭니다. x-ms-offer-throughput 헤더는 처리량(RU/s) 값을 설정하는 데 사용됩니다. 100 단위로 증가하는 최소 400의 숫자를 허용합니다.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:29:22 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
x-ms-offer-throughput = 400
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}

예제 3

다음 예제에서는 자동 크기 조정 최대 처리량이 4000RU/s(400 - 4000 RU/s 사이에서 확장)인 공유 처리량 데이터베이스를 만듭니다. x-ms-cosmos-offer-autopilot-settings 헤더는 자동 크기 조정 최대 RU/s 값인 을 설정하는 maxThroughput데 사용됩니다. 1000 단위로 증가하는 최소 4000의 숫자를 허용합니다.

비고

기존 데이터베이스 또는 컨테이너에서 자동 크기 조정을 사용하도록 설정하거나 자동 크기 조정에서 수동 처리량으로 전환하려면 제품 바꾸기 문서를 참조하세요.

POST https://contosomarketing.documents.azure.com:443/dbs HTTP/1.1 
x-ms-version: 2018-12-31
x-ms-date: Wed, 22 Jul 2020 20:09:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d 
Accept: application/json
x-ms-cosmos-offer-autopilot-settings: {"maxThroughput": 4000}
Content-Type: application/json
User-Agent: contoso/1.0
Postman-Token: 81c0a4ac-4b7c-4f98-8d46-8c662969bc7e
Host: contosomarketing.documents.azure.com:443
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 27

{"id":"volcanodb3"}

또한 참조하십시오

Azure Cosmos DB
Azure Cosmos DB SQL API
Azure Cosmos DB SQL API SDK
.NET 샘플 REST

Last updated on 2025-08-15