Delen via

Database maken

Met deze Create Database bewerking wordt een nieuwe database gemaakt in het databaseaccount.

Opmerking

In deze API-referentieartikelen wordt beschreven hoe u resources maakt met behulp van de Azure Cosmos DB-gegevensvlak-API. Met de Data Plane-API kunt u basisopties configureren, zoals indexeringsbeleid en partitiesleutels, net zoals u dat kunt met Cosmos DB software development kits (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 URI-aanvraag Beschrijving
BERICHT https://{databaseaccount}.documents.azure.com/dbs De {databaseaccount} is de naam van het Azure Cosmos DB-account dat u onder uw abonnement hebt gemaakt.

Kopteksten

Zie Algemene Azure Cosmos DB REST-aanvraagheaders voor headers die worden gebruikt door alle Azure Cosmos DB-aanvragen.

Vastgoed Verplicht Typologie Beschrijving
x-ms-aanbod-doorvoer Optioneel Aantal De door de gebruiker opgegeven handmatige doorvoer (RU/s) voor de database, uitgedrukt in eenheden van 100 aanvraageenheden per seconde. Het minimum is 400 tot 1.000.000 (of hoger door een limietverhoging aan te vragen).

Slechts één van x-ms-offer-throughput of x-ms-cosmos-offer-autopilot-settings moet worden opgegeven. Deze koppen kunnen niet samen worden opgegeven.
x-ms-cosmos-aanbieding-stuurautomaat-instellingen Optioneel JSON De gebruiker heeft autoscale max RU/s van de database opgegeven. De waarde is een JSON met de eigenschap maxThroughput. Voorbeeld: {"maxThroughput": 4000}.

Slechts één van x-ms-offer-throughput of x-ms-cosmos-offer-autopilot-settings moet worden opgegeven. Deze koppen kunnen niet samen worden opgegeven.

Opmerking

Als u de doorvoer voor een database instelt, wordt er een database met gedeelde doorvoer gemaakt waarin alle verzamelingen de ingerichte doorvoer delen. Er is een limiet van 25 containers in een database met gedeelde doorvoer. Als u niet van plan bent een database met gedeelde doorvoer te gebruiken, maakt u een database zonder de doorvoerheaders in te stellen. Meer informatie.

Lichaam

Vastgoed Verplicht Typologie Beschrijving
identiteitskaart Verplicht Snaar / Touwtje De door de gebruiker gegenereerde unieke naam voor de database. Het is een tekenreeks die niet meer dan 255 tekens mag bevatten. 
{  
  "id": "volcanodb2"  
}

Reactie

Kopteksten

Zie Algemene Azure Cosmos DB REST-antwoordheaders voor headers die worden geretourneerd door alle Azure Cosmos DB-antwoorden.

Statuscodes

In de volgende tabel vindt u een overzicht van de algemene statuscodes die door deze bewerking worden geretourneerd. Zie HTTP-statuscodes voor een volledige lijst met statuscodes.

HTTP-statuscode Beschrijving
201 Aangemaakt Wordt geretourneerd wanneer de bewerking is geslaagd.
400 Foute Verzoek Geretourneerd wanneer de JSON-body ongeldig is. Controleer op ontbrekende accolades of aanhalingstekens.
409 Conflict Wordt geretourneerd wanneer de ID die voor de nieuwe database is opgegeven, is overgenomen door een bestaande database.

Lichaam

Vastgoed Beschrijving
ID De door de gebruiker gegenereerde unieke naam voor de database.
_afhelpen Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is volgens de resourcestack in het resourcemodel. Het wordt intern gebruikt voor het plaatsen van en navigeren naar de databasebron.
_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 specificeert die nodig is voor optimistische gelijktijdigheidscontrole.
_colls Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de verzamelingsresource specificeert.
_Gebruikers Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad van de gebruikersresource specificeert. 
{  
    "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 database met gedeelde doorvoer gemaakt met handmatige doorvoer van 400 RU/s. x-ms-offer-throughput header wordt gebruikt om de doorvoerwaarde (RU/s) in te stellen. Het accepteert een nummer met een minimum van 400 dat toeneemt 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 database met gedeelde doorvoer gemaakt met een maximale doorvoer van 4000 RU/s (schalen tussen 400 - 4000 RU/s). x-ms-cosmos-offer-autopilot-settings header wordt gebruikt om de maxThroughput, wat de autoscale max RU/s-waarde is. Het accepteert een nummer met een minimum van 4000 dat wordt verhoogd met eenheden van 1000.

Opmerking

Zie het artikel Een aanbieding vervangen als u automatisch schalen wilt inschakelen voor een bestaande database of container, of als u wilt overschakelen van automatisch schalen naar handmatige doorvoer.

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

Zie ook