Condividi tramite

Aree di lavoro - Modifiche di rilievo (giugno 2024)

  • Articolo

SI APPLICA A: Sviluppatore | Standard | Premio

Importante

Se le aree di lavoro sono state create dopo la versione disponibile a livello generale delle aree di lavoro nel mese di luglio 2024, le aree di lavoro non devono essere interessate da queste modifiche.

Dopo il 14 giugno 2024, nell'ambito dello sviluppo di aree di lavoro in Azure Gestione API, vengono introdotti diversi cambiamenti di rilievo.

Dopo il 14 giugno 2024, le aree di lavoro e le API gestite potrebbero smettere di funzionare se si basano ancora sulle funzionalità impostate per cambiare. 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 configurate aree di lavoro (anteprima) nell'istanza di Gestione API. Questa funzionalità è stata introdotta nei livelli Premium, Standard e Developer .

Modifiche di rilievo

Esaminare le modifiche di rilievo seguenti per determinare se è necessario intervenire:

Passare ai livelli di servizio supportati

I livelli di servizio seguenti non supportano più le aree di lavoro: Standard e Developer. Le aree di lavoro saranno disponibili nel livello Premium .

Per la disponibilità nei livelli v2, vedere Azure Gestione API livelli v2.

Modifiche al supporto per l'assegnazione di entità a livello di servizio nelle aree di lavoro

Le assegnazioni seguenti delle entità dell'area di lavoro alle entità a livello di servizio non saranno più supportate:

  • Assegnare LE API dell'area di lavoro ai prodotti a livello di servizio

  • Assegnare LE API dell'area di lavoro ai tag a livello di servizio

  • Assegnare i prodotti dell'area di lavoro ai tag a livello di servizio

  • Assegnare gruppi a livello di servizio ai prodotti dell'area di lavoro per i controlli di visibilità

    Nota

    I gruppi guest e sviluppatori predefiniti continueranno a essere disponibili nelle aree di lavoro.

Modifiche agli oggetti di contesto supportati

Gli oggetti seguenti context non saranno più supportati nei criteri dell'area di lavoro o nei criteri all-API a livello di servizio:

  • context.Api.Workspace
  • context.Product.Workspace

L'oggetto context.Workspace può essere invece utilizzato.

Nota

È possibile continuare a fare riferimento agli utenti dal livello di servizio nell'oggetto context nei criteri a livello di area di lavoro.

Qual è la scadenza per la modifica?

Le modifiche di rilievo verranno introdotte dopo il 14 giugno 2024. È consigliabile apportare tutte le modifiche necessarie alla configurazione delle aree di lavoro prima di tale data.

Che cosa devo fare?

Se le aree di lavoro sono interessate da queste modifiche, è necessario aggiornare le configurazioni dell'area di lavoro in modo che siano allineate alle nuove funzionalità.

Clienti di livello Standard

Se si usano aree di lavoro nel livello Standard , eseguire l'aggiornamento al livello Premium per continuare a usare le aree di lavoro.

Clienti del livello sviluppatore

Il livello Developer è stato progettato per i casi d'uso di un singolo utente o di un singolo team. Non è in grado di facilitare la collaborazione multi-team con le aree di lavoro a causa delle risorse di calcolo limitate, della mancanza di contratto di servizio e della ridondanza dell'infrastruttura. Se si usa l'anteprima delle aree di lavoro nel livello Sviluppatore , è possibile scegliere una delle opzioni seguenti:

  • Aggregazione in un'istanza del livello Premium

    Durante l'aggiornamento di ogni istanza del livello Sviluppatore al livello Premium è un'opzione, è consigliabile aggregare più ambienti non di produzione in una singola istanza del livello Premium. Usare le aree di lavoro nel livello Premium per isolare i diversi ambienti.

  • Usare le istanze del livello sviluppatore per lo sviluppo, eseguire la migrazione alle aree di lavoro nel livello Premium per la produzione

    È possibile usare le istanze del livello sviluppatore per gli ambienti di sviluppo. Per gli ambienti più elevati, è possibile eseguire la migrazione della configurazione di ogni servizio livello sviluppatore in un'area di lavoro di un servizio di livello Premium, ad esempio usando pipeline CI/CD. Con questo approccio è possibile che si verifichino problemi o conflitti durante la gestione delle configurazioni in ambienti diversi.

    Se attualmente si usano aree di lavoro in un'istanza del livello Sviluppatore, è possibile eseguire la migrazione delle configurazioni dell'area di lavoro a un'istanza del livello sviluppatore senza aree di lavoro:

    1. Esportare un modello di Resource Manager dall'istanza di Gestione API. È possibile esportare il modello dal portale di Azure o usando altri strumenti.
    2. Rimuovere la sottostringa seguente dei valori id risorsa: /workspaces/[^/]+
    3. Distribuire il modello. Per altre informazioni, vedere Avvio rapido: Creare e distribuire modelli arm usando il portale di Azure.

    A seconda del caso d'uso, potrebbe essere necessario eseguire altre modifiche di configurazione nell'istanza di Gestione API.

Assegnazione di entità a livello di area di lavoro

Se sono state assegnate entità a livello di area di lavoro alle entità a livello di servizio nell'anteprima delle aree di lavoro, vedere la tabella seguente per indicazioni sulla migrazione.

Assegnazione non più supportata Passaggio consigliato per la migrazione
Assegnare LE API dell'area di lavoro ai prodotti a livello di servizio Usare prodotti a livello di area di lavoro
Assegnare API o prodotti dell'area di lavoro a tag a livello di servizio Usare i tag a livello di area di lavoro

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

Contenuto correlato

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