Создание базы данных

Операция Create Database создает новую базу данных в учетной записи базы данных.

Замечание

В этих справочных статьях по API показано, как создавать ресурсы с помощью API плоскости данных Azure Cosmos DB. С помощью API плоскости данных можно настроить основные параметры, такие как политика индексирования, ключи секций, так же, как это можно сделать с помощью комплектов разработки программного обеспечения (SDK) Cosmos DB. Если вам требуется полная поддержка функций для всех ресурсов Azure Cosmos DB, рекомендуется использовать поставщик ресурсов Cosmos DB.

Просьба

Метод	Запрос URI	Описание
ПОСТ	https://{databaseaccount}.documents.azure.com/dbs	{databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках подписки.

Заголовки

Заголовки, используемые всеми запросами Azure Cosmos DB, см. в статье Общие заголовки запросов Azure Cosmos DB REST .

Недвижимость	Обязательно	Тип	Описание
x-ms-offer-пропускная способность	Необязательно	Номер	Пользователь указал пропускную способность вручную (ЕЗ/с) для базы данных, выраженную в единицах по 100 единиц запроса в секунду. Минимальный размер составляет от 400 до 1 000 000 (или выше, запросив увеличение лимита). Должен быть указан только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки не могут быть указаны вместе.
x-ms-cosmos-предложить-автопилот-настройки	Необязательно	JSON (JavaScript Object Notation)	Пользователь указал максимальное количество ЕЗ/с для базы данных с автомасштабированием. Значением является JSON со свойством maxThroughput. Например: {"maxThroughput": 4000}. Должен быть указан только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки не могут быть указаны вместе.

Замечание

Если задать пропускную способность для базы данных, создается база данных с общей пропускной способностью , в которой все коллекции в ней совместно используют подготовленную пропускную способность. В базе данных с общей пропускной способностью может быть не более 25 контейнеров. Если вы не планируете использовать базу данных с общей пропускной способностью, создайте базу данных без задания заголовков пропускной способности. Подробнее.

Тело

Недвижимость	Обязательно	Тип	Описание
id	Обязательно	Струна	Созданное пользователем уникальное имя базы данных. Это строка, которая не должна быть больше 255 символов.

{  
  "id": "volcanodb2"  
}  
  

Ответ

Заголовки

Заголовки, возвращаемые всеми ответами Azure Cosmos DB, см. в статье Общие заголовки ответа Azure Cosmos DB REST .

Коды состояния

В следующей таблице перечислены распространенные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.

Код состояния HTTP	Описание
201 Создано	Возвращается, когда операция выполнена успешно.
400 Недопустимый запрос	Возвращается, если тело JSON недопустимо. Проверьте отсутствие фигурных скобок или кавычки.
409. Конфликт	Возвращается, когда идентификатор, предоставленный для новой базы данных, был занят существующей базой данных.

Тело

Недвижимость	Описание
идентификатор	Созданное пользователем уникальное имя базы данных.
_избавлять	Это свойство, сгенерированное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется внутри компании для размещения и навигации к ресурсу базы данных.
_ts	Это свойство, созданное системой. Он задает последнюю обновленную метку времени ресурса. Значение — метка времени.
_сам	Это свойство, созданное системой. Это уникальный адресируемый URI ресурса.
_etag	Это сгенерированное системой свойство, которое указывает тег ресурса, необходимый для управления оптимистичным параллелизмом.
_colls	Это сгенерированное системой свойство, которое указывает адресуемый путь к ресурсу коллекции.
_Пользователей	Это сгенерированное системой свойство, которое указывает адресуемый путь к ресурсу пользователя.

{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}  
  

Пример 1

В следующем примере создается база данных.

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

Пример 2

В следующем примере создается база данных с общей пропускной способностью и пропускной способностью вручную 400 ЕЗ/с. x-ms-offer-throughput header используется для установки значения пропускной способности (ЕЗ/с). Он принимает число с минимальным значением 400, которое увеличивается на единицы 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"}  

Пример 3

В следующем примере создается база данных с общей пропускной способностью и максимальной пропускной способностью автомасштабирования 4000 ЕЗ/с (масштабируется от 400 до 4000 ЕЗ/с). x-ms-cosmos-offer-autopilot-settings header используется для установки maxThroughputзначения , которое является максимальным значением автомасштабирования ЕЗ/с. Он принимает число с минимальным значением 4000, которое увеличивается на единицы 1000.

Замечание

Сведения о включении автомасштабирования в существующей базе данных или контейнере или переключении с автомасштабирования на ручную пропускную способность см. в статье Замена предложения.

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

См. также

• Azure Cosmos DB
• API SQL Azure Cosmos DB
• пакеты SDK ДЛЯ API SQL Для Azure Cosmos DB
• REST из примера .NET