BLOB の削除を取り消す

この操作により Undelete Blob 、論理的に削除された BLOB の内容とメタデータと、関連付けられている論理的に削除されたスナップショットが復元されます。

削除を取り消す BLOB は、バージョン 2017-07-29 以降でのみサポートされます。

Request

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

PUT メソッド要求の URI HTTP バージョン
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=undelete HTTP/1.1

エミュレートされたストレージ サービスの URI

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

PUT メソッド要求の URI HTTP バージョン
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=undelete HTTP/1.1

詳細については、「開発とテストにAzure Storage Emulatorを使用する」を参照してください。

URI パラメーター

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

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

要求ヘッダー (すべての BLOB の種類)

次の表では、すべての BLOB の種類に必要な要求ヘッダーと省略可能な要求ヘッダーについて説明します。

要求ヘッダー 説明
Authorization 必須。 承認スキーム、アカウント名、および署名を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。
Date または x-ms-date 必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。
x-ms-version 承認されたすべての要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-undelete-source 省略可能。 バージョン 2020-08-04 以降。 階層型名前空間が有効なアカウントの場合のみ。 削除を取り消す論理的に削除された BLOB のパス。 形式は blobPath?deletionid=<id> です。 アカウントとコンテナー名はパスに含まれません。 DeletionId は、論理的に削除された BLOB の一意識別子です。 階層型名前空間が有効なアカウントの BLOB REST API を一覧表示して、論理的に削除された BLOB を一覧表示することで取得できます。 パスはパーセントエンコードする必要があります。
x-ms-client-request-id 省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 KiB 文字制限を持つ、クライアントによって生成された不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Storage AnalyticsログAzure ログ: ログを使用したStorage要求の追跡」を参照してください。

要求本文

[なし] :

Response

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

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

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

レスポンス ヘッダー

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

構文 説明
x-ms-request-id このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください
x-ms-version 要求の実行に使用する BLOB サービスのバージョンを示します。
Date サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。
x-ms-client-request-id このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値 x-ms-client-request-id が最大 1024 文字の ASCII 文字で表示される場合、ヘッダーの値と同じです。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

[なし] :

承認

この操作は Undelete Blob 、アカウント所有者、この BLOB またはそのコンテナーに書き込むアクセス許可を持つ Shared Access Signature を持つすべてのユーザー、またはアクションでロール Microsoft.Storage/storageAccounts/blobServices/containers/write が割り当てられているセキュリティ プリンシパルによって呼び出すことができます。

解説

論理的に削除された BLOB が削除されていない場合、BLOB と関連するスナップショットは、他の API を使用した操作で使用できます。 BLOB への要求の削除を取り消し、論理的に削除された BLOB と関連付けられている論理的に削除されたスナップショットを削除解除します。 論理的に削除されていない BLOB や論理的に削除されたスナップショットを持つ BLOB の削除を取り消そうとすると、変更なしで成功します。

参照

Azure Storageへの要求を承認する
状態とエラー コードの BLOB の削除