Condividi tramite

Come spostare Gestione API di Azure tra aree

  • Articolo

SI APPLICA A: Sviluppatore | Basic | Standard | Premium

Questo articolo descrive come spostare un'istanza di Gestione API in un'area di Azure diversa. È possibile spostare l'istanza in un'altra area per molti motivi. Ad esempio:

  • Individuare l'istanza più vicina ai consumer di API
  • Distribuire le funzionalità disponibili solo in aree specifiche
  • Soddisfare i requisiti di governance e criteri interni

Per spostare le istanze di Gestione API da un'area di Azure a un'altra, usare le operazioni di backup e ripristino del servizio. È possibile usare un nome di istanza di Gestione API diverso o il nome esistente.

Nota

Gestione API supporta anche la distribuzione in più aree, che distribuisce un singolo servizio gestione API di Azure in più aree di Azure. Ciò consente di ridurre la latenza delle richieste percepita dagli utenti dell'API distribuiti geograficamente, oltre a migliorare la disponibilità del servizio se un'area viene portata offline.

Considerazioni

  • Scegliere lo stesso piano tariffario di Gestione API nelle aree di origine e di destinazione.
  • Il backup e il ripristino non funzioneranno durante la migrazione tra diversi tipi di cloud. Per questo scenario, esportare la risorsa come modello. Adattare quindi il modello esportato per l'area di Azure di destinazione e ricreare la risorsa.

Prerequisiti

Preparazione e spostamento

Opzione 1: Usare un nome di istanza di Gestione API diverso

  1. Nell'area di destinazione creare una nuova istanza di Gestione API con lo stesso piano tariffario dell'istanza di Gestione API di origine. Usare un nome diverso per la nuova istanza.
  2. Eseguire il backup dell'istanza di Gestione API esistente nell'account di archiviazione.
  3. Ripristinare il backup dell'istanza di origine nella nuova istanza di Gestione API.
  4. Se si dispone di un dominio personalizzato che punta all'istanza di Gestione API dell'area di origine, aggiornare il CNAME del dominio personalizzato in modo che punti alla nuova istanza di Gestione API.

Opzione 2: usare lo stesso nome dell'istanza di Gestione API

Avviso

Questa opzione elimina l'istanza originale di Gestione API e comporta tempi di inattività durante la migrazione. Assicurarsi di disporre di un backup valido prima di eliminare l'istanza di origine.

  1. Eseguire il backup dell'istanza di Gestione API esistente nell'account di archiviazione.
  2. Eliminare l'istanza di Gestione API nell'area di origine.
  3. Creare una nuova istanza di Gestione API nell'area di destinazione con lo stesso nome di quello nell'area di origine.
  4. Ripristinare il backup dell'istanza di origine nella nuova istanza di Gestione API nell'area di destinazione.

Verificare

  1. Assicurarsi che l'operazione di ripristino venga completata correttamente prima di accedere all'istanza di Gestione API nell'area di destinazione.
  2. Configurare le impostazioni che non vengono spostate automaticamente durante l'operazione di ripristino. Esempi: configurazione della rete virtuale, identità gestite, contenuto del portale per sviluppatori e dominio personalizzato e certificati della CA personalizzati.
  3. Accedere agli endpoint di Gestione API nell'area di destinazione. Ad esempio, testare le API o accedere al portale per sviluppatori.

Pulire le risorse di origine

Se l'istanza di Gestione API è stata spostata usando l'opzione 1, dopo aver ripristinato e configurato correttamente l'istanza di destinazione, è possibile eliminare l'istanza di origine.

Passaggi successivi