更新指定ID的迁移任务 - UpdateTask
功能介绍
更新指定ID的迁移任务
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
sms:server:updateTask
Write
server *
-
-
-
-
g:EnterpriseProjectId
URI
PUT /v3/tasks/{task_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
task_id |
是 |
String |
迁移任务ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
任务名称(用户自定义) |
type |
否 |
String |
任务类型,创建时必选,更新时可选 MIGRATE_FILE:文件级迁移 MIGRATE_BLOCK:块级迁移 枚举值: |
os_type |
否 |
String |
操作系统类型,分为WINDOWS和LINUX,创建时必选,更新时可选 枚举值: |
id |
否 |
String |
迁移任务ID |
priority |
否 |
Integer |
进程优先级 0:低 1:标准(默认) 2:高 取值范围: 0-2 枚举值: |
region_id |
否 |
String |
目的端服务器的区域ID |
start_target_server |
否 |
Boolean |
迁移完成后是否启动目的端服务器 true:启动 false:停止 默认取值: true |
enterprise_project_id |
否 |
String |
企业项目ID |
exist_server |
否 |
Boolean |
目的端服务器是否存在。true代表已有目的端服务器,false代表需要新建目的端服务器 |
migration_ip |
否 |
String |
目的端服务器的IP地址。 公网迁移时请填写弹性IP地址 专线迁移时请填写私有IP地址 |
region_name |
否 |
String |
目的端服务器的区域名称 |
speed_limit |
否 |
Integer |
限制迁移速率,单位:Mbps 取值范围: 0-10000 |
project_name |
否 |
String |
目的端服务器所在项目名称 |
project_id |
否 |
String |
目的端服务器所在项目ID |
vm_template_id |
否 |
String |
模板ID |
source_server |
否 |
PostSourceServerBody object |
源端服务器 |
target_server |
否 |
TargetServer object |
目的端服务器 |
state |
否 |
String |
任务状态 |
estimate_complete_time |
否 |
Long |
预估完成时间 取值范围: 0-9223372036854775807 |
connected |
否 |
Boolean |
连接状态 |
create_date |
否 |
Long |
任务创建时间 取值范围: 0-9223372036854775807 |
start_date |
否 |
Long |
任务开始时间 取值范围: 0-9223372036854775807 |
finish_date |
否 |
Long |
任务结束时间 取值范围: 0-9223372036854775807 |
migrate_speed |
否 |
Double |
迁移速率,单位:MB/S 取值范围: 0-10000 |
error_json |
否 |
String |
错误信息 |
total_time |
否 |
Long |
任务总耗时 取值范围: 0-9223372036854775807 |
float_ip |
否 |
String |
暂时保留float,兼容现网老版本的SMS-Agent |
remain_seconds |
否 |
Long |
迁移剩余时间(秒) 取值范围: 0-9223372036854775807 |
target_snapshot_id |
否 |
String |
目的端的快照ID |
clone_server |
否 |
CloneServer object |
克隆服务器类 |
sub_tasks |
否 |
Array of SubTask objects |
任务包含的子任务列表 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
源端在SMS数据库中的ID |
ip |
否 |
String |
源端服务器ip,注册源端时必选,更新非必选 |
name |
否 |
String |
用来区分不同源端服务器的名称 |
hostname |
否 |
String |
源端主机名,注册源端必选,更新非必选 |
os_type |
否 |
String |
源端服务器的OS类型,分为Windows和Linux,注册必选,更新非必选 枚举值: |
os_version |
否 |
String |
操作系统版本,注册必选,更新非必选 |
virtualization_type |
否 |
String |
操作系统虚拟化方式 |
linux_block_check |
否 |
String |
Linux操作系统块检查 |
firmware |
否 |
String |
源端服务器启动类型,如BIOS或者UEFI 枚举值: |
cpu_quantity |
否 |
Integer |
CPU个数,单位vCPU 取值范围: 0-65535 |
memory |
否 |
Long |
内存大小,单位MB 取值范围: 0-9223372036854775807 |
disks |
否 |
Array of ServerDisk objects |
源端服务器的磁盘信息 |
btrfs_list |
否 |
Array of BtrfsFileSystem objects |
Linux 必选,源端的Btrfs信息。如果源端不存在Btrfs,则为[] |
networks |
否 |
Array of NetWork objects |
源端服务器的网卡信息 |
domain_id |
否 |
String |
租户的domainId |
has_rsync |
否 |
Boolean |
是否安装rsync组件,Linux系统此参数为必选 |
paravirtualization |
否 |
Boolean |
Linux场景必选,源端是否是半虚拟化 |
raw_devices |
否 |
String |
Linux必选,裸设备列表 |
driver_files |
否 |
Boolean |
Windows 必选,是否缺少驱动文件 |
system_services |
否 |
Boolean |
Windows必选,是否存在不正常服务 |
account_rights |
否 |
Boolean |
Windows必选,权限是否满足要求 |
boot_loader |
否 |
String |
Linux必选,系统引导类型,BOOT_LOADER(GRUB/LILO) 枚举值: |
system_dir |
否 |
String |
Windows必选,系统目录 |
volume_groups |
否 |
Array of VolumeGroups objects |
Linux必选,如果没有卷组,输入[] |
agent_version |
否 |
String |
Agent版本 |
kernel_version |
否 |
String |
内核版本信息 |
migration_cycle |
否 |
String |
迁移周期 cutovering:启动目的端中 cutovered:启动目的端完成 checking:检查中 setting:设置中 replicating:复制中 syncing:同步中 枚举值: |
state |
否 |
String |
源端服务器状态 unavailable:环境校验不通过 waiting:等待 initialize:初始化 replicate:复制 syncing:持续同步 stopping:暂停中 stopped:已暂停 skipping:跳过中 deleting:删除中 error:错误 cloning:等待克隆完成 cutovering:启动目的端中 finished:启动目的端完成 clearing: 清理快照资源中 cleared:清理快照资源完成 clearfailed:清理快照资源失败 premigready: 迁移演练已就绪 premiging: 迁移演练中 premiged: 迁移演练已完成 premigfailed: 迁移演练失败 枚举值: |
oem_system |
否 |
Boolean |
是否是OEM操作系统(Windows) |
start_type |
否 |
String |
启动方式,可以取值MANUAL、MGC或者空。 枚举值: |
io_read_wait |
否 |
Double |
磁盘IO读时延,单位为ms 取值范围: 0.0-10000.0 |
has_tc |
否 |
Boolean |
是否安装tc组件,Linux系统此参数为必选 |
platform |
否 |
String |
平台信息: hw:华为 ali:阿里 aws:亚马逊 azure:微软云 gcp:谷歌云 tencent:腾讯云 vmware hyperv other:其他 枚举值: |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
磁盘名称 |
partition_style |
否 |
String |
磁盘的分区类型,添加源端时源端磁盘必选 MBR:mbr格式 GPT:gpt格式 枚举值: |
device_use |
是 |
String |
磁盘类型 BOOT:BOOT设备 OS:系统设备 枚举值: |
size |
是 |
Long |
磁盘总大小,以字节为单位 取值范围: 0-9223372036854775807 |
used_size |
是 |
Long |
磁盘已使用大小,以字节为单位 取值范围: 0-9223372036854775807 |
physical_volumes |
是 |
Array of PhysicalVolume objects |
磁盘上的物理分区信息 |
os_disk |
否 |
Boolean |
是否为系统盘 |
relation_name |
否 |
String |
Linux系统 目的端ECS中与源端关联的磁盘名称 |
inode_size |
否 |
Integer |
inode数量 取值范围: 0-2147483647 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
device_use |
否 |
String |
分区类型,普通分区,启动分区,系统分区 |
file_system |
否 |
String |
文件系统类型 |
index |
否 |
Integer |
顺序 取值范围: 0-2147483647 |
mount_point |
否 |
String |
挂载点 |
name |
否 |
String |
名称,windows表示盘符,Linux表示设备号 |
size |
否 |
Long |
大小 取值范围: 0-9223372036854775807 |
used_size |
否 |
Long |
使用大小 取值范围: 0-9223372036854775807 |
inode_size |
否 |
Integer |
inode数量 取值范围: 0-2147483647 |
inode_nums |
否 |
Long |
inode节点数量 取值范围: 0-9223372036854775807 |
uuid |
否 |
String |
GUID,可从源端查询 |
size_per_cluster |
否 |
Integer |
每个cluster大小 取值范围: 0-2147483647 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
服务器在SMS数据库中的ID |
ip |
是 |
String |
服务器IP,注册源端时必选,更新非必选 |
name |
是 |
String |
用来区分不同服务器的名称 |
hostname |
否 |
String |
主机名,注册源端必选,更新非必选 |
os_type |
是 |
String |
服务器的OS类型,分为Windows和Linux,注册必选,更新非必选 枚举值: |
os_version |
否 |
String |
操作系统版本,注册必选,更新非必选 |
firmware |
否 |
String |
服务器启动类型,如BIOS或者UEFI 枚举值: |
cpu_quantity |
否 |
Integer |
CPU个数,单位vCPU 取值范围: 0-65535 |
memory |
否 |
Long |
内存大小,单位MB 取值范围: 0-9223372036854775807 |
btrfs_list |
否 |
Array of BtrfsFileSystem objects |
Linux 必选,服务器的Btrfs信息。如果不存在Btrfs,则为[] |
networks |
否 |
Array of NetWork objects |
服务器的网卡信息 |
domain_id |
否 |
String |
租户的domainId |
has_rsync |
否 |
Boolean |
是否安装rsync组件,Linux系统此参数为必选 |
paravirtualization |
否 |
Boolean |
Linux场景必选,源端是否是半虚拟化 |
raw_devices |
否 |
String |
Linux必选,裸设备列表 |
driver_files |
否 |
Boolean |
Windows 必选,是否缺少驱动文件 |
system_services |
否 |
Boolean |
Windows必选,是否存在不正常服务 |
account_rights |
否 |
Boolean |
Windows必选,权限是否满足要求 |
boot_loader |
否 |
String |
Linux必选,系统引导类型,BOOT_LOADER(GRUB/LILO) 枚举值: |
system_dir |
否 |
String |
Windows必选,系统目录 |
volume_groups |
否 |
Array of VolumeGroups objects |
Linux必选,如果没有卷组,输入[] |
vm_id |
否 |
String |
目的端服务器ID,自动创建虚拟机不需要这个参数 |
flavor |
否 |
String |
目的端服务器的规格 |
disks |
是 |
Array of TargetDisk objects |
目的端磁盘信息,一般和源端保持一致 |
image_disk_id |
否 |
String |
目的端代理镜像磁盘ID |
snapshot_ids |
否 |
String |
目的端快照ID |
cutovered_snapshot_ids |
否 |
String |
目的端回滚快照ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
文件系统名称 |
label |
是 |
String |
文件系统标签,若无标签为空字符串 |
uuid |
是 |
String |
文件系统的uuid |
device |
是 |
String |
btrfs包含的设备名称 |
size |
是 |
Long |
文件系统数据占用大小 取值范围: 0-9223372036854775807 |
nodesize |
是 |
Long |
btrfs节点大小 取值范围: 0-9223372036854775807 |
sectorsize |
是 |
Integer |
扇区大小 取值范围: 0-2147483647 |
data_profile |
是 |
String |
数据配置(RAD) |
system_profile |
是 |
String |
文件系统配置(RAD) |
metadata_profile |
是 |
String |
元数据配置(RAD) |
global_reserve1 |
是 |
String |
Btrfs文件系统信息 |
g_vol_used_size |
是 |
Long |
Btrfs卷已使用空间大小 取值范围: 0-9223372036854775807 |
default_subvolid |
是 |
String |
默认子卷ID |
default_subvol_name |
是 |
String |
默认子卷名称 |
default_subvol_mountpath |
是 |
String |
默认子卷挂载路径/BTRFS文件系统的挂载路径 |
subvolumn |
是 |
Array of BtrfsSubvolumn objects |
子卷信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
uuid |
是 |
String |
父卷的uuid |
is_snapshot |
是 |
String |
子卷是否为快照 |
subvol_id |
是 |
String |
子卷的ID |
parent_id |
是 |
String |
父卷ID |
subvol_name |
是 |
String |
子卷的名称 |
subvol_mount_path |
是 |
String |
子卷的挂载路径 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
网卡的名称 |
ip |
是 |
String |
该网卡绑定的IP |
ipv6 |
否 |
String |
IPv6地址 |
netmask |
是 |
String |
掩码 |
gateway |
是 |
String |
网关 |
mtu |
否 |
Integer |
Linux必选,网卡的MTU 取值范围: 0-2147483647 |
mac |
是 |
String |
Mac地址 |
id |
否 |
String |
数据库ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
components |
否 |
String |
Pv信息 |
free_size |
否 |
Long |
剩余空间 取值范围: 0-9223372036854775807 |
logical_volumes |
否 |
Array of LogicalVolumes objects |
lv信息 |
name |
否 |
String |
名称 |
size |
否 |
Long |
大小 取值范围: 0-9223372036854775807 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
block_count |
否 |
Integer |
块数量 取值范围: 0-2147483647 默认取值: 0 |
block_size |
否 |
Long |
块大小 取值范围: 0-1048576 默认取值: 0 |
file_system |
是 |
String |
文件系统 |
inode_size |
是 |
Integer |
inode数量 取值范围: 0-2147483647 |
inode_nums |
否 |
Long |
inode节点数量 取值范围: 0-9223372036854775807 |
device_use |
否 |
String |
分区类型,普通分区,启动分区,系统分区 |
mount_point |
是 |
String |
挂载点 |
name |
是 |
String |
名称 |
size |
是 |
Long |
大小 取值范围: 0-9223372036854775807 |
used_size |
是 |
Long |
使用大小 取值范围: 0-9223372036854775807 |
free_size |
是 |
Long |
剩余空间 取值范围: 0-9223372036854775807 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
Long |
磁盘标识ID 取值范围: 0-9223372036854775807 |
device_use |
否 |
String |
判断是普通分区,启动分区还是系统分区 BOOT:BOOT设备 OS:系统设备 NORMAL:平常 默认取值: NORMAL 枚举值: |
disk_id |
否 |
String |
磁盘ID |
name |
否 |
String |
磁盘名称 |
physical_volumes |
否 |
Array of TargetPhysicalVolumes objects |
逻辑卷信息 |
size |
否 |
Long |
大小 取值范围: 0-9223372036854775807 |
used_size |
否 |
Long |
已使用大小 取值范围: 0-9223372036854775807 |
disk_index |
否 |
String |
磁盘索引 |
os_disk |
否 |
Boolean |
是否为系统盘 |
partition_style |
否 |
String |
磁盘的分区类型,添加源端时源端磁盘必选 MBR:mbr格式 GPT:gpt格式 枚举值: |
relation_name |
否 |
String |
Linux系统 目的端ECS中与源端关联的磁盘名称 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
Long |
逻辑卷ID 取值范围: 0-9223372036854775807 |
device_use |
否 |
String |
分区类型 NORMAL:平常 OS:系统设备 BOOT:BOOT设备 默认取值: NORMAL 枚举值: |
file_system |
否 |
String |
文件系统 |
index |
否 |
Integer |
编号 取值范围: 0-2147483647 |
mount_point |
否 |
String |
挂载点 |
name |
否 |
String |
名称 |
size |
否 |
Long |
大小 取值范围: 0-9223372036854775807 |
used_size |
否 |
Long |
使用大小 取值范围: 0-9223372036854775807 |
uuid |
否 |
String |
uuid |
relation_name |
否 |
String |
Linux系统 目的端ECS中与源端关联的磁盘名称 |
free_size |
否 |
Long |
分区空闲大小 取值范围: 0-9223372036854775807 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vm_id |
否 |
String |
克隆服务器ID |
name |
否 |
String |
克隆虚拟机的名称 |
clone_error |
否 |
String |
克隆错误信息 |
clone_state |
否 |
String |
克隆状态 |
error_msg |
否 |
String |
克隆错误信息描述 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
Long |
子任务ID 取值范围: 0-9223372036854775807 |
name |
否 |
String |
子任务名称 |
progress |
是 |
Integer |
子任务的进度,取值为0-100之间的整数 取值范围: 0-100 |
start_date |
否 |
Long |
子任务开始时间 取值范围: 0-9223372036854775807 |
end_date |
否 |
Long |
子任务结束时间(如果子任务还没有结束,则为空) 取值范围: 0-9223372036854775807 |
migrate_speed |
否 |
Double |
迁移速率,Mbit/s 取值范围: 0-10000 |
user_op |
否 |
String |
触发子任务的用户操作名称 |
process_trace |
否 |
String |
迁移或同步时,具体的迁移详情 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
任务ID |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误代码 |
error_msg |
String |
错误信息 |
encoded_authorization_message |
String |
加密授权信息 |
error_param |
Array of strings |
错误参数 |
details |
Array of details objects |
详细错误信息 |
请求示例
更新任务ID为ef3b9722-07a0-40ae-89b0-889ee96dxxxx的迁移任务的信息。
put https://{endpoint}/v3/tasks/ef3b9722-07a0-40ae-89b0-889ee96dxxxx { "name" : "MigrationTask", "type" : "MIGRATE_BLOCK", "os_type" : "WINDOWS", "state" : "RUNNING", "estimate_complete_time" : null, "create_date" : 1598435778000, "start_date" : 1598435784000, "finish_date" : null, "priority" : 1, "speed_limit" : 0, "migrate_speed" : 0.0, "start_target_server" : true, "error_json" : "", "total_time" : 115, "float_ip" : null, "migration_ip" : null, "vm_template_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", "region_name" : "region name", "region_id" : "region id", "project_name" : "project name", "project_id" : "xxxxxxxxxxxxxxxxxxxxxxxx00000001", "sub_tasks" : [ { "id" : 7278, "name" : "CREATE_CLOUD_SERVER", "progress" : 0, "start_date" : 1598435802000, "end_date" : null, "user_op" : "REPLICATE" }, { "id" : 7279, "name" : "SSL_CONFIG", "progress" : 0, "start_date" : null, "end_date" : null, "user_op" : "REPLICATE" }, { "id" : 7280, "name" : "ATTACH_AGENT_IMAGE", "progress" : 0, "start_date" : null, "end_date" : null, "user_op" : "REPLICATE" }, { "id" : 7281, "name" : "FORMAT_DISK_WINDOWS", "progress" : 0, "start_date" : null, "end_date" : null, "user_op" : "REPLICATE" }, { "id" : 7282, "name" : "MIGRATE_WINDOWS_BLOCK", "progress" : 0, "start_date" : null, "end_date" : null, "user_op" : "REPLICATE" } ], "source_server" : { "id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", "ip" : "192.168.0.154", "name" : "name-win16", "os_type" : "WINDOWS", "os_version" : "WINDOWS2016_64BIT", "agent_version" : "1.2.0", "oem_system" : false, "state" : "initialize", "migration_cycle" : "replicating" }, "target_server" : { "id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", "vm_id" : "", "name" : "", "ip" : null, "os_type" : "WINDOWS", "os_version" : "WINDOWS2016_64BIT", "system_dir" : "Y:\\Windows\\System32", "disks" : [ { "id" : 88008, "name" : "Disk 1", "relation_name" : null, "disk_id" : "0", "partition_style" : "MBR", "size" : 42949672960, "used_size" : 42947575808, "device_use" : "OS", "os_disk" : true, "physical_volumes" : [ { "id" : 135055, "uuid" : "\\\\?\\Volume{586b7157-0000-0000-0000-100000000000}\\", "index" : 1, "name" : "Z:", "relation_name" : null, "device_use" : "BOOT", "file_system" : "NTFS", "mount_point" : null, "size" : 524288000, "used_size" : 410275840, "free_size" : 114012160 }, { "id" : 135056, "uuid" : "\\\\?\\Volume{586b7157-0000-0000-0000-501f00000000}\\", "index" : 2, "name" : "Y:", "relation_name" : null, "device_use" : "OS", "file_system" : "NTFS", "mount_point" : null, "size" : 42423287808, "used_size" : 23170301952, "free_size" : 19252985856 } ], "disk_index" : "0" } ], "volume_groups" : [ ], "image_disk_id" : null, "cutovered_snapshot_ids" : null }, "clone_server" : null }
响应示例
状态码:200
更新指定ID的迁移任务
{ "id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001" }
状态码:403
鉴权失败
{ "error_code" : "SMS.9004", "error_msg" : "The current account does not have the permission to execute policy You do not have permission to perform action XXX on resource XXX.", "encoded_authorization_message" : "XXXXXX", "error_param" : [ "You do not have permission to perform action XXX on resource XXX." ], "details" : [ { "error_code" : "SMS.9004", "error_msg" : "You do not have permission to perform action XXX on resource XXX." } ] }
SDK代码示例
SDK代码示例如下。
更新任务ID为ef3b9722-07a0-40ae-89b0-889ee96dxxxx的迁移任务的信息。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 |
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.GlobalCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.sms.v3.region.SmsRegion; import com.huaweicloud.sdk.sms.v3.*; import com.huaweicloud.sdk.sms.v3.model.*; import java.util.List; import java.util.ArrayList; public class UpdateTaskSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); ICredential auth = new GlobalCredentials() .withAk(ak) .withSk(sk); SmsClient client = SmsClient.newBuilder() .withCredential(auth) .withRegion(SmsRegion.valueOf("<YOUR REGION>")) .build(); UpdateTaskRequest request = new UpdateTaskRequest(); request.withTaskId("{task_id}"); PutTaskReq body = new PutTaskReq(); List<SubTask> listbodySubTasks = new ArrayList<>(); listbodySubTasks.add( new SubTask() .withId(7278L) .withName("CREATE_CLOUD_SERVER") .withProgress(0) .withStartDate(1598435802000L) .withUserOp("REPLICATE") ); listbodySubTasks.add( new SubTask() .withId(7279L) .withName("SSL_CONFIG") .withProgress(0) .withUserOp("REPLICATE") ); listbodySubTasks.add( new SubTask() .withId(7280L) .withName("ATTACH_AGENT_IMAGE") .withProgress(0) .withUserOp("REPLICATE") ); listbodySubTasks.add( new SubTask() .withId(7281L) .withName("FORMAT_DISK_WINDOWS") .withProgress(0) .withUserOp("REPLICATE") ); listbodySubTasks.add( new SubTask() .withId(7282L) .withName("MIGRATE_WINDOWS_BLOCK") .withProgress(0) .withUserOp("REPLICATE") ); List<TargetPhysicalVolumes> listDisksPhysicalVolumes = new ArrayList<>(); listDisksPhysicalVolumes.add( new TargetPhysicalVolumes() .withId(135055L) .withDeviceUse(TargetPhysicalVolumes.DeviceUseEnum.fromValue("BOOT")) .withFileSystem("NTFS") .withIndex(1) .withName("Z:") .withSize(524288000L) .withUsedSize(410275840L) .withUuid("\\?\Volume{586b7157-0000-0000-0000-100000000000}\") .withFreeSize(114012160L) ); listDisksPhysicalVolumes.add( new TargetPhysicalVolumes() .withId(135056L) .withDeviceUse(TargetPhysicalVolumes.DeviceUseEnum.fromValue("OS")) .withFileSystem("NTFS") .withIndex(2) .withName("Y:") .withSize(42423287808L) .withUsedSize(23170301952L) .withUuid("\\?\Volume{586b7157-0000-0000-0000-501f00000000}\") .withFreeSize(19252985856L) ); List<TargetDisk> listTargetServerDisks = new ArrayList<>(); listTargetServerDisks.add( new TargetDisk() .withId(88008L) .withDeviceUse(TargetDisk.DeviceUseEnum.fromValue("OS")) .withDiskId("0") .withName("Disk 1") .withPhysicalVolumes(listDisksPhysicalVolumes) .withSize(42949672960L) .withUsedSize(42947575808L) .withDiskIndex("0") .withOsDisk(true) .withPartitionStyle(TargetDisk.PartitionStyleEnum.fromValue("MBR")) ); TargetServer targetServerbody = new TargetServer(); targetServerbody.withDisks(listTargetServerDisks) .withVolumeGroups() .withVmId("") .withId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001") .withOsVersion("WINDOWS2016_64BIT") .withSystemDir("Y:\Windows\System32") .withOsType(TargetServer.OsTypeEnum.fromValue("WINDOWS")) .withName(""); PostSourceServerBody sourceServerbody = new PostSourceServerBody(); sourceServerbody.withId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001") .withIp("192.168.0.154") .withName("name-win16") .withOsType(PostSourceServerBody.OsTypeEnum.fromValue("WINDOWS")) .withOsVersion("WINDOWS2016_64BIT") .withAgentVersion("1.2.0") .withMigrationCycle(PostSourceServerBody.MigrationCycleEnum.fromValue("replicating")) .withState(PostSourceServerBody.StateEnum.fromValue("initialize")) .withOemSystem(false); body.withSubTasks(listbodySubTasks); body.withTotalTime(115L); body.withErrorJson(""); body.withMigrateSpeed((double)0.0); body.withStartDate(1598435784000L); body.withCreateDate(1598435778000L); body.withState("RUNNING"); body.withTargetServer(targetServerbody); body.withSourceServer(sourceServerbody); body.withVmTemplateId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001"); body.withProjectId("xxxxxxxxxxxxxxxxxxxxxxxx00000001"); body.withProjectName("project name"); body.withSpeedLimit(0); body.withRegionName("region name"); body.withStartTargetServer(true); body.withRegionId("region id"); body.withPriority(PutTaskReq.PriorityEnum.NUMBER_1); body.withOsType(PutTaskReq.OsTypeEnum.fromValue("WINDOWS")); body.withType(PutTaskReq.TypeEnum.fromValue("MIGRATE_BLOCK")); body.withName("MigrationTask"); request.withBody(body); try { UpdateTaskResponse response = client.updateTask(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } |
更新任务ID为ef3b9722-07a0-40ae-89b0-889ee96dxxxx的迁移任务的信息。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 |
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import GlobalCredentials from huaweicloudsdksms.v3.region.sms_region import SmsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdksms.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] credentials = GlobalCredentials(ak, sk) client = SmsClient.new_builder() \ .with_credentials(credentials) \ .with_region(SmsRegion.value_of("<YOUR REGION>")) \ .build() try: request = UpdateTaskRequest() request.task_id = "{task_id}" listSubTasksbody = [ SubTask( id=7278, name="CREATE_CLOUD_SERVER", progress=0, start_date=1598435802000, user_op="REPLICATE" ), SubTask( id=7279, name="SSL_CONFIG", progress=0, user_op="REPLICATE" ), SubTask( id=7280, name="ATTACH_AGENT_IMAGE", progress=0, user_op="REPLICATE" ), SubTask( id=7281, name="FORMAT_DISK_WINDOWS", progress=0, user_op="REPLICATE" ), SubTask( id=7282, name="MIGRATE_WINDOWS_BLOCK", progress=0, user_op="REPLICATE" ) ] listPhysicalVolumesDisks = [ TargetPhysicalVolumes( id=135055, device_use="BOOT", file_system="NTFS", index=1, name="Z:", size=524288000, used_size=410275840, uuid="\\?\Volume{586b7157-0000-0000-0000-100000000000}\", free_size=114012160 ), TargetPhysicalVolumes( id=135056, device_use="OS", file_system="NTFS", index=2, name="Y:", size=42423287808, used_size=23170301952, uuid="\\?\Volume{586b7157-0000-0000-0000-501f00000000}\", free_size=19252985856 ) ] listDisksTargetServer = [ TargetDisk( id=88008, device_use="OS", disk_id="0", name="Disk 1", physical_volumes=listPhysicalVolumesDisks, size=42949672960, used_size=42947575808, disk_index="0", os_disk=True, partition_style="MBR" ) ] targetServerbody = TargetServer( disks=listDisksTargetServer, vm_id="", id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", os_version="WINDOWS2016_64BIT", system_dir="Y:\Windows\System32", os_type="WINDOWS", name="" ) sourceServerbody = PostSourceServerBody( id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", ip="192.168.0.154", name="name-win16", os_type="WINDOWS", os_version="WINDOWS2016_64BIT", agent_version="1.2.0", migration_cycle="replicating", state="initialize", oem_system=False ) request.body = PutTaskReq( sub_tasks=listSubTasksbody, total_time=115, error_json="", migrate_speed=0.0, start_date=1598435784000, create_date=1598435778000, state="RUNNING", target_server=targetServerbody, source_server=sourceServerbody, vm_template_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001", project_id="xxxxxxxxxxxxxxxxxxxxxxxx00000001", project_name="project name", speed_limit=0, region_name="region name", start_target_server=True, region_id="region id", priority=1, os_type="WINDOWS", type="MIGRATE_BLOCK", name="MigrationTask" ) response = client.update_task(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) |
更新任务ID为ef3b9722-07a0-40ae-89b0-889ee96dxxxx的迁移任务的信息。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 |
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/global" sms "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/sms/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/sms/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/sms/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") auth := global.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := sms.NewSmsClient( sms.SmsClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.UpdateTaskRequest{} request.TaskId = "{task_id}" idSubTasks:= int64(7278) nameSubTasks:= "CREATE_CLOUD_SERVER" startDateSubTasks:= int64(1598435802000) userOpSubTasks:= "REPLICATE" idSubTasks1:= int64(7279) nameSubTasks1:= "SSL_CONFIG" userOpSubTasks1:= "REPLICATE" idSubTasks2:= int64(7280) nameSubTasks2:= "ATTACH_AGENT_IMAGE" userOpSubTasks2:= "REPLICATE" idSubTasks3:= int64(7281) nameSubTasks3:= "FORMAT_DISK_WINDOWS" userOpSubTasks3:= "REPLICATE" idSubTasks4:= int64(7282) nameSubTasks4:= "MIGRATE_WINDOWS_BLOCK" userOpSubTasks4:= "REPLICATE" var listSubTasksbody = []model.SubTask{ { Id: &idSubTasks, Name: &nameSubTasks, Progress: int32(0), StartDate: &startDateSubTasks, UserOp: &userOpSubTasks, }, { Id: &idSubTasks1, Name: &nameSubTasks1, Progress: int32(0), UserOp: &userOpSubTasks1, }, { Id: &idSubTasks2, Name: &nameSubTasks2, Progress: int32(0), UserOp: &userOpSubTasks2, }, { Id: &idSubTasks3, Name: &nameSubTasks3, Progress: int32(0), UserOp: &userOpSubTasks3, }, { Id: &idSubTasks4, Name: &nameSubTasks4, Progress: int32(0), UserOp: &userOpSubTasks4, }, } idPhysicalVolumes:= int64(135055) deviceUsePhysicalVolumes:= model.GetTargetPhysicalVolumesDeviceUseEnum().BOOT fileSystemPhysicalVolumes:= "NTFS" indexPhysicalVolumes:= int32(1) namePhysicalVolumes:= "Z:" sizePhysicalVolumes:= int64(524288000) usedSizePhysicalVolumes:= int64(410275840) uuidPhysicalVolumes:= "\\?\Volume{586b7157-0000-0000-0000-100000000000}\" freeSizePhysicalVolumes:= int64(114012160) idPhysicalVolumes1:= int64(135056) deviceUsePhysicalVolumes1:= model.GetTargetPhysicalVolumesDeviceUseEnum().OS fileSystemPhysicalVolumes1:= "NTFS" indexPhysicalVolumes1:= int32(2) namePhysicalVolumes1:= "Y:" sizePhysicalVolumes1:= int64(42423287808) usedSizePhysicalVolumes1:= int64(23170301952) uuidPhysicalVolumes1:= "\\?\Volume{586b7157-0000-0000-0000-501f00000000}\" freeSizePhysicalVolumes1:= int64(19252985856) var listPhysicalVolumesDisks = []model.TargetPhysicalVolumes{ { Id: &idPhysicalVolumes, DeviceUse: &deviceUsePhysicalVolumes, FileSystem: &fileSystemPhysicalVolumes, Index: &indexPhysicalVolumes, Name: &namePhysicalVolumes, Size: &sizePhysicalVolumes, UsedSize: &usedSizePhysicalVolumes, Uuid: &uuidPhysicalVolumes, FreeSize: &freeSizePhysicalVolumes, }, { Id: &idPhysicalVolumes1, DeviceUse: &deviceUsePhysicalVolumes1, FileSystem: &fileSystemPhysicalVolumes1, Index: &indexPhysicalVolumes1, Name: &namePhysicalVolumes1, Size: &sizePhysicalVolumes1, UsedSize: &usedSizePhysicalVolumes1, Uuid: &uuidPhysicalVolumes1, FreeSize: &freeSizePhysicalVolumes1, }, } idDisks:= int64(88008) deviceUseDisks:= model.GetTargetDiskDeviceUseEnum().OS diskIdDisks:= "0" nameDisks:= "Disk 1" sizeDisks:= int64(42949672960) usedSizeDisks:= int64(42947575808) diskIndexDisks:= "0" osDiskDisks:= true partitionStyleDisks:= model.GetTargetDiskPartitionStyleEnum().MBR var listDisksTargetServer = []model.TargetDisk{ { Id: &idDisks, DeviceUse: &deviceUseDisks, DiskId: &diskIdDisks, Name: &nameDisks, PhysicalVolumes: &listPhysicalVolumesDisks, Size: &sizeDisks, UsedSize: &usedSizeDisks, DiskIndex: &diskIndexDisks, OsDisk: &osDiskDisks, PartitionStyle: &partitionStyleDisks, }, } vmIdTargetServer:= "" idTargetServer:= "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001" osVersionTargetServer:= "WINDOWS2016_64BIT" systemDirTargetServer:= "Y:\Windows\System32" targetServerbody := &model.TargetServer{ Disks: listDisksTargetServer, VmId: &vmIdTargetServer, Id: &idTargetServer, OsVersion: &osVersionTargetServer, SystemDir: &systemDirTargetServer, OsType: model.GetTargetServerOsTypeEnum().WINDOWS, Name: "", } idSourceServer:= "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001" ipSourceServer:= "192.168.0.154" nameSourceServer:= "name-win16" osTypeSourceServer:= model.GetPostSourceServerBodyOsTypeEnum().WINDOWS osVersionSourceServer:= "WINDOWS2016_64BIT" agentVersionSourceServer:= "1.2.0" migrationCycleSourceServer:= model.GetPostSourceServerBodyMigrationCycleEnum().REPLICATING stateSourceServer:= model.GetPostSourceServerBodyStateEnum().INITIALIZE oemSystemSourceServer:= false sourceServerbody := &model.PostSourceServerBody{ Id: &idSourceServer, Ip: &ipSourceServer, Name: &nameSourceServer, OsType: &osTypeSourceServer, OsVersion: &osVersionSourceServer, AgentVersion: &agentVersionSourceServer, MigrationCycle: &migrationCycleSourceServer, State: &stateSourceServer, OemSystem: &oemSystemSourceServer, } totalTimePutTaskReq:= int64(115) errorJsonPutTaskReq:= "" migrateSpeedPutTaskReq:= float64(0.0) startDatePutTaskReq:= int64(1598435784000) createDatePutTaskReq:= int64(1598435778000) statePutTaskReq:= "RUNNING" vmTemplateIdPutTaskReq:= "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001" projectIdPutTaskReq:= "xxxxxxxxxxxxxxxxxxxxxxxx00000001" projectNamePutTaskReq:= "project name" speedLimitPutTaskReq:= int32(0) regionNamePutTaskReq:= "region name" startTargetServerPutTaskReq:= true regionIdPutTaskReq:= "region id" priorityPutTaskReq:= model.GetPutTaskReqPriorityEnum().E_1 osTypePutTaskReq:= model.GetPutTaskReqOsTypeEnum().WINDOWS typePutTaskReq:= model.GetPutTaskReqTypeEnum().MIGRATE_BLOCK namePutTaskReq:= "MigrationTask" request.Body = &model.PutTaskReq{ SubTasks: &listSubTasksbody, TotalTime: &totalTimePutTaskReq, ErrorJson: &errorJsonPutTaskReq, MigrateSpeed: &migrateSpeedPutTaskReq, StartDate: &startDatePutTaskReq, CreateDate: &createDatePutTaskReq, State: &statePutTaskReq, TargetServer: targetServerbody, SourceServer: sourceServerbody, VmTemplateId: &vmTemplateIdPutTaskReq, ProjectId: &projectIdPutTaskReq, ProjectName: &projectNamePutTaskReq, SpeedLimit: &speedLimitPutTaskReq, RegionName: ®ionNamePutTaskReq, StartTargetServer: &startTargetServerPutTaskReq, RegionId: ®ionIdPutTaskReq, Priority: &priorityPutTaskReq, OsType: &osTypePutTaskReq, Type: &typePutTaskReq, Name: &namePutTaskReq, } response, err := client.UpdateTask(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。
状态码
状态码 |
描述 |
---|---|
200 |
更新指定ID的迁移任务 |
403 |
鉴权失败 |
错误码
请参见错误码。