Compartilhar via


Laboratórios do Microsoft.DevTestLab

Definição de recurso do Bicep

O tipo de recurso de laboratórios pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o Bicep a seguir ao modelo.

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 propriedade

Microsoft.DevTestLab/labs

Name Description Value
local O local do recurso. cadeia
name O nome do recurso cadeia de caracteres (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos

LabAnnouncementProperties

Name Description Value
enabled O anúncio do laboratório está ativo/habilitado no momento? 'Disabled'
'Enabled'
expirationDate O momento em que o anúncio expira (nulo para nunca) cadeia
expired Esse anúncio expirou? bool
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia
title O título de texto sem formatação para o anúncio do laboratório cadeia

LabProperties

Name Description Value
announcement As propriedades de qualquer comunicado de laboratório associado a este laboratório LabAnnouncementProperties
environmentPermission Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente 'Contributor'
'Reader'
extendedProperties Propriedades estendidas do laboratório usadas para recursos experimentais LabPropertiesExtendedProperties
labStorageType Tipo de armazenamento usado pelo laboratório. Pode ser Premium ou Standard. O padrão é Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Linux por padrão, antes dos artefatos especificados pelo usuário. string[]
mandatoryArtifactsResourceIdsWindows A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Windows por padrão, antes dos artefatos especificados pelo usuário. string[]
premiumDataDisks A configuração para habilitar o uso de discos de dados premium.
Quando seu valor é "Habilitado", a criação de discos de dados standard ou premium é permitida.
Quando seu valor é 'Desabilitado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
dar suporte As propriedades de qualquer mensagem de suporte de laboratório associada a este laboratório LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled A faixa de suporte do laboratório está ativa/habilitada no momento? 'Disabled'
'Enabled'
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia

ResourceTags

Name Description Value

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Module Description
Laboratório de DevTest Módulo de recursos da AVM para o DevTest Lab

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
Cria um laboratório no Azure DevTest Labs com uma VM Esse modelo cria uma nova instância do DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019 reivindicada. Mais modelos de início rápido do Azure Resource Manager para o Azure DevTest Labs disponíveis em https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definição de recurso de modelo do ARM

O tipo de recurso de laboratórios pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o JSON a seguir ao modelo.

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

Microsoft.DevTestLab/labs

Name Description Value
apiVersion A versão da API '2018-09-15'
local O local do recurso. cadeia
name O nome do recurso cadeia de caracteres (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevTestLab/labs'

LabAnnouncementProperties

Name Description Value
enabled O anúncio do laboratório está ativo/habilitado no momento? 'Disabled'
'Enabled'
expirationDate O momento em que o anúncio expira (nulo para nunca) cadeia
expired Esse anúncio expirou? bool
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia
title O título de texto sem formatação para o anúncio do laboratório cadeia

LabProperties

Name Description Value
announcement As propriedades de qualquer comunicado de laboratório associado a este laboratório LabAnnouncementProperties
environmentPermission Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente 'Contributor'
'Reader'
extendedProperties Propriedades estendidas do laboratório usadas para recursos experimentais LabPropertiesExtendedProperties
labStorageType Tipo de armazenamento usado pelo laboratório. Pode ser Premium ou Standard. O padrão é Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Linux por padrão, antes dos artefatos especificados pelo usuário. string[]
mandatoryArtifactsResourceIdsWindows A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Windows por padrão, antes dos artefatos especificados pelo usuário. string[]
premiumDataDisks A configuração para habilitar o uso de discos de dados premium.
Quando seu valor é "Habilitado", a criação de discos de dados standard ou premium é permitida.
Quando seu valor é 'Desabilitado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
dar suporte As propriedades de qualquer mensagem de suporte de laboratório associada a este laboratório LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled A faixa de suporte do laboratório está ativa/habilitada no momento? 'Disabled'
'Enabled'
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia

ResourceTags

Name Description Value

Exemplos de uso

Modelos de início rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Description
Criar um novo laboratório no Azure DevTest Labs

Implantar no Azure
Esse modelo cria uma nova instância do DevTest Lab/DTL. Mais modelos de início rápido do Azure Resource Manager para Azure DevTestlab disponíveis em https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Cria um laboratório no Azure DevTest Labs com uma VM

Implantar no Azure
Esse modelo cria uma nova instância do DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019 reivindicada. Mais modelos de início rápido do Azure Resource Manager para o Azure DevTest Labs disponíveis em https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Cria um laboratório no Azure DevTest Labs com uma VM do Windows Server

Implantar no Azure
Esse modelo cria uma nova instância do DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019 nela. Mais modelos de início rápido do Azure Resource Manager para o Azure DevTest Labs disponíveis em https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de laboratórios pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o Terraform a seguir ao seu modelo.

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 propriedade

Microsoft.DevTestLab/labs

Name Description Value
local O local do recurso. cadeia
name O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
tags Etiquetas de recursos Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevTestLab/labs@2018-09-15"

LabAnnouncementProperties

Name Description Value
enabled O anúncio do laboratório está ativo/habilitado no momento? 'Disabled'
'Enabled'
expirationDate O momento em que o anúncio expira (nulo para nunca) cadeia
expired Esse anúncio expirou? bool
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia
title O título de texto sem formatação para o anúncio do laboratório cadeia

LabProperties

Name Description Value
announcement As propriedades de qualquer comunicado de laboratório associado a este laboratório LabAnnouncementProperties
environmentPermission Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente 'Contributor'
'Reader'
extendedProperties Propriedades estendidas do laboratório usadas para recursos experimentais LabPropertiesExtendedProperties
labStorageType Tipo de armazenamento usado pelo laboratório. Pode ser Premium ou Standard. O padrão é Premium. 'Premium'
'Standard'
'StandardSSD'
mandatoryArtifactsResourceIdsLinux A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Linux por padrão, antes dos artefatos especificados pelo usuário. string[]
mandatoryArtifactsResourceIdsWindows A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Windows por padrão, antes dos artefatos especificados pelo usuário. string[]
premiumDataDisks A configuração para habilitar o uso de discos de dados premium.
Quando seu valor é "Habilitado", a criação de discos de dados standard ou premium é permitida.
Quando seu valor é 'Desabilitado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
dar suporte As propriedades de qualquer mensagem de suporte de laboratório associada a este laboratório LabSupportProperties

LabPropertiesExtendedProperties

Name Description Value

LabSupportProperties

Name Description Value
enabled A faixa de suporte do laboratório está ativa/habilitada no momento? 'Disabled'
'Enabled'
markdown O texto de markdown (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia

ResourceTags

Name Description Value

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do 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    = ["*"]
}