更新磁盘信息
功能介绍
更新服务器的磁盘信息，此接口会把服务器原有磁盘信息清空，然后更新成新磁盘信息。
调用方法
请参见如何调用API。
URI
PUT /v3/sources/{source_id}/diskinfo
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
source_id |
是 |
String |
源端服务器ID 最小长度：0 最大长度：255 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：16384 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
disks |
否 |
Array of ServerDisk objects |
更新的磁盘信息 数组长度：0 - 65535 |
|
volumegroups |
否 |
Array of VolumeGroups objects |
更新的卷信息 数组长度：0 - 65535 |
|
btrfs_list |
否 |
Array of BtrfsFileSystem objects |
更新的btrfs信息 数组长度：0 - 65535 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
磁盘名称 最小长度：0 最大长度：255 |
|
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 |
磁盘上的物理分区信息 数组长度：0 - 65535 |
|
os_disk |
否 |
Boolean |
是否为系统盘 |
|
relation_name |
否 |
String |
Linux系统 目的端ECS中与源端关联的磁盘名称 最小长度：0 最大长度：255 |
|
inode_size |
否 |
Integer |
inode数量 最小值：0 最大值：2147483647 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
device_use |
否 |
String |
分区类型，普通分区，启动分区，系统分区 最小长度：0 最大长度：255 |
|
file_system |
否 |
String |
文件系统类型 最小长度：0 最大长度：255 |
|
index |
否 |
Integer |
顺序 最小值：0 最大值：2147483647 |
|
mount_point |
否 |
String |
挂载点 最小长度：0 最大长度：255 |
|
name |
否 |
String |
名称，windows表示盘符，Linux表示设备号 最小长度：0 最大长度：255 |
|
size |
否 |
Long |
大小 最小值：0 最大值：9223372036854775807 |
|
used_size |
否 |
Long |
使用大小 最小值：0 最大值：9223372036854775807 |
|
inode_size |
否 |
Integer |
inode数量 最小值：0 最大值：2147483647 |
|
inode_nums |
否 |
Long |
inode节点数量 最小值：0 最大值：9223372036854775807 |
|
uuid |
否 |
String |
GUID，可从源端查询 最小长度：0 最大长度：255 |
|
size_per_cluster |
否 |
Integer |
每个cluster大小 最小值：0 最大值：2147483647 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
components |
否 |
String |
Pv信息 最小长度：0 最大长度：255 |
|
free_size |
否 |
Long |
剩余空间 最小值：0 最大值：9223372036854775807 |
|
logical_volumes |
否 |
Array of LogicalVolumes objects |
lv信息 数组长度：0 - 255 |
|
name |
否 |
String |
名称 最小长度：0 最大长度：255 |
|
size |
否 |
Long |
大小 最小值：0 最大值：9223372036854775807 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
block_count |
否 |
Integer |
块数量 最小值：0 最大值：2147483647 缺省值：0 |
|
block_size |
否 |
Long |
块大小 最小值：0 最大值：1048576 缺省值：0 |
|
file_system |
是 |
String |
文件系统 最小长度：0 最大长度：255 |
|
inode_size |
是 |
Integer |
inode数量 最小值：0 最大值：2147483647 |
|
inode_nums |
否 |
Long |
inode节点数量 最小值：0 最大值：9223372036854775807 |
|
device_use |
否 |
String |
分区类型，普通分区，启动分区，系统分区 最小长度：0 最大长度：255 |
|
mount_point |
是 |
String |
挂载点 最小长度：0 最大长度：256 |
|
name |
是 |
String |
名称 最小长度：0 最大长度：1024 |
|
size |
是 |
Long |
大小 最小值：0 最大值：9223372036854775807 |
|
used_size |
是 |
Long |
使用大小 最小值：0 最大值：9223372036854775807 |
|
free_size |
是 |
Long |
剩余空间 最小值：0 最大值：9223372036854775807 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
文件系统名称 最小长度：0 最大长度：255 |
|
label |
是 |
String |
文件系统标签，若无标签为空字符串 最小长度：0 最大长度：255 |
|
uuid |
是 |
String |
文件系统的uuid 最小长度：0 最大长度：255 |
|
device |
是 |
String |
btrfs包含的设备名称 最小长度：0 最大长度：255 |
|
size |
是 |
Long |
文件系统数据占用大小 最小值：0 最大值：9223372036854775807 |
|
nodesize |
是 |
Long |
btrfs节点大小 最小值：0 最大值：9223372036854775807 |
|
sectorsize |
是 |
Integer |
扇区大小 最小值：0 最大值：2147483647 |
|
data_profile |
是 |
String |
数据配置（RAD） 最小长度：0 最大长度：255 |
|
system_profile |
是 |
String |
文件系统配置（RAD） 最小长度：0 最大长度：255 |
|
metadata_profile |
是 |
String |
元数据配置（RAD） 最小长度：0 最大长度：255 |
|
global_reserve1 |
是 |
String |
Btrfs文件系统信息 最小长度：0 最大长度：255 |
|
g_vol_used_size |
是 |
Long |
Btrfs卷已使用空间大小 最小值：0 最大值：9223372036854775807 |
|
default_subvolid |
是 |
String |
默认子卷ID 最小长度：0 最大长度：255 |
|
default_subvol_name |
是 |
String |
默认子卷名称 最小长度：0 最大长度：255 |
|
default_subvol_mountpath |
是 |
String |
默认子卷挂载路径/BTRFS文件系统的挂载路径 最小长度：0 最大长度：255 |
|
subvolumn |
是 |
Array of BtrfsSubvolumn objects |
子卷信息 数组长度：0 - 65535 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
更新磁盘信息成功 |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误代码 最小长度：0 最大长度：255 |
|
error_msg |
String |
错误信息 最小长度：0 最大长度：255 |
|
encoded_authorization_message |
String |
加密授权信息 最小长度：0 最大长度：65535 |
|
error_param |
Array of strings |
错误参数 最小长度：0 最大长度：65535 数组长度：1 - 20 |
|
details |
Array of details objects |
详细错误信息 数组长度：1 - 20 |
请求示例
更新服务器的磁盘信息，此接口会把服务器原有磁盘信息清空，然后更新成新磁盘信息，新的磁盘名称是/dev/vda，磁盘类型是BOOT，磁盘大小是42949672960字节。
PUT https://{endpoint}/v3/sources/{source_id}/diskinfo
{
"disks" : [ {
"name" : "/dev/vda",
"device_use" : "BOOT",
"size" : 42949672960,
"partition_style" : "MBR",
"used_size" : 42948624384,
"physical_volumes" : [ {
"name" : "/dev/vda1",
"size" : 2153775104,
"device_use" : "NORMAL",
"used_size" : 2153775104,
"inode_size" : 0,
"file_system" : "swap",
"mount_point" : ""
}, {
"name" : "/dev/vda2",
"size" : 16862150656,
"device_use" : "BTRFS",
"used_size" : 16862150656,
"inode_size" : 0,
"file_system" : "btrfs",
"mount_point" : ""
}, {
"name" : "/dev/vda3",
"size" : 23932698624,
"device_use" : "NORMAL",
"used_size" : 33988608,
"inode_size" : 0,
"file_system" : "xfs",
"mount_point" : "/home"
} ]
}, {
"name" : "/dev/vdb",
"device_use" : "NORMAL",
"size" : 21474836480,
"partition_style" : "MBR",
"used_size" : 21473787904,
"physical_volumes" : [ {
"name" : "/dev/vdb1",
"size" : 21473787904,
"device_use" : "VOLUME_GROUP",
"used_size" : 21473787904,
"inode_size" : 0,
"file_system" : "LVM2_member",
"mount_point" : ""
} ]
}, {
"name" : "/dev/vdc",
"device_use" : "VOLUME_GROUP",
"size" : 21474836480,
"partition_style" : "MBR",
"used_size" : 0,
"physical_volumes" : [ ]
} ],
"volumegroups" : [ {
"name" : "vg1",
"size" : 42948624384,
"components" : "/dev/vdb1;/dev/vdc",
"logical_volumes" : [ {
"name" : "/dev/mapper/vg1-lv1",
"device_use" : "NORMAL",
"size" : 10737418240,
"free_size" : 10713837568,
"used_size" : 23580672,
"file_system" : "ext4",
"mount_point" : "/mnt/lv1",
"inode_size" : 256
} ]
} ],
"btrfs_list" : [ {
"name" : "/dev/vda2",
"label" : "none",
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"device" : "/dev/vda2",
"size" : "3.30GiB",
"nodesize" : 16384,
"sectorsize" : 4096,
"data_profile" : "single",
"system_profile" : "single",
"metadata_profile" : "single",
"global_reserve1" : "single",
"g_vol_used_size" : 3894038528,
"default_subvolid" : 259,
"default_subvol_name" : "@/.snapshots/1/snapshot",
"default_subvol_mountpath" : "/",
"subvolumn" : [ {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 257,
"parent_id" : 5,
"subvol_name" : "@",
"subvol_mount_path" : null
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 258,
"parent_id" : 257,
"subvol_name" : "@/.snapshots",
"subvol_mount_path" : "/.snapshots"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : true,
"subvol_id" : 259,
"parent_id" : 258,
"subvol_name" : "@/.snapshots/1/snapshot",
"subvol_mount_path" : "/"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 260,
"parent_id" : 257,
"subvol_name" : "@/boot/grub2/i386-pc",
"subvol_mount_path" : "/boot/grub2/i386-pc"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 261,
"parent_id" : 257,
"subvol_name" : "@/boot/grub2/x86_64-efi",
"subvol_mount_path" : "/boot/grub2/x86_64-efi"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 262,
"parent_id" : 257,
"subvol_name" : "@/opt",
"subvol_mount_path" : "/opt"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 263,
"parent_id" : 257,
"subvol_name" : "@/srv",
"subvol_mount_path" : "/srv"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 264,
"parent_id" : 257,
"subvol_name" : "@/tmp",
"subvol_mount_path" : "/tmp"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 265,
"parent_id" : 257,
"subvol_name" : "@/usr/local",
"subvol_mount_path" : "/usr/local"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 266,
"parent_id" : 257,
"subvol_name" : "@/var/cache",
"subvol_mount_path" : "/var/cache"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 267,
"parent_id" : 257,
"subvol_name" : "@/var/crash",
"subvol_mount_path" : "/var/crash"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 268,
"parent_id" : 257,
"subvol_name" : "@/var/lib/libvirt/images",
"subvol_mount_path" : "/var/lib/libvirt/images"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 269,
"parent_id" : 257,
"subvol_name" : "@/var/lib/machines",
"subvol_mount_path" : "/var/lib/machines"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 270,
"parent_id" : 257,
"subvol_name" : "@/var/lib/mailman",
"subvol_mount_path" : "/var/lib/mailman"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 271,
"parent_id" : 257,
"subvol_name" : "@/var/lib/mariadb",
"subvol_mount_path" : "/var/lib/mariadb"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 272,
"parent_id" : 257,
"subvol_name" : "@/var/lib/mysql",
"subvol_mount_path" : "/var/lib/mysql"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 273,
"parent_id" : 257,
"subvol_name" : "@/var/lib/named",
"subvol_mount_path" : "/var/lib/named"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 274,
"parent_id" : 257,
"subvol_name" : "@/var/lib/pgsql",
"subvol_mount_path" : "/var/lib/pgsql"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 275,
"parent_id" : 257,
"subvol_name" : "@/var/log",
"subvol_mount_path" : "/var/log"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 276,
"parent_id" : 257,
"subvol_name" : "@/var/opt",
"subvol_mount_path" : "/var/opt"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 277,
"parent_id" : 257,
"subvol_name" : "@/var/spool",
"subvol_mount_path" : "/var/spool"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : false,
"subvol_id" : 278,
"parent_id" : 257,
"subvol_name" : "@/var/tmp",
"subvol_mount_path" : "/var/tmp"
}, {
"uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"is_snapshot" : true,
"subvol_id" : 282,
"parent_id" : 258,
"subvol_name" : "@/.snapshots/2/snapshot",
"subvol_mount_path" : null
} ]
} ]
}响应示例
状态码：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."
} ]
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
更新磁盘信息成功 |
|
403 |
鉴权失败 |
错误码
请参见错误码。
