Modifiche che causano un'interruzione delle aree di lavoro, parte 2 (marzo 2025)
SI APPLICA A: Premium
Importante
Queste modifiche di rilievo si applicano solo alle aree di lavoro in anteprima in Gestione API di Azure. Se sono state create aree di lavoro dopo la versione disponibile a livello generale nel mese di agosto 2024 e si usano le aree di lavoro con i gateway dell'area di lavoro, le aree non saranno interessate da queste modifiche.
Le aree di lavoro di Gestione API di Azure sono ora disponibili a livello generale e sono stati introdotti diversi aggiornamenti delle funzionalità con tale versione. Nell'ambito dello sviluppo continuo delle aree di lavoro, viene rimosso il supporto per le aree di lavoro di anteprima (create prima di agosto 2024). Se sono state create aree di lavoro in anteprima in Gestione API di Azure e si vuole continuare a usarle, è necessario eseguire la migrazione delle aree alla versione disponibile a livello generale.
Dopo il 31 marzo 2025, le aree di lavoro e le API di anteprima gestite in esse potrebbero smettere di funzionare se non è stata eseguita la migrazione alle funzionalità più recenti dell'area di lavoro. Le API e le risorse gestite all'esterno delle aree di lavoro non sono interessate da questa modifica.
Il servizio è interessato da queste modifiche?
Il servizio potrebbe essere interessato da queste modifiche se sono state create aree di lavoro di anteprima nell'istanza di Gestione API, prima della versione disponibile a livello generale delle aree di lavoro nel mese di agosto 2024. Le aree di lavoro create dopo la data di rilascio disponibile a livello generale che usano i gateway dell'area di lavoro per il runtime dell'API non sono interessate dalle modifiche di rilievo.
Modifiche di rilievo
Di seguito sono riportate modifiche di rilievo che richiedono di intervenire per eseguire la migrazione delle aree di lavoro di anteprima alla versione disponibile a livello generale:
- Necessario il gateway API dell'area di lavoro: ogni area di lavoro deve essere associata a un gateway API dell'area di lavoro che isoli il traffico di runtime dell'area di lavoro. In anteprima, le aree di lavoro hanno condiviso un gateway con il servizio.
- Le identità gestite a livello di servizio non sono supportate: per migliorare la sicurezza delle aree di lavoro, le identità gestite assegnate dal sistema e assegnate dall'utente abilitate a livello di servizio non possono essere usate nelle aree di lavoro. Attualmente, le funzionalità correlate di Gestione API che dipendono da identità gestite, ad esempio l'archiviazione di valori denominati e certificati in Azure Key Vault e l'uso dei criteri di
authentication-managed-identity, non sono supportate nelle aree di lavoro.
Nota
Queste modifiche di rilievo si aggiungono a quelle di giugno 2024 per le aree di lavoro di anteprima annunciate in precedenza.
Qual è la scadenza per la modifica?
Le modifiche di rilievo verranno applicate nelle aree di lavoro di anteprima dopo il 31 marzo 2025. È consigliabile apportare tutte le modifiche necessarie alla configurazione delle aree di lavoro di anteprima prima di tale data.
Che cosa devo fare?
Se le aree di lavoro sono interessate da queste modifiche, è necessario eseguire la migrazione delle aree per allinearsi alle funzionalità disponibili a livello generale. Le sezioni seguenti forniscono indicazioni su come eseguire la migrazione delle aree di lavoro.
Usare il livello Premium per l'istanza di Gestione API
Assicurarsi che l'istanza di Gestione API sia in esecuzione nel livello Premium per continuare a usare le aree di lavoro. Come annunciato precedentemente, se l'istanza si trova nel livello Standard o Sviluppatore, è necessario eseguire l'aggiornamento al livello Premium.
Confermare l'area per l'istanza
L'aggiunta di un gateway dell'area di lavoro a un'area di lavoro richiede che il gateway si trovi nella stessa area dell'istanza. Attualmente, i gateway dell'area di lavoro sono supportati in un subset di aree in cui è disponibile Gestione API. Le aree con supporto per i gateway dell'area di lavoro verranno aggiornate nel tempo.
Per determinare se un'area di lavoro di anteprima si trova in un'area supportata:
- Nel portale di Azure accedere all'istanza di Gestione API.
- Nel menu a sinistra, in API, selezionare Aree di lavoro e selezionare un'area di lavoro.
- Se l'area di lavoro si trova in un'area che non supporta i gateway dell'area di lavoro, verrà visualizzato un messaggio nel portale simile a "Le aree di lavoro non sono attualmente disponibili nell'area del servizio Gestione API".
- Se viene visualizzato questo messaggio, è possibile spostare l'istanza di Gestione API in un'area supportata.
- Se questo messaggio non viene visualizzato, l'area di lavoro si trova in un'area supportata ed è possibile procedere con l'aggiunta di un gateway dell'area di lavoro.
Aggiungere un gateway dell'area di lavoro all'area di lavoro
Di seguito sono riportati i passaggi abbreviati per aggiungere un gateway dell'area di lavoro a un'area di lavoro. Per le opzioni di rete del gateway, i prerequisiti e le istruzioni dettagliate, vedere Creare e gestire un'area di lavoro.
Nota
- Il gateway dell'area di lavoro comporta addebiti aggiuntivi. Per altre informazioni, vedere Prezzi di Gestione API.
- Gestione API supporta attualmente solo un gateway dedicato per ogni area di lavoro. Se questo influisce sui piani di migrazione, vedere la roadmap delle aree di lavoro nell'annuncio di disponibilità generale delle aree di lavoro.
- Nel portale di Azure accedere all'istanza di Gestione API.
- Nel menu a sinistra, in API, selezionare Aree di lavoro.
- Selezionare un'area di lavoro.
- Nel menu a sinistra, in Distribuzione e infrastruttura, selezionare Gateway>+ Aggiungi.
- Completare la procedura guidata per creare un gateway. Attualmente, il provisioning del gateway può richiedere da diversi minuti fino a 3 ore o più.
- Dopo aver eseguito il provisioning del gateway, passare alla pagina Panoramica del gateway. Si noti il valore di Nome host runtime. Usare questo valore per aggiornare le app client che chiamano le API dell'area di lavoro.
- Ripetere i passaggi precedenti per le aree di lavoro rimanenti.
Aggiornare le app client per usare il nuovo nome host del gateway
Dopo aver aggiunto un gateway all'area di lavoro, è necessario aggiornare le app client che chiamano le API dell'area di lavoro per usare il nuovo nome host del gateway anziché il nome host del gateway dell'istanza di Gestione API.
Nota
Per semplificare la migrazione delle aree di lavoro, è comunque possibile accedere alle API nelle aree di lavoro in fase di esecuzione fino a ottobre 2024 usando il nome host del gateway dell'istanza di Gestione API, anche se un gateway dell'area di lavoro è associato a un'area di lavoro. È consigliabile completare la migrazione prima di questa data. Se i gateway dell'area di lavoro sono configurati con accesso in ingresso privato e accesso in uscita privato, assicurarsi che sia protetta anche la connettività al gateway predefinito di Gestione API.
Aggiornare le dipendenze dalle identità gestite a livello di servizio
Se si usano identità gestite a livello di servizio nella configurazione delle entità dell'area di lavoro (ad esempio, valori denominati o certificati), è necessario aggiornare le configurazioni. I passaggi consigliati variano a seconda dell'entità. Esempio: aggiornare i valori denominati per usare i valori segreti anziché i segreti archiviati in Azure Key Vault.
Assistenza e supporto
In caso di domande, è possibile contattare gli esperti della community di Microsoft Q&A. Se hai un piano di supporto e ti serve supporto tecnico, crea una richiesta di supporto.
Ulteriori informazioni
- Panoramica dell'area di lavoro
- Modifiche che causano un'interruzione delle aree di lavoro (giugno 2024)
Contenuto correlato
Vedere tutte le modifiche di rilievo e i ritiri delle funzionalità imminenti.