Skapa databas
Åtgärden Create Database skapar en ny databas i databaskontot.
Anteckning
Dessa API-referensartiklar visar hur du skapar resurser med hjälp av Azure Cosmos DB-dataplans-API:et. Med API:et för dataplanet kan du konfigurera grundläggande alternativ, till exempel indexeringsprincip, partitionsnycklar ungefär som du kan med Cosmos DB-SDK:er. Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern.
Förfrågan
| Metod | URI för förfrågan | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade under din prenumeration. |
Sidhuvuden
Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Azure Cosmos DB-begäranden.
| Egenskap | Krävs | Typ | Description |
|---|---|---|---|
| x-ms-offer-throughput | Valfritt | Tal | Användaren angav manuellt dataflöde (RU/s) för databasen uttryckt i enheter med 100 enheter för programbegäran per sekund. Minimivärdet är 400 upp till 1 000 000 (eller högre genom att begära en gränsökning). Endast en av x-ms-offer-throughput eller x-ms-cosmos-offer-autopilot-settings måste anges. Dessa rubriker kan inte anges tillsammans. |
| x-ms-cosmos-offer-autopilot-settings | Valfritt | JSON | Användaren har angett maximalt antal RU/s för databasen för autoskalning. Värdet är en JSON med egenskapen maxThroughput. Exempel: {"maxThroughput": 4000}.Endast en av x-ms-offer-throughput eller x-ms-cosmos-offer-autopilot-settings måste anges. Dessa rubriker kan inte anges tillsammans. |
Anteckning
Om du anger dataflöde för en databas skapas en databas med delat dataflöde där alla samlingar i den delar det etablerade dataflödet. Det finns en gräns på 25 containrar i en databas med delat dataflöde. Om du inte planerar att använda en databas med delat dataflöde skapar du en databas utan att ange ovanstående dataflödesrubriker. Läs mer.
Brödtext
| Egenskap | Krävs | Typ | Description |
|---|---|---|---|
| id | Obligatorisk | Sträng | Det användargenererade unika namnet för databasen. Det är en sträng som inte får innehålla fler än 255 tecken. |
{
"id": "volcanodb2"
}
Svarsåtgärder
Sidhuvuden
Se Vanliga REST-svarshuvuden för Azure Cosmos DB för rubriker som returneras av alla Azure Cosmos DB-svar.
Statuskoder
I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.
| HTTP-statuskod | Beskrivning |
|---|---|
| 201 Skapad | Returneras när åtgärden lyckas. |
| 400 Felaktig begäran | Returneras när JSON-brödtexten är ogiltig. Sök efter saknade klammerparenteser eller citattecken. |
| 409 – Konflikt | Returneras när det ID som angetts för den nya databasen har tagits av en befintlig databas. |
Brödtext
| Egenskap | Beskrivning |
|---|---|
| id | Det användargenererade unika namnet för databasen. |
| _Bli | Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Det används internt för placering av och navigering till databasresursen. |
| _Ts | Det är en systemgenererad egenskap. Den anger den senast uppdaterade tidsstämpeln för resursen. Värdet är en tidsstämpel. |
| _Själv | Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen. |
| _Etag | Det är en systemgenererad egenskap som anger resursetaggen som krävs för optimistisk samtidighetskontroll. |
| _colls | Det är en systemgenererad egenskap som anger den adresserbara sökvägen för samlingsresursen. |
| _Användare | Det är en systemgenererad egenskap som anger den adresserbara sökvägen för användarresursen. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Exempel 1
I följande exempel skapas en databas.
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\/"
}
Exempel 2
I följande exempel skapas en databas för delat dataflöde med ett manuellt dataflöde på 400 RU/s. x-ms-offer-throughput -huvudet används för att ange dataflödesvärdet (RU/s). Den accepterar ett tal med minst 400 som ökar med enheter på 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"}
Exempel 3
I följande exempel skapas en databas för delat dataflöde med maximalt dataflöde för autoskalning på 4 000 RU/s (skalar mellan 400 och 4 000 RU/s). x-ms-cosmos-offer-autopilot-settings -huvudet används för att ange maxThroughput, vilket är max-RU/s-värdet för autoskalning. Den accepterar ett tal med minst 4 000 som ökar med enheter på 1 000.
Anteckning
Om du vill aktivera autoskalning för en befintlig databas eller container, eller växla från autoskalning till manuellt dataflöde, kan du läsa artikeln Ersätt ett erbjudande.
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"}