You need to enable JavaScript to run this app.
文档中心
服务器迁移中心

服务器迁移中心

复制全文
下载 pdf
迁移源
DescribeMigrationSources - 查询迁移源信息
复制全文
下载 pdf
DescribeMigrationSources - 查询迁移源信息
调用 DescribeMigrationSources 接口,查询迁移源信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:DescribeMigrationSources​
要执行的操作,取值:DescribeMigrationSources。​
​
Version string 必选 示例值:2020-04-01​
API的版本,取值:2020-04-01。​
​
Order string 可选 示例值:Desc​
排序顺序,取值:​
  • Desc:降序。​
  • Asc:升序。​
​
OrderByColumn string 可选 示例值:CreatedAt​
排序字段,取值:​
  • CreatedAt:导入时间。​
​
PageNumber integer 可选 示例值:1​
分页数。​
​
PageSize integer 可选 示例值:10​
页表大小。​
  • 取值范围:1~50​
  • 默认值:10​
​
ProjectName string 可选 示例值:project_a​
迁移源所属项目,一个迁移源只能归属于一个项目。​
  • 只能包含字母、数字、下划线“_”、点“.”和中划线“-”。​
  • 长度限制在64个字符以内。​
​
SourceId string 可选 示例值:s-3tiegs1y963vj0******​
迁移源ID,可在导入迁移源时或调用本接口查询获取。​
说明​
根据迁移源ID查询迁移源信息时,需要传入该参数。​
​
SourceName string 可选 示例值:Local VM​
迁移源名称,最大长度为255个字符。​
说明​
根据迁移源名称查询迁移源信息时,需要传入该参数。​
​
SourceState string 可选 示例值:Online​
迁移源状态,取值:​
  • Online:在线。​
  • Offline:离线。​
  • Migrating:迁移中。​
  • Error:异常。​
​
SourceType string 可选 示例值:Normal​
迁移源来源类型。取值:​
  • Normal:普通迁移。​
  • Batch:一键迁移。​
​
TagFilters.N.Key string[] 可选 示例值:TagFilters.1.Key=k1&Tags.2.Key=k2​
根据标签查询资源时指定的标签键。​
  • 参数 - N:表示标签键的序号,取值范围:1~10。​
  • 多个标签键之间用&分隔,不允许重复。​
说明​
  • 不传则表示查询所有标签。​
  • 传入空字符串时,则返回错误码InvalidTagFilterKey.Malformed。​
​
TagFilters.N.Values.N string[] 可选 示例值:TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2​
根据标签查询资源时指定的标签值。​
  • 第一个N:表示标签键的序号,取值范围:1~10。​
  • 第二个N:表示标签值的序号,取值范围:1~3。​
  • 多个标签值之间用&分隔。​
说明​
  • 如果传入该参数,则必须先传入TagFilters.N.Key。​
  • 不传则表示查询同一标签键下的所有标签值。​
  • 传入空字符串时,表示查询标签值为空的标签。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
PageNumber integer 示例值:1​
分页数。​
​
PageSize integer 示例值:10​
页表大小。​
​
Sources object[] 示例值:--​
符合条件的迁移源信息。​
AgentVersion string 示例值:linux-1.4​
迁移Agent版本号。​
​
CreatedAt string 示例值:2023-06-01T10:27:16+08:00​
迁移源导入时间。​
​
DiskInfo object[] 示例值:--​
迁移源磁盘信息。​
DiskUsedSize long 示例值:100​
磁盘使用量,单位Bytes。​
​
DiskIndex integer 示例值:0​
磁盘下标。​
​
DiskName string 示例值:vda​
盘符。​
​
DiskSize integer 示例值:20​
磁盘容量,单位GB。​
​
FileSystemFormat string 示例值:vfat​
文件系统格式。​
​
IsSystemDisk boolean 示例值:true​
是否是系统盘。取值:​
  • true:是系统盘。​
  • false:不是系统盘。​
