Aggiornamento a Gestione API di Azure - Gennaio 2020

Il 22 gennaio 2019 è stato avviato un aggiornamento normale del servizio Gestione API di Azure che include le nuove funzionalità, le correzioni di bug e le modifiche seguenti, oltre ad altri miglioramenti. Per la ricezione dell'aggiornamento da parte del servizio Gestione API potrebbe essere necessaria più di una settimana.

Novità

1. Ora puoi creare servizi Gestione API di livello Consumo nell'area Sudafrica settentrionale di Azure.
2. I criteri rate-limit e rate-limit-by-key possono ora restituire il numero di chiamate rimanenti e il periodo di attesa prima di un nuovo tentativo nelle intestazioni della risposta o nelle variabili di espressione dei criteri usando i nuovi attributi seguenti: retry-after-header-name, remaining-calls-header-name, retry-after-variable-name, remaining-calls-variable-name. Ad esempio:
   
   <rate-limit-by-key calls="5" renewal-period="30" counter-key="test"  remaining-calls-variable-name=remainingCallsPerIp""/>
<rate-limit calls="20" renewal-period="90"  remaining-calls-variable-name="remainingCallsPerSubscription"/>

<choose>
  <when condition="@(((int)context.Variables["remainingCallsPerIp"]) >= 0)">
    <set-header name="x-remaining-calls" exists-action="override">
       <value>@(System.Math.Min(((int)context.Variables["remainingCallsPerIp"]), ((int)context.Variables["remainingCallsPerSubscription"])).ToString())</value>
    </set-header>
  </when>
</choose> 

A breve sarà disponibile la documentazione.

3. Il criterio authentication-certificate supporta ora certificati da una matrice di byte non elaborati. Accetta due nuovi attributi: body (d tipo byte[]) e password (stringa). Puoi fare riferimento a un esempio di recupero di un certificato da Azure Key Vault per usarlo per l'autenticazione di una chiamata con il back-end. A breve sarà disponibile la documentazione.
4. Ora puoi usare una nuova API di analisi JSON nelle espressioni di criteri:
   context.Request.Body.AsJToken(bool preserveContent = false, JsonSerializerSettings settings = null), context.Request.Body.AsJObject(bool preserveContent = false, JsonSerializerSettings settings = null), context.Request.Body.AsJArray(bool preserveContent = false, JsonSerializerSettings settings = null).
   Gli stessi metodi possono essere usati in context.Response.
5. Il nuovo portale per sviluppatori supporta ora il flusso di invito per nuovi utenti. Un collegamento nel messaggio di posta elettronica reindirizza a un modulo per la configurazione della password dell'utente.

Fisso

1. I servizi con livello Consumo con record CNAME non validi, ad esempio un nome host personalizzato che non fa riferimento al nome host di Gestione API predefinito o un certificato scaduto, che sono stati sospesi possono essere ora attivati dopo la rimozione della configurazione non valida per il nome host. In precedenza non era possibile attivare tali servizi.

Modifiche apportate

1. Il portale per sviluppatori impone ora la connessione HTTPS.
2. La logica di delega dell'autenticazione nel nuovo portale è stata sottoposta a migrazione dal lato client al back-end.
3. L'endpoint del nuovo portale per sviluppatori è stato ottimizzato, in modo da ridurre i tempi di caricamento in base a un ordine di grandezza.
4. L'opzione di aggregazione media per le metriche di richieste in Monitoraggio di Azure non è più disponibile.

Il nuovo portale per sviluppatori segue un ciclo di vita indipendente per le versioni e il log delle modifiche per ogni versione è disponibile su GitHub. La versione 2.2.0 più recente in particolare include modifiche necessarie per l'estendibilità del portale con widget personalizzati. Vedi il wiki del progetto per altri dettagli.

Altre informazioni.