Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Distributed Cache Service/ Referencia de la API/ API V2/ Migración de datos/ Creación de una tarea de migración de datos

Actualización más reciente 2022-11-09 GMT+08:00

Ver PDF

Creación de una tarea de migración de datos

Función

Esta API se utiliza para crear una tarea de migración de datos.

URI

POST /v2/{project_id}/migration-task

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
task_name	Sí	String	Nombre de la tarea de migración.
description	No	String	Descripción de la tarea de migración.
migration_type	Sí	String	Modo de migración. Valores: backupfile_import: importar archivos de copia de respaldo online_migration: migrar datos en línea Valores de enumeración: backupfile_import online_migration
migration_method	Sí	String	Tipo de migración, que puede ser migración completa o migración incremental. Valores: full_amount_migration: migración completa incremental_migration: migración incremental Valores de enumeración: full_amount_migration incremental_migration
backup_files	No	BackupFilesBody object	Los archivos de copia de respaldo que se van a importar cuando el modo de migración es la importación de archivos de copia de respaldo.
network_type	No	String	Tipo de la red para la comunicación entre el origen y el destino Redis cuando el modo de migración es migración de datos en línea. El tipo de red puede VPC o VPN. Valores de enumeración: vpc vpn
source_instance	No	SourceInstanceBody object	Fuente de información de Redis. Este parámetro es obligatorio cuando el modo de migración es migración de datos en línea.
target_instance	Sí	TargetInstanceBody object	Información de Redis de destino.

**Tabla 3** BackupFilesBody
Parámetro	Obligatorio	Tipo	Descripción
file_source	No	String	Origen de datos, que puede ser un bucket OBS o un registro de copia de respaldo. Valores de enumeración: self_build_obs backup_record
bucket_name	Sí	String	Nombre del bucket OBS.
files	Sí	Array of Files objects	Lista de archivos de copia de respaldo que se van a importar. Este parámetro es obligatorio cuando el origen de datos es un bucket OBS.
backup_id	No	String	ID de registro de copia de respaldo. Este parámetro es obligatorio cuando el origen de datos es un registro de copia de respaldo.

**Tabla 4** Files
Parámetro	Obligatorio	Tipo	Descripción
file_name	Sí	String	Nombre de un archivo de copia de respaldo.
size	No	String	Tamaño del archivo en bytes.
update_at	No	String	Hora en la que se modificó por última vez el archivo. El formato es AAAA-MM-DD HH:MM:SS.

**Tabla 5** SourceInstanceBody
Parámetro	Obligatorio	Tipo	Descripción
addrs	Sí	String	Nombre de Source Redis (especificado en el parámetro source_instance).
password	No	String	Contraseña de Redis. Si se establece una contraseña, este parámetro es obligatorio.

**Tabla 6** TargetInstanceBody
Parámetro	Obligatorio	Tipo	Descripción
id	Sí	String	ID de instancia de Redis (obligatorio en el parámetro target_instance).
name	No	String	Nombre de instancia de Redis (especificado en el parámetro target_instance).
password	No	String	Contraseña de Redis. Si se establece una contraseña, este parámetro es obligatorio.

Parámetros de respuesta

Código de estado: 200

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
id	String	ID de tarea de migración.
name	String	Nombre de la tarea de migración.
status	String	Estado de la tarea de migración. El valor puede ser SUCCESS, FAILED, MIGRATING, o TERMINATED. Valores de enumeración: SUCCESS FAILED MIGRATING TERMINATED

Código de estado: 400

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 401

**Tabla 9** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 403

**Tabla 10** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 404

**Tabla 11** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 500

**Tabla 12** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Solicitudes de ejemplo

POST https://{dcs_endpoint}/v2/{project_id}/migration-task

{
  "task_name" : "migration1",
  "description" : "Test",
  "migration_type" : "online_migration",
  "migration_method" : "full_amount_migration",
  "network_type" : "vpc",
  "source_instance" : {
    "addrs" : "192.168.1.135:6379",
    "password" : "xxxxxx"
  },
  "target_instance" : {
    "name" : "dcs-test",
    "id" : "4cd5dbb8-aacd-4603-b817-3e97d48c7a20"
  }
}

Ejemplo de respuestas

Código de estado: 200

Tarea de migración de datos creada correctamente.

{
  "id" : "8aa6999e71cb638b0171f485f5266ef0",
  "name" : "dcs-test",
  "status" : "MIGRATING"
}

Códigos de estado

Código de estado	Descripción
200	Tarea de migración de datos creada correctamente.
400	Solicitud no válida.
401	Información de autenticación no válida.
403	La solicitud se rechaza.
404	La página solicitada no se encuentra.
500	Error interno del servicio.