​
Partitions object[] 示例值:--​
磁盘分区信息。​
FileSystemFormat string 示例值:vfat​
文件系统格式。​
​
Mountpoint string 示例值:/boot/efi​
分区挂载点。​
说明​
返回值为空,表示未挂载。​
​
PartitionIndex integer 示例值:0​
分区下标,从0开始。​
​
PartitionSize long 示例值:209715200​
分区容量,单位Bytes。​
​
PartitionUsedSize long 示例值:200015200​
磁盘分区使用量,单位Bytes。​
​
PartitionName string 示例值:vda1​
磁盘分区名称。​
​
​
​
Hostname string 示例值:localhost.localdomain​
迁移源主机名。​
​
ImageInfo object 示例值:--​
迁移源镜像信息。​
BootMode string 示例值:BIOS​
系统启动模式,取值:​
  • UEFI。​
  • BIOS。​
​
KernelVersion string 示例值:3.10.0-1160.102.1.el7.x86_64​
内核版本。​
​
OS string 示例值:Linux​
操作系统,取值:​
  • Linux。​
  • Windows。​
​
Platform string 示例值:CentOS​
操作系统平台。​
​
PlatformVersion string 示例值:7.9.2009​
操作系统版本号。​
​
VirtualizationSystem string 示例值:kvm​
虚拟化系统。​
​
​
InstanceInfo object 示例值:--​
迁移源实例信息。​
BlkNoneCanInstall boolean 示例值:true​
源实例是否支持安装blk-none。取值:​
  • true:支持。​
  • false:不支持。​
​
BlkNoneInstall boolean 示例值:true​
源实例是否已经安装blk-none。取值:​
  • true:已安装。​
  • false:未安装。​
​
InnerInstance boolean 示例值:false​
源实例是否为火山引擎云服务器实例。取值:​
  • true:表示源实例为火山引擎云服务器实例。​
  • false:表示源实例非火山引擎云服务器实例。​
​
InstanceId string 示例值:i-3teco18f1w5a71****​
源实例在火山引擎的实例ID。​
​
RegionId string 示例值:cn-beijing​
源实例在火山引擎的地域。​
​
Virtio11CanInstall boolean 示例值:true​
源实例是否支持安装Virtio11。取值:​
  • true:支持。​
  • false:不支持。​
​
Virtio11Install boolean 示例值:true​
源实例是否安装Virtio1.1驱动,取值:​
  • true:已安装。​
  • false:未安装。​
​
​
LastMigrationJobInfo object 示例值:--​
最后一次迁移任务信息。​
DestinationType string 示例值:ECSInstance​
最近一次迁移任务目标类型。取值:​
  • ECSInstance:云服务器实例。​
  • ECSImage:云服务器镜像。​
  • ECSSystem:云服务器操作系统。​
​
MigrationJobId string 示例值:job-3tiegs1y963vj0******​
最近一次迁移任务ID。​
​
MigrationJobName string 示例值:VMware Migration​
最近一次迁移任务名称。​
​
MigrationJobState string 示例值:Replicating​
最近一次迁移任务状态,取值:​
  • Preparing:准备中。​
  • Replicating:迁移中。​
  • Success:已完成。​
  • Failed:失败。​
  • Waiting:等待中。​
  • Cleaning:清理中。​
