云主机

  • 云主机服务 > API 文档 > 磁盘 >创建磁盘

    创建磁盘

    最近更新时间:2020-12-29 15:50:41

    请求路径

    POST /v1/vm/disk

    请求参数

    名称 类型 位置 必须 描述
    region_id string query

    地域 ID。

    您可以调用 DescribeRegions 查看最新的七牛云地域列表。

    zone_id string body

    在指定可用区内创建一块按量付费云盘。

    • 如果您不设置 InstanceId,则 ZoneId 为必填参数。
    • 您不能同时指定 ZoneId 和 InstanceId。
    size integer body

    容量大小,以 GiB 为单位。指定该参数后,其取值必须≥指定快照 ID 的容量大小。取值范围:

    • cloud:5~2000
    • cloud_efficiency:20~32768
    • cloud_ssd:20~32768
    • cloud_essd:20~32768
    disk_name string body

    云盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

    默认值:空

    description string body

    云盘描述。长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。

    默认值:空

    encrypted boolean/td> body

    是否加密云盘。默认值:false

    disk_category string body

    数据盘的云盘种类。取值范围:

    • cloud:普通云盘
    • cloud_efficiency:高效云盘
    • cloud_ssd:SSD 云盘
    • cloud_essd:ESSD 云盘 默认值:cloud
    performance_level string body

    创建一块 ESSD 云盘时,设置云盘的性能等级。取值范围:

    • PL1(默认):单盘最高随机读写 IOPS 5 万
    • PL2:单盘最高随机读写 IOPS 10 万
    • PL3:单盘最高随机读写 IOPS 100 万 有关如何选择 ESSD 性能等级,请参见 ESSD 云盘。
    snapshot_id string body

    创建云盘使用的快照。指定该参数后,Size 会被忽略,实际创建的云盘大小为指定快照的大小。2013年7月15日及以前的快照不能用来创建云盘。

    instance_id string body

    创建一块包年包月云盘,并自动挂载到指定的包年包月实例(InstanceId)上。

    • 设置实例 ID 后,会忽略您设置的 ResourceGroupId、Tag.N.Key、Tag.N.Value、ClientToken 和 KMSKeyId 参数。
    • 您不能同时指定 ZoneId 和 InstanceId。 默认值:空,代表创建的是按量付费云盘,云盘所属地由 RegionId 和 ZoneId 确定。
    client_token string body

    保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。

    cost_charge_type string body 付费方式
    cost_charge_mode string body 计费方式
    cost_period_unit string body 计费单位
    cost_period integer body 计费周期

    返回值

    名称 类型 描述
    request_id string 请求 ID
    data object{} 返回数据
    data.disk_id string 按量创建返回 ID
    data.order string 预付费创建返回订单号
    以上内容是否对您有帮助?
  • Qvm free helper
    Close