Delete Document
Azure Cosmos DB è un database multimodello distribuito a livello globale con supporto per più API. Questo articolo illustra l'API SQL per Azure Cosmos DB.
L'operazione Delete Document elimina un documento esistente in una raccolta.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| DELETE | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/docs/{doc-id} | Si noti che {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. |
Intestazioni
Vedere Intestazioni di richiesta REST comuni di Azure Cosmos DB per le intestazioni usate da tutte le richieste di Cosmos DB.
| Intestazione | Obbligatoria | Tipo | Description |
|---|---|---|---|
x-ms-documentdb-partitionkey |
Facoltativo | Array | Valore della chiave di partizione per il documento da eliminare. Deve essere incluso se e solo se la raccolta viene creata con una definizione partitionKey . |
Corpo
Nessuno.
Risposta
Il servizio restituisce un corpo della risposta vuoto.
Intestazioni
Vedere Intestazioni di risposta REST comuni di Azure Cosmos DB per le intestazioni restituite da tutte le risposte di Cosmos DB. Le intestazioni di risposta importanti per Elimina documento sono le seguenti:
| Proprietà | Type | Descrizione |
|---|---|---|
x-ms-request-charge |
Number | Numero di unità richiesta utilizzate dall'operazione. |
x-ms-session-token |
string | Token stringa usato con coerenza a livello di sessione. I client devono salvare questo valore e impostarlo per le successive richieste di lettura per la coerenza della sessione. |
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 204 No Content (Nessun contenuto) | L'operazione di eliminazione è riuscita. |
| 404 - Non trovato | Il documento non è stato trovato. |
Corpo
No.
Esempio
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