Compartilhar via


Microsoft.Network networkManagers/connectivityConfigurations

Definição de recurso do Bicep

O tipo de recurso networkManagers/connectivityConfigurations pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o seguinte Bicep ao modelo.

resource symbolicname 'Microsoft.Network/networkManagers/connectivityConfigurations@2025-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    appliesToGroups: [
      {
        groupConnectivity: 'string'
        isGlobal: 'string'
        networkGroupId: 'string'
        useHubGateway: 'string'
      }
    ]
    connectivityCapabilities: {
      connectedGroupAddressOverlap: 'string'
      connectedGroupPrivateEndpointsScale: 'string'
      peeringEnforcement: 'string'
    }
    connectivityTopology: 'string'
    deleteExistingPeering: 'string'
    description: 'string'
    hubs: [
      {
        resourceId: 'string'
        resourceType: 'string'
      }
    ]
    isGlobal: 'string'
  }
}

Valores de propriedade

Microsoft.Network/networkManagers/connectivityConfigurations

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para o recurso do tipo: networkManagers
Propriedades Propriedades de uma configuração de conectividade do gerenciador de rede ConnectivityConfigurationProperties

ConnectivityConfigurationProperties

Nome Descrição Valor
appliesToGroups Grupos para configuração ConnectivityGroupItem [] (obrigatório)
conectividadeRecursos Coleção de configurações adicionais para aprimorar comportamentos de topologia específicos do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
excluirExistenteEmparelhamento Sinalizar se for necessário remover os emparelhamentos existentes atuais. Falso
'Verdade'
descrição Uma descrição da configuração de conectividade. cadeia
Hubs Lista de hubItems Hub
éGlobal Sinalizar se houver suporte para malha global. Falso
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities

Nome Descrição Valor
connectedGroupAddressOverlap Comportamento para lidar com o espaço de endereço IP sobreposto entre membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsEscala Opção que indica a escala de pontos de extremidade privados permitidos no grupo conectado da configuração de conectividade. 'Alta escala'
'Standard' (obrigatório)
peeringEnforcement Opção que indica a imposição de emparelhamentos criados pela configuração de conectividade. 'Imposto'
'Não aplicado' (obrigatório)

ConnectivityGroupItem

Nome Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
'None' (obrigatório)
éGlobal Sinalizar se houver suporte global. Falso
'Verdade'
networkGroupId ID do grupo de rede. cadeia de caracteres (obrigatório)
useHubGateway Sinalizar se for necessário usar o gateway do hub. Falso
'Verdade'

Núcleo

Nome Descrição Valor
ID do recurso ID do recurso. cadeia
tipoDeRecurso Tipo de recurso. cadeia

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar um Gerenciador de Rede Virtual do Azure e VNETs de exemplo Esse modelo implanta um Gerenciador de Rede Virtual do Azure e uma amostra de redes virtuais no grupo de recursos nomeado. Ele dá suporte a várias topologias de conectividade e tipos de associação de grupo de rede.

Definição de recurso de modelo do ARM

O tipo de recurso networkManagers/connectivityConfigurations pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Network/networkManagers/connectivityConfigurations",
  "apiVersion": "2025-03-01",
  "name": "string",
  "properties": {
    "appliesToGroups": [
      {
        "groupConnectivity": "string",
        "isGlobal": "string",
        "networkGroupId": "string",
        "useHubGateway": "string"
      }
    ],
    "connectivityCapabilities": {
      "connectedGroupAddressOverlap": "string",
      "connectedGroupPrivateEndpointsScale": "string",
      "peeringEnforcement": "string"
    },
    "connectivityTopology": "string",
    "deleteExistingPeering": "string",
    "description": "string",
    "hubs": [
      {
        "resourceId": "string",
        "resourceType": "string"
      }
    ],
    "isGlobal": "string"
  }
}

Valores de propriedade

Microsoft.Network/networkManagers/connectivityConfigurations

Nome Descrição Valor
apiVersion A versão da API '2025-03-01'
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades de uma configuração de conectividade do gerenciador de rede ConnectivityConfigurationProperties
tipo O tipo de recurso 'Microsoft.Network/networkManagers/connectivityConfigurations'

ConnectivityConfigurationProperties

Nome Descrição Valor
appliesToGroups Grupos para configuração ConnectivityGroupItem [] (obrigatório)
conectividadeRecursos Coleção de configurações adicionais para aprimorar comportamentos de topologia específicos do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
excluirExistenteEmparelhamento Sinalizar se for necessário remover os emparelhamentos existentes atuais. Falso
'Verdade'
descrição Uma descrição da configuração de conectividade. cadeia
Hubs Lista de hubItems Hub
éGlobal Sinalizar se houver suporte para malha global. Falso
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities

Nome Descrição Valor
connectedGroupAddressOverlap Comportamento para lidar com o espaço de endereço IP sobreposto entre membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsEscala Opção que indica a escala de pontos de extremidade privados permitidos no grupo conectado da configuração de conectividade. 'Alta escala'
'Standard' (obrigatório)
peeringEnforcement Opção que indica a imposição de emparelhamentos criados pela configuração de conectividade. 'Imposto'
'Não aplicado' (obrigatório)

