すべてのプロダクト
Search
ドキュメントセンター

File Storage NAS:CreateRecycleBinRestoreJob

最終更新日:Sep 03, 2026

ゴミ箱からファイルを復元します。

操作説明

  • 汎用 NAS ファイルシステムのみがこの特徴をサポートしています。

  • 1 つのファイルシステムでは、一度に 1 つのファイル解凍またはクリーンアップタスクのみを実行できます。ファイルの解凍中は、新しいファイル解凍またはクリーンアップタスクを開始できません。

  • 1 つの解凍タスクで解凍できるのは、1 つのファイルまたはディレクトリのみです。指定されたディレクトリを解凍すると、そのディレクトリ内のすべてのファイルが再帰的に解凍されます。

  • ファイルの解凍後、データの再編成が実行されます。データの再編成中は、読み取りリクエストのパフォーマンスがわずかに低下します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileSystemId

string

必須

ファイルシステムの ID です。必須です。

取得方法:

  • DescribeFileSystems を呼び出してファイルシステムリストをクエリし、FileSystemId を取得します。

  • CreateFileSystem を呼び出してファイルシステムを作成し、応答から FileSystemId を取得します。

使用上の注意:

  • この操作は汎用 NAS ファイルシステムにのみ適用されます。

  • この操作を呼び出す前に、ファイルシステムでゴミ箱特徴が有効になっていることを確認してください。

1ca404****

FileId

string

必須

解凍するファイルまたはディレクトリの FileId です。

ListRecycledDirectoriesAndFiles 操作を呼び出して、削除されたデータの FileId をクエリできます。

04***08

TargetFileId

string

必須

ファイルの解凍先ディレクトリの FileId です。

  • ListRecentlyRecycledDirectories 操作を呼び出して、ファイルが削除されたディレクトリの TargetFileId をクエリできます。

  • ListDirectoriesAndFiles 操作を呼び出して、ファイルシステム内の既存のディレクトリの TargetFileId をクエリできます。

特記事項:

  • ファイルシステムのルートディレクトリの FileId は 2 に固定されています。この値を TargetFileId として直接使用することで、クエリせずにファイルをルートディレクトリに解凍できます。

13***15

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークンです。

異なるリクエスト間で値が一意になるように、クライアント側で値を生成してください。ClientToken の値には ASCII 文字のみを使用でき、長さは 64 文字以下である必要があります。詳細については、「べき等性を確保する方法」をご参照ください。

説明

ClientToken を指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API 呼び出しごとに異なる場合があります。

123e4567-e89b-12d3-a456-42665544****

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

RequestId

string

リクエストの ID です。

98696EF0-1607-4E9D-B01D-F20930B6****

JobId

string

タスクの ID です。

rb-10****491ff-r-162****165400

例

成功レスポンス

JSONJSON

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "JobId": "rb-10****491ff-r-162****165400"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IllegalCharacters The parameter contains illegal characters. 無効なパラメーターです。有効なパラメーターを指定してください。
400 MissingFileSystemId FileSystemId is mandatory for this action. FileSystemId パラメーターが指定されていません。
400 MissingTargetFileId TargetFileId is mandatory for this action. TargetFileId パラメーターが見つかりません。
400 MissingFileId FileId is mandatory for this action. FileId パラメーターがありません。
400 InvalidParameter.KMSKeyId.KMSUnauthorized KMS is not authorized. KMS サービスへのアクセス権限が付与されていません。
400 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. 指定された CMK は無効化されています。有効な状態である必要があります。
403 OperationDenied.RecycleBinDisabled The operation is denied because the recycle bin is disabled. ゴミ箱が無効な場合、このリクエストは実行できません。
403 OperationDenied.Conflict The operation is in conflict with (% JobId). Please try again later. リクエストが別のタスクと競合しています。後でもう一度お試しください。
403 OperationDenied.TooManyRunningJobs The maximum number of running job is one. Please try again later. 実行中のタスク数は 1 を超えることはできません。後でもう一度お試しください。
403 InvalidTargetFileId.NotDirectory The specified TargetFileId(% TargetFileId) is not directory. 指定されたターゲットはディレクトリではありません。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定されたファイルシステムが存在しません。
404 InvalidFileId.NotFound The specified FileId(%FileId) does not exist. 指定されたファイルまたはディレクトリが存在しません。
404 InvalidTargetFileId.NotFound The specified TargetFileId(%TargetFileId) does not exist. 指定された送信先ディレクトリが存在しません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。