You need to enable JavaScript to run this app.
文档中心
云数据库 veDB MySQL 版

云数据库 veDB MySQL 版

复制全文
下载 pdf
实例管理
ModifyDBInstanceSpec - 修改实例规格
复制全文
下载 pdf
ModifyDBInstanceSpec - 修改实例规格
调用 ModifyDBInstanceSpec 接口修改实例的节点配置。​
请求类型​
异步请求。​
注意事项​
  • 实例目前没有待执行的配置变更事件,可在计划内事件列表通过实例 ID 搜索查看,操作步骤请参见查看事件列表。​
  • 缩减节点个数时,系统默认删除节点 ID 序号大的节点。节点类型不同对连接终端的影响不同:​
  • 目标删除节点为主节点​
  • 当目标删除节点为主节点时,您需要先切换主节点,建议将节点 ID 序号最小的节点切换成主节点,然后再进行缩减节点个数操作,操作详情请参见切换主节点。​
  • 目标删除节点为只读节点​
  • 自定义只读终端:若存在自定义只读终端仅关联了要删除的目标只读节点,此时需要先调用 ModifyDBEndpoint 接口为该只读终端关联其他只读节点,不使用时也可以直接调用 DeleteDBEndpoint 接口删除该连接终端,再进行缩减节点个数操作。​
  • 自定义读写终端:若存在自定义读写终端关联了主节点和要删除的目标只读节点,缩减只读节点后,该读写终端将不能进行读写分离,导致主节点压力增大。建议在缩减节点个数前为调用 ModifyDBEndpoint 接口该读写终端关联其他只读节点。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceId​
String​
是​
vedbm-h441603c68aaa****​
实例 ID。​
说明​
您可以调用 DescribeDBInstances 接口查询实例 ID。​
PrePaidStorageInGB​
Integer​
否​
60​
  • 若存储计费类型为按量计费,则无需选择存储容量,存储容量会随数据量的增减而自动弹性伸缩,根据实际使用量按小时计费。​
  • 若存储计费类型为包年包月,则需输入变更后的存储空间大小,步长为 10 GiB,单位为 GiB。​
说明​
不同的节点规格,存储空间取值范围不同,详情请参见产品规格。​
ScheduleType​
String​
是​
Immediate​
执行方式,取值:​
  • Immediate:立即执行(默认)。​
  • MaintainTime:可维护时间窗口执行。​
NodeInfo​
Array of NodeInfoObject​
否​
请参见请求示例。​
实例节点规格配置信息。​
​
NodeInfoObject​
​
参数​
类型​
是否必选​
示例值​
描述​
NodeType​
String​
是​
DBEngine​
节点类型。取值:​
DBEngine:主节点/只读节点。​
NodeSpec​
String​
是​
vedb.mysql.x4.large​
实例的节点规格代码。​
说明​
关于实例节点规格的详细信息,请参见产品规格。
NodeNumber​
Integer​
是​
2​
实例的节点数量。​
当 NodeType 取值为 DBEngine(主节点/只读节点) 时,该参数的取值范围为 2~16 个。​
ZoneId​
String​
是​
cn-beijing-a​
可用区 ID。​
说明​
您可以调用 DescribeDBInstanceDetail接口,查询指定实例所在的可用区 ID。
​
返回参数​
​
参数​
类型​
示例值​
描述​
InstanceId​
String​
vedbm-h441603c68aaa****​
实例 ID。​
OrderId​
String​
Order707643373078888****​
订单 ID。​
​
示例​
请求示例​
变更主节点/只读节点。​
​
POST /?Action=ModifyDBInstanceSpec&Version=2024-01-01 HTTP/1.1​
Content-Type: application/json​
Host: vedbm.cn-beijing.volcengineapi.com​
X-Date: 20240101T101010Z​
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"​
}​
]​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202407191557433BA18653C86F63A04B1B",​
"Action": "ModifyDBInstanceSpec",​
"Version": "2024-01-01",​
"Service": "vedbm",​
"Region": "cn-beijing"​
},​
"Result": {​
"InstanceId": "vedbm-gzwdsf9b****",​
"OrderId": "Order725743560891294****"​
}​
}​
​
错误码​
更多详情,请参见错误码。​
最近更新时间:2026.07.29 11:51:55
这个页面对您有帮助吗?
有用
有用
无用
无用