Todos os produtos
Search
Central de documentação

Elasticsearch:TransferNode

Última atualização: Jun 27, 2026

Executa uma tarefa de migração de dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos de requisição comuns.

Sintaxe da requisição

POST /openapi/instances/{InstanceId}/actions/transfer HTTP/1.1

Parâmetros da requisição

Parâmetro Tipo Posição Obrigatório Exemplo Descrição
InstanceId String Path Sim es-cn-nif1q9o8r0008****

ID da instância.

nodeType String Query Sim WORKER

Tipo dos nós. Valores válidos:

  • WORKER: nó hot
  • WORKER_WARM: nó warm
clientToken String Query Não 5A2CFF0E-5718-45B5-9D4D-70B3FF****

Token do cliente usado para garantir a idempotência da requisição. Gere o valor com o cliente e assegure que seja único entre diferentes requisições. O token aceita apenas caracteres ASCII e tem limite de 64 caracteres.

Array Body Não

Corpo da requisição HTTP.

host String Body Não 192.168.xx.xx

Endereço IP do nó.

port Integer Body Não 9200

Número da porta de acesso do nó.

zoneId String Body Não cn-shanghai-c

ID da zona onde o nó da instância está localizado. Por exemplo, a Zona C de Xangai corresponde a cn-shanghai-c.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
Result Boolean true

Saída:

  • true: Tarefa executada com sucesso.
  • false: Falha na execução da tarefa.
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

ID da requisição.

Exemplos

Exemplos de requisição

POST /openapi/instances/es-cn-nif1q9o8r0008****/actions/transfer?nodeType=WORKER&clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

[ {
  "host" : "192.168.xx.xx",
  "port" : 9200,
  "zoneId" : "cn-shanghai-c"
} ]

Exemplos de respostas de sucesso

Formato JSON

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

{
  "Result" : true,
  "RequestId" : "C82758DD-282F-4D48-934F-92170A33****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.