Eliminar uma Coleção
A Delete Collection operação elimina uma coleção existente numa 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 da mesma forma que pode 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 |
|---|---|---|
| DELETE | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id} | A {databaseaccount} é o nome da conta do Azure Cosmos DB criada na sua subscrição. O valor {db-id} é o nome/ID gerado pelo utilizador da base de dados e não o ID gerado pelo sistema (rid). O valor {coll-id} é o nome da coleção a eliminar. |
Cabeçalhos
Eliminar Coleção requer os cabeçalhos listados em Cabeçalhos de pedido REST do Azure Cosmos DB Comuns.
Corpo
Nenhum.
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, consulte Códigos de Estado HTTP.
| Código | Descrição |
|---|---|
| 204 Sem Conteúdo | A operação de eliminação foi efetuada com êxito. |
| 404 Não Encontrado | A coleção a eliminar já não é um recurso, ou seja, a coleção foi eliminada. |
Corpo
Nenhum.
Exemplo
DELETE https://querydemo.documents.azure.com/dbs/testdb/colls/testcoll HTTP/1.1
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dWmlMB62iSXF%2f0CUMyBD00AzOFH4LlcjzibmFC6zocxc%3d
Cache-Control: no-cache
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3
x-ms-version: 2015-12-16
Accept: application/json
Host: querydemo.documents.azure.com
Cookie: x-ms-session-token#0=365; x-ms-session-token=365
Content-Length: 0
HTTP/1.1 204 No Content
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Length: 0
Content-Type: application/json
Content-Location: https://querydemo.documents.azure.com/dbs/testdb/colls/testcoll
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Fri, 25 Mar 2016 22:54:09.213 GMT
x-ms-resource-quota: collections=5000;
x-ms-resource-usage: collections=28;
collection-partition-index: 0
collection-service-index: 0
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/testdb
x-ms-quorum-acked-lsn: 7850
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 4.95
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: c341354d-7040-4d01-8531-ab66caf7a01c
x-ms-session-token: M:7851
Set-Cookie: x-ms-session-token#M=7851; Domain=querydemo.documents.azure.com; Path=/dbs/-6MXAA==/colls/-6MXAPvmWww=
Set-Cookie: x-ms-session-token=7851; Domain=querydemo.documents.azure.com; Path=/dbs/-6MXAA==/colls/-6MXAPvmWww=
x-ms-gatewayversion: version=1.6.52.5
Date: Mon, 28 Mar 2016 20:56:35 GMT