Criação de tarefas de migração de dados
Função
Essa API é usada para criar uma tarefa de migração de dados.
URI
POST /v2/{project_id}/migration-task
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
project_id |
Sim |
String |
ID do projeto. |
Parâmetros de solicitação
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
task_name |
Sim |
String |
Nome da tarefa de migração. |
|
description |
Não |
String |
Descrição do tipo de migração. |
|
migration_type |
Sim |
String |
Modo de migração. Valores:
Valores de enumeração:
|
|
migration_method |
Sim |
String |
Tipo de migração, que pode ser migração completa ou migração incremental. Valores:
Valores de enumeração:
|
|
backup_files |
Não |
BackupFilesBody object |
Arquivos de backup a serem importados quando o modo de migração é a importação de arquivos de backup. |
|
network_type |
Não |
String |
Tipo de rede para comunicação entre o Redis de origem e de destino quando o modo de migração é a migração de dados on-line. O tipo de rede pode ser VPC ou VPN. Valores de enumeração:
|
|
source_instance |
Não |
SourceInstanceBody object |
Fonte das informações do Redis. Este parâmetro é obrigatório quando o modo de migração é migração de dados online. |
|
target_instance |
Sim |
TargetInstanceBody object |
Informações do Redis de destino. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
file_source |
Não |
String |
Fonte de dados, que pode ser um bucket do OBS ou um registro de backup. Valores de enumeração:
|
|
bucket_name |
Sim |
String |
Nome do bucket do OBS. |
|
files |
Sim |
Array of Files objects |
Lista de arquivos de backup a serem importados. Esse parâmetro é obrigatório quando a origem de dados é um bucket do OBS. |
|
backup_id |
Não |
String |
ID do registro de backup. Este parâmetro é obrigatório quando a fonte de dados é um registro de backup. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
file_name |
Sim |
String |
Nome de um arquivo de backup. |
|
size |
Não |
String |
Tamanho do arquivo em bytes. |
|
update_at |
Não |
String |
Hora em que o arquivo foi modificado pela última vez. O formato é AAAA-MM-DD HH:MM:SS. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
addrs |
Sim |
String |
Nome do Redis de origem (especificado no parâmetro source_instance). |
|
password |
Não |
String |
Senha do Redis. Se uma senha for definida, esse parâmetro é obrigatório. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
id |
Sim |
String |
ID da instância do Redis (obrigatório no parâmetro target_instance). |
|
name |
Não |
String |
Nome da instância do Redis (especificado no parâmetro target_instance). |
|
password |
Não |
String |
Senha do Redis. Se uma senha for definida, esse parâmetro é obrigatório. |
Parâmetros de resposta
Código de estado: 200
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
id |
String |
ID da tarefa de migração. |
|
name |
String |
Nome da tarefa de migração. |
|
status |
String |
Status da tarefa de migração. O valor pode ser SUCCESS, FAILED, MIGRATING, ou TERMINATED. Valores de enumeração:
|
Código de estado: 400
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error_msg |
String |
Mensagem de erro. Máximo: 1024 |
|
error_code |
String |
Código de erro. Máximo: 9 |
|
error_ext_msg |
String |
Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024 |
Código de estado: 401
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error_msg |
String |
Mensagem de erro. Máximo: 1024 |
|
error_code |
String |
Código de erro. Máximo: 9 |
|
error_ext_msg |
String |
Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024 |
Código de estado: 403
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error_msg |
String |
Mensagem de erro. Máximo: 1024 |
|
error_code |
String |
Código de erro. Máximo: 9 |
|
error_ext_msg |
String |
Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024 |
Código de estado: 404
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error_msg |
String |
Mensagem de erro. Máximo: 1024 |
|
error_code |
String |
Código de erro. Máximo: 9 |
|
error_ext_msg |
String |
Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024 |
Código de estado: 500
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error_msg |
String |
Mensagem de erro. Máximo: 1024 |
|
error_code |
String |
Código de erro. Máximo: 9 |
|
error_ext_msg |
String |
Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024 |
Exemplos de solicitações
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"
}
}
Exemplo de respostas
Código de estado: 200
Tarefa de migração de dados criada com êxito.
{
"id" : "8aa6999e71cb638b0171f485f5266ef0",
"name" : "dcs-test",
"status" : "MIGRATING"
}
Códigos de status
|
Código de status |
Descrição |
|---|---|
|
200 |
Tarefa de migração de dados criada com êxito. |
|
400 |
Pedido inválido. |
|
401 |
Informações de autenticação inválidas. |
|
403 |
O pedido é rejeitado. |
|
404 |
O recurso solicitado não foi encontrado. |
|
500 |
Erro de serviço interno. |
Códigos de erro
Consulte Códigos de erro.