调用ListRecycledDirectoriesAndFiles接口查询已删除的文件或目录。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListRecycledDirectoriesAndFiles

接口名称。

固定取值:ListRecycledDirectoriesAndFiles

FileSystemId String 1ca404****

文件系统ID。

FileId String 04***08

待查询目录的FileId。

您可以调用ListRecycleBinJobs接口查询参数FileId的值。

NextToken String 1256****25

下一页标识,首次查询无需传入。

如果一次查询结果并没有完整返回所有的文件和目录,则返回NextToken不为空。

您可以在查询中上传正确的NextToken继续查询。

MaxResults Long 100

每次查询返回文件或目录的个数。

取值范围:10~1000

默认值:100

返回数据

名称 类型 示例值 描述
RequestId String 98696EF0-1607-4E9D-B01D-F20930B6****

请求ID。

NextToken String

下一页标识。

如果一次查询结果并没有完整返回所有的文件和目录,则返回NextToken不为空。您可以在查询中上传正确的NextToken继续查询。

Entries Array of Entry

回收站中文件或目录的信息集合。

FileId String 04***08

文件或目录的FileId。

Type String File

返回对象类型。包括:

  • File:文件
  • Directory:目录
Name String test001

文件或目录删除前的名称。

DeleteTime String 2021-05-30T10:08:08Z

文件或目录被删除的时间。

Inode String 04***08

文件或目录的inode。

ATime String 2019-10-30T10:08:08Z

最近访问时间。

MTime String 2019-10-30T10:08:08Z

最近修改时间。

CTime String 2019-10-30T10:08:08Z

元数据最近修改时间。

Size Long 1073741824

文件大小。单位:Byte。

当Type=Directory时,返回为0。

示例

请求示例

http(s)://[Endpoint]/?Action=ListRecycledDirectoriesAndFiles
&FileSystemId=1ca404****
&FileId=04***08
&NextToken=1256****25
&MaxResults=100
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListRecycledDirectoriesAndFilesResponse>
    <RequestId>98696EF0-1607-4E9D-B01D-F20930B6****</RequestId>
    <NextToken>无</NextToken>
    <Entries>
        <FileId>04***08</FileId>
        <Type>File</Type>
        <Name>test001</Name>
        <DeleteTime>2021-05-30T10:08:08Z</DeleteTime>
        <Inode>04***08</Inode>
        <ATime>2019-10-30T10:08:08Z</ATime>
        <MTime>2019-10-30T10:08:08Z</MTime>
        <CTime>2019-10-30T10:08:08Z</CTime>
        <Size>1073741824</Size>
    </Entries>
</ListRecycledDirectoriesAndFilesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "98696EF0-1607-4E9D-B01D-F20930B6****",
  "NextToken" : "无",
  "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
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
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被disable需要处在启用状态。
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. 指定的NextToken非法。

访问错误中心查看更多错误码。