Partager via

Laboratoires Microsoft.DevTestLab

Définition de ressource Bicep

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

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

Format de ressource

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

resource symbolicname 'Microsoft.DevTestLab/labs@2018-09-15' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    announcement: {
      enabled: 'string'
      expirationDate: 'string'
      expired: bool
      markdown: 'string'
      title: 'string'
    }
    environmentPermission: 'string'
    extendedProperties: {
      {customized property}: 'string'
    }
    labStorageType: 'string'
    mandatoryArtifactsResourceIdsLinux: [
      'string'
    ]
    mandatoryArtifactsResourceIdsWindows: [
      'string'
    ]
    premiumDataDisks: 'string'
    support: {
      enabled: 'string'
      markdown: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

Microsoft.DevTestLab/labs

Name Description Value
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
properties Propriétés de la ressource. LabProperties (obligatoire)
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

LabAnnouncementProperties

Name Description Value
enabled L’annonce du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
expirationDate Heure à laquelle l’annonce expire (null pour jamais) string
expired Cette annonce a-t-elle expiré ? bool
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string
title Titre en texte brut de l’annonce du labo string

LabProperties

Name Description Value
announcement Propriétés d’une annonce de laboratoire associée à ce labo LabAnnouncementProperties
environmentPermission Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement 'Contributor'
'Reader'
extendedProperties Propriétés étendues du labo utilisées pour les fonctionnalités expérimentales LabPropertiesExtendedProperties
labStorageType Type de stockage utilisé par le labo. Il peut être Premium ou Standard. La valeur par défaut est Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués sur toutes les créations de machines virtuelles Linux par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
mandatoryArtifactsResourceIdsWindows Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués à toutes les créations de machines virtuelles Windows par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
premiumDataDisks Paramètre permettant d’activer l’utilisation des disques de données Premium.
Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée.
Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.		 'Disabled'
'Enabled'
support Propriétés d’un message de support lab associé à ce labo LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled La bannière de prise en charge du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string

ResourceTags

Name Description Value

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Description
Laboratoire DevTest Module de ressources AVM pour DevTest Lab

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Description
Crée un laboratoire dans Azure DevTest Labs avec une machine virtuelle revendiquée Ce modèle crée une instance DevTest Lab / DTL avec une machine virtuelle Windows Server 2019 Datacenter revendiquée. Plus de modèles de démarrage rapide Azure Resource Manager pour Azure DevTest Labs disponibles à https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Définition de ressource de modèle ARM

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

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

Format de ressource

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

{
  "type": "Microsoft.DevTestLab/labs",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "properties": {
    "announcement": {
      "enabled": "string",
      "expirationDate": "string",
      "expired": "bool",
      "markdown": "string",
      "title": "string"
    },
    "environmentPermission": "string",
    "extendedProperties": {
      "{customized property}": "string"
    },
    "labStorageType": "string",
    "mandatoryArtifactsResourceIdsLinux": [ "string" ],
    "mandatoryArtifactsResourceIdsWindows": [ "string" ],
    "premiumDataDisks": "string",
    "support": {
      "enabled": "string",
      "markdown": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

Microsoft.DevTestLab/labs

Name Description Value
apiVersion Version de l’API '2018-09-15'
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
properties Propriétés de la ressource. LabProperties (obligatoire)
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.DevTestLab/labs'

LabAnnouncementProperties

Name Description Value
enabled L’annonce du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
expirationDate Heure à laquelle l’annonce expire (null pour jamais) string
expired Cette annonce a-t-elle expiré ? bool
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string
title Titre en texte brut de l’annonce du labo string

LabProperties

Name Description Value
announcement Propriétés d’une annonce de laboratoire associée à ce labo LabAnnouncementProperties
environmentPermission Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement 'Contributor'
'Reader'
extendedProperties Propriétés étendues du labo utilisées pour les fonctionnalités expérimentales LabPropertiesExtendedProperties
labStorageType Type de stockage utilisé par le labo. Il peut être Premium ou Standard. La valeur par défaut est Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués sur toutes les créations de machines virtuelles Linux par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
mandatoryArtifactsResourceIdsWindows Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués à toutes les créations de machines virtuelles Windows par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
premiumDataDisks Paramètre permettant d’activer l’utilisation des disques de données Premium.
Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée.
Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.		 'Disabled'
'Enabled'
support Propriétés d’un message de support lab associé à ce labo LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled La bannière de prise en charge du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string

ResourceTags

Name Description Value

Exemples d’utilisation

Modèles de démarrage rapide Azure

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

Template Description
Créer un laboratoire dans Azure DevTest Labs

Déployer sur Azure 		Ce modèle crée une instance DevTest Lab /DTL. Autres modèles de démarrage rapide Azure Resource Manager pour Azure DevTestlab disponibles à https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crée un laboratoire dans Azure DevTest Labs avec une machine virtuelle revendiquée

Déployer sur Azure 		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
Crée un laboratoire dans Azure DevTest Labs avec une machine virtuelle Windows Server

Déployer sur Azure 		Ce modèle crée une instance DevTest Lab / DTL avec une machine virtuelle Windows Server 2019 Datacenter. 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 peut être déployé avec des opérations qui ciblent :

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

Format de ressource

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs@2018-09-15"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      announcement = {
        enabled = "string"
        expirationDate = "string"
        expired = bool
        markdown = "string"
        title = "string"
      }
      environmentPermission = "string"
      extendedProperties = {
        {customized property} = "string"
      }
      labStorageType = "string"
      mandatoryArtifactsResourceIdsLinux = [
        "string"
      ]
      mandatoryArtifactsResourceIdsWindows = [
        "string"
      ]
      premiumDataDisks = "string"
      support = {
        enabled = "string"
        markdown = "string"
      }
    }
  }
}

Valeurs de propriété

Microsoft.DevTestLab/labs

Name Description Value
location Emplacement de la ressource. string
name Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
properties Propriétés de la ressource. LabProperties (obligatoire)
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource "Microsoft.DevTestLab/labs@2018-09-15"

LabAnnouncementProperties

Name Description Value
enabled L’annonce du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
expirationDate Heure à laquelle l’annonce expire (null pour jamais) string
expired Cette annonce a-t-elle expiré ? bool
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string
title Titre en texte brut de l’annonce du labo string

LabProperties

Name Description Value
announcement Propriétés d’une annonce de laboratoire associée à ce labo LabAnnouncementProperties
environmentPermission Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement 'Contributor'
'Reader'
extendedProperties Propriétés étendues du labo utilisées pour les fonctionnalités expérimentales LabPropertiesExtendedProperties
labStorageType Type de stockage utilisé par le labo. Il peut être Premium ou Standard. La valeur par défaut est Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués sur toutes les créations de machines virtuelles Linux par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
mandatoryArtifactsResourceIdsWindows Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués à toutes les créations de machines virtuelles Windows par défaut, avant les artefacts spécifiés par l’utilisateur. string[]
premiumDataDisks Paramètre permettant d’activer l’utilisation des disques de données Premium.
Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée.
Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.		 'Disabled'
'Enabled'
support Propriétés d’un message de support lab associé à ce labo LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled La bannière de prise en charge du labo est-elle active/activée pour l’instant ? 'Disabled'
'Enabled'
markdown Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche. string

ResourceTags

Name Description Value

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement de Dev Test Lab.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "lab" {
  type      = "Microsoft.DevTestLab/labs@2018-09-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      labStorageType = "Premium"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}
  • Last updated on