刪除文件
Azure Cosmos DB 是全域散發的多模型資料庫，並可支援多個 API。 本文涵蓋適用於 Azure Cosmos DB 的 SQL API。
作業 Delete Document 會刪除集合中的現有檔。
要求
| 方法 | 要求 URI | Description |
|---|---|---|
| 刪除 | HTTPs://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/docs/{doc-id} | 請注意，{databaseaccount} 是您訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。 |
標題
如需所有 Cosmos DB 要求所使用的標頭，請參閱常見的 Azure Cosmos DB REST 要求標頭 。
| 標頭 | 必要 | 類型 | 說明 |
|---|---|---|---|
x-ms-documentdb-partitionkey |
選用 | Array | 要刪除之檔的分割區索引鍵值。 只有在使用 partitionKey 定義建立集合時，才必須包含 。 |
主體
無。
回應
服務傳回空白回應本文。
標題
如需所有 Cosmos DB 回應所傳回的標頭，請參閱 常見的 Azure Cosmos DB REST 回應標頭 。 刪除檔的重要回應標頭如下：
| 屬性 | 類型 | Description |
|---|---|---|
x-ms-request-charge |
數字 | 作業所耗用的要求單位數目。 |
x-ms-session-token |
String | 搭配工作階段層級一致性使用的字串權杖。 用戶端必須儲存此值，並針對會話一致性的後續讀取要求設定此值。 |
狀態碼
下表列出此作業所傳回的常見狀態碼。 如需狀態碼的完整清單，請參閱 HTTP 狀態碼。
| HTTP 狀態碼 | Description |
|---|---|
| 204 沒有內容 | 刪除作業成功。 |
| 404 找不到 | 找不到文件。 |
主體
無。
範例
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