Laboratori Microsoft.DevTestLab

Definizione di risorsa Bicep

Il tipo di risorsa lab può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione di Dev Test Lab.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource lab 'Microsoft.DevTestLab/labs@2018-09-15' = {
  name: resourceName
  location: location
  properties: {
    labStorageType: 'Premium'
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Module Description
Laboratorio di sviluppo e test Modulo di risorse AVM per DevTest Lab

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Description
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili in https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

Formato risorsa

Per creare una risorsa Microsoft.DevTestLab/labs, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DevTestLab/labs@2018-09-15' = {
  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'
  }
}

Valori delle proprietà

Microsoft.DevTestLab/labs

Name Description Value
location Posizione geografica in cui risiede la risorsa string
name Nome della risorsa stringa (obbligatorio)
properties Proprietà della risorsa. LabProperties (obbligatorio)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

LabAnnouncementProperties

Name Description Value
enabled L'annuncio del lab è attivo/abilitato al momento? 'Disabled'
'Enabled'
expirationDate Ora in cui l'annuncio scade (null per mai) string
expired L'annuncio è scaduto? bool
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string
title Titolo di testo normale per l'annuncio del lab string

LabProperties

Name Description Value
announcement Proprietà di qualsiasi annuncio lab associato a questo lab LabAnnouncementProperties
environmentPermission Diritti di accesso da concedere all'utente durante il provisioning di un ambiente 'Contributor'
'Reader'
extendedProperties Proprietà estese del lab usato per le funzionalità sperimentali LabPropertiesExtendedProperties
labStorageType Tipo di spazio di archiviazione usato dal lab. Può essere Premium o Standard. Il valore predefinito è Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Elenco ordinato di ID risorsa artefatti che devono essere applicati a tutte le creazioni di macchine virtuali Linux per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
mandatoryArtifactsResourceIdsWindows Elenco ordinato di ID risorsa artefatto che devono essere applicati a tutte le creazioni di macchine virtuali Windows per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
premiumDataDisks Impostazione per abilitare l'utilizzo dei dischi dati Premium.
Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium.
Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.		 'Disabled'
'Enabled'
support Proprietà di qualsiasi messaggio di supporto lab associato a questo lab LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled Al momento il banner di supporto del lab è attivo/abilitato? 'Disabled'
'Enabled'
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string

LabTags

Name Description Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa lab può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template Description
Creare un nuovo lab in Azure DevTest Labs

Distribuire in Azure 		Questo modello crea una nuova istanza di DevTest Lab/DTL. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTestlab disponibili in https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta

Distribuire in Azure 		Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili in https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale Windows Server

Distribuire in Azure 		Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili in https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

Formato risorsa

Per creare una risorsa Microsoft.DevTestLab/labs, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

Microsoft.DevTestLab/labs

Name Description Value
apiVersion Versione dell'API '2018-09-15'
location Posizione geografica in cui risiede la risorsa string
name Nome della risorsa stringa (obbligatorio)
properties Proprietà della risorsa. LabProperties (obbligatorio)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DevTestLab/labs'

LabAnnouncementProperties

Name Description Value
enabled L'annuncio del lab è attivo/abilitato al momento? 'Disabled'
'Enabled'
expirationDate Ora in cui l'annuncio scade (null per mai) string
expired L'annuncio è scaduto? bool
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string
title Titolo di testo normale per l'annuncio del lab string

LabProperties

Name Description Value
announcement Proprietà di qualsiasi annuncio lab associato a questo lab LabAnnouncementProperties
environmentPermission Diritti di accesso da concedere all'utente durante il provisioning di un ambiente 'Contributor'
'Reader'
extendedProperties Proprietà estese del lab usato per le funzionalità sperimentali LabPropertiesExtendedProperties
labStorageType Tipo di spazio di archiviazione usato dal lab. Può essere Premium o Standard. Il valore predefinito è Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Elenco ordinato di ID risorsa artefatti che devono essere applicati a tutte le creazioni di macchine virtuali Linux per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
mandatoryArtifactsResourceIdsWindows Elenco ordinato di ID risorsa artefatto che devono essere applicati a tutte le creazioni di macchine virtuali Windows per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
premiumDataDisks Impostazione per abilitare l'utilizzo dei dischi dati Premium.
Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium.
Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.		 'Disabled'
'Enabled'
support Proprietà di qualsiasi messaggio di supporto lab associato a questo lab LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled Al momento il banner di supporto del lab è attivo/abilitato? 'Disabled'
'Enabled'
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string

LabTags

Name Description Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa lab può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione di 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    = ["*"]
}

Formato risorsa

Per creare una risorsa Microsoft.DevTestLab/labs, aggiungere il codice Terraform seguente al modello.

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"
      }
    }
  }
}

Valori delle proprietà

Microsoft.DevTestLab/labs

Name Description Value
location Posizione geografica in cui risiede la risorsa string
name Nome della risorsa stringa (obbligatorio)
properties Proprietà della risorsa. LabProperties (obbligatorio)
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.DevTestLab/labs@2018-09-15"

LabAnnouncementProperties

Name Description Value
enabled L'annuncio del lab è attivo/abilitato al momento? 'Disabled'
'Enabled'
expirationDate Ora in cui l'annuncio scade (null per mai) string
expired L'annuncio è scaduto? bool
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string
title Titolo di testo normale per l'annuncio del lab string

LabProperties

Name Description Value
announcement Proprietà di qualsiasi annuncio lab associato a questo lab LabAnnouncementProperties
environmentPermission Diritti di accesso da concedere all'utente durante il provisioning di un ambiente 'Contributor'
'Reader'
extendedProperties Proprietà estese del lab usato per le funzionalità sperimentali LabPropertiesExtendedProperties
labStorageType Tipo di spazio di archiviazione usato dal lab. Può essere Premium o Standard. Il valore predefinito è Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Elenco ordinato di ID risorsa artefatti che devono essere applicati a tutte le creazioni di macchine virtuali Linux per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
mandatoryArtifactsResourceIdsWindows Elenco ordinato di ID risorsa artefatto che devono essere applicati a tutte le creazioni di macchine virtuali Windows per impostazione predefinita, prima degli artefatti specificati dall'utente. string[]
premiumDataDisks Impostazione per abilitare l'utilizzo dei dischi dati Premium.
Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium.
Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.		 'Disabled'
'Enabled'
support Proprietà di qualsiasi messaggio di supporto lab associato a questo lab LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled Al momento il banner di supporto del lab è attivo/abilitato? 'Disabled'
'Enabled'
markdown Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento. string

LabTags

Name Description Value
  • Last updated on