调用 ModifyMigrationJobAttribute 接口，修改迁移任务基础信息。

请求说明

调用该接口时，如不传入可选参数，则保持原有配置。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ModifyMigrationJobAttribute

要执行的操作，取值：ModifyMigrationJobAttribute。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

NetworkTransitionMode string 可选示例值：PublicNetwork

网络传输模式。取值：

PublicNetwork：公网传输。

VPC：内网传输。

Bandwidth integer 可选示例值：0

网络传输带宽，单位Mbps。最小值（默认）为0，表示不限速。

MigrationJobDescription string 可选示例值：迁移本地虚拟机

任务描述。

必须以字母或中文开头。

只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“，”和中文句号“。”

长度限制在255个字符以内。

说明

若传入空字符串，将清空原有描述信息。

MigrationJobId string 必选示例值：job-3tiegs1y963vj0****

迁移任务ID。您可以调用DescribeMigrationJobs接口查询获取。

MigrationJobName string 可选示例值：VM迁移至ECS

任务名称。

以字母或中文开头。

只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。

长度限制为1～128个字符。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

MigrationJobId string 示例值：job-3tiegs1y963vj0****

迁移任务ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidDestinationTypeForOperate.Unsupported	The specified migration job destination type does not support operate.	指定的迁移任务类型不支持此操作。
400	InvalidJobStateForOperate.Unsupported	The specified migration job state not support operate.	指定的迁移任务状态不支持此操作。
400	InvalidMigrationJobDescription.Malformed	The specified MigrationJobDescription is malformed.	指定的MigrationJobDescription不合法。
400	InvalidMigrationJobName.Malformed	The specified MigrationJobName is malformed.	指定的MigrationJobName不合法。
400	InvalidNetworkTransitionMode.Malformed	The specified migration job network transition mode is malformed.	指定的迁移任务网络传输类型不合法。
400	LimitExceeded.MinimumBandwidth	The number of specified Bandwidth exceeds the minimum limit.	指定的Bandwidth超过最小限制。
400	MissingParameter.MigrationJobId	The required parameter MigrationJobId is not supplied.	参数MigrationJobId不能为空。
404	InvalidActionOrVersion	Could not find operation %s for version %s.	请求接口不存在。
404	InvalidMigrationJob.NotFound	The specified migration job does not exist.	指定的迁移任务不存在。
404	InvalidSourceTransferEip.NotFound	The specified source instance does not associate eip.	指定的源实例没有绑定EIP。
404	InvalidSourceTransferPrivateIp.NotFound	The specified source instance private ip does not exist.	指定的源实例没有内网ip。
404	InvalidTransferEip.NotFound	The specified destination instance does not associate eip.	指定的目标实例没有绑定EIP。
412	OperationDenied.AgentNeedUpgrade	The specified migration agent need upgrade	请升级迁移客户端。

服务器迁移中心