Excluir banco de dados
A Delete Database operação exclui um banco de dados existente 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 da mesma forma que você pode com os SDKs 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 da solicitação | Descrição |
|---|---|---|
| Delete (excluir) | https://{databaseaccount}.documents.azure.com/dbs/{db-id} |
O {databaseaccount} é o nome da conta do Azure Cosmos DB criada em sua assinatura. O valor {db-id} é o nome/ID gerado pelo usuário do banco de dados, não a ID gerada pelo sistema (rid). |
Cabeçalhos
Confira Cabeçalhos comuns de solicitação REST do Azure Cosmos DB para cabeçalhos usados por todas as solicitações do Cosmos DB.
Corpo
Nenhum.
Resposta
Cabeçalhos
Confira Cabeçalhos comuns de resposta REST do Azure Cosmos DB para cabeçalhos retornados por todas as respostas do 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 |
|---|---|
| 204 Sem Conteúdo | A operação de exclusão teve êxito. |
| 404 Não Encontrado | O banco de dados não foi encontrado. |
Corpo
Nenhum.
Exemplo
DELETE https://contosomarketing.documents.azure.com/dbs/volcanodb2 HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:43:19 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dA7Gg2gVKimd4r4WcuYh518tQsbTlgSZKSLx65e%2f%2f4Cw%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: 0
Connection: Keep-Alive
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: application/json
Content-Location: https://contosomarketing.documents.azure.com/dbs/volcanodb2
x-ms-resource-quota: databases=100;
x-ms-resource-usage: databases=14;
x-ms-session-token: 861
x-ms-request-charge: 4.95
x-ms-activity-id: b3c53c99-0d3c-433c-b77f-1e05217a1d81
Date: Tue, 08 Dec 2015 19:43:20 GMT
Comentários
A execução de um DELETE em um banco de dados exclui o recurso de banco de dados e seus recursos filho, ou seja, coleções, documentos, anexos, procedimentos armazenados, gatilhos, funções definidas pelo usuário, usuários e permissões dentro do banco de dados.