Partager via


Microsoft.DevTestLab laboratoires/réseaux virtuels

Définition de ressource Bicep

Le type de ressource labs/virtualnetworks peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevTestLab/labs/virtualnetworks, ajoutez le bicep suivant à votre modèle.

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

Valeurs de la propriété

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : labs
properties Propriétés de la ressource. VirtualNetworkProperties (obligatoire)
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

Port

Name Description Value
backendPort Port principal de la machine virtuelle cible. int
transportProtocol Type de protocole du port. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Stratégie d’autorisation du sous-réseau pour autoriser les adresses IP publiques (par exemple, Autoriser, Refuser)). 'Allow'
'Default'
'Deny'
labSubnetName Nom du sous-réseau tel qu’il apparaît dans le labo. string
resourceId ID de ressource du sous-réseau. string

SubnetOverride

Name Description Value
labSubnetName Nom donné au sous-réseau dans le labo. string
resourceId ID de ressource du sous-réseau. string
sharedPublicIpAddressConfiguration Propriétés que les machines virtuelles sur ce sous-réseau partageront. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indique si ce sous-réseau peut être utilisé lors de la création d’une machine virtuelle (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indique si les adresses IP publiques peuvent être affectées à des machines virtuelles sur ce sous-réseau (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Pool de réseaux virtuels associé à ce sous-réseau. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Les ports back-end que les machines virtuelles sur ce sous-réseau sont autorisés à exposer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Sous-réseaux autorisés du réseau virtuel. Subnet[]
description Description du réseau virtuel. string
externalProviderResourceId Identificateur de ressource Microsoft.Network du réseau virtuel. string
subnetOverrides Le sous-réseau remplace le réseau virtuel. SubnetOverride[]

Exemples d’utilisation

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Description
Crée un laboratoire dans Azure DevTest Labs avec une machine virtuelle revendiquée Ce modèle crée une instance DevTest Lab / DTL avec une machine virtuelle Windows Server 2019 Datacenter revendiquée. Plus de modèles de démarrage rapide Azure Resource Manager pour Azure DevTest Labs disponibles à https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Définition de ressource de modèle ARM

Le type de ressource labs/virtualnetworks peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevTestLab/labs/virtualnetworks, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de la propriété

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
apiVersion Version de l’API '2018-09-15'
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
properties Propriétés de la ressource. VirtualNetworkProperties (obligatoire)
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name Description Value
backendPort Port principal de la machine virtuelle cible. int
transportProtocol Type de protocole du port. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Stratégie d’autorisation du sous-réseau pour autoriser les adresses IP publiques (par exemple, Autoriser, Refuser)). 'Allow'
'Default'
'Deny'
labSubnetName Nom du sous-réseau tel qu’il apparaît dans le labo. string
resourceId ID de ressource du sous-réseau. string

SubnetOverride

Name Description Value
labSubnetName Nom donné au sous-réseau dans le labo. string
resourceId ID de ressource du sous-réseau. string
sharedPublicIpAddressConfiguration Propriétés que les machines virtuelles sur ce sous-réseau partageront. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indique si ce sous-réseau peut être utilisé lors de la création d’une machine virtuelle (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indique si les adresses IP publiques peuvent être affectées à des machines virtuelles sur ce sous-réseau (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Pool de réseaux virtuels associé à ce sous-réseau. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Les ports back-end que les machines virtuelles sur ce sous-réseau sont autorisés à exposer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Sous-réseaux autorisés du réseau virtuel. Subnet[]
description Description du réseau virtuel. string
externalProviderResourceId Identificateur de ressource Microsoft.Network du réseau virtuel. string
subnetOverrides Le sous-réseau remplace le réseau virtuel. SubnetOverride[]

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Template Description
Crée un laboratoire dans Azure DevTest Labs avec une machine virtuelle revendiquée

Déployer sur Azure
Ce modèle crée une instance DevTest Lab / DTL avec une machine virtuelle Windows Server 2019 Datacenter revendiquée. Plus de modèles de démarrage rapide Azure Resource Manager pour Azure DevTest Labs disponibles à https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource labs/virtualnetworks peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevTestLab/labs/virtualnetworks, ajoutez terraform suivant à votre modèle.

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

Valeurs de la propriété

Microsoft.DevTestLab/labs/virtualnetworks

Name Description Value
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : labs
properties Propriétés de la ressource. VirtualNetworkProperties (obligatoire)
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name Description Value
backendPort Port principal de la machine virtuelle cible. int
transportProtocol Type de protocole du port. 'Tcp'
'Udp'

ResourceTags

Name Description Value

Subnet

Name Description Value
allowPublicIp Stratégie d’autorisation du sous-réseau pour autoriser les adresses IP publiques (par exemple, Autoriser, Refuser)). 'Allow'
'Default'
'Deny'
labSubnetName Nom du sous-réseau tel qu’il apparaît dans le labo. string
resourceId ID de ressource du sous-réseau. string

SubnetOverride

Name Description Value
labSubnetName Nom donné au sous-réseau dans le labo. string
resourceId ID de ressource du sous-réseau. string
sharedPublicIpAddressConfiguration Propriétés que les machines virtuelles sur ce sous-réseau partageront. SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission Indique si ce sous-réseau peut être utilisé lors de la création d’une machine virtuelle (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
usePublicIpAddressPermission Indique si les adresses IP publiques peuvent être affectées à des machines virtuelles sur ce sous-réseau (par exemple, Autoriser, Refuser). 'Allow'
'Default'
'Deny'
virtualNetworkPoolName Pool de réseaux virtuels associé à ce sous-réseau. string

SubnetSharedPublicIpAddressConfiguration

Name Description Value
allowedPorts Les ports back-end que les machines virtuelles sur ce sous-réseau sont autorisés à exposer Port[]

VirtualNetworkProperties

Name Description Value
allowedSubnets Sous-réseaux autorisés du réseau virtuel. Subnet[]
description Description du réseau virtuel. string
externalProviderResourceId Identificateur de ressource Microsoft.Network du réseau virtuel. string
subnetOverrides Le sous-réseau remplace le réseau virtuel. SubnetOverride[]

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement de réseau virtuel au sein d’un 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    = ["*"]
}