You need to enable JavaScript to run this app.
导航
ModifyDBInstanceSpec
最近更新时间:2024.08.28 10:56:53首次发布时间:2024.08.22 10:35:41

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

前提条件

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

注意事项

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

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

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述

InstanceId

String

vedbm-h441603c68aaa****

实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询实例 ID。

NodeInfoArray of NodeInfoObject请参见请求示例。实例节点规格配置信息。关于 NodeInfo 的更多详情,请参见 NodeInfoObject

PrePaidStorageInGB

Integer

60

  • 若存储计费类型为按量计费,则无需选择存储容量,存储容量会随数据量的增减而自动弹性伸缩,根据实际使用量按小时计费。
  • 若存储计费类型为包年包月,则需输入变更后的存储空间大小,步长为 10GiB,单位为 GiB。

说明

不同的节点规格,存储空间取值范围不同,详情请参见产品规格

返回参数

名称类型示例值描述
InstanceIdStringvedbm-h441603c68aaa****实例 ID。
OrderIdStringOrder707643373078888****订单 ID。

请求示例

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

    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****"
    }
}

错误码

更多详情,请参见错误码