Criar a Base de Dados
A Create Database operação cria uma nova base de dados na conta da base de dados.
Nota
Estes artigos de referência da API mostram como criar recursos com a API do plano de dados do Azure Cosmos DB. Com a API do plano de dados, pode configurar opções básicas, como a política de indexação, chaves de partição tal como com os SDKs do Cosmos DB. Se precisar de suporte completo de funcionalidades para todos os recursos do Azure Cosmos DB, recomendamos que utilize o Fornecedor de Recursos do Cosmos DB.
Pedir
| Método | URI do pedido | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs |
A {databaseaccount} é o nome da conta do Azure Cosmos DB que criou na sua subscrição. |
Cabeçalhos
Veja Common Azure Cosmos DB REST request headers for headers that are used by all Azure Cosmos DB requests (Cabeçalhos de pedido REST do Azure Cosmos DB comuns para cabeçalhos que são utilizados por todos os pedidos do Azure Cosmos DB).
| Propriedade | Necessário | Tipo | Description |
|---|---|---|---|
| x-ms-offer-throughput | Opcional | Número | O utilizador especificou o débito manual (RU/s) para a base de dados expresso em unidades de 100 unidades de pedido por segundo. O mínimo é de 400 até 1000 000 (ou superior ao pedir um aumento de limite). Apenas um de x-ms-offer-throughput ou x-ms-cosmos-offer-autopilot-settings tem de ser especificado. Estes cabeçalhos não podem ser especificados em conjunto. |
| x-ms-cosmos-offer-autopilot-settings | Opcional | JSON | O utilizador especificou o dimensionamento automático máximo de RU/s da base 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 tem de ser especificado. Estes cabeçalhos não podem ser especificados em conjunto. |
Nota
Se definir débito numa base de dados, esta ação cria uma base de dados de débito partilhado onde todas as coleções na mesma partilham o débito aprovisionado. Existe um limite de 25 contentores numa base de dados de débito partilhado. Se não planear utilizar uma base de dados de débito partilhado, crie uma base de dados sem definir os cabeçalhos de débito acima. Saiba mais.
Corpo
| Propriedade | Necessário | Tipo | Descrição |
|---|---|---|---|
| ID | Necessário | String | O nome exclusivo gerado pelo utilizador para a base de dados. É uma cadeia que não pode ter mais de 255 carateres. |
{
"id": "volcanodb2"
}
Resposta
Cabeçalhos
Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Azure Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do Azure Cosmos DB).
Códigos de estado
A tabela seguinte lista os códigos de estado comuns devolvidos por esta operação. Para obter uma lista completa dos códigos de estado, veja Códigos de Estado HTTP.
| Código de estado de HTTP | Descrição |
|---|---|
| 201 Criado | Devolvido quando a operação é efetuada com êxito. |
| 400 Pedido Incorreto | Devolvido quando o corpo JSON é inválido. Verifique se existem parênteses ou aspas curvas em falta. |
| 409 Conflito | Devolvido quando o ID fornecido para a nova base de dados foi tomado por uma base de dados existente. |
Corpo
| Propriedade | Descrição |
|---|---|
| id | O nome exclusivo gerado pelo utilizador para a base de dados. |
| _rid | É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado internamente para colocação e navegação no recurso da base 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. |
| _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 recursos necessária para o controlo 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 dos utilizadores. |
{
"id": "volcanodb2",
"_rid": "CqNBAA==",
"_ts": 1449602962,
"_self": "dbs\/CqNBAA==\/",
"_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
"_colls": "colls\/",
"_users": "users\/"
}
Exemplo 1
O exemplo seguinte cria uma base 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 seguinte cria uma base de dados de débito partilhado com um débito manual de 400 RU/s.
x-ms-offer-throughput o cabeçalho é utilizado para definir o valor de débito (RU/s). Aceita um número com um mínimo de 400 que incrementa 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 seguinte cria uma base de dados de débito partilhado com um débito máximo de dimensionamento automático de 4000 RU/s (dimensiona entre 400 e 4000 RU/s).
x-ms-cosmos-offer-autopilot-settings o cabeçalho é utilizado para definir o maxThroughput, que é o valor máximo de RU/s de dimensionamento automático. Aceita um número com um mínimo de 4000 que incrementa por unidades de 1000.
Nota
Para ativar o dimensionamento automático numa base de dados ou contentor existente, ou mudar do dimensionamento automático para o débito manual, veja 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"}