Partager via


Microsoft.DevTestLab labs/virtualmachines 2016-05-15

Définition de ressource Bicep

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

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

Format des ressources

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

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
      }
      tags: {}
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
      }
      tags: {}
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: 'string'
  }
}

Valeurs de propriétés

labs/virtualmachines

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.
string (obligatoire)

Limite de caractères : 1-15 (Windows)
1-64 (Linux)

Caractères valides :
Caractères alphanumériques et traits d’union.

Doit commencer et se terminer par un caractère alphanumérique. Ne peut pas être constitué uniquement de chiffres.
location Emplacement de la ressource. string
tags Balises de la ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
parent Dans Bicep, vous pouvez spécifier la ressource parente pour 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. LabVirtualMachineProperties (obligatoire)

LabVirtualMachineProperties

Nom Description Valeur
allowClaim Indique si un autre utilisateur peut prendre possession de la machine virtuelle bool
applicableSchedule Planification applicable pour la machine virtuelle. ApplicableSchedule
artifactDeploymentStatus Le déploiement de l’artefact status pour la machine virtuelle. ArtifactDeploymentStatusProperties
artifacts Artefacts à installer sur la machine virtuelle. ArtifactInstallProperties[]
computeVm Propriétés de la machine virtuelle de calcul. ComputeVmProperties
createdByUser Adresse e-mail du créateur de la machine virtuelle. string
createdByUserId Identificateur d’objet du créateur de la machine virtuelle. string
createdDate Date de création de la machine virtuelle. string
customImageId Identificateur d’image personnalisé de la machine virtuelle. string
disallowPublicIpAddress Indique si la machine virtuelle doit être créée sans adresse IP publique. bool
environmentId ID de ressource de l’environnement qui contient cette machine virtuelle, le cas échéant. string
expirationDate Date d’expiration de la machine virtuelle. string
fqdn Nom de domaine complet de la machine virtuelle. string
galleryImageReference Référence d’image Microsoft Place de marché Azure de la machine virtuelle. GalleryImageReference
isAuthenticationWithSshKey Indique si cette machine virtuelle utilise une clé SSH pour l’authentification. bool
labSubnetName Nom du sous-réseau lab de la machine virtuelle. string
labVirtualNetworkId Identificateur de réseau virtuel lab de la machine virtuelle. string
networkInterface Propriétés de l’interface réseau. NetworkInterfaceProperties
HDInsight Notes de la machine virtuelle. string
osType Type de système d’exploitation de la machine virtuelle. string
ownerObjectId Identificateur d’objet du propriétaire de la machine virtuelle. string
ownerUserPrincipalName Nom d’utilisateur principal du propriétaire de la machine virtuelle. string
mot de passe Mot de passe de l’administrateur de la machine virtuelle. string
provisioningState Le provisionnement status de la ressource. string
taille Taille de la machine virtuelle. string
sshKey Clé SSH de l’administrateur de machine virtuelle. string
storageType Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
userName Nom d’utilisateur de la machine virtuelle. string
virtualMachineCreationSource Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. 'FromCustomImage'
'FromGalleryImage'

ApplicableSchedule

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object

ApplicableScheduleProperties

Nom Description Valeur
labVmsShutdown Planification d’arrêt automatique, si une a été définie au niveau des ressources du labo ou du labo. Planification
labVmsStartup Planification de démarrage automatique, si elle a été définie au niveau des ressources du labo ou du labo. Planification

Planifier

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ScheduleProperties (obligatoire)
tags Balises de la ressource. object

ScheduleProperties

Nom Description Valeur
dailyRecurrence Si la planification se produit une fois chaque jour de la semaine, spécifiez la périodicité quotidienne. DayDetails
hourlyRecurrence Si la planification se produit plusieurs fois par jour, spécifiez la périodicité horaire. HourDetails
notificationSettings Paramètres de notification. NotificationSettings
provisioningState Le provisionnement status de la ressource. string
status Status de la planification (par exemple, Activé, Désactivé) 'Désactivé'
'Enabled'
targetResourceId ID de ressource auquel la planification appartient string
taskType Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). string
timeZoneId ID de fuseau horaire (par exemple, l’heure standard du Pacifique). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
hebdomadaireRecurrence Si la planification ne se produit que certains jours de la semaine, spécifiez la périodicité hebdomadaire. WeekDetails

DayDetails

Nom Description Valeur
time Heure de la journée où la planification se produira. string

HourDetails

Nom Description Valeur
minute Minutes de l’heure d’exécution de la planification. int

