Configura il supporto dual-stack IPv6 per i namespace Griglia di eventi di Azure (anteprima)

Gli spazi di nomi Griglia di eventi di Azure supportano la connettività dual-stack IPv4 e IPv6 durante l'anteprima. Dopo aver abilitato il dual stack, i client supportati possono usare IPv4 o IPv6 per connettersi agli endpoint pubblici supportati nel namespace.

Importante

Il supporto dual-stack IPv6 per i namespace Griglia di eventi di Azure è attualmente in anteprima. Questa anteprima viene fornita senza un contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per ulteriori informazioni, vedere Condizioni supplementari per l'uso delle versioni di anteprima di Microsoft Azure.

Scenari supportati

Durante l'anteprima, il supporto dual-stack IPv6 si applica agli spazi di nomi Event Grid. Supporta i seguenti scenari:

  • Crea un nuovo namespace Event Grid con il dual stack abilitato.
  • Converti uno spazio di nomi IPv4 Event Grid esistente in dual stack.
  • Configura le regole del firewall IPv4 e IPv6.
  • Pubblica eventi negli argomenti dello spazio dei nomi tramite IPv4 o IPv6.
  • Ricevi eventi usando pull delivery tramite IPv4 o IPv6.
  • Collega i client MQTT supportati all'endpoint broker pubblico MQTT tramite IPv4 o IPv6.
  • Continua a usare i client IPv4 esistenti dopo che il dual stack è stato abilitato.

Come funziona la connettività dual-stack durante l'anteprima

Le preferenze disponibili per i protocolli di rete sono:

  • IPv4: Il valore predefinito per uno spazio di nomi che non è abilitato per il dual stack.
  • Dual stack: Consente agli endpoint pubblici supportati di accettare connessioni IPv4 e IPv6.

Abilitare il dual stack non richiede che i client IPv4 esistenti migrino a IPv6. Se un client utilizza IPv4 o IPv6 dipende dalle capacità e dall'ambiente di rete del client.

Prerequisites

Prima di iniziare, è necessario disporre di quanto segue:

  • Una sottoscrizione di Azure.
  • Permesso di creare o aggiornare uno spazio di nomi Event Grid.
  • Un ambiente client e di rete compatibile IPv6 se intendi validare la connettività IPv6.
  • Uno spazio dei nomi di Griglia di eventi senza endpoint privato se si prevede di convertire uno spazio dei nomi esistente in dual stack.

Endpoint pubblici supportati

Durante l'anteprima, il supporto per il dual-stack IPv6 si applica ai seguenti endpoint pubblici:

  • Endpoint di pubblicazione degli argomenti dello spazio dei nomi.
  • Endpoint di recapito pull.
  • Endpoint del broker MQTT.

L'uso di IPv6 non cambia i requisiti di autenticazione, autorizzazione o Transport Layer Security (TLS) a livello applicativo per questi endpoint.

Warning

Durante l'anteprima, il supporto a doppio stack IPv6 è disponibile solo per endpoint pubblici. Gli endpoint privati non sono supportati con namespace Event Grid abilitati a doppio stack. Non puoi abilitare il dual stack su uno spazio di nomi che ha un endpoint privato, e non puoi creare un endpoint privato per uno spazio di nomi abilitato al doppio stack. Se hai bisogno di connettività con endpoint privati, tieni la preferenza del protocollo di rete dello spazio dei nomi impostata su IPv4.

Crea uno spazio di nomi Event Grid a doppio stack (anteprima)

Per creare uno spazio di nomi Event Grid con doppio stack abilitato:

  1. Accedi al portale di Azure.

  2. Nella casella di ricerca, inserisci Event Grid Namespaces e poi seleziona Event Grid Namespaces dai risultati.

  3. Nella pagina Spazi dei nomi di Griglia di eventi, selezionare Crea.

  4. Nella pagina Informazioni di base, configurare le impostazioni necessarie dello spazio dei nomi.

  5. Selezionare Avanti: Rete.

  6. Nella pagina Networking, trova la preferenza per protocollo di rete.

  7. Seleziona Dual stack.

    Screenshot del portale Azure Configurazione di rete per un nuovo namespace Event Grid con Dual stack selezionato.

  8. Configura l'accesso alla rete pubblica.

  9. Configura le regole del firewall IPv4 e IPv6 se devi limitare l'accesso pubblico.

  10. Continuare con la configurazione restante dello spazio dei nomi, quindi selezionare Rivedi e crea.

  11. Controllare la configurazione e quindi selezionare Crea.

