调用ListLifecycleRetrieveJobs接口列出已创建的数据取回任务。

调试

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

请求参数

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

接口名称。

取值：ListLifecycleRetrieveJobs
PageSize Integer 否 10

每个分页包含的数据取回任务个数。

取值范围：1~100

默认值：10
PageNumber Integer 否 1

列表的分页页码。

起始值（默认值）：1
FileSystemId String 否 31a8e4****

文件系统ID。
Status String 否 completed

数据取回任务的状态。

取值：

  • active：任务执行中。
  • canceled ：任务已取消。
  • completed：任务执行成功。
  • failed：任务执行失败。

返回数据

名称 类型 示例值 描述
TotalCount Integer 10

数据取回任务总数。
RequestId String BC7C825C-5F65-4B56-BEF6-98C56C7C****

请求ID。
PageSize Integer 10

每个分页包含的数据取回任务个数。
PageNumber Integer 1

列表的分页页码。
LifecycleRetrieveJobs Array of LifecycleRetrieveJob

数据取回任务信息集合。
FileSystemId String 31a8e4****

文件系统ID。
Status String completed

数据取回任务的状态。

包括：

  • active：任务执行中。
  • canceled ：任务已取消。
  • completed：任务执行成功。
  • failed：任务执行失败。
DiscoveredFileCount Long 100

执行数据取回任务读取文件的总个数。
UpdateTime String 2021-02-30T11:08:08Z

任务更新时间。

执行ISO8601标准表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

Paths Array of String ["/pathway/to/folder","/pathway/to/folder","/pathway/to/folder"]

指定取回的目录或文件。

必须以正斜线（/）开头，并且是挂载点中真实存在的路径。
RetrievedFileCount Long 80

执行数据取回任务成功取回的文件个数。
JobId String lrj-nfstest-ia-160****853-hshvw

数据取回任务ID。
CreateTime String 2021-02-30T10:08:08Z

任务创建时间。

执行ISO8601标准表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

示例

请求示例

http(s)://[Endpoint]/?Action=ListLifecycleRetrieveJobs
&<公共请求参数>

正常返回示例

XML格式 

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

<ListLifecycleRetrieveJobsResponse>
    <TotalCount>10</TotalCount>
    <RequestId>BC7C825C-5F65-4B56-BEF6-98C56C7C****</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <LifecycleRetrieveJobs>
        <FileSystemId>31a8e4****</FileSystemId>
        <Status>completed</Status>
        <DiscoveredFileCount>100</DiscoveredFileCount>
        <UpdateTime>2021-02-30T11:08:08Z</UpdateTime>
        <Paths>["/pathway/to/folder","/pathway/to/folder","/pathway/to/folder"]</Paths>
        <RetrievedFileCount>80</RetrievedFileCount>
        <JobId>lrj-nfstest-ia-160****853-hshvw</JobId>
        <CreateTime>2021-02-30T10:08:08Z</CreateTime>
    </LifecycleRetrieveJobs>
</ListLifecycleRetrieveJobsResponse>

JSON格式 

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

{
  "TotalCount" : 10,
  "RequestId" : "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "PageSize" : 10,
  "PageNumber" : 1,
  "LifecycleRetrieveJobs" : [ {
    "FileSystemId" : "31a8e4****",
    "Status" : "completed",
    "DiscoveredFileCount" : 100,
    "UpdateTime" : "2021-02-30T11:08:08Z",
    "Paths" : [ "[\"/pathway/to/folder\",\"/pathway/to/folder\",\"/pathway/to/folder\"]" ],
    "RetrievedFileCount" : 80,
    "JobId" : "lrj-nfstest-ia-160****853-hshvw",
    "CreateTime" : "2021-02-30T10:08:08Z"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的文件系统不存在。

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