NotificationSettings

Nom Description Valeur
status Si les notifications sont activées pour cette planification (par exemple, Activé, Désactivé). 'Désactivé'
'Enabled'
timeInMinutes Heure, en minutes avant l’événement, à laquelle la notification sera envoyée. int
webhookUrl URL du webhook à laquelle la notification sera envoyée. string

WeekDetails

Nom Description Valeur
time Heure du jour où la planification se produira. string
Semaine Jours de la semaine pour lesquels l’horaire est défini (par exemple, dimanche, lundi, mardi, etc.). string[]

ArtifactDeploymentStatusProperties

Nom Description Valeur
artefactsApplied Nombre total d’artefacts qui ont été appliqués avec succès. int
deploymentStatus La status de déploiement de l’artefact. string
totalArtifacts Nombre total d’artefacts qui ont été appliqués provisoirement. int

ArtifactInstallProperties

Nom Description Valeur
artifactId Identificateur de l’artefact. string
deploymentStatusMessage Message status du déploiement. string
installTime Heure à laquelle l’artefact commence à s’installer sur la machine virtuelle. string
parameters Paramètres de l’artefact. ArtifactParameterProperties[]
status Status de l’artefact. string
vmExtensionStatusMessage Message status de l’extension de machine virtuelle. string

ArtifactParameterProperties

Nom Description Valeur
name Nom du paramètre d’artefact. string
value Valeur du paramètre d’artefact. string

ComputeVmProperties

Nom Description Valeur
dataDiskIds Obtient l’URI d’objet blob des disques de données pour la machine virtuelle. string[]
dataDisks Obtient tous les disques de données attachés à la machine virtuelle. ComputeDataDisk[]
networkInterfaceId Obtient l’ID d’interface réseau de la machine virtuelle. string
osDiskId Obtient l’URI d’objet blob de disque du système d’exploitation pour la machine virtuelle. string
osType Obtient le type de système d’exploitation de la machine virtuelle. string
statuses Obtient les états de la machine virtuelle. ComputeVmInstanceViewStatus[]
vmSize Obtient la taille de la machine virtuelle. string

ComputeDataDisk

Nom Description Valeur
diskSizeGiB Obtient la taille du disque de données en Gio. int
diskUri Lorsqu’il est soutenu par un objet blob, l’URI de l’objet blob sous-jacent. string
managedDiskId Lorsqu’il est sauvegardé par un disque managé, il s’agit de l’ID de la ressource de disque de calcul. string
name Obtient le nom du disque de données. string

ComputeVmInstanceViewStatus

Nom Description Valeur
code Obtient le code status. string
displayStatus Obtient l’étiquette courte localisable pour le status. string
message Obtient le message associé au status. string

GalleryImageReference

Nom Description Valeur
offer Offre de l’image de la galerie. string
osType Type de système d’exploitation de l’image de la galerie. string
publisher Éditeur de l’image de la galerie. string
sku Référence SKU de l’image de la galerie. string
version Version de l’image de la galerie. string

NetworkInterfaceProperties

Nom Description Valeur
dnsName Nom DNS. string
privateIpAddress Adresse IP privée. string
publicIpAddress Adresse IP publique. string
publicIpAddressId ID de ressource de l’adresse IP publique. string
rdpAuthority La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivi du numéro de port de service pour RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configuration du partage d’une adresse IP publique sur plusieurs machines virtuelles. SharedPublicIpAddressConfiguration
sshAuthority La propriété SshAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivi du numéro de port de service pour SSH. string
subnetId ID de ressource du sous-réseau. string
virtualNetworkId ID de ressource du réseau virtuel. string

SharedPublicIpAddressConfiguration

Nom Description Valeur
inboundNatRules Règles NAT entrantes InboundNatRule[]

InboundNatRule

Nom Description Valeur
backendPort Port vers lequel le trafic externe sera redirigé. int
frontendPort Port de point de terminaison externe de la connexion entrante. Les valeurs possibles sont comprises entre 1 et 65535 inclus. Si elle n’est pas spécifiée, une valeur est allouée automatiquement. int
transportProtocol Protocole de transport du point de terminaison. 'Tcp'
'Udp'

Modèles de démarrage rapide

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

Modèle Description
Crée un labo dans Azure DevTest Labs avec une machine virtuelle Windows Server

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

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

Définition de ressources de modèle ARM

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

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

Format des ressources

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

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2016-05-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        }
      },
      "tags": {},
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        }
      },
      "tags": {}
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  }
}

