IPv6-dual-stackondersteuning configureren voor Azure Event Grid-namespaces (preview)

Azure Event Grid-namespaces ondersteunen IPv4- en IPv6-dual-stack connectiviteit tijdens de preview. Nadat je dual stack hebt ingeschakeld, kunnen ondersteunde clients IPv4 of IPv6 gebruiken om verbinding te maken met publieke endpoints in de ondersteunde namespace.

Important

IPv6 dual-stack ondersteuning voor Azure Event Grid-namespaces is momenteel in preview. Deze preview wordt geleverd zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

Ondersteunde scenario's

Tijdens de preview geldt IPv6 dual-stack ondersteuning voor Event Grid-namespaces. Het ondersteunt de volgende scenario's:

  • Maak een nieuwe Event Grid-naamruimte aan met dual stack ingeschakeld.
  • Zet een bestaande IPv4 Event Grid-naamruimte om naar dual stack.
  • Stel IPv4- en IPv6-firewallregels in.
  • Publiceer gebeurtenissen naar namespace-topics via IPv4 of IPv6.
  • Ontvang events door pull delivery te gebruiken via IPv4 of IPv6.
  • Verbind ondersteunde MQTT-clients met het publieke MQTT-broker-eindpunt via IPv4 of IPv6.
  • Blijf bestaande IPv4-clients gebruiken nadat dual stack is ingeschakeld.

Hoe dual-stack connectiviteit werkt tijdens preview

De beschikbare voorkeuren voor netwerkprotocollen zijn:

  • IPv4: De standaard voor een naamruimte die niet is ingeschakeld voor dual stack.
  • Dual stack: Maakt het mogelijk dat ondersteunde publieke eindpunten IPv4- en IPv6-verbindingen accepteren.

Het inschakelen van dual stack vereist niet dat bestaande IPv4-clients migreren naar IPv6. Of een client IPv4 of IPv6 gebruikt, hangt af van de mogelijkheden en netwerkomgeving van de client.

Prerequisites

Voordat u begint, hebt u het volgende nodig:

  • Een Azure-abonnement.
  • Toestemming om een Event Grid-naamspace aan te maken of bij te werken.
  • Een IPv6-compatibele client en netwerkomgeving als je van plan bent de IPv6-connectiviteit te valideren.
  • Een Event Grid-namespace zonder een privé-endpoint als je van plan bent een bestaande namespace om te zetten naar een dual stack.

Ondersteunde openbare endpoints

Tijdens de preview geldt IPv6 dual-stack ondersteuning voor de volgende publieke eindpunten:

  • Publicatie-eindpunten voor namespace-onderwerpen.
  • Pull delivery endpoints.
  • MQTT broker-eindpunten.

Het gebruik van IPv6 verandert niets aan de applicatielaag-authenticatie-, autorisatie- of Transport Layer Security (TLS)-eisen voor deze eindpunten.

Warning

Tijdens de preview is IPv6 dual-stack ondersteuning alleen beschikbaar voor publieke eindpunten. Privé-endpoints worden niet ondersteund met Event Grid-namespaces met dual-stack ingeschakeld. Je kunt geen dual stack inschakelen op een namespace met een privé-endpoint, en je kunt geen privé-endpoint maken voor een dual-stack-geschikte namespace. Als je verbinding met een privé-endpoint nodig hebt, houd dan de voorkeur voor het namespace Network protocol preference ingesteld op IPv4.

Maak een dual-stack Event Grid naamruimte aan (preview)

Om een Event Grid-naamruimte te maken met dual stack ingeschakeld:

  1. Meld u aan bij het Azure-portaal.

  2. Voer in het zoekvak Event Grid Namespaces in en selecteer vervolgens Event Grid Namespaces uit de resultaten.

  3. Selecteer op de pagina Event Grid Namespaces de optie Aanmaken.

  4. Op de pagina Basis configureer je de benodigde namespace-instellingen.

  5. Selecteer Volgende: Netwerkverbinding.

  6. Op de pagina Netwerken vind je de voorkeur voor netwerkprotocol.

  7. Selecteer Dual stack.

    Screenshot van de Azure portal Networking-configuratie voor een nieuwe Event Grid-naamruimte met Dual stack geselecteerd.

  8. Openbare netwerktoegang configureren.

  9. Configureer IPv4- en IPv6-firewallregels als je publieke toegang moet beperken.

  10. Ga door met de resterende namespace-configuratie en selecteer vervolgens Beoordelen + aanmaken.

  11. Controleer de configuratie en selecteer vervolgens Maken.

