Updated on 2026-01-28 GMT+08:00

Updating Disk Information

Function

This API is used to overwrite the original disk information of a server with the new disk information.

This API takes effect only when the source server is in the waiting state. After the migration starts, the modification on the disk information does not take effect.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    sms:server:updateDiskInfo

    Write

    server *

    -

    sms:server:registerServer

    -

    -

    g:EnterpriseProjectId

URI

PUT /v3/sources/{source_id}/diskinfo

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

source_id

Yes

String

The source server ID.

Minimum: 1

Maximum: 36

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

The token can be obtained by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token.

Minimum: 1

Maximum: 16384

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

disks

No

Array of ServerDisk objects

The updated disk information.

Array Length: 0 - 50

volumegroups

No

Array of VolumeGroups objects

The updated volume information.

Array Length: 0 - 50

btrfs_list

No

Array of BtrfsFileSystem objects

The updated Btrfs file system information.

Array Length: 0 - 65535

Table 4 ServerDisk

Parameter

Mandatory

Type

Description

name

No

String

The disk name.

Minimum: 0

Maximum: 255

partition_style

No

String

Disk partition type. This parameter is mandatory when the source server is added. Otherwise, the subsequent environment check will fail.

Options (required by EVS):

MBR: Master Boot Record

GPT: GUID Partition Table**

Partition Table

For details, see the description of differences between MBR and GPT in the EVS API document.

Minimum: 0

Maximum: 255

device_use

No

String

Disk type.

This is not mandatory and can be left blank. The common values are as follows:

NORMAL

OS: system device

BOOT

VOLUME_GROUP

BTRFS

Minimum: 0

Maximum: 255

size

No

Long

The disk size, in bytes.

Minimum: 0

Maximum: 9223372036854775807

used_size

No

Long

The used disk space, in bytes.

Minimum: 0

Maximum: 9223372036854775807

physical_volumes

No

Array of PhysicalVolume objects

The information about physical partitions on the disk.

Array Length: 0 - 50

os_disk

No

Boolean

Indicates whether the disk is the system disk.

relation_name

No

String

The name of the paired disk on the Linux target ECS server.

Minimum: 0

Maximum: 255

inode_size

No

Integer

The inode size.

Minimum: 0

Maximum: 2147483647

Table 5 PhysicalVolume

Parameter

Mandatory

Type

Description

device_use

No

String

Disk type.

This is not mandatory and can be left blank. The common values are as follows:

NORMAL

OS: system device

BOOT

VOLUME_GROUP

BTRFS

Minimum: 0

Maximum: 255

file_system

No

String

The file system type.

Minimum: 0

Maximum: 255

index

No

Integer

The serial number.

Minimum: 0

Maximum: 2147483647

mount_point

No

String

The mount point.

Minimum: 0

Maximum: 255

name

No

String

The volume name. In Windows, it indicates the drive letter, and in Linux, it indicates the device ID.

Minimum: 0

Maximum: 255

size

No

Long

The size.

Minimum: 0

Maximum: 9223372036854775807

used_size

No

Long

The used space.

Minimum: 0

Maximum: 9223372036854775807

inode_size

No

Integer

The number of inodes.

Minimum: 0

Maximum: 2147483647

inode_nums

No

Long

The number of inodes.

Minimum: 0

Maximum: 9223372036854775807

uuid

No

String

The GUID, which can be obtained from the source server.

Minimum: 0

Maximum: 255

size_per_cluster

No

Integer

The size of each cluster.

Minimum: 0

Maximum: 2147483647

Table 6 VolumeGroups

Parameter

Mandatory

Type

Description

components

No

String

The physical volume information.

Minimum: 0

Maximum: 255

free_size

No

Long

The available space.

Minimum: 0

Maximum: 9223372036854775807

logical_volumes

No

Array of LogicalVolumes objects

The logical volume information.

Array Length: 0 - 50

name

No

String

Name.

Minimum: 0

Maximum: 255

size

No

Long

Size.

Minimum: 0

