Todos os produtos
Search
Central de documentação

:Transferir cargas de trabalho para a instância de destino

Última atualização: Jun 26, 2026

Chame a operação ActivateMigrationTargetInstance para transferir cargas de trabalho para uma instância do ApsaraDB RDS for PostgreSQL.

Pré-requisitos

Antes de chamar a operação ActivateMigrationTargetInstance, crie uma tarefa de migração para a nuvem com a operação CreateCloudMigrationTask. Além disso, verifique se o valor retornado para o parâmetro MigrateStage na chamada da operação DescribeCloudMigrationResult é increment.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ActivateMigrationTargetInstance

Operação a ser executada. Defina o valor como ActivateMigrationTargetInstance.

DBInstanceName

String

Sim

pgm-bp102g323jd4****

ID da instância do ApsaraDB RDS for PostgreSQL. Chame a operação DescribeDBInstances para consultar o ID da instância.

SwitchTime

String

Não

2022-02-25T06:57:41Z

Parâmetro reservado. Este parâmetro não tem efeito.

SwitchTimeMode

String

Não

0

Momento para realizar o switchover.

Defina o valor como 0. O valor 0 especifica um switchover imediato.

ForceSwitch

String

Não

1

Especifica se o switchover deve ser forçado. Defina o valor como 1. O valor 1 especifica um switchover forçado.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DBInstanceName

String

pgm-bp102g323jd4****

Nome da instância do ApsaraDB RDS for PostgreSQL.

RequestId

String

76364A52-E0AB-5CC8-9818-CF1DC482C092

ID da solicitação.

TaskId

Long

440913675

ID da tarefa.

SourceIpAddress

String

172.16.XX.XX

Endereço IP privado ou público usado para conectar à instância auto-gerenciada do PostgreSQL.

SourcePort

Long

5432

Número da porta usada para conectar à instância auto-gerenciada do PostgreSQL.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ActivateMigrationTargetInstance
&DBInstanceName=pgm-bp102g323jd4****
&SwitchTime=2022-02-25T06:57:41Z
&SwitchTimeMode=0
&ForceSwitch=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ActivateMigrationTargetInstanceResponse>
    <DBInstanceName>pgm-bp102g323jd4****</DBInstanceName>
    <RequestId>76364A52-E0AB-5CC8-9818-CF1DC482C092</RequestId>
    <TaskId>440913675</TaskId>
    <SourceIpAddress>172.16.XX.XX</SourceIpAddress>
    <SourcePort>5432</SourcePort>
</ActivateMigrationTargetInstanceResponse>

Formato JSON

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

{
  "DBInstanceName" : "pgm-bp102g323jd4****",
  "RequestId" : "76364A52-E0AB-5CC8-9818-CF1DC482C092",
  "TaskId" : 440913675,
  "SourceIpAddress" : "172.16.XX.XX",
  "SourcePort" : 5432
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

IncorrectDBInstanceState

The current instance state does not support this operation.

Mensagem de erro retornada porque a operação não é compatível com o estado atual da instância.

403

IncorrectDBInstance

The current DB instance does not support this operation.

Mensagem de erro retornada porque a instância não oferece suporte à operação.

403

IncorrectDBInstanceType

The database instance type does not support the operation.

Mensagem de erro retornada porque o mecanismo de banco de dados da instância não oferece suporte à operação.

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

Mensagem de erro retornada porque o nome da instância especificado não foi encontrado. Verifique o nome da instância e tente novamente.

404

IncorrectDBInstanceLockMode

Current DB instance lock mode does not support this operation.

Mensagem de erro retornada porque a instância está bloqueada.

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