Konfigurera IPv6 dual-stack-stöd för Azure Event Grid-namnrymder (förhandsgranskning)

Azure Event Grid-namnrymder stödjer IPv4- och IPv6-dualstack-anslutning under förhandsgranskning. Efter att du aktiverat dual stack kan stödda klienter använda IPv4 eller IPv6 för att ansluta till stödda offentliga namnrymdsendpoints.

Important

IPv6-stöd för dual-stack för Azure Event Grid-namnrymder är för närvarande i förhandsvisning. Den här förhandsversionen tillhandahålls utan ett serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Stödda scenarier

Under förhandsgranskningen gäller IPv6 dual-stack-stöd för Event Grid-namnrymder. Den stöder följande scenarier:

Skapa ett nytt Event Grid-namnområde med dual stack aktiverat.
Konvertera en befintlig IPv4 Event Grid-namnrymd till dual stack.
Konfigurera IPv4- och IPv6-brandväggsregler.
Publicera evenemang till namnområdesämnen över IPv4 eller IPv6.
Ta emot händelser genom att använda pull delivery över IPv4 eller IPv6.
Koppla stödda MQTT-klienter till den publika MQTT-mäklarens slutpunkt via IPv4 eller IPv6.
Fortsätt använda befintliga IPv4-klienter efter att dual stack är aktiverat.

Hur dual-stack-anslutning fungerar under förhandsgranskning

De tillgängliga nätverksprotokollpreferenserna är:

IPv4: Standarden för en namnrymd som inte är aktiverad för dual stack.
Dual stack: Möjliggör för stödda publika endpoints att acceptera IPv4- och IPv6-anslutningar.

Att aktivera dual stack kräver inte att befintliga IPv4-klienter migrerar till IPv6. Om en klient använder IPv4 eller IPv6 beror på klientens kapacitet och nätverksmiljö.

Prerequisites

Innan du börjar behöver du:

Ett Azure-abonnemang.
Behörighet att skapa eller uppdatera ett Event Grid-namnområde.
En IPv6-kompatibel klient- och nätverksmiljö om du planerar att validera IPv6-anslutningen.
Ett Event Grid-namnrymd utan privat slutpunkt om du planerar att konvertera en befintlig namnrymd till dubbelstack.

Publika ändpunkter som stöds

Under förhandsgranskningen gäller IPv6 dual-stack-stöd för följande publika slutpunkter:

Publiceringsslutpunkter för namnområdesämnen.
Hämta leveransslutpunkter.
slutpunkter för MQTT-broker.

Att använda IPv6 förändrar inte applikationsnivåns autentiserings-, auktorisations- eller Transport Layer Security (TLS)-krav för dessa endpoints.

Varning

Under förhandsgranskningen är IPv6 dual-stack-stöd endast tillgängligt för publika endpoints. Privata slutpunkter stöds inte med Event Grid-namnrymder med stöd för dubbelstack. Du kan inte aktivera dual stack på en namnrymd som har en privat endpoint, och du kan inte skapa en privat endpoint för en namnrymd med dual stack aktiverat. Om du behöver privat endpoint-anslutning, behåll namnområdets Nätverksprotokollpreferens inställd på IPv4.

Skapa ett Event Grid-namnområde med dubbla stackar (förhandsgranskning)

För att skapa ett Event Grid-namnrymd med dual stack aktiverat:

Logga in på Azure-portalen.
I sökrutan, ange Event Grid Namespaces och välj sedan Event Grid Namespaces från resultaten.
På sidan Event Grid Namespaces , välj Skapa.
På sidan Grunder, konfigurera de nödvändiga namespace-inställningarna.
Välj Nästa: Nätverk.
På sidan Nätverk, hitta föredraget Nätverksprotokoll.
Välj Dual stack.
Konfigurera allmän nätverksåtkomst.
Konfigurera IPv4- och IPv6-brandväggsregler om du behöver begränsa offentlig åtkomst.
Fortsätt genom den återstående namnrymdskonfigurationen och välj sedan Granska + skapa.
Granska konfigurationen och välj sedan Skapa.

Exempel på att skapa flöde

