다음을 통해 공유


Microsoft.Network 네트워크관리자/연결구성

Bicep 리소스 정의

networkManagers/connectivityConfigurations 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/networkManagers/connectivityConfigurations 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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

속성 값

Microsoft.Network/networkManagers/connectivityConfigurations

이름 묘사
이름 리소스 이름 string(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.
형식의 리소스에 대한 기호 이름: networkManagers
속성 네트워크 관리자 연결 구성의 속성 연결성구성속성

연결성구성속성

이름 묘사
그룹에 적용 구성을 위한 그룹 ConnectivityGroupItem[] (필수)
연결성기능 연결 구성 리소스의 특정 토폴로지 동작을 향상시키기 위한 추가 설정 모음입니다. 연결ConfigurationPropertiesConnectivityCapabilities
연결토폴로지 연결 토폴로지 유형입니다. '허브앤스포크'
'Mesh'(필수)
deleteExisting피어링 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다. 거짓
'참'
묘사 연결 구성에 대한 설명입니다. 문자열
허브 hubItems 목록 허브[]
is글로벌 전역 메시가 지원되는 경우 플래그를 지정합니다. 거짓
'참'

연결ConfigurationPropertiesConnectivityCapabilities

이름 묘사
connectedGroupAddressOverlap 연결 구성의 연결된 그룹 멤버 간에 중복된 IP 주소 공간을 처리하는 동작입니다. '허용됨'
'허용되지 않음'(필수)
connectedGroupPrivateEndpoints확장 연결 구성의 연결된 그룹에서 허용되는 프라이빗 엔드포인트의 크기를 나타내는 옵션입니다. '하이스케일'
'Standard'(필수)
피어링시행 연결 구성에 의해 생성된 피어링의 적용을 나타내는 옵션입니다. '적용됨'
'Unenforced'(필수)

연결성GroupItem

이름 묘사
그룹커넥티비티 그룹 연결 유형입니다. '직접 연결됨'
'None'(필수)
is글로벌 전역이 지원되는 경우 플래그를 지정합니다. 거짓
'참'
네트워크 그룹 ID 네트워크 그룹 ID입니다. string(필수)
useHubGateway 허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다. 거짓
'참'

허브

이름 묘사
리소스ID 리소스 ID입니다. 문자열
리소스 유형 리소스 종류입니다. 문자열

사용 예제

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일 묘사
Azure Virtual Network Manager 및 샘플 VNET 만들기 이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다.

ARM 템플릿 리소스 정의

networkManagers/connectivityConfigurations 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/networkManagers/connectivityConfigurations 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

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

속성 값

Microsoft.Network/networkManagers/connectivityConfigurations

이름 묘사
API버전 api 버전 '2025-03-01'
이름 리소스 이름 string(필수)
속성 네트워크 관리자 연결 구성의 속성 연결성구성속성
리소스 종류 'Microsoft.Network/networkManagers/connectivityConfigurations'

연결성구성속성

이름 묘사
그룹에 적용 구성을 위한 그룹 ConnectivityGroupItem[] (필수)
연결성기능 연결 구성 리소스의 특정 토폴로지 동작을 향상시키기 위한 추가 설정 모음입니다. 연결ConfigurationPropertiesConnectivityCapabilities
연결토폴로지 연결 토폴로지 유형입니다. '허브앤스포크'
'Mesh'(필수)
deleteExisting피어링 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다. 거짓
'참'
묘사 연결 구성에 대한 설명입니다. 문자열
허브 hubItems 목록 허브[]
is글로벌 전역 메시가 지원되는 경우 플래그를 지정합니다. 거짓
'참'

연결ConfigurationPropertiesConnectivityCapabilities

이름 묘사
connectedGroupAddressOverlap 연결 구성의 연결된 그룹 멤버 간에 중복된 IP 주소 공간을 처리하는 동작입니다. '허용됨'
'허용되지 않음'(필수)
connectedGroupPrivateEndpoints확장 연결 구성의 연결된 그룹에서 허용되는 프라이빗 엔드포인트의 크기를 나타내는 옵션입니다. '하이스케일'
'Standard'(필수)
피어링시행 연결 구성에 의해 생성된 피어링의 적용을 나타내는 옵션입니다. '적용됨'
'Unenforced'(필수)

연결성GroupItem

이름 묘사
그룹커넥티비티 그룹 연결 유형입니다. '직접 연결됨'
'None'(필수)
is글로벌 전역이 지원되는 경우 플래그를 지정합니다. 거짓
'참'
네트워크 그룹 ID 네트워크 그룹 ID입니다. string(필수)
useHubGateway 허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다. 거짓
'참'

허브

이름 묘사
리소스ID 리소스 ID입니다. 문자열
리소스 유형 리소스 종류입니다. 문자열

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛 묘사
Azure Virtual Network Manager 및 샘플 VNET 만들기

Azure 배포
이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다.

Terraform(AzAPI 공급자) 리소스 정의

networkManagers/connectivityConfigurations 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/networkManagers/connectivityConfigurations 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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

속성 값

Microsoft.Network/networkManagers/connectivityConfigurations

이름 묘사
이름 리소스 이름 string(필수)
부모 ID 이 리소스의 부모인 리소스의 ID입니다. 유형의 리소스 ID: networkManagers
속성 네트워크 관리자 연결 구성의 속성 연결성구성속성
리소스 종류 "Microsoft.Network/networkManagers/connectivityConfigurations@2025-03-01"

연결성구성속성

이름 묘사
그룹에 적용 구성을 위한 그룹 ConnectivityGroupItem[] (필수)
연결성기능 연결 구성 리소스의 특정 토폴로지 동작을 향상시키기 위한 추가 설정 모음입니다. 연결ConfigurationPropertiesConnectivityCapabilities
연결토폴로지 연결 토폴로지 유형입니다. '허브앤스포크'
'Mesh'(필수)
deleteExisting피어링 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다. 거짓
'참'
묘사 연결 구성에 대한 설명입니다. 문자열
허브 hubItems 목록 허브[]
is글로벌 전역 메시가 지원되는 경우 플래그를 지정합니다. 거짓
'참'

연결ConfigurationPropertiesConnectivityCapabilities

이름 묘사
connectedGroupAddressOverlap 연결 구성의 연결된 그룹 멤버 간에 중복된 IP 주소 공간을 처리하는 동작입니다. '허용됨'
'허용되지 않음'(필수)
connectedGroupPrivateEndpoints확장 연결 구성의 연결된 그룹에서 허용되는 프라이빗 엔드포인트의 크기를 나타내는 옵션입니다. '하이스케일'
'Standard'(필수)
피어링시행 연결 구성에 의해 생성된 피어링의 적용을 나타내는 옵션입니다. '적용됨'
'Unenforced'(필수)

연결성GroupItem

이름 묘사
그룹커넥티비티 그룹 연결 유형입니다. '직접 연결됨'
'None'(필수)
is글로벌 전역이 지원되는 경우 플래그를 지정합니다. 거짓
'참'
네트워크 그룹 ID 네트워크 그룹 ID입니다. string(필수)
useHubGateway 허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다. 거짓
'참'

허브

이름 묘사
리소스ID 리소스 ID입니다. 문자열
리소스 유형 리소스 종류입니다. 문자열

사용 예제

Terraform 샘플

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