Creación de una base de datos
La Create Database operación crea una nueva base de datos en la cuenta de base de datos.
Nota
En estos artículos de referencia de API se muestra cómo crear recursos mediante la API del plano de datos de Azure Cosmos DB. Con la API del plano de datos, puede configurar opciones básicas, como la directiva de indexación, las claves de partición del mismo modo que puede con los SDK de Cosmos DB. Si necesita compatibilidad completa con características para todos los recursos de Azure Cosmos DB, se recomienda usar el proveedor de recursos de Cosmos DB.
Solicitud
| Método | URI de solicitud | Descripción |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} es el nombre de la cuenta de Azure Cosmos DB que creó en la suscripción. |
encabezados
Consulte Encabezados de solicitud REST comunes de Azure Cosmos DB para ver los encabezados que usan todas las solicitudes de Azure Cosmos DB.
| Propiedad | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| x-ms-offer-throughput | Opcionales | Number | El usuario especificó un rendimiento manual (RU/s) para la base de datos expresado en unidades de 100 unidades de solicitud por segundo. El mínimo es de 400 hasta 1 000 000 (o superior solicitando un aumento del límite). Solo se debe especificar uno de x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Estos encabezados no se pueden especificar juntos. |
| x-ms-cosmos-offer-autopilot-settings | Opcionales | JSON | El usuario especificó un máximo de RU/s de escalabilidad automática de la base de datos. El valor es un JSON con la propiedad maxThroughput. Por ejemplo: {"maxThroughput": 4000}.Solo se debe especificar uno de x-ms-offer-throughput o x-ms-cosmos-offer-autopilot-settings . Estos encabezados no se pueden especificar juntos. |
Nota
Si establece el rendimiento en una base de datos, se crea una base de datos de rendimiento compartida en la que todas las colecciones que contiene comparten el rendimiento aprovisionado. Hay un límite de 25 contenedores en una base de datos de rendimiento compartido. Si no tiene previsto usar una base de datos de rendimiento compartido, cree una base de datos sin establecer los encabezados de rendimiento anteriores. Más información.
Body
| Propiedad | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| id | Requerido | String | Nombre único generado por el usuario para la base de datos. Es una cadena que no debe tener más de 255 caracteres. |
{
"id": "volcanodb2"
}
Response
encabezados
Consulte Encabezados de respuesta REST comunes de Azure Cosmos DB para ver los encabezados devueltos por todas las respuestas de Azure Cosmos DB.
Códigos de estado
La tabla siguiente muestra los códigos de estado comunes que devuelve esta operación. Para obtener una lista completa de los códigos de estado, consulte Códigos de estado HTTP.
| Código de estado HTTP | Descripción |
|---|---|
| 201 Creado | Se devuelve cuando la operación es correcta. |
| 400 - Solicitud incorrecta | Se devuelve cuando el cuerpo JSON no es válido. Compruebe si faltan llaves o comillas. |
| 409 Conflicto | Se devuelve cuando una base de datos existente ha tomado el identificador proporcionado para la nueva base de datos. |
Body
| Propiedad | Descripción |
|---|---|
| id | Nombre único generado por el usuario para la base de datos. |
| _Librar | Es una propiedad generada por el sistema. El identificador de recurso (_rid) es un identificador único que también es jerárquico por la pila de recursos en el modelo de recursos. Se usa internamente para la colocación y el desplazamiento en el recurso de base de datos. |
| _Ts | Es una propiedad generada por el sistema. Especifica la última marca de tiempo actualizada del recurso. El valor es una marca de tiempo. |
| _propio | Es una propiedad generada por el sistema. Es el URI direccionable único para el recurso. |
| _Etag | Se trata de una propiedad generada por el sistema que especifica la etiqueta electrónica de recursos necesaria para el control de simultaneidad optimista. |
| _colls | Es una propiedad generada por el sistema que especifica la ruta de acceso direccionable del recurso de colecciones. |
| _Usuarios | Es una propiedad generada por el sistema que especifica la ruta de acceso direccionable del recurso users. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Ejemplo 1
En el ejemplo siguiente se crea una base de datos.
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\/"
}
Ejemplo 2
En el ejemplo siguiente se crea una base de datos de rendimiento compartido con un rendimiento manual de 400 RU/s.
x-ms-offer-throughput el encabezado se usa para establecer el valor de rendimiento (RU/s). Acepta un número con un mínimo de 400 que aumenta en unidades de 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"}
Ejemplo 3
En el ejemplo siguiente se crea una base de datos de rendimiento compartido con un rendimiento máximo de escalabilidad automática de 4000 RU/s (se escala entre 400 y 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings el encabezado se usa para establecer , maxThroughputque es el valor máximo de RU/s de escalabilidad automática. Acepta un número con un mínimo de 4000 que se incrementa en unidades de 1000.
Nota
Para habilitar la escalabilidad automática en una base de datos o contenedor existente, o cambiar de escalabilidad automática a rendimiento manual, consulte el artículo Reemplazar una oferta.
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"}