Compartilhar via

Laboratórios do Microsoft.DevTestLab/virtualmachines 2016-05-15

  • Artigo

Definição de recurso do Bicep

O tipo de recurso labs/virtualmachines 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/virtualmachines, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
      }
      tags: {
        {customized property}: 'string'
      }
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

ApplicableSchedule

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ApplicableScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ApplicableScheduleProperties

Nome Descrição Valor
labVmsShutdown O agendamento de desligamento automático, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar
labVmsStartup O agendamento de inicialização automática, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar

ArtifactDeploymentStatusProperties

Nome Descrição Valor
artifactsApplied A contagem total dos artefatos que foram aplicados com êxito. int
deploymentStatus O status de implantação do artefato. corda
totalArtifacts A contagem total dos artefatos que foram aplicados provisoriamente. int

ArtifactInstallProperties

Nome Descrição Valor
artifactId O identificador do artefato. corda
deploymentStatusMessage A mensagem de status da implantação. corda
installTime A hora em que o artefato começa a ser instalado na máquina virtual. corda
Parâmetros Os parâmetros do artefato. ArtifactParameterProperties []
estado O status do artefato. corda
vmExtensionStatusMessage A mensagem de status da extensão da máquina virtual. corda

ArtifactParameterProperties

Nome Descrição Valor
nome O nome do parâmetro de artefato. corda
valor O valor do parâmetro de artefato. corda

ComputeDataDisk

Nome Descrição Valor
diskSizeGiB Obtém o tamanho do disco de dados no GiB. int
diskUri Quando apoiado por um blob, o URI do blob subjacente. corda
managedDiskId Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. corda
nome Obtém o nome do disco de dados. corda

ComputeVmInstanceViewStatus

Nome Descrição Valor
código Obtém o código de status. corda
displayStatus Obtém o rótulo localizável curto para o status. corda
Mensagem Obtém a mensagem associada ao status. corda

ComputeVmProperties

Nome Descrição Valor
dataDiskIds Obtém o uri de blob de discos de dados para a máquina virtual. string[]
dataDisks Obtém todos os discos de dados anexados à máquina virtual. ComputeDataDisk []
networkInterfaceId Obtém a ID da interface de rede da máquina virtual. corda
osDiskId Obtém o uri de blob de disco do sistema operacional para a máquina virtual. corda
osType Obtém o tipo de sistema operacional da máquina virtual. corda
Status Obtém os status da máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtém o tamanho da máquina virtual. corda

DayDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda

GalleryImageReference

Nome Descrição Valor
oferecer A oferta da imagem da galeria. corda
osType O tipo de sistema operacional da imagem da galeria. corda
editor O editor da imagem da galeria. corda
Sku A SKU da imagem da galeria. corda
Versão A versão da imagem da galeria. corda

HourDetails

Nome Descrição Valor
minuto Minutos da hora em que o agendamento será executado. int

InboundNatRule

Nome Descrição Valor
backendPort A porta para a qual o tráfego externo será redirecionado. int
frontendPort A porta do ponto de extremidade externo da conexão de entrada. Os valores possíveis variam entre 1 e 65535, inclusive. Se não for especificado, um valor será alocado automaticamente. int
transportProtocol O protocolo de transporte para o ponto de extremidade. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nome Descrição Valor
allowClaim Indica se outro usuário pode assumir a propriedade da máquina virtual Bool
applicableSchedule O agendamento aplicável para a máquina virtual. ApplicableSchedule
artifactDeploymentStatus O status de implantação do artefato para a máquina virtual. artifactDeploymentStatusProperties
Artefatos Os artefatos a serem instalados na máquina virtual. ArtifactInstallProperties[]
computeVm As propriedades da máquina virtual de computação. computeVmProperties
createdByUser O endereço de email do criador da máquina virtual. corda
createdByUserId O identificador de objeto do criador da máquina virtual. corda
createdDate A data de criação da máquina virtual. corda
customImageId O identificador de imagem personalizado da máquina virtual. corda
disallowPublicIpAddress Indica se a máquina virtual deve ser criada sem um endereço IP público. Bool
environmentId A ID do recurso do ambiente que contém essa máquina virtual, se houver. corda
expirationDate A data de validade da VM. corda
Fqdn O nome de domínio totalmente qualificado da máquina virtual. corda
galleryImageReference A referência de imagem do Microsoft Azure Marketplace da máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica se essa máquina virtual usa uma chave SSH para autenticação. Bool
labSubnetName O nome da sub-rede do laboratório da máquina virtual. corda
labVirtualNetworkId O identificador de rede virtual do laboratório da máquina virtual. corda
networkInterface As propriedades do adaptador de rede. NetworkInterfaceProperties
anotações As anotações da máquina virtual. corda
osType O tipo de sistema operacional da máquina virtual. corda
ownerObjectId O identificador de objeto do proprietário da máquina virtual. corda
ownerUserPrincipalName O nome principal do usuário do proprietário da máquina virtual. corda
senha A senha do administrador da máquina virtual. corda
provisioningState O status de provisionamento do recurso. corda
tamanho O tamanho da máquina virtual. corda
sshKey A chave SSH do administrador da máquina virtual. corda
storageType Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
userName O nome de usuário da máquina virtual. corda
virtualMachineCreationSource Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrição Valor
localização O local do recurso. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: laboratórios
Propriedades As propriedades do recurso. LabVirtualMachineProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NetworkInterfaceProperties