Valeurs de propriétés

labs/virtualmachines

Nom Description Valeur
type Type de ressource 'Microsoft.DevTestLab/labs/virtualmachines'
apiVersion Version de l’API de ressource '2016-05-15'
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON.
string (obligatoire)

Limite de caractères : 1-15 (Windows)
1-64 (Linux)

Caractères valides :
Caractères alphanumériques et traits d’union.

Doit commencer et se terminer par un caractère alphanumérique. Ne peut pas être constitué uniquement de chiffres.
location Emplacement de la ressource. string
tags Balises de la ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
properties Propriétés de la ressource. LabVirtualMachineProperties (obligatoire)

LabVirtualMachineProperties

Nom Description Valeur
allowClaim Indique si un autre utilisateur peut prendre possession de la machine virtuelle bool
applicableSchedule Planification applicable pour la machine virtuelle. ApplicableSchedule
artifactDeploymentStatus Le déploiement de l’artefact status pour la machine virtuelle. ArtifactDeploymentStatusProperties
artifacts Artefacts à installer sur la machine virtuelle. ArtifactInstallProperties[]
computeVm Propriétés de la machine virtuelle de calcul. ComputeVmProperties
createdByUser Adresse e-mail du créateur de la machine virtuelle. string
createdByUserId Identificateur d’objet du créateur de la machine virtuelle. string
createdDate Date de création de la machine virtuelle. string
customImageId Identificateur d’image personnalisé de la machine virtuelle. string
disallowPublicIpAddress Indique si la machine virtuelle doit être créée sans adresse IP publique. bool
environmentId ID de ressource de l’environnement qui contient cette machine virtuelle, le cas échéant. string
expirationDate Date d’expiration de la machine virtuelle. string
fqdn Nom de domaine complet de la machine virtuelle. string
galleryImageReference Référence d’image Microsoft Place de marché Azure de la machine virtuelle. GalleryImageReference
isAuthenticationWithSshKey Indique si cette machine virtuelle utilise une clé SSH pour l’authentification. bool
labSubnetName Nom du sous-réseau lab de la machine virtuelle. string
labVirtualNetworkId Identificateur de réseau virtuel lab de la machine virtuelle. string
networkInterface Propriétés de l’interface réseau. NetworkInterfaceProperties
HDInsight Notes de la machine virtuelle. string
osType Type de système d’exploitation de la machine virtuelle. string
ownerObjectId Identificateur d’objet du propriétaire de la machine virtuelle. string
ownerUserPrincipalName Nom d’utilisateur principal du propriétaire de la machine virtuelle. string
mot de passe Mot de passe de l’administrateur de la machine virtuelle. string
provisioningState Status d’approvisionnement de la ressource. string
taille Taille de la machine virtuelle. string
sshKey Clé SSH de l’administrateur de la machine virtuelle. string
storageType Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
userName Nom d’utilisateur de la machine virtuelle. string
virtualMachineCreationSource Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. 'FromCustomImage'
'FromGalleryImage'

ApplicableSchedule

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object

ApplicableScheduleProperties

Nom Description Valeur
labVmsShutdown Planification d’arrêt automatique, si une a été définie au niveau des ressources du labo ou du labo. Planification
labVmsStartup Planification de démarrage automatique, si elle a été définie au niveau des ressources du labo ou du labo. Planification

Planifier

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ScheduleProperties (obligatoire)
tags Balises de la ressource. object

ScheduleProperties

Nom Description Valeur
dailyRecurrence Si la planification se produit une fois chaque jour de la semaine, spécifiez la périodicité quotidienne. DayDetails
hourlyRecurrence Si la planification se produit plusieurs fois par jour, spécifiez la périodicité horaire. HourDetails
notificationSettings Paramètres de notification. NotificationSettings
provisioningState Le provisionnement status de la ressource. string
status Status de la planification (par exemple, Activé, Désactivé) 'Désactivé'
'Enabled'
targetResourceId ID de ressource auquel la planification appartient string
taskType Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). string
timeZoneId ID de fuseau horaire (par exemple, l’heure standard du Pacifique). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
hebdomadaireRecurrence Si la planification ne se produit que certains jours de la semaine, spécifiez la périodicité hebdomadaire. WeekDetails

DayDetails

Nom Description Valeur
time Heure de la journée où la planification se produira. string

HourDetails

Nom Description Valeur
minute Minutes de l’heure d’exécution de la planification. int

NotificationSettings

