文档

ListJob - 列举任务

更新时间:
一键部署

列举用户在该区域下的迁移任务。

接口说明

  • 列举迁移任务,您必须有 mgw:ListImportJob 权限。

调试

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

授权信息

当前API暂无授权信息透出。

请求语法

GET /joblist HTTP/1.1 Host: userid.cn-hangzhou.mgw.aliyuncs.com

请求参数

名称类型必填描述示例值
markerstring

设定从该 marker 之后列举迁移任务。
默认值:无

test_marker
countinteger

指定返回迁移任务的数量。
取值:大于 0 小于等于 1000
默认值:1000

1000
parentNamestring

父任务名称。指定该参数时,会返回所有该父任务的子任务。

test_parent_job_name
allboolean

是否返回子任务。
取值:true,false。

true

返回参数

名称类型描述示例值
object

列举迁移任务响应体。

ImportJobListListJobResp

迁移任务列表详情。

示例

正常返回示例

JSON格式

{
  "ImportJobList": {
    "NextMarker": "test_nex_marker",
    "Truncated": true,
    "ImportJob": [
      {
        "Name": "test_name",
        "SrcAddress": "test_src_address",
        "DestAddress": "test_dest_address",
        "Status": "IMPORT_JOB_DOING",
        "EnableMultiVersioning": false,
        "CreateTime": "2024-05-01T12:00:00.000Z",
        "ModifyTime": "2024-05-01T12:00:00.000Z",
        "Version": "test_id",
        "Audit": {
          "LogMode": "off"
        },
        "OverwriteMode": "always",
        "TransferMode": "all",
        "Tags": "K1:V1,K2:V2",
        "ParentName": "test_parent_name",
        "ParentVersion": "7db93837-a5ee-4e3a-b3c8-800e7947dabc",
        "ConvertSymlinkTarget": false,
        "CreateReport": false,
        "Owner": "test_owner",
        "FilterRule": {
          "KeyFilters": {
            "Includes": {
              "Regex": [
                ".*\\.jpg$"
              ]
            },
            "Excludes": {
              "Regex": [
                ".*\\.jpg$"
              ]
            }
          },
          "LastModifiedFilters": {
            "Includes": {
              "TimeFilter": [
                {
                  "StartTime": "2006-01-01T00:00:00Z",
                  "EndTime": "2006-12-31T59:59:59Z"
                }
              ]
            },
            "Excludes": {
              "TimeFilter": [
                {
                  "StartTime": "2006-01-01T00:00:00Z",
                  "EndTime": "2006-12-31T59:59:59Z"
                }
              ]
            }
          },
          "FileTypeFilters": {
            "ExcludeSymlink": true,
            "ExcludeDir": true
          }
        },
        "ImportQos": {
          "MaxBandWidth": 1073741824,
          "MaxImportTaskQps": 1000
        },
        "ScheduleRule": {
          "StartCronExpression": "0 0 * * * ?",
          "SuspendCronExpression": "0 0 * * * ?",
          "MaxScheduleCount": 1
        }
      }
    ]
  }
}

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ImportJobList>
  <NextMarker>test_nex_marker</NextMarker>
  <Truncated>true</Truncated>
  <ImportJob>
    <Name>test_name</Name>
    <SrcAddress>test_src_address</SrcAddress>
    <DestAddress>test_dest_address</DestAddress>
    <Status>IMPORT_JOB_DOING</Status>
    <EnableMultiVersioning>false</EnableMultiVersioning>
    <CreateTime>2024-05-01T12:00:00.000Z</CreateTime>
    <ModifyTime>2024-05-01T12:00:00.000Z</ModifyTime>
    <Version>test_id</Version>
    <Audit>
      <LogMode>off</LogMode>
    </Audit>
    <OverwriteMode>always</OverwriteMode>
    <TransferMode>all</TransferMode>
    <Tags>K1:V1,K2:V2</Tags>
    <ParentName>test_parent_name</ParentName>
    <ParentVersion>7db93837-a5ee-4e3a-b3c8-800e7947dabc</ParentVersion>
    <ConvertSymlinkTarget>false</ConvertSymlinkTarget>
    <CreateReport>false</CreateReport>
    <Owner>test_owner</Owner>
    <FilterRule>
      <KeyFilters>
        <Includes>
          <Regex>.*\.jpg$</Regex>
        </Includes>
        <Excludes>
          <Regex>.*\.jpg$</Regex>
        </Excludes>
      </KeyFilters>
      <LastModifiedFilters>
        <Includes>
          <TimeFilter>
            <StartTime>2006-01-01T00:00:00Z</StartTime>
            <EndTime>2006-12-31T59:59:59Z</EndTime>
          </TimeFilter>
        </Includes>
        <Excludes>
          <TimeFilter>
            <StartTime>2006-01-01T00:00:00Z</StartTime>
            <EndTime>2006-12-31T59:59:59Z</EndTime>
          </TimeFilter>
        </Excludes>
      </LastModifiedFilters>
      <FileTypeFilters>
        <ExcludeSymlink>true</ExcludeSymlink>
        <ExcludeDir>true</ExcludeDir>
      </FileTypeFilters>
    </FilterRule>
    <ImportQos>
      <MaxBandWidth>1073741824</MaxBandWidth>
      <MaxImportTaskQps>1000</MaxImportTaskQps>
    </ImportQos>
    <ScheduleRule>
      <StartCronExpression>0 0 * * * ?</StartCronExpression>
      <SuspendCronExpression>0 0 * * * ?</SuspendCronExpression>
      <MaxScheduleCount>1</MaxScheduleCount>
    </ScheduleRule>
  </ImportJob>
</ImportJobList>

错误码

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