Konfigurowanie obsługi podwójnego stosu IPv6 dla przestrzeni nazw Azure Event Grid (preview)

Przestrzenie nazw Azure Event Grid obsługują łączność IPv4 i IPv6 dual-stack w wersji zapoznawczej. Po włączeniu dual stack obsługiwani klienci mogą używać IPv4 lub IPv6 do łączenia się z publicznymi punktami końcowymi obsługiwanej przestrzeni nazw.

Important

Wsparcie dla IPv6 dual-stack dla przestrzeni nazw Azure Event Grid jest obecnie w podglądzie. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Obsługiwane scenariusze

W okresie wersji zapoznawczej obsługa IPv6 dual-stack dotyczy przestrzeni nazw Event Grid. Wspiera następujące scenariusze:

Stwórz nową przestrzeń nazw Event Grid z włączonym dual stack.
Przekonwertowanie istniejącej przestrzeni nazw IPv4 Event Grid na dual stack.
Konfiguruj reguły zapory IPv4 i IPv6.
Publikuj wydarzenia do tematów w przestrzeni nazw przez IPv4 lub IPv6.
Otrzymuj zdarzenia przy użyciu mechanizmu pull przez IPv4 lub IPv6.
Podłącz obsługiwane klienty MQTT z publicznym punktem końcowym brokera MQTT przez IPv4 lub IPv6.
Kontynuuj korzystanie z istniejących klientów IPv4 po włączeniu dual stack.

Jak działa łączność dual-stack podczas podglądu

Dostępne preferencje protokołu sieciowego to:

IPv4: Domyślna dla przestrzeni nazw, która nie jest włączona dla dual stack.
Dual stack: Umożliwia obsługiwanym publicznym punktom końcowym akceptację połączeń IPv4 i IPv6.

Włączanie dual stack nie wymaga, aby istniejący klienci IPv4 migrowali na IPv6. To, czy klient korzysta z IPv4 czy IPv6, zależy od jego możliwości i środowiska sieciowego.

Prerequisites

Przed rozpoczęciem potrzebne są następujące elementy:

Subskrypcja platformy Azure.
Uprawnienia do tworzenia lub aktualizacji przestrzeni nazw Event Grid.
Klient i środowisko sieciowe obsługujące IPv6, jeśli planujesz weryfikować łączność IPv6.
Nie można użyć przestrzeni nazw Event Grid bez prywatnego punktu końcowego, jeśli planujesz przekonwertować istniejącą przestrzeń nazw na dual stack.

Obsługiwane publiczne punkty końcowe API

Podczas podglądu obsługa IPv6 dual-stack dotyczy następujących publicznych punktów końcowych:

Punkty końcowe publikowania tematów w przestrzeni nazw.
Punkty końcowe odbierania.
Punkty końcowe brokera MQTT.

Korzystanie z IPv6 nie zmienia wymagań dotyczących uwierzytelniania, autoryzacji ani zabezpieczeń warstwy transportowej (TLS) na poziomie warstwy aplikacji dla tych punktów końcowych.

Warning

Podczas podglądu wsparcie dla IPv6 dual-stack jest dostępne tylko dla publicznych punktów końcowych. Prywatne punkty końcowe nie są obsługiwane przez przestrzenie nazw Event Grid z włączoną obsługą podwójnego stosu. Nie możesz włączyć dual stack w przestrzeni nazw, która ma prywatny endpoint, ani nie możesz utworzyć prywatnego endpointu dla przestrzeni nazw z podwójnym stackiem. Jeśli potrzebujesz prywatnej łączności z punktem końcowym, pozostaw w przestrzeni nazw ustawienie Preferencja protokołu sieciowego jako IPv4.

Utwórz przestrzeń nazw Event Grid dual-stack (wersja zapoznawcza)

Aby utworzyć przestrzeń nazw Event Grid z włączonym dual stackiem:

