最近削除操作が実行されたディレクトリを照会します。
操作説明
この特徴は、汎用 NAS ファイルシステムのみでサポートされています。
開始する前に
この操作を呼び出す前に、ファイルシステムのゴミ箱特徴が有効になっていることを確認してください。ゴミ箱が有効になっていない場合、この操作では最近削除されたディレクトリのリストを返すことができません。
ゴミ箱の有効化
ゴミ箱特徴を有効にするには、 EnableRecycleBin 操作を呼び出します。ゴミ箱を有効にすると、ファイルシステム内で削除されたディレクトリはゴミ箱に移動されます。この操作を呼び出して、最近削除されたディレクトリのリストをクエリできます。詳細については、開発者リファレンスをご参照ください。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。 |
1ca404**** |
| NextToken |
string |
任意 |
次のページのページネーショントークン。最初のリクエストでは、このパラメーターを指定する必要はありません。 単一のクエリですべてのディレクトリが返されない場合、NextToken パラメーターに値が設定されて返されます。後続のリクエストで有効な NextToken の値を指定して、クエリを継続できます。 |
1256****25 |
| MaxResults |
integer |
任意 |
クエリごとに返されるディレクトリの最大値。 有効な値: 10～1000。 デフォルト値: 100。 |
100 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ。 |
||
| RequestId |
string |
リクエストの ID。 |
9E15E394-38A6-457A-A62A-D9797C9A**** |
| NextToken |
string |
次のページのページネーショントークン。 単一のクエリですべてのディレクトリが返されない場合、NextToken パラメーターに値が設定されて返されます。後続のリクエストで有効な NextToken の値を指定して、クエリを継続できます。 |
1256****25 |
| Entries |
array<object> |
最近削除操作が実行されたディレクトリに関する情報。フォーマットは以下の通りです。 |
|
|
object |
|||
| FileId |
string |
ディレクトリの ID。 |
04***08 |
| Path |
string |
ディレクトリの絶対パス。 |
/a/b |
| Name |
string |
ディレクトリの名前。 |
b |
| LastDeleteTime |
string |
ディレクトリに対して最新の削除操作が実行された時間。時間は協定世界時 (UTC) で ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2021-05-30T10:08:08Z |
例
成功レスポンス
JSONJSON
{
"RequestId": "9E15E394-38A6-457A-A62A-D9797C9A****",
"NextToken": "1256****25",
"Entries": [
{
"FileId": "04***08",
"Path": "/a/b",
"Name": "b",
"LastDeleteTime": "2021-05-30T10:08:08Z"
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 無効なパラメーターです。有効なパラメーターを指定してください。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | FileSystemId パラメーターが指定されていません。 |
| 400 | InvalidParameter.KMSKeyId.KMSUnauthorized | KMS is not authorized. | KMS サービスへのアクセス権限が付与されていません。 |
| 400 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 指定された CMK は無効化されています。有効な状態である必要があります。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定されたファイルシステムが存在しません。 |
| 404 | InvalidParameter.InvalidNextToken | The specified NextToken is invaild. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。