You need to enable JavaScript to run this app.
导航
ModifyDBInstanceSpec
最近更新时间:2024.02.27 10:08:47首次发布时间:2023.07.26 13:58:16

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

注意事项

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

  • 目标删除节点为主节点

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

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

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

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

请求类型

异步请求。

请求参数

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

InstanceId

String

vedbm-h441603c68aaa****

实例 ID。

说明

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

NodeSpec

String

vedb.mysql.x4.large

节点规格代码。

说明

关于实例节点规格的详细信息,请参见产品规格

NodeNumberInteger6实例的节点数量,取值范围为 2~16 个。

PrePaidStorageInGB

Integer

60

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

说明

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

返回参数

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

请求示例

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

错误码

更多详情,请参见错误码