FailoverDBCluster_云数据库 PolarDB_API文档

云数据库 PolarDB
产品与服务收起分类
最近访问 - 云产品
热门产品
计算
容器
存储
网络与CDN
安全
中间件
Serverless
开发工具
迁移与运维管理
数据库
大数据计算
人工智能与机器学习
媒体服务
企业服务与云通信
物联网
其他
域名与网站
终端用户计算
未分类
产品与服务
最近访问 - 云产品全球加速运维事件中心
Serverless
应用集成
云工作流
开发工具
API 与工具
资源编排云控制APIOpenAPI 门户开放服务
云效DevOps
云效2020
开发与运维
HTTPDNS
人工智能与机器学习
人工智能平台
模型在线服务 EAS人工智能平台 PAI人工智能平台 PAI - 工作流人工智能平台 PAI - AI 工作空间人工智能平台 PAI - 分布式训练（DLC）人工智能平台 PAI - 用户增长人工智能平台 PAI - 交互式建模智能计算灵骏ITag智能计算灵骏-管控人工智能平台 PAI - 数据集加速器人工智能平台PAI-自动机器学习人工智能平台PAI-推荐全链路深度定制开发平台人工智能平台 PAI - 特征平台
智能搜索与推荐
智能开放搜索 OpenSearch智能推荐开放搜索-问天引擎
视觉智能
图像搜索视觉计算服务智能视觉生产视觉智能开放平台-图像生产视觉智能开放平台-图像识别视觉智能开放平台-目标检测视觉智能开放平台-商品理解视觉智能开放平台-文字识别视觉智能开放平台-内容安全视觉智能开放平台-分割抠图视觉智能开放平台-人脸人体视觉智能开放平台-图像分析处理视觉智能开放平台-视觉搜索视觉智能开放平台-视频理解视觉智能开放平台-视频分割视觉智能开放平台-视频生产文字识别摩观SDK授权服务视觉智能开放平台-操作接口视觉智能开放平台-自学习文档自学习产品视觉智能开放平台-生成专区
自然语言处理
机器翻译NLP自学习平台地址标准化
智能语音交互
智能语音交互
决策智能
优化求解器
AI应用
智能语音导航三维空间重建虚拟数字人开放平台听悟
行业智能
智联车管理云平台基因分析平台智慧教育平台智慧教育平台
智能客服
云联络中心智能对话机器人智能对话分析智能外呼智能双录质检悉犀客服
模型平台与服务
大模型服务平台百炼AI妙笔通义晓蜜CCAI-AIO法睿通义点金百炼全妙轻应用
其他
交付与运维
阿里云健康看板支持计划
其他类目
地址解析
域名与网站
域名与备案服务
域名服务云解析企业服务
云产品主页文档中心工具中心服务广场了解 OpenAPI
AI
中国站
简体中文English
国际站
简体中文English
API变更订阅已开通产品值班交流群满意度问卷
立即登录
2017-08-01
FailoverDBCluster - 对集群进行手动主备切换
获取元数据
对PolarDB集群进行手动主备切换，可以指定一个只读节点为新的主节点。
更新时间: 2025-01-09 09:00
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

流控信息

请求速率为200/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作访问级别资源类型条件关键字关联操作
polardb:FailoverDBCluster
Update
dbcluster
acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}
无无

请求参数

字段名称字段详情
DBClusterIdstring

数据库集群 ID。

示例值:pc-**************参考取值来源:
    ModifyDBCluster
    CreateDBCluster
    DescribeDBClusters
    TransformDBClusterPayType
    EnableDBClusterServerless
    RestartDBLink
    DisableDBClusterServerless
TargetDBNodeIdstring

将要切换为主节点的节点 ID，如果不填，则系统自动选举。您可以通过接口 DescribeDBClusters 查询节点 ID 等信息。展开详情

示例值:pi-***********
RollBackForDisasterboolean

是否是故障切换后的回切至原主可用区，取值范围如下：展开详情

示例值:false
ClientTokenstring

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。

示例值:6000170000591aed949d0f54a343f1a4233c1e7d1c5******
TargetZoneTypestring

是否是主可用区内主备切换，取值如下：展开详情

示例值:Primary枚举值:PrimaryStandby

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:D0CEC6AC-7760-409A-A0D5-E6CD86******

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
HaStatusNotSupport
Current DB instance HA status does not support this operation.诊断
400
InvalidDBNodeId.Malformed
The specified parameter DBNodeId is not valid.诊断
400
InvalidDBType.Malformed
The Specified DBType is not valid.诊断
400
UnsupportHighFrequenceSwitchOver
The instance has switch over too frequent within ten minutes.诊断
400
UnsupportWitchUnhealthyReplication
The action is unsupported with unhealthy replication.诊断
403
OperationDenied.DBNodeType
The operation is not permitted due to type of node.诊断
403
OperationDenied.ClusterCategory
The operation is not permitted due to cluster category.诊断
404
InvalidDBCluster.NotFound
The DBClusterId provided does not exist in our records.诊断
404
InvalidDBClusterId.Malformed
The specified parameter DBClusterId is not valid.诊断

变更历史

变更时间变更内容概要操作
2024-08-20
变更错误码400
2024-08-08
新增请求参数TargetZoneType
2023-12-07
新增请求参数RollBackForDisaster
2023-09-12
变更错误码400
变更错误码403
变更错误码404
2023-06-12
新增错误码403
2022-06-10
新增错误码400
流控信息
授权信息
请求参数
返回参数
返回示例
错误码
变更历史
相关示例