Crear una tarea de migración a la nube - - Centro de documentación de Alibaba Cloud

Llame a la operación CreateCloudMigrationTask para crear una tarea de migración a la nube en una instancia de ApsaraDB RDS for PostgreSQL.

Requisitos previos

Antes de llamar a esta operación, compruebe que la instancia de ApsaraDB RDS for PostgreSQL haya superado la evaluación de migración a la nube.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateCloudMigrationTask	La operación que desea ejecutar. Establezca el valor en CreateCloudMigrationTask.
DBInstanceName	String	Sí	pgm-bp102g323jd4****	El identificador de la instancia de ApsaraDB RDS for PostgreSQL. Llame a la operación DescribeDBInstances para consultar el identificador de la instancia.
SourceIpAddress	String	Sí	172.16.XX.XX	La dirección IP privada o pública que se utiliza para conectarse a la instancia de PostgreSQL autogestionada. Si la instancia de PostgreSQL autogestionada reside en una instancia de Elastic Compute Service (ECS), introduzca la dirección IP privada de dicha instancia de ECS. Para obtener más información, consulte Consultar direcciones IP. Si la instancia de PostgreSQL autogestionada reside en un centro de datos local, introduzca la dirección IP privada del centro de datos local. Si la instancia de PostgreSQL autogestionada reside en un dispositivo conectado a través de Internet, introduzca la dirección IP pública del dispositivo.
SourcePort	Long	Sí	5432	El número de puerto que se utiliza para conectarse a la instancia de PostgreSQL autogestionada. Ejecute el comando `netstat -a grep PGSQL` para obtener el número de puerto.
SourceAccount	String	Sí	migratetest	El nombre de usuario de la cuenta que se utiliza para la migración a la nube. Para obtener más información, consulte Crear una cuenta para la migración a la nube en una instancia de PostgreSQL autogestionada.
SourcePassword	String	Sí	123456	La contraseña de la cuenta anterior. Para obtener más información, consulte Crear una cuenta para la migración a la nube en una instancia de PostgreSQL autogestionada.
TaskName	String	No	362c6c7a-4d20-4eac-898c-1495ceab374c	El nombre de la tarea. Especifique un nombre de tarea personalizado. Si no especifica este parámetro, ApsaraDB RDS genera automáticamente un nombre para la tarea.
SourceCategory	String	Sí	ecsOnVpc	El entorno en el que se ejecuta la instancia de PostgreSQL autogestionada. idcOnVpc: la instancia de PostgreSQL autogestionada reside en un centro de datos local que puede comunicarse con la VPC a la que pertenece la instancia de ApsaraDB RDS for PostgreSQL. ecsOnVpc: la instancia de PostgreSQL autogestionada reside en una instancia de ECS. internet: la instancia de PostgreSQL autogestionada reside en un dispositivo conectado a través de Internet.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DBInstanceName	String	pgm-bp102g323jd4****	El nombre de la instancia de ApsaraDB RDS for PostgreSQL.
RequestId	String	8B993DA9-5272-5414-94E3-4CA8BA0146C2	El identificador de la solicitud.
TaskId	Long	440437220	El identificador de la tarea.
TaskName	String	362c6c7a-4d20-4eac-898c-1495ceab374c	El nombre de la tarea.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas de ejemplo exitosas

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	IncorrectDBInstanceState	The current instance state does not support this operation.	Mensaje de error devuelto porque la operación no es compatible con el estado actual de la instancia.
403	IncorrectDBInstance	The current DB instance does not support this operation.	Mensaje de error devuelto porque la instancia no admite la operación.
403	IncorrectDBInstanceType	The database instance type does not support the operation.	Mensaje de error devuelto porque el motor de base de datos que ejecuta la instancia no es compatible con la operación.
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Mensaje de error devuelto porque no se encuentra el nombre de instancia especificado. Compruebe el nombre de la instancia e inténtelo de nuevo.
404	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Mensaje de error devuelto porque la instancia está bloqueada.

Para consultar la lista de códigos de error, visite el centro de errores de API.