卷实例扩缩容 | 大装置帮助中心
跳到主要内容

卷实例扩缩容

POST /storage/afs/v2/subscriptions/{subscription_name}/resourceGroups/{resource_group_name}/zones/{zone}/virtualVolumes/{virtual_volume_name}:resize

请求头（Request Header）​

参考认证（authentication）

请求参数（Request Parameters​

名称类型必须位置默认值取值范围描述
subscription_namestring是path--订阅名称.
resource_group_namestring是path--资源组.
zonestring是path--可用区.
virtual_volume_namestring是path--卷实例名.

请求体（Request Body）​

名称类型必须默认值取值范围描述
resource_idstring是--卷实例资源id.
sku_idstring是--最小库存单元id.
operator_idstring是--资源操作id
propertiesobject否--卷实例规格属性.
order_infoobject否--订单信息.

其中，properties的参数如下

名称类型必须默认值取值范围描述
resourcesobject否--规格属性.

其中，resources的参数如下

名称类型必须默认值取值范围描述
billing_itemsstring否--计费项.

其中，billing_items的参数如下

名称类型必须默认值取值范围描述
capacitystring否--资源容量.
capacity_unitstring否--资源容量单位.

其中，order_info的参数如下

名称类型必须默认值取值范围描述
billing_cycle_numberinteger否--购买时长.
auto_renewboolean否--自动续费.
currency_codestring否--货币代码.
payment_channelstring否--支付方式.
notestring否--订单备注.
order_typestring否--订单类型.
order_idstring否--订单id.
start_timestring否--订单生效日期.
payment_modelstring否--付费类型.
billing_modelstring否--计费类型.
original_idstring否--合同包ID.
end_timestring否--订单结束时间.

其中，payment_channel有如下情况

状态含义
PC_UNSPECIFIED未指定
PC_BALANCE余额支付
PC_CREDIT信用支付
PC_FROZENACCOUNT冻结款支付
PC_REMIT_OFFLINE线下汇款
PC_ALIPAY支付宝支付
PC_UNIONPAY银联支付
PC_REMIT_ONLINE在线转账
PC_CONTRACT合同包支付

其中，order_type有如下情况

状态含义
OT_UNSPECIFIED未指定
OT_ORIGINAL原始订单
OT_RENEW续费订单
OT_UPGRADED升配订单
OT_DOWNGRADED降配订单
OT_CONTRACT合同订单
OT_UNSUBSCRIBE退订订单
OT_RESIZE扩缩容订单

其中，payment_model有如下情况

状态含义
PM_UNSPECIFIED未指定
PM_PREPAID预付
PM_POSTPAID后付费

其中，billing_model有如下情况

状态含义
BM_UNSPECIFIED未指定
BM_USAGE按量计费
BM_MONTHLY包月
BM_YEARLY包年

请求示例（Request Example）​

curl 'https://management.sensecoreapi.tech/storage/afs/v2/subscriptions/c28f173a-8f18-474c-866b-4ce89a612958/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/faa98576-f5c1-44e1-8a5a-3a2c68c4a78d:resize' \
  --data-raw '{
      "resource_id": "2cb51531-5856-11ee-af22-a22980a5cad2",
      "sku_id": "de6c091b-4841-4602-b120-623ee620c8be",
      "operator_id": "a51b3495-3ba1-4add-b760-3d257e299f37",
      "properties": {
        "resources": {
          "billing_items": {
            "capacity": 20,
            "capacity_unit": "GB",
            "requests": 20
          }
        }
      },
      "order_info": {
        "billing_cycle_number": 8,
        "auto_renew": true,
        "auto_convert_postpaid": false,
        "currency_code": "CNY",
        "payment_channel": "PC_UNSPECIFIED",
        "note": "",
        "order_type": "OT_RESIZE",
        "start_time": "2023-09-25T11:35:01+08:00",
        "payment_model": "PM_PREPAID",
        "billing_model": "BM_MONTHLY"
      }
    }' \
  --compressed

响应（Response）​

名称类型描述
virtual_volumesarray[object]卷实例资源详情列表.
next_page_tokenstring下一页的token.
total_sizeinteger卷实例资源总数.

其中，virtual_volumes的参数如下

