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

Puede llamar a la operación CreateMigrateTask para crear una tarea de migración que restaure archivos de copia de seguridad desde un bucket de Object Storage Service (OSS) hacia una instancia de ApsaraDB RDS for SQL Server.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateMigrateTask	La operación que desea ejecutar. Establezca el valor en CreateMigrateTask.
DBInstanceId	String	Sí	rm-uf6wjk5xxxxxxx	El ID de la instancia.
DBName	String	Sí	testDB	El nombre de la base de datos de la que desea crear la copia de seguridad.
BackupMode	String	Sí	FULL	El tipo de tarea de migración. Valores válidos: FULL: La tarea migra archivos de copia de seguridad completa. UPDF: La tarea migra archivos de copia de seguridad incremental o de registros.
IsOnlineDB	String	Sí	True	Especifica si los datos restaurados de la base de datos estarán disponibles para el acceso de los usuarios. Valores válidos: True False Nota Establezca el valor en True para instancias que ejecutan SQL Server 2008 R2.
CheckDBMode	String	No	AsyncExecuteDBCheck	El método de comprobación de consistencia para la base de datos. Valores válidos: SyncExecuteDBCheck: comprobación de base de datos síncrona AsyncExecuteDBCheck: comprobación de base de datos asíncrona Valor predeterminado: AsyncExecuteDBCheck (compatible con SQL Server 2008 R2). Nota Este parámetro es válido cuando IsOnlineDB se establece en True.
OssObjectPositions	String	No	oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak	La ubicación del archivo de copia de seguridad en el bucket de OSS. El valor consta de las siguientes partes separadas por dos puntos (:): El endpoint de OSS: oss-ap-southeast-1.aliyuncs.com. El nombre del bucket de OSS: rdsmssqlsingapore. La clave del archivo de copia de seguridad en el bucket de OSS: autotest_2008R2_TestMigration_FULL.bak. Nota Este parámetro es opcional para instancias que ejecutan SQL Server 2008 R2. Este parámetro es obligatorio para instancias que ejecutan un motor de base de datos posterior a SQL Server 2008 R2.
OSSUrls	String	No	check_cdn_oss.sh www.xxxxxx.mobi	La URL compartida del archivo de copia de seguridad en el bucket de OSS. La URL debe estar codificada. Si especifica varias URL, sepárelas con barras verticales (\|) y luego codifíquelas. Nota Este parámetro es obligatorio para instancias que ejecutan SQL Server 2008 R2.
MigrateTaskId	String	No	None	El ID de la tarea de migración. Valores válidos: Si BackupMode se establece en FULL, el valor de este parámetro está vacío. El modo de copia de seguridad completa es compatible con instancias que ejecutan SQL Server 2008 R2. Si BackupMode se establece en UPDF, el valor de este parámetro es el ID de la tarea de migración completa requerida. Nota Si IsOnlineDB se establece en True, BackupMode debe establecerse en FULL. Si IsOnlineDB se establece en False, BackupMode debe establecerse en UPDF.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	866F5EB8-4650-4061-87F0-379F6F968BCE	El ID de la solicitud.
DBName	String	test02	El nombre de la base de datos.
BackupMode	String	FULL	El tipo de tarea de migración. Valores válidos: FULL: La tarea migra archivos de copia de seguridad completa. UPDF: La tarea migra archivos de copia de seguridad incremental o de registros.
DBInstanceId	String	rm-uf6wjk5xxxxx	El ID de la instancia.
MigrateTaskId	String	564563256	El ID de la tarea de migración.
TaskId	String	5451225	El ID de la tarea.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=CreateMigrateTask
&DBInstanceId=rm-uf6wjk5xxxxxxx
&DBName=testDB
&BackupMode=FULL
&IsOnlineDB=True
&OssObjectPositions=oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<CreateMigrateTaskResponse>
	<MigrateTaskId>135847</MigrateTaskId>
	<DBInstanceId>rm-bp178grbxxxxxxx</DBInstanceId>
	<RequestId>5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2</RequestId>
	<BackupMode>UPDF</BackupMode>
	<TaskId>128301751</TaskId>
	<DBName>test02</DBName>
</CreateMigrateTaskResponse>

Formato JSON

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

{
  "MigrateTaskId" : "135847",
  "DBInstanceId" : "rm-bp178grbxxxxxxx",
  "RequestId" : "5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2",
  "BackupMode" : "UPDF",
  "TaskId" : "128301751",
  "DBName" : "test02"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidFile	The operation does not support this kind of file	El mensaje de error devuelto porque esta operación no es compatible con el tipo de archivo actual.
400	InvalidInstanceType	The DB instance type does not support this operation.	El mensaje de error devuelto porque el tipo de instancia actual no admite la operación.
400	InvalidInstanceLockMode	The DB instance lock mode does not support this operation.	El mensaje de error devuelto porque esta operación no es compatible con una instancia bloqueada.
400	InvalidDBName	The instance does not have the specified DB name.	El mensaje de error devuelto porque la base de datos de destino especificada no existe. Compruebe el nombre y el estado de la base de datos de destino o especifique otra base de datos.
400	InvalidDBType	The DB type does not support this operation.	El mensaje de error devuelto porque el estado de la base de datos no admite esta operación.
400	InvalidDBState	The DB state does not support this operation.	El mensaje de error devuelto porque el estado de la base de datos no admite esta operación.
400	ExceedUploadTime	Exceeding the daily upload times of this DB.	El mensaje de error devuelto porque el número de cargas supera el límite diario de la base de datos.
400	InvalidOSSURL	The Specified OSS URL is not valid	El mensaje de error devuelto porque la URL de OSS especificada no es válida.
400	ExceedDiskSize	The file size exceeding the disk size	El mensaje de error devuelto porque el tamaño del archivo supera la capacidad del disco. Compruebe el tamaño del archivo e inténtelo de nuevo.
400	InvalideStatus	Parent migrate task status is invalid.	El mensaje de error devuelto porque el estado de la tarea de migración principal es anómalo.
400	InvalidOssObjectStorageClassType	The specified OSS bucket storage type is invalid.	El mensaje de error devuelto porque la clase de almacenamiento del bucket de OSS especificado no es válida.
403	InvalidInstanceState	The DB instance state does not support this operation.	El mensaje de error devuelto porque el estado de la instancia no admite esta operación.

Para obtener una lista de códigos de error, visite el Centro de errores de API.