Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de instâncias de banco de dados/ Migração de uma instância de banco de dados para outra AZ
Atualizado em 2023-05-06 GMT+08:00
Ver PDF
Compartilhar

Migração de uma instância de banco de dados para outra AZ

Descrição da API

Essa API é usada para migrar uma instância de banco de dados para outra AZ.

O serviço será interrompido por até 60 segundos enquanto a AZ estiver sendo alterada. O tempo necessário para alterar uma AZ dependerá da quantidade de dados a serem migrados. Todo o processo de migração pode levar uma hora. Recomendamos que você use a conexão HA para acessar a instância ou configure seu cliente para se reconectar automaticamente à instância.

Restrições

  • Os conjuntos de clusters e de réplicas do DDS Community Edition suportam esta operação.
  • As instâncias entre AZs não suportam esta operação.
  • As instâncias de banco de dados criadas usando uma sub-rede IPv6 não oferecem suporte a essa operação.
  • Réplicas de leitura ou nós stand-by inativos em uma instância do conjunto de réplicas não dão suporte a essa operação.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/migrate

  • Exemplo de URI

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/migrate

Tabela 1 Parâmetros de solicitação

Nome

Tipo

IN

Obrigatório

Descrição

x-auth-token

string

header

Sim

Token do usuário

project_id

string

path

Sim

ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

string

path

Sim

ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

Solicitações

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    target_azs

    String

    Sim

    Single-AZ ou multi-AZ para o qual a VM é migrada. O valor é obtido a partir do campo de código no corpo de resposta da API em Consulta de AZs para as quais uma instância pode ser migrada.
  • Exemplo de solicitação
    Migração para uma única AZ: 
    { 
        "target_azs":"az1xahz"
}
    Migração para várias AZs: 
    {
	"target_azs":"az1xahz,az2xahz,az3xahz"
}

Respostas

  • Descrição do parâmetro
    Tabela 3 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    job_id

    String

    Sim

    A ID da tarefa.
  • Exemplo de resposta 
    { 
    "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5" 
}

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.