​
ProjectName string 示例值:project_a​
迁移任务所属项目。​
​
​
LvmInfo object 示例值:--​
迁移源LVM信息。​
VgInfos object[] 示例值:--​
逻辑卷组列表。​
Format string 示例值:lvm2​
逻辑卷组格式。​
​
LvInfos object[] 示例值:--​
逻辑卷组下逻辑卷信息列表。​
BlockDevices string[] 示例值:["/dev/vdb1"]​
逻辑卷使用的磁盘块设备列表。​
​
FsType string 示例值:--​
逻辑卷被格式化的文件系统类型。​
​
LvName string 示例值:lv01​
逻辑卷名称。​
​
LvPath string 示例值:/dev/vg_01/lv01​
逻辑卷路径。​
​
LvSize long 示例值:943718400​
逻辑卷大小,单位Bytes。​
​
LvUUID string 示例值:VlMqHc-iZfE-Vo*****​
逻辑卷UUID。​
​
LvUsedSize long 示例值:--​
逻辑卷已使用大小,单位Bytes。​
​
MountPoint string 示例值:--​
逻辑卷挂载点。​
​
VgName string 示例值:vg_01​
逻辑卷所在卷组名称。​
​
​
PvInfos object[] 示例值:--​
逻辑卷组下物理卷信息列表。​
PvName string 示例值:/dev/vdb1​
物理卷名称。​
​
PvSize long 示例值:1019215872​
物理卷大小,单位Bytes。​
​
PvUUID string 示例值:h3ey9f-VJAi*****​
物理卷UUID。​
​
VgName string 示例值:vg_01​
物理卷所在卷组名称。​
​
​
VgName string 示例值:vg_01​
逻辑卷组名称。​
​
VgSize long 示例值:1019215872​
逻辑卷组大小,单位Bytes。​
​
VgUUID string 示例值:Y2apS5-w7yK-*****​
逻辑卷组UUID。​
​
​
​
MigrationSourceDescription string 示例值:Local virtual machine​
迁移源的描述。​
​
PrivateIpAddress string 示例值:172.xx.xx.xxx​
迁移源私网IP。​
​
ProjectName string 示例值:project_a​
迁移源所属项目。​
​
PublicIpAddress string 示例值:119.x.xxx.xxx​
迁移源公网IP。​
​
SourceId string 示例值:s-iegs1y963vj0******​
迁移源ID。​
​
SourceName string 示例值:s-ycg9hd3nfb8r****​
迁移源名称。​
​
SourceState string 示例值:Migrating​
迁移源状态。​
​
SourceType string 示例值:Normal​
迁移源来源类型。​
​
SuggestSyncType string 示例值:Block​
推荐的迁移方式。取值:​
  • File:文件复制。​
  • Block:块复制。​
​
SyncTypeSupportStatuses object[] 示例值:--​
迁移源支持的迁移方式。​
BlockReason string 示例值:--​
不支持该迁移方式的原因。​
​
IsSupport boolean 示例值:true​
是否支持该迁移方式。取值:​
  • true:支持。​
  • false:不支持。​
​
SyncType string 示例值:File​
迁移方式。取值:​
  • File:文件复制。​
  • Block:块复制。​
​
​
SystemInfo object 示例值:--​
迁移源系统信息。​
Architecture string 示例值:x86_64​
CPU架构。取值:​
  • x86_64​
