Compartir a través de


Microsoft.DevTestLab labs/virtualnetworks

Definición de recursos de Bicep

El tipo de recurso labs/virtualnetworks se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs/virtualnetworks, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
parent En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: laboratorios
properties Propiedades del recurso. VirtualNetworkProperties (obligatorio)
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

Port

Name Description Value
backendPort Puerto back-end de la máquina virtual de destino. int
transportProtocol Tipo de protocolo del puerto. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Directiva de permisos de la subred para permitir direcciones IP públicas (es decir, Permitir, Denegar)). 'Allow'
'Default'
'Deny'
labSubnetName Nombre de la subred tal como se ve en el laboratorio. string
resourceId Identificador de recurso de la subred. string

SubnetOverride

Name Description Value
labSubnetName Nombre asignado a la subred dentro del laboratorio. string
resourceId Identificador de recurso de la subred. string
sharedPublicIpAddressConfiguration Propiedades que compartirán las máquinas virtuales de esta subred. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indica si esta subred se puede usar durante la creación de la máquina virtual (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indica si las direcciones IP públicas se pueden asignar a las máquinas virtuales de esta subred (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Grupo de redes virtuales asociado a esta subred. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Los puertos back-end que las máquinas virtuales de esta subred pueden exponer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subredes permitidas de la red virtual. Subnet[]
description Descripción de la red virtual. string
externalProviderResourceId Identificador de recurso Microsoft.Network de la red virtual. string
subnetOverrides La subred invalida la red virtual. SubnetOverride[]

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Description
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de plantilla de ARM

El tipo de recurso labs/virtualnetworks se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs/virtualnetworks, agregue el siguiente JSON a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
apiVersion La versión de api '2018-09-15'
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
properties Propiedades del recurso. VirtualNetworkProperties (obligatorio)
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type El tipo de recurso 'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name Description Value
backendPort Puerto back-end de la máquina virtual de destino. int
transportProtocol Tipo de protocolo del puerto. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Directiva de permisos de la subred para permitir direcciones IP públicas (es decir, Permitir, Denegar)). 'Allow'
'Default'
'Deny'
labSubnetName Nombre de la subred tal como se ve en el laboratorio. string
resourceId Identificador de recurso de la subred. string

SubnetOverride

Name Description Value
labSubnetName Nombre asignado a la subred dentro del laboratorio. string
resourceId Identificador de recurso de la subred. string
sharedPublicIpAddressConfiguration Propiedades que compartirán las máquinas virtuales de esta subred. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indica si esta subred se puede usar durante la creación de la máquina virtual (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indica si las direcciones IP públicas se pueden asignar a las máquinas virtuales de esta subred (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Grupo de redes virtuales asociado a esta subred. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Los puertos back-end que las máquinas virtuales de esta subred pueden exponer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subredes permitidas de la red virtual. Subnet[]
description Descripción de la red virtual. string
externalProviderResourceId Identificador de recurso Microsoft.Network de la red virtual. string
subnetOverrides La subred invalida la red virtual. SubnetOverride[]

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada

Implementación en Azure
Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso labs/virtualnetworks se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs/virtualnetworks, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: laboratorios
properties Propiedades del recurso. VirtualNetworkProperties (obligatorio)
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name Description Value
backendPort Puerto back-end de la máquina virtual de destino. int
transportProtocol Tipo de protocolo del puerto. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Directiva de permisos de la subred para permitir direcciones IP públicas (es decir, Permitir, Denegar)). 'Allow'
'Default'
'Deny'
labSubnetName Nombre de la subred tal como se ve en el laboratorio. string
resourceId Identificador de recurso de la subred. string

SubnetOverride

Name Description Value
labSubnetName Nombre asignado a la subred dentro del laboratorio. string
resourceId Identificador de recurso de la subred. string
sharedPublicIpAddressConfiguration Propiedades que compartirán las máquinas virtuales de esta subred. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indica si esta subred se puede usar durante la creación de la máquina virtual (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indica si las direcciones IP públicas se pueden asignar a las máquinas virtuales de esta subred (es decir, Permitir, Denegar). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Grupo de redes virtuales asociado a esta subred. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Los puertos back-end que las máquinas virtuales de esta subred pueden exponer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Subredes permitidas de la red virtual. Subnet[]
description Descripción de la red virtual. string
externalProviderResourceId Identificador de recurso Microsoft.Network de la red virtual. string
subnetOverrides La subred invalida la red virtual. SubnetOverride[]

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de Virtual Network dentro de un laboratorio de DevTest.

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