Condividi tramite

Ritiri delle versioni delle API (giugno 2024)

  • Articolo

SI APPLICA A: Consumo | Sviluppatore | Basic | Standard | Premium

Gestione API di Azure usa Azure Resource Manager (ARM) per configurare le istanze di Gestione API. La versione dell'API è incorporata nell'uso dei modelli che descrivono l'infrastruttura, negli strumenti usati per configurare il servizio e nei programmi scritti per gestire i servizi di Gestione API di Azure.

A partire dal 1° giugno 2024, tutte le versioni dell'API per il servizio Azure Gestione API prima del 2021-08-01 verranno ritirati (disabilitate). La data di ritiro comunicata in precedenza era il 30 settembre 2023. In qualsiasi momento dopo il 1° giugno 2024, le chiamate API che usano una versione API precedente al 2021-08-01 potrebbero non riuscire senza ulteriore preavviso. Non sarà più possibile creare o gestire i servizi di Gestione API con modelli, strumenti, script e programmi esistenti usando una versione dell'API ritirata fino a quando non sono stati aggiornati per usare la versione API 2021-08-01 o successiva. Le operazioni del piano dati(ad esempio la mediazione delle richieste API nel gateway) non saranno interessate da questo aggiornamento, tra cui dopo il 1° giugno 2024.

Il servizio è interessato da questo problema?

Anche se il servizio non è interessato da questa modifica, da qualsiasi strumento, script o programma che usa Azure Resource Manager (ad esempio l'interfaccia della riga di comando di Azure, Azure PowerShell, Azure Gestione API DevOps Resource Kit o Terraform) per interagire con il servizio Gestione API e chiama una versione dell'API Gestione API prima della versione 2021-08-01 è influenzata da questa modifica. Dopo che una versione dell'API è stata ritirata, non sarà possibile eseguire correttamente gli strumenti interessati, a meno che non si aggiornino gli strumenti.

Qual è la scadenza per la modifica?

Le versioni dell'API interessate verranno ritirati gradualmente a partire dal 1° giugno 2024.

Una volta ritirata una versione dell'API, se si preferisce non aggiornare gli strumenti, gli script e i programmi interessati, i servizi continueranno a essere eseguiti. Tuttavia, non sarà possibile aggiungere o rimuovere API, modificare i criteri API o configurare il servizio Gestione API con gli strumenti interessati.

Azione richiesta

Aggiornare gli strumenti, gli script e i programmi usando i dettagli nella sezione seguente.

È anche consigliabile impostare la versione minima dell'API nell'istanza di Gestione API.

Aggiornare gli strumenti, gli script e i programmi

  • Modelli ARM, Bicep o Terraform : aggiornare il modello per usare l'API versione 2021-08-01 o successiva.

  • Interfaccia della riga di comando di Azure: eseguire az version per verificare la versione. Se si esegue la versione 2.42.0 o successiva, non è necessaria alcuna azione. Usare il az upgrade comando per aggiornare l'interfaccia della riga di comando di Azure, se necessario. Per altre informazioni, vedere Come aggiornare l'interfaccia della riga di comando di Azure.

  • Azure PowerShell : eseguire Get-Module -ListAvailable -Name Az per controllare la versione. Se si esegue la versione 8.1.0 o successiva, non è necessaria alcuna azione. Usare Update-Module -Name Az -Repository PSGallery per aggiornare il modulo, se necessario. Per altre informazioni, vedere Installare il modulo Azure Az PowerShell.

  • Altri strumenti : usare le versioni seguenti (o versioni successive):

    • Gestione API DevOps Resource Kit: 1.0.0
    • Provider Azurerm terraform: 3.0.0

  • Azure SDK : aggiornare gli SDK di Azure Gestione API alle versioni più recenti o almeno alle versioni seguenti:

    • .NET: v1.1.0
    • Vai: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Aggiornare l'impostazione versione minima dell'API nell'istanza di Gestione API

È consigliabile impostare la versione minima dell'API per l'istanza di Gestione API usando il portale di Azure o usando l'API REST o altri strumenti. Questa impostazione limita le chiamate API del piano di controllo all'istanza a una versione dell'API uguale o successiva a questo valore. Impostando questo valore su 2021-08-01, è possibile valutare l'impatto dei ritiri della versione dell'API sugli strumenti.

Per impostare la versione minima dell'API nel portale:

  1. Nel portale di Azure accedere all'istanza di Gestione API.
  2. Nel menu a sinistra, in Distribuzione e infrastruttura selezionare API di gestione.
  3. Selezionare la scheda Impostazioni API di gestione.
  4. In Imponi versione minima dell'API selezionare Sì. Viene visualizzata la versione minima dell'API.
  5. Seleziona Salva.

Importante

Se la versione minima dell'API nel portale è disattivata, è possibile aggiornare l'impostazione solo a livello di codice, ad esempio usando l'API REST o il comando az apim update nell'interfaccia della riga di comando di Azure.

Ulteriori informazioni

Contenuto correlato

Vedi tutte le modifiche di rilievo imminenti e i ritiri delle funzionalità.