Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Create Database Vorgang erstellt eine neue Datenbank im Datenbankkonto.
Hinweis
In diesen API-Referenzartikeln wird gezeigt, wie Sie Ressourcen mithilfe der Azure Cosmos DB-Datenebenen-API erstellen. Mit der Datenebenen-API können Sie grundlegende Optionen konfigurieren, z. B. Indizierungsrichtlinien und Partitionsschlüssel, ähnlich wie bei Cosmos DB Software Development Kits (SDKs). Wenn Sie vollständige Featureunterstützung für alle Azure Cosmos DB-Ressourcen benötigen, empfehlen wir die Verwendung des Cosmos DB-Ressourcenanbieters.
Anfrage
| Methode | Anforderungs-URI | BESCHREIBUNG |
|---|---|---|
| SENDEN | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} ist der Name des Azure Cosmos DB-Kontos, das Sie im Rahmen Ihres Abonnements erstellt haben. |
Überschriften
Header, die von allen Azure Cosmos DB-Anforderungen verwendet werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader .
| Eigentum | Erforderlich | Typ | BESCHREIBUNG |
|---|---|---|---|
| x-ms-angebot-durchsatz | Wahlfrei | Nummer | Der vom Benutzer angegebene manuelle Durchsatz (RU/s) für die Datenbank, ausgedrückt in Einheiten von 100 Anforderungseinheiten pro Sekunde. Das Minimum liegt bei 400 bis 1.000.000 (oder höher, indem Sie eine Limiterhöhung beantragen). 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-angebot-autopilot-einstellungen | Wahlfrei | JSON | Der vom Benutzer angegebene maximale RU/s für die automatische Skalierung der Datenbank. 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 darin enthaltenen Sammlungen den bereitgestellten Durchsatz teilen. Es gibt einen Grenzwert von 25 Containern in einer Datenbank mit freigegebenem Durchsatz. Wenn Sie nicht vorhaben, eine Datenbank mit freigegebenem Durchsatz zu verwenden, erstellen Sie eine Datenbank, ohne die Durchsatzheader festzulegen. Erfahren Sie mehr.
Körper
| Eigentum | Erforderlich | Typ | BESCHREIBUNG |
|---|---|---|---|
| id | Erforderlich | Schnur | Der vom Benutzer generierte eindeutige Name für die Datenbank. Es handelt sich um eine Zeichenfolge, die nicht länger als 255 Zeichen sein darf. |
{
"id": "volcanodb2"
}
Antwort
Überschriften
Header, 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 allgemeine Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der Statuscodes finden Sie unter HTTP-Statuscodes.
| HTTP-Statuscode | BESCHREIBUNG |
|---|---|
| 201 Erstellt | Wird zurückgegeben, wenn der Vorgang erfolgreich ist. |
| 400 Fehlerhafte Anfrage | 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. |
Körper
| Eigentum | 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 hierarchisch pro Ressourcenstapel im Ressourcenmodell ist. Es wird intern für die Platzierung und Navigation zur Datenbankressource verwendet. |
| _ts | Es handelt sich um eine vom System generierte Eigenschaft. Er gibt den letzten aktualisierten Zeitstempel der Ressource an. Der Wert ist ein Zeitstempel. |
| _selbst | Es handelt sich um eine vom System generierte Eigenschaft. Dies ist der eindeutige adressierbare URI für die Ressource. |
| _etag | Es handelt sich um eine vom System generierte Eigenschaft, die das Ressourcen-ETAG angibt, das für die Steuerung der optimistischen Parallelität erforderlich ist. |
| _colls | Dabei handelt es sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Sammlungsressource 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 und einem manuellen Durchsatz von 400 RU/s erstellt.
x-ms-offer-throughput -Header wird verwendet, um den Durchsatzwert (RU/s) festzulegen. Es akzeptiert eine Zahl mit mindestens 400, die um die Einheiten 100 inkrementiert 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 4000 RU/s für die automatische Skalierung erstellt (skaliert zwischen 400 und 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings -Header wird verwendet, um den maxThroughputfestzulegen, d. h. den maximalen RU/s-Wert für die automatische Skalierung. Es akzeptiert eine Zahl mit mindestens 4000, die um die Einheiten 1000 inkrementiert wird.
Hinweis
Informationen zum Aktivieren der automatischen Skalierung für eine vorhandene Datenbank oder einen vorhandenen Container oder zum 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"}