為 Azure 事件方格 命名空間設定 IPv6 雙重堆疊支援(預覽)

Azure 事件方格 命名空間在預覽階段支援 IPv4 與 IPv6 雙堆疊連接。 啟用雙重堆疊後,支援的用戶端可以使用 IPv4 或 IPv6 連接支援的命名空間公共端點。

Important

IPv6 對 Azure 事件方格 命名空間的雙堆疊支援目前處於預覽階段。 此預覽版在沒有服務等級協議的情況下提供,不建議用於生產工作負載。 某些功能可能不被支援或功能受限。 欲了解更多資訊,請參閱 Microsoft Azure 預覽版補充使用條款。

支援的案例

預覽期間,事件網格命名空間支援 IPv6 雙堆疊。 它支援以下情境:

  • 建立一個啟用雙堆疊的新 Event Grid 命名空間。
  • 將現有的 IPv4 事件網格命名空間轉換成雙堆疊。
  • 設定 IPv4 和 IPv6 防火牆規則。
  • 透過 IPv4 或 IPv6 發佈事件到命名空間主題。
  • 透過 IPv4 或 IPv6 的拉取式傳遞來接收事件。
  • 透過 IPv4 或 IPv6 將支援的 MQTT 用戶端連接至公開的 MQTT 代理程式端點。
  • 啟用雙重堆疊後,繼續使用現有的 IPv4 用戶端。

預覽期間雙堆疊連線的運作方式

可用的網路協定偏好包括:

  • IPv4:未啟用雙重堆疊的命名空間的預設值。
  • 雙堆疊:允許支援的公共端點接受 IPv4 與 IPv6 連線。

啟用雙重堆疊並不需要現有的 IPv4 用戶端遷移到 IPv6。 客戶使用 IPv4 或 IPv6 取決於客戶的能力與網路環境。

Prerequisites

在開始之前,您需要:

  • Azure 訂用帳戶。
  • 建立或更新事件網格命名空間的權限。
  • 如果您打算驗證 IPv6 連線,則需要支援 IPv6 的用戶端和網路環境。
  • 如果您打算將現有命名空間轉換為雙堆疊,則需要沒有私人端點的事件方格命名空間。

支援的公開端點

在預覽階段,IPv6 雙堆疊支援適用於以下公開端點:

  • 命名空間主題發佈端點。
  • 提取傳遞端點。
  • MQTT 代理端點。

使用 IPv6 並不會改變這些端點在應用層的認證、授權或傳輸層安全(TLS)要求。

Warning

預覽期間,IPv6 雙堆疊支援僅支援公共端點。 啟用雙堆疊的事件網格命名空間不支援私有端點。 你無法在有私有端點的命名空間啟用雙重堆疊,也無法為啟用雙堆疊的命名空間建立私有端點。 如果你需要私有端點連線,請將命名空間的網路通訊協定偏好設定設為IPv4。

建立雙堆疊 Event Grid 命名空間(預覽)

要建立啟用雙堆疊的事件網格命名空間:

  1. 登入 Azure 入口網站。

  2. 在搜尋框中輸入 Event Grid Namespaces,然後從結果中選擇 Event Grid Namespaces。

  3. 在 事件網格命名空間 頁面,選擇 建立。

  4. 在 Basics 頁面,設定所需的命名空間設定。

  5. 請選取「下一步:網路」。

  6. 在 Networking 頁面上,找到 網路協定偏好。

  7. 選擇 雙協定堆疊。

    Azure 入口網站中已選取雙重堆疊之新 Event Grid 命名空間的網路設定螢幕擷取畫面。

  8. 設定公用網路存取。

  9. 如果你需要限制公開存取,請設定 IPv4 和 IPv6 防火牆規則。

  10. 繼續完成剩餘的命名空間設定,然後選擇 檢視 + 建立。

  11. 檢閱設定,然後選取 [建立]。

建立流程範例

假設一個製造解決方案使用命名空間 contoso-manufacturing-ns。 現有應用程式使用 IPv4,而較新的用戶端和裝置則可使用 IPv6。 管理員會在選取 雙堆疊 的情況下建立命名空間。 現有應用程式仍可透過 IPv4 連接,支援 IPv6 的用戶端也能透過 IPv6 連接到支援的命名空間公共端點。

將現有命名空間轉換為雙重堆疊(預覽)

在啟用雙棧之前,命名空間不能有私有端點。

  1. 在 Azure 入口網站中,開啟你現有的事件網格命名空間。

  2. 在命名空間功能表上,選取 [網路]。

  3. 尋找 網路協定偏好。

  4. 把設定從 IPv4 改成 雙堆疊。

    Azure portal 網路協定偏好的截圖,針對已選取雙堆疊的現有 Event Grid 命名空間。

  5. 檢視公共網路存取設定。

  6. 為需要 IPv6 存取的客戶端新增 IPv6 防火牆規則。

  7. 選取 [儲存]。

  8. 確認更新是否成功完成。

