文档中心

云数据库 veDB MySQL 版

请输入

实例管理

ChangeMaster - 更改数据库集群主节点

调用 ChangeMaster 接口切换主节点。

请求类型

异步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
ClusterName	String	是	vedbm-gzwdsf9b****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
TargetNode	String	是	vedbm-gzwdsf9b****-0	需要切换为主节点的只读节点 ID。说明必须传入只读节点的 ID，即 NodeType 取值为 ReadOnly，您可调用 DescribeDBInstanceDetail 接口查询指定实例的详细信息。

返回参数

null

示例

请求示例

POST /?Action=ChangeMaster&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host:vedbm.cn-beijing.volcengineapi.com​
X-Date: 20220101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "ClusterName": "vedbm-gzwdsf9b****",​
    "TargetNode": "vedbm-gzwdsf9b****-0"​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20230719180652433CAFB3959A26A24EFA",​
        "Action": "ChangeMaster",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": null​
}​

错误码

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

最近更新时间：2026.02.25 13:20:56

这个页面对您有帮助吗？

有用

无用