Voorbeeld van een Create-flow

Stel dat een productieoplossing de naamruimte contoso-manufacturing-nsgebruikt. Bestaande applicaties gebruiken IPv4, terwijl nieuwere clients en apparaten IPv6 kunnen gebruiken. De beheerder maakt de naamruimte aan met Dual stack geselecteerd. Bestaande applicaties blijven via IPv4 verbinden, en IPv6-capabele clients kunnen via IPv6 verbinding maken met ondersteunde publieke namespace-endpoints.

Converteer een bestaande naamruimte naar dual stack (preview)

De naamruimte kan geen privé-endpoint hebben voordat je dual stack hebt ingeschakeld.

  1. Open in het Azure-portaal je bestaande Event Grid-naamruimte.

  2. Selecteer in het namespace-menu Netwerken.

  3. Ga naar de voorkeur voor netwerkprotocol.

  4. Verander de instelling van IPv4 naar Dual Stack.

    Screenshot van de Azure portal netwerkprotocolvoorkeur voor een bestaande Event Grid-naamruimte met Dual stack geselecteerd.

  5. Bekijk de instellingen voor toegang tot het openbare netwerk.

  6. Voeg IPv6-firewallregels toe voor clients die IPv6-toegang vereisen.

  7. Klik op Opslaan.

  8. Bevestig dat de update succesvol is afgerond.

Update-flow voorbeeld

Stel dat een organisatie een IPv4-naamruimte heeft genaamd contoso-events-ns. De beheerder opent Netwerk, wijzigt de voorkeur voor netwerkprotocol naar Dual stack, voegt de benodigde IPv6-firewallregels toe en slaat de configuratie op. Bestaande IPv4-clients blijven verbinden, terwijl goedgekeurde IPv6-clients verbinding kunnen maken via ondersteunde namespace-publieke endpoints. Dit scenario gaat ervan uit dat de naamruimte geen privé-eindpunt heeft.

Dual stack programmatisch configureren (preview)

De 2026-06-15-preview beheer-API voegt de properties.ipAddressType eigenschap toe voor Event Grid-naamruimtes. Stel de eigenschap in op:

  • IPv4 ondersteunt alleen IPv4-adressen.
  • DualStack om zowel IPv4- als IPv6-adressen te ondersteunen.

Important

Voordat je ipAddressType op DualStack instelt, zorg ervoor dat de naamruimte geen privé-endpoint heeft. Tijdens de preview kun je private endpoints en dual-stack connectiviteit niet samen gebruiken.

Note

De huidige az eventgrid namespace commando's en Az.EventGrid cmdlets bieden geen toegewijde parameter voor ipAddressType. De volgende voorbeelden van Azure CLI en Azure PowerShell roepen de management REST API aan. SDK-specifieke voorbeelden zijn niet opgenomen omdat de momenteel gepubliceerde Event Grid management SDK-modellen deze preview-eigenschap niet blootstellen.

Maak een naamruimte aan door Bicep of een ARM-sjabloon te gebruiken

De volgende voorbeelden creëren een standaardnaamruimte met dual stack ingeschakeld.

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'
  }
}

Als je een van beide voorbeelden over een bestaande namespace deployt, voeg dan de volledige gewenste configuratie voor die namespace toe zodat je niet per ongeluk andere instellingen verandert.

Maak een naamruimte aan met behulp van de REST API

Gebruik een PUT verzoek om een naamruimte te maken met dual stack ingeschakeld:

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

Verzoekinhoud:

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

Werk een bestaande naamruimte bij

