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

前提条件

实例目前没有待执行的配置变更任务，可在任务中心通过实例 ID 搜索查看，操作步骤请参见查看任务。

注意事项

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

• 目标删除节点为主节点
  当目标删除节点为主节点时，您需要先切换主节点，建议将节点 ID 序号最小的节点切换成主节点，然后再进行缩减节点个数操作，操作详情请参见切换主节点。
• 目标删除节点为只读节点
  • 自定义只读终端：若存在自定义只读终端仅关联了要删除的目标只读节点，此时需要先调用 接口为该只读终端关联其他只读节点，不使用时也可以直接调用 DeleteDBEndpoint 接口删除该连接终端，再进行缩减节点个数操作。
  • 自定义读写终端：若存在自定义读写终端关联了主节点和要删除的目标只读节点，缩减只读节点后，该读写终端将不能进行读写分离，导致主节点压力增大。建议在缩减节点个数前为调用 ModifyDBEndpoint 接口该读写终端关联其他只读节点。

请求类型

异步请求。

请求参数

返回参数

请求示例

• 变更主节点/只读节点。

  POST /?Action=ModifyDBInstanceSpec&Version=2024-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-fihrnbtgrmr4",
      "NodeInfo": [
          {
              "ZoneId": "cn-chongqing-a",
              "NodeNumber": 3,
              "NodeSpec": "vedb.mysql.x8.large",
              "NodeType": "DBEngine"
          }
      ]
  }
  

• 创建、变更分析节点。

  {
      "InstanceId": "vedbm-fihrnbtgrmr4",
      "NodeInfo": [
          {
              "ZoneId": "cn-beijing-a",
              "NodeNumber": 3,
              "NodeSpec": "vedb.mysql.x8.large",
              "NodeType": "APWorkNode"
          }
      ]
  }
  

• 同时变更主节点/只读节点和分析节点配置。

  {
      "InstanceId": "vedbm-fihrnbtgrmr4",
      "NodeInfo": [
          {
              "NodeSpec": "vedb.mysql.x4.large",
              "NodeNumber": 2,
              "NodeType": "DBEngine",
              "ZoneId": "cn-chongqing-a"
          },
          {
              "ZoneId": "cn-chongqing-a",
              "NodeNumber": 2,
              "NodeSpec": "vedb.mysql.x4.large",
              "NodeType": "APWorkNode"
          }
      ]
  }
  

返回示例

正常返回示例

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

错误码

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