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 命名空間(預覽)
要建立啟用雙堆疊的事件網格命名空間:
登入 Azure 入口網站。
在搜尋框中輸入 Event Grid Namespaces,然後從結果中選擇 Event Grid Namespaces。
在 事件網格命名空間 頁面,選擇 建立。
在 Basics 頁面,設定所需的命名空間設定。
請選取「下一步:網路」。
在 Networking 頁面上,找到 網路協定偏好。
選擇 雙協定堆疊。
設定公用網路存取。
如果你需要限制公開存取,請設定 IPv4 和 IPv6 防火牆規則。
繼續完成剩餘的命名空間設定,然後選擇 檢視 + 建立。
檢閱設定,然後選取 [建立]。
建立流程範例
假設一個製造解決方案使用命名空間 contoso-manufacturing-ns。 現有應用程式使用 IPv4,而較新的用戶端和裝置則可使用 IPv6。 管理員會在選取 雙堆疊 的情況下建立命名空間。 現有應用程式仍可透過 IPv4 連接,支援 IPv6 的用戶端也能透過 IPv6 連接到支援的命名空間公共端點。
將現有命名空間轉換為雙重堆疊(預覽)
在啟用雙棧之前,命名空間不能有私有端點。
在 Azure 入口網站中,開啟你現有的事件網格命名空間。
在命名空間功能表上,選取 [網路]。
尋找 網路協定偏好。
把設定從 IPv4 改成 雙堆疊。
檢視公共網路存取設定。
為需要 IPv6 存取的客戶端新增 IPv6 防火牆規則。
選取 [儲存]。
確認更新是否成功完成。
更新流程範例
假設一個組織擁有一個名為 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 不會改變:
- MQTT 協定與 TLS 要求。
- MQTT 用戶端驗證。
- MQTT 存取控制。
- 客戶群組、主題空間或權限綁定。
欲了解更多資訊,請參閱 Azure 事件方格 中 MQTT 經紀人功能的概述。
驗證 IPv6 連線
請使用以下檢查清單來驗證從預期用戶端環境進行連線:
- 確認命名空間是否已設定為 雙堆疊。
- 確認命名空間沒有私有端點。
- 確認客戶端環境是否支援 IPv6。
- 確認命名空間端點是否可透過 IPv6 連線。
- 確認適用的 IPv6 防火牆規則是否允許該用戶端。
- 確認客戶端能夠建立 TLS 連線。
- 確認用戶端可以進行驗證。
- 確認預期的事件方格作業成功。
對於 MQTT,驗證可以包括連接、發佈和訂閱。 對於命名空間主題和拉取傳遞,驗證可以包含發佈與接收事件。
考慮事項與限制條件
- 此功能處於預覽狀態。
- 預覽版適用於支援的公開端點。
- 預覽期間,啟用雙棧命名空間時不支援私有端點。
- 啟用雙重堆疊後,IPv4 仍然可用。
- IPv4 與 IPv6 防火牆規則是獨立配置的。
- 用戶端網路環境必須支援 IPv6 才能使用 IPv6 連線。
- 現有的認證、授權及TLS要求仍持續適用。
- 這份預覽文件中沒有包含 IPv6 上的推送傳送。
- 僅限 IPv6 模式並不包含在此預覽版文件中。