# 变更堡垒机实例 - ResizeInstance #### 功能介绍 变更云堡垒机实例。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cbh/cbh_02_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbh/cbh_02_00015.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cbh:instance:alterInstance | Write | instance \* | - g:EnterpriseProjectId - g:ResourceTag/tag-key | - | evs:quotas:get | #### URI PUT /v2/{project_id}/cbs/instance 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，用于唯一标识用户项目。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbh/cbh_02_0020.html)。 **约束限制**： 不涉及 **取值范围**： 只能由字母和数字组成，长度为32个字符。 **默认取值**： 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取方法请参见[获取用户Token](https://support.huaweicloud.com/api-cbh/cbh_02_0010.html)。 **约束限制**： 不涉及 **取值范围**： 字符串，长度为1\~28000个字符。 **默认取值**： 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | server_id | 是 | String | 云堡垒机实例ID，使用UUID格式表示。 | | new_resource_spec_code | 否 | String | 待变更云堡垒机规格ID，例如： - cbh.basic.50 - cbh.enhance.50 可参考接口[查询云堡垒机规格信息](https://support.huaweicloud.com/api-cbh/ListSpecifications.html)获取。 | | attach_disk_size | 否 | Integer | 附加磁盘大小。单位TB 说明： 附加磁盘和规格自带磁盘大小不能超过300TB。 | | is_auto_pay | 否 | Integer | 是否自动支付，下单订购后，是否自动从客户的客户云账户中支付，而不需要客户手动去进行支付。 - 1：是（会自动选择折扣和优惠券进行优惠，然后自动从客户云账户中支付），自动支付失败后会生成订单成功(该订单应付金额是优惠后金额)、但订单状态为"待支付"，等待客户手动支付(手动支付时，客户还可以修改系统自动选择的折扣和优惠券) - 0：否（需要客户手动去支付，客户可以选择折扣和优惠券。） 默认值为"0"。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | order_id | String | 订单ID。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 请求参数错误。 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 校验Token失败。 | **状态码：403** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 租户无权限操作。 | **状态码：404** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 没有找到CBH资源。 | #### 请求示例 变更堡垒机实例请求示例 ``` { "server_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "new_resource_spec_code" : "cbh.basic.50", "attach_disk_size" : 1, "is_auto_pay" : 1 } ``` #### 响应示例 **状态码：200** ``` { "order_id" : "CS22xxx82xx5AssGxxx" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | Create Alter Task Success | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cbh/ErrorCode.html)。