# 变更实例规格 - ChangingthevCPUsandMemoryofaDBInstance
#### 功能介绍
通过调用该接口提升实例的CPU和内存。
- 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。
- 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。
 
#### 接口约束
- 规格变更前，须确保实例状态正常。实例异常，节点异常均不允许进行规格变更。
- 新规格和旧规格的操作系统架构必须相同。
- 修改CPU\|内存后，将会重启数据库实例，重启后实例会自动释放内存中的缓存，请在业务低峰期进行重启，避免对高峰期业务造成影响。
- 规格变更过程中会进行主备倒换。
- 单副本的部署形态下，规格变更过程中会进行中断重启，中断重启过程中会有5\~10min的业务中断。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=GaussDBforopenGauss&api=ResizeInstanceFlavor)中调试该接口。
#### URI
PUT /v3/{project_id}/instance/{instance_id}/flavor
表1参数说明 
| 名称          | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| project_id  | 是    | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| instance_id | 是    | **参数解释：** 实例ID，此参数是用户创建实例的唯一标识。请参考[查询数据库实例列表 - QueryingDBInstances](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_328.html)接口获取实例ID。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为36个字符。 **默认取值** **：** 不涉及。 |
   
#### 请求参数
表2参数说明 
| 名称          | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| flavor_ref  | 是    | String  | **参数解释：** 规格变更的新规格的资源规格编码。参考[表1](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_199.html#ZH-CN_TOPIC_0000001977386662__table3323153222911)中的"规格编码"列内容获取。 参考[查询数据库规格 - QueryingInstanceSpecifications](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_084.html)中"spec_code"字段获取。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值** **：** 不涉及。 |
| is_auto_pay | 否    | Boolean | **参数解释：** 包周期实例时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。 **约束限制：** 不涉及。 **取值范围：** - true，表示自动从账户中支付。  - false，表示手动从账户中支付，默认为该方式。   **默认取值** **：** false                                           |
   
#### 响应参数
表3响应参数说明 
| 名称       | 参数类型   | 说明                                                                                                                                                                                                 |
|:---|:---|:---|
| job_id   | String | **参数解释：** 规格变更的任务ID，仅变更按需实例时会返回该参数。 **取值范围：** 不涉及。 |
| order_id | String | **参数解释：** 订单ID，仅变更包周期实例会返回该参数。 **取值范围：** 不涉及。     |
   
#### 请求示例
变更按需实例的规格，变更为16U128G。
```
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instance/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in" 
 }
```
变更包周期实例的规格，从8U64G变更为16U128G。
```
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instance/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in",
        "is_auto_pay":true
 }
```
#### 响应示例
变更实例规格成功。
```
{
"job_id": "2b414788a6004883a02390e2eb0ea227"
}
```
#### 状态码
- 正常 202
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。