human: 如何处理七牛云的云主机磁盘详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >磁盘详情

#  磁盘详情

最近更新时间: 2020-12-29 15:55:13

# 请求路径

> `GET` /v1/vm/disk/:disk_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
disk_id | string | path | 是 | 磁盘 ID  
region_id | string | query | 是 | 实例所属的地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | []Disk | 磁盘列表  
  
### Disk

名称 | 类型 | 描述  
---|---|---  
zone_id | string |  可用区 ID。  
region_id | string |  区域 ID  
disk_id | string |  磁盘 ID  
disk_name | string |  磁盘名称  
type | string |  磁盘类型  
size | integer |  云盘或本地盘大小，单位 GiB。  
status | string |  云盘状态。可能值：In_use, Available, Attaching, Detaching, Creating, ReIniting  
device | string |  云盘或本地盘挂载的实例的设备名，例如 `/dev/xvdb`。该参数仅在 Status 参数值为 `In_use` 时才有值，其他状态时为空。  
category | string |  云盘种类  
portable | boolean |  云盘或本地盘是否支持卸载。取值范围：

  * true：支持。可以独立存在，且可以在可用区内自由挂载和卸载。
  * false：不支持。不可以独立存在，且不可以在可用区内自由挂载和卸载。

以下类型块存储的 Portable 属性都为 false，生命周期与实例等同：

  * 本地盘
  * 本地 SSD 盘
  * 包年包月数据盘

  
encrypted | boolean |  是否只筛选出加密云盘。默认值：false  
description | string |  云盘或本地盘描述。  
expired_time | string |  过期时间  
attached_time | string |  挂载时间  
detached_time | string |  卸载时间。  
disk_charge_type | string |  云盘或本地盘的计费方式。 可能值：

  * PrePaid：包年包月
  * PostPaid：按量付费

  
enable_auto_snapshot | boolean |  云盘是否启用自动快照策略功能。  
delete_auto_snapshot | boolean |  是否同时删除自动快照。 可能值：

  * true：删除云盘上的快照。
  * false：保留云盘上的快照。

  
enable_automated_snapshot_policy | boolean |  云盘是否设置了自动快照策略。  
delete_with_instance | boolean |  是否随实例释放。可能值：

  * true：释放实例时，这块云盘随实例一起释放。
  * false：释放实例时，这块云盘保留不释放。

  
image_id | string |  创建 ECS 实例时使用的镜像 ID，只有通过镜像创建的云盘才有值，否则为空。这个值在云盘的生命周期内始终不变。  
instance_id | string |  云盘或本地盘挂载的实例 ID。 该参数值仅在 Status 参数值为 In_use 时才有值，其他状态时为空。  
instance_name | string |  云盘或本地盘挂载的实例名称  
source_snapshot_id | string |  创建云盘使用的快照 ID。 如果创建云盘时，没有指定快照，则该参数值为空。该参数值在云盘的生命周期内始终不变。  
auto_snapshot_policy_id | string |  云盘采用的自动快照策略 ID。  
performance_level | string |  ESSD 云盘的性能等级。 可能值：PL1, PL2, PL3  
iops | integer |  每秒读写（I/O）操作的次数，单位：次/s。  
iops_read | integer |  每秒读操作的次数，单位：次/s。  
iops_write | integer |  每秒写操作的次数，单位：次/s。  
created_at | string |  创建时间  
updated_at | string |  更新时间  
cost_charge_type | string | 付费方式  
cost_charge_mode | string | 按什么计费  
  
## 返回值示例

    
    
    {
      "data": {
        "zone_id": "grand-cn-east-3c",
        "region_id": "grand-cn-east-3",
        "disk_id": "7fc9c9e5-4a01-4b78-96fb-9f8754884bc4",
        "disk_name": "I-0PIn3",
        "type": "system",
        "size": 50,
        "status": "In_use",
        "device": "/dev/vda",
        "is_bind": false,
        "category": "H_GPSSD",
        "portable": true,
        "encrypted": false,
        "product_code": "",
        "description": "",
        "expired_time": "3000-01-01T00:00:00+08:00",
        "attached_time": "2020-12-10T18:21:25.269+08:00",
        "detached_time": "0001-01-01T00:00:00Z",
        "disk_charge_type": "PostPaid",
        "operation_locks": {
          "operation_lock": []
        },
        "enable_auto_snapshot": false,
        "delete_auto_snapshot": false,
        "enable_automated_snapshot_policy": false,
        "delete_with_instance": false,
        "image_id": "",
        "instance_id": "6cc3f0fa-2739-4384-8e85-8f212e7edbef",
        "instance_name": "I-0PIn3",
        "resource_group_id": "0",
        "source_snapshot_id": "",
        "auto_snapshot_policy_id": "",
        "performance_level": "",
        "iops": 0,
        "iops_read": 0,
        "iops_write": 0,
        "created_at": "2020-12-10T18:10:26.778+08:00",
        "updated_at": "2020-12-18T14:52:16.286+08:00",
        "cost_charge_type": "PostPaid",
        "cost_charge_mode": "PayByDisk"
      },
      "request_id": "ScKvES8HUEOkwVEW"
    }
    

以上内容是否对您有帮助？