Nome Descrição Valor
dnsName O nome DNS. corda
privateIpAddress O endereço IP privado. corda
publicIpAddress O endereço IP público. corda
publicIpAddressId A ID do recurso do endereço IP público. corda
rdpAuthority A propriedade RdpAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para RDP (Protocolo de Área de Trabalho Remota). corda
sharedPublicIpAddressConfiguration A configuração para compartilhar um endereço IP público em várias máquinas virtuais. SharedPublicIpAddressConfiguration
sshAuthority A propriedade SshAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para SSH. corda
subnetId A ID do recurso da sub-rede. corda
virtualNetworkId A ID do recurso da rede virtual. corda

NotificationSettings

Nome Descrição Valor
estado Se as notificações estiverem habilitadas para esse agendamento (ou seja, Habilitado, Desabilitado). 'Desabilitado'
'Habilitado'
timeInMinutes Tempo em minutos antes do evento em que a notificação será enviada. int
webhookUrl A URL do webhook para a qual a notificação será enviada. corda

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

Horário

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ScheduleProperties

Nome Descrição Valor
dailyRecurrence Se o agendamento ocorrer uma vez a cada dia da semana, especifique a recorrência diária. DayDetails
hourlyRecurrence Se o agendamento ocorrer várias vezes por dia, especifique a recorrência por hora. HourDetails
notificationSettings Configurações de notificação. notificationSettings
provisioningState O status de provisionamento do recurso. corda
estado O status do agendamento (ou seja, Habilitado, Desabilitado) 'Desabilitado'
'Habilitado'
targetResourceId A ID do recurso à qual o agendamento pertence corda
taskType O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). corda
timeZoneId A ID do fuso horário (por exemplo, hora padrão do Pacífico). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
weeklyRecurrence Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrição Valor
inboundNatRules As regras NAT de entrada InboundNatRule []

WeekDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda
Semana Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda, terça,etc.). string[]

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
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 labs/virtualmachines 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/virtualmachines, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2016-05-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        }
      },
      "tags": {
        "{customized property}": "string"
      }
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

ApplicableSchedule

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ApplicableScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ApplicableScheduleProperties

Nome Descrição Valor
labVmsShutdown O agendamento de desligamento automático, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar
labVmsStartup O agendamento de inicialização automática, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar

ArtifactDeploymentStatusProperties

Nome Descrição Valor
artifactsApplied A contagem total dos artefatos que foram aplicados com êxito. int
deploymentStatus O status de implantação do artefato. corda
totalArtifacts A contagem total dos artefatos que foram aplicados provisoriamente. int

ArtifactInstallProperties

Nome Descrição Valor
artifactId O identificador do artefato. corda
deploymentStatusMessage A mensagem de status da implantação. corda
installTime A hora em que o artefato começa a ser instalado na máquina virtual. corda
Parâmetros Os parâmetros do artefato. ArtifactParameterProperties []
estado O status do artefato. corda
vmExtensionStatusMessage A mensagem de status da extensão da máquina virtual. corda

ArtifactParameterProperties

Nome Descrição Valor
nome O nome do parâmetro de artefato. corda
valor O valor do parâmetro de artefato. corda

ComputeDataDisk

Nome Descrição Valor
diskSizeGiB Obtém o tamanho do disco de dados no GiB. int
diskUri Quando apoiado por um blob, o URI do blob subjacente. corda
managedDiskId Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. corda
nome Obtém o nome do disco de dados. corda

ComputeVmInstanceViewStatus