Nom Description Valeur
status Si les notifications sont activées pour cette planification (par exemple, Activé, Désactivé). 'Désactivé'
'Enabled'
timeInMinutes Heure, en minutes avant l’événement, à laquelle la notification sera envoyée. int
webhookUrl URL du webhook à laquelle la notification sera envoyée. string

WeekDetails

Nom Description Valeur
time Heure du jour où la planification se produira. string
Semaine Jours de la semaine pour lesquels l’horaire est défini (par exemple, dimanche, lundi, mardi, etc.). string[]

ArtifactDeploymentStatusProperties

Nom Description Valeur
artefactsApplied Nombre total d’artefacts qui ont été appliqués avec succès. int
deploymentStatus La status de déploiement de l’artefact. string
totalArtifacts Nombre total d’artefacts qui ont été appliqués provisoirement. int

ArtifactInstallProperties

Nom Description Valeur
artifactId Identificateur de l’artefact. string
deploymentStatusMessage Message status du déploiement. string
installTime Heure à laquelle l’artefact commence à s’installer sur la machine virtuelle. string
parameters Paramètres de l’artefact. ArtifactParameterProperties[]
status Status de l’artefact. string
vmExtensionStatusMessage Message status de l’extension de machine virtuelle. string

ArtifactParameterProperties

Nom Description Valeur
name Nom du paramètre d’artefact. string
value Valeur du paramètre d’artefact. string

ComputeVmProperties

Nom Description Valeur
dataDiskIds Obtient l’URI d’objet blob des disques de données pour la machine virtuelle. string[]
dataDisks Obtient tous les disques de données attachés à la machine virtuelle. ComputeDataDisk[]
networkInterfaceId Obtient l’ID d’interface réseau de la machine virtuelle. string
osDiskId Obtient l’URI d’objet blob de disque du système d’exploitation pour la machine virtuelle. string
osType Obtient le type de système d’exploitation de la machine virtuelle. string
statuses Obtient les états de la machine virtuelle. ComputeVmInstanceViewStatus[]
vmSize Obtient la taille de la machine virtuelle. string

ComputeDataDisk

Nom Description Valeur
diskSizeGiB Obtient la taille du disque de données en Gio. int
diskUri Lorsqu’il est soutenu par un objet blob, l’URI de l’objet blob sous-jacent. string
managedDiskId Lorsqu’il est sauvegardé par un disque managé, il s’agit de l’ID de la ressource de disque de calcul. string
name Obtient le nom du disque de données. string

ComputeVmInstanceViewStatus

Nom Description Valeur
code Obtient le code status. string
displayStatus Obtient l’étiquette courte localisable pour le status. string
message Obtient le message associé au status. string

GalleryImageReference

Nom Description Valeur
offer Offre de l’image de la galerie. string
osType Type de système d’exploitation de l’image de la galerie. string
publisher Éditeur de l’image de la galerie. string
sku Référence SKU de l’image de la galerie. string
version Version de l’image de la galerie. string

NetworkInterfaceProperties

Nom Description Valeur
dnsName Nom DNS. string
privateIpAddress Adresse IP privée. string
publicIpAddress Adresse IP publique. string
publicIpAddressId ID de ressource de l’adresse IP publique. string
rdpAuthority La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivi du numéro de port de service pour RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configuration du partage d’une adresse IP publique sur plusieurs machines virtuelles. SharedPublicIpAddressConfiguration
sshAuthority La propriété SshAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivi du numéro de port de service pour SSH. string
subnetId ID de ressource du sous-réseau. string
virtualNetworkId ID de ressource du réseau virtuel. string

SharedPublicIpAddressConfiguration

Nom Description Valeur
inboundNatRules Règles NAT entrantes InboundNatRule[]

InboundNatRule

Nom Description Valeur
backendPort Port vers lequel le trafic externe sera redirigé. int
frontendPort Port de point de terminaison externe de la connexion entrante. Les valeurs possibles sont comprises entre 1 et 65535 inclus. Si elle n’est pas spécifiée, une valeur est allouée automatiquement. int
transportProtocol Protocole de transport du point de terminaison. 'Tcp'
'Udp'

Modèles de démarrage rapide

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

Modèle Description
Crée un labo dans Azure DevTest Labs avec une machine virtuelle Windows Server

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

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

Définition de ressource Terraform (fournisseur AzAPI)

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

  • Groupes de ressources

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

Format des ressources

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
        }
        tags = {}
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
        }
        tags = {}
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  })
}

