Partilhar via

Criar banco de dados

A Create Database operação cria um novo banco de dados na conta do banco de dados.

Observação

Estes 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 pode fazer com os SDKs (Software Development Kits) 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.

Request

Método Solicitar URI Descrição
Publicação https://{databaseaccount}.documents.azure.com/dbs {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 cabeçalhos que são usados por todas as solicitações do Azure Cosmos DB.

Propriedade Obrigatório Tipo Descrição
Taxa de transferência X-MS-Offer- Opcional Número A taxa de transferência manual especificada pelo usuário (RU/s) para o banco de dados expressa 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 dos 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-configurações Opcional JSON O usuário especificou a escala automática máxima de RU/s do banco de dados. O valor é um JSON com a propriedade maxThroughput. Por exemplo: {"maxThroughput": 4000}.

Apenas um dos 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 onde 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. Mais informações.

Corpo

Propriedade Obrigatório Tipo Descrição
id Obrigatório Cordão 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 de cabeçalhos de resposta REST comuns do Azure Cosmos DB para 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 estado de HTTP Descrição
201 Criado Retornado quando a operação é bem-sucedida.
400 Pedido Inválido Retornado quando o corpo JSON é inválido. Verifique se faltam parênteses ou cotações.
409 Conflito Retornado quando a ID fornecida para o novo banco de dados tiver sido obtida por um banco de dados existente.

Corpo

Propriedade Descrição
ID O nome exclusivo gerado pelo usuário para o banco de dados.
_rid É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico pela pilha de recursos no modelo de recursos. 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.
_self É 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.
_users É 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). Aceita um número com um mínimo de 400 que aumenta 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 compartilhado com taxa de transferência máxima de escala automática de 4000 RU/s (escala entre 400 e 4000 RU/s). x-ms-cosmos-offer-autopilot-settings header é usado para definir o maxThroughput, que é o valor máximo de RU/s de escala automática. Aceita um número com um mínimo de 4000 que aumenta 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"}

Ver também

  • Last updated on