更新流程範例

假設一個組織擁有一個名為 contoso-events-ns的 IPv4 命名空間。 管理員開啟 網路,將 網路協定偏好 改為 雙堆疊,新增所需的 IPv6 防火牆規則,並儲存設定。 現有的 IPv4 用戶端仍可連線,而核准的 IPv6 用戶端則可透過支援的命名空間公共端點連接。 此情境假設命名空間沒有私有端點。

以程式化方式配置雙堆疊(預覽)

2026-06-15-preview管理 API 會為事件網格命名空間新增 properties.ipAddressType 屬性。 將屬性設定為:

  • IPv4 僅支援 IPv4 位址。
  • DualStack 支援 IPv4 與 IPv6 位址。

Important

在將 ipAddressType 設定為 DualStack 之前,請確認命名空間沒有私有端點。 預覽期間,你不能同時使用私有端點和雙堆疊連接。

Note

目前的az eventgrid namespace指令和Az.EventGrid指令小程式並未暴露用於ipAddressType的專門參數。 以下 Azure CLI 和 Azure PowerShell 範例會呼叫管理 REST API。 由於目前已發布的事件網格管理 SDK 模型未揭露此預覽特性,故未包含 SDK 專屬範例。

使用 Bicep 或 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'
  }
}

如果你在現有命名空間上部署任一範例,請包含該命名空間的完整設定,避免無意中更改其他設定。

使用 REST API 建立命名空間

使用 PUT 請求建立啟用雙重堆疊的命名空間:

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

請求主體:

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

更新現有命名空間

利用 PATCH 請求將現有命名空間從 IPv4 改為雙重堆疊。 在執行範例前,先替換佔位符。

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

更新可能會傳回非同步作業。 等操作結束後再驗證連線或進行其他網路變更。

驗證設定

使用相同的預覽 API 版本來取得命名空間:

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

確認回應包含以下數值:

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

預覽期間設定 IPv4 和 IPv6 防火牆規則

預覽期間,雙堆疊事件網格命名空間支援 IPv4 與 IPv6 防火牆規則。 分別設定位址範圍:

  • IPv4 防火牆規則並不授權 IPv6 用戶端位址。
  • IPv6 防火牆規則不會授權 IPv4 用戶端位址。
  • 為你打算允許的每個客戶端協定設定規則。

關於設定步驟,請參見 設定 Azure 事件方格 命名空間的 IP 防火牆。

防火牆範例

假設現有的 IPv4 用戶端被 IPv4 防火牆規則允許。 新的 IPv6 用戶端需要另外的 IPv6 防火牆規則。 IPv4 規則不會授權 IPv6 用戶端存取,IPv6 規則也不會授權 IPv4 用戶端存取。

發佈與接收事件

啟用雙重堆疊後,支援的用戶端可以使用 IPv4 或 IPv6 來:

網路協定不會改變一般的認證、授權、TLS、事件格式或操作要求。

連接 MQTT 用戶端

在預覽期間,支援的 MQTT 用戶端可透過 IPv4 或 IPv6 連線至已啟用雙堆疊的 Event Grid 命名空間的公用 MQTT 代理程式端點。 啟用雙重堆疊後,現有的 IPv4 MQTT 用戶端仍可繼續運作。

使用 IPv6 不會改變:

欲了解更多資訊,請參閱 Azure 事件方格 中 MQTT 經紀人功能的概述。

驗證 IPv6 連線

請使用以下檢查清單來驗證從預期用戶端環境進行連線:

  • 確認命名空間是否已設定為 雙堆疊。
  • 確認命名空間沒有私有端點。
  • 確認客戶端環境是否支援 IPv6。
  • 確認命名空間端點是否可透過 IPv6 連線。
  • 確認適用的 IPv6 防火牆規則是否允許該用戶端。
  • 確認客戶端能夠建立 TLS 連線。
  • 確認用戶端可以進行驗證。
  • 確認預期的事件方格作業成功。

對於 MQTT,驗證可以包括連接、發佈和訂閱。 對於命名空間主題和拉取傳遞,驗證可以包含發佈與接收事件。

考慮事項與限制條件

  • 此功能處於預覽狀態。
  • 預覽版適用於支援的公開端點。
  • 預覽期間,啟用雙棧命名空間時不支援私有端點。
  • 啟用雙重堆疊後,IPv4 仍然可用。
  • IPv4 與 IPv6 防火牆規則是獨立配置的。
  • 用戶端網路環境必須支援 IPv6 才能使用 IPv6 連線。
  • 現有的認證、授權及TLS要求仍持續適用。
  • 這份預覽文件中沒有包含 IPv6 上的推送傳送。
  • 僅限 IPv6 模式並不包含在此預覽版文件中。