Nome Descrição Valor
código Obtém o código de status. corda
displayStatus Obtém o rótulo localizável curto para o status. corda
Mensagem Obtém a mensagem associada ao status. corda

ComputeVmProperties

Nome Descrição Valor
dataDiskIds Obtém o uri de blob de discos de dados para a máquina virtual. string[]
dataDisks Obtém todos os discos de dados anexados à máquina virtual. ComputeDataDisk []
networkInterfaceId Obtém a ID da interface de rede da máquina virtual. corda
osDiskId Obtém o uri de blob de disco do sistema operacional para a máquina virtual. corda
osType Obtém o tipo de sistema operacional da máquina virtual. corda
Status Obtém os status da máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtém o tamanho da máquina virtual. corda

DayDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda

GalleryImageReference

Nome Descrição Valor
oferecer A oferta da imagem da galeria. corda
osType O tipo de sistema operacional da imagem da galeria. corda
editor O editor da imagem da galeria. corda
Sku A SKU da imagem da galeria. corda
Versão A versão da imagem da galeria. corda

HourDetails

Nome Descrição Valor
minuto Minutos da hora em que o agendamento será executado. int

InboundNatRule

Nome Descrição Valor
backendPort A porta para a qual o tráfego externo será redirecionado. int
frontendPort A porta do ponto de extremidade externo da conexão de entrada. Os valores possíveis variam entre 1 e 65535, inclusive. Se não for especificado, um valor será alocado automaticamente. int
transportProtocol O protocolo de transporte para o ponto de extremidade. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nome Descrição Valor
allowClaim Indica se outro usuário pode assumir a propriedade da máquina virtual Bool
applicableSchedule O agendamento aplicável para a máquina virtual. ApplicableSchedule
artifactDeploymentStatus O status de implantação do artefato para a máquina virtual. artifactDeploymentStatusProperties
Artefatos Os artefatos a serem instalados na máquina virtual. ArtifactInstallProperties[]
computeVm As propriedades da máquina virtual de computação. computeVmProperties
createdByUser O endereço de email do criador da máquina virtual. corda
createdByUserId O identificador de objeto do criador da máquina virtual. corda
createdDate A data de criação da máquina virtual. corda
customImageId O identificador de imagem personalizado da máquina virtual. corda
disallowPublicIpAddress Indica se a máquina virtual deve ser criada sem um endereço IP público. Bool
environmentId A ID do recurso do ambiente que contém essa máquina virtual, se houver. corda
expirationDate A data de validade da VM. corda
Fqdn O nome de domínio totalmente qualificado da máquina virtual. corda
galleryImageReference A referência de imagem do Microsoft Azure Marketplace da máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica se essa máquina virtual usa uma chave SSH para autenticação. Bool
labSubnetName O nome da sub-rede do laboratório da máquina virtual. corda
labVirtualNetworkId O identificador de rede virtual do laboratório da máquina virtual. corda
networkInterface As propriedades do adaptador de rede. NetworkInterfaceProperties
anotações As anotações da máquina virtual. corda
osType O tipo de sistema operacional da máquina virtual. corda
ownerObjectId O identificador de objeto do proprietário da máquina virtual. corda
ownerUserPrincipalName O nome principal do usuário do proprietário da máquina virtual. corda
senha A senha do administrador da máquina virtual. corda
provisioningState O status de provisionamento do recurso. corda
tamanho O tamanho da máquina virtual. corda
sshKey A chave SSH do administrador da máquina virtual. corda
storageType Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
userName O nome de usuário da máquina virtual. corda
virtualMachineCreationSource Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrição Valor
apiVersion A versão da API '2016-05-15'
localização O local do recurso. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do recurso. LabVirtualMachineProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

Nome Descrição Valor
dnsName O nome DNS. corda
privateIpAddress O endereço IP privado. corda
publicIpAddress O endereço IP público. corda
publicIpAddressId A ID do recurso do endereço IP público. corda
rdpAuthority A propriedade RdpAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para RDP (Protocolo de Área de Trabalho Remota). corda
sharedPublicIpAddressConfiguration A configuração para compartilhar um endereço IP público em várias máquinas virtuais. SharedPublicIpAddressConfiguration
sshAuthority A propriedade SshAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para SSH. corda
subnetId A ID do recurso da sub-rede. corda
virtualNetworkId A ID do recurso da rede virtual. corda

NotificationSettings

