Partilhar via


Microsoft.Network networkManagers/connectivityConfigurations

Definição de recursos do bíceps

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

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

Formato do recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o seguinte Bicep ao seu 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

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
elemento principal 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 recurso do tipo: networkManagers
propriedades Propriedades de uma configuração de conectividade do gerenciador de rede ConnectivityConfigurationProperties

ConnectivityConfigurationProperties

Designação Descrição Valor
aplica-seToGroups Grupos para configuração ConnectivityGroupItem[] (obrigatório)
conectividadeCapacidades Coleção de configurações adicionais para aprimorar comportamentos específicos de topologia do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
deleteExistingPeering Sinalize se necessário remover os emparelhamentos existentes atuais. 'Falso'
'Verdade'
Descrição Uma descrição da configuração de conectividade. cadeia (de caracteres)
centros Lista de hubItems Hub[]
isGlobal Sinalize se a malha global for suportada. 'Falso'
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades

Designação Descrição Valor
connectedGroupAddressOverlap Comportamento para manipular o espaço de endereço IP sobreposto entre os membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsScale Opção que indica a escala de pontos finais 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. 'Cumprido'
'Não executado' (obrigatório)

ConnectivityGroupItem

Designação Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
«Nenhum» (obrigatório)
isGlobal Sinalize se global for suportado. 'Falso'
'Verdade'
networkGroupId Id do grupo de rede. string (obrigatório)
useHubGateway Sinalize se necessário usar o gateway de hub. 'Falso'
'Verdade'

Núcleo

Designação Descrição Valor
identificadorDeRecurso Id do recurso. cadeia (de caracteres)
tipoDeRecurso Tipo de recurso. cadeia (de caracteres)

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar um Gerenciador de Rede Virtual do Azure e exemplos de VNETs Este modelo implanta um Gerenciador de Rede Virtual do Azure e redes virtuais de exemplo no grupo de recursos nomeado. Ele suporta várias topologias de conectividade e tipos de associação de grupo de rede.

Definição de recurso de modelo ARM

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

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

Formato do recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o seguinte JSON ao seu 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

Designação Descrição Valor
Versão da API A versão api '2025-03-01'
Designação O nome do recurso string (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

Designação Descrição Valor
aplica-seToGroups Grupos para configuração ConnectivityGroupItem[] (obrigatório)
conectividadeCapacidades Coleção de configurações adicionais para aprimorar comportamentos específicos de topologia do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
deleteExistingPeering Sinalize se necessário remover os emparelhamentos existentes atuais. 'Falso'
'Verdade'
Descrição Uma descrição da configuração de conectividade. cadeia (de caracteres)
centros Lista de hubItems Hub[]
isGlobal Sinalize se a malha global for suportada. 'Falso'
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades

Designação Descrição Valor
connectedGroupAddressOverlap Comportamento para manipular o espaço de endereço IP sobreposto entre os membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsScale Opção que indica a escala de pontos finais 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. 'Cumprido'
'Não executado' (obrigatório)

ConnectivityGroupItem

Designação Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
«Nenhum» (obrigatório)
isGlobal Sinalize se global for suportado. 'Falso'
'Verdade'
networkGroupId Id do grupo de rede. string (obrigatório)
useHubGateway Sinalize se necessário usar o gateway de hub. 'Falso'
'Verdade'

Núcleo

Designação Descrição Valor
identificadorDeRecurso Id do recurso. cadeia (de caracteres)
tipoDeRecurso Tipo de recurso. cadeia (de caracteres)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

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

Implantar no Azure
Este modelo implanta um Gerenciador de Rede Virtual do Azure e redes virtuais de exemplo no grupo de recursos nomeado. Ele suporta várias topologias de conectividade e tipos de associação de grupo de rede.

Definição de recursos Terraform (provedor AzAPI)

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

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

Formato do recurso

Para criar um recurso Microsoft.Network/networkManagers/connectivityConfigurations, adicione o seguinte Terraform 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

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este 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

Designação Descrição Valor
aplica-seToGroups Grupos para configuração ConnectivityGroupItem[] (obrigatório)
conectividadeCapacidades Coleção de configurações adicionais para aprimorar comportamentos específicos de topologia do recurso de configuração de conectividade. ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades
conectividadeTopologia Tipo de topologia de conectividade. 'HubAndSpoke'
'Malha' (obrigatório)
deleteExistingPeering Sinalize se necessário remover os emparelhamentos existentes atuais. 'Falso'
'Verdade'
Descrição Uma descrição da configuração de conectividade. cadeia (de caracteres)
centros Lista de hubItems Hub[]
isGlobal Sinalize se a malha global for suportada. 'Falso'
'Verdade'

ConectividadeConfiguraçãoPropriedadesConectividadeCapacidades

Designação Descrição Valor
connectedGroupAddressOverlap Comportamento para manipular o espaço de endereço IP sobreposto entre os membros do grupo conectado da configuração de conectividade. 'Permitido'
'Não permitido' (obrigatório)
connectedGroupPrivateEndpointsScale Opção que indica a escala de pontos finais 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. 'Cumprido'
'Não executado' (obrigatório)

ConnectivityGroupItem

Designação Descrição Valor
groupConnectivity Tipo de conectividade de grupo. 'Diretamente conectado'
«Nenhum» (obrigatório)
isGlobal Sinalize se global for suportado. 'Falso'
'Verdade'
networkGroupId Id do grupo de rede. string (obrigatório)
useHubGateway Sinalize se necessário usar o gateway de hub. 'Falso'
'Verdade'

Núcleo

Designação Descrição Valor
identificadorDeRecurso Id do recurso. cadeia (de caracteres)
tipoDeRecurso Tipo de recurso. cadeia (de caracteres)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação da Configuração de Conectividade do Network Manager.

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    = ["*"]
}