Delete Container
Delete Container 操作は、指定されたコンテナーを削除対象としてマークします。 コンテナーとその中に含まれている BLOB は、後でガベージ コレクション中に削除されます。
Request
Delete Container 要求の構成は次のとおりです。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前に置き換えます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
DELETE |
https://myaccount.blob.core.windows.net/mycontainer?restype=container |
HTTP/1.1 |
エミュレートされたストレージ サービス URI
エミューレートされたストレージ サービスに対する要求では、エミュレーターのホスト名と BLOB Service ポートを 127.0.0.1:10000 と指定し、その後にエミューレートされたストレージ アカウント名を指定します。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
DELETE |
http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container |
HTTP/1.1 |
詳細については、「開発とテストにAzure Storage Emulatorを使用する」を参照してください。
URI パラメーター
次の追加パラメーターを要求の URI で指定できます。
| パラメーター | 説明 |
|---|---|
timeout |
省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 Blob Service 操作のタイムアウトの設定」を参照してください。 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、および署名を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。 |
Date または x-ms-date |
必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。 |
x-ms-lease-id: <ID> |
コンテナーがアクティブなリースを保持している場合、バージョン 2012-02-12 以降では必須です。 アクティブなリースを保持するコンテナーで Delete Container を呼び出すには、このヘッダーでリース ID を指定します。 アクティブなリースがあるときにこのヘッダーが指定されていない場合、Delete Container は 409 (Conflict) を返します。 誤ったリース ID (アクティブなリースを保持していないコンテナーのリース ID) を指定した場合、Delete Container は 412 (Precondition failed) を返します。 |
x-ms-version |
承認されたすべての要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
x-ms-client-request-id |
省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 KiB 文字制限を持つ、クライアントによって生成された不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Storage Analyticsログと Azure ログ: ログを使用したStorage要求の追跡」を参照してください。 |
この操作では、条件ヘッダーを使用して、指定した条件を満たした場合にのみコンテナーを削除することもできます。 詳細については、「BLOB サービス操作の条件ヘッダーの指定」を参照してください。
要求本文
[なし] :
要求のサンプル
Request Syntax:
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=
応答
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作が正常に終了すると、ステータス コード 202 (Accepted) が返されます。
状態コードの詳細については、「 状態とエラー コード」を参照してください。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
| 応答ヘッダー | 説明 |
|---|---|
x-ms-request-id |
このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用する BLOB サービスのバージョンを示します。 このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。 |
Date |
サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。 |
x-ms-client-request-id |
このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値 x-ms-client-request-id が最大 1024 文字の ASCII 文字で表示される場合、ヘッダーの値と同じです。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。 |
応答本文
[なし] :
応答のサンプル
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Sun, 25 Sep 2011 21:45:00 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
承認
この操作を呼び出すことができるのはアカウント所有者のみです。
解説
コンテナーを削除した場合、少なくとも 30 秒間は同じ名前のコンテナーを作成できません。サービスがまだ要求を処理中である場合は、30 秒より長い間コンテナーを使用できないことがあります。 コンテナーの削除中に同じ名前のコンテナーを作成しようとすると、ステータス コード 409 (Conflict) で失敗します。サービスは、コンテナーが削除中であることを示す追加のエラー情報を返します。 その他すべての操作は (コンテナーの下位にある BLOB の操作を含む)、コンテナーの削除中はステータス コード 404 (Not Found) で失敗します。