汎用NASファイルシステムのごみ箱からファイルを復元します。
説明
- 単一のファイルシステムに対して一度に実行できるジョブは1つだけで、ファイルを復元したり、ファイルシステムからファイルを消去したりできます。 ファイルがごみ箱から復元されている場合、復元またはクリーンアップジョブを作成することはできません。
- 1つの復元ジョブで復元できるファイルまたはディレクトリは1つだけです。 指定したディレクトリを復元すると、ディレクトリ内のすべてのファイルが再帰的に復元されます。
- ファイルが復元された後、ファイルのデータはデフラグされます。 データがデフラグされているとき、読み取りパフォーマンスはわずかに低下します。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | CreateRecycleBinRestoreJob |
実行する操作です。 値をCreateRecycleBinRestoreJobに設定します。 |
| FileSystemId | String | 必須 | 1ca404 **** |
ファイルシステムの ID。 |
| FileId | String | 必須 | 04 *** 08 |
復元するファイルまたはディレクトリのID。 ListRecycleBinJobs操作を呼び出して、FileIdパラメーターの値を照会できます。 |
| TargetFileId | String | 必須 | 13 *** 15 |
ファイルが復元されるディレクトリのID。 |
| ClientTokend | String | 任意 | 123e4567-e89b-12d3-a456-42665544 **** |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 For more information, see How to ensure the idempotence of a request. 注 このパラメーターを指定しない場合、システムは自動的にリクエストIDをクライアントトークンとして使用します。 しかしながら、異なる要求のIDは同じであっても異なっていてもよい。
|
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| RequestId | String | 98696EF0-1607-4E9D-B01D-F20930B6 **** |
リクエストの ID です。 |
| JobId | String | rb-10 **** 491ff-r-162 **** 165400 |
ジョブの ID です。 |
例
リクエストの例
http(s):// [エンドポイント]/? アクション=CreateRecycleBinRestoreJob
&FileSystemId=1ca404 ****
&FileId=04 *** 08
&TargetFileId=13 *** 15
&ClientToken=123e4567-e89b-12d3-a456-42665544 ****
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateRecycleBinRestoreJobResponse>
<RequestId>98696EF0-1607-4E9D-B01D-F20930B6 ****</RequestId>
<JobId>8C **** C54</JobId>
</CreateRecycleBinRestoreJobResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "98696EF0-1607-4E9D-B01D-F20930B6 ****" 、
"JobId" : "8C **** C54"
}エラーコード
| HttpCode | エラーコード | エラーメッセージ | 必須／任意 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | The error message returned because the specified value of a parameter is invalid. |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | The error message returned because the FileSystemId parameter is not specified. |
| 400 | MissingTargetFileId | TargetFileId is mandatory for this action. | TargetFileIdパラメーターが指定されていない場合に返されるエラーメッセージ。 |
| 400 | MissingFileId | FileId is mandatory for this action. | FileIdパラメーターが指定されていない場合に返されるエラーメッセージ。 |
| 400 | InvalidParameter.KMSKeyId.KMSUnauthorized | KMSは承認されません。 | Key Management Service (KMS) にアクセスする権限がない場合に返されるエラーメッセージ。 |
| 400 | InvalidParameter.KMSKeyId.CMKNotEnabled | CMKを有効にする必要があります。 | 指定されたカスタマーマスターキー (CMK) が無効になっている場合に返されるエラーメッセージ。 |
| 403 | OperationDenied.RecycleBinDisabled | ごみ箱が無効になっているため、操作は拒否されます。 | ごみ箱機能が無効になっている場合、リクエストがサポートされていない場合に返されるエラーメッセージ。 |
| 403 | OperationDenied.Conflict | 操作は (% JobId) と競合しています。 しばらくしてからもう一度お試しください。 | リクエストが別のジョブと競合している場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
| 403 | OperationDenied.TooManyRunningJobs | 実行中のジョブの最大数は1です。 しばらくしてからもう一度お試しください。 | 複数のジョブを同時に実行できない場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
| 403 | InvalidTargetFileId.NotDirectory | 指定されたTargetFileId(% TargetFileId) はディレクトリではありません。 | TargetFileIdパラメーターの値にディレクトリが指定されていない場合に返されるエラーメッセージ。 |
| 404 | InvalidFileSystem.NotFound | 指定されたファイルシステムが存在しません。 | 指定されたファイルシステムが存在しない場合に返されるエラーメッセージ。 |
| 404 | InvalidFileId.NotFound | 指定されたFileId(% FileId) は存在しません。 | The error message returned because the specified file or directory does not exist. |
| 404 | InvalidTargetFileId.NotFound | 指定されたTargetFileId(% TargetFileId) は存在しません。 | 指定された宛先ディレクトリが存在しない場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。