Laboratoires Microsoft.DevTestLab/virtualmachines 2018-09-15

Article
12/20/2024

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@2018-09-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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'
          timeZoneId: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {
          {customized property}: 'string'
        }
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

ArtifactInstallProperties

Nom	Description	Valeur
artifactId	Identificateur de l’artefact.	corde
artifactTitle	Titre 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

AttachNewDataDiskOptions

Nom	Description	Valeur
diskName	Nom du disque à attacher.	corde
diskSizeGiB	Taille du disque à attacher en Gibibytes.	Int
diskType	Type de stockage pour le disque (par exemple, Standard, Premium).	'Premium' 'Standard' 'StandardSSD'

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 du labo existant à attacher à la machine virtuelle.	corde
hostCaching	Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite).	'None' 'ReadOnly' 'ReadWrite'

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
Artefacts	Artefacts à installer sur la machine virtuelle.	ArtifactInstallProperties[]
createdDate	Date de création de la machine virtuelle.	corde
customImageId	Identificateur d’image personnalisé de la machine virtuelle.	corde
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.	corde
expirationDate	Date d’expiration 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
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 Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
planId	ID du plan associé à l’image de machine virtuelle	corde
scheduleParameters	Planifications de machines virtuelles à créer	ScheduleCreationParameter[]
taille	Taille de la machine virtuelle.	corde
sshKey	Clé SSH de l’administrateur de la machine virtuelle.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
storageType	Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium).	corde
nom d’utilisateur	Nom d’utilisateur de la machine virtuelle.	corde

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
emailRecipient	Le destinataire de l’e-mail auquel envoyer des notifications (il peut s’agir d’une liste d’adresses e-mail séparées par des points-virgules).	corde
notificationLocale	Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN).	corde
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

ScheduleCreationParameter

Nom	Description	Valeur
nom	Nom de la machine virtuelle ou de l’environnement	corde
Propriétés	Propriétés de la planification.	ScheduleCreationParameterProperties
étiquettes	Balises de la ressource.	ScheduleCreationParameterTags

ScheduleCreationParameterProperties

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
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 de chine, heure standard du Groenland, heure standard du Pacifique, etc.). Les valeurs possibles pour cette propriété sont disponibles dans `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corde
weeklyRecurrence	Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire.	WeekDetails

ScheduleCreationParameterTags

Nom	Description	Valeur

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": "2018-09-15",
  "name": "string",
  "location": "string",
  "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",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

ArtifactInstallProperties

Nom	Description	Valeur
artifactId	Identificateur de l’artefact.	corde
artifactTitle	Titre 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

AttachNewDataDiskOptions

Nom	Description	Valeur
diskName	Nom du disque à attacher.	corde
diskSizeGiB	Taille du disque à attacher en Gibibytes.	Int
diskType	Type de stockage pour le disque (par exemple, Standard, Premium).	'Premium' 'Standard' 'StandardSSD'

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 du labo existant à attacher à la machine virtuelle.	corde
hostCaching	Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite).	'None' 'ReadOnly' 'ReadWrite'

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
Artefacts	Artefacts à installer sur la machine virtuelle.	ArtifactInstallProperties[]
createdDate	Date de création de la machine virtuelle.	corde
customImageId	Identificateur d’image personnalisé de la machine virtuelle.	corde
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.	corde
expirationDate	Date d’expiration 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
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 Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
planId	ID du plan associé à l’image de machine virtuelle	corde
scheduleParameters	Planifications de machines virtuelles à créer	ScheduleCreationParameter[]
taille	Taille de la machine virtuelle.	corde
sshKey	Clé SSH de l’administrateur de la machine virtuelle.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
storageType	Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium).	corde
nom d’utilisateur	Nom d’utilisateur de la machine virtuelle.	corde

Microsoft.DevTestLab/labs/virtualmachines

Nom	Description	Valeur
apiVersion	Version de l’API	'2018-09-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
emailRecipient	Le destinataire de l’e-mail auquel envoyer des notifications (il peut s’agir d’une liste d’adresses e-mail séparées par des points-virgules).	corde
notificationLocale	Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN).	corde
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

ScheduleCreationParameter

Nom	Description	Valeur
nom	Nom de la machine virtuelle ou de l’environnement	corde
Propriétés	Propriétés de la planification.	ScheduleCreationParameterProperties
étiquettes	Balises de la ressource.	ScheduleCreationParameterTags

ScheduleCreationParameterProperties

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
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 de chine, heure standard du Groenland, heure standard du Pacifique, etc.). Les valeurs possibles pour cette propriété sont disponibles dans `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corde
weeklyRecurrence	Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire.	WeekDetails

ScheduleCreationParameterTags

Nom	Description	Valeur

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@2018-09-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Valeurs de propriété

ArtifactInstallProperties

Nom	Description	Valeur
artifactId	Identificateur de l’artefact.	corde
artifactTitle	Titre 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

AttachNewDataDiskOptions

Nom	Description	Valeur
diskName	Nom du disque à attacher.	corde
diskSizeGiB	Taille du disque à attacher en Gibibytes.	Int
diskType	Type de stockage pour le disque (par exemple, Standard, Premium).	'Premium' 'Standard' 'StandardSSD'

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 du labo existant à attacher à la machine virtuelle.	corde
hostCaching	Option de mise en cache pour un disque de données (par exemple, None, ReadOnly, ReadWrite).	'None' 'ReadOnly' 'ReadWrite'

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
Artefacts	Artefacts à installer sur la machine virtuelle.	ArtifactInstallProperties[]
createdDate	Date de création de la machine virtuelle.	corde
customImageId	Identificateur d’image personnalisé de la machine virtuelle.	corde
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.	corde
expirationDate	Date d’expiration 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
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 Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
planId	ID du plan associé à l’image de machine virtuelle	corde
scheduleParameters	Planifications de machines virtuelles à créer	ScheduleCreationParameter[]
taille	Taille de la machine virtuelle.	corde
sshKey	Clé SSH de l’administrateur de la machine virtuelle.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.
storageType	Type de stockage à utiliser pour la machine virtuelle (par exemple, Standard, Premium).	corde
nom d’utilisateur	Nom d’utilisateur de la machine virtuelle.	corde

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@2018-09-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
emailRecipient	Le destinataire de l’e-mail auquel envoyer des notifications (il peut s’agir d’une liste d’adresses e-mail séparées par des points-virgules).	corde
notificationLocale	Paramètres régionaux à utiliser lors de l’envoi d’une notification (secours pour les langues non prises en charge est EN).	corde
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

ScheduleCreationParameter

Nom	Description	Valeur
nom	Nom de la machine virtuelle ou de l’environnement	corde
Propriétés	Propriétés de la planification.	ScheduleCreationParameterProperties
étiquettes	Balises de la ressource.	ScheduleCreationParameterTags

ScheduleCreationParameterProperties

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
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 de chine, heure standard du Groenland, heure standard du Pacifique, etc.). Les valeurs possibles pour cette propriété sont disponibles dans `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corde
weeklyRecurrence	Si la planification ne se produit que quelques jours de la semaine, spécifiez la périodicité hebdomadaire.	WeekDetails

ScheduleCreationParameterTags

Nom	Description	Valeur

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[]

Partager via

Laboratoires Microsoft.DevTestLab/virtualmachines 2018-09-15

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Exemples de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Commentaires

Ressources supplémentaires