Esempio del flusso di creazione

Supponiamo che una soluzione di produzione utilizzi il namespace contoso-manufacturing-ns. Le applicazioni esistenti utilizzano IPv4, mentre i client e i dispositivi più recenti possono usare IPv6. L'amministratore crea il namespace con Dual stack selezionato. Le applicazioni esistenti continuano a connettersi tramite IPv4 e i client compatibili con IPv6 possono connettersi tramite IPv6 agli endpoint pubblici dei namespace supportati.

Converti un namespace esistente in dual stack (anteprima)

Il namespace non può avere un endpoint privato prima che tu abiliti il dual stack.

  1. Nel portale Azure, apri il tuo namespace Event Grid esistente.

  2. Nel menu namespace, seleziona Networking.

  3. Localizza la preferenza del protocollo di rete.

  4. Cambia l'impostazione da IPv4 a Dual stack.

    Screenshot della preferenza del protocollo di rete del portale Azure per un namespace Event Grid esistente con Dual stack selezionato.

  5. Rivedi le impostazioni di accesso pubblico alla rete.

  6. Aggiungi regole firewall IPv6 per i client che richiedono accesso IPv6.

  7. Selezionare Salva.

  8. Conferma che l'aggiornamento sia terminato con successo.

Esempio di flusso di aggiornamento

Supponiamo che un'organizzazione abbia uno spazio di nomi IPv4 chiamato contoso-events-ns. L'amministratore apre Networking, cambia la preferenza del protocollo di rete in Dual stack, aggiunge le regole del firewall IPv6 richieste e salva la configurazione. I client IPv4 esistenti continuano a connettersi, mentre i client IPv6 approvati possono connettersi tramite endpoint pubblici del namespace supportati. Questo scenario presuppone che il namespace non abbia un endpoint privato.

Configura il dual stack in modo programmativo (anteprima)

L'API 2026-06-15-preview di gestione aggiunge la properties.ipAddressType proprietà per gli spazi di nomi Event Grid. Imposta la proprietà a:

  • IPv4 per supportare solo indirizzi IPv4.
  • DualStack per supportare sia gli indirizzi IPv4 che IPv6.

Importante

Prima di impostare ipAddressType su DualStack, assicurati che il namespace non abbia un endpoint privato. Durante l'anteprima, non puoi usare insieme endpoint privati e connettività dual-stack.

Note

Gli attuali comandi az eventgrid namespace e cmdlet Az.EventGrid non espongono un parametro dedicato per ipAddressType. I seguenti esempi di interfaccia della riga di comando di Azure e Azure PowerShell chiamano l'API REST di gestione. Esempi specifici per SDK non sono inclusi perché i modelli SDK di gestione di Event Grid attualmente pubblicati non espongono questa proprietà di anteprima.

Crea un namespace usando Bicep o un modello ARM

I seguenti esempi creano un namespace Standard con il doppio stack abilitato.

param namespaceName string
param location string = resourceGroup().location

resource eventGridNamespace 'Microsoft.EventGrid/namespaces@2026-06-15-preview' = {
  name: namespaceName
  location: location
  sku: {
    name: 'Standard'
    capacity: 1
  }
  properties: {
    ipAddressType: 'DualStack'
    isZoneRedundant: false
    publicNetworkAccess: 'Enabled'
  }
}

Se distribuisci uno dei due esempi su un namespace esistente, includi la configurazione completa desiderata per quel namespace, così da non cambiare involontariamente altre impostazioni.

Crea uno spazio di nomi usando l'API REST

Usa una PUT richiesta per creare un namespace con il dual stack abilitato:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2026-06-15-preview

Corpo della richiesta:

{
  "location": "eastus",
  "sku": {
    "name": "Standard",
    "capacity": 1
  },
  "properties": {
    "ipAddressType": "DualStack",
    "isZoneRedundant": false,
    "publicNetworkAccess": "Enabled"
  }
}

