削除されたファイルまたはディレクトリを照会します。
操作説明
この特徴は、汎用 NAS ファイルシステムでのみサポートされています。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。 |
1ca404**** |
| FileId |
string |
必須 |
クエリするディレクトリの FileId。 このフィールドは NFS inode 番号です。ゴミ箱が空の場合、FileId=2 (ルートディレクトリの inode) を指定してこの操作を呼び出し、操作の到達可能性を確認するか、ルートディレクトリ配下のゴミ箱の内容をクエリできます。その他の有効な FileId 値は、 ListRecentlyRecycledDirectories 操作を呼び出すことで取得できます。 |
04***08 |
| NextToken |
string |
任意 |
次のページのページネーショントークン。最初のクエリではこのパラメーターを指定する必要はありません。 単一のクエリで全てのファイルとディレクトリが返されない場合、空ではない NextToken が返されます。後続のクエリで正しい NextToken を渡すことで、結果の取得を継続できます。 |
1256****25 |
| MaxResults |
integer |
任意 |
クエリごとに返されるファイルまたはディレクトリの数。 有効な値: 10～1000。 デフォルト値: 100。 |
100 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
string |
リクエストの ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| NextToken |
string |
次のページのページネーショントークン。 単一のクエリで全てのファイルとディレクトリが返されない場合、空ではない NextToken が返されます。後続のクエリで正しい NextToken を渡すことで、結果の取得を継続できます。 |
None |
| Entries |
array<object> |
ゴミ箱内のファイルまたはディレクトリのコレクション。 |
|
|
object |
|||
| FileId |
string |
ファイルまたはディレクトリの FileId。 |
04***08 |
| Type |
string |
オブジェクトタイプ。有効な値:
|
File |
| Name |
string |
削除前のファイルまたはディレクトリの名前。 |
test001 |
| DeleteTime |
string |
ファイルまたはディレクトリが削除された時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2021-05-30T10:08:08Z |
| Inode |
string |
ファイルまたはディレクトリの inode。 |
04***08 |
| ATime |
string |
最新のアクセス時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| MTime |
string |
最新の変更時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| CTime |
string |
最新のメタデータ変更時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| Size |
integer |
ファイルサイズ。単位: バイト。 Type が Directory に設定されている場合、値 0 が返されます。 |
1073741824 |
例
成功レスポンス
JSONJSON
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"NextToken": "None",
"Entries": [
{
"FileId": "04***08",
"Type": "File",
"Name": "test001",
"DeleteTime": "2021-05-30T10:08:08Z",
"Inode": "04***08",
"ATime": "2019-10-30T10:08:08Z",
"MTime": "2019-10-30T10:08:08Z",
"CTime": "2019-10-30T10:08:08Z",
"Size": 1073741824
}
]
}エラーコード
|
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 | InvalidFileId.NotFound | The specified FileId(%FileId) does not exist. | 指定されたファイルまたはディレクトリが存在しません。 |
| 404 | InvalidParameter.InvalidNextToken | The specified NextToken is invaild. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。