Maximum: 9223372036854775807

Table 7 LogicalVolumes

Parameter

Mandatory

Type

Description

block_count

No

Integer

The number of blocks.

Minimum: 0

Maximum: 2147483647

Default: 0

block_size

No

Long

Block size.

Minimum: 0

Maximum: 1048576

Default: 0

file_system

No

String

The file system.

Minimum: 0

Maximum: 255

inode_size

No

Integer

The number of inodes.

Minimum: 0

Maximum: 2147483647

inode_nums

No

Long

The number of inodes.

Minimum: 0

Maximum: 9223372036854775807

device_use

No

String

Partition type.

This is not mandatory and can be left blank. The common values are as follows:

NORMAL

OS: system device

BOOT

VOLUME_GROUP

BTRFS

Minimum: 0

Maximum: 255

mount_point

No

String

The mount point.

Minimum: 0

Maximum: 256

name

No

String

Name.

Minimum: 0

Maximum: 1024

size

No

Long

The size.

Minimum: 0

Maximum: 9223372036854775807

used_size

No

Long

The used space.

Minimum: 0

Maximum: 9223372036854775807

free_size

No

Long

The available space.

Minimum: 0

Maximum: 9223372036854775807

Table 8 BtrfsFileSystem

Parameter

Mandatory

Type

Description

name

No

String

The file system name.

Minimum: 0

Maximum: 255

label

No

String

The file system tags. If no tag exists, the value is an empty string.

Minimum: 0

Maximum: 255

uuid

No

String

The file system UUID.

Minimum: 0

Maximum: 255

device

No

String

The device names of the Btrfs file system.

Minimum: 0

Maximum: 255

size

No

Long

The space occupied by the file system data.

Minimum: 0

Maximum: 9223372036854775807

nodesize

No

Long

The Btrfs node size.

Minimum: 0

Maximum: 9223372036854775807

sectorsize

No

Integer

The sector size.

Minimum: 0

Maximum: 2147483647

data_profile

No

String

The data profile (RAD).

Minimum: 0

Maximum: 255

system_profile

No

String

The file system profile (RAD).

Minimum: 0

Maximum: 255

metadata_profile

No

String

The metadata profile (RAD).

Minimum: 0

Maximum: 255

global_reserve1

No

String

The Btrfs file system information.

Minimum: 0

Maximum: 255

g_vol_used_size

No

Long

The used space of the Btrfs volume.

Minimum: 0

Maximum: 9223372036854775807

default_subvolid

No

String

The ID of the default subvolume.

Minimum: 0

Maximum: 255

default_subvol_name

No

String

The name of the default subvolume.

Minimum: 0

Maximum: 255

default_subvol_mountpath

No

String

The mount path of the default subvolume or Btrfs file system.

Minimum: 0

Maximum: 255

subvolumn

No

Array of BtrfsSubvolumn objects

The subvolume information.

Array Length: 0 - 65535

Table 9 BtrfsSubvolumn

Parameter

Mandatory

Type

Description

uuid

No

String

The UUID of the parent volume.

Minimum: 0

Maximum: 255

is_snapshot

No

String

Indicates whether the subvolume is a snapshot.

Minimum: 0

Maximum: 255

subvol_id

No

String

The subvolume ID.

Minimum: 0

Maximum: 255

parent_id

No

String

The parent volume ID.

Minimum: 0

Maximum: 255

subvol_name

No

String

The subvolume name.

Minimum: 0

Maximum: 255

subvol_mount_path

No

String

The mount path of the subvolume.

Minimum: 0

Maximum: 255

Response Parameters

Status code: 200

Table 10 Response body parameters

Parameter

Type

Description

-

String

The disk information was updated.

Status code: 403

Table 11 Response body parameters

Parameter

Type

Description

error_code

String

The error code.

Minimum: 0

Maximum: 255

error_msg

String

The error message.

Minimum: 0

Maximum: 255

encoded_authorization_message

String

The encrypted authorization information.

Minimum: 0

Maximum: 65535

error_param

