ModifyDBInstanceSpec--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

ModifyDBInstanceSpec

最近更新时间：2025.05.20 17:25:35首次发布时间：2023.02.02 17:41:21

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

请求类型

异步请求。

注意事项

该接口已弃用。请使用以下接口变更实例配置：

调用 CreateDBNodes 接口为实例增加节点。
调用 ModifyDBNodeSpec 接口变更实例的节点规格和存储空间。
调用 DeleteDBNodes 接口为实例删除节点。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-e26822cf****	实例 ID。
NodeInfo	Object[]	否	[ { "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" } ]	实例规格配置。主节点和备节点有且只有 1 个，只读节点可选 0~10 个。除新增只读节点场景外，其他场景忽略 ZoneId。说明该参数与 StorageSpace 二者必选其一，且这两个参数可同时修改。云数据库 MySQL 版支持将主节点、备节点创建在不同可用区，但只读节点必须添加在主节点或备节点的可用区。
ModifyType	String	否	Usually	实例规格的变更类型。取值为 `Usually`，常规变配。
StorageType	String	是	LocalSSD	实例存储类型。取值为 `LocalSSD`，表示本地 SSD 盘。说明如需设定 StorageSpace 参数，StorageType 参数为必传。
StorageSpace	Integer	否	100	实例存储空间。取值范围：[20, 3000]，单位为 GB，步长为 10GB。默认与当前值相同。说明该参数与 NodeInfo 二者必选其一，且这两个参数可同时修改。
SwitchType	String	否	MaintainTime	执行时间，取值： `Immediate`：立即切换（默认）。 `MaintainTime`：可维护时间段内进行切换。 `SpecifiedTime`：指定时间段内进行切换。说明取值为 `SpecifiedTime` 时，需要在参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime 中设定时间段的起止时间。
SpecifiedSwitchStartTime	String	否	2024-12-25T14:00:00Z	指定时间段执行时时间段的起始时间。时间格式为 `yyyy-MM-ddTHH:mm:ssZ`。说明 SwitchType 取值为 `SpecifiedTime` 时，该参数为必填参数。
SpecifiedSwitchEndTime	String	否	2024-12-25T15:59:00Z	指定时间段执行时时间段的结束时间。时间格式为 `yyyy-MM-ddTHH:mm:ssZ`。说明 SwitchType 取值为 `SpecifiedTime` 时，该参数为必填参数。指定时间段的最短时长为一小时五十九分钟。

返回参数

参数	类型	示例值	描述
InstanceId	String	mysql-7d1efb9f****	实例 ID。
OrderId	String	Order71220115095297****	订单 ID。

示例

请求示例

POST /?Action=ModifyDBInstanceSpec&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "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****"
    }
}

错误码

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