Aggiorna uno spazio di nomi esistente

Usa una PATCH richiesta per cambiare un namespace esistente da IPv4 a dual stack. Sostituisci i segnaposto prima di eseguire un esempio.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2026-06-15-preview
Content-Type: application/json

{
  "properties": {
    "ipAddressType": "DualStack"
  }
}

L'aggiornamento può restituire un'operazione asincrona. Aspetta che l'operazione finisca prima di validare la connettività o di effettuare un altro cambiamento di rete.

Verificare la configurazione

Recupera il namespace usando la stessa versione dell'API di anteprima:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2026-06-15-preview

Conferma che la risposta contenga i seguenti valori:

{
  "properties": {
    "provisioningState": "Succeeded",
    "ipAddressType": "DualStack"
  }
}

Configura le regole del firewall IPv4 e IPv6 durante l'anteprima

Durante l'anteprima, uno spazio di nomi Event Grid dual-stack supporta regole firewall IPv4 e IPv6. Configura gli intervalli di indirizzi in modo indipendente:

  • Una regola firewall IPv4 non autorizza un indirizzo client IPv6.
  • Una regola firewall IPv6 non autorizza un indirizzo client IPv4.
  • Configura una regola per ogni protocollo client che intendi permettere.

Per i passaggi di configurazione, vedi Configura firewall IP per i namespace Griglia di eventi di Azure.

Esempio di firewall

Supponiamo che un client IPv4 esistente sia consentito da una regola del firewall IPv4. Un nuovo client IPv6 richiede una regola separata del firewall IPv6. La regola IPv4 non concede l'accesso al client IPv6, e la regola IPv6 non concede l'accesso al client IPv4.

Pubblica e ricevi eventi

Dopo aver abilitato il dual stack, i client supportati possono usare IPv4 o IPv6 per:

Il protocollo di rete non cambia i normali requisiti di autenticazione, autorizzazione, TLS, il formato degli eventi o i requisiti operativi.

Connetti i client MQTT

Durante l'anteprima, i client MQTT supportati possono connettersi all'endpoint broker pubblico MQTT di un namespace Event Grid abilitato a doppio stack su IPv4 o IPv6. I client IPv4 MQTT esistenti possono continuare a operare dopo aver abilitato il dual stack.

L'uso di IPv6 non cambia:

Per ulteriori informazioni, consulta la Panoramica della funzione broker MQTT in Griglia di eventi di Azure.

Verifica la connettività IPv6

Utilizzare la seguente lista di controllo per validare la connettività dall'ambiente client previsto:

  • Conferma che il namespace sia configurato per il doppio stack.
  • Conferma che il namespace non abbia un endpoint privato.
  • Conferma che l'ambiente client supporti IPv6.
  • Conferma che l'endpoint dello spazio dei nomi sia raggiungibile tramite IPv6.
  • Conferma che una regola applicabile del firewall IPv6 consente al client.
  • Conferma che il client possa stabilire una connessione TLS.
  • Conferma che il cliente possa autenticarsi.
  • Conferma che l'operazione prevista con Event Grid abbia avuto successo.

Per MQTT, la convalida può includere connessione, pubblicazione e sottoscrizione. Per i topic del namespace e il recapito pull, la validazione può includere la pubblicazione e la ricezione di eventi.

Considerazioni e limitazioni

  • La funzionalità è disponibile in anteprima.
  • L'anteprima si applica agli endpoint pubblici supportati.
  • Gli endpoint privati non sono supportati con namespace abilitati a doppio stack durante l'anteprima.
  • IPv4 rimane disponibile anche dopo aver abilitato il dual stack.
  • Le regole firewall IPv4 e IPv6 sono configurate in modo indipendente.
  • L'ambiente di rete client deve supportare IPv6 per utilizzare la connettività IPv6.
  • I requisiti esistenti di autenticazione, autorizzazione e TLS continuano ad applicarsi.
  • La consegna push tramite IPv6 non è inclusa in questa documentazione di anteprima.
  • La modalità solo IPv6 non fa parte di questa documentazione di anteprima (anteprime).