Compartilhar via


Como migrar o Gerenciamento de API do Azure de uma região para outra

APLICA-SE A: Desenvolvedor | Básico | Standard | Premium

Este artigo descreve como mover uma instância do Gerenciamento de API para uma região do Azure diferente. Você pode mover sua instância para outra região por vários motivos. Por exemplo:

  • Localizar sua instância mais perto de seus consumidores de API
  • Implantar recursos disponíveis somente em regiões específicas
  • Atender aos requisitos internos de políticas e governança

Para mover as instâncias do Gerenciamento de API de uma região do Azure para outra, use as operações de backup e restauração do serviço. Você pode usar um nome de instância do Gerenciamento de API diferente ou o nome atual.

Observação

O Gerenciamento de API também dá suporte à implantação multirregional, que distribui um único serviço do Gerenciamento de API do Azure em várias regiões do Azure. A implantação de várias regiões ajuda a reduzir a solicitação de latência percebida pelos consumidores de API distribuídos geograficamente e melhora a disponibilidade do serviço se uma região ficar offline.

Considerações

  • Escolha o mesmo tipo de preço de Gerenciamento de API nas regiões de origem e de destino.
  • O backup e a restauração não funcionam se você migrar de um tipo de nuvem para outro. Nesse cenário, exporte o recurso como um modelo. Em seguida, adapte o modelo exportado para a região do Azure de destino e recrie o recurso.

Pré-requisitos

  • Revise os requisitos e as limitações das operações de backup e restauração do Gerenciamento de API.
  • Confira O que não é submetido a backup. Registre as configurações e os dados que você precisará recriar manualmente depois de mover a instância.
  • Crie uma conta de armazenamento na região de origem. Você usará essa conta para fazer backup da instância de origem.

Preparar e mover

Opção 1: usar um nome de instância de gerenciamento de API diferente

  1. Na região de destino, crie uma nova instância de gerenciamento de API com o mesmo tipo de preço que a instância de gerenciamento de API de origem. Use um nome diferente para a nova instância.
  2. Faça backup da instância do Gerenciamento de API na conta de armazenamento.
  3. Restaure o backup da instância de origem na nova instância do Gerenciamento de API.
  4. Se você tiver um domínio personalizado apontando para a instância de gerenciamento de API de região de origem, atualize o CNAME de domínio personalizado para apontar para a nova instância de gerenciamento de API.

Opção 2: usar o mesmo nome de instância de gerenciamento de API

Aviso

Essa opção exclui a instância do Gerenciamento de API original e resulta em tempo de inatividade durante a migração. Verifique se você tem um backup válido antes de excluir a instância de origem.

  1. Faça backup da instância do Gerenciamento de API na conta de armazenamento.
  2. Exclua a instância do Gerenciamento de API na região de origem.
  3. Crie uma nova instância de gerenciamento de API na região de destino com o mesmo nome que aquela na região de origem.
  4. Restaure o backup da instância de origem na nova instância do Gerenciamento de API na região de destino.

Verificar

  1. Antes de acessar sua instância do Gerenciamento de API na região de destino, verifique se a operação de restauração foi concluída com êxito.
  2. Defina as configurações que não são movidas automaticamente durante a operação de restauração. Exemplos: configuração de rede virtual, identidades gerenciadas, conteúdo do portal do desenvolvedor e certificados de autoridade de certificação personalizados e de domínio personalizado.
  3. Acesse os seus pontos de extremidade do Gerenciamento de API na região de destino. Por exemplo, teste suas APIs ou acesse o portal do desenvolvedor.

Limpar recursos de origem

Se você moveu a instância do Gerenciamento de API usando a opção 1, depois de restaurar e configurar a instância de destino, você pode excluir a instância de origem.

Próximas etapas