Antag att en tillverkningslösning använder namnrymden contoso-manufacturing-ns. Befintliga applikationer använder IPv4, medan nyare klienter och enheter kan använda IPv6. Administratören skapar namnrymden med Dual stack vald. Befintliga applikationer fortsätter att ansluta över IPv4, och IPv6-kompatibla klienter kan ansluta över IPv6 till offentliga ändpunkter för namnrymder som stöds.

Konvertera en befintlig namnrymd till dual stack (förhandsgranskning)

Namnrymden kan inte ha en privat endpoint innan du aktiverar dual stack.

I Azure-portalen öppnar du ditt befintliga Event Grid-namnområde.
I namnrymdsmenyn, välj Networking.
Hitta Inställning för nätverksprotokoll.
Ändra inställningen från IPv4 till Dual stack.
Granska inställningarna för offentlig nätverksåtkomst.
Lägg till IPv6-brandväggsregler för klienter som kräver IPv6-åtkomst.
Välj Spara.
Kontrollera att uppdateringen slutförs som den ska.

Exempel på uppdateringsflöde

Antag att en organisation har en IPv4-namnrymd som heter contoso-events-ns. Administratören öppnar Nätverk, ändrar nätverksprotokollpreferensen till Dual stack, lägger till nödvändiga IPv6-brandväggsregler och sparar konfigurationen. Befintliga IPv4-klienter fortsätter att ansluta, medan godkända IPv6-klienter kan ansluta via offentliga slutpunkter för namnrymder som stöds. Detta scenario antar att namnrymden inte har en privat slutpunkt.

Konfigurera dual stack programmatiskt (förhandsgranskning)

Hanterings-API:t 2026-06-15-preview lägger till egenskapen properties.ipAddressType för Event Grid-namnrymder. Sätt egenskapen till:

IPv4 för att endast stödja IPv4-adresser.
DualStack för att stödja både IPv4- och IPv6-adresser.

Important

Innan du sätter ipAddressType till DualStack, se till att namnrymden inte har en privat endpoint. Under förhandsgranskningen kan du inte använda privata endpoints och dual-stack-anslutning tillsammans.

Note

De nuvarande az eventgrid namespace kommandona och Az.EventGrid cmdletarna exponerar ingen dedikerad parameter för ipAddressType. Följande exempel på Azure CLI och Azure PowerShell anropar hanterings-REST-API:t. SDK-specifika exempel ingår inte eftersom de för närvarande publicerade Event Grid-hanterings-SDK-modellerna inte exponerar denna förhandsvisningsegenskap.

Skapa ett namnområde genom att använda Bicep eller en ARM-mall

Följande exempel skapar en standardnamnrymd med dual stack aktiverat.

Bicep
ARM-template

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

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "namespaceName": {
      "type": "string"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.EventGrid/namespaces",
      "apiVersion": "2026-06-15-preview",
      "name": "[parameters('namespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard",
        "capacity": 1
      },
      "properties": {
        "ipAddressType": "DualStack",
        "isZoneRedundant": false,
        "publicNetworkAccess": "Enabled"
      }
    }
  ]
}

Om du distribuerar något av exemplen över ett befintligt namnområde, inkludera den kompletta önskade konfigurationen för det namnområdet så att du inte oavsiktligt ändrar andra inställningar.

Skapa ett namnrymd genom att använda REST API:et

Använd en PUT förfrågan för att skapa en namnrymd med dual stack aktiverat:

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

Begäranens innehåll

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

Uppdatera ett befintligt namnområde

Använd en PATCH förfrågan för att ändra en befintlig namnrymd från IPv4 till dual stack. Byt ut platshållarna innan du kör ett exempel.

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

subscriptionId=$(az account show --query id --output tsv)
resourceId="/subscriptions/${subscriptionId}/resourceGroups/<resource-group-name>/providers/Microsoft.EventGrid/namespaces/<namespace-name>"

az rest \
  --method patch \
  --url "${resourceId}?api-version=2026-06-15-preview" \
  --body '{"properties":{"ipAddressType":"DualStack"}}'

