查询磁盘自动扩容策略-QueryingtheAutoscalingPolicyofStorageSpace

功能介绍

查询磁盘自动扩容策略。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
dds:instance:getAutoEnlargeVolumePolicy
read
instance
g:EnterpriseProjectId
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
dds:instance:getAutoEnlargeVolumePolicy	read	instance	g:EnterpriseProjectId	-	-

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	Object	参数解释：磁盘自动扩容策略。详情请参见表4。取值范围：不涉及。

表4 DiskAutoExpansionPolicy
参数	参数类型	描述
instance_id	String	参数解释：实例ID。取值范围：不涉及。
threshold	Integer	参数解释：触发自动扩容阈值，只支持输入80、85和90。默认阈值为90，即当已使用存储空间达到总存储空间的90%时就会触发扩容。集群实例的自动扩容阈值指的是每个shard。取值范围： 80、85和90。
step	Integer	参数解释：扩容步长（s%），默认为10，支持输入10、15和20。当触发自动扩容的时候，自动扩容当前存储空间的s%（非10倍数向上取整。小数点后四舍五入，默认一次最小10G，账户余额不足时，会导致包年包月实例扩容失败）。取值范围： 10、15和20。
size	Integer	参数解释：最大扩容上限，即当自动扩容达到上限后不再触发自动扩容。取值范围：实例规格小于8U时，自动扩容上限为5000GB；大于等于8U时，自动扩容上限为10000GB。

状态码： 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" : "on",
     "policy" : {  
       "instance_id" : "93e4b3eda14349b1b870f72829bc3b9bin02", 
       "threshold" : 90,   
       "step" : 10,   
       "size" : 5000  
     } 
}