云主机 > 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"
}

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