Delen via


Labs/virtuele netwerken van Microsoft.DevTestLab

Bicep-resourcedefinitie

Het resourcetype labs/virtualnetworks kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevTestLab/labs/virtualnetworks-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location De locatie van de resource. string
name De resourcenaam tekenreeks (vereist)
parent In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: labs
properties De eigenschappen van de resource. VirtualNetworkProperties (verplicht)
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

Port

Name Description Value
backendPort Back-endpoort van de virtuele doelmachine. int
transportProtocol Protocoltype van de poort. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Het machtigingsbeleid van het subnet voor het toestaan van openbare IP-adressen (bijvoorbeeld Toestaan, Weigeren)). 'Allow'
'Default'
'Deny'
labSubnetName De naam van het subnet, zoals te zien is in het lab. string
resourceId De resource-id van het subnet. string

SubnetOverride

Name Description Value
labSubnetName De naam die aan het subnet in het lab wordt gegeven. string
resourceId De resource-id van het subnet. string
sharedPublicIpAddressConfiguration Eigenschappen die virtuele machines in dit subnet delen. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Hiermee wordt aangegeven of dit subnet kan worden gebruikt tijdens het maken van virtuele machines (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Hiermee wordt aangegeven of openbare IP-adressen kunnen worden toegewezen aan virtuele machines in dit subnet (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName De virtuele netwerkgroep die is gekoppeld aan dit subnet. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Back-endpoorten die virtuele machines in dit subnet beschikbaar mogen maken Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets De toegestane subnetten van het virtuele netwerk. Subnet[]
description De beschrijving van het virtuele netwerk. string
externalProviderResourceId De resource-id van Microsoft.Network van het virtuele netwerk. string
subnetOverrides Het subnet overschrijft het virtuele netwerk. SubnetOverride[]

Gebruiksvoorbeelden

Azure-snelstartvoorbeelden

De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.

Bicep-bestand Description
Maakt een lab in Azure DevTest Labs met een geclaimde VM- Met deze sjabloon maakt u een nieuw DevTest Lab/DTL-exemplaar met daarin een geclaimde Virtuele Machine met Windows Server 2019 Datacenter. Meer Azure Resource Manager-quickstartsjablonen voor Azure DevTest Labs die beschikbaar zijn op https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Resourcedefinitie van ARM-sjabloon

Het resourcetype labs/virtualnetworks kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevTestLab/labs/virtualnetworks-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
apiVersion De API-versie '2018-09-15'
location De locatie van de resource. string
name De resourcenaam tekenreeks (vereist)
properties De eigenschappen van de resource. VirtualNetworkProperties (verplicht)
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name Description Value
backendPort Back-endpoort van de virtuele doelmachine. int
transportProtocol Protocoltype van de poort. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Het machtigingsbeleid van het subnet voor het toestaan van openbare IP-adressen (bijvoorbeeld Toestaan, Weigeren)). 'Allow'
'Default'
'Deny'
labSubnetName De naam van het subnet, zoals te zien is in het lab. string
resourceId De resource-id van het subnet. string

SubnetOverride

Name Description Value
labSubnetName De naam die aan het subnet in het lab wordt gegeven. string
resourceId De resource-id van het subnet. string
sharedPublicIpAddressConfiguration Eigenschappen die virtuele machines in dit subnet delen. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Hiermee wordt aangegeven of dit subnet kan worden gebruikt tijdens het maken van virtuele machines (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Hiermee wordt aangegeven of openbare IP-adressen kunnen worden toegewezen aan virtuele machines in dit subnet (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName De virtuele netwerkgroep die is gekoppeld aan dit subnet. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Back-endpoorten die virtuele machines in dit subnet beschikbaar mogen maken Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets De toegestane subnetten van het virtuele netwerk. Subnet[]
description De beschrijving van het virtuele netwerk. string
externalProviderResourceId De resource-id van Microsoft.Network van het virtuele netwerk. string
subnetOverrides Het subnet overschrijft het virtuele netwerk. SubnetOverride[]

Gebruiksvoorbeelden

Azure-snelstartsjablonen

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Template Description
Maakt een lab in Azure DevTest Labs met een geclaimde VM-

implementeren in Azure
Met deze sjabloon maakt u een nieuw DevTest Lab/DTL-exemplaar met daarin een geclaimde Virtuele Machine met Windows Server 2019 Datacenter. Meer Azure Resource Manager-quickstartsjablonen voor Azure DevTest Labs die beschikbaar zijn op https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype labs/virtualnetworks kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevTestLab/labs/virtualnetworks-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location De locatie van de resource. string
name De resourcenaam tekenreeks (vereist)
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: labs
properties De eigenschappen van de resource. VirtualNetworkProperties (verplicht)
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name Description Value
backendPort Back-endpoort van de virtuele doelmachine. int
transportProtocol Protocoltype van de poort. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Het machtigingsbeleid van het subnet voor het toestaan van openbare IP-adressen (bijvoorbeeld Toestaan, Weigeren)). 'Allow'
'Default'
'Deny'
labSubnetName De naam van het subnet, zoals te zien is in het lab. string
resourceId De resource-id van het subnet. string

SubnetOverride

Name Description Value
labSubnetName De naam die aan het subnet in het lab wordt gegeven. string
resourceId De resource-id van het subnet. string
sharedPublicIpAddressConfiguration Eigenschappen die virtuele machines in dit subnet delen. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Hiermee wordt aangegeven of dit subnet kan worden gebruikt tijdens het maken van virtuele machines (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Hiermee wordt aangegeven of openbare IP-adressen kunnen worden toegewezen aan virtuele machines in dit subnet (bijvoorbeeld Toestaan, Weigeren). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName De virtuele netwerkgroep die is gekoppeld aan dit subnet. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Back-endpoorten die virtuele machines in dit subnet beschikbaar mogen maken Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets De toegestane subnetten van het virtuele netwerk. Subnet[]
description De beschrijving van het virtuele netwerk. string
externalProviderResourceId De resource-id van Microsoft.Network van het virtuele netwerk. string
subnetOverrides Het subnet overschrijft het virtuele netwerk. SubnetOverride[]

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van Virtual Network binnen een 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    = ["*"]
}