Create Database
Operacja Create Database tworzy nową bazę danych na koncie bazy danych.
Uwaga
W tych artykułach referencyjnych interfejsu API pokazano, jak tworzyć zasoby przy użyciu interfejsu API płaszczyzny danych usługi Azure Cosmos DB. Za pomocą interfejsu API płaszczyzny danych można skonfigurować podstawowe opcje, takie jak zasady indeksowania, klucze partycji, podobnie jak w przypadku zestawów SDK usługi Cosmos DB. Jeśli potrzebujesz pełnej obsługi funkcji dla wszystkich zasobów usługi Azure Cosmos DB, zalecamy użycie dostawcy zasobów usługi Cosmos DB.
Żądanie
| Metoda | Identyfikator URI żądania | Opis |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} to nazwa konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. |
Nagłówki
Zobacz Typowe nagłówki żądań REST usługi Azure Cosmos DB dla nagłówków używanych przez wszystkie żądania usługi Azure Cosmos DB.
| Właściwość | Wymagany | Typ | Opis |
|---|---|---|---|
| x-ms-offer-throughput | Opcjonalne | Liczba | Użytkownik określił przepływność ręczną (RU/s) dla bazy danych wyrażonej w jednostkach 100 jednostek żądań na sekundę. Wartość minimalna to 400 do 1 000 000 (lub wyższa, żądając zwiększenia limitu). Należy określić tylko jedną z wartości x-ms-offer-throughput lub x-ms-cosmos-offer-autopilot-settings . Tych nagłówków nie można określić razem. |
| x-ms-cosmos-offer-autopilot-settings | Opcjonalne | JSON | Użytkownik określił maksymalną wartość RU/s autoskalowania bazy danych. Wartość jest plikiem JSON z właściwością maxThroughput. Na przykład: {"maxThroughput": 4000}.Należy określić tylko jedną z wartości x-ms-offer-throughput lub x-ms-cosmos-offer-autopilot-settings . Tych nagłówków nie można określić razem. |
Uwaga
Jeśli ustawisz przepływność w bazie danych, spowoduje to utworzenie bazy danych z udostępnioną przepływnością , w której wszystkie kolekcje w niej współdzielą aprowizowaną przepływność. W bazie danych z udostępnioną przepływnością istnieje limit 25 kontenerów. Jeśli nie planujesz używania bazy danych z udostępnioną przepływnością, utwórz bazę danych bez ustawiania powyższych nagłówków przepływności. Dowiedz się więcej.
Treść
| Właściwość | Wymagany | Typ | Opis |
|---|---|---|---|
| identyfikator | Wymagane | Ciąg | Unikatowa nazwa bazy danych wygenerowana przez użytkownika. Jest to ciąg, który nie może zawierać więcej niż 255 znaków. |
{
"id": "volcanodb2"
}
Reakcja
Nagłówki
Zobacz Typowe nagłówki odpowiedzi REST usługi Azure Cosmos DB dla nagłówków zwracanych przez wszystkie odpowiedzi usługi Azure Cosmos DB.
Kody stanu
W poniższej tabeli wymieniono typowe kody stanu zwracane przez tę operację. Aby uzyskać pełną listę kodów stanu, zobacz Kody stanu HTTP.
| Kod stanu HTTP | Opis |
|---|---|
| Utworzono 201 | Zwracany, gdy operacja zakończy się pomyślnie. |
| 400 Nieprawidłowe żądanie | Zwracany, gdy treść JSON jest nieprawidłowa. Sprawdź brak nawiasów klamrowych lub cudzysłowów. |
| 409 Konflikt | Zwracany, gdy identyfikator podany dla nowej bazy danych został pobrany przez istniejącą bazę danych. |
Treść
| Właściwość | Opis |
|---|---|
| id | Unikatowa nazwa bazy danych wygenerowana przez użytkownika. |
| _Rid | Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) jest unikatowym identyfikatorem, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania zasobu bazy danych i nawigacji w nim. |
| _Ts | Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu. |
| _Własny | Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu. |
| _Etag | Jest to właściwość wygenerowana przez system, która określa tag zasobu wymagany do optymistycznej kontroli współbieżności. |
| _colls | Jest to właściwość wygenerowana przez system, która określa adresową ścieżkę zasobu kolekcji. |
| _Użytkowników | Jest to właściwość wygenerowana przez system, która określa adresową ścieżkę zasobu użytkowników. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Przykład 1
Poniższy przykład tworzy bazę danych.
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\/"
}
Przykład 2
Poniższy przykład tworzy bazę danych z udostępnioną przepływnością z ręczną przepływnością 400 RU/s.
x-ms-offer-throughput nagłówek służy do ustawiania wartości przepływności (RU/s). Akceptuje liczbę z co najmniej 400, która zwiększa się o jednostki 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"}
Przykład 3
Poniższy przykład tworzy bazę danych z udostępnioną przepływnością z maksymalną przepływnością autoskalowania 4000 RU/s (skaluje się między 400 a 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings nagłówek służy do ustawiania wartości , która jest wartością maksymalnej maxThroughputwartości RU/s autoskalowania. Akceptuje liczbę z co najmniej 4000, która zwiększa się o jednostki 1000.
Uwaga
Aby włączyć skalowanie automatyczne w istniejącej bazie danych lub kontenerze albo przełączyć się z autoskalowania do przepływności ręcznej, zobacz artykuł Replace an Offer (Zastępowanie oferty).
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"}