Todos os produtos
Search
Central de documentação

:Alternar uma instância primária para uma instância de recuperação de desastres

Última atualização: Jun 26, 2026

Chame a operação ReceiveDBInstance para alternar uma instância primária para uma instância de recuperação de desastres.

Pré-requisitos

Uma instância de recuperação de desastres já deve ter sido criada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter

Type

Required

Example

Description

Action

String

Yes

ReceiveDBInstance

A operação que você deseja executar. Defina o valor como ReceiveDBInstance.

DBInstanceId

String

Yes

rm-uf6wjk5*

O ID da instância primária. Chame a operação DescribeDBInstances para consultar o ID da instância primária.

GuardDBInstanceId

String

Yes

rm-tr2whku*

O ID da instância de recuperação de desastres. Chame a operação DescribeDBInstances para consultar o ID da instância de recuperação de desastres.

Parâmetros de resposta

Parameter

Type

Example

Description

GuardDBInstanceId

String

rm-tr2whku*

O ID da instância de recuperação de desastres após a alternância.

RequestId

String

EFB6083A-7699-489B-8278-C0CB4793A96E

O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=ReceiveDBInstance
&DBInstanceId=rm-uf6wjk5*****
&GuardDBInstanceId=rm-tr2whku*****
&Common request parameters

Exemplos de resposta com sucesso

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<ReceiveDBInstanceResponse>
    <RequestId>19806A9E-28A5-5C2F-BE0E-5BE2A4063B74</RequestId>
    <GuardDBInstanceId>rm-bp1**************</GuardDBInstanceId>
</ReceiveDBInstanceResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "19806A9E-28A5-5C2F-BE0E-5BE2A4063B74",
  "GuardDBInstanceId" : "rm-bp1**************"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

GuardInstance.Exist

The guard instance has exist.

A instância de recuperação de desastres já existe.

Para obter uma lista de códigos de erro, acesse o API Error Center.