Создание базы данных
Операция Create Database создает новую базу данных в учетной записи базы данных.
Примечание
В этих справочных статьях по API показано, как создавать ресурсы с помощью API плоскости данных Azure Cosmos DB. С помощью API плоскости данных можно настроить базовые параметры, такие как политика индексирования, ключи секций, так же, как в пакетах SDK для Cosmos DB. Если вам требуется полная поддержка функций для всех ресурсов Azure Cosmos DB, рекомендуется использовать поставщик ресурсов Cosmos DB.
Запрос
| Метод | Универсальный код ресурса (URI) запроса | Описание |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках подписки. |
Заголовки
Заголовки, используемые всеми запросами Azure Cosmos DB, см. в статье Общие заголовки запросов REST Azure Cosmos DB .
| Свойство | Обязательно | Тип | Описание |
|---|---|---|---|
| Пропускная способность x-ms-offer-throughput | Необязательно | Число | Пользователь указал пропускную способность вручную (ЕЗ/с) для базы данных, выраженную в единицах 100 единиц запросов в секунду. Минимальное значение — от 400 до 1 000 000 (или выше при запросе увеличения лимита). Необходимо указать только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки нельзя указать вместе. |
| x-ms-cosmos-offer-autopilot-settings | Необязательно | JSON | Пользователь указал максимальное значение ЕЗ/с автомасштабирования базы данных. Значением является JSON со свойством maxThroughput. Например: {"maxThroughput": 4000}.Необходимо указать только один из x-ms-offer-throughput или x-ms-cosmos-offer-autopilot-settings . Эти заголовки нельзя указать вместе. |
Примечание
Если вы задали пропускную способность для базы данных, создается база данных с общей пропускной способностью , в которой все коллекции в ней совместно используют подготовленную пропускную способность. В базе данных с общей пропускной способностью существует ограничение в 25 контейнеров. Если вы не планируете использовать базу данных с общей пропускной способностью, создайте базу данных, не задавая указанные выше заголовки пропускной способности. Подробнее.
Текст
| Свойство | Обязательно | Тип | Описание |
|---|---|---|---|
| идентификатор | Обязательно | Строка | Созданное пользователем уникальное имя базы данных. Это строка, которая не должна содержать более 255 символов. |
{
"id": "volcanodb2"
}
Ответ
Заголовки
Заголовки, возвращаемые всеми ответами Azure Cosmos DB, см. в статье Общие заголовки ответов REST Azure Cosmos DB .
Коды состояния
В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.
| Код состояния HTTP | Описание |
|---|---|
| 201 Создано | Возвращается, если операция выполнена успешно. |
| 400 — недопустимый запрос | Возвращается, если текст JSON является недопустимым. Проверьте наличие фигурных скобок и кавычек. |
| 409. Конфликт | Возвращается, когда идентификатор, предоставленный для новой базы данных, был взят существующей базой данных. |
Текст
| Свойство | Описание |
|---|---|
| идентификатор | Созданное пользователем уникальное имя базы данных. |
| _rid | Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения и перемещения к ресурсу базы данных. |
| _Ts | Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени. |
| _Самостоятельно | Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса. |
| _etag | Это созданное системой свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом. |
| _colls | Это созданное системой свойство, указывающее адресуемый путь к ресурсу коллекций. |
| _Пользователей | Это созданное системой свойство, указывающее адресуемый путь к ресурсу users. |
{
"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 Заголовок используется для задания значения пропускной способности (ЕЗ/с). Он принимает число не менее 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 Заголовок используется для задания 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"}