Updated on 2024-09-26 GMT+08:00

Updating Disk Information

Function

This API is used to update the disk information of a source server. After you call this API successfully, the new disk information will take effect, and the original disk information will be deleted.

Calling Method

For details, see Calling APIs.

URI

PUT /v3/sources/{source_id}/diskinfo

Table 1 Path parameter

Parameter

Mandatory

Type

Description

source_id

Yes

String

The source server ID.

Minimum length: 0 characters

Maximum length: 255 characters

Request

Table 2 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Minimum length: 1 character

Maximum length: 16,384 characters

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

disks

No

Array of ServerDisk objects

The updated disk information.

Array length: 0 to 65,535 characters

volumegroups

No

Array of VolumeGroups objects

The updated volume information.

Array length: 0 to 65,535 characters

btrfs_list

No

Array of BtrfsFileSystem objects

The updated Btrfs information.

Array length: 0 to 65,535 characters

Table 4 ServerDisk field description

Parameter

Mandatory

Type

Description

name

Yes

String

The disk name.

Minimum length: 0 characters

Maximum length: 255 characters

partition_style

No

String

The disk partition type. This parameter is mandatory for source server registration.

The value can be:

  • MBR

  • GPT

device_use

Yes

String

The disk function.

The value can be:

  • BOOT

  • OS

size

Yes

Long

The disk size, in bytes.

Minimum value: 0

Maximum value: 9223372036854775807

used_size

Yes

Long

The used disk space, in bytes.

Minimum value: 0

Maximum value: 9223372036854775807

physical_volumes

Yes

Array of PhysicalVolume objects

The physical partition information of the disk.

Array length: 0 to 65,535 characters

os_disk

No

Boolean

Specifies whether the disk is the system disk.

relation_name

No

String

The name of the corresponding disk on the target server running Linux.

Minimum length: 0 characters

Maximum length: 255 characters

inode_size

No

Integer

The number of inodes.

Minimum value: 0

Maximum value: 2147483647

Table 5 PhysicalVolume

Parameter

Mandatory

Type

Description

device_use

No

String

The partition function. The value can be NORMAL, BOOT, or OS.

Minimum length: 0 characters

Maximum length: 255 characters

file_system

No

String

The file system type.

Minimum length: 0 characters

Maximum length: 255 characters

index

No

Integer

The serial number of the volume.

Minimum value: 0

Maximum value: 2147483647

mount_point

No

String

The mount point.

Minimum length: 0 characters

Maximum length: 255 characters

name

No

String

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

Minimum length: 0 characters

Maximum length: 255 characters

size

No

Long

The size.

Minimum value: 0

Maximum value: 9223372036854775807

used_size

No

Long

The used space.

Minimum value: 0

Maximum value: 9223372036854775807

inode_size

No

Integer

The number of inodes.

Minimum value: 0

Maximum value: 2147483647

inode_nums

No

Long

The number of inodes.

Minimum value: 0

Maximum value: 9223372036854775807

uuid

No

String

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

Minimum length: 0 characters

Maximum length: 255 characters

size_per_cluster

No

Integer

The size of each cluster.

Minimum value: 0

Maximum value: 2147483647

Table 6 VolumeGroups field description

Parameter

Mandatory

Type

Description

components

No

String

The physical volume information.

Minimum length: 0 characters

Maximum length: 255 characters

free_size

No

Long

The available space.

Minimum value: 0

Maximum value: 9223372036854775807

logical_volumes

No

Array of LogicalVolumes objects

The logical volume information.

Array length: 0 to 255 characters

name

No

String

The name.

Minimum length: 0 characters

Maximum length: 255 characters

size

No

Long

The size.

Minimum value: 0

Maximum value: 9223372036854775807

Table 7 LogicalVolumes field description

Parameter

Mandatory

Type

Description

block_count

No

Integer

The number of blocks.

Minimum value: 0

Maximum value: 2147483647

Default value: 0

block_size

No

Long

The block size.

Minimum value: 0

Maximum value: 1048576

Default value: 0

file_system

Yes

String

The file system.

Minimum length: 0 characters

Maximum length: 255 characters

inode_size

Yes

Integer

The number of inodes.

