Compartilhar via

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 política de indexação, chaves de partição, da mesma forma que você pode fazer com SDKs (kits de desenvolvimento de software) do Cosmos DB. Se você precisar de suporte completo a recursos para todos os recursos do Azure Cosmos DB, recomendamos usar o Provedor de Recursos do Cosmos DB.

Solicitação

Método URI de solicitação Descrição
PUBLICAR https://{databaseaccount}.documents.azure.com/dbs O {databaseaccount} é o nome da conta do Azure Cosmos DB que você criou em sua assinatura.

Cabeçalhos

Consulte Cabeçalhos de solicitação REST comuns do Azure Cosmos DB para obter cabeçalhos usados por todas as solicitações do Azure Cosmos DB.

Propriedade Obrigatório Tipo Descrição
x-ms-taxa de transferência de oferta Opcional Número A taxa de transferência manual (RU/s) especificada pelo usuário para o banco de dados expressa em unidades de 100 unidades de solicitação por segundo. O mínimo é de 400 a 1.000.000 (ou mais, 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 compartilhado, crie um banco de dados sem definir os cabeçalhos de taxa de transferência. Saiba mais.

Corpo

Propriedade Obrigatório Tipo Descrição
id Obrigatório fio 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 de resposta REST comuns 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 essa operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.

Código de status de HTTP Descrição
201 Criado Retornado quando a operação é 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 obtida 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. Ele é usado internamente para posicionamento e navegação para o recurso de banco de dados.
_Ts É uma propriedade gerada pelo sistema. Ele especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora.
_eu É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o 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 compartilhado com taxa de transferência manual de 400 RU/s. x-ms-offer-throughput header é usado para definir o valor de taxa de transferência (RU/s). Ele aceita um número com no mínimo 400 que é incrementado em 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 compartilhado com taxa de transferência máxima de dimensionamento automático de 4000 RU/s (escala entre 400 e 4000 RU/s). x-ms-cosmos-offer-autopilot-settings é 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 é incrementado em 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"}

Consulte Também

  • Last updated on