Database maken
Met de Create Database bewerking maakt u een nieuwe database in het databaseaccount.
Notitie
Deze API-referentieartikelen laten zien hoe u resources maakt met behulp van de Azure Cosmos DB-gegevensvlak-API. Met de gegevensvlak-API kunt u basisopties configureren, zoals indexeringsbeleid en partitiesleutels, net als met Cosmos DB SDK's. Als u volledige functieondersteuning nodig hebt voor alle Azure Cosmos DB-resources, raden we u aan de Cosmos DB-resourceprovider te gebruiken.
Aanvraag
| Methode | Aanvraag-URI | Beschrijving |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} is de naam van het Azure Cosmos DB-account dat u hebt gemaakt onder uw abonnement. |
Kopteksten
Zie Algemene Azure Cosmos DB REST-aanvraagheaders voor headers die worden gebruikt door alle Azure Cosmos DB-aanvragen.
| Eigenschap | Vereist | Type | Beschrijving |
|---|---|---|---|
| x-ms-offer-throughput | Optioneel | Aantal | De gebruiker heeft handmatige doorvoer (RU/s) opgegeven voor de database, uitgedrukt in eenheden van 100 aanvraageenheden per seconde. Het minimum is 400 tot 1.000.000 (of hoger door een verhoging van de limiet aan te vragen). Er moet slechts één van x-ms-offer-throughput of x-ms-cosmos-offer-autopilot-settings worden opgegeven. Deze headers kunnen niet samen worden opgegeven. |
| x-ms-cosmos-offer-autopilot-settings | Optioneel | JSON | De gebruiker heeft het maximum aantal RU/s van de database voor automatisch schalen opgegeven. De waarde is een JSON met de eigenschap maxThroughput. Bijvoorbeeld: {"maxThroughput": 4000}.Er moet slechts één van x-ms-offer-throughput of x-ms-cosmos-offer-autopilot-settings worden opgegeven. Deze headers kunnen niet samen worden opgegeven. |
Notitie
Als u doorvoer instelt voor een database, wordt hiermee een gedeelde doorvoerdatabase gemaakt waarin alle verzamelingen in de database de ingerichte doorvoer delen. Er is een limiet van 25 containers in een gedeelde doorvoerdatabase. Als u niet van plan bent om een gedeelde doorvoerdatabase te gebruiken, maakt u een database zonder de bovenstaande doorvoerheaders in te stellen. Meer informatie.
Hoofdtekst
| Eigenschap | Vereist | Type | Beschrijving |
|---|---|---|---|
| id | Vereist | Tekenreeks | De door de gebruiker gegenereerde unieke naam voor de database. Het is een tekenreeks die niet meer dan 255 tekens mag bevatten. |
{
"id": "volcanodb2"
}
Antwoord
Kopteksten
Zie Algemene Azure Cosmos DB REST-antwoordheaders voor headers die worden geretourneerd door alle Azure Cosmos DB-antwoorden.
Statuscodes
De volgende tabel bevat algemene statuscodes die door deze bewerking worden geretourneerd. Zie HTTP-statuscodes voor een volledige lijst met statuscodes.
| HTTP-statuscode | Beschrijving |
|---|---|
| 201 Gemaakt | Wordt geretourneerd wanneer de bewerking is voltooid. |
| 400 Ongeldige aanvraag | Wordt geretourneerd wanneer de JSON-hoofdtekst ongeldig is. Controleer of er accolades of aanhalingstekens ontbreken. |
| 409 Conflict | Wordt geretourneerd wanneer de id die is opgegeven voor de nieuwe database is gebruikt door een bestaande database. |
Hoofdtekst
| Eigenschap | Beschrijving |
|---|---|
| id | De door de gebruiker gegenereerde unieke naam voor de database. |
| _Ontdoen | Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is per resourcestack in het resourcemodel. Het wordt intern gebruikt voor de plaatsing van en navigatie naar de databaseresource. |
| _Ts | Het is een door het systeem gegenereerde eigenschap. Hiermee geeft u de laatst bijgewerkte tijdstempel van de resource op. De waarde is een tijdstempel. |
| _Zelf | Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource. |
| _etag | Het is een door het systeem gegenereerde eigenschap die de resource-etag aangeeft die is vereist voor optimistisch gelijktijdigheidsbeheer. |
| _colls | Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de verzamelingsresource aangeeft. |
| _Gebruikers | Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de gebruikersresource aangeeft. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Voorbeeld 1
In het volgende voorbeeld wordt een database gemaakt.
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\/"
}
Voorbeeld 2
In het volgende voorbeeld wordt een gedeelde doorvoerdatabase gemaakt met een handmatige doorvoer van 400 RU/s.
x-ms-offer-throughput header wordt gebruikt om de waarde voor doorvoer (RU/s) in te stellen. Het accepteert een getal met minimaal 400 dat wordt verhoogd met eenheden van 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"}
Voorbeeld 3
In het volgende voorbeeld wordt een gedeelde doorvoerdatabase gemaakt met een maximale doorvoer van 4000 RU/s (schaalt tussen 400 - 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings header wordt gebruikt om de maxThroughputin te stellen. Dit is de waarde voor het maximum aantal RU/s voor automatisch schalen. Het accepteert een getal met minimaal 4000 dat wordt verhoogd met eenheden van 1000.
Notitie
Als u automatische schaalaanpassing wilt inschakelen voor een bestaande database of container, of wilt overschakelen van automatische schaalaanpassing naar handmatige doorvoer, raadpleegt u het artikel Een aanbieding vervangen.
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"}