Configure suporte ao dual-stack IPv6 para namespaces do Grade de Eventos do Azure (prévia)

Os namespaces do Grade de Eventos do Azure suportam conectividade dual-stack IPv4 e IPv6 durante a prévia. Após ativar a pilha dupla, os clientes suportados podem usar IPv4 ou IPv6 para se conectar aos endpoints públicos de namespace suportados.

Importante

O suporte ao dual-stack IPv6 para namespaces do Grade de Eventos do Azure está atualmente em pré-visualização. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Cenários com suporte

Durante a pré-visualização, o suporte a dual-stack IPv6 se aplica aos namespaces do Event Grid. Ele suporta os seguintes cenários:

  • Crie um novo namespace do Event Grid com dual stack ativado.
  • Converta um namespace existente do Event Grid IPv4 para pilha dupla.
  • Configure as regras de firewall IPv4 e IPv6.
  • Publique eventos para tópicos de namespace via IPv4 ou IPv6.
  • Receba eventos usando pull delivery via IPv4 ou IPv6.
  • Conecte os clientes MQTT suportados ao endpoint público do broker MQTT via IPv4 ou IPv6.
  • Continue usando clientes IPv4 existentes após ativar a dual stack.

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 conexões IPv4 e IPv6.

Ativar a dupla pilha não exige que os clientes IPv4 existentes migrem para o IPv6. Se um cliente usa IPv4 ou IPv6 depende das capacidades e do ambiente de rede do cliente.

Prerequisites

Antes de começar, você precisa de:

  • 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 você planeje validar a conectividade IPv6.
  • Um namespace do Event Grid sem um endpoint privado, se você planeja converter um namespace existente para dual stack.

Endpoints públicos suportados

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

  • Endpoints de publicação de tópicos do namespace.
  • Pontos de extremidade de entrega de pull.
  • Pontos de extremidade do Agente MQTT.

O uso do IPv6 não altera os requisitos de autenticação, autorização ou Segurança da Camada de Transporte (TLS) da camada de aplicação para esses endpoints.

Warning

Durante a prévia, o suporte a pilha dupla IPv6 está disponível apenas para endpoints públicos. Endpoints privados não são suportados com namespaces Event Grid habilitados para pilha dupla. Você não pode ativar dual stack em um namespace que tenha um endpoint privado, e não pode criar um endpoint privado para um namespace habilitado para dual-stack. Se você precisar de conectividade de endpoint privado, mantenha a preferência do protocolo de rede do namespace definida para IPv4.

Crie um namespace do Event Grid de pilha dupla (prévia)

Para criar um namespace de Grade de Eventos com dual stack ativado:

  1. Entre no portal do Azure.

  2. Na caixa de busca, insira Event Grid Namespaces e então selecione Event Grid Namespaces nos resultados.

  3. Na página de Namespaces da Grade de Eventos , selecione Criar.

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

  5. Selecione Avançar: Rede.

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

  7. Selecione Dual stack.

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

  8. Configure o acesso à rede pública.

  9. Configure regras de firewall IPv4 e IPv6 se precisar restringir o acesso público.

  10. Continue pela configuração restante do namespace e então selecione Revisar + criar.

  11. Examine a configuração e selecione Criar.

Exemplo de fluxo de criação

Suponha que uma solução de manufatura use o namespace contoso-manufacturing-ns. Aplicações existentes usam IPv4, enquanto clientes e dispositivos mais novos podem usar IPv6. O administrador cria o namespace com Dual stack selecionado. As aplicações existentes continuam a se conectar via IPv4, e clientes compatíveis com IPv6 podem se conectar via IPv6 a endpoints públicos de espaço de nomes suportados.

Converta um namespace existente para dual stack (prévia)

O namespace não pode ter um endpoint privado antes de você ativar o dual stack.

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

  2. No menu de namespace, selecione Networking.

  3. Encontre preferência do protocolo de rede.

  4. Mude a configuração de IPv4 para Dual Stack.

    Captura de tela da preferência do protocolo de rede do portal Azure para um namespace Grade de Eventos existente com pilha dupla selecionada.

  5. Revise as configurações de acesso à rede pública.

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

  7. Clique em Salvar.

  8. Confirme se a atualização foi concluída com sucesso.

Exemplo de fluxo de atualização

Suponha que uma organização tenha um namespace IPv4 chamado contoso-events-ns. O administrador abre o Networking, muda a preferência do protocolo de Rede para Dual stack, adiciona as regras de firewall IPv6 necessárias e salva a configuração. Clientes IPv4 existentes continuam a se conectar, enquanto clientes IPv6 aprovados podem se conectar por meio de endpoints públicos de namespace suportados. Esse cenário assume que o namespace não possui um endpoint privado.

Configurar pilha dual programaticamente (versão prévia)

A 2026-06-15-preview API de gerenciamento adiciona a properties.ipAddressType propriedade para namespaces do Event Grid. Defina a propriedade para:

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

Importante

Antes de definir ipAddressType para DualStack, certifique-se de que o namespace não tenha um endpoint privado. Durante a prévia, você não pode usar endpoints privados e conectividade dual-stack juntos.

Note

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

Crie um namespace usando Bicep ou um template ARM

Os exemplos a seguir criam um namespace padrão 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 você implantar qualquer um dos exemplos sobre um namespace existente, inclua a configuração completa desejada para esse namespace para não alterar outras configurações sem querer.

Crie um namespace usando a API REST

Use uma PUT solicitação 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 da solicitação:

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

Atualize um namespace existente

Use uma PATCH solicitação para mudar um namespace existente de IPv4 para dual stack. Troque os marcadores antes de rodar 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 a operação terminar antes de validar a conectividade ou fazer outra mudança na rede.

Verificar a configuração

Recupere o namespace usando a mesma versão da API de prévia:

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évia, um namespace do 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.
  • Configure uma regra para cada protocolo cliente que você pretende permitir.

Para etapas de configuração, veja Configurar firewall IP para namespaces do Grade de Eventos do Azure.

Exemplo de firewall

Suponha que um cliente IPv4 existente seja permitido por uma regra de firewall IPv4. Um novo cliente IPv6 requer uma regra separada de firewall IPv6. 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

Após ativar a pilha dupla, os clientes suportados podem usar IPv4 ou IPv6 para:

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

Conecte clientes MQTT

Durante a prévia, os clientes MQTT suportados podem se conectar ao endpoint público do corretor MQTT de um namespace Event Grid dual-stack habilitado sobre IPv4 ou IPv6. Clientes IPv4 MQTT existentes podem continuar operando após você ativar a pilha dupla.

Usar IPv6 não muda:

Para mais informações, veja Visão Geral do recurso do corretor MQTT no Grade de Eventos do Azure.

Validar conectividade IPv6

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

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

Para o MQTT, a validação pode incluir conexão, publicação e assinatura. Para tópicos de namespace e entrega por pull, a validação pode incluir publicação e recebimento de eventos.

Considerações e limitações

  • Esse recurso está em versão prévia.
  • A prévia se aplica a endpoints públicos suportados.
  • Endpoints privados não são suportados com namespaces habilitados para dual-stack durante a prévia.
  • O IPv4 permanece disponível depois que você ativa o dual stack.
  • As regras de firewall IPv4 e IPv6 são configuradas de forma independente.
  • O ambiente de rede cliente deve suportar IPv6 para usar conectividade IPv6.
  • Os requisitos existentes de autenticação, autorização e TLS continuam sendo aplicados.
  • A entrega push via IPv6 não está incluída nesta documentação de prévia.
  • O modo apenas IPv6 não faz parte desta documentação de prévia.