Excluir Documento
O Azure Cosmos DB é um serviço de banco de dados multimodelo globalmente distribuído compatível com várias APIs. Este artigo cobre a API do SQL do Azure Cosmos DB.
A Delete Document operação exclui um documento existente em uma coleção.
Solicitação
| Método | URI da solicitação | Descrição |
|---|---|---|
| Delete (excluir) | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/docs/{doc-id} | Observe que {databaseaccount} é o nome da conta do Azure Cosmos DB criada em sua assinatura. |
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.
| parâmetro | Obrigatório | Type | Descrição |
|---|---|---|---|
x-ms-documentdb-partitionkey |
Opcional | Array | O valor da chave de partição para o documento a ser excluído. Deve ser incluído se e somente se a coleção for criada com uma definição partitionKey . |
Corpo
Nenhum.
Resposta
O serviço retorna um corpo de resposta vazio.
Cabeçalhos
Confira Cabeçalhos comuns de resposta REST do Azure Cosmos DB para cabeçalhos retornados por todas as respostas do Cosmos DB. Os cabeçalhos de resposta importantes para Excluir Documento são os seguintes:
| Propriedade | Type | Descrição |
|---|---|---|
x-ms-request-charge |
Número | O número de unidades de solicitação consumidas pela operação. |
x-ms-session-token |
String | Um token de cadeia de caracteres usado com consistência no nível da sessão. Os clientes devem salvar esse valor e defini-lo para solicitações de leitura subsequentes para consistência de sessão. |
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 documento não foi encontrado. |
Corpo
Nenhum.
Exemplo
DELETE https://querydemo.documents.azure.com/dbs/testdb/colls/testcoll/docs/SalesOrder3 HTTP/1.1
x-ms-documentdb-partitionkey: ["Account1"]
x-ms-date: Tue, 29 Mar 2016 02:03:07 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dvR4ZglipsSQvOX176KTSLz7G21rfxS784sxfUEae4N0%3d
Cache-Control: no-cache
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0
x-ms-version: 2015-12-16
Accept: application/json
Host: querydemo.documents.azure.com
Cookie: x-ms-session-token#0=775; x-ms-session-token=775
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/docs/SalesOrder3
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-resource-quota: documentSize=10240;documentsSize=10485760;collectionSize=10485760;
x-ms-resource-usage: documentSize=0;documentsSize=2;collectionSize=2;
x-ms-alt-content-path: dbs/testdb/colls/testcoll
x-ms-content-path: d9RzAJRFKgw=
x-ms-request-charge: 9.33
x-ms-activity-id: 01b5b7fc-824d-4945-b6ce-4eb3532584a1
x-ms-session-token: 0:776
Set-Cookie: x-ms-session-token#0=776; Domain=querydemo.documents.azure.com; Path=/dbs/testdb/colls/testcoll
Set-Cookie: x-ms-session-token=776; Domain=querydemo.documents.azure.com; Path=/dbs/testdb/colls/testcoll
Date: Tue, 29 Mar 2016 02:03:07 GMT