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
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 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.