​
CPU integer 示例值:2​
实例CPU核数。​
​
CPUUsage float 示例值:10​
CPU使用率,以百分比为单位,例如:10表示CPU使用率为10%。​
​
Memory long 示例值:8236490752​
内存大小,单位Bytes。​
​
MemoryUsage float 示例值:10​
内存使用率,以百分比为单位,例如:47.86表示内存使用率为47.86%。​
​
​
Tags object[] 示例值:--​
迁移源标签信息。​
Key string 示例值:Key=k1​
根据标签查询资源时指定的标签键。​
​
Value string 示例值:Value=v1​
根据标签查询资源时指定的标签值。​
​
​
​
TotalCount integer 示例值:1​
迁移源总数。​
​
​
​
请求示例​
​
GET /?Action=DescribeMigrationSources&Version=2020-04-01 HTTP/1.1​
Host: smc.volcengineapi.com​
Region: cn-beijing​
Service: smc​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202306021637410F150D*****",​
"Action": "DescribeMigrationSources",​
"Version": "2020-04-01",​
"Service": "smc",​
"Region": "cn-beijing"​
},​
"Result": {​
"TotalCount": 1,​
"PageNumber": 1,​
"PageSize": 10,​
"Sources": [​
{​
"SourceId": "s-ycg9hd3nfb8rx6****",​
"SourceName": "s-ycg9hd3nfb8r****",​
"Hostname": "localhost.localdomain",​
"CreatedAt": "2023-06-01T10:27:16+08:00",​
"SourceState": "Migrating",​
"PublicIpAddress": "119.x.xxx.xxx",​
"PrivateIpAddress": "172.xx.xx.xxx",​
"MigrationSourceDescription": "Local VM",​
"AgentVersion": "linux-1.4",​
"ProjectName": "project_a",​
"SourceType": "Normal",​
"SuggestSyncType": "Block",​
"SyncTypeSupportStatuses": [​
{​
"SyncType": "File",​
"IsSupport": true,​
"BlockReason": ""​
},​
{​
"SyncType": "Block",​
"IsSupport": true,​
"BlockReason": ""​
}​
],​
"SystemInfo": {​
"CPU": 1,​
"Memory": 1019027456,​
"CPUUsage": 4,​
"MemoryUsage": 47.86,​
"Architecture": "x86_64"​
},​
"ImageInfo": {​
"OS": "Linux",​
"Platform": "CentOS",​
"PlatformVersion": "7.9.2009",​
"BootMode": "UEFI",​
"VirtualizationSystem": "",​
"KernelVersion": "3.10.0-1160.102.1.el7.x86_64"​
},​
"InstanceInfo": {​
"InnerInstance": "true",​
"InstanceId": "i-3teco18f1w5a71****",​
"RegionId": "cn-beijing",​
"Virtio11CanInstall": true,​
"Virtio11Install": true,​
"BlkNoneCanInstall": true,​
"BlkNoneInstall": true​
},​
"DiskInfo": [​
{​
"DiskIndex": 0,​
"DiskSize": 20,​
"DiskUsedSize": 100,​
"Partitions": [​
{​
"PartitionIndex": 0,​
"PartitionSize": 209715200,​
"Mountpoint": "/boot/efi",​
"FileSystemFormat": "vfat",​
"PartitionName": "vda1",​
"PartitionUsedSize": "200015200"​
},​
{​
"PartitionIndex": 1,​
"PartitionSize": 1073741824,​
"Mountpoint": "/boot",​
"FileSystemFormat": "xfs",​
"PartitionName": "vdb1",​
"PartitionUsedSize": "1003741824"​
}​
],​
"FileSystemFormat": "",​
"DiskName": "vda",​
"IsSystemDisk": true​
}​
],​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"LvmInfo": {​
"VgInfos": []​
},​
"LastMigrationJobInfo": {​
"DestinationType": "ECSInstance",​
"ProjectName": "project_a",​
"MigrationJobId": "job-ycg9hghuv7****",​
"MigrationJobName": "VMware Migration",​
"MigrationJobState": "Replicating"​
}​
}​
]​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidOrder.Malformed​
The specified Order is malformed.​
指定的Order不合法。​
400​
InvalidOrderByColumn.Malformed​
The specified OrderByColumn is malformed.​
指定的OrderByColumn不合法。​
400​
InvalidProjectName.Malformed​
The specified ProjectName is malformed.​
指定的ProjectName不合法。​
400​
InvalidSourceName.Malformed​
The specified SourceName is malformed.​
指定的SourceName不合法。​
400​
InvalidSourceState.Malformed​
The specified SourceState is malformed.​
指定的SourceState不合法。​
400​
InvalidSourceType.Malformed​
The specified SourceType is malformed.​
指定的SourceType不合法。​
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.​
指定的标签过滤值超过最大限制。​
​
​
最近更新时间:2025.11.24 10:37:51
这个页面对您有帮助吗?
有用
有用
无用
无用