エクスポート (0) 印刷
すべて展開

Delete Blob

更新日: 2014年1月

Delete Blob 操作は、指定した BLOB またはスナップショットを削除対象としてマークします。BLOB は、後でガベージ コレクション中に削除されます。

BLOB を削除するには、そのスナップショットをすべて削除する必要があります。Delete Blob 操作では、両方を同時に削除できます。

Delete Blob 要求の構成は次のとおりです。HTTPS が推奨されます。myaccount はストレージ アカウントの名前に置き換えます。

 

  DELETE メソッド要求の URI HTTP バージョン

https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

HTTP/1.1

エミューレートされたストレージ サービスに対する要求では、エミュレーターのホスト名と BLOB サービス ポートを 127.0.0.1:10000 と指定し、その後にエミューレートされたストレージ アカウント名を指定します。

 

  DELETE メソッド要求の URI HTTP バージョン

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob

HTTP/1.1

詳細については、「開発とテストのための Azure のストレージ エミュレーター使用」を参照してください。

次の追加パラメーターを要求の URI で指定できます。

 

Parameter 説明

snapshot

省略可能。snapshot パラメーターは、BLOB のスナップショットが存在する場合に、削除するスナップショットを指定する非透過的な DateTime 値です。BLOB のスナップショットの操作の詳細については、「BLOB のスナップショットの作成」を参照してください。

timeout

省略可能。timeout パラメーターは、秒単位で表されます。詳細については、「BLOB サービス操作のタイムアウトの設定」を参照してください。

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

 

要求ヘッダー 説明

Authorization

必須。認証スキーム、アカウント名、および署名を指定します。詳細については、「Azure ストレージ サービスの認証」を参照してください。

Date またはx-ms-date

必須。要求の世界協定時刻 (UTC) を指定します。詳細については、「Azure ストレージ サービスの認証」を参照してください。

x-ms-version

認証されたすべての要求について必須です。詳細については、「Azure ストレージ サービスのバージョン設定」を参照してください。

x-ms-lease-id:<ID>

BLOB にアクティブなリースが存在する場合は必須です。

アクティブなリースが存在する BLOB に対してこの操作を実行するには、このヘッダーに有効なリース ID を指定します。有効なリース ID が要求に指定されない場合、操作はステータス コード 403 (Forbidden) で失敗します。

x-ms-delete-snapshots: {include, only}

BLOB にスナップショットが関連付けられている場合は必須です。次の 2 つのオプションのいずれかを指定します。

  • include: ベース BLOB とすべてのスナップショットを削除します。

  • only: BLOB のスナップショットだけを削除し、BLOB 自体は削除しません。

このヘッダーは、ベース BLOB リソースに対する要求にのみ指定する必要があります。このヘッダーを個々のスナップショットを削除するための要求で指定した場合、BLOB サービスはステータス コード 400 (Bad Request) を返します。

要求にこのヘッダーの指定がないときに BLOB にスナップショットが関連付けられている場合、BLOB サービスはステータス コード 409 (Conflict) を返します。

x-ms-client-request-id

省略可能。Storage Analytics Logging が有効な場合に解析ログに記録される、クライアントで生成された非透過の値を 1 KB の文字制限付きで提供します。クライアント側のアクティビティとサーバーが受け取る要求を相互に関連付けるには、このヘッダーを使用することを強くお勧めします。詳細については、「Storage Analytics Logging について」および「Windows Azure のログ: ログを使用した、ストレージ要求の追跡」を参照してください。

この操作では、条件ヘッダーを使用して、指定した条件を満たした場合にのみ BLOB を削除することもできます。詳細については、「BLOB サービス操作の条件ヘッダーの指定」を参照してください。

なし。

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

操作が正常に終了すると、ステータス コード 202 (Accepted) が返されます。

ステータス コードの詳細については、「ステータス コードとエラー コード」を参照してください。

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。標準ヘッダーはすべて、HTTP/1.1 プロトコル仕様に準拠しています。

 

要求ヘッダー 説明

x-ms-request-id

このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。詳細については、「API 操作のトラブルシューティング」を参照してください。

x-ms-version

要求の実行に使用する BLOB サービスのバージョンを示します。このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。

Date

サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。

この操作は、アカウント所有者、または、BLOB に対する削除アクセス許可がある共有アクセス署名を使用する任意のユーザーが実行できます。

正常に削除された BLOB は、その時点でストレージ アカウントのインデックスから削除され、クライアントからアクセスできなくなります。BLOB のデータは、後でガベージ コレクション中にサービスから削除されます。

BLOB にアクティブなリースが存在する場合に BLOB を削除するには、クライアントは有効なリース ID を要求に指定する必要があります。

BLOB に多数のスナップショットが関連付けられている場合、Delete Blob 操作がタイムアウトする可能性があります。これが発生した場合、クライアントは要求を再試行する必要があります。

バージョン 2013-08-15 以降では、クライアントが Delete Blob を呼び出して、コミット前の BLOB を削除することができます。コミット前の BLOB とは、Put Block 操作によって作成された一方で Put Block List を使用してコミットされていない BLOB です。それ以前のバージョンの場合、クライアントは、BLOB を削除する前にコミットする必要があります。

表示:
© 2014 Microsoft