最近更新时间:2024.05.23 10:12:41
首次发布时间:2023.07.18 10:22:41
调用 DescribeMigrationJobs 接口,查询迁移任务信息。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeMigrationJobs | 要执行的操作,取值:DescribeMigrationJobs。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
DestinationRegion | String | 否 | cn-beijing | 目标地域,最大长度为255个字符。您可以调用DescribeRegions接口查询获取。 说明 根据目的区域查询时,需要传入该参数。 |
DestinationType.N | Array of String | 否 | DestinationType.1=ECSInstance&DestinationType.2=ECSImage | 迁移目标类型,最多支持5个类型。取值:
说明
|
MigrationJobId | String | 否 | job-3tiegs1y963vj0****** | 迁移任务ID。 说明 根据迁移任务ID查询时,需要传入该参数。 |
MigrationJobName | String | 否 | VM迁移至ECS | 迁移任务名,最大长度为255个字符。 说明 根据迁移任务名称查询时,需要传入该参数。 |
MigrationJobState | String | 否 | Success | 迁移任务状态,取值:
|
PageNumber | Integer | 否 | 1 | 分页数。 |
PageSize | Integer | 否 | 10 | 页表大小。
|
ProjectName | String | 否 | project_a | 迁移任务所属项目,一个任务只能归属于一个项目。
|
TagFilters.N.Key | Array of String | 是 | TagFilters.1.Key=k1 | 根据标签查询资源时指定的标签键。
说明
|
TagFilters.N.Values.N | Array of String | 否 | TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2 | 根据标签查询资源时指定的标签值。
说明
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Jobs | Array of JobsForDescribeMigrationJobs | -- | 符合条件的迁移任务信息。 |
PageNumber | Integer | 1 | 分页数。 |
PageSize | Integer | 10 | 页表大小。 |
TotalCount | Integer | 30 | 迁移任务总数。 |
GET /?Action=DescribeMigrationJobs&Version=2020-04-01&MigrationJobId=job-ycg7dvqn59b5oz**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: smc
{ "ResponseMetadata": { "RequestId": "202306051605204303A34A*****", "Action": "DescribeMigrationJobs", "Version": "2020-04-01", "Service": "smc", "Region": "cn-beijing" }, "Result": { "TotalCount": 16, "PageNumber": 1, "PageSize": 10, "Jobs": [ { "MigrationJobId": "job-ycg79lm7wg7grbxxxx", "MigrationJobName": "VM迁移至ECS", "MigrationJobDescription": "", "SourceProjectName": "project_a", "CreatedAt": "2023-05-31T14:00:43+08:00", "StartedAt": "2023-05-31T14:00:43+08:00", "FinishedAt": "", "State": "Replicating", "Progress": 0, "MigrationSourceId": "s-ycg79jgyp8b5ozxxxx", "MigrationSourceName": "s-ycg79jgyp8b5oxxxx", "Tags": [ { "Key": "k1", "Value": "v1" } ], "DestinationConfig": { "Region": "cn-beijing", "DestinationType": "ECSInstance", "InstanceId": "i-ycg4zh1r13ebgy4xxxx", "InstanceName": "VMwareMigrationTarget", "ImageId": "", "ImageName": "", "AutoInstallVirtio11": true, "AutoInstallBlkNone": true }, "NetworkConfig": { "NetworkTransitionMode": "PublicNetwork", "BandwidthLimit": 0, "TransferIP": "180.xxx.xx.xxx", "VpcId": "", "SubnetId": "" }, "SyncConfig": { "SyncInterval": 1, "TriggerLastSync": false, "SyncType": "Block", "HasSyncedTimes": "" }, "SystemConfig": { "SourceImageInfo": { "OS": "Linux", "Platform": "CentOS", "PlatformVersion": "7.6" }, "TargetImageInfo": { "OS": "Linux", "Platform": "veLinux", "PlatformVersion": "1.0" } }, "TemporaryResources": [ { "AssociatedResource": { "ResourceId": "i-3tigy72q3u3vj0x2****", "ResourceType": "Instance" }, "ProjectName": "default", "ResourceId": "kp-ybp0x6i30gep29******", "ResourceName": "MigrationKey-job-yd0d5s8n*****", "ResourceStatus": "Exist", "ResourceType": "KeyPair" } ], "MigrationStateTips": "", "LastSyncTime": "2023-05-31T14:00:43+08:00" } ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidDestinationRegion.Malformed | The specified DestinationRegion is malformed. | 指定的DestinationRegion不合法。 |
400 | InvalidMigrationJobName.Malformed | The specified MigrationJobName is malformed. | 指定的MigrationJobName不合法。 |
400 | InvalidMigrationJobState.Malformed | The specified MigrationJobState is malformed. | 指定的MigrationJobState不合法。 |
400 | InvalidProjectName.Malformed | The specified ProjectName is malformed. | 指定的ProjectName不合法。 |
400 | InvalidTagFilterKey.Conflict | The specified TagFilterKey already exists. | 指定的过滤标签键已存在。 |
400 | InvalidTagFilterKey.Malformed | The specified TagFilterKey is malformed. | 指定的标签键不合法。 |
400 | InvalidTagFilterValue.Malformed | The specified TagFilterValue already exists. | 指定的过滤标签值已存在。 |
400 | LimitExceeded.MaximumTagFilterKeys | You've reached the limit on the number of TagFilterKeys that you can set. | 指定的标签过滤键超过最大限制。 |
400 | LimitExceeded.MaximumTagFilterResults | You've reached the limit on the number of resources that you can describe by TagFilters. | 通过标签过滤出的资源数量超过上限。 |
400 | LimitExceeded.MaximumTagFilterValues | You've reached the limit on the number of TagFilterValues that you can set. | 指定的标签过滤值超过最大限制。 |