Minimum value: 0

Maximum value: 2147483647

inode_nums

No

Long

The number of inodes.

Minimum value: 0

Maximum value: 9223372036854775807

device_use

No

String

The partition function. The value can be NORMAL, BOOT, or OS.

Minimum length: 0 characters

Maximum length: 255 characters

mount_point

Yes

String

The mount point.

Minimum length: 0 characters

Maximum length: 256 characters

name

Yes

String

The name.

Minimum length: 0 characters

Maximum length: 1,024 characters

size

Yes

Long

The size.

Minimum value: 0

Maximum value: 9223372036854775807

used_size

Yes

Long

The used space.

Minimum value: 0

Maximum value: 9223372036854775807

free_size

Yes

Long

The available space.

Minimum value: 0

Maximum value: 9223372036854775807

Table 8 BtrfsFileSystem field description

Parameter

Mandatory

Type

Description

name

Yes

String

The file system name.

Minimum length: 0 characters

Maximum length: 255 characters

label

Yes

String

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

Minimum length: 0 characters

Maximum length: 255 characters

The UUID.

Yes

String

The UUID of the file system.

Minimum length: 0 characters

Maximum length: 255 characters

device

Yes

String

The device name in the Btrfs.

Minimum length: 0 characters

Maximum length: 255 characters

size

Yes

Long

The space occupied by the file system.

Minimum value: 0

Maximum value: 9223372036854775807

nodesize

Yes

Long

The size of the Btrfs node.

Minimum value: 0

Maximum value: 9223372036854775807

sectorsize

Yes

Integer

The sector size.

Minimum value: 0

Maximum value: 2147483647

data_profile

Yes

String

The data profile (RAD).

Minimum length: 0 characters

Maximum length: 255 characters

system_profile

Yes

String

The file system profile (RAD).

Minimum length: 0 characters

Maximum length: 255 characters

metadata_profile

Yes

String

The metadata profile (RAD).

Minimum length: 0 characters

Maximum length: 255 characters

global_reserve1

Yes

String

The Btrfs file system information.

Minimum length: 0 characters

Maximum length: 255 characters

g_vol_used_size

Yes

Long

The used space of the Btrfs volume.

Minimum value: 0

Maximum value: 9223372036854775807

default_subvolid

Yes

String

The ID of the default subvolume.

Minimum length: 0 characters

Maximum length: 255 characters

default_subvol_name

Yes

String

The name of the default subvolume.

Minimum length: 0 characters

Maximum length: 255 characters

default_subvol_mountpath

Yes

String

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

Minimum length: 0 characters

Maximum length: 255 characters

subvolume

Yes

Array of BtrfsSubvolumn objects

The subvolume information.

Array length: 0 to 65,535 characters

Table 9 BtrfsSubvolumn field description

Parameter

Mandatory

Type

Description

The UUID.

Yes

String

The UUID of the parent volume.

Minimum length: 0 characters

Maximum length: 255 characters

is_snapshot

Yes

String

Specifies whether the subvolume is a snapshot.

Minimum length: 0 characters

Maximum length: 255 characters

subvol_id

Yes

String

The subvolume ID.

Minimum length: 0 characters

Maximum length: 255 characters

parent_id

Yes

String

The parent volume ID.

Minimum length: 0 characters

Maximum length: 255 characters

subvol_name

Yes

String

The subvolume name.

Minimum length: 0 characters

Maximum length: 255 characters

subvol_mount_path

Yes

String

The mount path of the subvolume.

Minimum length: 0 characters

Maximum length: 255 characters

Response

None

Example Request

This example updates the original disk information of the server to the new disk information. The new disk name is /dev/vda, the disk function is BOOT, and the disk size is 42949672960 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 Response

None

SDK Sample Code

The sample code is as follows.

This example updates the original disk information of the server to the new disk information. 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
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();
        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 original disk information of the server to the new disk information. 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
# 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()
        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 original disk information of the server to the new disk information. 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
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{}
	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 more SDK sample code of programming languages, visit API Explorer and click the Sample Code tab. Example code can be automatically generated.

Status Codes

Status Code

Description

200

Response returned.

Error Codes

For details, see Error Codes.