You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

ModifyDBInstanceSpec

最近更新时间：2023.12.04 15:06:11

首次发布时间：2023.02.02 17:41:21

我的收藏

调用 ModifyDBInstanceSpec 接口修改实例配置。

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述
InstanceIdString是mysql-e26822cf****实例 ID。

NodeInfo

Array of NodeInfoObject

否

[
{
"NodeId": "mysql-7d1efb9f****-0",
"NodeType": "Primary",
"NodeSpec": "rds.mysql.1c2g",
"NodeOperateType": "Modify"
},
{
"NodeId": "mysql-7d1efb9f****-1",
"NodeType": "Secondary",
"NodeSpec": "rds.mysql.1c2g",
"NodeOperateType": "Modify"
},
{
"NodeId": "mysql-7d1efb9f****-r****",
"NodeType": "ReadOnly",
"NodeSpec": "rds.mysql.1c2g",
"NodeOperateType": "Delete"
},
{
"NodeType": "ReadOnly",
"NodeSpec": "rds.mysql.1c2g",
"NodeOperateType": "Create"
},
{
"NodeId": "mysql-7d1efb9f****-r****",
"NodeType": "ReadOnly",
"NodeSpec": "rds.mysql.1c2g",
"NodeOperateType": "Modify"
}
]

实例规格配置。Primary 节点有且只有 1 个，Secondary 节点有且只有 1 个，Read-Only 节点可选 0~10 个。除新增只读节点场景外，其他场景忽略 ZoneId。更多关于 NodeInfo 信息，请参见数据结构。

说明

说明：该参数与 StorageSpace 二者必选其一，且此二参数可同时修改。

ModifyType

String

否

Temporary

实例规格的变更类型。取值为：

  • Usually：常规变配（默认）。
  • Temporary：临时升配。

RollbackTime

String

否

2022-01-01T10:10:10Z

临时升配的还原时间。当ModifyType 取值为 Temporary 时必选。还原时间的设置应满足以下规则：

  • 格式为 UTC 格式。
  • 支持设置在未来的 5 天到 30 天内。
  • 时间点应为调用接口的 UTC 时间加临时升配的天数，前后各允许两分钟的误差。

StorageType

String

否

LocalSSD

实例存储类型。当传入 StorageSpace 参数时，该参数必传。取值：
LocalSSD - 本地 SSD 盘。

说明

当 ModifyType 取值为 Temporary 时，不支持设置 StorageType。

StorageSpace

Integer

否

100

实例存储空间。取值范围：[20, 3000]，单位：GB，步长为 10GB。默认与当前值相同。

说明

  • 该参数与 NodeInfo 二者必选其一，且此二参数可同时修改。
  • 当 ModifyType 取值为 Temporary 时，不支持修改 StorageSpace。

返回参数

名称类型示例值描述
InstanceIdStringmysql-7d1efb9f****实例 ID。
OrderIdStringOrder71220115095297****订单 ID。

请求示例

POST /?Action=ModifyDBInstanceSpec&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****

{
    "InstanceId" : "mysql-f4cba23f****",
    "NodeInfo" : [
        {
            "NodeId": "mysql-f4cba23f****-0",
            "NodeType": "Primary",
            "NodeSpec": "rds.mysql.2c4g",
            "NodeOperateType": "Modify"
        },
        {
            "NodeId": "mysql-f4cba23f****-1",
            "NodeType": "Secondary",
            "NodeSpec": "rds.mysql.2c4g",
            "NodeOperateType": "Modify"
        },
        {
            "ZoneId" : "cn-beijing-a",
            "NodeType": "ReadOnly",
            "NodeSpec": "rds.mysql.2c4g",
            "NodeOperateType": "Create"
        }
    ],
    "StorageType":"LocalSSD",
    "StorageSpace":200
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "20220719173634010212035227001977AC",
        "Action": "ModifyDBInstanceSpec",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "InstanceId": "mysql-f4cba23f****",
        "OrderId": "Order71220115095297****"
    }
}

错误码

更多详情，请参见错误码。