Crie tarefa de migração para a nuvem - : Central de Documentação do Alibaba Cloud

Pré-requisitos

Antes de usar esta operação, verifique se a instância do ApsaraDB RDS for PostgreSQL foi aprovada na avaliação de migração para a nuvem.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. O OpenAPI Explorer 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	CreateCloudMigrationTask	Operação a ser executada. Defina o valor como CreateCloudMigrationTask.
DBInstanceName	String	Sim	pgm-bp102g323jd4****	ID da instância do ApsaraDB RDS for PostgreSQL. Use a operação DescribeDBInstances para consultar o ID da instância.
SourceIpAddress	String	Sim	172.16.XX.XX	Endereço IP privado ou público usado para conectar à instância autogerenciada do PostgreSQL. Se a instância autogerenciada do PostgreSQL estiver em uma instância do Elastic Compute Service (ECS), insira o endereço IP privado da instância do ECS. Para mais informações, consulte Visualizar endereços IP. Se a instância autogerenciada do PostgreSQL estiver em um data center local, insira o endereço IP privado desse data center. Se a instância autogerenciada do PostgreSQL estiver em um dispositivo conectado à Internet, insira o endereço IP público do dispositivo.
SourcePort	Long	Sim	5432	Número da porta usada para conectar à instância autogerenciada do PostgreSQL. Execute o comando `netstat -a grep PGSQL` para obter o número da porta.
SourceAccount	String	Sim	migratetest	Nome de usuário da conta usada na migração para a nuvem. Para mais informações, consulte Criar uma conta para migração para a nuvem em uma instância autogerenciada do PostgreSQL.
SourcePassword	String	Sim	123456	Senha da conta mencionada. Para mais informações, consulte Criar uma conta para migração para a nuvem em uma instância autogerenciada do PostgreSQL.
TaskName	String	Não	362c6c7a-4d20-4eac-898c-1495ceab374c	Nome da tarefa. Especifique um nome personalizado. Caso contrário, o ApsaraDB RDS gerará automaticamente um nome para a tarefa.
SourceCategory	String	Sim	ecsOnVpc	Ambiente de execução da instância autogerenciada do PostgreSQL. idcOnVpc: a instância autogerenciada do PostgreSQL reside em um data center local com comunicação habilitada para a Virtual Private Cloud (VPC) da instância do ApsaraDB RDS for PostgreSQL. ecsOnVpc: a instância autogerenciada do PostgreSQL reside em uma instância do ECS. internet: a instância autogerenciada do PostgreSQL reside em um dispositivo conectado à Internet.

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	8B993DA9-5272-5414-94E3-4CA8BA0146C2	ID da solicitação.
TaskId	Long	440437220	ID da tarefa.
TaskName	String	362c6c7a-4d20-4eac-898c-1495ceab374c	Nome da tarefa.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=CreateCloudMigrationTask
&DBInstanceName=pgm-bp102g323jd4****
&SourceIpAddress=172.16.XX.XX
&SourcePort=5432
&SourceAccount=migratetest
&SourcePassword=123456
&TaskName=362c6c7a-4d20-4eac-898c-1495ceab374c
&SourceCategory=ecsOnVpc
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateCloudMigrationTaskResponse>
    <DBInstanceName>pgm-bp102g323jd4****</DBInstanceName>
    <RequestId>8B993DA9-5272-5414-94E3-4CA8BA0146C2</RequestId>
    <TaskId>440437220</TaskId>
    <TaskName>362c6c7a-4d20-4eac-898c-1495ceab374c</TaskName>
</CreateCloudMigrationTaskResponse>

Formato JSON

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

{
  "DBInstanceName" : "pgm-bp102g323jd4****",
  "RequestId" : "8B993DA9-5272-5414-94E3-4CA8BA0146C2",
  "TaskId" : 440437220,
  "TaskName" : "362c6c7a-4d20-4eac-898c-1495ceab374c"
}

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.	Erro retornado 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.	Erro retornado porque a instância não oferece suporte à operação.
403	IncorrectDBInstanceType	The database instance type does not support the operation.	Erro retornado 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.	Erro retornado 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.	Erro retornado porque a instância está bloqueada.

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