Configure suporte de dual-stack IPv6 para namespaces do Azure Event Grid (pré-visualização)

Os namespaces do Azure Event Grid suportam conectividade dual-stack IPv4 e IPv6 durante a pré-visualização. Depois de ativar a dupla pilha, os clientes suportados podem usar IPv4 ou IPv6 para se ligar a endpoints públicos de namespace suportados.

Importante

O suporte IPv6 dual-stack para namespaces do Azure Event Grid está atualmente em pré-visualização. Esta pré-visualização é fornecida sem um acordo de nível de serviço e não é recomendada para cargas de trabalho em produção. Certas funcionalidades podem não ser suportadas ou podem ter capacidades limitadas. Para mais informações, consulte Termos Suplementares de Utilização para Microsoft Azure Previews.

Cenários suportados

Durante a pré-visualização, o suporte a dual-stack IPv6 aplica-se aos namespaces da Grade de Eventos. Suporta os seguintes cenários:

  • Crie um novo namespace de Grade de Eventos com dual stack ativado.
  • Converta um namespace IPv4 existente do Event Grid para pilha dupla.
  • Configura as regras do firewall IPv4 e IPv6.
  • Publique eventos em tópicos de namespace através de IPv4 ou IPv6.
  • Receba eventos usando pull delivery via IPv4 ou IPv6.
  • Ligue os clientes MQTT suportados ao endpoint público do corretor MQTT via IPv4 ou IPv6.
  • Continue a usar clientes IPv4 existentes depois de o dual stack estar ativado.

Como funciona a conectividade dual-stack durante a pré-visualização

As preferências disponíveis de protocolo de rede são:

  • IPv4: O padrão para um namespace que não está ativado para dual stack.
  • Dual stack: Permite que endpoints públicos suportados aceitem ligações IPv4 e IPv6.

Ativar dual stack não exige que os clientes IPv4 existentes migrem para IPv6. Se um cliente utiliza IPv4 ou IPv6 depende das capacidades e do ambiente de rede do cliente.

Prerequisites

Antes de começar, você precisa:

  • Uma assinatura do Azure.
  • Permissão para criar ou atualizar um namespace do Event Grid.
  • Um ambiente cliente e de rede compatível com IPv6, caso planeie validar a conectividade IPv6.
  • Um namespace do Event Grid sem endpoint privado, caso planeie converter um namespace existente para dual stack.

Pontos de extremidade públicos suportados

Durante a pré-visualização, o suporte ao dual-stack do IPv6 aplica-se aos seguintes endpoints públicos:

  • Pontos finais de publicação do tópico do namespace.
  • Obtém os endpoints de entrega.
  • Pontos de extremidade do broker MQTT.

Usar IPv6 não altera os requisitos de autenticação, autorização ou Segurança da Camada de Transporte (TLS) na camada de aplicação para estes endpoints.

Warning

Durante a pré-visualização, o suporte a dual-stack IPv6 está disponível apenas para endpoints públicos. Os pontos finais privados não são suportados com espaços de nomes do Event Grid com dual-stack ativado. Não podes ativar dual stack num namespace que tenha um endpoint privado, nem podes criar um endpoint privado para um namespace dual-stack. Se precisar de conectividade de endpoint privado, mantenha a preferência do protocolo de rede do namespace definida para IPv4.

Criar um namespace do Event Grid dual-stack (pré-visualização)

Para criar um namespace Event Grid com dual stack ativado:

  1. Inicie sessão no portal Azure.

  2. Na caixa de pesquisa, introduza Event Grid Namespaces e depois selecione Event Grid Namespaces nos resultados.

  3. Na página Namespaces do Event Grid, selecione Criar.

  4. Na página Básicos , configure as definições necessárias do namespace.

  5. Selecionar Seguinte: Rede.

  6. Na página de Rede , localize a preferência de protocolo de rede.

  7. Selecione Dual stack.

    Captura de ecrã do portal Azure Configuração de rede para um novo namespace Event Grid com Dual stack selecionado.

  8. Configurar o acesso à rede pública.

  9. Configura regras de firewall IPv4 e IPv6 se precisares de restringir o acesso público.

  10. Continue pela configuração restante do namespace e depois selecione Rever + criar.

  11. Reveja a configuração e, em seguida, selecione Criar.

Exemplo de criação de fluxo

Suponha que uma solução de fabrico utiliza o namespace contoso-manufacturing-ns. As aplicações existentes usam IPv4, enquanto clientes e dispositivos mais recentes podem usar IPv6. O administrador cria o namespace com Dual stack selecionada. As aplicações existentes continuam a ligar-se via IPv4, e os clientes compatíveis com IPv6 podem ligar-se via IPv6 a pontos finais públicos do espaço de nomes suportados.

Converter um espaço de nomes existente para dual stack (pré-visualização)

O namespace não pode ter um endpoint privado antes de ativares o dual stack.

  1. No portal Azure, abra o seu namespace Event Grid existente.

  2. No menu de espaço de nomes, selecione Networking.

  3. Localize Preferência de protocolo de rede.

  4. Muda a definição de IPv4 para Dual Stack.

    Captura de ecrã da preferência do protocolo de rede do portal Azure para um namespace Event Grid existente com Dual stack selecionado.

  5. Consulte as definições de acesso à rede pública.

  6. Adicionar regras de firewall IPv6 para clientes que exigem acesso IPv6.

  7. Selecione Guardar.

  8. Confirma que a atualização termine com sucesso.

