共有の復元
操作は Restore Share 、以前に論理的に削除された共有を復元 (または削除 解除) します。 この API は完全にサポートされていますが、レガシ管理 API です。 代わりに、ストレージ リソース プロバイダー (Microsoft.Storage) によって提供される ファイル共有 - 復元を使用します。 ストレージ リソース プロバイダーを使用してプログラムでリソースを FileShare 操作する方法の詳細については、「 FileShares に対する操作」を参照してください。
共有は、そのすべてのデータ、メタデータ、スナップショットと共に復元されます。 共有リソースには、共有のメタデータとプロパティが含まれます。
プロトコルの可用性
| 有効なファイル共有プロトコル | 利用可能 |
|---|---|
| SMB |
|
| NFS |
|
要求
要求は Restore Share 次のように構築できます。 HTTPS が推奨されます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
次のように、要求 URI に示されたパス コンポーネントを独自の URI に置き換えます。
| パス コンポーネント | Description |
|---|---|
myaccount |
ご利用のストレージ アカウントの名前。 |
restoredShareName |
復元された共有に使用する名前。 この名前の共有が既に存在する場合、操作は失敗します。 |
パスの名前付け制限の詳細については、「 共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。
URI パラメーター
要求 URI には、次の追加パラメーターを指定できます。
| パラメーター | 説明 |
|---|---|
timeout |
省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「Azure Files操作のタイムアウトの設定」を参照してください。 |
要求ヘッダー
次の表では、必須と省略可能の要求ヘッダーについて説明します。
| 要求ヘッダー | 説明 |
|---|---|
Authorization |
必須。 認証スキーム、アカウント名、および署名を指定します。 詳細については、「 Azure Storage サービスの認証」を参照してください。 |
x-ms-date |
必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「 Azure Storage サービスの認証」を参照してください。 |
x-ms-version |
認証されたすべての要求について必須です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
x-ms-deleted-share-name |
必須。 復元する論理的に削除されたファイル共有を識別します。 この値は、 の restoredShareName値と一致する必要があります。 |
x-ms-deleted-share-version |
必須。 論理的に削除されたファイル共有をバージョン別に一意に識別します。 |
x-ms-client-request-id |
省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「Azure Blob Storageの監視」を参照してください。 |
要求本文
なし。
要求のサンプル
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Response
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作が正常に終了すると、状態コード 201 (Created) が返されます。 コピー先のファイル共有名が削除されていない有効なファイル共有で使用されている場合、要求は 409 (競合) で失敗します。 ソース ファイル共有が論理的に削除されていない場合、既に復元されている場合、またはソース ファイル共有が保持期間を過ぎて有効期限が切れている場合、要求は 404 (見つかりません) で失敗します。
状態コードの詳細については、「 状態とエラー コード」を参照してください。
応答ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
| 応答ヘッダー | 説明 |
|---|---|
ETag |
共有のバージョンを引用符で囲んで表す値を格納します。 |
Last-Modified |
共有が最後に更新された日時を返します。 詳細については、「 ヘッダー内の日時値の表現」を参照してください。 共有またはそのプロパティまたはメタデータを変更する操作は、最後に変更された時刻を更新します。 ファイルに対する操作は、共有の最終変更時刻には影響しません。 |
x-ms-request-id |
行われた要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用Azure Filesのバージョンを示します。 |
Date |
応答が開始された時刻を示す UTC 日付/時刻値。 サービスによってこの値が生成されます。 |
x-ms-client-request-id |
要求と対応する応答のトラブルシューティングに使用できます。 要求に存在する場合、このヘッダーの x-ms-client-request-id header値は の値と等しくなります。 この値は、最大 1,024 文字の可視 ASCII 文字です。
x-ms-client-request-id headerが要求に存在しない場合、応答には存在しません。 |
応答本文
なし。
応答のサンプル
Response Status:
HTTP/1.1 201 Created
Response Headers:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
承認
ストレージ アカウント所有者は、この操作を呼び出すことができます。 また、有効なアカウント共有アクセス署名トークンを持つユーザーは、この操作を呼び出すことができます。 トークンには、この操作を承認するためのコンテナー リソースの書き込みアクセス許可が含まれている必要があります。
注釈
共有を別の名前に復元することはできません。 共有を復元するときに、同じ名前の別の共有が存在する場合、操作は状態コード 409 (競合) で失敗します。 論理的に削除された共有を削除する前に、同じ名前の共有を最初に削除する必要があります。
共有を削除すると、同じ名前の共有を 30 秒以上復元することはできません。 共有が削除されている間、同じ名前の共有を復元しようとすると、状態コード 409 (競合) で失敗します。 サービスは、共有が削除されていることを示す追加のエラー情報を返します。