Create Database
Operace Create Database vytvoří novou databázi v databázovém účtu.
Poznámka
Tyto referenční články k rozhraní API ukazují, jak vytvářet prostředky pomocí rozhraní API roviny dat služby Azure Cosmos DB. Pomocí rozhraní API roviny dat můžete nakonfigurovat základní možnosti, jako jsou zásady indexování, klíče oddílů podobně jako u sad SDK služby Cosmos DB. Pokud potřebujete úplnou podporu funkcí pro všechny prostředky Azure Cosmos DB, doporučujeme použít poskytovatele prostředků Cosmos DB.
Žádost
| Metoda | Identifikátor URI žádosti | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} je název účtu služby Azure Cosmos DB, který jste vytvořili v rámci svého předplatného. |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Azure Cosmos DB.
| Vlastnost | Požaduje se | Typ | Description |
|---|---|---|---|
| x-ms-offer-propustnost | Volitelné | Číslo | Uživatel zadal pro databázi ruční propustnost (RU/s) vyjádřenou v jednotkách 100 jednotek žádostí za sekundu. Minimální hodnota je 400 až 1 000 000 (nebo vyšší tím, že požádáte o navýšení limitu). Musí být zadán pouze jeden z nebo x-ms-offer-throughputx-ms-cosmos-offer-autopilot-settings . Tyto hlavičky nelze zadat společně. |
| x-ms-cosmos-offer-autopilot-settings | Volitelné | JSON | Uživatel zadal maximální počet RU/s automatického škálování databáze. Hodnota je JSON s vlastností maxThroughput. Příklad: {"maxThroughput": 4000}.Musí být zadán pouze jeden z nebo x-ms-offer-throughputx-ms-cosmos-offer-autopilot-settings . Tyto hlavičky nelze zadat společně. |
Poznámka
Pokud nastavíte propustnost pro databázi, vytvoří se databáze se sdílenou propustností , ve které všechny kolekce v ní sdílejí zřízenou propustnost. Databáze se sdílenou propustností má limit 25 kontejnerů. Pokud neplánujete používat databázi se sdílenou propustností, vytvořte databázi bez nastavení výše uvedených hlaviček propustnosti. Další informace.
Text
| Vlastnost | Požaduje se | Typ | Description |
|---|---|---|---|
| id | Vyžadováno | Řetězec | Jedinečný název databáze vygenerovaný uživatelem. Jedná se o řetězec, který nesmí být delší než 255 znaků. |
{
"id": "volcanodb2"
}
Odpověď
Hlavičky
Viz Běžné hlavičky odpovědí REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Azure Cosmos DB.
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
| Stavový kód HTTP | Popis |
|---|---|
| 201 Vytvořeno | Vrátí se, když je operace úspěšná. |
| 400 – Chybný požadavek | Vrátí se, když je text JSON neplatný. Zkontrolujte, jestli nechybí složené závorky nebo uvozovky. |
| 409 – Konflikt | Vrátí se, když ID zadané pro novou databázi převzala existující databáze. |
Text
| Vlastnost | Popis |
|---|---|
| id | Jedinečný název databáze vygenerovaný uživatelem. |
| _Zbavit | Jedná se o systém vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění prostředku databáze a navigaci v něm. |
| _Ts | Jedná se o systémově vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
| _Vlastní | Jedná se o systémově vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
| _Etag | Jedná se o systémově vygenerovanou vlastnost, která určuje etag prostředku vyžadovanou pro řízení optimistické souběžnosti. |
| _colls | Jedná se o systémově vygenerovanou vlastnost, která určuje adresovatelnou cestu k prostředku kolekcí. |
| _Uživatelé | Jedná se o systémově vygenerovanou vlastnost, která určuje adresovatelnou cestu k prostředku uživatelů. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Příklad 1
Následující příklad vytvoří databázi.
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\/"
}
Příklad 2
Následující příklad vytvoří databázi se sdílenou propustností s ruční propustností 400 RU/s.
x-ms-offer-throughput hlavička slouží k nastavení hodnoty propustnosti (RU/s). Přijímá číslo s minimálním číslem 400, které se zvýší o jednotky 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"}
Příklad 3
Následující příklad vytvoří databázi se sdílenou propustností s maximální propustností automatického škálování 4000 RU/s (škáluje se mezi 400 až 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings Hlavička se používá k nastavení maxThroughputhodnoty , což je hodnota maximálního počtu RU/s automatického škálování. Přijímá číslo s minimálním počtem 4000, které se zvýší o jednotky 1000.
Poznámka
Pokud chcete povolit automatické škálování u existující databáze nebo kontejneru nebo přepnout z automatického škálování na ruční propustnost, přečtěte si článek Nahrazení nabídky.
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"}