调用ModifyReplicationJobAttribute修改迁移任务信息。
接口说明
修改迁移任务之前,请阅读以下注意事项:
- 参数
Name
和Description
在迁移任务的整个生命周期内均可以修改。 - 参数
Frequency
和MaxNumberOfImageToKeep
只能在迁移任务执行前或任务状态为等待中
时修改。 - 其他参数只能在迁移任务执行前修改。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyReplicationJobAttribute | 系统规定参数。取值:ModifyReplicationJobAttribute。 |
JobId | String | 是 | j-bp19vlwm0tyigbmj**** | 迁移任务ID。 |
Name | String | 否 | testMigrationTaskName | 迁移任务名称。迁移任务的名称需满足以下要求:
|
Description | String | 否 | This_is_my_migration_task | 迁移任务描述。 长度应为2~128个英文或中文字符,必须以大小写字母或中文开头,不能以 |
TargetType | String | 否 | Image | 迁移交付的目标类型。仅支持在迁移任务启动前修改。取值范围:
说明
|
ScheduledStartTime | String | 否 | 2019-06-04T13:35:00Z | 设置迁移任务的执行时间。SMC在指定时间自动为您启动迁移任务。 执行时间遵循ISO8601标准,并需要使用UTC时间,格式为YYYY-MM-DDThh:mm:ssZ。例如,2018-01-01T12:00:00Z,表示北京时间2018年01月01日20点00分00秒。 说明 当执行时间为空时,SMC不自动启动迁移任务,您需要调用StartReplicationJob启动。 |
ImageName | String | 否 | testAliCloudImageName | 迁移任务交付的目标镜像名称。目标镜像的名称需满足以下要求:
说明 如果迁移任务运行过程中,当前地域已经存在相同名称的镜像,则系统默认在镜像名称后面添加迁移任务ID(JobId)作为后缀,如:ImageName-JobId。 |
InstanceId | String | 否 | i-bp1f1dvfto1sigz5**** | 目标实例ID。 |
SystemDiskSize | Integer | 否 | 50 | 目标阿里云服务器ECS的系统盘大小,单位:GiB。取值范围为20~500。 说明 参数取值需要大于源服务器系统盘实际占用大小,例如,源系统盘大小为500 GiB,实际占用100 GiB,则该参数取值需大于100 GiB。 |
Frequency | Integer | 否 | 10 | 增量迁移任务运行的时间间隔,单位:小时。取值范围为1~168。
|
MaxNumberOfImageToKeep | Integer | 否 | 5 | 增量迁移任务默认保留的最大镜像数。取值范围为1~10。
|
InstanceType | String | 否 | ecs.c5.large | 中转实例的实例规格。 调用DescribeInstanceTypes可查询云服务器ECS提供的实例规格。
|
LaunchTemplateId | String | 否 | lt-bp16jovvln1cgaaq**** | 实例启动模板ID。 |
LaunchTemplateVersion | String | 否 | Latest | 实例启动模板的版本。 |
InstanceRamRole | String | 否 | SMCAdmin | 实例RAM角色名称。 |
ContainerNamespace | String | 否 | testNamespace | Docker的命名空间。关于Docker容器镜像详情请参见容器镜像服务。 |
ContainerRepository | String | 否 | testRepository | Docker的镜像仓库。关于Docker容器镜像详情请参见容器镜像服务。 |
ContainerTag | String | 否 | CentOS:v1 | Docker的镜像标签。关于Docker容器镜像详情请参见容器镜像服务。 |
ValidTime | String | 否 | 2019-06-04T13:35:00Z | 迁移任务的过期时间。取值范围:迁移任务创建时间+7天~迁移任务创建时间+90天
默认值:迁移任务创建时间+30天(表示迁移任务的默认有效期为创建后30天)。 |
SystemDiskPart.N.SizeBytes | Long | 否 | 254803968 | 目标系统盘分区N大小。单位:Byte。默认为源系统盘分区大小。 说明 分区空间大小不能超过系统盘空间大小,并且在系统盘下所有分区空间大小之和不能超过系统盘空间大小。 |
SystemDiskPart.N.Block | Boolean | 否 | true | 目标系统盘分区N是否开启块复制。取值范围:
|
SystemDiskPart.N.Device | String | 否 | 0_1 | 目标系统盘分区N设备标识。 说明 N的实际取值请参考迁移源的分区设备标识。 |
DataDisk.N.Index | Integer | 否 | 1 | 目标阿里云服务器ECS的数据盘顺序。取值范围为1~16。 初始值为1。 说明 您只能为源服务器中存在的数据盘创建目标数据盘。 |
DataDisk.N.Part.N.SizeBytes | Long | 否 | 254803968 | 目标数据盘N分区N的大小。单位:Byte。默认为源数据盘分区大小。 说明 分区空间大小不能超过数据盘空间大小,并且在同一数据盘下所有分区空间大小之和不能超过数据盘空间大小。 |
DataDisk.N.Part.N.Block | Boolean | 否 | true | 目标数据盘N分区N是否开启块复制。取值范围:
|
DataDisk.N.Part.N.Device | String | 否 | 0_1 | 目标数据盘N分区N对应的分区设备标识。 说明 N的实际取值请参考迁移源的分区设备标识。 |
DataDisk.N.Size | Integer | 否 | 100 | 目标阿里云服务器ECS的数据盘大小,单位:GiB。取值范围为20~32768。 说明 参数取值需要大于源服务器数据盘实际占用大小。例如,源数据盘大小为500 GiB,实际占用100 GiB,则该参数取值需大于100 GiB。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 1C488B66-B819-4D14-8711-C4EAAA13AC01 | 请求ID。 |
示例
请求示例
http(s)://smc.aliyuncs.com/?Action=ModifyReplicationJobAttribute
&JobId=j-bp19vlwm0tyigbmj****
&Name=testMigrationTaskName
&Description=This_is_my_migration_task
&TargetType=Image
&ScheduledStartTime=2019-06-04T13:35:00Z
&ImageName=testAliCloudImageName
&InstanceId=i-bp1f1dvfto1sigz5****
&SystemDiskSize=50
&Frequency=10
&MaxNumberOfImageToKeep=5
&InstanceType=ecs.c5.large
&LaunchTemplateId=lt-bp16jovvln1cgaaq****
&LaunchTemplateVersion=Latest
&InstanceRamRole=SMCAdmin
&ContainerNamespace=testNamespace
&ContainerRepository=testRepository
&ContainerTag=CentOS:v1
&ValidTime=2019-06-04T13:35:00Z
&SystemDiskPart=[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}]
&DataDisk=[{"Index":1,"Part":[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}],"Size":100}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyReplicationJobAttributeResponse>
<RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</ModifyReplicationJobAttributeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | DataDisk.DuplicateIndex | The source server data disk cannot contain the same index. | 迁移源数据盘包含相同的索引,请检查磁盘索引是否重复。 |
400 | ReplicationJob.InvalidStatus | The specified replication job status is invalid. | 无效的迁移任务状态。 |
400 | ReplicationJobDataDiskIndex.Invalid | The specified replication job contains data disk index not found in source server. | 迁移任务包含的数据盘索引在迁移源中不存在。 |
400 | ReplicationJobName.Duplicate | The specified replication job name already exists. | 迁移任务名称已存在,请修改迁移任务名称。 |
500 | InternalError | An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
访问错误中心查看更多错误码。