$subscriptionId = (Get-AzContext).Subscription.Id
$resourceId = "/subscriptions/$subscriptionId/resourceGroups/<resource-group-name>/providers/Microsoft.EventGrid/namespaces/<namespace-name>"
$payload = @{
    properties = @{
        ipAddressType = "DualStack"
    }
} | ConvertTo-Json -Depth 3

Invoke-AzRestMethod `
    -Method PATCH `
    -Path "$resourceId`?api-version=2026-06-15-preview" `
    -Payload $payload

Uppdateringen kan resultera i en asynkron operation. Vänta tills operationen är klar innan du validerar anslutningen eller gör en ny nätverksändring.

Kontrollera konfigurationen

Hämta namnrymden genom att använda samma förhandsversion av API:et:

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

Bekräfta att svaret innehåller följande värden:

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

Konfigurera IPv4- och IPv6-brandväggsregler under förhandsgranskning

Under förhandsgranskningen stöder ett dubbelstackat Event Grid-namnutrymme IPv4- och IPv6-brandväggsregler. Konfigurera adressområdena separat:

En IPv4-brandväggsregel auktoriserar inte en IPv6-klientadress.
En IPv6-brandväggsregel tillåter inte en IPv4-klientadress.
Konfigurera en regel för varje klientprotokoll som du tänker tillåta.

För konfigurationssteg, se Konfigurera IP-brandvägg för Azure Event Grid-namnrymder.

Brandväggsexempel

Antag att en befintlig IPv4-klient tillåts av en IPv4-brandväggsregel. En ny IPv6-klient kräver en separat IPv6-brandväggsregel. IPv4-regeln ger inte åtkomst till IPv6-klienten, och IPv6-regeln ger inte åtkomst till IPv4-klienten.

Publicera och ta emot händelser

Efter att du aktiverat dual stack kan stödda klienter använda IPv4 eller IPv6 för att:

Nätverksprotokollet ändrar inte de normala autentiserings-, auktorisations-, TLS-, händelseformat- eller operationskraven.

Koppla upp MQTT-klienter

Under förhandsversionen kan MQTT-klienter med stöd ansluta till den offentliga MQTT-mäklarens slutpunkt för en Event Grid-namespace med stöd för dubbla stackar via IPv4 eller IPv6. Befintliga IPv4 MQTT-klienter kan fortsätta fungera efter att du aktiverat dual stack.

Att använda IPv6 förändrar inte:

MQTT-protokoll och TLS-krav.
MQTT-klientautentisering.
MQTT-åtkomstkontroll.
Klientgrupper, ämnesområden eller behörighetskopplingar.

För mer information, se Översikt av MQTT-mäklarfunktionen i Azure Event Grid.

Validera IPv6-anslutning

Använd följande checklista för att validera anslutning från den avsedda klientmiljön:

Bekräfta att namnrymden är konfigurerad för Dual stack.
Bekräfta att namespace inte har en private endpoint.
Bekräfta att klientmiljön stödjer IPv6.
Bekräfta att namnrymdens slutpunkt är nåbar via IPv6.
Bekräfta att en tillämplig IPv6-brandväggsregel tillåter klienten.
Bekräfta att klienten kan etablera en TLS-anslutning.
Bekräfta att klienten kan autentisera sig.
Bekräfta att den avsedda Event Grid-operationen lyckas.

För MQTT kan validering inkludera att ansluta, publicera och prenumerera. För namnområdesämnen och pull delivery kan validering inkludera publicering och mottagande av händelser.

Överväganden och begränsningar

Funktionen är i förhandsvisning.
Förhandsvisningen gäller för offentliga slutpunkter som stöds.
Privata slutpunkter stöds inte med namnrymder med stöd för dubbelstack under förhandsgranskning.
IPv4 förblir tillgängligt efter att du aktiverat dual stack.
IPv4- och IPv6-brandväggsregler konfigureras oberoende.
Klientnätverksmiljön måste stödja IPv6 för att använda IPv6-anslutning.
Befintliga krav på autentisering, auktorisation och TLS fortsätter att gälla.
Push-leverans över IPv6 ingår inte i denna förhandsvisningsdokumentation.
IPv6-endast läge ingår inte i denna förhandsgranskningsdokumentation.

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-10-28