ドキュメントの削除
Azure Cosmos DB は、グローバル分散型のマルチモデル データベースであり、複数の API でサポートされています。 この記事では、Azure Cosmos DB 用の SQL API について説明します。
この操作により Delete Document 、コレクション内の既存のドキュメントが削除されます。
Request
| Method | 要求 URI | 説明 |
|---|---|---|
| DELETE | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/docs/{doc-id} | {databaseaccount} は、サブスクリプションの下に作成された Azure Cosmos DB アカウントの名前であることに注意してください。 |
ヘッダー
すべての Cosmos DB 要求 で使用されるヘッダーについては、「共通の Azure Cosmos DB REST 要求ヘッダー」を参照してください。
| ヘッダー | 必須 | Type | 説明 |
|---|---|---|---|
x-ms-documentdb-partitionkey |
省略可能 | Array | 削除するドキュメントのパーティション キー値。 partitionKey 定義を使用してコレクションが作成される場合にのみ、 と を含む必要があります。 |
本文
なし。
[応答]
サービスからは空の応答本文が返されます。
ヘッダー
すべての Cosmos DB 応答によって返されるヘッダーについては、「 共通の Azure Cosmos DB REST 応答ヘッダー 」を参照してください。 ドキュメントの削除の重要な応答ヘッダーは次のとおりです。
| プロパティ | Type | 説明 |
|---|---|---|
x-ms-request-charge |
番号 | 操作で使用された要求ユニットの数。 |
x-ms-session-token |
String | セッション レベルの整合性で使用される文字列トークン。 クライアントは、この値を保存し、セッション整合性のために後続の読み取り要求用に設定する必要があります。 |
状態コード
次の表に、この操作で返される一般的なステータス コードを示します。 状態コードの完全な一覧については、「 HTTP 状態コード」を参照してください。
| HTTP 状態コード | 説明 |
|---|---|
| 204 No Content | 削除操作は成功しました。 |
| 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