文档中心

云数据库 veDB MySQL 版

实例管理

ModifyDBInstanceSpec - 修改实例规格

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

请求类型

异步请求。

注意事项

实例目前没有待执行的配置变更事件，可在计划内事件列表通过实例 ID 搜索查看，操作步骤请参见查看事件列表。

缩减节点个数时，系统默认删除节点 ID 序号大的节点。节点类型不同对连接终端的影响不同：

目标删除节点为主节点

当目标删除节点为主节点时，您需要先切换主节点，建议将节点 ID 序号最小的节点切换成主节点，然后再进行缩减节点个数操作，操作详情请参见切换主节点。

目标删除节点为只读节点

自定义只读终端：若存在自定义只读终端仅关联了要删除的目标只读节点，此时需要先调用 ModifyDBEndpoint 接口为该只读终端关联其他只读节点，不使用时也可以直接调用 DeleteDBEndpoint 接口删除该连接终端，再进行缩减节点个数操作。

自定义读写终端：若存在自定义读写终端关联了主节点和要删除的目标只读节点，缩减只读节点后，该读写终端将不能进行读写分离，导致主节点压力增大。建议在缩减节点个数前为调用 ModifyDBEndpoint 接口该读写终端关联其他只读节点。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-h441603c68aaa****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
PrePaidStorageInGB	Integer	否	60	若存储计费类型为按量计费，则无需选择存储容量，存储容量会随数据量的增减而自动弹性伸缩，根据实际使用量按小时计费。若存储计费类型为包年包月，则需输入变更后的存储空间大小，步长为 10 GiB，单位为 GiB。说明不同的节点规格，存储空间取值范围不同，详情请参见产品规格。
ScheduleType	String	是	Immediate	执行方式，取值： Immediate：立即执行（默认）。 MaintainTime：可维护时间窗口执行。
NodeInfo	Array of NodeInfoObject	否	请参见请求示例。	实例节点规格配置信息。

NodeInfoObject

参数	类型	是否必选	示例值	描述
NodeType	String	是	DBEngine	节点类型。取值： DBEngine：主节点/只读节点。
NodeSpec	String	是	vedb.mysql.x4.large	实例的节点规格代码。说明关于实例节点规格的详细信息，请参见产品规格。
NodeNumber	Integer	是	2	实例的节点数量。当 NodeType 取值为 DBEngine（主节点/只读节点）时，该参数的取值范围为 2~16 个。
ZoneId	String	是	cn-beijing-a	可用区 ID。说明您可以调用 DescribeDBInstanceDetail接口，查询指定实例所在的可用区 ID。

返回参数

参数	类型	示例值	描述
InstanceId	String	vedbm-h441603c68aaa****	实例 ID。
OrderId	String	Order707643373078888****	订单 ID。

示例

请求示例

变更主节点/只读节点。

POST /?Action=ModifyDBInstanceSpec&Version=2024-01-01 HTTP/1.1​
Content-Type: application/json​
Host: vedbm.cn-beijing.volcengineapi.com​
X-Date: 20240101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b76789****​
{​
    "InstanceId": "vedbm-fihrnbtgrmr4",​
    "NodeInfo": [​
        {​
            "ZoneId": "cn-chongqing-a",​
            "NodeNumber": 3,​
            "NodeSpec": "vedb.mysql.x8.large",​
            "NodeType": "DBEngine"​
        }​
    ]​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202407191557433BA18653C86F63A04B1B",​
        "Action": "ModifyDBInstanceSpec",​
        "Version": "2024-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "InstanceId": "vedbm-gzwdsf9b****",​
        "OrderId": "Order725743560891294****"​
    }​
}​

错误码

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

最近更新时间：2026.07.29 11:51:55

这个页面对您有帮助吗？

有用

无用