Todos os produtos
Search
Central de documentação

Elasticsearch:MigrateToOtherZone

Última atualização: Jun 27, 2026

Chame a API MigrateToOtherZone para migrar os nós de uma zona especificada para a zona de destino.

Se as especificações da sua zona forem insuficientes, atualize sua instância para nós em outra zona. Antes de chamar esta interface, garanta que:

  • A conta atual esteja em uma zona com recursos suficientes.

    Após migrar os nós com as especificações atuais para outra zona, atualize o cluster manualmente, pois o cluster não é atualizado durante a migração. Selecione uma zona com recursos adequados para evitar falhas na atualização do cluster. Recomendamos escolher novas zonas que apareçam primeiro em ordem alfabética. Por exemplo, entre as zonas cn-hangzhou-e e cn-hangzhou-h, prefira a cn-hangzhou-h.

  • O cluster esteja íntegro.

    Execute o comando GET _cat/health?v para verificar a integridade do cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Cabeçalho da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte o tópico Parâmetros comuns de requisição.

Sintaxe da requisição

POST /openapi/instances/[InstanceId]/actions/migrate-zones HTTPS|HTTP

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

dryRun

Boolean

Sim

false

Verifica se o nó da zona pode ser migrado. true indica que apenas os dados são validados e a tarefa de migração não é executada. false indica que a tarefa de migração é executada após a validação bem-sucedida.

InstanceId

String

Sim

es-cn-n6w1o1x0w001c****

O ID da instância.

RequestBody

Especifique os parâmetros a seguir no RequestBody para definir as informações de zona da migração.

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

fromZoneId

String

Sim

cn-hangzhou-i

A zona onde a instância está localizada.

toZoneId

String

Sim

cn-hangzhou-b

A zona de destino para a qual a instância será migrada.

toVswitchId

String

Sim

vsw-bp1f7r0ma00pf9h2l****

O ID do vSwitch.

Exemplo:


{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}
            

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

O ID da requisição.

ResultBooleantrue

Resultados retornados:

  • true: migração bem-sucedida
  • false: falha na migração

Exemplos

Exemplos de requisições

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/migrate-zones? dryRun=false HTTP/1.1
Common request parameters
{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}

Exemplos de respostas de sucesso

Formato XML

<Result>true</Result>
<RequestId>24A77388-9444-49A3-A1CF-F48385E5****</RequestId>

Formato JSON

{
    "Result": true,
    "RequestId": "24A77388-9444-49A3-A1CF-F48385E5****"
}

Código de erro

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