Como mover o Gerenciamento de API do Azure entre regiões

  • Artigo

APLICA-SE A: Developer | Básico | Padrão | Prémio

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

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

Para mover instâncias de 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 de Gerenciamento de API diferente ou o nome existente.

Nota

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

Considerações

  • Escolha a mesma camada de preços do Gerenciamento de API nas regiões de origem e de destino.
  • O backup e a restauração não funcionarão ao migrar entre diferentes tipos de nuvem. Para esse 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

  • Analise os requisitos e as limitações das operações de backup e restauração do Gerenciamento de API.
  • Consulte O que não é feito 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.

Prepare-se e mova-se

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 a mesma camada de preços da instância de Gerenciamento de API de origem. Use um nome diferente para a nova instância.
  2. Faça backup da instância de Gerenciamento de API existente para a conta de armazenamento.
  3. Restaure o backup da instância de origem para a nova instância de Gerenciamento de API.
  4. Se você tiver um domínio personalizado apontando para a instância de Gerenciamento de API da 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 original do Gerenciamento de API e resulta em tempo de inatividade durante a migração. Certifique-se de ter um backup válido antes de excluir a instância de origem.

  1. Faça backup da instância de Gerenciamento de API existente para a conta de armazenamento.
  2. Exclua a instância de 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 da região de origem.
  4. Restaure o backup da instância de origem para a nova instância de Gerenciamento de API na região de destino.

Verificar

  1. Certifique-se de que a operação de restauração seja concluída com êxito antes de acessar sua instância de Gerenciamento de API na região de destino.
  2. Configure 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 CA personalizados e de domínio personalizados.
  3. Acesse seus pontos de extremidade de 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 de Gerenciamento de API usando a Opção 1, depois de restaurar e configurar com êxito a instância de destino, poderá excluir a instância de origem.

Próximos passos