다음을 통해 공유


Microsoft.DevTestLab 랩/가상 네트워크

Bicep 리소스 정의

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

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

리소스 형식

Microsoft.DevTestLab/labs/virtualnetworks 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15' = {
  parent: resourceSymbolicName
  ___location: 'string'
  name: 'string'
  properties: {
    allowedSubnets: [
      {
        allowPublicIp: 'string'
        labSubnetName: 'string'
        resourceId: 'string'
      }
    ]
    description: 'string'
    externalProviderResourceId: 'string'
    subnetOverrides: [
      {
        labSubnetName: 'string'
        resourceId: 'string'
        sharedPublicIpAddressConfiguration: {
          allowedPorts: [
            {
              backendPort: int
              transportProtocol: 'string'
            }
          ]
        }
        useInVmCreationPermission: 'string'
        usePublicIpAddressPermission: 'string'
        virtualNetworkPoolName: 'string'
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
___location 리소스의 위치입니다. string
name 리소스 이름 string(필수)
parent Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.
형식 리소스의 기호 이름:
properties 리소스의 속성입니다. VirtualNetworkProperties (필수)
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

Port

Name Description Value
backendPort 대상 가상 머신의 백 엔드 포트입니다. int
transportProtocol 포트의 프로토콜 유형입니다. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp 공용 IP 주소(예: 허용, 거부)를 허용하기 위한 서브넷의 권한 정책입니다. 'Allow'
'Default'
'Deny'
labSubnetName 랩에 표시된 서브넷의 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string

SubnetOverride

Name Description Value
labSubnetName 랩 내의 서브넷에 지정된 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string
sharedPublicIpAddressConfiguration 이 서브넷의 가상 머신이 공유할 속성입니다. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission 가상 머신을 만드는 동안 이 서브넷을 사용할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission 공용 IP 주소를 이 서브넷의 가상 머신에 할당할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName 이 서브넷과 연결된 가상 네트워크 풀입니다. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts 이 서브넷의 가상 머신에서 노출할 수 있는 백 엔드 포트 Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets 가상 네트워크의 허용된 서브넷입니다. Subnet[]
description 가상 네트워크에 대한 설명입니다. string
externalProviderResourceId 가상 네트워크의 Microsoft.Network 리소스 식별자입니다. string
subnetOverrides 가상 네트워크의 서브넷 재정의입니다. SubnetOverride[]

사용 예제

Azure 빠른 시작 샘플

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

Bicep 파일 Description
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다. 이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

ARM 템플릿 리소스 정의

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

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

리소스 형식

Microsoft.DevTestLab/labs/virtualnetworks 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DevTestLab/labs/virtualnetworks",
  "apiVersion": "2018-09-15",
  "name": "string",
  "___location": "string",
  "properties": {
    "allowedSubnets": [
      {
        "allowPublicIp": "string",
        "labSubnetName": "string",
        "resourceId": "string"
      }
    ],
    "description": "string",
    "externalProviderResourceId": "string",
    "subnetOverrides": [
      {
        "labSubnetName": "string",
        "resourceId": "string",
        "sharedPublicIpAddressConfiguration": {
          "allowedPorts": [
            {
              "backendPort": "int",
              "transportProtocol": "string"
            }
          ]
        },
        "useInVmCreationPermission": "string",
        "usePublicIpAddressPermission": "string",
        "virtualNetworkPoolName": "string"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
apiVersion api 버전 '2018-09-15'
___location 리소스의 위치입니다. string
name 리소스 이름 string(필수)
properties 리소스의 속성입니다. VirtualNetworkProperties (필수)
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
type 리소스 종류 'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name Description Value
backendPort 대상 가상 머신의 백 엔드 포트입니다. int
transportProtocol 포트의 프로토콜 유형입니다. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp 공용 IP 주소(예: 허용, 거부)를 허용하기 위한 서브넷의 권한 정책입니다. 'Allow'
'Default'
'Deny'
labSubnetName 랩에 표시된 서브넷의 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string

SubnetOverride

Name Description Value
labSubnetName 랩 내의 서브넷에 지정된 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string
sharedPublicIpAddressConfiguration 이 서브넷의 가상 머신이 공유할 속성입니다. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission 가상 머신을 만드는 동안 이 서브넷을 사용할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission 공용 IP 주소를 이 서브넷의 가상 머신에 할당할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName 이 서브넷과 연결된 가상 네트워크 풀입니다. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts 이 서브넷의 가상 머신에서 노출할 수 있는 백 엔드 포트 Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets 가상 네트워크의 허용된 서브넷입니다. Subnet[]
description 가상 네트워크에 대한 설명입니다. string
externalProviderResourceId 가상 네트워크의 Microsoft.Network 리소스 식별자입니다. string
subnetOverrides 가상 네트워크의 서브넷 재정의입니다. SubnetOverride[]

사용 예제

Azure 빠른 시작 템플릿

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

Template Description
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다.

Azure 배포
이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

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

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

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

리소스 형식

Microsoft.DevTestLab/labs/virtualnetworks 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"
  name = "string"
  parent_id = "string"
  ___location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowedSubnets = [
        {
          allowPublicIp = "string"
          labSubnetName = "string"
          resourceId = "string"
        }
      ]
      description = "string"
      externalProviderResourceId = "string"
      subnetOverrides = [
        {
          labSubnetName = "string"
          resourceId = "string"
          sharedPublicIpAddressConfiguration = {
            allowedPorts = [
              {
                backendPort = int
                transportProtocol = "string"
              }
            ]
          }
          useInVmCreationPermission = "string"
          usePublicIpAddressPermission = "string"
          virtualNetworkPoolName = "string"
        }
      ]
    }
  }
}

속성 값

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
___location 리소스의 위치입니다. string
name 리소스 이름 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 형식 리소스에 대한 ID:
properties 리소스의 속성입니다. VirtualNetworkProperties (필수)
tags 리소스 태그 태그 이름 및 값의 사전입니다.
type 리소스 종류 "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name Description Value
backendPort 대상 가상 머신의 백 엔드 포트입니다. int
transportProtocol 포트의 프로토콜 유형입니다. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp 공용 IP 주소(예: 허용, 거부)를 허용하기 위한 서브넷의 권한 정책입니다. 'Allow'
'Default'
'Deny'
labSubnetName 랩에 표시된 서브넷의 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string

SubnetOverride

Name Description Value
labSubnetName 랩 내의 서브넷에 지정된 이름입니다. string
resourceId 서브넷의 리소스 ID입니다. string
sharedPublicIpAddressConfiguration 이 서브넷의 가상 머신이 공유할 속성입니다. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission 가상 머신을 만드는 동안 이 서브넷을 사용할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission 공용 IP 주소를 이 서브넷의 가상 머신에 할당할 수 있는지 여부를 나타냅니다(예: 허용, 거부). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName 이 서브넷과 연결된 가상 네트워크 풀입니다. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts 이 서브넷의 가상 머신에서 노출할 수 있는 백 엔드 포트 Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets 가상 네트워크의 허용된 서브넷입니다. Subnet[]
description 가상 네트워크에 대한 설명입니다. string
externalProviderResourceId 가상 네트워크의 Microsoft.Network 리소스 식별자입니다. string
subnetOverrides 가상 네트워크의 서브넷 재정의입니다. SubnetOverride[]

사용 예제

Terraform 샘플

DevTest 랩 내에서 Virtual Network를 배포하는 기본 예제입니다.

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

resource "azapi_resource" "lab" {
  type      = "Microsoft.DevTestLab/labs@2018-09-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  ___location  = var.___location
  body = {
    properties = {
      labStorageType = "Premium"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2023-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
}

data "azapi_resource_id" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2023-04-01"
  parent_id = data.azapi_resource_id.virtualNetwork.id
  name      = "${var.resource_name}Subnet"
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.DevTestLab/labs/virtualNetworks@2018-09-15"
  parent_id = azapi_resource.lab.id
  name      = var.resource_name
  body = {
    properties = {
      description = ""
      subnetOverrides = [
        {
          labSubnetName                = data.azapi_resource_id.subnet.name
          resourceId                   = data.azapi_resource_id.subnet.id
          useInVmCreationPermission    = "Allow"
          usePublicIpAddressPermission = "Allow"
        },
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}