Criar banco de dados
A Create Database operação cria um novo banco de dados na conta de banco de dados.
Observação
Esses artigos de referência de API mostram como criar recursos usando a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, você pode configurar opções básicas, como a política de indexação, chaves de partição como você pode com SDKs do Cosmos DB. Se você precisar de suporte completo para todos os recursos do Azure Cosmos DB, recomendamos usar o Provedor de Recursos do Cosmos DB.
Solicitação
| Método | URI da solicitação | Descrição |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
{databaseaccount} é o nome da conta do Azure Cosmos DB que você criou em sua assinatura. |
Cabeçalhos
Confira Cabeçalhos comuns de solicitação REST do Azure Cosmos DB para obter cabeçalhos usados por todas as solicitações do Azure Cosmos DB.
| Propriedade | Obrigatório | Type | Descrição |
|---|---|---|---|
| x-ms-offer-throughput | Opcional | Número | O usuário especificou a taxa de transferência manual (RU/s) para o banco de dados expresso em unidades de 100 unidades de solicitação por segundo. O mínimo é de 400 até 1.000.000 (ou superior, solicitando um aumento de limite). Apenas um de x-ms-offer-throughput ou x-ms-cosmos-offer-autopilot-settings deve ser especificado. Esses cabeçalhos não podem ser especificados juntos. |
| x-ms-cosmos-offer-autopilot-settings | Opcional | JSON | O usuário especificou o dimensionamento automático máximo de RU/s do banco de dados. O valor é um JSON com a propriedade maxThroughput. Por exemplo: {"maxThroughput": 4000}.Apenas um de x-ms-offer-throughput ou x-ms-cosmos-offer-autopilot-settings deve ser especificado. Esses cabeçalhos não podem ser especificados juntos. |
Observação
Se você definir a taxa de transferência em um banco de dados, isso criará um banco de dados de taxa de transferência compartilhado em que todas as coleções dentro dele compartilham a taxa de transferência provisionada. Há um limite de 25 contêineres em um banco de dados de taxa de transferência compartilhado. Se você não planeja usar um banco de dados de taxa de transferência compartilhada, crie um banco de dados sem definir os cabeçalhos de taxa de transferência acima. Saiba mais.
Corpo
| Propriedade | Obrigatório | Type | Descrição |
|---|---|---|---|
| id | Obrigatório | String | O nome exclusivo gerado pelo usuário para o banco de dados. É uma cadeia de caracteres que não deve ter mais de 255 caracteres. |
{
"id": "volcanodb2"
}
Resposta
Cabeçalhos
Consulte Cabeçalhos comuns de resposta REST do Azure Cosmos DB para obter cabeçalhos retornados por todas as respostas do Azure Cosmos DB.
Códigos de status
A tabela a seguir lista os códigos de status comuns retornados por esta operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.
| Código de status HTTP | Descrição |
|---|---|
| 201 Criado | Retornado quando a operação for bem-sucedida. |
| 400 Solicitação Inválida | Retornado quando o corpo JSON é inválido. Verifique por colchetes ou aspas ausentes. |
| 409 Conflito | Retornado quando a ID fornecida para o novo banco de dados foi tomada por um banco de dados existente. |
Corpo
| Propriedade | Descrição |
|---|---|
| id | O nome exclusivo gerado pelo usuário para o banco de dados. |
| _Livrar | É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. É usado internamente para colocação e navegação para o recurso do banco de dados. |
| _Ts | É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora. |
| _Auto | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo do recurso. |
| _Etag | É uma propriedade gerada pelo sistema que especifica a etag de recurso necessária para o controle de simultaneidade otimista. |
| _colls | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de coleções. |
| _Usuários | É uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de usuários. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Exemplo 1
O exemplo a seguir cria um banco de dados.
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\/"
}
Exemplo 2
O exemplo a seguir cria um banco de dados de taxa de transferência compartilhada com taxa de transferência manual de 400 RU/s. x-ms-offer-throughput o cabeçalho é usado para definir o valor de taxa de transferência (RU/s). Ele aceita um número com no mínimo 400 incrementos por 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"}
Exemplo 3
O exemplo a seguir cria um banco de dados de taxa de transferência compartilhada com taxa de transferência máxima de dimensionamento automático de 4000 RU/s (dimensiona entre 400 e 4000 RU/s). x-ms-cosmos-offer-autopilot-settings o cabeçalho é usado para definir o maxThroughput, que é o valor máximo de RU/s de dimensionamento automático. Ele aceita um número com no mínimo 4000 que incrementa por unidades de 1000.
Observação
Para habilitar o dimensionamento automático em um banco de dados ou contêiner existente ou alternar do dimensionamento automático para a taxa de transferência manual, consulte o artigo Substituir uma 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"}