1# @ohos.file.volumeManager (卷管理) 2 3该模块提供卷设备、磁盘设备查询和管理的相关功能：包括查询卷设备信息，对卷设备的挂载卸载、对磁盘设备分区以及卷设备的格式化等功能。 4 5> **说明：** 6> 7> - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> - 本模块接口为系统接口。 9 10## 导入模块 11 12```js 13import volumemanager from "@ohos.file.volumeManager"; 14``` 15 16## volumemanager.getAllVolumes 17 18getAllVolumes(): Promise<Array<Volume>> 19 20异步获取当前外置存储中所有卷设备信息，以promise方式返回。 21 22**需要权限**：ohos.permission.STORAGE_MANAGER 23 24**系统能力**：SystemCapability.FileManagement.StorageService.Volume 25 26**返回值：** 27 28 | 类型 | 说明 | 29 | ---------------------------------- | -------------------------- | 30 | Promise<[Volume](#volume)[]> | 返回当前所有可获得的卷设备信息 | 31 32**错误码：** 33 34以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 35 36| 错误码ID | 错误信息 | 37| -------- | -------- | 38| 201 | Permission verification failed. | 39| 202 | The caller is not a system application. | 40| 401 | The input parameter is invalid. | 41| 13600001 | IPC error. | 42| 13900032 | Unknown error. | 43 44**示例：** 45 46 ```js 47 volumemanager.getAllVolumes().then(function(volumes){ 48 // do something 49 }).catch(function(error){ 50 console.info("getAllVolumes failed"); 51 }); 52 ``` 53 54## volumemanager.getAllVolumes 55 56getAllVolumes(callback: AsyncCallback<Array<Volume>>): void 57 58异步获取当前外置存储中所有卷设备信息，以callback方式返回。 59 60**需要权限**：ohos.permission.STORAGE_MANAGER 61 62**系统能力**：SystemCapability.FileManagement.StorageService.Volume 63 64**参数：** 65 66 | 参数名 | 类型 | 必填 | 说明 | 67 | -------- | ------------------------------------------------- | ---- | ------------------------------------ | 68 | callback | AsyncCallback<[Volume](#volume)[]> | 是 | 获取当前所有可获得的卷设备信息之后的回调 | 69 70**错误码：** 71 72以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 73 74| 错误码ID | 错误信息 | 75| -------- | -------- | 76| 201 | Permission verification failed. | 77| 202 | The caller is not a system application. | 78| 401 | The input parameter is invalid. | 79| 13600001 | IPC error. | 80| 13900032 | Unknown error. | 81 82**示例：** 83 84 ```js 85 let uuid = ""; 86 volumemanager.getAllVolumes(function(error, volumes){ 87 // do something 88 }); 89 ``` 90 91## volumemanager.mount 92 93mount(volumeId: string): Promise<void> 94 95异步挂载指定卷设备，以promise方式返回。当前仅支持fat、exfat以及ntfs三中文件系统的卷设备挂载。 96 97**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 98 99**系统能力**：SystemCapability.FileManagement.StorageService.Volume 100 101**参数：** 102 103 | 参数名 | 类型 | 必填 | 说明 | 104 | -------- | ------ | ---- | ---- | 105 | volumeId | string | 是 | 卷设备id | 106 107**返回值：** 108 109 | 类型 | 说明 | 110 | ---------------------- | ---------- | 111 | Promise<void> | 挂载指定卷设备 | 112 113**错误码：** 114 115以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 116 117| 错误码ID | 错误信息 | 118| -------- | -------- | 119| 201 | Permission verification failed. | 120| 202 | The caller is not a system application. | 121| 401 | The input parameter is invalid. | 122| 13600001 | IPC error. | 123| 13600002 | Not supported filesystem. | 124| 13600003 | Failed to mount. | 125| 13600005 | Incorrect volume state. | 126| 13600008 | No such object. | 127| 13900032 | Unknown error. | 128 129**示例：** 130 131 ```js 132 let volumeId = ""; 133 volumemanager.mount(volumeId).then(function(){ 134 // do something 135 }).catch(function(error){ 136 console.info("mount failed"); 137 }); 138 ``` 139 140## volumemanager.mount 141 142mount(volumeId: string, callback:AsyncCallback<void>):void 143 144异步挂载指定卷设备，以callback方式返回。当前仅支持fat、exfat以及ntfs三中文件系统的卷设备挂载。 145 146**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 147 148**系统能力**：SystemCapability.FileManagement.StorageService.Volume 149 150**参数：** 151 152 | 参数名 | 类型 | 必填 | 说明 | 153 | -------- | ------------------------------------- | ---- | -------------------- | 154 | volumeId | string | 是 | 卷设备id | 155 | callback | AsyncCallback<void> | 是 | 挂载指定卷设备之后的回调 | 156 157**错误码：** 158 159以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 160 161| 错误码ID | 错误信息 | 162| -------- | -------- | 163| 201 | Permission verification failed. | 164| 202 | The caller is not a system application. | 165| 401 | The input parameter is invalid. | 166| 13600001 | IPC error. | 167| 13600002 | Not supported filesystem. | 168| 13600003 | Failed to mount. | 169| 13600005 | Incorrect volume state. | 170| 13600008 | No such object. | 171| 13900032 | Unknown error. | 172 173**示例：** 174 175 ```js 176 let volumeId = ""; 177 volumemanager.mount(volumeId, function(error){ 178 // do something 179 }); 180 ``` 181 182## volumemanager.unmount 183 184unmount(volumeId: string): Promise<void> 185 186异步卸载指定卷设备，以promise方式返回。 187 188**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 189 190**系统能力**：SystemCapability.FileManagement.StorageService.Volume 191 192**参数：** 193 194 | 参数名 | 类型 | 必填 | 说明 | 195 | -------- | ------ | ---- | ---- | 196 | volumeId | string | 是 | 卷设备id | 197 198**返回值：** 199 200 | 类型 | 说明 | 201 | ---------------------- | ---------- | 202 | Promise<void> | 卸载指定卷设备 | 203 204**错误码：** 205 206以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 207 208| 错误码ID | 错误信息 | 209| -------- | -------- | 210| 201 | Permission verification failed. | 211| 202 | The caller is not a system application. | 212| 401 | The input parameter is invalid. | 213| 13600001 | IPC error. | 214| 13600002 | Not supported filesystem. | 215| 13600004 | Failed to unmount. | 216| 13600005 | Incorrect volume state. | 217| 13600008 | No such object. | 218| 13900032 | Unknown error. | 219 220**示例：** 221 222 ```js 223 let volumeId = ""; 224 volumemanager.unmount(volumeId).then(function(){ 225 // do something 226 }).catch(function(error){ 227 console.info("mount failed"); 228 }); 229 ``` 230 231## volumemanager.unmount 232 233unmount(volumeId: string, callback: AsyncCallback<void>): void 234 235异步卸载指定卷设备，以callback方式返回。 236 237**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 238 239**系统能力**：SystemCapability.FileManagement.StorageService.Volume 240 241**参数：** 242 243 | 参数名 | 类型 | 必填 | 说明 | 244 | -------- | ------------------------------------- | ---- | -------------------- | 245 | volumeId | string | 是 | 卷设备id | 246 | callback | AsyncCallback<void> | 是 | 卸载指定卷设备之后的回调 | 247 248**错误码：** 249 250以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 251 252| 错误码ID | 错误信息 | 253| -------- | -------- | 254| 201 | Permission verification failed. | 255| 202 | The caller is not a system application. | 256| 401 | The input parameter is invalid. | 257| 13600001 | IPC error. | 258| 13600002 | Not supported filesystem. | 259| 13600004 | Failed to unmount. | 260| 13600005 | Incorrect volume state. | 261| 13600008 | No such object. | 262| 13900032 | Unknown error. | 263 264**示例：** 265 266 ```js 267 let volumeId = ""; 268 volumemanager.unmount(volumeId, function(error){ 269 // do something 270 }); 271 ``` 272 273## volumemanager.getVolumeByUuid 274 275getVolumeByUuid(uuid: string): Promise<Volume> 276 277异步通过卷设备uuid获得指定卷设备信息，以promise方式返回。 278 279**需要权限**：ohos.permission.STORAGE_MANAGER 280 281**系统能力**：SystemCapability.FileManagement.StorageService.Volume 282 283**参数：** 284 285 | 参数名 | 类型 | 必填 | 说明 | 286 | -------- | ------ | ---- | ---- | 287 | uuid | string | 是 | 卷设备uuid | 288 289**返回值：** 290 291 | 类型 | 说明 | 292 | ---------------------------------- | -------------------------- | 293 | Promise<[Volume](#volume)> | 返回当前所有可获得的卷设备信息 | 294 295**错误码：** 296 297以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 298 299| 错误码ID | 错误信息 | 300| -------- | -------- | 301| 201 | Permission verification failed. | 302| 202 | The caller is not a system application. | 303| 401 | The input parameter is invalid. | 304| 13600001 | IPC error. | 305| 13600008 | No such object. | 306| 13900032 | Unknown error. | 307 308**示例：** 309 310 ```js 311 let uuid = ""; 312 volumemanager.getVolumeByUuid(uuid).then(function(volume) { 313 console.info("getVolumeByUuid successfully:" + JSON.stringify(volume)); 314 }).catch(function(error){ 315 console.info("getVolumeByUuid failed with error:"+ error); 316 }); 317 ``` 318 319## volumemanager.getVolumeByUuid 320 321getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void 322 323异步通过卷设备uuid获得指定卷设备信息，以callback方式返回。 324 325**需要权限**：ohos.permission.STORAGE_MANAGER 326 327**系统能力**：SystemCapability.FileManagement.StorageService.Volume 328 329**参数：** 330 331 | 参数名 | 类型 | 必填 | 说明 | 332 | -------- | ------------------------------------------------ | ---- | -------------------- | 333 | uuid | string | 是 | 卷设备uuid | 334 | callback | AsyncCallback<[Volume](#volume)> | 是 | 获取卷设备信息之后的回调 | 335 336**错误码：** 337 338以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 339 340| 错误码ID | 错误信息 | 341| -------- | -------- | 342| 201 | Permission verification failed. | 343| 202 | The caller is not a system application. | 344| 401 | The input parameter is invalid. | 345| 13600001 | IPC error. | 346| 13600008 | No such object. | 347| 13900032 | Unknown error. | 348 349**示例：** 350 351 ```js 352 let uuid = ""; 353 volumemanager.getVolumeByUuid(uuid, (error, volume) => { 354 // do something 355 }); 356 ``` 357 358## volumemanager.getVolumeById 359 360getVolumeById(volumeId: string): Promise<Volume> 361 362异步通过卷设备id获得指定卷设备信息，以promise方式返回。 363 364**需要权限**：ohos.permission.STORAGE_MANAGER 365 366**系统能力**：SystemCapability.FileManagement.StorageService.Volume 367 368**参数：** 369 370 | 参数名 | 类型 | 必填 | 说明 | 371 | -------- | ------ | ---- | ---- | 372 | volumeId | string | 是 | 卷设备id | 373 374**返回值：** 375 376 | 类型 | 说明 | 377 | ---------------------------------- | -------------------------- | 378 | Promise<[Volume](#volume)> | 返回当前所有可获得的卷设备信息 | 379 380**错误码：** 381 382以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 383 384| 错误码ID | 错误信息 | 385| -------- | -------- | 386| 201 | Permission verification failed. | 387| 202 | The caller is not a system application. | 388| 401 | The input parameter is invalid. | 389| 13600001 | IPC error. | 390| 13600008 | No such object. | 391| 13900032 | Unknown error. | 392 393**示例：** 394 395 ```js 396 let volumeId = ""; 397 volumemanager.getVolumeById(volumeId).then(function(volume) { 398 console.info("getVolumeById successfully:" + JSON.stringify(volume)); 399 }).catch(function(error){ 400 console.info("getVolumeById failed with error:"+ error); 401 }); 402 ``` 403 404## volumemanager.getVolumeById 405 406getVolumeById(volumeId: string, callback: AsyncCallback<Volume>): void 407 408异步通过指定卷设备id获得卷设备信息，以callback方式返回。 409 410**需要权限**：ohos.permission.STORAGE_MANAGER 411 412**系统能力**：SystemCapability.FileManagement.StorageService.Volume 413 414**参数：** 415 416 | 参数名 | 类型 | 必填 | 说明 | 417 | -------- | ------------------------- | ---- | ----------------------------- | 418 | volumeId | string | 是 | 卷设备id | 419 | callback | AsyncCallback<[Volume](#volume)> | 是 | 获取卷设备信息之后的回调 | 420 421**错误码：** 422 423以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 424 425| 错误码ID | 错误信息 | 426| -------- | -------- | 427| 201 | Permission verification failed. | 428| 202 | The caller is not a system application. | 429| 401 | The input parameter is invalid. | 430| 13600001 | IPC error. | 431| 13600008 | No such object. | 432| 13900032 | Unknown error. | 433 434**示例：** 435 436 ```js 437 let volumeId = ""; 438 volumemanager.getVolumeById(volumeId, (error, volume) => { 439 // do something 440 }); 441 ``` 442 443## volumemanager.setVolumeDescription 444 445setVolumeDescription(uuid: string, description: string): Promise<void> 446 447异步修改指定卷设备描述，以promise方式返回。 448 449**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 450 451**系统能力**：SystemCapability.FileManagement.StorageService.Volume 452 453**参数：** 454 455 | 参数名 | 类型 | 必填 | 说明 | 456 | --------- | ------ | ---- | ---- | 457 | uuid | string | 是 | 卷设备uuid | 458 | description | string | 是 | 卷设备描述 | 459 460**返回值：** 461 462 | 类型 | 说明 | 463 | ---------------------- | -------------------------- | 464 | Promise<void> | 设置卷设备信息 | 465 466**错误码：** 467 468以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 469 470| 错误码ID | 错误信息 | 471| -------- | -------- | 472| 201 | Permission verification failed. | 473| 202 | The caller is not a system application. | 474| 401 | The input parameter is invalid. | 475| 13600001 | IPC error. | 476| 13600002 | Not supported filesystem. | 477| 13600005 | Incorrect volume state. | 478| 13600008 | No such object. | 479| 13900032 | Unknown error. | 480 481**示例：** 482 483 ```js 484 let uuid = ""; 485 let description = ""; 486 volumemanager.setVolumeDescription(uuid, description).then(function() { 487 console.info("setVolumeDescription successfully"); 488 }).catch(function(error){ 489 console.info("setVolumeDescription failed with error:"+ error); 490 }); 491 ``` 492 493## volumemanager.setVolumeDescription 494 495setVolumeDescription(uuid: string, description: string, callback: AsyncCallback<void>): void 496 497异步修改指定卷设备描述，以callback方式返回。 498 499**需要权限**：ohos.permission.MOUNT_UNMOUNT_MANAGER 500 501**系统能力**：SystemCapability.FileManagement.StorageService.Volume 502 503**参数：** 504 505 | 参数名 | 类型 | 必填 | 说明 | 506 | ---------- | --------------------------------------- | ---- | ---------------- | 507 | uuid | string | 是 | 卷设备uuid | 508 | description | string | 是 | 卷设备描述 | 509 | callback | AsyncCallback<void> | 是 | 设置卷描述之后的回调 | 510 511**错误码：** 512 513以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 514 515| 错误码ID | 错误信息 | 516| -------- | -------- | 517| 201 | Permission verification failed. | 518| 202 | The caller is not a system application. | 519| 401 | The input parameter is invalid. | 520| 13600001 | IPC error. | 521| 13600002 | Not supported filesystem. | 522| 13600005 | Incorrect volume state. | 523| 13600008 | No such object. | 524| 13900032 | Unknown error. | 525 526**示例：** 527 528 ```js 529 let uuid = ""; 530 let description = ""; 531 volumemanager.setVolumeDescription(uuid, description, (error) => { 532 // do something 533 }); 534 ``` 535 536## volumemanager.format 537 538format(volumeId: string, fsType: string): Promise<void> 539 540异步对指定卷设备进行格式化，以promise方式返回。当前仅支持vfat和exfat两种文件系统类型的格式化，只有处于卸载状态的卷设备可以进行格式化，格式化后卷设备的uuid、挂载路径和卷设备描述均会发生变化。 541 542**需要权限**：ohos.permission.MOUNT_FORMAT_MANAGER 543 544**系统能力**：SystemCapability.FileManagement.StorageService.Volume 545 546**参数：** 547 548 | 参数名 | 类型 | 必填 | 说明 | 549 | ----------- | ------ | ---- | ---- | 550 | volumeId | string | 是 | 卷设备id | 551 | fsType | string | 是 | 文件系统类型（vfat或者exfat） | 552 553**返回值：** 554 555 | 类型 | 说明 | 556 | ---------------------- | ---------- | 557 | Promise<void> | 对指定卷设备进行格式化 | 558 559**错误码：** 560 561以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 562 563| 错误码ID | 错误信息 | 564| -------- | -------- | 565| 201 | Permission verification failed. | 566| 202 | The caller is not a system application. | 567| 401 | The input parameter is invalid. | 568| 13600001 | IPC error. | 569| 13600002 | Not supported filesystem. | 570| 13600005 | Incorrect volume state. | 571| 13600008 | No such object. | 572| 13900032 | Unknown error. | 573 574**示例：** 575 576 ```js 577 let volumeId = ""; 578 let fsType = ""; 579 volumemanager.format(volumeId, fsType).then(function() { 580 console.info("format successfully"); 581 }).catch(function(error){ 582 console.info("format failed with error:"+ error); 583 }); 584 ``` 585 586## volumemanager.format 587 588format(volumeId: string, fsType: string, callback: AsyncCallback<void>): void 589 590异步对指定卷设备进行格式化，以callback方式返回。当前仅支持vfat和exfat两种文件系统类型的格式化，只有处于卸载状态的卷设备可以进行格式化，格式化后卷设备的uuid、挂载路径和卷设备描述均会发生变化。 591 592**需要权限**：ohos.permission.MOUNT_FORMAT_MANAGER 593 594**系统能力**：SystemCapability.FileManagement.StorageService.Volume 595 596**参数：** 597 598 | 参数名 | 类型 | 必填 | 说明 | 599 | -------- | ------------------------- | ---- | ----------------------------- | 600 | volumeId | string | 是 | 卷设备id | 601 | fsType | string | 是 | 文件系统类型(vfat或者exfat) | 602 | callback | AsyncCallback<void> | 是 | 对指定卷设备格式化后的回调 | 603 604**错误码：** 605 606以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 607 608| 错误码ID | 错误信息 | 609| -------- | -------- | 610| 201 | Permission verification failed. | 611| 202 | The caller is not a system application. | 612| 401 | The input parameter is invalid. | 613| 13600001 | IPC error. | 614| 13600002 | Not supported filesystem. | 615| 13600005 | Incorrect volume state. | 616| 13600008 | No such object. | 617| 13900032 | Unknown error. | 618 619**示例：** 620 621 ```js 622 let volumeId = ""; 623 let fsType = ""; 624 volumemanager.format(volumeId, fsType, (error) => { 625 // do something 626 }); 627 ``` 628 629## volumemanager.partition 630 631partition(diskId: string, type: number): Promise<void> 632 633异步对磁盘设备进行分区，以promise方式返回。当前仅支持将磁盘设备重新分区为一个分区，系统是支持读取多分区的磁盘设备。 634 635**需要权限**：ohos.permission.MOUNT_FORMAT_MANAGER 636 637**系统能力**：SystemCapability.FileManagement.StorageService.Volume 638 639**参数：** 640 641 | 参数名 | 类型 | 必填 | 说明 | 642 | ----------- | ------ | ---- | ---- | 643 | diskId | string | 是 | 卷设备所属的磁盘设备id | 644 | type | number | 是 | 分区类型 | 645 646**返回值：** 647 648 | 类型 | 说明 | 649 | --------------------- | ----------------------- | 650 | Promise<void> | 对磁盘进行分区 | 651 652**错误码：** 653 654以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 655 656| 错误码ID | 错误信息 | 657| -------- | -------- | 658| 201 | Permission verification failed. | 659| 202 | The caller is not a system application. | 660| 401 | The input parameter is invalid. | 661| 13600001 | IPC error. | 662| 13600008 | No such object. | 663| 13900032 | Unknown error. | 664 665**示例：** 666 667 ```js 668 let diskId = ""; 669 let type = 0; 670 volumemanager.partition(diskId, type).then(function() { 671 console.info("partition successfully"); 672 }).catch(function(error){ 673 console.info("partition failed with error:"+ error); 674 }); 675 ``` 676 677## volumemanager.partition 678 679partition(diskId: string, type: number, callback: AsyncCallback<void>): void 680 681异步对磁盘进行分区，以callback方式返回。当前仅支持将磁盘设备重新分区为一个分区，系统是支持读取多分区的磁盘设备。 682 683**需要权限**：ohos.permission.MOUNT_FORMAT_MANAGER 684 685**系统能力**：SystemCapability.FileManagement.StorageService.Volume 686 687**参数：** 688 689 | 参数名 | 类型 | 必填 | 说明 | 690 | -------- | --------------------------------------- | ---- | ---------------- | 691 | diskId | string | 是 | 卷设备所属的磁盘id | 692 | type | number | 是 | 分区类型 | 693 | callback | AsyncCallback<void> | 是 | 对磁盘设备进行分区 | 694 695**错误码：** 696 697以下错误码的详细介绍请参见[文件管理错误码](../errorcodes/errorcode-filemanagement.md)。 698 699| 错误码ID | 错误信息 | 700| -------- | -------- | 701| 201 | Permission verification failed. | 702| 202 | The caller is not a system application. | 703| 401 | The input parameter is invalid. | 704| 13600001 | IPC error. | 705| 13600008 | No such object. | 706| 13900032 | Unknown error. | 707 708**示例：** 709 710 ```js 711 let diskId = ""; 712 let type = 0; 713 volumemanager.partition(diskId, type, (error) => { 714 // do something 715 }); 716 ``` 717 718## Volume 719 720**系统能力**：以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.Volume。 721 722### 属性 723 724| 名称 | 类型 | 可读 | 可写 | 说明 | 725| ----------- | ------- | ------- | ----- | -------------------- | 726| id | string | 是 | 否 | 卷设备ID的格式为vol-{主设备号}-{次设备号}，主设备号用来区分不同种类的设备，次设备号用来区分同一类型的多个设备，卷设备ID会随着插卡顺序不同而变化。 | 727| uuid | string | 是 | 否 | 卷设备uuid是卷设备的通用唯一识别码，不会随着插卡顺序变化而变化，但是卷设备的格式化会改变卷设备的uuid | 728| diskId | string | 是 | 否 | 卷设备所属的磁盘ID，一个磁盘可以有一个或者多个卷设备。磁盘设备ID好格式为disk-{主设备号}-{次设备号}，与卷设备ID相似。 | 729| description | string | 是 | 否 | 卷设备描述、 | 730| removable | boolean | 是 | 否 | 表示卷设备是否可移除，当前仅支持可移除存储设备、 | 731| state | number | 是 | 否 | 卷设备状态标识：<br>0：卸载状态 UNMOUNTED<br> 1：检查状态 CHECKING<br> 2：挂载状态 MOUNTED<br> 3：正在弹出状态 EJECTING | 732| path | string | 是 | 否 | 卷设备的挂载地址，一般为/mnt/external/{uuid} |