ConnectivityGroupItem

Nome Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
'None' (obrigatório)
éGlobal Sinalizar se houver suporte global. Falso
'Verdade'
networkGroupId ID do grupo de rede. cadeia de caracteres (obrigatório)
useHubGateway Sinalizar se for necessário usar o gateway do hub. Falso
'Verdade'

Núcleo

Nome Descrição Valor
ID do recurso ID do recurso. cadeia
tipoDeRecurso Tipo de recurso. cadeia

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo Descrição
Criar um Gerenciador de Rede Virtual do Azure e VNETs de exemplo

Implantar no Azure
Esse modelo implanta um Gerenciador de Rede Virtual do Azure e uma amostra de redes virtuais no grupo de recursos nomeado. Ele dá suporte a várias topologias de conectividade e tipos de associação de grupo de rede.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso networkManagers/connectivityConfigurations pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkManagers/connectivityConfigurations@2025-03-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      appliesToGroups = [
        {
          groupConnectivity = "string"
          isGlobal = "string"
          networkGroupId = "string"
          useHubGateway = "string"
        }
      ]
      connectivityCapabilities = {
        connectedGroupAddressOverlap = "string"
        connectedGroupPrivateEndpointsScale = "string"
        peeringEnforcement = "string"
      }
      connectivityTopology = "string"
      deleteExistingPeering = "string"
      description = "string"
      hubs = [
        {
          resourceId = "string"
          resourceType = "string"
        }
      ]
      isGlobal = "string"
    }
  }
}

Valores de propriedade

Microsoft.Network/networkManagers/connectivityConfigurations

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: networkManagers
Propriedades Propriedades de uma configuração de conectividade do gerenciador de rede ConnectivityConfigurationProperties
tipo O tipo de recurso "Microsoft.Network/networkManagers/connectivityConfigurations@2025-03-01"

ConnectivityConfigurationProperties

Nome Descrição Valor
appliesToGroups Grupos para configuração ConnectivityGroupItem [] (obrigatório)
conectividadeRecursos Coleção de configurações adicionais para aprimorar comportamentos de topologia específicos do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
excluirExistenteEmparelhamento Sinalizar se for necessário remover os emparelhamentos existentes atuais. Falso
'Verdade'
descrição Uma descrição da configuração de conectividade. cadeia
Hubs Lista de hubItems Hub
éGlobal Sinalizar se houver suporte para malha global. Falso
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapabilities

Nome Descrição Valor
connectedGroupAddressOverlap Comportamento para lidar com o espaço de endereço IP sobreposto entre membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsEscala Opção que indica a escala de pontos de extremidade privados permitidos no grupo conectado da configuração de conectividade. 'Alta escala'
'Standard' (obrigatório)
peeringEnforcement Opção que indica a imposição de emparelhamentos criados pela configuração de conectividade. 'Imposto'
'Não aplicado' (obrigatório)

ConnectivityGroupItem

Nome Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
'None' (obrigatório)
éGlobal Sinalizar se houver suporte global. Falso
'Verdade'
networkGroupId ID do grupo de rede. cadeia de caracteres (obrigatório)
useHubGateway Sinalizar se for necessário usar o gateway do hub. Falso
'Verdade'

Núcleo

Nome Descrição Valor
ID do recurso ID do recurso. cadeia
tipoDeRecurso Tipo de recurso. cadeia

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação da Configuração de Conectividade do Gerenciador de Rede.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

data "azurerm_client_config" "current" {
}

data "azapi_resource" "subscription" {
  type                   = "Microsoft.Resources/subscriptions@2021-01-01"
  resource_id            = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  response_export_values = ["*"]
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "networkManager" {
  type      = "Microsoft.Network/networkManagers@2022-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description = ""
      networkManagerScopeAccesses = [
        "SecurityAdmin",
        "Connectivity",
      ]
      networkManagerScopes = {
        managementGroups = [
        ]
        subscriptions = [
          data.azapi_resource.subscription.id,
        ]
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      flowTimeoutInMinutes = 10
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "networkGroup" {
  type      = "Microsoft.Network/networkManagers/networkGroups@2022-09-01"
  parent_id = azapi_resource.networkManager.id
  name      = var.resource_name
  body = {
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "connectivityConfiguration" {
  type      = "Microsoft.Network/networkManagers/connectivityConfigurations@2022-09-01"
  parent_id = azapi_resource.networkManager.id
  name      = var.resource_name
  body = {
    properties = {
      appliesToGroups = [
        {
          groupConnectivity = "None"
          isGlobal          = "False"
          networkGroupId    = azapi_resource.networkGroup.id
          useHubGateway     = "False"
        },
      ]
      connectivityTopology  = "HubAndSpoke"
      deleteExistingPeering = "False"
      hubs = [
        {
          resourceId   = azapi_resource.virtualNetwork.id
          resourceType = azapi_resource.virtualNetwork.output.type
        },
      ]
      isGlobal = "False"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}