共用方式為

建立資料庫

  • 發行項

作業 Create Database 會在資料庫帳戶中建立新的資料庫。

注意

這些 API 參考文章示範如何使用 Azure Cosmos DB 資料平面 API 來建立資源。 使用資料平面 API，您可以設定基本選項，例如編制索引原則，分割區索引鍵與使用 Cosmos DB SDK 非常類似。 如果您需要所有 Azure Cosmos DB 資源的完整功能支援，建議您使用 Cosmos DB 資源提供者。

要求

方法 要求 URI Description
POST https://{databaseaccount}.documents.azure.com/dbs {databaseaccount} 是您在訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。

標題

如需所有 Azure Cosmos DB 要求所使用的標頭，請參閱常見的 Azure Cosmos DB REST 要求標頭 。

屬性 必要 類型 Description
x-ms-offer-throughput 選擇性 數字 使用者為以每秒 100 個要求單位表示的資料庫指定手動輸送量 (RU/秒) 。 最小值為 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 個容器的限制。 如果您不打算使用共用輸送量資料庫，請建立資料庫而不設定上述輸送量標頭。 深入了解。

主體

屬性 必要 類型 Description
id 必要 String 使用者為資料庫產生的唯一名稱。 它是不能超過 255 個字元的字串。 
{  
  "id": "volcanodb2"  
}

回應

標題

如需所有 Azure Cosmos DB 回應所傳回的標頭，請參閱 一般 Azure Cosmos DB REST 回應標頭 。

狀態碼

下表列出此作業所傳回的常見狀態碼。 如需狀態碼的完整清單，請參閱 HTTP 狀態碼。

HTTP 狀態碼 Description
201 Created 在作業成功時傳回。
400 不正確的要求 當 JSON 主體無效時傳回。 檢查是否缺少大括號或引號。
409 衝突 當現有資料庫已取得為新資料庫提供的識別碼時傳回。

主體

屬性 描述
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 標頭用來設定 (RU/秒) 值的輸送量。 它會接受最小 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/秒值。 它會接受最小 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"}

另請參閱