# 变更数据库实例的规格 - StartResizeFlavorAction #### 功能介绍 变更数据库实例规格。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=RDS&api=StartResizeFlavorAction)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | rds:instance:modifySpec | write | - | - | - | - | #### 接口约束 - RDS for MySQL变更规格耗时及对业务的影响，请参见[手动变更实例的CPU和内存规格](https://support.huaweicloud.com/usermanual-rds-mysql/zh-cn_topic_scale_rds.html)。 - RDS for PostgreSQL变更规格耗时及对业务的影响，请参见[变更实例的CPU和内存规格](https://support.huaweicloud.com/usermanual-rds-pg/rds_pg_scale_rds.html)。 - RDS for SQL Server变更规格耗时及对业务的影响，请参见[变更实例的CPU和内存规格](https://support.huaweicloud.com/usermanual-rds-mssql/rds_sqlserver_scale_rds.html)。 - 需要变更的数据库实例规格不能与原数据库实例规格一样。 - 实例状态仅为"正常"时可以进行调整CPU/内存。 - 只能变更相同类型数据库实例的规格。（例如，单实例只能变更为单实例对应的规格，不能变更为HA的规格）。 - RDS for MySQL本地盘规格变更时，变更后的目标规格的存储上限不能小于当前实例规格的存储空间。 #### URI - URI格式 POST /v3/{*project_id* }/instances/{*instance_id*}/action - 参数说明 表1参数说明 | 名称 | 是否必选 | 说明 | |:---|:---|:---| | project_id | 是 | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | instance_id | 是 | **参数解释：** 实例ID。 可调用[查询数据库实例列表](https://support.huaweicloud.com/api-rds/rds_01_0004.html)接口，通过[表4](https://support.huaweicloud.com/api-rds/rds_01_0004.html#rds_01_0004__table2058713718267)中的"id"获取。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求消息 表2参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | resize_flavor | 是 | Object | **参数解释：** 规格变更信息，请参见[表3]。 **约束限制**： 不涉及。 | 表3resize_flavor字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | spec_code | 是 | String | **参数解释：** 资源规格编码。例如：rds.mysql.m1.xlarge。其中，rds代表RDS产品，mysql代表数据库引擎，m1.xlarge代表性能规格，为高内存类型。带"rr"的表示只读实例规格，反之表示单实例和HA实例规格。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询数据库规格](https://support.huaweicloud.com/api-rds/rds_06_0002.html)接口，通过[表3](https://support.huaweicloud.com/api-rds/rds_06_0002.html#rds_06_0002__table66531170)中的"spec_code"获取。 **默认取值**： 不涉及。 | | is_auto_pay | 否 | Boolean | **参数解释：** 变更包周期实例的规格时可指定，表示是否自动从客户的账户中支付。 **约束限制**： 不涉及。 **取值范围**： - true，为自动支付。 - false，为手动支付，默认该方式。 **默认取值**： false | | is_delay | 否 | Boolean | **参数解释：** 是否进行定时规格变更。 **约束限制**： 该参数目前仅支持MySQL。 **取值范围**： - true，为定时变更，将在运维时间窗内进行变更操作。 - false，为即时变更，默认该方式。 **默认取值**： false | #### 请求示例 - 变更MySQL数据库实例的规格为rds.mysql.m1.xlarge。 ``` POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "resize_flavor": { "spec_code": "rds.mysql.m1.xlarge", "is_auto_pay": true, "is_delay": true } } ``` - 变更PostgreSQL数据库实例的规格为rds.pg.c2.medium.ha。 ``` { "resize_flavor": { "spec_code": "rds.pg.c2.medium.ha", "is_auto_pay": true } } ``` - 变更SQL Server数据库实例的规格为rds.mssql.2014.se.s3.large.2。 ``` { "resize_flavor": { "spec_code": "rds.mssql.2014.se.s3.large.2", "is_auto_pay": true } } ``` #### 响应消息 - **按需实例** - 正常响应要素说明 表4要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | job_id | String | **参数解释：** 任务ID。 **取值范围**： 不涉及。 | - 正常响应样例 ``` { "job_id": "2b414788a6004883a02390e2eb0ea227" } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 - **包周期实例** - 正常响应要素说明 表5要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | order_id | String | **参数解释：** 订单ID。 **取值范围**： 不涉及。 | - 正常响应样例 ``` { "order_id": "CS2009151216NO2U1" } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 202 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。