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
Compartir

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.

Códigos de error

Consulte Códigos de error.

Tema principal:Migración de datos