强制备节点升主-ForciblyPromotingaSecondaryNodetoPrimary

接口说明

支持副本集、shard和config备节点强制升主。

约束说明

在主备时延较大的情况下不保证成功。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  dds:instance:switchover	write	instance	g:EnterpriseProjectId	-	-

URI

• URI格式

  POST /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/primary

• URI样例
  https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/b54ea2b393034728b8582e1c4b5b4c88in02/nodes/639371286e95457394914f734e1ed6feno02/primary

  表1 请求参数

  参数	是否必选	参数类型	描述
  X-Auth-Token	是	String	从IAM服务获取的用户Token。请参考认证鉴权。
  project_id	是	String	租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。
  instance_id	是	String	实例ID，可以调用“查询实例列表和详情-QueryingInstancesandDetails”接口获取。如果未申请实例，可以调用“创建实例-CreatingaDBInstance”接口创建。
  node_id	是	String	备节点ID。

请求消息

• 参数说明

  无。

• 请求示例

  无。

响应消息

• 参数说明

  无。

• 响应示例

  无。

状态码

详情请参见状态码。

错误码

详情请参见错误码。