Sdílet prostřednictvím

Vytvořit databázi

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 (Software Development Kit) Cosmos DB. Pokud požadujete kompletní podporu funkcí pro všechny prostředky služby Azure Cosmos DB, doporučujeme použít poskytovatele prostředků Cosmos DB.

Žádost

Metoda Požadavek na URI Popis
PŘÍSPĚVEK 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.

Vlastnictví Povinné Typ Popis
x-ms-kapacita nabídky Volitelný Číslo Uživatel specifikoval ruční propustnost (RU/s) pro databázi vyjádřenou v jednotkách 100 jednotek žádostí za sekundu. Minimum je 400 až 1 000 000 (nebo vyšší na základě žádosti o zvýšení limitu).

Musí být zadán pouze jeden z operátorů x-ms-offer-throughput nebo x-ms-cosmos-offer-autopilot-settings . Tyto hlavičky nelze zadat společně.
x-ms-cosmos-nabídka-autopilot-nastavení Volitelný JSON Uživatel zadal automatické škálování s maximálním počtem RU/s databáze. Hodnota je JSON s vlastností maxThroughput. Například: {"maxThroughput": 4000}.

Musí být zadán pouze jeden z operátorů x-ms-offer-throughput nebo x-ms-cosmos-offer-autopilot-settings . Tyto hlavičky nelze zadat společně.

Poznámka:

Pokud nastavíte propustnost databáze, vytvoří se databáze se sdílenou propustností , kde všechny kolekce v ní sdílejí zřízenou propustnost. V databázi se sdílenou propustností platí limit 25 kontejnerů. Pokud neplánujete používat databázi se sdílenou propustností, vytvořte databázi bez nastavení hlaviček propustnosti. Další informace.

Tělo

Vlastnictví Povinné Typ Popis
identifikační číslo Povinné Řetězec Uživatelem vygenerovaný jedinečný název databáze. Jedná se o řetězec, který nesmí být delší než 255 znaků. 
{  
  "id": "volcanodb2"  
}

Odezva

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

V následující tabulce jsou uvedeny běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů naleznete 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 tělo JSON neplatné. Zkontrolujte chybějící složené závorky nebo uvozovky.
409 – Konflikt Vrací se, když ID zadané pro novou databázi bylo převzato existující databází.

Tělo

Vlastnictví Popis
id Uživatelem vygenerovaný jedinečný název databáze.
_zbavit Jedná se o systémem generovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Interně se používá pro umístění a navigaci k databázovému zdroji.
_Ts Jedná se o systémem generovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko.
_já Jedná se o systémem generovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku.
_etag Jedná se o systémem generovanou vlastnost, která určuje značku prostředku vyžadovanou pro optimistické řízení souběžnosti.
_colls Jedná se o systémem generovanou vlastnost, která určuje adresovatelnou cestu ke zdroji kolekcí.
_uživatelé Jedná se o systémem generovanou vlastnost, která určuje adresovatelnou cestu ke zdroji users. 
{  
    "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 slouží k nastavení hodnoty propustnosti (RU/s). Přijímá číslo s minimem 400, které se zvyšuje 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 se používá k nastavení maxThroughput, což je maximální hodnota RU/s automatického škálování. Přijímá číslo s minimem 4000, které se zvyšuje 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"}

Viz také

  • Last updated on