本文将为您介绍服务器迁移中心服务端 API 的更新动态。 ## 2025年04月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增返回参数：|迁移源 |\ | |`Sources.Partitions`结构，新增：| |\ | || |\ | |* `PartitionName`，表示磁盘分区名称。| |\ | |* `PartitionUsedSize`，表示磁盘分区使用量。 | | ## 2025年02月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增返回参数：|迁移源 |\ | |`Sources`结构新增`MigrationSourceDescription`参数，表示迁移源描述。 | | |[DeleteMigrationSource](https://www.volcengine.com/docs/6886/984875) |新增错误码：|^^|\ | |412，InvalidMigrationSource.InUse | | |[ModifyMigrationSourceAttribute](https://www.volcengine.com/docs/6886/1171071) |* 新增请求参数：|^^|\ | || |\ | | `MigrationSourceDescription`，可选，表示迁移源的描述。| |\ | || |\ | |* 新增错误码：| |\ | | * 400，InvalidMigrationSourceDescription.Malformed| |\ | | * 400，InvalidMigrationSourceName.Malformed | | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |新增错误码：|迁移任务 |\ | || |\ | |* 400，InvalidCustomImageName.Malformed| |\ | |* 400，InvalidDestinationInstanceType.Unsupported| |\ | |* 400，InvalidDiskConfigForMigration.Unsupported| |\ | |* 400，InvalidInstanceForMigration.Unsupported| |\ | |* 400，InvalidInstanceTypeForMigtation.Unsupported| |\ | |* 400，InvalidLicenseTypeForMigration.Unsupported| |\ | |* 400，InvalidMigrationSourceForSystemMigration.Unsupported| |\ | |* 400，InvalidMigrationType.Unsupported| |\ | |* 400，InvalidOSTypeForFileMigration.Unsupported| |\ | |* 400，InvalidVolumeTypeForCreateWholeImage.UnSupported| |\ | |* 400，LimitExceeded.MaximumSecurityGroupCount| |\ | |* 400，LimitExceeded.MaximumVolumes| |\ | |* 400，MissingParameter.NetworkTransitionMode| |\ | |* 400，MissingParameter.SyncType| |\ | |* 404，InvalidInstance.NotFound| |\ | |* 412，PendingVerification | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |新增错误码：|^^|\ | || |\ | |* 400，LimitExceeded.MaximumResourceIds| |\ | |* 404，InvalidMigrationSource.NotFound | | |[ModifyMigrationJobAttribute](https://www.volcengine.com/docs/6886/1171072) |新增错误码：|^^|\ | || |\ | |* 400，InvalidDestinationTypeForOperate.Unsupported| |\ | |* 400，InvalidJobStateForOperate.Unsupported| |\ | |* 400，InvalidNetworkTransitionMode.Malformed| |\ | |* 404，InvalidSourceTransferEip.NotFound| |\ | |* 404，InvalidSourceTransferPrivateIp.NotFound| |\ | |* 404，InvalidTransferEip.NotFound| |\ | |* 412，OperationDenied.AgentNeedUpgrade | | |[DescribeMigrationLogs](https://www.volcengine.com/docs/6886/984908) |新增错误码：|^^|\ | || |\ | |* 404，InvalidMigrationJob.NotFound| |\ | |* 404，InvalidMigrationJobLog.NotFound | | |[TagResources](https://www.volcengine.com/docs/6886/1186837) |* 新增错误码：|标签 |\ | || |\ | | 400，MissingParameter.Tags| |\ | || |\ | |* 新增批量操作的单个错误码：| |\ | || |\ | | MissingParameter.ResourceIds | | |[UnTagResources](https://www.volcengine.com/docs/6886/1186838) |* 新增错误码：|^^|\ | || |\ | | 400，LimitExceeded.MaximumTags| |\ | || |\ | |* 新增批量操作的单个错误码：| |\ | || |\ | | InvalidTagKey.Malformed | | ## 2024年11月 |API |变更记录 |关联功能 | |---|---|---| |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 新增请求参数：|迁移任务 |\ | | `DestinationConfig.AutoReplicate`（可选），表示迁移任务通过预检后是否自动开始迁移。| |\ | |* 更新错误码：| |\ | | 400，InvalidSecurityGroupPermission.Conflict，描述调整为“迁移服务需要目的实例开启8080、22、5201以及5986端口，请检查目的实例安全组规则。” | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |* 更新请求参数：|^^|\ | | `MigrationJobStateSourceState`参数新增枚举值：| |\ | | * `Pending`，待开始。| |\ | |* 新增返回参数：| |\ | | `Jobs.DestinationConfig`结构，新增`AutoReplicate`参数，表示迁移任务通过预检后是否自动开始迁移。 | | |[ModifyMigrationJobAttribute](https://www.volcengine.com/docs/6886/1171072) |新增请求参数：|^^|\ | |`NetworkTransitionMode`（可选），表示网络传输模式。 | | ## 2024年10月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |更新请求参数：|迁移任务 |\ | |`MigrationJobStateSourceState`参数新增枚举值：| |\ | || |\ | |* `Pausing`，暂停中。| |\ | |* `Paused`，已暂停。 | | ## 2024年09月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增响应参数：|迁移源 |\ | |Sources.InstanceInfo结构，新增：| |\ | || |\ | |* `BlkNoneInstall`，表示源实例是否已安装blk\-none。| |\ | |* `Virtio11CanInstall`，表示源实例是否支持安装Virtio1.1。 | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |新增请求参数：|迁移任务 |\ | || |\ | |* 新增`MigrationSourceIds.N`参数，传入后将依据迁移源筛选对应的迁移任务。 | | ## 2024年07月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增响应参数：|迁移源 |\ | || |\ | |* 新增`SuggestSyncType`参数，表示推荐的迁移方式。| |\ | |* 新增`SyncTypeSupportStatuses`结构，表示迁移源支持的迁移方式。 | | |[DescribeMigrationSystemSupportTypes](https://www.volcengine.com/docs/6886/1312621) |新增接口，用于查询源服务器操作系统支持迁移的目标操作系统。 |迁移任务 | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 请求参数更新：|^^|\ | | * `DestinationConfig.DestinationSystem`参数新增枚举值`VeLinux20Centos`，表示迁移为veLinux 2.0 CentOS兼容版操作系统。| |\ | |* 新增错误码：| |\ | | 400，InvalidSystemVolumeSize.Malformed | | ## 2024年05月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |* 新增响应参数：|迁移源 |\ | | * Sources.DiskInfo结构新增如下参数：| |\ | | * `DiskName`，磁盘盘符。| |\ | | * `FileSystemFormat`，磁盘文件系统格式。| |\ | | * `IsSystemDisk`，磁盘是否是系统盘。| |\ | |* Source结构新增`LvmInfo`参数，表示迁移源LVM信息。 | | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 更新请求参数|迁移任务 |\ | | * `DiskConfigs.N.DiskIndex`参数调整为必填。| |\ | |* 新增错误码：| |\ | | * InvalidFilesystemType.Unsupported| |\ | | * InvalidLVMStatus.Unsupported| |\ | | * InvalidMigrationCheckResult.Unsupported| |\ | | * InvalidRsyncStatus.Unsupported| |\ | | * LimitExceeded.MinimumPartitionSize| |\ | | * QuotaExceeded.GeneralCpu| |\ | |* 更新错误码：| |\ | | * InvalidSecurityGroupPermission.Conflict描述调整为“迁移服务需要目的实例开启8080、22以及5986端口，请检查目的实例安全组规则。”| |\ | | * QuotaExceeded.Cpu描述调整为“已达到可创建的cpu数量上限，迁移服务会创建临时实例，请确保目的可用区cpu数目未达到上限。”| |\ | | * QuotaExceeded.Common错误码：| |\ | | * 错误信息调整为“You've reached the limit of cpu, volume and general cpu that you can create, please submit ticket to request an increase in quota.”| |\ | | * 描述调整为“已达到可创建的cpu、云盘和通用性cpu和数量上限，迁移服务到镜像会在目的地区创建云盘和云服务器，请确保目的地区至少存在一个可用区的云盘和cpu余额能满足迁移服务要求。”| |\ | | * QuotaExceeded.Volume描述调整为“已达到可创建的云盘容量上限，迁移服务会创建临时云盘，请确保目的地区该类型云盘容量未达到上限。”| |\ | | * LimitExceeded.MaximumDiskSize错误信息调整为“The size of disk exceeds the maximum limit.”| |\ | |* 删除错误码：| |\ | | * QuotaExceeded.GereralCpu | | ## 2024年04月 |API |变更记录 |关联功能 | |---|---|---| |[TagResources](https://www.volcengine.com/docs/6886/1186837) |* 更新请求参数：|标签 |\ | | * `Tags.N.Key`参数增加使用限制，不支持任何大小写形式`sys:`开头。 | | |[UnTagResources](https://www.volcengine.com/docs/6886/1186838) |* 更新请求参数：|^^|\ | | * `Tags.N.Key`参数增加使用限制，不支持任何大小写形式`sys:`开头。 | | |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |* 更新请求参数：|迁移源 |\ | | * `PageSize`，取值范围修改为1~50。| |\ | |* 新增返回参数：| |\ | | * `Sources. InstanceInfo`结构新增`BlkNoneCanInstall`参数，表示源实例是否支持安装blk\-none。 | | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 新增请求参数：|迁移任务 |\ | | * `DestinationConfig.AutoInstallBlkNone`，表示是否自动为目标实例或目标镜像安装blk\-none。| |\ | |* 更新请求参数：| |\ | | * `Tags.N.Key`参数增加使用限制，不支持任何大小写形式`sys:`开头。| |\ | |* 新增错误码：| |\ | | * 400，InvalidSyncTypeForMigration.Unsupported，指定迁移任务的复制类型不支持迁移。| |\ | | * 412，OperationDenied.SnapshotServiceUnavailable，指定的操作被拒绝，因为快照服务未开通。 | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |* 更新请求参数：|^^|\ | | * `MigrationJobStateSourceState`参数新增枚举值：| |\ | | * `Terminated`，已终止。| |\ | | * `Terminating`，终止中。| |\ | | * `Warning`，异常。| |\ | | * `PageSize`，取值范围修改为1~50。| |\ | |* 新增返回参数：| |\ | | * `Jobs`结构新增`TemporaryResources`，表示临时资源信息。 | | ## 2024年01月 |API |变更记录 |关联功能 | |---|---|---| |[TagResources](https://www.volcengine.com/docs/6886/1186837) |新增接口，为指定的SMC迁移源、迁移任务创建并绑定标签。 |标签 | |[UnTagResources](https://www.volcengine.com/docs/6886/1186838) |新增接口，为指定的SMC迁移源、迁移任务解绑并删除标签。 |^^| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |* 新增请求参数：|迁移源 |\ | | * `TagFilters.N.Key`，表示用户标签的标签键。| |\ | | * `TagFilters.N.Values.N`，表示用户标签的标签值。| |\ | |* 新增返回参数：| |\ | | * `ImageInfo.KernelVersion`，表示镜像内核版本。| |\ | | * `InstanceInfo.Virtio11Install`，表示源实例是否安装Virtio1.1驱动。| |\ | | * `LastMigrationJobInfo.DestinationType`，表示最近一次迁移任务目标类型。| |\ | | * `LastMigrationJobInfo.ProjectName`，表示迁移任务所属项目。| |\ | | * `Tags`，表示迁移源标签信息。| |\ | |* 新增错误码：| |\ | | * 400，InvalidTagFilterKey.Conflict，指定的过滤标签键已存在。| |\ | | * 400，InvalidTagFilterKey.Malformed，指定的标签键不合法。| |\ | | * 400，InvalidTagFilterValue.Malformed，指定的过滤标签值已存在。| |\ | | * 400，LimitExceeded.MaximumTagFilterKeys，指定的标签过滤键超过最大限制。| |\ | | * 400，LimitExceeded.MaximumTagFilterResults，通过标签过滤出的资源数量超过上限。| |\ | | * 400，LimitExceeded.MaximumTagFilterValues，指定的标签过滤值超过最大限制。 | | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 新增请求参数：|迁移任务 |\ | | * `DestinationConfig.AutoInstallVirtio11`，表示是否自动安装virtio1.1驱动。| |\ | | * `Tags.N.Key`，表示用户标签的标签键。| |\ | | * `Tags.N.Value`，表示用户标签的标签值。| |\ | |* 新增错误码：| |\ | | * 400，InvalidTagKey.Malformed，指定的标签的键不合法。| |\ | | * 400，InvalidTagValue.Malformed，指定的标签的值不合法。| |\ | | * 400，LimitExceeded.MaximumTags，指定的标签数量超过最大限制。| |\ | | * 409，InvalidTagKey.Conflict，指定的标签键已存在。 | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |* 新增请求参数：|^^|\ | | * `TagFilters.N.Key`，表示用户标签的标签键。| |\ | | * `TagFilters.N.Values.N`，表示用户标签的标签值。| |\ | |* 新增返回参数：| |\ | | * `DestinationConfig.AutoInstallVirtio11`，表示是否自动安装Virtio1.1驱动。| |\ | | * `SourceProjectName`，表示迁移任务对应的迁移源所属项目。| |\ | | * `Tags`，表示迁移源标签信息。| |\ | |* 新增错误码：| |\ | | * 400，InvalidTagFilterKey.Conflict，指定的过滤标签键已存在。| |\ | | * 400，InvalidTagFilterKey.Malformed，指定的标签键不合法。| |\ | | * 400，InvalidTagFilterValue.Malformed，指定的过滤标签值已存在。| |\ | | * 400，LimitExceeded.MaximumTagFilterKeys，指定的标签过滤键超过最大限制。| |\ | | * 400，LimitExceeded.MaximumTagFilterResults，通过标签过滤出的资源数量超过上限。| |\ | | * 400，LimitExceeded.MaximumTagFilterValues，指定的标签过滤值超过最大限制。 | | ## 2023年11月 |API |变更记录 |关联功能 | |---|---|---| |[ModifyMigrationSourceAttribute](https://www.volcengine.com/docs/6886/1171071) |新增接口，用于修改迁移源基础信息。 |迁移源 | |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |* 新增请求参数：|^^|\ | | * `ProjectName`，表示迁移源所属项目。| |\ | |* 新增返回数据：| |\ | | * `Sources`结构新增参数`ProjectName`，表示迁移源所属项目。| |\ | |* 新增错误码：| |\ | | * 400，InvalidProjectName.Malformed，指定的ProjectName不合法。 | | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 新增请求参数：|迁移任务 |\ | | * `ProjectName`，表示迁移任务所属项目。| |\ | |* 新增错误码：| |\ | | * 400，InvalidProjectName.Malformed，指定的ProjectName不合法。 | | |[ModifyMigrationJobAttribute](https://www.volcengine.com/docs/6886/1171072) |新增接口，用于修改迁移任务基础信息。 |^^| |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |* 新增请求参数：|^^|\ | | * `ProjectName`，表示迁移任务所属项目。| |\ | |* 新增返回数据：| |\ | | * `Jobs`结构新增`ProjectName`参数，表示迁移任务所属项目。| |\ | |* 新增错误码：| |\ | | * 400，InvalidProjectName.Malformed，指定的ProjectName不合法。 | | ## 2023年09月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增接口，用于查询迁移源信息。 |迁移源 | |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |* 新增请求参数：|迁移任务 |\ | | * `DestinationConfig.DestinationSystem`，表示目标操作系统。| |\ | |* 变更请求参数：| |\ | | * `DestinationConfig.DestinationType`，新增枚举值：| |\ | | * `ECSSystem`，表示云服务器操作系统。| |\ | | * `SyncConfig.SyncType`，变更为可选参数。| |\ | | * `SyncConfig.TriggerLastSync`，变更为可选参数。| |\ | |* 删除错误码：| |\ | | * 400，MissingParameter.TriggerLastSync，参数TriggerLastSync不能为空。 | | |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |* 新增请求参数：|^^|\ | | * `DestinationType.N`，表示根据迁移目标类型过滤迁移任务。| |\ | |* 新增返回数据：| |\ | | * `SystemConfig.Jobs`结构，新增`SystemConfig`参数，表示操作系统配置。| |\ | | * `SystemConfig.Jobs.DestinationConfig`结构，新增`DestinationSystem`参数，表示目标操作系统。 | | ## 2023年07月 |API |变更记录 |关联功能 | |---|---|---| |[DescribeMigrationSources](https://www.volcengine.com/docs/6886/984874) |新增接口，用于查询迁移源信息。 |迁移源 | |[DeleteMigrationSource](https://www.volcengine.com/docs/6886/984875) |新增接口，用于删除一个迁移源。 |^^| |[CreateMigrationJob](https://www.volcengine.com/docs/6886/984892) |新增接口，用于创建迁移任务。 |迁移任务 | |[DeleteMigrationJob](https://www.volcengine.com/docs/6886/984906) |新增接口，用于删除一个迁移任务。 |^^| |[DescribeMigrationJobs](https://www.volcengine.com/docs/6886/984907) |新增接口，用于查询迁移任务信息。 |^^| |[DescribeMigrationLogs](https://www.volcengine.com/docs/6886/984908) |新增接口，用于查询迁移日志。 |^^| |[SetIncrementalSyncInterval](https://www.volcengine.com/docs/6886/984911) |新增接口，用于设置自动增量同步。 |^^| |[TriggerLastIncrementalSync](https://www.volcengine.com/docs/6886/984912) |新增接口，用于进行最后一次自动增量同步。 |^^|