Valeurs de propriétés

labs/virtualmachines

Nom Description Valeur
type Type de ressource « Microsoft.DevTestLab/labs/virtualmachines@2016-05-15 »
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-15 (Windows)
1-64 (Linux)

Caractères valides :
Caractères alphanumériques et traits d’union.

Doit commencer et se terminer par un caractère alphanumérique. Ne peut pas être constitué uniquement de chiffres.
location Emplacement de la ressource. string
parent_id ID de la ressource qui est le parent de cette ressource. ID pour la ressource de type : labs
tags Balises de la ressource. Dictionnaire de noms et de valeurs d’étiquettes.
properties Propriétés de la ressource. LabVirtualMachineProperties (obligatoire)

LabVirtualMachineProperties

Nom Description Valeur
allowClaim Indique si un autre utilisateur peut prendre possession de la machine virtuelle bool
applicableSchedule Planification applicable pour la machine virtuelle. ApplicableSchedule
artifactDeploymentStatus Le déploiement de l’artefact status pour la machine virtuelle. ArtifactDeploymentStatusProperties
artifacts Artefacts à installer sur la machine virtuelle. ArtifactInstallProperties[]
computeVm Propriétés de la machine virtuelle de calcul. ComputeVmProperties
createdByUser Adresse e-mail du créateur de la machine virtuelle. string
createdByUserId Identificateur d’objet du créateur de la machine virtuelle. string
createdDate Date de création de la machine virtuelle. string
customImageId Identificateur d’image personnalisé de la machine virtuelle. string
disallowPublicIpAddress Indique si la machine virtuelle doit être créée sans adresse IP publique. bool
environmentId ID de ressource de l’environnement qui contient cette machine virtuelle, le cas échéant. string
expirationDate Date d’expiration de la machine virtuelle. string
fqdn Nom de domaine complet de la machine virtuelle. string
galleryImageReference Référence d’image Microsoft Place de marché Azure de la machine virtuelle. GalleryImageReference
isAuthenticationWithSshKey Indique si cette machine virtuelle utilise une clé SSH pour l’authentification. bool
labSubnetName Nom du sous-réseau lab de la machine virtuelle. string
labVirtualNetworkId Identificateur de réseau virtuel lab de la machine virtuelle. string
networkInterface Propriétés de l’interface réseau. NetworkInterfaceProperties
HDInsight Notes de la machine virtuelle. string
osType Type de système d’exploitation de la machine virtuelle. string
ownerObjectId Identificateur d’objet du propriétaire de la machine virtuelle. string
ownerUserPrincipalName Nom d’utilisateur principal du propriétaire de la machine virtuelle. string
mot de passe Mot de passe de l’administrateur de la machine virtuelle. string
provisioningState Status d’approvisionnement de la ressource. string
taille Taille de la machine virtuelle. string
sshKey Clé SSH de l’administrateur de la machine virtuelle. string
storageType Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
userName Nom d’utilisateur de la machine virtuelle. string
virtualMachineCreationSource Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. « FromCustomImage »
« FromGalleryImage »

ApplicableSchedule

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object
location Emplacement de la ressource. string
properties Propriétés de la ressource. ApplicableScheduleProperties (obligatoire)
tags Balises de la ressource. object

ApplicableScheduleProperties

Nom Description Valeur
labVmsShutdown Planification d’arrêt automatique, si une a été définie au niveau des ressources du labo ou du labo. Planification
labVmsStartup Planification de démarrage automatique, si elle a été définie au niveau des ressources du labo ou du labo. Planification

Planifier

Nom Description Valeur
location Emplacement de la ressource. string
properties Propriétés de la ressource. ScheduleProperties (obligatoire)
tags Balises de la ressource. object

ScheduleProperties

Nom Description Valeur
dailyRecurrence Si la planification se produit une fois chaque jour de la semaine, spécifiez la périodicité quotidienne. DayDetails
hourlyRecurrence Si la planification se produit plusieurs fois par jour, spécifiez la périodicité horaire. HourDetails
notificationSettings Paramètres de notification. NotificationSettings
provisioningState Le provisionnement status de la ressource. string
status Status de la planification (par exemple, Activé, Désactivé) « Désactivé »
« Activé »
targetResourceId ID de ressource auquel la planification appartient string
taskType Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). string
timeZoneId ID de fuseau horaire (par exemple, l’heure standard du Pacifique). string
Uniqueidentifier Identificateur immuable unique d’une ressource (GUID). string
hebdomadaireRecurrence Si la planification ne se produit que certains jours de la semaine, spécifiez la périodicité hebdomadaire. WeekDetails

