Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
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 = ["*"]
}