Gebruik een PATCH verzoek om een bestaande naamruimte van IPv4 naar dual stack te veranderen. Vervang de placeholders voordat je een voorbeeld uitvoert.

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"
  }
}

De update kan een asynchrone bewerking teruggeven. Wacht tot de bewerking klaar is voordat je de connectiviteit controleert of een andere netwerkwijziging doet.

De configuratie controleren

Haal de naamruimte op door dezelfde preview-API-versie te gebruiken:

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

Bevestig dat de respons de volgende waarden bevat:

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

IPv4- en IPv6-firewallregels configureren tijdens de preview

Tijdens de preview ondersteunt een dual-stack Event Grid-naamruimte IPv4- en IPv6-firewallregels. Stel de adresbereiken afzonderlijk in:

  • Een IPv4-firewallregel autoriseert geen IPv6-clientadres.
  • Een IPv6-firewallregel autoriseert geen IPv4-clientadres.
  • Configureer een regel voor elk clientprotocol dat je wilt toestaan.

Voor configuratiestappen raadpleegt u IP-firewall configureren voor Azure Event Grid-naamruimten.

Voorbeeld van een firewall

Stel dat een bestaande IPv4-client wordt toegestaan door een IPv4-firewallregel. Een nieuwe IPv6-client vereist een aparte IPv6-firewallregel. De IPv4-regel verleent geen toegang tot de IPv6-client, en de IPv6-regel verleent geen toegang tot de IPv4-client.

Publiceren en gebeurtenissen ontvangen

Nadat je dual stack hebt ingeschakeld, kunnen ondersteunde clients IPv4 of IPv6 gebruiken om:

Het netwerkprotocol verandert de normale authenticatie-, autorisatie-, TLS-, gebeurtenisindelings- of operationele vereisten niet.

MQTT-clients verbinden

Tijdens de preview kunnen ondersteunde MQTT-clients verbinding maken met het publieke MQTT broker-eindpunt van een Event Grid-naamruimte met dual-stack-ondersteuning via IPv4 of IPv6. Bestaande IPv4 MQTT-clients kunnen blijven werken nadat je dual stack hebt ingeschakeld.

Het gebruik van IPv6 verandert niet:

Voor meer informatie, zie Overzicht van de MQTT-brokerfunctie in Azure Event Grid.

Valideer IPv6-connectiviteit

Gebruik de volgende checklist om de connectiviteit vanuit de beoogde clientomgeving te valideren:

  • Bevestig dat de naamruimte is geconfigureerd voor Dual stack.
  • Controleer of de naamruimte geen privé-endpoint heeft.
  • Bevestig dat de clientomgeving IPv6 ondersteunt.
  • Bevestig dat het namespace-eindpunt bereikbaar is via IPv6.
  • Bevestig dat een toepasselijke IPv6-firewallregel de client toestaat.
  • Bevestig dat de client een TLS-verbinding kan opzetten.
  • Bevestig dat de klant kan authenticeren.
  • Bevestig dat de beoogde Event Grid-operatie slaagt.

Voor MQTT kan validatie verbinden, publiceren en abonneren omvatten. Voor namespace-onderwerpen en pull delivery kan validatie ook het publiceren en ontvangen van gebeurtenissen omvatten.

Overwegingen en beperkingen

  • De functie is beschikbaar als preview-versie.
  • De preview geldt voor ondersteunde publieke endpoints.
  • Privé-endpoints worden niet ondersteund met dual-stack-enabled namespaces tijdens de preview.
  • IPv4 blijft beschikbaar nadat je dual stack hebt ingeschakeld.
  • IPv4- en IPv6-firewallregels zijn onafhankelijk geconfigureerd.
  • De clientnetwerkomgeving moet IPv6 ondersteunen om IPv6-connectiviteit te kunnen gebruiken.
  • Bestaande authenticatie-, autorisatie- en TLS-vereisten blijven van toepassing.
  • Push-levering via IPv6 is niet opgenomen in deze preview-documentatie.
  • IPv6-only modus maakt geen deel uit van deze preview-documentatie.