You need to enable JavaScript to run this app.
导航
云数据库 veDB MySQL 版
  • 文档首页
    • /
  • 云数据库 veDB MySQL 版

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

节点规格代码。

说明

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

NodeNumberInteger是6实例的节点数量，取值范围为 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****"
    }
}

错误码

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