调用 ModifyDBInstanceSpec 接口修改指定 veDB MySQL 实例的节点配置。

请求类型

异步请求。

调试

前提条件

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

使用限制

2022-01-01 版本的 ModifyDBInstanceSpec 接口仅适用于内核版本为 3.0.*.* 的实例。3.1.*.* 和 3.2.*.* 的实例请使用 2024-01-01 版本的 ModifyDBInstanceSpec 接口。关于实例内核版本的查看方法请参见查看实例版本。

注意事项

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

• 目标删除节点为主节点

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

• 目标删除节点为只读节点

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

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

请求参数

返回参数

请求示例

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

{
        "InstanceId": "vedbm-gzwdsf9b****",
        "NodeSpec": "vedb.mysql.x4.large",
        "NodeNumber": 2
}

返回示例

正常返回示例

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

错误码

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