Exemplo de fluxo de atualização

Suponha que uma organização tem um namespace IPv4 chamado contoso-events-ns. O administrador abre o Networking, altera a preferência do protocolo de Rede para Dual stack, adiciona as regras obrigatórias do firewall IPv6 e guarda a configuração. Os clientes IPv4 existentes continuam a ligar-se, enquanto os clientes IPv6 aprovados podem ligar-se através dos endpoints públicos de namespace suportados. Este cenário assume que o namespace não tem um endpoint privado.

Configurar dual stack programaticamente (pré-visualização)

A 2026-06-15-preview API de gestão adiciona a properties.ipAddressType propriedade para os namespaces Event Grid. Defina a propriedade para:

  • IPv4 para suportar apenas endereços IPv4.
  • DualStack para suportar endereços IPv4 e IPv6.

Importante

Antes de definires ipAddressType para DualStack, certifica-te de que o namespace não tem um endpoint privado. Durante a pré-visualização, não podes usar endpoints privados e conectividade dual-stack em conjunto.

Note

Os comandos az eventgrid namespace e cmdlets ipAddressType atuais não expõem um parâmetro dedicado para Az.EventGrid. Os seguintes exemplos de CLI do Azure e Azure PowerShell chamam à API REST de gestão. Exemplos específicos de SDK não são incluídos porque os modelos de gestão de Event Grid atualmente publicados não expõem esta propriedade de pré-visualização.

Crie um namespace usando Bicep ou um template ARM

Os exemplos seguintes criam um namespace Standard com dual stack ativado.

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

Se implementares qualquer um dos exemplos sobre um namespace existente, inclui a configuração completa desejada para esse namespace para não alterares outras definições sem querer.

Crie um namespace usando a API REST

Utilize um PUT pedido para criar um namespace com dual stack ativado:

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

Corpo do pedido:

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

Atualizar um namespace existente

Submeta um pedido PATCH para alterar um namespace existente de IPv4 para dual stack. Substitua os marcadores antes de executar um exemplo.

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

A atualização pode retornar uma operação assíncrona. Espere que a operação termine antes de validar a conectividade ou fazer outra alteração de rede.

Verifique a configuração

Recupere o namespace usando a mesma versão da API de pré-visualização:

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

Confirme que a resposta contém os seguintes valores:

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

Configurar regras de firewall IPv4 e IPv6 durante a pré-visualização

Durante a pré-visualização, um namespace Event Grid de pilha dupla suporta regras de firewall IPv4 e IPv6. Configure os intervalos de endereços de forma independente:

  • Uma regra de firewall IPv4 não autoriza um endereço de cliente IPv6.
  • Uma regra de firewall IPv6 não autoriza um endereço de cliente IPv4.
  • Configura uma regra para cada protocolo cliente que pretendes permitir.

Para os passos de configuração, consulte Configurar firewall IP para namespaces do Azure Event Grid.

Exemplo de firewall

Suponha que um cliente IPv4 existente é permitido por uma regra de firewall IPv4. Um novo cliente IPv6 requer uma regra de firewall IPv6 separada. A regra IPv4 não concede acesso ao cliente IPv6, e a regra IPv6 não concede acesso ao cliente IPv4.

Publicar e receber eventos

Depois de ativar o dual stack, os clientes suportados podem usar IPv4 ou IPv6 para:

O protocolo de rede não altera a autenticação, a autorização, o TLS, o formato de evento nem os requisitos normais de operação.

Ligar clientes MQTT

Durante a pré-visualização, os clientes MQTT suportados podem ligar-se ao endpoint público do corretor MQTT de um namespace Event Grid habilitado para dual-stack sobre IPv4 ou IPv6. Os clientes IPv4 MQTT existentes podem continuar a operar depois de ativar o dual stack.

Usar IPv6 não muda:

Para mais informações, consulte a Visão Geral da funcionalidade MQTT broker no Azure Event Grid.

Validar a conectividade IPv6

Use a seguinte lista de verificação para validar a conectividade a partir do ambiente cliente pretendido:

  • Confirme que o namespace está configurado para Dual stack.
  • Confirma que o namespace não tem um endpoint privado.
  • Confirme que o ambiente cliente suporta IPv6.
  • Confirme que o endpoint do namespace é acessível via IPv6.
  • Confirme que uma regra de firewall IPv6 aplicável permite ao cliente.
  • Confirme que o cliente consegue estabelecer uma ligação TLS.
  • Confirmar que o cliente consegue autenticar-se.
  • Confirme que a operação pretendida da Grade de Eventos foi bem-sucedida.

Para o MQTT, a validação pode incluir a ligação, publicação e subscrição. Para tópicos de namespace e entrega por pull, a validação pode incluir a publicação e receção de eventos.

Considerações e limitações

  • A funcionalidade está em pré-visualização.
  • A pré-visualização aplica-se a endpoints públicos suportados.
  • Os endpoints privados não são suportados com namespaces habilitados para dual-stack durante a pré-visualização.
  • O IPv4 mantém-se disponível depois de ativar o dual stack.
  • As regras de firewall IPv4 e IPv6 são configuradas de forma independente.
  • O ambiente de rede do cliente deve suportar IPv6 para utilizar a conectividade IPv6.
  • Os requisitos existentes de autenticação, autorização e TLS continuam a aplicar-se.
  • A entrega push através do IPv6 não está incluída nesta documentação de pré-visualização.
  • O modo apenas IPv6 não faz parte desta documentação de pré-visualização.