Zaloguj się do portalu Azure.
W polu wyszukiwania wpisz Event Grid Namespaces, a następnie wybierz Event Grid Namespaces z wyników.
Na stronie Event Grid Namespaces wybierz Create.
Na stronie Podstawy skonfiguruj wymagane ustawienia przestrzeni nazw.
Wybierz Dalej: Sieć.
Na stronie Sieć i internet znajdź Preferowany protokół sieciowy.
Wybierz Dual stack.
Konfiguruj dostęp do sieci publicznej.
Skonfiguruj reguły zapory IPv4 i IPv6, jeśli musisz ograniczyć dostęp publiczny.
Kontynuuj konfigurację pozostałej przestrzeni nazw, a następnie wybierz Przejrzyj i utwórz.
Przejrzyj konfigurację i wybierz pozycję Utwórz.

Przykład Create-flow

Załóżmy, że rozwiązanie produkcyjne korzysta z przestrzeni nazw contoso-manufacturing-ns. Istniejące aplikacje korzystają z IPv4, podczas gdy nowsze klienci i urządzenia mogą korzystać z IPv6. Administrator tworzy przestrzeń nazw po wybraniu opcji Dual stack. Istniejące aplikacje nadal łączą się przez IPv4, a klienci obsługujący IPv6 mogą łączyć się przez IPv6 z obsługiwanymi publicznymi punktami końcowymi przestrzeni nazw.

Przekonwertowanie istniejącej przestrzeni nazw na dual stack (podgląd)

Przestrzeń nazw nie może mieć prywatnego endpointu przed włączeniem dual stack.

W portalu Azure otwórz istniejącą przestrzeń nazw Event Grid.
W menu przestrzeni nazw wybierz Networking.
Znajdź preferencję protokołu sieciowego.
Zmień ustawienie z IPv4 na Dual stack.
Przejrzyj ustawienia dostępu do sieci publicznej.
Dodaj reguły zapory IPv6 dla klientów wymagających dostępu IPv6.
Wybierz Zapisz.
Potwierdź, że aktualizacja zakończyła się pomyślnie.

Przykład przepływu aktualizacji

Załóżmy, że organizacja ma przestrzeń nazw IPv4 o nazwie contoso-events-ns. Administrator otwiera Networking, zmienia preferencje protokołu sieciowego na Dual stack, dodaje wymagane reguły zapory IPv6 i zapisuje konfigurację. Istniejący klienci IPv4 nadal się łączą, podczas gdy zatwierdzeni klienci IPv6 mogą łączyć się przez wspierane publiczne punkty końcowe przestrzeni nazw. Ten scenariusz zakłada, że przestrzeń nazw nie ma prywatnego punktu końcowego.

Konfiguruj programowo dual stack (podgląd)

API 2026-06-15-preview zarządzania dodaje właściwość properties.ipAddressType dla przestrzeni nazw Event Grid. Ustaw właściwość na:

IPv4 aby obsługiwać tylko adresy IPv4.
DualStack aby obsługiwać zarówno adresy IPv4, jak i IPv6.

Important

Zanim ustawisz ipAddressType na DualStack, upewnij się, że przestrzeń nazw nie ma prywatnego punktu końcowego. Podczas podglądu nie można używać prywatnych punktów końcowych i łączności dual-stack razem.

Note

Obecne az eventgrid namespace polecenia i cmdlets nie Az.EventGrid udostępniają dedykowanego parametru dla ipAddressType. Poniższe przykłady Azure CLI i Azure PowerShell wywołują interfejs API REST zarządzania. Przykłady specyficzne dla SDK nie są uwzględnione, ponieważ obecnie publikowane modele SDK zarządzania Event Grid nie udostępniają tej właściwości podglądu.

Stwórz przestrzeń nazw, używając Bicep lub szablonu ARM

Poniższe przykłady tworzą przestrzeń nazw Standard z włączonym dual stack.

Bicep
Szablon ARM

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

Jeśli wdrożysz którykolwiek z tych przykładów do istniejącej przestrzeni nazw, dołącz pełną pożądaną konfigurację dla tej przestrzeni, aby nie zmieniać przypadkowo innych ustawień.

Utwórz przestrzeń nazw, korzystając z API REST

Użyj żądania PUT do utworzenia przestrzeni nazw z włączonym dual stack:

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

Treść żądania:

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

Zaktualizuj istniejącą przestrzeń nazw

Użyj żądania PATCH zmiany istniejącej przestrzeni nazw z IPv4 na dual stack. Zamień symbole zastępcze, zanim uruchomisz przykładowy kod.

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

