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

云数据库 SQL Server 版

复制全文
下载 pdf
实例管理
ModifyDBFailover - 手动切换主备节点
复制全文
下载 pdf
ModifyDBFailover - 手动切换主备节点
调用 ModifyDBFailover 接口手动切换主备节点。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:ModifyDBFailover​
要执行的操作,取值:ModifyDBFailover。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
InstanceId string 必选 示例值:mssql-3373999a****​
实例 ID。​
说明​
您可以调用 DescribeDBInstances 接口查询实例 ID。​
​
NodeId string 必选 示例值:mssql-3373999a****-0​
备节点 ID。​
说明​
您可以调用 DescribeDBInstances 接口查询备节点 ID。​
​
​
返回参数​
本接口无特有的返回参数。更多信息请见返回结构。​
请求示例​
​
POST /?Action=ModifyDBFailover&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: rds-mssql.cn-beijing.volcengineapi.com​
X-Date: 20230131T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mssql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"InstanceId":"mssql-3373999a****",​
"NodeId":"mssql-3373999a****-0"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202505121136416A7BF07596FDEC2F4629-d8e5a7",​
"Action": "ModifyDBFailover",​
"Version": "2022-01-01",​
"Service": "rds_mssql",​
"Region": "cn-beijing"​
},​
"Result": null​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidParameter​
The specified parameter %s is not valid.​
参数 {parameter1} 值无效。​
​
​
最近更新时间:2025.12.01 18:11:12
这个页面对您有帮助吗?
有用
有用
无用
无用