Lab/virtualnetworks Microsoft.DevTestLab

Definisi sumber daya Bicep

Jenis sumber daya labs/virtualnetworks dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya - Lihat perintah penyebaran grup sumber daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Contoh Penggunaan

Sampel Bicep

Contoh dasar penyebaran Virtual Network dalam DevTest Lab.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource lab 'Microsoft.DevTestLab/labs@2018-09-15' = {
  name: resourceName
  location: location
  properties: {
    labStorageType: 'Premium'
  }
}

resource virtualNetwork 'Microsoft.DevTestLab/labs/virtualNetworks@2018-09-15' = {
  name: resourceName
  parent: lab
  properties: {
    description: ''
    subnetOverrides: [
      {
        labSubnetName: '${resourceName}Subnet'
        resourceId: resourceId(
          'Microsoft.Network/virtualNetworks/subnets',
          resourceGroup().name,
          resourceName,
          '${resourceName}Subnet'
        )
        useInVmCreationPermission: 'Allow'
        usePublicIpAddressPermission: 'Allow'
      }
    ]
  }
}

Sampel Mulai Cepat Azure

Templat Mulai Cepat Azure berikut ini berisi sampel Bicep untuk menyebarkan jenis sumber daya ini.

File Bisep Description
Membuat lab di Azure DevTest Labs dengan VM yang diklaim Templat ini membuat instans DevTest Lab / DTL baru dengan VM Pusat Data Server Windows 2019 yang diklaim di dalamnya. Templat Mulai Cepat Azure Resource Manager lainnya untuk Azure DevTest Labs tersedia di https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

Format sumber daya

Untuk membuat sumber daya Microsoft.DevTestLab/labs/virtualnetworks, tambahkan Bicep berikut ke templat Anda.

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

Nilai Properti

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
lokasi Lokasi geografis tempat sumber daya berada string
name Nama sumber daya string (diperlukan)
induk Di Bicep, Anda dapat menentukan sumber daya induk untuk sumber daya anak. Anda hanya perlu menambahkan properti ini ketika sumber daya anak dideklarasikan di luar sumber daya induk.

Untuk informasi selengkapnya, lihat sumber daya Turunan di luar sumber daya induk.
Nama simbolis untuk sumber daya jenis: lab
properties Properti sumber daya. VirtualNetworkProperties (wajib)
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat

Port

Name Description Value
backendPort Port backend dari komputer virtual target. int
transportProtocol Jenis protokol port. 'Tcp'
'Udp'

Subnet

Name Description Value
allowPublicIp Kebijakan izin subnet untuk mengizinkan alamat IP publik (yaitu Izinkan, Tolak)). 'Allow'
'Default'
'Deny'
labSubnetName Nama subnet seperti yang terlihat di lab. string
resourceId ID sumber daya subnet. string

SubnetOverride