Aktualizacja może zwrócić wynik operacji asynchronicznej. Poczekaj na zakończenie operacji, zanim zweryfikowasz łączność lub wprowadzisz kolejną zmianę w sieci.

Sprawdzanie konfiguracji

Pobierz przestrzeń nazw, używając tej samej wersji API podglądowej:

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

Potwierdź, że odpowiedź zawiera następujące wartości:

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

Konfiguruj reguły zapory IPv4 i IPv6 w wersji zapoznawczej

W wersji zapoznawczej przestrzeń nazw Event Grid z dwoma stosami obsługuje reguły zapory IPv4 i IPv6. Konfiguruj zakresy adresów niezależnie:

Reguła zapory IPv4 nie autoryzuje adresu klienta IPv6.
Reguła zapory IPv6 nie autoryzuje adresu klienta IPv4.
Skonfiguruj regułę dla każdego protokołu klienta, na który chcesz zezwolić.

Aby uzyskać instrukcje dotyczące konfiguracji, zobacz Konfigurowanie zapory IP dla przestrzeni nazw usługi Azure Event Grid.

Przykład zapory sieciowej

Załóżmy, że istniejący klient IPv4 jest dozwolony przez regułę zapory IPv4. Nowy klient IPv6 wymaga osobnej reguły zapory IPv6. Reguła IPv4 nie przyznaje dostępu klientowi IPv6, a reguła IPv6 nie daje dostępu klientowi IPv4.

Publikuj i otrzymuj zdarzenia

Po włączeniu dual stack obsługiwani klienci mogą używać protokołu IPv4 lub IPv6 do:

Protokół sieciowy nie zmienia standardowych wymagań uwierzytelniania, autoryzacji, TLS, formatu zdarzeń ani wymagań operacyjnych.

Połącz klientów MQTT

W wersji zapoznawczej obsługiwane klienty MQTT mogą łączyć się z publicznym punktem końcowym brokera MQTT przestrzeni nazw Event Grid z podwójnym stosem przez IPv4 lub IPv6. Istniejący klienci IPv4 MQTT mogą działać dalej po włączeniu dual stack.

Korzystanie z IPv6 nic nie zmienia:

Protokół MQTT i wymagania TLS.
Uwierzytelnianie klienta MQTT.
Kontrola dostępu MQTT.
Grupy klientów, przestrzenie tematyczne lub powiązania uprawnień.

Więcej informacji można znaleźć w artykule Przegląd funkcji brokera MQTT w Azure Event Grid.

Sprawdź łączność IPv6

Użyj poniższej listy kontrolnej, aby zweryfikować łączność z zamierzonego środowiska klienta:

Potwierdź, że przestrzeń nazw jest skonfigurowana pod kątem Dual stack.
Potwierdź, że przestrzeń nazw nie ma prywatnego endpointa.
Potwierdź, że środowisko klienta obsługuje IPv6.
Potwierdź, że punkt końcowy przestrzeni nazw jest dostępny przez IPv6.
Potwierdź, że odpowiednia reguła zapory IPv6 zezwala klientowi.
Potwierdź, że klient może nawiązać połączenie TLS.
Potwierdź, że klient może się uwierzytelnić.
Potwierdź, że zamierzona operacja Event Grid się powiodła.

W przypadku MQTT walidacja może obejmować łączenie, publikowanie i subskrypcję. W przypadku tematów z przestrzeni nazw i dostarczania pull walidacja może obejmować publikowanie i odbiór zdarzeń.

Uwagi i ograniczenia

Funkcja jest dostępna w wersji podglądowej.
Podgląd dotyczy obsługiwanych publicznych punktów końcowych.
Prywatne punkty końcowe nie są wspierane w przestrzeniach nazw z włączoną obsługą dual-stack w wersji zapoznawczej.
IPv4 pozostaje dostępne po włączeniu dual stack.
Reguły zapory IPv4 i IPv6 konfiguruje się niezależnie.
Środowisko sieciowe klienta musi obsługiwać IPv6, aby korzystać z łączności IPv6.
Istniejące wymagania dotyczące uwierzytelniania, autoryzacji i TLS nadal obowiązują.
Dostarczanie push przez IPv6 nie jest uwzględnione w tej dokumentacji podglądowej.
Tryb tylko IPv6 nie jest częścią tej dokumentacji podglądowej.

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-28