Microsoft.DevTestLab labs/virtualmachines 2016-05-15
Definição de recurso do Bicep
O tipo de recurso labs/virtualmachines pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.DevTestLab/labs/virtualmachines, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
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: {}
}
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: {}
}
}
tags: {}
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: {}
}
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: {}
}
}
tags: {}
}
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
labs/virtualmachines
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 (Windows) 1–64 (Linux) Caracteres válidos: Caracteres alfanuméricos e hifens. Comece e termine com caractere alfanumérico. Não pode ser apenas números. |
| local | A localização do recurso. | string |
| marcas | As marcas do recurso. | Dicionário de nomes e valores de marcas. Consulte Marcas em modelos |
| 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 o recurso do tipo: laboratórios |
| properties | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
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 | A implantação do artefato status 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. | string |
| createdByUserId | O identificador de objeto do criador da máquina virtual. | string |
| createdDate | A data de criação da máquina virtual. | string |
| customImageId | O identificador de imagem personalizado da máquina virtual. | string |
| 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. | string |
| expirationDate | A data de validade da VM. | string |
| fqdn | O nome de domínio totalmente qualificado da máquina virtual. | string |
| 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. | string |
| labVirtualNetworkId | O identificador de rede virtual do laboratório da máquina virtual. | string |
| networkInterface | As propriedades do adaptador de rede. | NetworkInterfaceProperties |
| HDInsight | As anotações da máquina virtual. | string |
| osType | O tipo de sistema operacional da máquina virtual. | string |
| ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
| ownerUserPrincipalName | O nome principal do usuário do proprietário da máquina virtual. | string |
| password | A senha do administrador da máquina virtual. | string |
| provisioningState | O status de provisionamento do recurso. | string |
| tamanho | O tamanho da máquina virtual. | string |
| sshKey | A chave SSH do administrador da máquina virtual. | string |
| storageType | Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| userName | O nome de usuário da máquina virtual. | string |
| virtualMachineCreationSource | Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. | 'FromCustomImage' 'FromGalleryImage' |
ApplicableSchedule
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
ApplicableScheduleProperties
| Nome | Descrição | Valor |
|---|---|---|
| labVmsShutdown | O agendamento de desligamento automático, se um tiver sido definido no nível do laboratório ou do recurso de laboratório. | Agenda |
| labVmsStartup | O agendamento de inicialização automática, se um tiver sido definido no nível do laboratório ou do recurso de laboratório. | Agenda |
Agenda
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
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. | string |
| status | O status do agendamento (ou seja, Habilitado, Desabilitado) | 'Desabilitado' 'Enabled' |
| targetResourceId | A ID do recurso à qual o agendamento pertence | string |
| taskType | O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
| timeZoneId | A ID do fuso horário (por exemplo, hora padrão do Pacífico). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| Weeklyrecurrence | Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. | WeekDetails |
DayDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que o agendamento ocorrerá. | string |
HourDetails
| Nome | Descrição | Valor |
|---|---|---|
| minute | Minutos da hora em que o agendamento será executado. | INT |
NotificationSettings
| Nome | Descrição | Valor |
|---|---|---|
| status | Se as notificações estiverem habilitadas para esse agendamento (ou seja, Habilitado, Desabilitado). | 'Desabilitado' 'Enabled' |
| timeInMinutes | Tempo em minutos antes do evento no qual a notificação será enviada. | INT |
| webhookUrl | A URL do webhook para a qual a notificação será enviada. | string |
WeekDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que o agendamento ocorrerá. | string |
| Semana | Os dias da semana para os quais o agendamento está definido (por exemplo, domingo, segunda-feira, terça-feira etc.). | string[] |
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. | string |
| totalArtifacts | A contagem total dos artefatos que foram aplicados provisoriamente. | INT |
ArtifactInstallProperties
| Nome | Descrição | Valor |
|---|---|---|
| artifactId | O identificador do artefato. | string |
| deploymentStatusMessage | A mensagem status da implantação. | string |
| installTime | A hora em que o artefato começa a ser instalado na máquina virtual. | string |
| parâmetros | Os parâmetros do artefato. | ArtifactParameterProperties[] |
| status | O status do artefato. | string |
| vmExtensionStatusMessage | A mensagem status da extensão da máquina virtual. | string |
ArtifactParameterProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro de artefato. | string |
| value | O valor do parâmetro de artefato. | string |
ComputeVmProperties
| Nome | Descrição | Valor |
|---|---|---|
| dataDiskIds | Obtém o URI do 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 do adaptador de rede da máquina virtual. | string |
| osDiskId | Obtém o URI do blob de disco do sistema operacional para a máquina virtual. | string |
| osType | Obtém o tipo de sistema operacional da máquina virtual. | string |
| status | Obtém os status da máquina virtual. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtém o tamanho da máquina virtual. | string |
ComputeDataDisk
| Nome | Descrição | Valor |
|---|---|---|
| diskSizeGiB | Obtém o tamanho do disco de dados em GiB. | INT |
| diskUri | Quando apoiado por um blob, o URI do blob subjacente. | string |
| managedDiskId | Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. | string |
| name | Obtém o nome do disco de dados. | string |
ComputeVmInstanceViewStatus
| Nome | Descrição | Valor |
|---|---|---|
| code | Obtém o código status. | string |
| displayStatus | Obtém o rótulo localizável curto para o status. | string |
| message | Obtém a mensagem associada ao status. | string |
GalleryImageReference
| Nome | Descrição | Valor |
|---|---|---|
| oferta | A oferta da imagem da galeria. | string |
| osType | O tipo de sistema operacional da imagem da galeria. | string |
| publicador | O editor da imagem da galeria. | string |
| sku | O SKU da imagem da galeria. | string |
| version | A versão da imagem da galeria. | string |
NetworkInterfaceProperties
| Nome | Descrição | Valor |
|---|---|---|
| Dnsname | O nome DNS. | string |
| privateIpAddress | O endereço IP privado. | string |
| publicIpAddress | O endereço IP público. | string |
| publicIpAddressId | A ID do recurso do endereço IP público. | string |
| 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). | string |
| 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. | string |
| subnetId | A ID do recurso da sub-rede. | string |
| virtualNetworkId | A ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| inboundNatRules | As regras NAT de entrada | InboundNatRule[] |
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' |
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 em Azure DevTest Labs com uma VM do Windows Server |
Este 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 Resource Manager do Azure para Azure DevTest Labs disponíveis emhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
| Cria um laboratório em Azure DevTest Labs com uma VM reivindicada |
Este 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 Resource Manager do Azure para Azure DevTest Labs disponíveis emhttps://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:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte 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",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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": {}
},
"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": {}
}
},
"tags": {},
"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": {}
},
"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": {}
}
},
"tags": {}
},
"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
labs/virtualmachines
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.DevTestLab/labs/virtualmachines' |
| apiVersion | A versão da API de recursos | '2016-05-15' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 (Windows) 1–64 (Linux) Caracteres válidos: Caracteres alfanuméricos e hifens. Comece e termine com caractere alfanumérico. Não pode ser apenas números. |
| local | A localização do recurso. | string |
| marcas | As marcas do recurso. | Dicionário de nomes e valores de marcas. Consulte Marcas em modelos |
| properties | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
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 | A implantação do artefato status 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. | string |
| createdByUserId | O identificador de objeto do criador da máquina virtual. | string |
| createdDate | A data de criação da máquina virtual. | string |
| customImageId | O identificador de imagem personalizado da máquina virtual. | string |
| 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. | string |
| expirationDate | A data de validade da VM. | string |
| fqdn | O nome de domínio totalmente qualificado da máquina virtual. | string |
| 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. | string |
| labVirtualNetworkId | O identificador de rede virtual do laboratório da máquina virtual. | string |
| networkInterface | As propriedades do adaptador de rede. | NetworkInterfaceProperties |
| HDInsight | As anotações da máquina virtual. | string |
| osType | O tipo de sistema operacional da máquina virtual. | string |
| ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
| ownerUserPrincipalName | O nome principal do usuário do proprietário da máquina virtual. | string |
| password | A senha do administrador da máquina virtual. | string |
| provisioningState | O status de provisionamento do recurso. | string |
| tamanho | O tamanho da máquina virtual. | string |
| sshKey | A chave SSH do administrador da máquina virtual. | string |
| storageType | Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| userName | O nome de usuário da máquina virtual. | string |
| virtualMachineCreationSource | Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. | 'FromCustomImage' 'FromGalleryImage' |
ApplicableSchedule
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
ApplicableScheduleProperties
| Nome | Descrição | Valor |
|---|---|---|
| labVmsShutdown | O agendamento de desligamento automático, se um tiver sido definido no nível do recurso de laboratório ou laboratório. | Agenda |
| labVmsStartup | O agendamento de inicialização automática, se um tiver sido definido no nível de recurso de laboratório ou laboratório. | Agenda |
Agenda
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
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. | string |
| status | O status do agendamento (ou seja, Habilitado, Desabilitado) | 'Desabilitado' 'Enabled' |
| targetResourceId | A ID do recurso à qual o agendamento pertence | string |
| taskType | O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
| timeZoneId | A ID do fuso horário (por exemplo, hora padrão do Pacífico). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| Weeklyrecurrence | Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. | WeekDetails |
DayDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que a agenda ocorrerá. | string |
HourDetails
| Nome | Descrição | Valor |
|---|---|---|
| minute | Minutos da hora em que o agendamento será executado. | INT |
NotificationSettings
| Nome | Descrição | Valor |
|---|---|---|
| status | Se as notificações estiverem habilitadas para esse agendamento (ou seja, Habilitado, Desabilitado). | 'Desabilitado' 'Enabled' |
| 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. | string |
WeekDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que o agendamento ocorrerá. | string |
| Semana | Os dias da semana para os quais a agenda é definida (por exemplo, domingo, segunda- feira, terça-feira, etc.). | string[] |
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. | string |
| totalArtifacts | A contagem total dos artefatos que foram aplicados provisoriamente. | INT |
ArtifactInstallProperties
| Nome | Descrição | Valor |
|---|---|---|
| artifactId | O identificador do artefato. | string |
| deploymentStatusMessage | A mensagem status da implantação. | string |
| installTime | A hora em que o artefato começa a ser instalado na máquina virtual. | string |
| parâmetros | Os parâmetros do artefato. | ArtifactParameterProperties[] |
| status | O status do artefato. | string |
| vmExtensionStatusMessage | A mensagem status da extensão da máquina virtual. | string |
ArtifactParameterProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro de artefato. | string |
| value | O valor do parâmetro de artefato. | string |
ComputeVmProperties
| Nome | Descrição | Valor |
|---|---|---|
| dataDiskIds | Obtém o URI do 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 do adaptador de rede da máquina virtual. | string |
| osDiskId | Obtém o URI do blob de disco do sistema operacional para a máquina virtual. | string |
| osType | Obtém o tipo de sistema operacional da máquina virtual. | string |
| status | Obtém os status da máquina virtual. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtém o tamanho da máquina virtual. | string |
ComputeDataDisk
| Nome | Descrição | Valor |
|---|---|---|
| diskSizeGiB | Obtém o tamanho do disco de dados em GiB. | INT |
| diskUri | Quando apoiado por um blob, o URI do blob subjacente. | string |
| managedDiskId | Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. | string |
| name | Obtém o nome do disco de dados. | string |
ComputeVmInstanceViewStatus
| Nome | Descrição | Valor |
|---|---|---|
| code | Obtém o código status. | string |
| displayStatus | Obtém o rótulo localizável curto para o status. | string |
| message | Obtém a mensagem associada ao status. | string |
GalleryImageReference
| Nome | Descrição | Valor |
|---|---|---|
| oferta | A oferta da imagem da galeria. | string |
| osType | O tipo de sistema operacional da imagem da galeria. | string |
| publicador | O editor da imagem da galeria. | string |
| sku | O SKU da imagem da galeria. | string |
| version | A versão da imagem da galeria. | string |
NetworkInterfaceProperties
| Nome | Descrição | Valor |
|---|---|---|
| Dnsname | O nome DNS. | string |
| privateIpAddress | O endereço IP privado. | string |
| publicIpAddress | O endereço IP público. | string |
| publicIpAddressId | A ID do recurso do endereço IP público. | string |
| 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). | string |
| 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. | string |
| subnetId | A ID do recurso da sub-rede. | string |
| virtualNetworkId | A ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| inboundNatRules | As regras NAT de entrada | InboundNatRule[] |
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' |
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 em Azure DevTest Labs com uma VM do Windows Server |
Este 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 Azure DevTest Labs disponíveis emhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
| Cria um laboratório em Azure DevTest Labs com uma VM reivindicada |
Este modelo cria uma nova instância do DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019 reivindicada nela. Mais modelos de início rápido do Azure Resource Manager para Azure DevTest Labs disponíveis emhttps://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 das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.DevTestLab/labs/virtualmachines, adicione o Terraform a seguir ao modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
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 = {}
}
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 = {}
}
}
tags = {}
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 = {}
}
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 = {}
}
}
tags = {}
}
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
labs/virtualmachines
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15" |
| name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 (Windows) 1–64 (Linux) Caracteres válidos: Caracteres alfanuméricos e hifens. Comece e termine com caractere alfanumérico. Não pode ser apenas números. |
| local | A localização do recurso. | string |
| parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: laboratórios |
| marcas | As marcas do recurso. | Dicionário de nomes e valores de marcas. |
| properties | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
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 | A implantação do artefato status 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. | string |
| createdByUserId | O identificador de objeto do criador da máquina virtual. | string |
| createdDate | A data de criação da máquina virtual. | string |
| customImageId | O identificador de imagem personalizado da máquina virtual. | string |
| 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. | string |
| expirationDate | A data de validade da VM. | string |
| fqdn | O nome de domínio totalmente qualificado da máquina virtual. | string |
| 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. | string |
| labVirtualNetworkId | O identificador de rede virtual do laboratório da máquina virtual. | string |
| networkInterface | As propriedades do adaptador de rede. | NetworkInterfaceProperties |
| HDInsight | As anotações da máquina virtual. | string |
| osType | O tipo de sistema operacional da máquina virtual. | string |
| ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
| ownerUserPrincipalName | O nome principal do usuário do proprietário da máquina virtual. | string |
| password | A senha do administrador da máquina virtual. | string |
| provisioningState | O status de provisionamento do recurso. | string |
| tamanho | O tamanho da máquina virtual. | string |
| sshKey | A chave SSH do administrador da máquina virtual. | string |
| storageType | Tipo de armazenamento a ser usado para máquina virtual (ou seja, Standard, Premium). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| userName | O nome de usuário da máquina virtual. | string |
| virtualMachineCreationSource | Informa a origem da criação da máquina virtual de laboratório. Somente propriedade de saída. | "FromCustomImage" "FromGalleryImage" |
ApplicableSchedule
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ApplicableScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
ApplicableScheduleProperties
| Nome | Descrição | Valor |
|---|---|---|
| labVmsShutdown | O agendamento de desligamento automático, se um tiver sido definido no nível do laboratório ou do recurso de laboratório. | Agenda |
| labVmsStartup | O agendamento de inicialização automática, se um tiver sido definido no nível do laboratório ou do recurso de laboratório. | Agenda |
Agenda
| Nome | Descrição | Valor |
|---|---|---|
| local | A localização do recurso. | string |
| properties | As propriedades do recurso. | ScheduleProperties (obrigatório) |
| marcas | As marcas do recurso. | objeto |
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. | string |
| status | O status do agendamento (ou seja, Habilitado, Desabilitado) | "Desabilitado" "Habilitado" |
| targetResourceId | A ID do recurso à qual o agendamento pertence | string |
| taskType | O tipo de tarefa do agendamento (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
| timeZoneId | A ID do fuso horário (por exemplo, hora padrão do Pacífico). | string |
| Uniqueidentifier | O identificador imutável exclusivo de um recurso (Guid). | string |
| Weeklyrecurrence | Se o agendamento ocorrer apenas alguns dias da semana, especifique a recorrência semanal. | WeekDetails |
DayDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que o agendamento ocorrerá. | string |
HourDetails
| Nome | Descrição | Valor |
|---|---|---|
| minute | Minutos da hora em que o agendamento será executado. | INT |
NotificationSettings
| Nome | Descrição | Valor |
|---|---|---|
| status | 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. | string |
WeekDetails
| Nome | Descrição | Valor |
|---|---|---|
| time | A hora do dia em que o agendamento ocorrerá. | string |
| Semana | Os dias da semana para os quais a agenda é definida (por exemplo, domingo, segunda- feira, terça-feira, etc.). | string[] |
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. | string |
| totalArtifacts | A contagem total dos artefatos que foram aplicados provisoriamente. | INT |
ArtifactInstallProperties
| Nome | Descrição | Valor |
|---|---|---|
| artifactId | O identificador do artefato. | string |
| deploymentStatusMessage | A mensagem status da implantação. | string |
| installTime | A hora em que o artefato começa a ser instalado na máquina virtual. | string |
| parâmetros | Os parâmetros do artefato. | ArtifactParameterProperties[] |
| status | O status do artefato. | string |
| vmExtensionStatusMessage | A mensagem status da extensão da máquina virtual. | string |
ArtifactParameterProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro de artefato. | string |
| value | O valor do parâmetro artifact. | string |
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 do adaptador de rede da máquina virtual. | string |
| osDiskId | Obtém o uri do blob de disco do sistema operacional para a máquina virtual. | string |
| osType | Obtém o tipo de sistema operacional da máquina virtual. | string |
| status | Obtém os status da máquina virtual. | ComputeVmInstanceViewStatus[] |
| vmSize | Obtém o tamanho da máquina virtual. | string |
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. | string |
| managedDiskId | Quando apoiado pelo disco gerenciado, essa é a ID do recurso de disco de computação. | string |
| name | Obtém o nome do disco de dados. | string |
ComputeVmInstanceViewStatus
| Nome | Descrição | Valor |
|---|---|---|
| code | Obtém o código status. | string |
| displayStatus | Obtém o rótulo localizável curto para o status. | string |
| message | Obtém a mensagem associada ao status. | string |
GalleryImageReference
| Nome | Descrição | Valor |
|---|---|---|
| oferta | A oferta da imagem da galeria. | string |
| osType | O tipo de sistema operacional da imagem da galeria. | string |
| publicador | O editor da imagem da galeria. | string |
| sku | O SKU da imagem da galeria. | string |
| version | A versão da imagem da galeria. | string |
NetworkInterfaceProperties
| Nome | Descrição | Valor |
|---|---|---|
| Dnsname | O nome DNS. | string |
| privateIpAddress | O endereço IP privado. | string |
| publicIpAddress | O endereço IP público. | string |
| publicIpAddressId | A ID do recurso do endereço IP público. | string |
| 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). | string |
| 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. | string |
| subnetId | A ID do recurso da sub-rede. | string |
| virtualNetworkId | A ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| inboundNatRules | As regras NAT de entrada | InboundNatRule[] |
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" |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de