名称类型描述
idstring卷实例资源id.
namestring卷实例资源名称，需符合正则：^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$.
display_namestring卷实例资源别名.
descriptionstring卷实例资源描述.
uidstring卷实例资源uuid.
resource_typestring卷实例资源类型, 例子: storage.afs.v2.volume.
creator_idstring卷实例创建用户id.
owner_idstring卷实例所有者id.
tenant_idstring租户id.
zonestring可用区.
statestring卷实例状态.
sku_idstring最小库存单元id.
tagsobject卷实例资源标签.
propertiesobject卷实例规格属性.
order_infoobject订单信息.
deletedboolean卷实例资源是否删除.
create_timestring卷实例资源创建时间.
update_timestring卷实例资源更新时间.

其中，state有如下情况

状态含义
CREATING创建中(默认值)
UPDATING更新中
ACTIVE已激活
DELETING删除中
DELETED已删除
FAILED失败
EXPIREDOWNGRADING到期降级中
EXPIREDOWNGRADED到期已降级
RENEWUPGRADING续订升级中
EXPIRESTOPPING到期停服中
EXPIRESTOPPED到期已停服
RENEWSTARTING续订恢复中
DOWNGRADING服务降级中
DOWNGRADE服务降级
RESTORING服务降级恢复中

其中，properties的参数如下

名称类型描述
resourcesobject规格属性.

其中，resources的参数如下

名称类型必须默认值取值范围描述
billing_itemsstring否--计费项.

其中，billing_items的参数如下

名称类型必须默认值取值范围描述
capacitystring否--资源容量.
capacity_unitstring否--资源容量单位.

其中，order_info的参数如下

名称类型描述
billing_cycle_numberinteger购买时长.
auto_renewboolean自动续费.
currency_codestring货币代码.
payment_channelstring支付方式.
notestring订单备注.
order_typestring订单类型.
order_idstring订单id.
start_timestring订单生效日期.
payment_modelstring付费类型.
billing_modelstring计费类型.
original_idstring合同包ID.
end_timestring订单结束时间.

其中，payment_channel有如下情况

状态含义
PC_UNSPECIFIED未指定
PC_BALANCE余额支付
PC_CREDIT信用支付
PC_FROZENACCOUNT冻结款支付
PC_REMIT_OFFLINE线下汇款
PC_ALIPAY支付宝支付
PC_UNIONPAY银联支付
PC_REMIT_ONLINE在线转账
PC_CONTRACT合同包支付

其中，order_type有如下情况

状态含义
OT_UNSPECIFIED未指定
OT_ORIGINAL原始订单
OT_RENEW续费订单
OT_UPGRADED升配订单
OT_DOWNGRADED降配订单
OT_CONTRACT合同订单
OT_UNSUBSCRIBE退订订单
OT_RESIZE扩缩容订单

其中，payment_model有如下情况

状态含义
PM_UNSPECIFIED未指定
PM_PREPAID预付
PM_POSTPAID后付费

其中，billing_model有如下情况

状态含义
BM_UNSPECIFIED未指定
BM_USAGE按量计费
BM_MONTHLY包月
BM_YEARLY包年

响应示例（Response Example）​

{
  "id": "/subscriptions/c28f173a-8f18-474c-866b-4ce89a612958/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/faa98576-f5c1-44e1-8a5a-3a2c68c4a78d",
  "name": "faa98576-f5c1-44e1-8a5a-3a2c68c4a78d",
  "display_name": "ly0920",
  "description": "",
  "uid": "2cb51531-5856-11ee-af22-a22980a5cad2",
  "resource_type": "storage.afs.v2.volume",
  "creator_id": "a51b3495-3ba1-4add-b760-3d257e299f37",
  "owner_id": "a51b3495-3ba1-4add-b760-3d257e299f37",
  "tenant_id": "c28f173a-8f18-474c-866b-4ce89a612958",
  "zone": "cn-sh-01a",
  "state": "CREATING",
  "sku_id": "de6c091b-4841-4602-b120-623ee620c8be",
  "tags": {

  },
  "properties": {
    "resources": {
      "billing_items": {
        "capacity": 21,
        "capacity_unit": "GB"
      }
    }
  },
  "order_info": {
    "billing_cycle_number": 8,
    "auto_renew": true,
    "currency_code": "CNY",
    "payment_channel": "PC_UNSPECIFIED",
    "note": "",
    "order_type": "OT_RESIZE",
    "order_id": "37be1968238843224547328",
    "start_time": "2023-09-25T06:18:27Z",
    "payment_model": "PM_PREPAID",
    "billing_model": "BM_MONTHLY",
    "original_id": "",
    "end_time": null,
    "auto_convert_postpaid": false
  },
  "deleted": false,
  "create_time": null,
  "update_time": null
}