Partilhar via


Laboratórios Microsoft.DevTestLab

Definição de recursos do bíceps

O tipo de recurso labs pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o seguinte Bicep ao seu 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
localização A localização do recurso. cadeia (de caracteres)
name O nome do recurso string (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
âmbito 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 tags. Consulte Tags em modelos

LabAnnouncementProperties

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

LabProperties

Name Description Value
announcement As propriedades de qualquer anúncio 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 utilizado 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 aplicados em todas as criações de VM 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 o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida.
Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
apoio ao cliente 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 O banner de suporte do laboratório está ativo/ativado no momento? 'Disabled'
'Enabled'
markdown O texto de marcação (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia (de caracteres)

ResourceTags

Name Description Value

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

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

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure 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 declarada Este modelo cria uma nova instância do DevTest Lab/DTL com uma VM de Datacenter do Windows Server 2019 declarada. 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 ARM

O tipo de recurso labs pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o seguinte JSON ao seu 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 api '2018-09-15'
localização A localização do recurso. cadeia (de caracteres)
name O nome do recurso string (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DevTestLab/labs'

LabAnnouncementProperties

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

LabProperties

Name Description Value
announcement As propriedades de qualquer anúncio 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 utilizado 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 aplicados em todas as criações de VM 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 o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida.
Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
apoio ao cliente 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 O banner de suporte do laboratório está ativo/ativado no momento? 'Disabled'
'Enabled'
markdown O texto de marcação (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia (de caracteres)

ResourceTags

Name Description Value

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

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

Implantar no Azure
Este modelo cria uma nova instância do DevTest Lab/DTL. Mais modelos de início rápido do Azure Resource Manager para o 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 declarada

Implantar no Azure
Este modelo cria uma nova instância do DevTest Lab/DTL com uma VM de Datacenter do Windows Server 2019 declarada. 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
Este modelo cria uma nova instância do DevTest Lab/DTL com uma VM do Windows Server 2019 Datacenter. 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 recursos Terraform (provedor AzAPI)

O tipo de recurso labs pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.DevTestLab/labs, adicione o seguinte Terraform 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
localização A localização do recurso. cadeia (de caracteres)
name O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
properties As propriedades do recurso. LabProperties (obrigatório)
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DevTestLab/labs@2018-09-15"

LabAnnouncementProperties

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

LabProperties

Name Description Value
announcement As propriedades de qualquer anúncio 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 utilizado 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 aplicados em todas as criações de VM 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 o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida.
Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
'Disabled'
'Enabled'
apoio ao cliente 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 O banner de suporte do laboratório está ativo/ativado no momento? 'Disabled'
'Enabled'
markdown O texto de marcação (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado. cadeia (de caracteres)

ResourceTags

Name Description Value

Exemplos de uso

Amostras 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    = ["*"]
}