Nome Descrição Valor
estado Se as notificações estiverem habilitadas para esse agendamento (ou seja, Habilitado, Desabilitado). 'Desabilitado'
'Habilitado'
timeInMinutes Tempo em minutos antes do evento em que a notificação será enviada. int
webhookUrl A URL do webhook para a qual a notificação será enviada. corda

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

Horário

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ScheduleProperties

Nome Descrição Valor
dailyRecurrence Se o agendamento ocorrer uma vez a cada dia da semana, especifique a recorrência diária. DayDetails
hourlyRecurrence Se o agendamento ocorrer várias vezes por dia, especifique a recorrência por hora. HourDetails
notificationSettings Configurações de notificação. notificationSettings
provisioningState O status de provisionamento do recurso. corda
estado O status do agendamento (ou seja, Habilitado, Desabilitado) 'Desabilitado'
'Habilitado'
targetResourceId A ID do recurso à qual o agendamento pertence corda
taskType O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). corda
timeZoneId A ID do fuso horário (por exemplo, hora padrão do Pacífico). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
weeklyRecurrence Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrição Valor
inboundNatRules As regras NAT de entrada InboundNatRule []

WeekDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda
Semana Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda, terça,etc.). string[]

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
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

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

O tipo de recurso labs/virtualmachines pode ser implantado com operações direcionadas:

  • grupos de recursos

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/virtualmachines, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
        }
        tags = {
          {customized property} = "string"
        }
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  })
}

Valores de propriedade

ApplicableSchedule

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ApplicableScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ApplicableScheduleProperties

Nome Descrição Valor
labVmsShutdown O agendamento de desligamento automático, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar
labVmsStartup O agendamento de inicialização automática, se um tiver sido definido no nível de recurso de laboratório ou laboratório. agendar

ArtifactDeploymentStatusProperties

Nome Descrição Valor
artifactsApplied A contagem total dos artefatos que foram aplicados com êxito. int
deploymentStatus O status de implantação do artefato. corda
totalArtifacts A contagem total dos artefatos que foram aplicados provisoriamente. int

ArtifactInstallProperties

Nome Descrição Valor
artifactId O identificador do artefato. corda
deploymentStatusMessage A mensagem de status da implantação. corda
installTime A hora em que o artefato começa a ser instalado na máquina virtual. corda
Parâmetros Os parâmetros do artefato. ArtifactParameterProperties []
estado O status do artefato. corda
vmExtensionStatusMessage A mensagem de status da extensão da máquina virtual. corda

ArtifactParameterProperties

Nome Descrição Valor
nome O nome do parâmetro de artefato. corda
valor O valor do parâmetro de artefato. corda

ComputeDataDisk

Nome Descrição Valor
diskSizeGiB Obtém o tamanho do disco de dados no GiB. int
diskUri Quando apoiado por um blob, o URI do blob subjacente. corda
managedDiskId Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. corda
nome Obtém o nome do disco de dados. corda

ComputeVmInstanceViewStatus

Nome Descrição Valor
código Obtém o código de status. corda
displayStatus Obtém o rótulo localizável curto para o status. corda
Mensagem Obtém a mensagem associada ao status. corda

ComputeVmProperties

Nome Descrição Valor
dataDiskIds Obtém o uri de blob de discos de dados para a máquina virtual. string[]
dataDisks Obtém todos os discos de dados anexados à máquina virtual. ComputeDataDisk []
networkInterfaceId Obtém a ID da interface de rede da máquina virtual. corda
osDiskId Obtém o uri de blob de disco do sistema operacional para a máquina virtual. corda
osType Obtém o tipo de sistema operacional da máquina virtual. corda
Status Obtém os status da máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtém o tamanho da máquina virtual. corda

DayDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda

GalleryImageReference

Nome Descrição Valor
oferecer A oferta da imagem da galeria. corda
osType O tipo de sistema operacional da imagem da galeria. corda
editor O editor da imagem da galeria. corda
Sku A SKU da imagem da galeria. corda
Versão A versão da imagem da galeria. corda

HourDetails

Nome Descrição Valor
minuto Minutos da hora em que o agendamento será executado. int

InboundNatRule

