Odstranění dokumentu
Azure Cosmos DB je globálně distribuovaná databáze pro více modelů s podporou několika rozhraní API. Tento článek se věnuje rozhraní SQL API pro službu Azure Cosmos DB.
Operace Delete Document odstraní existující dokument v kolekci.
Žádost
| Metoda | Identifikátor URI žádosti | Description |
|---|---|---|
| DELETE | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{id_coll}/docs/{doc-id} | Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB vytvořeného v rámci vašeho předplatného. |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Cosmos DB.
| Hlavička | Požaduje se | Typ | Description |
|---|---|---|---|
x-ms-documentdb-partitionkey |
Volitelné | Pole | Hodnota klíče oddílu pro dokument, který se má odstranit. Musí být zahrnuta pouze v případě, že je kolekce vytvořena s definicí partitionKey . |
Text
Žádné
Odpověď
Služba vrátí prázdný text odpovědi.
Hlavičky
Viz Běžné hlavičky odpovědi REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Cosmos DB. Důležité hlavičky odpovědi pro odstranění dokumentu jsou následující:
| Vlastnost | Typ | Description |
|---|---|---|
x-ms-request-charge |
Číslo | Počet jednotek požadavků spotřebovaných operací. |
x-ms-session-token |
Řetězec | Token řetězce používaný s konzistencí na úrovni relace. Klienti musí tuto hodnotu uložit a nastavit ji pro následné žádosti o čtení kvůli konzistenci relací. |
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
| Stavový kód HTTP | Popis |
|---|---|
| 204 Žádný obsah | Operace odstranění byla úspěšná. |
| 404 Nenalezeno | Dokument nebyl nalezen. |
Text
Žádné
Příklad
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