DayDetails

Nom Description Valeur
time Heure de la journée où la planification se produira. string

HourDetails

Nom Description Valeur
minute Minutes de l’heure d’exécution de la planification. int

NotificationSettings

Nom Description Valeur
status Si les notifications sont activées pour cette planification (par exemple, Activé, Désactivé). « Désactivé »
« Activé »
timeInMinutes Heure en minutes avant l’événement à laquelle la notification sera envoyée. int
webhookUrl URL du webhook à laquelle la notification sera envoyée. string

WeekDetails

Nom Description Valeur
time Heure du jour où la planification aura lieu. string
Semaine Jours de la semaine pour lesquels la planification est définie (par exemple, dimanche, lundi, mardi, etc.). string[]

ArtifactDeploymentStatusProperties

Nom Description Valeur
artifactsApplied Nombre total d’artefacts qui ont été appliqués avec succès. int
deploymentStatus Déploiement status de l’artefact. string
totalArtifacts Nombre total d’artefacts qui ont été appliqués provisoirement. int

ArtifactInstallProperties

Nom Description Valeur
artifactId Identificateur de l’artefact. string
deploymentStatusMessage Message status du déploiement. string
installTime Heure à laquelle l’artefact commence à installer sur la machine virtuelle. string
parameters Paramètres de l’artefact. ArtifactParameterProperties[]
status Status de l’artefact. string
vmExtensionStatusMessage Message status de l’extension de machine virtuelle. string

ArtifactParameterProperties

Nom Description Valeur
name Nom du paramètre d’artefact. string
value Valeur du paramètre d’artefact. string

ComputeVmProperties

Nom Description Valeur
dataDiskIds Obtient l’URI d’objet blob des disques de données pour la machine virtuelle. string[]
dataDisks Obtient tous les disques de données attachés à la machine virtuelle. ComputeDataDisk[]
networkInterfaceId Obtient l’ID d’interface réseau de la machine virtuelle. string
osDiskId Obtient l’URI d’objet blob de disque du système d’exploitation pour la machine virtuelle. string
osType Obtient le type de système d’exploitation de la machine virtuelle. string
statuses Obtient les états de la machine virtuelle. ComputeVmInstanceViewStatus[]
vmSize Obtient la taille de la machine virtuelle. string

ComputeDataDisk

Nom Description Valeur
diskSizeGiB Obtient la taille du disque de données en Gio. int
diskUri Lorsqu’il est soutenu par un objet blob, l’URI de l’objet blob sous-jacent. string
managedDiskId Lorsqu’il est sauvegardé par un disque managé, il s’agit de l’ID de la ressource de disque de calcul. string
name Obtient le nom du disque de données. string

ComputeVmInstanceViewStatus

Nom Description Valeur
code Obtient le code status. string
displayStatus Obtient l’étiquette courte localisable pour le status. string
message Obtient le message associé au status. string

GalleryImageReference

Nom Description Valeur
offer Offre de l’image de la galerie. string
osType Type de système d’exploitation de l’image de la galerie. string
publisher Éditeur de l’image de la galerie. string
sku Référence SKU de l’image de la galerie. string
version Version de l’image de la galerie. string

NetworkInterfaceProperties

Nom Description Valeur
dnsName Nom DNS. string
privateIpAddress Adresse IP privée. string
publicIpAddress Adresse IP publique. string
publicIpAddressId ID de ressource de l’adresse IP publique. string
rdpAuthority La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP, suivi du numéro de port de service pour RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configuration pour le partage d’une adresse IP publique sur plusieurs machines virtuelles. SharedPublicIpAddressConfiguration
sshAuthority La propriété SshAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivi du numéro de port de service pour SSH. string
subnetId ID de ressource du sous-réseau. string
virtualNetworkId ID de ressource du réseau virtuel. string

SharedPublicIpAddressConfiguration

Nom Description Valeur
inboundNatRules Règles NAT entrantes InboundNatRule[]

InboundNatRule

Nom Description Valeur
backendPort Port vers lequel le trafic externe sera redirigé. int
frontendPort Port de point de terminaison externe de la connexion entrante. Les valeurs possibles sont comprises entre 1 et 65535 inclus. Si elle n’est pas spécifiée, une valeur est allouée automatiquement. int
transportProtocol Protocole de transport du point de terminaison. « Tcp »
« Udp »