Nome Descrição Valor
backendPort A porta para a qual o tráfego externo será redirecionado. int
frontendPort A porta do ponto de extremidade externo da conexão de entrada. Os valores possíveis variam entre 1 e 65535, inclusive. Se não for especificado, um valor será alocado automaticamente. int
transportProtocol O protocolo de transporte para o ponto de extremidade. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nome Descrição Valor
allowClaim Indica se outro usuário pode assumir a propriedade da máquina virtual Bool
applicableSchedule O agendamento aplicável para a máquina virtual. ApplicableSchedule
artifactDeploymentStatus O status de implantação do artefato para a máquina virtual. artifactDeploymentStatusProperties
Artefatos Os artefatos a serem instalados na máquina virtual. ArtifactInstallProperties[]
computeVm As propriedades da máquina virtual de computação. computeVmProperties
createdByUser O endereço de email do criador da máquina virtual. corda
createdByUserId O identificador de objeto do criador da máquina virtual. corda
createdDate A data de criação da máquina virtual. corda
customImageId O identificador de imagem personalizado da máquina virtual. corda
disallowPublicIpAddress Indica se a máquina virtual deve ser criada sem um endereço IP público. Bool
environmentId A ID do recurso do ambiente que contém essa máquina virtual, se houver. corda
expirationDate A data de validade da VM. corda
Fqdn O nome de domínio totalmente qualificado da máquina virtual. corda
galleryImageReference A referência de imagem do Microsoft Azure Marketplace da máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica se essa máquina virtual usa uma chave SSH para autenticação. Bool
labSubnetName O nome da sub-rede do laboratório da máquina virtual. corda
labVirtualNetworkId O identificador de rede virtual do laboratório da máquina virtual. corda
networkInterface As propriedades do adaptador de rede. NetworkInterfaceProperties
anotações As anotações da máquina virtual. corda
osType O tipo de sistema operacional da máquina virtual. corda
ownerObjectId O identificador de objeto do proprietário da máquina virtual. corda
ownerUserPrincipalName O nome principal do usuário do proprietário da máquina virtual. corda
senha A senha do administrador da máquina virtual. corda
provisioningState O status de provisionamento do recurso. corda
tamanho O tamanho da máquina virtual. corda
sshKey A chave SSH do administrador da máquina virtual. corda
storageType Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
userName O nome de usuário da máquina virtual. corda
virtualMachineCreationSource Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrição Valor
localização O local do recurso. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: laboratórios
Propriedades As propriedades do recurso. LabVirtualMachineProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Nome Descrição Valor
dnsName O nome DNS. corda
privateIpAddress O endereço IP privado. corda
publicIpAddress O endereço IP público. corda
publicIpAddressId A ID do recurso do endereço IP público. corda
rdpAuthority A propriedade RdpAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para RDP (Protocolo de Área de Trabalho Remota). corda
sharedPublicIpAddressConfiguration A configuração para compartilhar um endereço IP público em várias máquinas virtuais. SharedPublicIpAddressConfiguration
sshAuthority A propriedade SshAuthority é um nome de host DNS do servidor ou endereço IP seguido pelo número da porta de serviço para SSH. corda
subnetId A ID do recurso da sub-rede. corda
virtualNetworkId A ID do recurso da rede virtual. corda

NotificationSettings

Nome Descrição Valor
estado Se as notificações estiverem habilitadas para esse agendamento (ou seja, Habilitado, Desabilitado). 'Desabilitado'
'Habilitado'
timeInMinutes Tempo em minutos antes do evento em que a notificação será enviada. int
webhookUrl A URL do webhook para a qual a notificação será enviada. corda

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

ResourceTags

Nome Descrição Valor

Horário

Nome Descrição Valor
localização O local do recurso. corda
Propriedades As propriedades do recurso. ScheduleProperties (obrigatório)
Tags As marcas do recurso. ResourceTags

ScheduleProperties

Nome Descrição Valor
dailyRecurrence Se o agendamento ocorrer uma vez a cada dia da semana, especifique a recorrência diária. DayDetails
hourlyRecurrence Se o agendamento ocorrer várias vezes por dia, especifique a recorrência por hora. HourDetails
notificationSettings Configurações de notificação. notificationSettings
provisioningState O status de provisionamento do recurso. corda
estado O status do agendamento (ou seja, Habilitado, Desabilitado) 'Desabilitado'
'Habilitado'
targetResourceId A ID do recurso à qual o agendamento pertence corda
taskType O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). corda
timeZoneId A ID do fuso horário (por exemplo, hora padrão do Pacífico). corda
uniqueIdentifier O identificador imutável exclusivo de um recurso (Guid). corda
weeklyRecurrence Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrição Valor
inboundNatRules As regras NAT de entrada InboundNatRule []

WeekDetails

Nome Descrição Valor
Hora A hora do dia em que a agenda ocorrerá. corda
Semana Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda, terça,etc.). string[]