你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建数据库

该作在 Create Database 数据库帐户中创建一个新数据库。

注释

这些 API 参考文章介绍如何使用 Azure Cosmos DB 数据平面 API 创建资源。使用数据平面 API，可以配置基本选项，例如索引策略、分区键，就像使用 Cosmos DB 软件开发工具包（SDK）一样。如果需要对所有 Azure Cosmos DB 资源提供完整的功能支持，建议使用 Cosmos DB 资源提供程序。

请求

方法	请求 URI	DESCRIPTION
帖子	`https://{databaseaccount}.documents.azure.com/dbs`	{databaseaccount} 是在订阅下创建的 Azure Cosmos DB 帐户的名称。

标头

有关所有 Azure Cosmos DB 请求使用的标头，请参阅常见的 Azure Cosmos DB REST 请求标头。

资产	必选	类型	DESCRIPTION
x-ms-offer-throughput	可选	编号	用户为数据库指定的手动吞吐量（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`. 例如： `{"maxThroughput": 4000}`。必须只指定或 `x-ms-cosmos-offer-autopilot-settings` 中的`x-ms-offer-throughput`一个。这些标头不能一起指定。

注释

如果在数据库上设置吞吐量，则会创建一个共享吞吐量数据库，其中所有集合共享预配的吞吐量。共享吞吐量数据库中的容器限制为 25 个。如果不打算使用共享吞吐量数据库，请在不设置吞吐量标头的情况下创建数据库。了解详细信息。

身体

资产	必选	类型	DESCRIPTION
id	必选	字符串	用户为数据库生成的唯一名称。这是一个不得超过 255 个字符的字符串。

{  
  "id": "volcanodb2"  
}

响应

标头

有关所有 Azure Cosmos DB 响应返回的标头，请参阅常见的 Azure Cosmos DB REST 响应标头。

状态代码

下表列出了此作返回的常见状态代码。有关状态代码的完整列表，请参阅 HTTP 状态代码。

HTTP 状态代码	DESCRIPTION
201 已创建	作成功时返回。
400 错误的请求	当 JSON 正文无效时返回。检查是否缺少大括号或引号。
409 冲突	当为新数据库提供的 ID 已被现有数据库采用时返回。

身体

资产	DESCRIPTION
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

以下示例创建手动吞吐量为 400 RU/秒的共享吞吐量数据库。 x-ms-offer-throughput header 用于设置吞吐量（RU/s）值。它接受最小为 400 的数字，该数字以 100 为单位递增。

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

以下示例创建自动缩放最大吞吐量为 4000 RU/秒（在 400 - 4000 RU/秒之间缩放）的共享吞吐量数据库。 x-ms-cosmos-offer-autopilot-settings 标头用于设置 maxThroughput，这是自动缩放的最大 RU/s 值。它接受一个最小为 4000 的数字，该数字以 1000 为单位递增。

注释

若要在现有数据库或容器上启用自动缩放，或从自动缩放切换到手动吞吐量，请参阅替换产品/服务一文。

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"}

另请参阅

Last updated on 2025-08-15

通过