Microsoft.DevTestLab labs/virtualmachines 2018-09-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 - Voir commandes de déploiement de groupe 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 Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
allowClaim: bool
artifacts: [
{
artifactId: 'string'
artifactTitle: 'string'
deploymentStatusMessage: 'string'
installTime: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
status: 'string'
vmExtensionStatusMessage: 'string'
}
]
createdDate: 'string'
customImageId: 'string'
dataDiskParameters: [
{
attachNewDataDiskOptions: {
diskName: 'string'
diskSizeGiB: int
diskType: 'string'
}
existingLabDiskId: 'string'
hostCaching: 'string'
}
]
disallowPublicIpAddress: bool
environmentId: 'string'
expirationDate: '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'
ownerObjectId: 'string'
ownerUserPrincipalName: 'string'
password: 'string'
planId: 'string'
scheduleParameters: [
{
name: 'string'
properties: {
dailyRecurrence: {
time: 'string'
}
hourlyRecurrence: {
minute: int
}
notificationSettings: {
emailRecipient: 'string'
notificationLocale: 'string'
status: 'string'
timeInMinutes: int
webhookUrl: 'string'
}
status: 'string'
targetResourceId: 'string'
taskType: 'string'
weeklyRecurrence: {
time: 'string'
weekdays: [
'string'
]
}
}
tags: {}
}
]
size: 'string'
sshKey: 'string'
storageType: 'string'
userName: '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 |
artifacts | Artefacts à installer sur la machine virtuelle. | ArtifactInstallProperties[] |
createdDate | Date de création de la machine virtuelle. | string |
customImageId | Identificateur d’image personnalisé de la machine virtuelle. | string |
dataDiskParameters | Disques de données nouveaux ou existants à attacher à la machine virtuelle après la création | DataDiskProperties[] |
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 |
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 |
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 |
planId | ID du plan associé à l’image de machine virtuelle | string |
scheduleParameters | Planifications de machine virtuelle à créer | ScheduleCreationParameter[] |
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 |
userName | Nom d’utilisateur de la machine virtuelle. | string |
ArtifactInstallProperties
Nom | Description | Valeur |
---|---|---|
artifactId | Identificateur de l’artefact. | string |
artifactTitle | Titre 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 |
DataDiskProperties
Nom | Description | Valeur |
---|---|---|
attachNewDataDiskOptions | Spécifie les options permettant d’attacher un nouveau disque à la machine virtuelle. | AttachNewDataDiskOptions |
existingLabDiskId | Spécifie l’ID de disque lab existant à attacher à la machine virtuelle. | string |
hostCaching | Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite). | 'None' 'ReadOnly' 'ReadWrite' |
AttachNewDataDiskOptions
Nom | Description | Valeur |
---|---|---|
diskName | Nom du disque à attacher. | string |
diskSizeGiB | Taille du disque à attacher en Gibibytes. | int |
diskType | Type de stockage pour le disque (par exemple, Standard, Premium). | 'Premium' 'Standard' 'StandardSSD' |
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' |
ScheduleCreationParameter
Nom | Description | Valeur |
---|---|---|
name | Nom de la machine virtuelle ou de l’environnement | string |
properties | Propriétés de la planification. | ScheduleCreationParameterProperties |
tags | Balises de la ressource. | object |
ScheduleCreationParameterProperties
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 |
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 |
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 |
---|---|---|
emailRecipient | Destinataire de l’e-mail auquel envoyer des notifications (peut être une liste d’adresses e-mail séparées par deux-points). | string |
notificationLocale | Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN). | string |
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[] |
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 |
Ce modèle crée une nouvelle 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 surhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Crée un labo dans Azure DevTest Labs avec une machine virtuelle revendiquée |
Ce modèle crée une nouvelle 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 surhttps://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 :
- Groupes de ressources - Voir 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 des ressources
Pour créer une ressource Microsoft.DevTestLab/labs/virtualmachines, ajoutez le json suivant à votre modèle.
{
"type": "Microsoft.DevTestLab/labs/virtualmachines",
"apiVersion": "2018-09-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"allowClaim": "bool",
"artifacts": [
{
"artifactId": "string",
"artifactTitle": "string",
"deploymentStatusMessage": "string",
"installTime": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
],
"status": "string",
"vmExtensionStatusMessage": "string"
}
],
"createdDate": "string",
"customImageId": "string",
"dataDiskParameters": [
{
"attachNewDataDiskOptions": {
"diskName": "string",
"diskSizeGiB": "int",
"diskType": "string"
},
"existingLabDiskId": "string",
"hostCaching": "string"
}
],
"disallowPublicIpAddress": "bool",
"environmentId": "string",
"expirationDate": "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",
"ownerObjectId": "string",
"ownerUserPrincipalName": "string",
"password": "string",
"planId": "string",
"scheduleParameters": [
{
"name": "string",
"properties": {
"dailyRecurrence": {
"time": "string"
},
"hourlyRecurrence": {
"minute": "int"
},
"notificationSettings": {
"emailRecipient": "string",
"notificationLocale": "string",
"status": "string",
"timeInMinutes": "int",
"webhookUrl": "string"
},
"status": "string",
"targetResourceId": "string",
"taskType": "string",
"weeklyRecurrence": {
"time": "string",
"weekdays": [ "string" ]
}
},
"tags": {}
}
],
"size": "string",
"sshKey": "string",
"storageType": "string",
"userName": "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 | '2018-09-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. |
chaîne (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 |
artifacts | Artefacts à installer sur la machine virtuelle. | ArtifactInstallProperties[] |
createdDate | Date de création de la machine virtuelle. | string |
customImageId | Identificateur d’image personnalisé de la machine virtuelle. | string |
dataDiskParameters | Disques de données nouveaux ou existants à attacher à la machine virtuelle après la création | DataDiskProperties[] |
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 |
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 |
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 |
planId | ID du plan associé à l’image de machine virtuelle | string |
scheduleParameters | Planifications de machine virtuelle à créer | ScheduleCreationParameter[] |
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 |
userName | Nom d’utilisateur de la machine virtuelle. | string |
ArtifactInstallProperties
Nom | Description | Valeur |
---|---|---|
artifactId | Identificateur de l’artefact. | string |
artifactTitle | Titre 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 |
DataDiskProperties
Nom | Description | Valeur |
---|---|---|
attachNewDataDiskOptions | Spécifie les options permettant d’attacher un nouveau disque à la machine virtuelle. | AttachNewDataDiskOptions |
existingLabDiskId | Spécifie l’ID de disque de labo existant à attacher à la machine virtuelle. | string |
hostCaching | Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite). | 'None' 'ReadOnly' 'ReadWrite' |
AttachNewDataDiskOptions
Nom | Description | Valeur |
---|---|---|
diskName | Nom du disque à attacher. | string |
diskSizeGiB | Taille du disque à attacher en Gibibytes. | int |
diskType | Type de stockage du disque (Par exemple, Standard, Premium). | 'Premium' 'Standard' 'StandardSSD' |
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' |
ScheduleCreationParameter
Nom | Description | Valeur |
---|---|---|
name | Nom de la machine virtuelle ou de l’environnement | string |
properties | Propriétés de la planification. | ScheduleCreationParameterProperties |
tags | Balises de la ressource. | object |
ScheduleCreationParameterProperties
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 |
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 |
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 |
---|---|---|
emailRecipient | Destinataire de l’e-mail auquel envoyer des notifications (peut être une liste d’adresses e-mail séparées par deux-points). | string |
notificationLocale | Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN). | string |
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[] |
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 |
Ce modèle crée une nouvelle 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 surhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Crée un labo dans Azure DevTest Labs avec une machine virtuelle revendiquée |
Ce modèle crée une nouvelle 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 surhttps://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 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@2018-09-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
allowClaim = bool
artifacts = [
{
artifactId = "string"
artifactTitle = "string"
deploymentStatusMessage = "string"
installTime = "string"
parameters = [
{
name = "string"
value = "string"
}
]
status = "string"
vmExtensionStatusMessage = "string"
}
]
createdDate = "string"
customImageId = "string"
dataDiskParameters = [
{
attachNewDataDiskOptions = {
diskName = "string"
diskSizeGiB = int
diskType = "string"
}
existingLabDiskId = "string"
hostCaching = "string"
}
]
disallowPublicIpAddress = bool
environmentId = "string"
expirationDate = "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"
ownerObjectId = "string"
ownerUserPrincipalName = "string"
password = "string"
planId = "string"
scheduleParameters = [
{
name = "string"
properties = {
dailyRecurrence = {
time = "string"
}
hourlyRecurrence = {
minute = int
}
notificationSettings = {
emailRecipient = "string"
notificationLocale = "string"
status = "string"
timeInMinutes = int
webhookUrl = "string"
}
status = "string"
targetResourceId = "string"
taskType = "string"
weeklyRecurrence = {
time = "string"
weekdays = [
"string"
]
}
}
tags = {}
}
]
size = "string"
sshKey = "string"
storageType = "string"
userName = "string"
}
})
}
Valeurs de propriétés
labs/virtualmachines
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.DevTestLab/labs/virtualmachines@2018-09-15 » |
name | Nom de la ressource | chaîne (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 |
artifacts | Artefacts à installer sur la machine virtuelle. | ArtifactInstallProperties[] |
createdDate | Date de création de la machine virtuelle. | string |
customImageId | Identificateur d’image personnalisé de la machine virtuelle. | string |
dataDiskParameters | Disques de données nouveaux ou existants à attacher à la machine virtuelle après la création | DataDiskProperties[] |
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 |
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 |
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 |
planId | ID du plan associé à l’image de machine virtuelle | string |
scheduleParameters | Planifications de machine virtuelle à créer | ScheduleCreationParameter[] |
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 |
userName | Nom d’utilisateur de la machine virtuelle. | string |
ArtifactInstallProperties
Nom | Description | Valeur |
---|---|---|
artifactId | Identificateur de l’artefact. | string |
artifactTitle | Titre 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 |
DataDiskProperties
Nom | Description | Valeur |
---|---|---|
attachNewDataDiskOptions | Spécifie les options permettant d’attacher un nouveau disque à la machine virtuelle. | AttachNewDataDiskOptions |
existingLabDiskId | Spécifie l’ID de disque de labo existant à attacher à la machine virtuelle. | string |
hostCaching | Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite). | "None" « ReadOnly » « ReadWrite » |
AttachNewDataDiskOptions
Nom | Description | Valeur |
---|---|---|
diskName | Nom du disque à attacher. | string |
diskSizeGiB | Taille du disque à attacher en Gibibytes. | int |
diskType | Type de stockage du disque (Par exemple, Standard, Premium). | « Premium » « Standard » « StandardSSD » |
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 » |
ScheduleCreationParameter
Nom | Description | Valeur |
---|---|---|
name | Nom de la machine virtuelle ou de l’environnement | string |
properties | Propriétés de la planification. | ScheduleCreationParameterProperties |
tags | Balises de la ressource. | object |
ScheduleCreationParameterProperties
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 |
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 |
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 |
---|---|---|
emailRecipient | Destinataire de l’e-mail auquel envoyer des notifications (peut être une liste d’adresses e-mail séparées par deux-points). | string |
notificationLocale | Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN). | string |
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 se produira. | string |
Semaine | Jours de la semaine pour lesquels l’horaire est défini (par exemple, dimanche, lundi, mardi, etc.). | string[] |