Laboratórios Microsoft.DevTestLab/virtualmachines
Definição de recurso do Bicep
O tipo de recurso labs/virtualmachines pode ser implementado com operações que visam:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DevTestLab/labs/virtualmachines, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
allowClaim: bool
artifacts: [
{
artifactId: 'string'
artifactTitle: 'string'
deploymentStatusMessage: 'string'
installTime: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
status: 'string'
vmExtensionStatusMessage: 'string'
}
]
createdDate: 'string'
customImageId: 'string'
dataDiskParameters: [
{
attachNewDataDiskOptions: {
diskName: 'string'
diskSizeGiB: int
diskType: 'string'
}
existingLabDiskId: 'string'
hostCaching: 'string'
}
]
disallowPublicIpAddress: bool
environmentId: 'string'
expirationDate: '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'
ownerObjectId: 'string'
ownerUserPrincipalName: 'string'
password: 'string'
planId: 'string'
scheduleParameters: [
{
name: 'string'
properties: {
dailyRecurrence: {
time: 'string'
}
hourlyRecurrence: {
minute: int
}
notificationSettings: {
emailRecipient: 'string'
notificationLocale: 'string'
status: 'string'
timeInMinutes: int
webhookUrl: 'string'
}
status: 'string'
targetResourceId: 'string'
taskType: 'string'
weeklyRecurrence: {
time: 'string'
weekdays: [
'string'
]
}
}
tags: {}
}
]
size: 'string'
sshKey: 'string'
storageType: 'string'
userName: 'string'
}
}
Valores de propriedade
laboratórios/virtualmachines
Nome | Descrição | Valor |
---|---|---|
name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) Limite de carateres: 1-15 (Windows) 1-64 (Linux) Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. Não podem ser todos números. |
localização | A localização do recurso. | string |
etiquetas | As etiquetas do recurso. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só tem de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: laboratórios |
propriedades | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
LabVirtualMachineProperties
Nome | Descrição | Valor |
---|---|---|
allowClaim | Indica se outro utilizador pode assumir a propriedade da máquina virtual | bool |
artefactos | Os artefactos a instalar na máquina virtual. | ArtifactInstallProperties[] |
createdDate | A data de criação da máquina virtual. | string |
customImageId | O identificador de imagem personalizado da máquina virtual. | string |
dataDiskParameters | Discos de dados novos ou existentes para anexar à máquina virtual após a criação | DataDiskProperties[] |
disallowPublicIpAddress | Indica se a máquina virtual deve ser criada sem um endereço IP público. | bool |
environmentId | O ID de recurso do ambiente que contém esta máquina virtual, se existir. | string |
expirationDate | A data de expiração da VM. | string |
galleryImageReference | O Microsoft Azure Marketplace referência de imagem da máquina virtual. | GalleryImageReference |
isAuthenticationWithSshKey | Indica se esta máquina virtual utiliza 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 de laboratório da máquina virtual. | string |
networkInterface | As propriedades da interface de rede. | NetworkInterfaceProperties |
notas | As notas da máquina virtual. | string |
ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
ownerUserPrincipalName | O nome principal de utilizador do proprietário da máquina virtual. | string |
palavra-passe | A palavra-passe do administrador da máquina virtual. | string |
planId | O ID do plano associado à imagem da máquina virtual | string |
scheduleParameters | Agendas de Máquinas Virtuais a criar | ScheduleCreationParameter[] |
size | O tamanho da máquina virtual. | string |
sshKey | A chave SSH do administrador da máquina virtual. | string |
storageType | Tipo de armazenamento a utilizar para máquina virtual (ou seja, Standard, Premium). | string |
userName | O nome de utilizador da máquina virtual. | string |
ArtifactInstallProperties
Nome | Descrição | Valor |
---|---|---|
artifactId | O identificador do artefacto. | string |
artifactTitle | O título do artefacto. | string |
deploymentStatusMessage | A mensagem de estado da implementação. | string |
installTime | A hora em que o artefacto começa a ser instalado na máquina virtual. | string |
parâmetros | Os parâmetros do artefacto. | ArtifactParameterProperties[] |
status | O estado do artefacto. | string |
vmExtensionStatusMessage | A mensagem de estado da extensão da máquina virtual. | string |
ArtifactParameterProperties
Nome | Descrição | Valor |
---|---|---|
name | O nome do parâmetro do artefacto. | string |
valor | O valor do parâmetro do artefacto. | string |
DataDiskProperties
Nome | Descrição | Valor |
---|---|---|
attachNewDataDiskOptions | Especifica opções para anexar um novo disco à máquina virtual. | AttachNewDataDiskOptions |
existingLabDiskId | Especifica o ID de disco de laboratório existente para anexar à máquina virtual. | string |
hostCaching | Opção de colocação em cache para um disco de dados (ou seja, Nenhum, ReadOnly, ReadWrite). | "Nenhum" 'ReadOnly' "ReadWrite" |
AttachNewDataDiskOptions
Nome | Descrição | Valor |
---|---|---|
diskName | O nome do disco a anexar. | string |
diskSizeGiB | Tamanho do disco a anexar em Gibibytes. | int |
diskType | O tipo de armazenamento do disco (ou seja, Standard, Premium). | "Premium" 'Standard' "StandardSSD" |
GalleryImageReference
Nome | Descrição | Valor |
---|---|---|
oferta | A oferta da imagem da galeria. | string |
osType | O tipo de SO da imagem da galeria. | string |
publicador | O editor da imagem da galeria. | string |
sku | O SKU da imagem da galeria. | string |
versão | 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 | O ID do recurso do endereço IP público. | string |
rdpAuthority | A propriedade RdpAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para RDP (Remote Desktop Protocol). | string |
sharedPublicIpAddressConfiguration | A configuração para partilhar um endereço IP público em várias máquinas virtuais. | SharedPublicIpAddressConfiguration |
sshAuthority | A propriedade SshAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para SSH. | string |
subnetId | O ID do recurso da sub-rede. | string |
virtualNetworkId | O ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
Nome | Descrição | Valor |
---|---|---|
inboundNatRules | As regras NAT recebidas | InboundNatRule[] |
InboundNatRule
Nome | Descrição | Valor |
---|---|---|
backendPort | A porta para a qual o tráfego externo será redirecionado. | int |
frontendPort | A porta de ponto final externo da ligaçã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 final. | 'Tcp' 'Udp' |
ScheduleCreationParameter
Nome | Descrição | Valor |
---|---|---|
name | O nome da máquina virtual ou do ambiente | string |
propriedades | As propriedades da agenda. | ScheduleCreationParameterProperties |
etiquetas | As etiquetas do recurso. | objeto |
ScheduleCreationParameterProperties
Nome | Descrição | Valor |
---|---|---|
diariamenteRecurrence | Se a agenda ocorrer uma vez por dia da semana, especifique a periodicidade diária. | DayDetails |
hourlyRecurrence | Se a agenda ocorrer várias vezes por dia, especifique a periodicidade por hora. | HourDetails |
notificationSettings | Definições de notificação. | NotificationSettings |
status | O estado da agenda (ou seja, Ativado, Desativado) | "Desativado" "Ativado" |
targetResourceId | O ID do recurso ao qual a agenda pertence | string |
taskType | O tipo de tarefa da agenda (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
weeklyRecurrence | Se a agenda ocorrer apenas alguns dias da semana, especifique a periodicidade semanal. | WeekDetails |
DayDetails
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda ocorrerá. | string |
HourDetails
Nome | Descrição | Valor |
---|---|---|
minute | Minutos da hora em que a agenda será executada. | int |
NotificationSettings
Nome | Descrição | Valor |
---|---|---|
emailRecipient | O destinatário do e-mail para o qual enviar notificações (pode ser uma lista de endereços de e-mail separados por pontos e vírgulas). | string |
notificationLocale | A região a utilizar ao enviar uma notificação (contingência para idiomas não suportados é EN). | string |
status | Se as notificações estiverem ativadas para esta agenda (ou seja, Ativada, Desativada). | "Desativado" "Ativado" |
timeInMinutes | Tempo em minutos antes do evento em que a notificação será enviada. | int |
webhookUrl | O URL do webhook para o qual a notificação será enviada. | string |
WeekDetails
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda ocorrerá. | string |
dias úteis | Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda-feira, terça-feira, etc.). | cadeia[] |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
Modelo | Description |
---|---|
Cria um laboratório no Azure DevTest Labs com uma VM do Windows Server |
Este modelo cria uma nova instância de DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019. 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 no Azure DevTest Labs com uma VM reclamada |
Este modelo cria uma nova instância de DevTest Lab/DTL com uma VM do Datacenter do Windows Server 2019 reclamada. 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 de modelo do ARM
O tipo de recurso labs/virtualmachines pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DevTestLab/labs/virtualmachines, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.DevTestLab/labs/virtualmachines",
"apiVersion": "2018-09-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"allowClaim": "bool",
"artifacts": [
{
"artifactId": "string",
"artifactTitle": "string",
"deploymentStatusMessage": "string",
"installTime": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
],
"status": "string",
"vmExtensionStatusMessage": "string"
}
],
"createdDate": "string",
"customImageId": "string",
"dataDiskParameters": [
{
"attachNewDataDiskOptions": {
"diskName": "string",
"diskSizeGiB": "int",
"diskType": "string"
},
"existingLabDiskId": "string",
"hostCaching": "string"
}
],
"disallowPublicIpAddress": "bool",
"environmentId": "string",
"expirationDate": "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",
"ownerObjectId": "string",
"ownerUserPrincipalName": "string",
"password": "string",
"planId": "string",
"scheduleParameters": [
{
"name": "string",
"properties": {
"dailyRecurrence": {
"time": "string"
},
"hourlyRecurrence": {
"minute": "int"
},
"notificationSettings": {
"emailRecipient": "string",
"notificationLocale": "string",
"status": "string",
"timeInMinutes": "int",
"webhookUrl": "string"
},
"status": "string",
"targetResourceId": "string",
"taskType": "string",
"weeklyRecurrence": {
"time": "string",
"weekdays": [ "string" ]
}
},
"tags": {}
}
],
"size": "string",
"sshKey": "string",
"storageType": "string",
"userName": "string"
}
}
Valores de propriedade
laboratórios/virtualmachines
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | "Microsoft.DevTestLab/labs/virtualmachines" |
apiVersion | A versão da API de recursos | '2018-09-15' |
name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON. |
cadeia (obrigatório) Limite de carateres: 1-15 (Windows) 1-64 (Linux) Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. Não pode ser todos os números. |
localização | A localização do recurso. | string |
etiquetas | As etiquetas do recurso. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
propriedades | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
LabVirtualMachineProperties
Nome | Descrição | Valor |
---|---|---|
allowClaim | Indica se outro utilizador pode assumir a propriedade da máquina virtual | bool |
artefactos | Os artefactos a instalar na máquina virtual. | ArtifactInstallProperties[] |
createdDate | A data de criação da máquina virtual. | string |
customImageId | O identificador de imagem personalizado da máquina virtual. | string |
dataDiskParameters | Discos de dados novos ou existentes para anexar à máquina virtual após a criação | DataDiskProperties[] |
disallowPublicIpAddress | Indica se a máquina virtual deve ser criada sem um endereço IP público. | bool |
environmentId | O ID de recurso do ambiente que contém esta máquina virtual, se existir. | string |
expirationDate | A data de expiração da VM. | string |
galleryImageReference | O Microsoft Azure Marketplace referência de imagem da máquina virtual. | GalleryImageReference |
isAuthenticationWithSshKey | Indica se esta máquina virtual utiliza 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 de laboratório da máquina virtual. | string |
networkInterface | As propriedades da interface de rede. | NetworkInterfaceProperties |
notas | As notas da máquina virtual. | string |
ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
ownerUserPrincipalName | O nome principal de utilizador do proprietário da máquina virtual. | string |
palavra-passe | A palavra-passe do administrador da máquina virtual. | string |
planId | O ID do plano associado à imagem da máquina virtual | string |
scheduleParameters | Agendamentos de Máquinas Virtuais a criar | ScheduleCreationParameter[] |
size | O tamanho da máquina virtual. | string |
sshKey | A chave SSH do administrador da máquina virtual. | string |
storageType | Tipo de armazenamento a utilizar na máquina virtual (ou seja, Standard, Premium). | string |
userName | O nome de utilizador da máquina virtual. | string |
ArtifactInstallProperties
Nome | Descrição | Valor |
---|---|---|
artifactId | O identificador do artefacto. | string |
artifactTitle | O título do artefacto. | string |
deploymentStatusMessage | A mensagem de estado da implementação. | string |
installTime | A hora em que o artefacto começa a ser instalado na máquina virtual. | string |
parâmetros | Os parâmetros do artefacto. | ArtifactParameterProperties[] |
status | O estado do artefacto. | string |
vmExtensionStatusMessage | A mensagem de estado da extensão da máquina virtual. | string |
ArtifactParameterProperties
Nome | Descrição | Valor |
---|---|---|
name | O nome do parâmetro do artefacto. | string |
valor | O valor do parâmetro do artefacto. | string |
DataDiskProperties
Nome | Descrição | Valor |
---|---|---|
attachNewDataDiskOptions | Especifica opções para anexar um novo disco à máquina virtual. | AttachNewDataDiskOptions |
existingLabDiskId | Especifica o ID de disco de laboratório existente para anexar à máquina virtual. | string |
hostCaching | Opção de colocação em cache para um disco de dados (ou seja, Nenhum, ReadOnly, ReadWrite). | "Nenhum" 'ReadOnly' "ReadWrite" |
AttachNewDataDiskOptions
Nome | Descrição | Valor |
---|---|---|
diskName | O nome do disco a anexar. | string |
diskSizeGiB | Tamanho do disco a anexar em Gibibytes. | int |
diskType | O tipo de armazenamento do disco (ou seja, Standard, Premium). | "Premium" 'Standard' "StandardSSD" |
GalleryImageReference
Nome | Descrição | Valor |
---|---|---|
oferta | A oferta da imagem da galeria. | string |
osType | O tipo de SO da imagem da galeria. | string |
publicador | O editor da imagem da galeria. | string |
sku | O SKU da imagem da galeria. | string |
versão | 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 | O ID do recurso do endereço IP público. | string |
rdpAuthority | A propriedade RdpAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para RDP (Remote Desktop Protocol). | string |
sharedPublicIpAddressConfiguration | A configuração para partilhar um endereço IP público em várias máquinas virtuais. | SharedPublicIpAddressConfiguration |
sshAuthority | A propriedade SshAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para SSH. | string |
subnetId | O ID do recurso da sub-rede. | string |
virtualNetworkId | O ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
Nome | Descrição | Valor |
---|---|---|
inboundNatRules | As regras NAT recebidas | InboundNatRule[] |
InboundNatRule
Nome | Descrição | Valor |
---|---|---|
backendPort | A porta para a qual o tráfego externo será redirecionado. | int |
frontendPort | A porta de ponto final externo da ligaçã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 final. | 'Tcp' 'Udp' |
ScheduleCreationParameter
Nome | Descrição | Valor |
---|---|---|
name | O nome da máquina virtual ou do ambiente | string |
propriedades | As propriedades da agenda. | ScheduleCreationParameterProperties |
etiquetas | As etiquetas do recurso. | objeto |
ScheduleCreationParameterProperties
Nome | Descrição | Valor |
---|---|---|
diariamenteRecurrence | Se a agenda ocorrer uma vez por dia da semana, especifique a periodicidade diária. | Diadetalhes |
hourlyRecurrence | Se a agenda ocorrer várias vezes por dia, especifique a periodicidade por hora. | HourDetails |
notificationSettings | Definições de notificação. | NotificationSettings |
status | O estado da agenda (ou seja, Ativado, Desativado) | "Desativado" "Ativado" |
targetResourceId | O ID do recurso ao qual a agenda pertence | string |
taskType | O tipo de tarefa da agenda (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
periodicidade semanal | Se a agenda ocorrer apenas alguns dias da semana, especifique a periodicidade semanal. | WeekDetails |
Diadetalhes
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda irá ocorrer. | string |
HourDetails
Nome | Descrição | Valor |
---|---|---|
minute | Minutos da hora em que o agendamento será executado. | int |
NotificationSettings
Nome | Descrição | Valor |
---|---|---|
emailRecipient | O destinatário do e-mail para o qual enviar notificações (pode ser uma lista de endereços de e-mail separados por ponto e vírgula). | string |
notificationLocale | A região a utilizar ao enviar uma notificação (contingência para idiomas não suportados é EN). | string |
status | Se as notificações estiverem ativadas para esta agenda (ou seja, Ativada, Desativada). | "Desativado" "Ativado" |
timeInMinutes | Tempo em minutos antes do evento em que a notificação será enviada. | int |
webhookUrl | O URL do webhook para o qual a notificação será enviada. | string |
WeekDetails
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda irá ocorrer. | string |
dias úteis | Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda-feira, terça-feira, etc.). | string[] |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
Modelo | Description |
---|---|
Cria um laboratório no Azure DevTest Labs com uma VM do Windows Server |
Este modelo cria uma nova instância de DevTest Lab/DTL com uma VM do Windows Server 2019 Datacenter. 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 no Azure DevTest Labs com uma VM reclamada |
Este modelo cria uma nova instância de DevTest Lab/DTL com uma VM do Windows Server 2019 Datacenter reclamada. 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 terraform (fornecedor AzAPI)
O tipo de recurso labs/virtualmachines pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DevTestLab/labs/virtualmachines, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
allowClaim = bool
artifacts = [
{
artifactId = "string"
artifactTitle = "string"
deploymentStatusMessage = "string"
installTime = "string"
parameters = [
{
name = "string"
value = "string"
}
]
status = "string"
vmExtensionStatusMessage = "string"
}
]
createdDate = "string"
customImageId = "string"
dataDiskParameters = [
{
attachNewDataDiskOptions = {
diskName = "string"
diskSizeGiB = int
diskType = "string"
}
existingLabDiskId = "string"
hostCaching = "string"
}
]
disallowPublicIpAddress = bool
environmentId = "string"
expirationDate = "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"
ownerObjectId = "string"
ownerUserPrincipalName = "string"
password = "string"
planId = "string"
scheduleParameters = [
{
name = "string"
properties = {
dailyRecurrence = {
time = "string"
}
hourlyRecurrence = {
minute = int
}
notificationSettings = {
emailRecipient = "string"
notificationLocale = "string"
status = "string"
timeInMinutes = int
webhookUrl = "string"
}
status = "string"
targetResourceId = "string"
taskType = "string"
weeklyRecurrence = {
time = "string"
weekdays = [
"string"
]
}
}
tags = {}
}
]
size = "string"
sshKey = "string"
storageType = "string"
userName = "string"
}
})
}
Valores de propriedade
laboratórios/virtualmachines
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15" |
name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-15 (Windows) 1-64 (Linux) Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. Não podem ser todos números. |
localização | A localização do recurso. | string |
parent_id | O ID do recurso que é o principal para este recurso. | ID do recurso do tipo: laboratórios |
etiquetas | As etiquetas do recurso. | Dicionário de nomes e valores de etiquetas. |
propriedades | As propriedades do recurso. | LabVirtualMachineProperties (obrigatório) |
LabVirtualMachineProperties
Nome | Descrição | Valor |
---|---|---|
allowClaim | Indica se outro utilizador pode assumir a propriedade da máquina virtual | bool |
artefactos | Os artefactos a instalar na máquina virtual. | ArtifactInstallProperties[] |
createdDate | A data de criação da máquina virtual. | string |
customImageId | O identificador de imagem personalizado da máquina virtual. | string |
dataDiskParameters | Discos de dados novos ou existentes para anexar à máquina virtual após a criação | DataDiskProperties[] |
disallowPublicIpAddress | Indica se a máquina virtual deve ser criada sem um endereço IP público. | bool |
environmentId | O ID de recurso do ambiente que contém esta máquina virtual, se existir. | string |
expirationDate | A data de expiração da VM. | string |
galleryImageReference | O Microsoft Azure Marketplace referência de imagem da máquina virtual. | GalleryImageReference |
isAuthenticationWithSshKey | Indica se esta máquina virtual utiliza 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 de laboratório da máquina virtual. | string |
networkInterface | As propriedades da interface de rede. | NetworkInterfaceProperties |
notas | As notas da máquina virtual. | string |
ownerObjectId | O identificador de objeto do proprietário da máquina virtual. | string |
ownerUserPrincipalName | O nome principal de utilizador do proprietário da máquina virtual. | string |
palavra-passe | A palavra-passe do administrador da máquina virtual. | string |
planId | O ID do plano associado à imagem da máquina virtual | string |
scheduleParameters | Agendamentos de Máquinas Virtuais a criar | ScheduleCreationParameter[] |
size | O tamanho da máquina virtual. | string |
sshKey | A chave SSH do administrador da máquina virtual. | string |
storageType | Tipo de armazenamento a utilizar na máquina virtual (ou seja, Standard, Premium). | string |
userName | O nome de utilizador da máquina virtual. | string |
ArtifactInstallProperties
Nome | Descrição | Valor |
---|---|---|
artifactId | O identificador do artefacto. | string |
artifactTitle | O título do artefacto. | string |
deploymentStatusMessage | A mensagem de estado da implementação. | string |
installTime | A hora em que o artefacto começa a ser instalado na máquina virtual. | string |
parâmetros | Os parâmetros do artefacto. | ArtifactParameterProperties[] |
status | O estado do artefacto. | string |
vmExtensionStatusMessage | A mensagem de estado da extensão da máquina virtual. | string |
ArtifactParameterProperties
Nome | Descrição | Valor |
---|---|---|
name | O nome do parâmetro do artefacto. | string |
valor | O valor do parâmetro do artefacto. | string |
DataDiskProperties
Nome | Descrição | Valor |
---|---|---|
attachNewDataDiskOptions | Especifica opções para anexar um novo disco à máquina virtual. | AttachNewDataDiskOptions |
existingLabDiskId | Especifica o ID de disco de laboratório existente para anexar à máquina virtual. | string |
hostCaching | Opção de colocação em cache para um disco de dados (ou seja, Nenhum, ReadOnly, ReadWrite). | "Nenhum" "ReadOnly" "ReadWrite" |
AttachNewDataDiskOptions
Nome | Descrição | Valor |
---|---|---|
diskName | O nome do disco a anexar. | string |
diskSizeGiB | Tamanho do disco a anexar em Gibibytes. | int |
diskType | O tipo de armazenamento do disco (ou seja, Standard, Premium). | "Premium" "Standard" "StandardSSD" |
GalleryImageReference
Nome | Descrição | Valor |
---|---|---|
oferta | A oferta da imagem da galeria. | string |
osType | O tipo de SO da imagem da galeria. | string |
publicador | O editor da imagem da galeria. | string |
sku | O SKU da imagem da galeria. | string |
versão | 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 | O ID do recurso do endereço IP público. | string |
rdpAuthority | A propriedade RdpAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para RDP (Remote Desktop Protocol). | string |
sharedPublicIpAddressConfiguration | A configuração para partilhar um endereço IP público em várias máquinas virtuais. | SharedPublicIpAddressConfiguration |
sshAuthority | A propriedade SshAuthority é um nome de anfitrião DNS do servidor ou endereço IP seguido do número da porta de serviço para SSH. | string |
subnetId | O ID do recurso da sub-rede. | string |
virtualNetworkId | O ID do recurso da rede virtual. | string |
SharedPublicIpAddressConfiguration
Nome | Descrição | Valor |
---|---|---|
inboundNatRules | As regras NAT recebidas | InboundNatRule[] |
InboundNatRule
Nome | Descrição | Valor |
---|---|---|
backendPort | A porta para a qual o tráfego externo será redirecionado. | int |
frontendPort | A porta de ponto final externo da ligaçã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 final. | "Tcp" "Udp" |
ScheduleCreationParameter
Nome | Descrição | Valor |
---|---|---|
name | O nome da máquina virtual ou do ambiente | string |
propriedades | As propriedades da agenda. | ScheduleCreationParameterProperties |
etiquetas | As etiquetas do recurso. | objeto |
ScheduleCreationParameterProperties
Nome | Descrição | Valor |
---|---|---|
diariamenteRecurrence | Se a agenda ocorrer uma vez por dia da semana, especifique a periodicidade diária. | DayDetails |
hourlyRecurrence | Se a agenda ocorrer várias vezes por dia, especifique a periodicidade por hora. | HourDetails |
notificationSettings | Definições de notificação. | NotificationSettings |
status | O estado da agenda (ou seja, Ativado, Desativado) | "Desativado" "Ativado" |
targetResourceId | O ID do recurso ao qual a agenda pertence | string |
taskType | O tipo de tarefa da agenda (por exemplo, LabVmsShutdownTask, LabVmAutoStart). | string |
weeklyRecurrence | Se a agenda ocorrer apenas alguns dias da semana, especifique a periodicidade semanal. | WeekDetails |
DayDetails
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda ocorrerá. | string |
HourDetails
Nome | Descrição | Valor |
---|---|---|
minute | Minutos da hora em que a agenda será executada. | int |
NotificationSettings
Nome | Descrição | Valor |
---|---|---|
emailRecipient | O destinatário do e-mail para o qual enviar notificações (pode ser uma lista de endereços de e-mail separados por pontos e vírgulas). | string |
notificationLocale | A região a utilizar ao enviar uma notificação (contingência para idiomas não suportados é EN). | string |
status | Se as notificações estiverem ativadas para esta agenda (ou seja, Ativada, Desativada). | "Desativado" "Ativado" |
timeInMinutes | Tempo em minutos antes do evento em que a notificação será enviada. | int |
webhookUrl | O URL do webhook para o qual a notificação será enviada. | string |
WeekDetails
Nome | Descrição | Valor |
---|---|---|
hora | A hora do dia em que a agenda ocorrerá. | string |
dias úteis | Os dias da semana para os quais a agenda está definida (por exemplo, domingo, segunda-feira, terça-feira, etc.). | cadeia[] |