Laboratoires Microsoft.DevTestLab/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 :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
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/virtualmachines, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
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: {
{customized property}: 'string'
}
}
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: {
{customized property}: 'string'
}
}
}
tags: {
{customized property}: 'string'
}
}
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'
}
tags: {
{customized property}: 'string'
}
}
Valeurs de propriété
ApplicableSchedule
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ApplicableScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ApplicableScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| labVmsShutdown | Planification de l’arrêt automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
| labVmsStartup | Planification de démarrage automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
ArtifactDeploymentStatusProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactsApplied | Nombre total d’artefacts appliqués avec succès. | Int |
| deploymentStatus | État du déploiement de l’artefact. | corde |
| totalArtifacts | Nombre total d’artefacts appliqués provisoirement. | Int |
ArtifactInstallProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactId | Identificateur de l’artefact. | corde |
| deploymentStatusMessage | Message d’état du déploiement. | corde |
| installTime | Heure à laquelle l’artefact commence à s’installer sur la machine virtuelle. | corde |
| Paramètres | Paramètres de l’artefact. | ArtifactParameterProperties[] |
| statut | État de l’artefact. | corde |
| vmExtensionStatusMessage | Message d’état de l’extension de machine virtuelle. | corde |
ArtifactParameterProperties
| Nom | Description | Valeur |
|---|---|---|
| nom | Nom du paramètre d’artefact. | corde |
| valeur | Valeur du paramètre d’artefact. | corde |
ComputeDataDisk
| Nom | Description | Valeur |
|---|---|---|
| diskSizeGiB | Obtient la taille du disque de données en Gio. | Int |
| diskUri | Lorsqu’il est sauvegardé par un objet blob, l’URI de l’objet blob sous-jacent. | corde |
| managedDiskId | Lorsqu’il est sauvegardé par disque managé, il s’agit de l’ID de la ressource de disque de calcul. | corde |
| nom | Obtient le nom du disque de données. | corde |
ComputeVmInstanceViewStatus
| Nom | Description | Valeur |
|---|---|---|
| code | Obtient le code d’état. | corde |
| displayStatus | Obtient l’étiquette localisable courte pour l’état. | corde |
| Message | Obtient le message associé à l’état. | corde |
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. | corde |
| osDiskId | Obtient l’URI de l’objet blob de disque du système d’exploitation pour la machine virtuelle. | corde |
| osType | Obtient le type de système d’exploitation de la machine virtuelle. | corde |
| Statuts | Obtient les états de la machine virtuelle. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtient la taille de la machine virtuelle. | corde |
DayDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | L’heure de la planification se produit. | corde |
GalleryImageReference
| Nom | Description | Valeur |
|---|---|---|
| offrir | Offre de l’image de la galerie. | corde |
| osType | Type de système d’exploitation de l’image de la galerie. | corde |
| éditeur | Éditeur de l’image de la galerie. | corde |
| Sku | Référence SKU de l’image de la galerie. | corde |
| Version | Version de l’image de la galerie. | corde |
HourDetails
| Nom | Description | Valeur |
|---|---|---|
| minute | Minutes de l’heure pendant laquelle la planification s’exécutera. | Int |
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 pour le point de terminaison. | 'Tcp' 'Udp' |
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 | État du déploiement d’artefacts pour la machine virtuelle. | ArtifactDeploymentStatusProperties |
| Artefacts | 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. | corde |
| createdByUserId | Identificateur d’objet du créateur de la machine virtuelle. | corde |
| createdDate | Date de création de la machine virtuelle. | corde |
| customImageId | Identificateur d’image personnalisé de la machine virtuelle. | corde |
| 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. | corde |
| expirationDate | Date d’expiration de la machine virtuelle. | corde |
| Fqdn | Nom de domaine complet de la machine virtuelle. | corde |
| galleryImageReference | Référence de l’image de la Place de marché Microsoft 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 du labo de la machine virtuelle. | corde |
| labVirtualNetworkId | Identificateur de réseau virtuel lab de la machine virtuelle. | corde |
| networkInterface | Propriétés de l’interface réseau. | NetworkInterfaceProperties |
| Notes | Notes de la machine virtuelle. | corde |
| osType | Type de système d’exploitation de la machine virtuelle. | corde |
| ownerObjectId | Identificateur d’objet du propriétaire de la machine virtuelle. | corde |
| ownerUserPrincipalName | Nom d’utilisateur principal du propriétaire de la machine virtuelle. | corde |
| mot de passe | Mot de passe de l’administrateur de la machine virtuelle. | corde |
| provisioningState | État d’approvisionnement de la ressource. | corde |
| taille | Taille de la machine virtuelle. | corde |
| sshKey | Clé SSH de l’administrateur de la machine virtuelle. | corde |
| storageType | Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| nom d’utilisateur | Nom d’utilisateur de la machine virtuelle. | corde |
| virtualMachineCreationSource | Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. | 'FromCustomImage' 'FromGalleryImage' |
Microsoft.DevTestLab/labs/virtualmachines
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| nom | 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 |
| Propriétés | Propriétés de la ressource. | LabVirtualMachineProperties (obligatoire) |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
NetworkInterfaceProperties
| Nom | Description | Valeur |
|---|---|---|
| dnsName | Nom DNS. | corde |
| privateIpAddress | Adresse IP privée. | corde |
| publicIpAddress | Adresse IP publique. | corde |
| publicIpAddressId | ID de ressource de l’adresse IP publique. | corde |
| rdpAuthority | La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivie du numéro de port de service pour RDP (Remote Desktop Protocol). | corde |
| 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 suivie du numéro de port de service pour SSH. | corde |
| subnetId | ID de ressource du sous-réseau. | corde |
| virtualNetworkId | ID de ressource du réseau virtuel. | corde |
NotificationSettings
| Nom | Description | Valeur |
|---|---|---|
| statut | Si les notifications sont activées pour cette planification (c’est-à-dire activée, désactivée). | 'Désactivé' 'Activé' |
| timeInMinutes | Heure en minutes avant l’événement auquel la notification sera envoyée. | Int |
| webhookUrl | URL du webhook à laquelle la notification sera envoyée. | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
Horaire
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| dailyRecurrence | Si la planification se produit une fois par 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 | État d’approvisionnement de la ressource. | corde |
| statut | État de la planification (c’est-à-dire Activé, Désactivé) | 'Désactivé' 'Activé' |
| targetResourceId | ID de ressource auquel appartient la planification | corde |
| taskType | Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). | corde |
| timeZoneId | ID de fuseau horaire (par exemple, Heure standard du Pacifique). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| weeklyRecurrence | Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire. | WeekDetails |
SharedPublicIpAddressConfiguration
| Nom | Description | Valeur |
|---|---|---|
| inboundNatRules | Règles NAT entrantes | InboundNatRule[] |
WeekDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | Heure de la planification. | corde |
| Semaine | Jours de la semaine pour lesquels la planification est définie (par exemple, dimanche, lundi, mardi, etc.). | string[] |
Exemples de démarrage rapide
Les exemples de démarrage rapide suivants déploient 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/virtualmachines peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
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/virtualmachines, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.DevTestLab/labs/virtualmachines",
"apiVersion": "2016-05-15",
"name": "string",
"location": "string",
"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": {
"{customized property}": "string"
}
},
"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": {
"{customized property}": "string"
}
}
},
"tags": {
"{customized property}": "string"
}
},
"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"
},
"tags": {
"{customized property}": "string"
}
}
Valeurs de propriété
ApplicableSchedule
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ApplicableScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ApplicableScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| labVmsShutdown | Planification de l’arrêt automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
| labVmsStartup | Planification de démarrage automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
ArtifactDeploymentStatusProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactsApplied | Nombre total d’artefacts appliqués avec succès. | Int |
| deploymentStatus | État du déploiement de l’artefact. | corde |
| totalArtifacts | Nombre total d’artefacts appliqués provisoirement. | Int |
ArtifactInstallProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactId | Identificateur de l’artefact. | corde |
| deploymentStatusMessage | Message d’état du déploiement. | corde |
| installTime | Heure à laquelle l’artefact commence à s’installer sur la machine virtuelle. | corde |
| Paramètres | Paramètres de l’artefact. | ArtifactParameterProperties[] |
| statut | État de l’artefact. | corde |
| vmExtensionStatusMessage | Message d’état de l’extension de machine virtuelle. | corde |
ArtifactParameterProperties
| Nom | Description | Valeur |
|---|---|---|
| nom | Nom du paramètre d’artefact. | corde |
| valeur | Valeur du paramètre d’artefact. | corde |
ComputeDataDisk
| Nom | Description | Valeur |
|---|---|---|
| diskSizeGiB | Obtient la taille du disque de données en Gio. | Int |
| diskUri | Lorsqu’il est sauvegardé par un objet blob, l’URI de l’objet blob sous-jacent. | corde |
| managedDiskId | Lorsqu’il est sauvegardé par disque managé, il s’agit de l’ID de la ressource de disque de calcul. | corde |
| nom | Obtient le nom du disque de données. | corde |
ComputeVmInstanceViewStatus
| Nom | Description | Valeur |
|---|---|---|
| code | Obtient le code d’état. | corde |
| displayStatus | Obtient l’étiquette localisable courte pour l’état. | corde |
| Message | Obtient le message associé à l’état. | corde |
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. | corde |
| osDiskId | Obtient l’URI de l’objet blob de disque du système d’exploitation pour la machine virtuelle. | corde |
| osType | Obtient le type de système d’exploitation de la machine virtuelle. | corde |
| Statuts | Obtient les états de la machine virtuelle. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtient la taille de la machine virtuelle. | corde |
DayDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | L’heure de la planification se produit. | corde |
GalleryImageReference
| Nom | Description | Valeur |
|---|---|---|
| offrir | Offre de l’image de la galerie. | corde |
| osType | Type de système d’exploitation de l’image de la galerie. | corde |
| éditeur | Éditeur de l’image de la galerie. | corde |
| Sku | Référence SKU de l’image de la galerie. | corde |
| Version | Version de l’image de la galerie. | corde |
HourDetails
| Nom | Description | Valeur |
|---|---|---|
| minute | Minutes de l’heure pendant laquelle la planification s’exécutera. | Int |
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 pour le point de terminaison. | 'Tcp' 'Udp' |
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 | État du déploiement d’artefacts pour la machine virtuelle. | ArtifactDeploymentStatusProperties |
| Artefacts | 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. | corde |
| createdByUserId | Identificateur d’objet du créateur de la machine virtuelle. | corde |
| createdDate | Date de création de la machine virtuelle. | corde |
| customImageId | Identificateur d’image personnalisé de la machine virtuelle. | corde |
| 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. | corde |
| expirationDate | Date d’expiration de la machine virtuelle. | corde |
| Fqdn | Nom de domaine complet de la machine virtuelle. | corde |
| galleryImageReference | Référence de l’image de la Place de marché Microsoft 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 du labo de la machine virtuelle. | corde |
| labVirtualNetworkId | Identificateur de réseau virtuel lab de la machine virtuelle. | corde |
| networkInterface | Propriétés de l’interface réseau. | NetworkInterfaceProperties |
| Notes | Notes de la machine virtuelle. | corde |
| osType | Type de système d’exploitation de la machine virtuelle. | corde |
| ownerObjectId | Identificateur d’objet du propriétaire de la machine virtuelle. | corde |
| ownerUserPrincipalName | Nom d’utilisateur principal du propriétaire de la machine virtuelle. | corde |
| mot de passe | Mot de passe de l’administrateur de la machine virtuelle. | corde |
| provisioningState | État d’approvisionnement de la ressource. | corde |
| taille | Taille de la machine virtuelle. | corde |
| sshKey | Clé SSH de l’administrateur de la machine virtuelle. | corde |
| storageType | Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| nom d’utilisateur | Nom d’utilisateur de la machine virtuelle. | corde |
| virtualMachineCreationSource | Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. | 'FromCustomImage' 'FromGalleryImage' |
Microsoft.DevTestLab/labs/virtualmachines
| Nom | Description | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2016-05-15' |
| emplacement | Emplacement de la ressource. | corde |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés de la ressource. | LabVirtualMachineProperties (obligatoire) |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| type | Type de ressource | 'Microsoft.DevTestLab/labs/virtualmachines' |
NetworkInterfaceProperties
| Nom | Description | Valeur |
|---|---|---|
| dnsName | Nom DNS. | corde |
| privateIpAddress | Adresse IP privée. | corde |
| publicIpAddress | Adresse IP publique. | corde |
| publicIpAddressId | ID de ressource de l’adresse IP publique. | corde |
| rdpAuthority | La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivie du numéro de port de service pour RDP (Remote Desktop Protocol). | corde |
| 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 suivie du numéro de port de service pour SSH. | corde |
| subnetId | ID de ressource du sous-réseau. | corde |
| virtualNetworkId | ID de ressource du réseau virtuel. | corde |
NotificationSettings
| Nom | Description | Valeur |
|---|---|---|
| statut | Si les notifications sont activées pour cette planification (c’est-à-dire activée, désactivée). | 'Désactivé' 'Activé' |
| timeInMinutes | Heure en minutes avant l’événement auquel la notification sera envoyée. | Int |
| webhookUrl | URL du webhook à laquelle la notification sera envoyée. | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
Horaire
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| dailyRecurrence | Si la planification se produit une fois par 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 | État d’approvisionnement de la ressource. | corde |
| statut | État de la planification (c’est-à-dire Activé, Désactivé) | 'Désactivé' 'Activé' |
| targetResourceId | ID de ressource auquel appartient la planification | corde |
| taskType | Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). | corde |
| timeZoneId | ID de fuseau horaire (par exemple, Heure standard du Pacifique). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| weeklyRecurrence | Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire. | WeekDetails |
SharedPublicIpAddressConfiguration
| Nom | Description | Valeur |
|---|---|---|
| inboundNatRules | Règles NAT entrantes | InboundNatRule[] |
WeekDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | Heure de la planification. | corde |
| Semaine | Jours de la semaine pour lesquels la planification est définie (par exemple, dimanche, lundi, mardi, etc.). | string[] |
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 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/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 de l’API, consultez journal des modifications.
Format de ressource
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"
tags = {
{customized property} = "string"
}
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 = {
{customized property} = "string"
}
}
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 = {
{customized property} = "string"
}
}
}
tags = {
{customized property} = "string"
}
}
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é
ApplicableSchedule
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ApplicableScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ApplicableScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| labVmsShutdown | Planification de l’arrêt automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
| labVmsStartup | Planification de démarrage automatique, si l’une d’elles a été définie au niveau du labo ou de la ressource lab. | planifier |
ArtifactDeploymentStatusProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactsApplied | Nombre total d’artefacts appliqués avec succès. | Int |
| deploymentStatus | État du déploiement de l’artefact. | corde |
| totalArtifacts | Nombre total d’artefacts appliqués provisoirement. | Int |
ArtifactInstallProperties
| Nom | Description | Valeur |
|---|---|---|
| artifactId | Identificateur de l’artefact. | corde |
| deploymentStatusMessage | Message d’état du déploiement. | corde |
| installTime | Heure à laquelle l’artefact commence à s’installer sur la machine virtuelle. | corde |
| Paramètres | Paramètres de l’artefact. | ArtifactParameterProperties[] |
| statut | État de l’artefact. | corde |
| vmExtensionStatusMessage | Message d’état de l’extension de machine virtuelle. | corde |
ArtifactParameterProperties
| Nom | Description | Valeur |
|---|---|---|
| nom | Nom du paramètre d’artefact. | corde |
| valeur | Valeur du paramètre d’artefact. | corde |
ComputeDataDisk
| Nom | Description | Valeur |
|---|---|---|
| diskSizeGiB | Obtient la taille du disque de données en Gio. | Int |
| diskUri | Lorsqu’il est sauvegardé par un objet blob, l’URI de l’objet blob sous-jacent. | corde |
| managedDiskId | Lorsqu’il est sauvegardé par disque managé, il s’agit de l’ID de la ressource de disque de calcul. | corde |
| nom | Obtient le nom du disque de données. | corde |
ComputeVmInstanceViewStatus
| Nom | Description | Valeur |
|---|---|---|
| code | Obtient le code d’état. | corde |
| displayStatus | Obtient l’étiquette localisable courte pour l’état. | corde |
| Message | Obtient le message associé à l’état. | corde |
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. | corde |
| osDiskId | Obtient l’URI de l’objet blob de disque du système d’exploitation pour la machine virtuelle. | corde |
| osType | Obtient le type de système d’exploitation de la machine virtuelle. | corde |
| Statuts | Obtient les états de la machine virtuelle. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtient la taille de la machine virtuelle. | corde |
DayDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | L’heure de la planification se produit. | corde |
GalleryImageReference
| Nom | Description | Valeur |
|---|---|---|
| offrir | Offre de l’image de la galerie. | corde |
| osType | Type de système d’exploitation de l’image de la galerie. | corde |
| éditeur | Éditeur de l’image de la galerie. | corde |
| Sku | Référence SKU de l’image de la galerie. | corde |
| Version | Version de l’image de la galerie. | corde |
HourDetails
| Nom | Description | Valeur |
|---|---|---|
| minute | Minutes de l’heure pendant laquelle la planification s’exécutera. | Int |
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 pour le point de terminaison. | 'Tcp' 'Udp' |
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 | État du déploiement d’artefacts pour la machine virtuelle. | ArtifactDeploymentStatusProperties |
| Artefacts | 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. | corde |
| createdByUserId | Identificateur d’objet du créateur de la machine virtuelle. | corde |
| createdDate | Date de création de la machine virtuelle. | corde |
| customImageId | Identificateur d’image personnalisé de la machine virtuelle. | corde |
| 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. | corde |
| expirationDate | Date d’expiration de la machine virtuelle. | corde |
| Fqdn | Nom de domaine complet de la machine virtuelle. | corde |
| galleryImageReference | Référence de l’image de la Place de marché Microsoft 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 du labo de la machine virtuelle. | corde |
| labVirtualNetworkId | Identificateur de réseau virtuel lab de la machine virtuelle. | corde |
| networkInterface | Propriétés de l’interface réseau. | NetworkInterfaceProperties |
| Notes | Notes de la machine virtuelle. | corde |
| osType | Type de système d’exploitation de la machine virtuelle. | corde |
| ownerObjectId | Identificateur d’objet du propriétaire de la machine virtuelle. | corde |
| ownerUserPrincipalName | Nom d’utilisateur principal du propriétaire de la machine virtuelle. | corde |
| mot de passe | Mot de passe de l’administrateur de la machine virtuelle. | corde |
| provisioningState | État d’approvisionnement de la ressource. | corde |
| taille | Taille de la machine virtuelle. | corde |
| sshKey | Clé SSH de l’administrateur de la machine virtuelle. | corde |
| storageType | Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| nom d’utilisateur | Nom d’utilisateur de la machine virtuelle. | corde |
| virtualMachineCreationSource | Indique la source de création d’une machine virtuelle lab. Propriété de sortie uniquement. | 'FromCustomImage' 'FromGalleryImage' |
Microsoft.DevTestLab/labs/virtualmachines
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| nom | 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 |
| Propriétés | Propriétés de la ressource. | LabVirtualMachineProperties (obligatoire) |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.DevTestLab/labs/virtualmachines@2016-05-15 » |
NetworkInterfaceProperties
| Nom | Description | Valeur |
|---|---|---|
| dnsName | Nom DNS. | corde |
| privateIpAddress | Adresse IP privée. | corde |
| publicIpAddress | Adresse IP publique. | corde |
| publicIpAddressId | ID de ressource de l’adresse IP publique. | corde |
| rdpAuthority | La propriété RdpAuthority est un nom d’hôte DNS de serveur ou une adresse IP suivie du numéro de port de service pour RDP (Remote Desktop Protocol). | corde |
| 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 suivie du numéro de port de service pour SSH. | corde |
| subnetId | ID de ressource du sous-réseau. | corde |
| virtualNetworkId | ID de ressource du réseau virtuel. | corde |
NotificationSettings
| Nom | Description | Valeur |
|---|---|---|
| statut | Si les notifications sont activées pour cette planification (c’est-à-dire activée, désactivée). | 'Désactivé' 'Activé' |
| timeInMinutes | Heure en minutes avant l’événement auquel la notification sera envoyée. | Int |
| webhookUrl | URL du webhook à laquelle la notification sera envoyée. | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
ResourceTags
| Nom | Description | Valeur |
|---|
Horaire
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement de la ressource. | corde |
| Propriétés | Propriétés de la ressource. | ScheduleProperties (obligatoire) |
| étiquettes | Balises de la ressource. | ResourceTags |
ScheduleProperties
| Nom | Description | Valeur |
|---|---|---|
| dailyRecurrence | Si la planification se produit une fois par 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 | État d’approvisionnement de la ressource. | corde |
| statut | État de la planification (c’est-à-dire Activé, Désactivé) | 'Désactivé' 'Activé' |
| targetResourceId | ID de ressource auquel appartient la planification | corde |
| taskType | Type de tâche de la planification (par exemple, LabVmsShutdownTask, LabVmAutoStart). | corde |
| timeZoneId | ID de fuseau horaire (par exemple, Heure standard du Pacifique). | corde |
| uniqueIdentifier | Identificateur immuable unique d’une ressource (GUID). | corde |
| weeklyRecurrence | Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire. | WeekDetails |
SharedPublicIpAddressConfiguration
| Nom | Description | Valeur |
|---|---|---|
| inboundNatRules | Règles NAT entrantes | InboundNatRule[] |
WeekDetails
| Nom | Description | Valeur |
|---|---|---|
| Heure | Heure de la planification. | corde |
| Semaine | Jours de la semaine pour lesquels la planification est définie (par exemple, dimanche, lundi, mardi, etc.). | string[] |