Compartir a través de

Laboratorios de Microsoft.DevTestLab

Definición de recursos de Bicep

El tipo de recurso labs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs

Name Description Value
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
properties Propiedades del recurso. LabProperties (obligatorio)
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

LabAnnouncementProperties

Name Description Value
enabled ¿El anuncio del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
expirationDate Hora a la que expira el anuncio (null para nunca) string
expired ¿Ha expirado este anuncio? bool
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string
title Título de texto sin formato del anuncio del laboratorio string

LabProperties

Name Description Value
announcement Propiedades de cualquier anuncio de laboratorio asociado a este laboratorio LabAnnouncementProperties
environmentPermission Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno 'Contributor'
'Reader'
extendedProperties Propiedades extendidas del laboratorio usadas para características experimentales LabPropertiesExtendedProperties
labStorageType Tipo de almacenamiento usado por el laboratorio. Puede ser Premium o Estándar. El valor predeterminado es Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Linux de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
mandatoryArtifactsResourceIdsWindows Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Windows de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
premiumDataDisks Configuración para habilitar el uso de discos de datos Premium.
Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium.
Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.		 'Disabled'
'Enabled'
support Propiedades de cualquier mensaje de soporte técnico de laboratorio asociado a este laboratorio LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled ¿El banner de soporte técnico del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string

ResourceTags

Name Description Value

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Module Description
Laboratorio de pruebas de desarrollo Módulo de recursos de AVM para DevTest Lab

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Description
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de plantilla de ARM

El tipo de recurso labs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs, agregue el siguiente JSON a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs

Name Description Value
apiVersion La versión de api '2018-09-15'
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
properties Propiedades del recurso. LabProperties (obligatorio)
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type El tipo de recurso 'Microsoft.DevTestLab/labs'

LabAnnouncementProperties

Name Description Value
enabled ¿El anuncio del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
expirationDate Hora a la que expira el anuncio (null para nunca) string
expired ¿Ha expirado este anuncio? bool
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string
title Título de texto sin formato del anuncio del laboratorio string

LabProperties

Name Description Value
announcement Propiedades de cualquier anuncio de laboratorio asociado a este laboratorio LabAnnouncementProperties
environmentPermission Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno 'Contributor'
'Reader'
extendedProperties Propiedades extendidas del laboratorio usadas para características experimentales LabPropertiesExtendedProperties
labStorageType Tipo de almacenamiento usado por el laboratorio. Puede ser Premium o Estándar. El valor predeterminado es Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Linux de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
mandatoryArtifactsResourceIdsWindows Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Windows de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
premiumDataDisks Configuración para habilitar el uso de discos de datos Premium.
Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium.
Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.		 'Disabled'
'Enabled'
support Propiedades de cualquier mensaje de soporte técnico de laboratorio asociado a este laboratorio LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled ¿El banner de soporte técnico del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string

ResourceTags

Name Description Value

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
Creación de un laboratorio en Azure DevTest Labs

Implementación en Azure 		Esta plantilla crea una nueva instancia de DevTest Lab/DTL. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTestlab disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada

Implementación en Azure 		Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un laboratorio en Azure DevTest Labs con una máquina virtual Windows Server

Implementación en Azure 		Esta plantilla crea una nueva instancia de DevTest Lab/DTL con una máquina virtual de Windows Server 2019 Datacenter en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso labs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevTestLab/labs, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

Microsoft.DevTestLab/labs

Name Description Value
location Ubicación del recurso. string
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
properties Propiedades del recurso. LabProperties (obligatorio)
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft.DevTestLab/labs@2018-09-15"

LabAnnouncementProperties

Name Description Value
enabled ¿El anuncio del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
expirationDate Hora a la que expira el anuncio (null para nunca) string
expired ¿Ha expirado este anuncio? bool
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string
title Título de texto sin formato del anuncio del laboratorio string

LabProperties

Name Description Value
announcement Propiedades de cualquier anuncio de laboratorio asociado a este laboratorio LabAnnouncementProperties
environmentPermission Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno 'Contributor'
'Reader'
extendedProperties Propiedades extendidas del laboratorio usadas para características experimentales LabPropertiesExtendedProperties
labStorageType Tipo de almacenamiento usado por el laboratorio. Puede ser Premium o Estándar. El valor predeterminado es Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Linux de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
mandatoryArtifactsResourceIdsWindows Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Windows de forma predeterminada, antes de los artefactos especificados por el usuario. string[]
premiumDataDisks Configuración para habilitar el uso de discos de datos Premium.
Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium.
Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.		 'Disabled'
'Enabled'
support Propiedades de cualquier mensaje de soporte técnico de laboratorio asociado a este laboratorio LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled ¿El banner de soporte técnico del laboratorio está activo o habilitado en este momento? 'Disabled'
'Enabled'
markdown Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada. string

ResourceTags

Name Description Value

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación 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