Array of strings

Error parameters.

Minimum: 0

Maximum: 65535

Array Length: 1 - 20

details

Array of details objects

The error details.

Array Length: 1 - 20

Table 12 details

Parameter

Type

Description

error_code

String

The SMS error code.

Minimum: 0

Maximum: 65535

error_msg

String

The SMS error message.

Minimum: 0

Maximum: 65535

Example Requests

This example updates the disk information of a server. The new disk name is /dev/vda, the disk function is BOOT, and the disk size is 42,949,672,960 bytes.

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
    } ]
  } ]
}

Example Responses

Status code: 200

The disk information was updated.

{ }

Status code: 403

Authentication failed.

{
  "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 Sample Code

The SDK sample code is as follows.

This example updates the disk information of a server. The new disk name is /dev/vda, the disk function is BOOT, and the disk size is 42,949,672,960 bytes.

  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
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
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 UpdateDiskInfoSolution {

    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();
        UpdateDiskInfoRequest request = new UpdateDiskInfoRequest();
        request.withSourceId("{source_id}");
        PutDiskInfoReq body = new PutDiskInfoReq();
        List<BtrfsSubvolumn> listBtrfsListSubvolumn = new ArrayList<>();
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("257")
                .withParentId("5")
                .withSubvolName("@")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("258")
                .withParentId("257")
                .withSubvolName("@/.snapshots")
                .withSubvolMountPath("/.snapshots")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("true")
                .withSubvolId("259")
                .withParentId("258")
                .withSubvolName("@/.snapshots/1/snapshot")
                .withSubvolMountPath("/")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("260")
                .withParentId("257")
                .withSubvolName("@/boot/grub2/i386-pc")
                .withSubvolMountPath("/boot/grub2/i386-pc")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("261")
                .withParentId("257")
                .withSubvolName("@/boot/grub2/x86_64-efi")
                .withSubvolMountPath("/boot/grub2/x86_64-efi")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("262")
                .withParentId("257")
                .withSubvolName("@/opt")
                .withSubvolMountPath("/opt")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("263")
                .withParentId("257")
                .withSubvolName("@/srv")
                .withSubvolMountPath("/srv")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("264")
                .withParentId("257")
                .withSubvolName("@/tmp")
                .withSubvolMountPath("/tmp")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("265")
                .withParentId("257")
                .withSubvolName("@/usr/local")
                .withSubvolMountPath("/usr/local")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("266")
                .withParentId("257")
                .withSubvolName("@/var/cache")
                .withSubvolMountPath("/var/cache")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("267")
                .withParentId("257")
                .withSubvolName("@/var/crash")
                .withSubvolMountPath("/var/crash")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("268")
                .withParentId("257")
                .withSubvolName("@/var/lib/libvirt/images")
                .withSubvolMountPath("/var/lib/libvirt/images")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("269")
                .withParentId("257")
                .withSubvolName("@/var/lib/machines")
                .withSubvolMountPath("/var/lib/machines")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("270")
                .withParentId("257")
                .withSubvolName("@/var/lib/mailman")
                .withSubvolMountPath("/var/lib/mailman")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("271")
                .withParentId("257")
                .withSubvolName("@/var/lib/mariadb")
                .withSubvolMountPath("/var/lib/mariadb")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("272")
                .withParentId("257")
                .withSubvolName("@/var/lib/mysql")
                .withSubvolMountPath("/var/lib/mysql")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("273")
                .withParentId("257")
                .withSubvolName("@/var/lib/named")
                .withSubvolMountPath("/var/lib/named")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("274")
                .withParentId("257")
                .withSubvolName("@/var/lib/pgsql")
                .withSubvolMountPath("/var/lib/pgsql")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("275")
                .withParentId("257")
                .withSubvolName("@/var/log")
                .withSubvolMountPath("/var/log")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("276")
                .withParentId("257")
                .withSubvolName("@/var/opt")
                .withSubvolMountPath("/var/opt")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("277")
                .withParentId("257")
                .withSubvolName("@/var/spool")
                .withSubvolMountPath("/var/spool")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("false")
                .withSubvolId("278")
                .withParentId("257")
                .withSubvolName("@/var/tmp")
                .withSubvolMountPath("/var/tmp")
        );
        listBtrfsListSubvolumn.add(
            new BtrfsSubvolumn()
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withIsSnapshot("true")
                .withSubvolId("282")
                .withParentId("258")
                .withSubvolName("@/.snapshots/2/snapshot")
        );
        List<BtrfsFileSystem> listbodyBtrfsList = new ArrayList<>();
        listbodyBtrfsList.add(
            new BtrfsFileSystem()
                .withName("/dev/vda2")
                .withLabel("none")
                .withUuid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001")
                .withDevice("/dev/vda2")
                .withSize(3.30GiBL)
                .withNodesize(16384L)
                .withSectorsize(4096)
                .withDataProfile("single")
                .withSystemProfile("single")
                .withMetadataProfile("single")
                .withGlobalReserve1("single")
                .withGVolUsedSize(3894038528L)
                .withDefaultSubvolid("259")
                .withDefaultSubvolName("@/.snapshots/1/snapshot")
                .withDefaultSubvolMountpath("/")
                .withSubvolumn(listBtrfsListSubvolumn)
        );
        List<LogicalVolumes> listVolumegroupsLogicalVolumes = new ArrayList<>();
        listVolumegroupsLogicalVolumes.add(
            new LogicalVolumes()
                .withFileSystem("ext4")
                .withInodeSize(256)
                .withDeviceUse("NORMAL")
                .withMountPoint("/mnt/lv1")
                .withName("/dev/mapper/vg1-lv1")
                .withSize(10737418240L)
                .withUsedSize(23580672L)
                .withFreeSize(10713837568L)
        );
        List<VolumeGroups> listbodyVolumegroups = new ArrayList<>();
        listbodyVolumegroups.add(
            new VolumeGroups()
                .withComponents("/dev/vdb1;/dev/vdc")
                .withLogicalVolumes(listVolumegroupsLogicalVolumes)
                .withName("vg1")
                .withSize(42948624384L)
        );
        List<PhysicalVolume> listDisksPhysicalVolumes = new ArrayList<>();
        listDisksPhysicalVolumes.add(
            new PhysicalVolume()
                .withDeviceUse("VOLUME_GROUP")
                .withFileSystem("LVM2_member")
                .withMountPoint("")
                .withName("/dev/vdb1")
                .withSize(21473787904L)
                .withUsedSize(21473787904L)
                .withInodeSize(0)
        );
        List<PhysicalVolume> listDisksPhysicalVolumes1 = new ArrayList<>();
        listDisksPhysicalVolumes1.add(
            new PhysicalVolume()
                .withDeviceUse("NORMAL")
                .withFileSystem("swap")
                .withMountPoint("")
                .withName("/dev/vda1")
                .withSize(2153775104L)
                .withUsedSize(2153775104L)
                .withInodeSize(0)
        );
        listDisksPhysicalVolumes1.add(
            new PhysicalVolume()
                .withDeviceUse("BTRFS")
                .withFileSystem("btrfs")
                .withMountPoint("")
                .withName("/dev/vda2")
                .withSize(16862150656L)
                .withUsedSize(16862150656L)
                .withInodeSize(0)
        );
        listDisksPhysicalVolumes1.add(
            new PhysicalVolume()
                .withDeviceUse("NORMAL")
                .withFileSystem("xfs")
                .withMountPoint("/home")
                .withName("/dev/vda3")
                .withSize(23932698624L)
                .withUsedSize(33988608L)
                .withInodeSize(0)
        );
        List<ServerDisk> listbodyDisks = new ArrayList<>();
        listbodyDisks.add(
            new ServerDisk()
                .withName("/dev/vda")
                .withPartitionStyle(ServerDisk.PartitionStyleEnum.fromValue("MBR"))
                .withDeviceUse(ServerDisk.DeviceUseEnum.fromValue("BOOT"))
                .withSize(42949672960L)
                .withUsedSize(42948624384L)
                .withPhysicalVolumes(listDisksPhysicalVolumes1)
        );
        listbodyDisks.add(
            new ServerDisk()
                .withName("/dev/vdb")
                .withPartitionStyle(ServerDisk.PartitionStyleEnum.fromValue("MBR"))
                .withDeviceUse(ServerDisk.DeviceUseEnum.fromValue("NORMAL"))
                .withSize(21474836480L)
                .withUsedSize(21473787904L)
                .withPhysicalVolumes(listDisksPhysicalVolumes)
        );
        listbodyDisks.add(
            new ServerDisk()
                .withName("/dev/vdc")
                .withPartitionStyle(ServerDisk.PartitionStyleEnum.fromValue("MBR"))
                .withDeviceUse(ServerDisk.DeviceUseEnum.fromValue("VOLUME_GROUP"))
                .withSize(21474836480L)
                .withUsedSize(0L)
                .withPhysicalVolumes()
        );
        body.withBtrfsList(listbodyBtrfsList);
        body.withVolumegroups(listbodyVolumegroups);
        body.withDisks(listbodyDisks);
        request.withBody(body);
        try {
            UpdateDiskInfoResponse response = client.updateDiskInfo(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());
        }
    }
}

