文档首页/ 文档数据库服务 DDS/ API参考/ API v3（推荐）/ 实例管理/ 查询磁盘自动扩容策略
更新时间：2024-11-29 GMT+08:00
查看PDF
分享

查询磁盘自动扩容策略

功能介绍

查询磁盘自动扩容策略。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/{project_id}/instances/{instance_id}/auto-enlarge-volume-policy
表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

instance_id

是

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。请参考认证鉴权。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

switch_option

String

自动扩容开关。

  • on：开启磁盘自动扩容策略。
  • off: 关闭磁盘自动扩容策略。

    默认值为on。

policy

Array of objects

磁盘自动扩容策略。详情请参见表4。
表4 DiskAutoExpansionPolicy

参数

参数类型

描述

instance_id

String

实例ID。

threshold

Integer

触发自动扩容阈值，只支持输入80、85和90。默认阈值为90，即当已使用存储空间达到总存储空间的90%时就会触发扩容。集群实例的自动扩容阈值指的是每个shard。

step

Integer

扩容步长（s%），默认为10，支持输入10、15和20。当触发自动扩容的时候，自动扩容当前存储空间的s%（非10倍数向上取整。小数点后四舍五入，默认一次最小10G，账户余额不足时，会导致包年包月实例扩容失败）。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/93e4b3eda14349b1b870f72829bc3b9bin02/auto-enlarge-volume-policy

响应示例

状态码： 200
Success
{ 
  "switch_option" : "off", 
  "policy" : { 
    "instance_id" : "93e4b3eda14349b1b870f72829bc3b9bin02", 
    "threshold" : 90, 
    "step" : 10 
  } 
}

状态码

状态码

描述

200

Success

400

Client error.

500

Server error.

错误码

详情请参见错误码。

父主题： 实例管理

相关文档