Name Description Value
labSubnetName Nama yang diberikan ke subnet dalam lab. string
resourceId ID sumber daya subnet. string
sharedPublicIpAddressConfiguration Properti yang akan dibagikan oleh komputer virtual pada subnet ini. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Menunjukkan apakah subnet ini dapat digunakan selama pembuatan komputer virtual (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Menunjukkan apakah alamat IP publik dapat ditetapkan ke komputer virtual pada subnet ini (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Kumpulan jaringan virtual yang terkait dengan subnet ini. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Port backend yang diizinkan untuk diekspos oleh komputer virtual pada subnet ini Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subnet yang diizinkan dari jaringan virtual. Subnet[]
description Deskripsi jaringan virtual. string
externalProviderResourceId Pengidentifikasi sumber daya Microsoft.Network dari jaringan virtual. string
subnetOverrides Subnet mengambil alih jaringan virtual. SubnetOverride[]

VirtualNetworkTags

Name Description Value

Definisi sumber daya templat ARM

Jenis sumber daya labs/virtualnetworks dapat disebarkan dengan operasi yang menargetkan:

Contoh Penggunaan

Templat Quickstart Azure

Templat Mulai Cepat Azure berikut ini menyebarkan jenis sumber daya ini.

Template Description
Membuat lab di Azure DevTest Labs dengan VM yang diklaim

Sebarkan ke Azure
Templat ini membuat instans DevTest Lab / DTL baru dengan VM Pusat Data Server Windows 2019 yang diklaim di dalamnya. Templat Mulai Cepat Azure Resource Manager lainnya untuk Azure DevTest Labs tersedia di https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

Format sumber daya

Untuk membuat sumber daya Microsoft.DevTestLab/labs/virtualnetworks, tambahkan JSON berikut ke templat Anda.

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

Nilai Properti

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
apiVersion Versi api '2018-09-15'
lokasi Lokasi geografis tempat sumber daya berada string
name Nama sumber daya string (diperlukan)
properties Properti sumber daya. VirtualNetworkProperties (wajib)
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat
jenis Jenis sumber daya 'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name Description Value
backendPort Port backend dari komputer virtual target. int
transportProtocol Jenis protokol port. 'Tcp'
'Udp'

Subnet

Name Description Value
allowPublicIp Kebijakan izin subnet untuk mengizinkan alamat IP publik (yaitu Izinkan, Tolak)). 'Allow'
'Default'
'Deny'
labSubnetName Nama subnet seperti yang terlihat di lab. string
resourceId ID sumber daya subnet. string

SubnetOverride

Name Description Value
labSubnetName Nama yang diberikan ke subnet dalam lab. string
resourceId ID sumber daya subnet. string
sharedPublicIpAddressConfiguration Properti yang akan dibagikan oleh komputer virtual pada subnet ini. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Menunjukkan apakah subnet ini dapat digunakan selama pembuatan komputer virtual (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Menunjukkan apakah alamat IP publik dapat ditetapkan ke komputer virtual pada subnet ini (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Kumpulan jaringan virtual yang terkait dengan subnet ini. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Port backend yang diizinkan untuk diekspos oleh komputer virtual pada subnet ini Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subnet yang diizinkan dari jaringan virtual. Subnet[]
description Deskripsi jaringan virtual. string
externalProviderResourceId Pengidentifikasi sumber daya Microsoft.Network dari jaringan virtual. string
subnetOverrides Subnet mengambil alih jaringan virtual. SubnetOverride[]

VirtualNetworkTags

Name Description Value

Definisi sumber daya Terraform (penyedia AzAPI)

Jenis sumber daya labs/virtualnetworks dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.

Contoh Penggunaan

Sampel Terraform

Contoh dasar penyebaran Virtual Network dalam DevTest Lab.

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

Format sumber daya

Untuk membuat sumber daya Microsoft.DevTestLab/labs/virtualnetworks, tambahkan Terraform berikut ke templat Anda.

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

Nilai Properti

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
lokasi Lokasi geografis tempat sumber daya berada string
name Nama sumber daya string (diperlukan)
parent_id ID sumber daya yang merupakan induk untuk sumber daya ini. ID untuk sumber daya jenis: lab
properties Properti sumber daya. VirtualNetworkProperties (wajib)
tags Tag sumber daya Kamus nama dan nilai tag.
jenis Jenis sumber daya "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name Description Value
backendPort Port backend dari komputer virtual target. int
transportProtocol Jenis protokol port. 'Tcp'
'Udp'

Subnet

Name Description Value
allowPublicIp Kebijakan izin subnet untuk mengizinkan alamat IP publik (yaitu Izinkan, Tolak)). 'Allow'
'Default'
'Deny'
labSubnetName Nama subnet seperti yang terlihat di lab. string
resourceId ID sumber daya subnet. string

SubnetOverride

Name Description Value
labSubnetName Nama yang diberikan ke subnet dalam lab. string
resourceId ID sumber daya subnet. string
sharedPublicIpAddressConfiguration Properti yang akan dibagikan oleh komputer virtual pada subnet ini. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Menunjukkan apakah subnet ini dapat digunakan selama pembuatan komputer virtual (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Menunjukkan apakah alamat IP publik dapat ditetapkan ke komputer virtual pada subnet ini (yaitu Izinkan, Tolak). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Kumpulan jaringan virtual yang terkait dengan subnet ini. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Port backend yang diizinkan untuk diekspos oleh komputer virtual pada subnet ini Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subnet yang diizinkan dari jaringan virtual. Subnet[]
description Deskripsi jaringan virtual. string
externalProviderResourceId Pengidentifikasi sumber daya Microsoft.Network dari jaringan virtual. string
subnetOverrides Subnet mengambil alih jaringan virtual. SubnetOverride[]

VirtualNetworkTags

Name Description Value