ModifyDBFailover--云数据库 SQL Server 版-火山引擎

文档中心

立即注册

导航

ModifyDBFailover

最近更新时间：2025.06.04 11:23:25首次发布时间：2025.06.03 10:21:05

调用 ModifyDBFailover 接口手动切换主备节点。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
InstanceId	String	是	mssql-3373999a****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
NodeId	String	是	mssql-3373999a****-0	备节点 ID。说明您可以调用 DescribeDBInstances 接口查询备节点 ID。

返回参数

null

请求示例

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
}

错误码

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