This example updates the disk information of a server. The new disk name is /dev/vda, the disk function is BOOT, and the disk size is 42,949,672,960 bytes.

  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
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
# 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 = UpdateDiskInfoRequest()
        request.source_id = "{source_id}"
        listSubvolumnBtrfsList = [
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="257",
                parent_id="5",
                subvol_name="@"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="258",
                parent_id="257",
                subvol_name="@/.snapshots",
                subvol_mount_path="/.snapshots"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="true",
                subvol_id="259",
                parent_id="258",
                subvol_name="@/.snapshots/1/snapshot",
                subvol_mount_path="/"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="262",
                parent_id="257",
                subvol_name="@/opt",
                subvol_mount_path="/opt"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="263",
                parent_id="257",
                subvol_name="@/srv",
                subvol_mount_path="/srv"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="264",
                parent_id="257",
                subvol_name="@/tmp",
                subvol_mount_path="/tmp"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="265",
                parent_id="257",
                subvol_name="@/usr/local",
                subvol_mount_path="/usr/local"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="266",
                parent_id="257",
                subvol_name="@/var/cache",
                subvol_mount_path="/var/cache"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="267",
                parent_id="257",
                subvol_name="@/var/crash",
                subvol_mount_path="/var/crash"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                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"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="275",
                parent_id="257",
                subvol_name="@/var/log",
                subvol_mount_path="/var/log"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="276",
                parent_id="257",
                subvol_name="@/var/opt",
                subvol_mount_path="/var/opt"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="277",
                parent_id="257",
                subvol_name="@/var/spool",
                subvol_mount_path="/var/spool"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="false",
                subvol_id="278",
                parent_id="257",
                subvol_name="@/var/tmp",
                subvol_mount_path="/var/tmp"
            ),
            BtrfsSubvolumn(
                uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
                is_snapshot="true",
                subvol_id="282",
                parent_id="258",
                subvol_name="@/.snapshots/2/snapshot"
            )
        ]
        listBtrfsListbody = [
            BtrfsFileSystem(
                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=listSubvolumnBtrfsList
            )
        ]
        listLogicalVolumesVolumegroups = [
            LogicalVolumes(
                file_system="ext4",
                inode_size=256,
                device_use="NORMAL",
                mount_point="/mnt/lv1",
                name="/dev/mapper/vg1-lv1",
                size=10737418240,
                used_size=23580672,
                free_size=10713837568
            )
        ]
        listVolumegroupsbody = [
            VolumeGroups(
                components="/dev/vdb1;/dev/vdc",
                logical_volumes=listLogicalVolumesVolumegroups,
                name="vg1",
                size=42948624384
            )
        ]
        listPhysicalVolumesDisks = [
            PhysicalVolume(
                device_use="VOLUME_GROUP",
                file_system="LVM2_member",
                mount_point="",
                name="/dev/vdb1",
                size=21473787904,
                used_size=21473787904,
                inode_size=0
            )
        ]
        listPhysicalVolumesDisks1 = [
            PhysicalVolume(
                device_use="NORMAL",
                file_system="swap",
                mount_point="",
                name="/dev/vda1",
                size=2153775104,
                used_size=2153775104,
                inode_size=0
            ),
            PhysicalVolume(
                device_use="BTRFS",
                file_system="btrfs",
                mount_point="",
                name="/dev/vda2",
                size=16862150656,
                used_size=16862150656,
                inode_size=0
            ),
            PhysicalVolume(
                device_use="NORMAL",
                file_system="xfs",
                mount_point="/home",
                name="/dev/vda3",
                size=23932698624,
                used_size=33988608,
                inode_size=0
            )
        ]
        listDisksbody = [
            ServerDisk(
                name="/dev/vda",
                partition_style="MBR",
                device_use="BOOT",
                size=42949672960,
                used_size=42948624384,
                physical_volumes=listPhysicalVolumesDisks1
            ),
            ServerDisk(
                name="/dev/vdb",
                partition_style="MBR",
                device_use="NORMAL",
                size=21474836480,
                used_size=21473787904,
                physical_volumes=listPhysicalVolumesDisks
            ),
            ServerDisk(
                name="/dev/vdc",
                partition_style="MBR",
                device_use="VOLUME_GROUP",
                size=21474836480,
                used_size=0,
            )
        ]
        request.body = PutDiskInfoReq(
            btrfs_list=listBtrfsListbody,
            volumegroups=listVolumegroupsbody,
            disks=listDisksbody
        )
        response = client.update_disk_info(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

This example updates the disk information of a server. The new disk name is /dev/vda, the disk function is BOOT, and the disk size is 42,949,672,960 bytes.

  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
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
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.UpdateDiskInfoRequest{}
	request.SourceId = "{source_id}"
	var listSubvolumnBtrfsList = []model.BtrfsSubvolumn{
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "257",
            ParentId: "5",
            SubvolName: "@",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "258",
            ParentId: "257",
            SubvolName: "@/.snapshots",
            SubvolMountPath: "/.snapshots",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "true",
            SubvolId: "259",
            ParentId: "258",
            SubvolName: "@/.snapshots/1/snapshot",
            SubvolMountPath: "/",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "260",
            ParentId: "257",
            SubvolName: "@/boot/grub2/i386-pc",
            SubvolMountPath: "/boot/grub2/i386-pc",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "261",
            ParentId: "257",
            SubvolName: "@/boot/grub2/x86_64-efi",
            SubvolMountPath: "/boot/grub2/x86_64-efi",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "262",
            ParentId: "257",
            SubvolName: "@/opt",
            SubvolMountPath: "/opt",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "263",
            ParentId: "257",
            SubvolName: "@/srv",
            SubvolMountPath: "/srv",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "264",
            ParentId: "257",
            SubvolName: "@/tmp",
            SubvolMountPath: "/tmp",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "265",
            ParentId: "257",
            SubvolName: "@/usr/local",
            SubvolMountPath: "/usr/local",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "266",
            ParentId: "257",
            SubvolName: "@/var/cache",
            SubvolMountPath: "/var/cache",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "267",
            ParentId: "257",
            SubvolName: "@/var/crash",
            SubvolMountPath: "/var/crash",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "268",
            ParentId: "257",
            SubvolName: "@/var/lib/libvirt/images",
            SubvolMountPath: "/var/lib/libvirt/images",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "269",
            ParentId: "257",
            SubvolName: "@/var/lib/machines",
            SubvolMountPath: "/var/lib/machines",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "270",
            ParentId: "257",
            SubvolName: "@/var/lib/mailman",
            SubvolMountPath: "/var/lib/mailman",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "271",
            ParentId: "257",
            SubvolName: "@/var/lib/mariadb",
            SubvolMountPath: "/var/lib/mariadb",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "272",
            ParentId: "257",
            SubvolName: "@/var/lib/mysql",
            SubvolMountPath: "/var/lib/mysql",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "273",
            ParentId: "257",
            SubvolName: "@/var/lib/named",
            SubvolMountPath: "/var/lib/named",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "274",
            ParentId: "257",
            SubvolName: "@/var/lib/pgsql",
            SubvolMountPath: "/var/lib/pgsql",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "275",
            ParentId: "257",
            SubvolName: "@/var/log",
            SubvolMountPath: "/var/log",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "276",
            ParentId: "257",
            SubvolName: "@/var/opt",
            SubvolMountPath: "/var/opt",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "277",
            ParentId: "257",
            SubvolName: "@/var/spool",
            SubvolMountPath: "/var/spool",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "false",
            SubvolId: "278",
            ParentId: "257",
            SubvolName: "@/var/tmp",
            SubvolMountPath: "/var/tmp",
        },
        {
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            IsSnapshot: "true",
            SubvolId: "282",
            ParentId: "258",
            SubvolName: "@/.snapshots/2/snapshot",
        },
    }
	var listBtrfsListbody = []model.BtrfsFileSystem{
        {
            Name: "/dev/vda2",
            Label: "none",
            Uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
            Device: "/dev/vda2",
            Size: int64(3.30GiB),
            Nodesize: int64(16384),
            Sectorsize: int32(4096),
            DataProfile: "single",
            SystemProfile: "single",
            MetadataProfile: "single",
            GlobalReserve1: "single",
            GVolUsedSize: int64(3894038528),
            DefaultSubvolid: "259",
            DefaultSubvolName: "@/.snapshots/1/snapshot",
            DefaultSubvolMountpath: "/",
            Subvolumn: listSubvolumnBtrfsList,
        },
    }
	deviceUseLogicalVolumes:= "NORMAL"
	var listLogicalVolumesVolumegroups = []model.LogicalVolumes{
        {
            FileSystem: "ext4",
            InodeSize: int32(256),
            DeviceUse: &deviceUseLogicalVolumes,
            MountPoint: "/mnt/lv1",
            Name: "/dev/mapper/vg1-lv1",
            Size: int64(10737418240),
            UsedSize: int64(23580672),
            FreeSize: int64(10713837568),
        },
    }
	componentsVolumegroups:= "/dev/vdb1;/dev/vdc"
	nameVolumegroups:= "vg1"
	sizeVolumegroups:= int64(42948624384)
	var listVolumegroupsbody = []model.VolumeGroups{
        {
            Components: &componentsVolumegroups,
            LogicalVolumes: &listLogicalVolumesVolumegroups,
            Name: &nameVolumegroups,
            Size: &sizeVolumegroups,
        },
    }
	deviceUsePhysicalVolumes:= "VOLUME_GROUP"
	fileSystemPhysicalVolumes:= "LVM2_member"
	mountPointPhysicalVolumes:= ""
	namePhysicalVolumes:= "/dev/vdb1"
	sizePhysicalVolumes:= int64(21473787904)
	usedSizePhysicalVolumes:= int64(21473787904)
	inodeSizePhysicalVolumes:= int32(0)
	var listPhysicalVolumesDisks = []model.PhysicalVolume{
        {
            DeviceUse: &deviceUsePhysicalVolumes,
            FileSystem: &fileSystemPhysicalVolumes,
            MountPoint: &mountPointPhysicalVolumes,
            Name: &namePhysicalVolumes,
            Size: &sizePhysicalVolumes,
            UsedSize: &usedSizePhysicalVolumes,
            InodeSize: &inodeSizePhysicalVolumes,
        },
    }
	deviceUsePhysicalVolumes1:= "NORMAL"
	fileSystemPhysicalVolumes1:= "swap"
	mountPointPhysicalVolumes1:= ""
	namePhysicalVolumes1:= "/dev/vda1"
	sizePhysicalVolumes1:= int64(2153775104)
	usedSizePhysicalVolumes1:= int64(2153775104)
	inodeSizePhysicalVolumes1:= int32(0)
	deviceUsePhysicalVolumes2:= "BTRFS"
	fileSystemPhysicalVolumes2:= "btrfs"
	mountPointPhysicalVolumes2:= ""
	namePhysicalVolumes2:= "/dev/vda2"
	sizePhysicalVolumes2:= int64(16862150656)
	usedSizePhysicalVolumes2:= int64(16862150656)
	inodeSizePhysicalVolumes2:= int32(0)
	deviceUsePhysicalVolumes3:= "NORMAL"
	fileSystemPhysicalVolumes3:= "xfs"
	mountPointPhysicalVolumes3:= "/home"
	namePhysicalVolumes3:= "/dev/vda3"
	sizePhysicalVolumes3:= int64(23932698624)
	usedSizePhysicalVolumes3:= int64(33988608)
	inodeSizePhysicalVolumes3:= int32(0)
	var listPhysicalVolumesDisks1 = []model.PhysicalVolume{
        {
            DeviceUse: &deviceUsePhysicalVolumes1,
            FileSystem: &fileSystemPhysicalVolumes1,
            MountPoint: &mountPointPhysicalVolumes1,
            Name: &namePhysicalVolumes1,
            Size: &sizePhysicalVolumes1,
            UsedSize: &usedSizePhysicalVolumes1,
            InodeSize: &inodeSizePhysicalVolumes1,
        },
        {
            DeviceUse: &deviceUsePhysicalVolumes2,
            FileSystem: &fileSystemPhysicalVolumes2,
            MountPoint: &mountPointPhysicalVolumes2,
            Name: &namePhysicalVolumes2,
            Size: &sizePhysicalVolumes2,
            UsedSize: &usedSizePhysicalVolumes2,
            InodeSize: &inodeSizePhysicalVolumes2,
        },
        {
            DeviceUse: &deviceUsePhysicalVolumes3,
            FileSystem: &fileSystemPhysicalVolumes3,
            MountPoint: &mountPointPhysicalVolumes3,
            Name: &namePhysicalVolumes3,
            Size: &sizePhysicalVolumes3,
            UsedSize: &usedSizePhysicalVolumes3,
            InodeSize: &inodeSizePhysicalVolumes3,
        },
    }
	partitionStyleDisks:= model.GetServerDiskPartitionStyleEnum().MBR
	partitionStyleDisks1:= model.GetServerDiskPartitionStyleEnum().MBR
	partitionStyleDisks2:= model.GetServerDiskPartitionStyleEnum().MBR
	var listDisksbody = []model.ServerDisk{
        {
            Name: "/dev/vda",
            PartitionStyle: &partitionStyleDisks,
            DeviceUse: model.GetServerDiskDeviceUseEnum().BOOT,
            Size: int64(42949672960),
            UsedSize: int64(42948624384),
            PhysicalVolumes: listPhysicalVolumesDisks1,
        },
        {
            Name: "/dev/vdb",
            PartitionStyle: &partitionStyleDisks1,
            DeviceUse: model.GetServerDiskDeviceUseEnum().NORMAL,
            Size: int64(21474836480),
            UsedSize: int64(21473787904),
            PhysicalVolumes: listPhysicalVolumesDisks,
        },
        {
            Name: "/dev/vdc",
            PartitionStyle: &partitionStyleDisks2,
            DeviceUse: model.GetServerDiskDeviceUseEnum().VOLUME_GROUP,
            Size: int64(21474836480),
            UsedSize: int64(0),
        },
    }
	request.Body = &model.PutDiskInfoReq{
		BtrfsList: &listBtrfsListbody,
		Volumegroups: &listVolumegroupsbody,
		Disks: &listDisksbody,
	}
	response, err := client.UpdateDiskInfo(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code

Description

200

The disk information was updated.

403

Authentication failed.

Error Codes

See Error Codes.