Erstellen einer Datenbank
Der Create Database Vorgang erstellt eine neue Datenbank im Datenbankkonto.
Hinweis
In diesen API-Referenzartikeln wird gezeigt, wie Ressourcen mithilfe der Azure Cosmos DB-Datenebenen-API erstellt werden. Mit der Datenebenen-API können Sie grundlegende Optionen wie Indizierungsrichtlinie und Partitionsschlüssel wie bei Cosmos DB SDKs konfigurieren. Wenn Sie vollständige Featureunterstützung für alle Azure Cosmos DB-Ressourcen benötigen, empfiehlt es sich, den Cosmos DB-Ressourcenanbieter zu verwenden.
Anforderung
| Methode | Anforderungs-URI | BESCHREIBUNG |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} ist der Name des Azure Cosmos DB-Kontos, das Sie unter Ihrem Abonnement erstellt haben. |
Header
Informationen zu Headern, die von allen Azure Cosmos DB-Anforderungen verwendet werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader .
| Eigenschaft | Erforderlich | type | BESCHREIBUNG |
|---|---|---|---|
| x-ms-offer-throughput | Optional | Number | Der vom Benutzer angegebene manuelle Durchsatz (RUs/s) für die Datenbank, ausgedrückt in Einheiten von 100 Anforderungseinheiten pro Sekunde. Das Minimum beträgt 400 bis 1.000.000 (oder höher durch Anfordern einer Grenzwerterhöhung). Es muss nur einer von x-ms-offer-throughput oder x-ms-cosmos-offer-autopilot-settings angegeben werden. Diese Header können nicht zusammen angegeben werden. |
| x-ms-cosmos-offer-autopilot-settings | Optional | JSON | Der Benutzer hat die automatische Skalierung der maximalen RU/s der Datenbank angegeben. Der Wert ist ein JSON-Code mit der Eigenschaft maxThroughput. Beispiel: {"maxThroughput": 4000}.Es muss nur einer von x-ms-offer-throughput oder x-ms-cosmos-offer-autopilot-settings angegeben werden. Diese Header können nicht zusammen angegeben werden. |
Hinweis
Wenn Sie den Durchsatz für eine Datenbank festlegen, wird eine Datenbank mit freigegebenem Durchsatz erstellt, in der alle Sammlungen in der Datenbank den bereitgestellten Durchsatz gemeinsam nutzen. Es gibt ein Limit von 25 Containern in einer Datenbank mit freigegebenem Durchsatz. Wenn Sie nicht planen, eine Datenbank mit freigegebenem Durchsatz zu verwenden, erstellen Sie eine Datenbank, ohne die obigen Durchsatzheader festzulegen. Weitere Informationen
Body
| Eigenschaft | Erforderlich | type | BESCHREIBUNG |
|---|---|---|---|
| id | Erforderlich | String | Der vom Benutzer generierte eindeutige Name für die Datenbank. Es ist eine Zeichenfolge, die nicht mehr als 255 Zeichen sein darf. |
{
"id": "volcanodb2"
}
Antwort
Header
Informationen zu Headern, die von allen Azure Cosmos DB-Antworten zurückgegeben werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Antwortheader .
Statuscodes
In der folgenden Tabelle sind die allgemeinen Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der status Codes finden Sie unter HTTP-Statuscodes.
| HTTP-Statuscode | BESCHREIBUNG |
|---|---|
| 201 – Erstellt | Wird zurückgegeben, wenn der Vorgang erfolgreich ist. |
| 400 – Ungültige Anforderung | Wird zurückgegeben, wenn der JSON-Text ungültig ist. Überprüfen Sie, ob geschweifte Klammern oder Anführungszeichen fehlen. |
| 409 – Konflikt | Wird zurückgegeben, wenn die für die neue Datenbank angegebene ID von einer vorhandenen Datenbank übernommen wurde. |
Body
| Eigenschaft | BESCHREIBUNG |
|---|---|
| id | Der vom Benutzer generierte eindeutige Name für die Datenbank. |
| _los | Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der auch je nach Ressourcenstapel im Ressourcenmodell hierarchisch ist. Sie wird intern für die Platzierung der Dokumentressource und Navigation zu dieser verwendet. |
| _Ts | Es handelt sich um eine vom System generierte Eigenschaft. Sie gibt den zuletzt aktualisierten Zeitstempel der Ressource an. Der Wert ist ein Zeitstempel. |
| _Selbst | Es handelt sich um eine vom System generierte Eigenschaft. Es handelt sich um den eindeutigen, adressierbaren URI für die Ressource. |
| _Etag | Es handelt sich um eine vom System generierte Eigenschaft, die das Ressourcen-Etag angibt, das für die Kontrolle der optimistischen Parallelität erforderlich ist. |
| _colls | Es handelt sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Auflistungsressource angibt. |
| _Benutzer | Es handelt sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Benutzerressource angibt. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Beispiel 1
Im folgenden Beispiel wird eine Datenbank erstellt.
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\/"
}
Beispiel 2
Im folgenden Beispiel wird eine Datenbank mit freigegebenem Durchsatz mit einem manuellen Durchsatz von 400 RU/s erstellt. x-ms-offer-throughput header wird verwendet, um den Durchsatzwert (RU/s) festzulegen. Sie akzeptiert eine Zahl mit mindestens 400, die um Einheiten von 100 erhöht wird.
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"}
Beispiel 3
Im folgenden Beispiel wird eine Datenbank mit freigegebenem Durchsatz mit einem maximalen Durchsatz von 4.000 RU/s (Skalierung zwischen 400 und 4.000 RU/s) erstellt. x-ms-cosmos-offer-autopilot-settings header wird verwendet, um festzulegen, was der maxThroughputwert für die automatische Skalierung max RU/s ist. Sie akzeptiert eine Zahl mit mindestens 4000, die um Einheiten von 1000 erhöht wird.
Hinweis
Informationen zum Aktivieren der automatischen Skalierung für eine vorhandene Datenbank oder einen vorhandenen Container oder einen Wechsel von der automatischen Skalierung zum manuellen Durchsatz finden Sie im Artikel Ersetzen eines Angebots.
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"}