Condividi tramite


Microsoft.DevTestLab labs/virtualmachines 2016-05-15

Definizione di risorsa Bicep

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice Bicep seguente al modello.

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'
  }
}

Valori delle proprietà

labs/virtualmachines

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.
stringa (obbligatoria)

Limite di caratteri: 1-15 (Windows)
1-64 (Linux)

Caratteri validi:
Caratteri alfanumerici e trattini.

Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione Il percorso della risorsa. string
tags Tag della risorsa. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
padre In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.
Nome simbolico per la risorsa di tipo: lab
properties Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome Descrizione Valore
allowClaim Indica se un altro utente può assumere la proprietà della macchina virtuale bool
applicabileSchedule Pianificazione applicabile per la macchina virtuale. ApplicabileSchedule
artifactDeploymentStatus Stato della distribuzione dell'artefatto per la macchina virtuale. ArtifactDeploymentStatusProperties
Artefatti Elementi da installare nella macchina virtuale. ArtifactInstallProperties[]
computeVm Proprietà della macchina virtuale di calcolo. ComputeVmProperties
createByUser Indirizzo di posta elettronica dell'autore della macchina virtuale. string
createByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. string
createdDate Data di creazione della macchina virtuale. string
customImageId Identificatore di immagine personalizzato della macchina virtuale. string
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. bool
environmentId ID risorsa dell'ambiente contenente questa macchina virtuale, se presente. string
expirationDate Data di scadenza per la macchina virtuale. string
fqdn Nome di dominio completo della macchina virtuale. string
galleryImageReference Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale. GalleryImageReference
isAuthenticationWithSshKey Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione. bool
labSubnetName Nome della subnet lab della macchina virtuale. string
labVirtualNetworkId Identificatore di rete virtuale lab della macchina virtuale. string
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
di HDInsight Note della macchina virtuale. string
osType Tipo di sistema operativo della macchina virtuale. string
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. string
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. string
password Password dell'amministratore della macchina virtuale. string
provisioningState Stato del provisioning della risorsa. string
size Dimensioni della macchina virtuale. string
sshKey Chiave SSH dell'amministratore della macchina virtuale. string
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (Guid). string
userName Nome utente della macchina virtuale. string
virtualMachineCreationSource Indica l'origine della creazione di macchina virtuale lab. Solo la proprietà output. 'FromCustomImage'
'FromGalleryImage'

ApplicabileSchedule

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicabileScheduleProperties (obbligatorio)
tags Tag della risorsa. object
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicabileScheduleProperties (obbligatorio)
tags Tag della risorsa. object

ApplicabileScheduleProperties

Nome Descrizione Valore
labVmsShutdown Pianificazione di arresto automatico, se è stata impostata a livello di lab o risorse lab. Pianificare
labVmsStartup Pianificazione di avvio automatico, se è stata impostata a livello di lab o risorse lab. Pianificare

Pianifica

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ScheduleProperties (obbligatorio)
tags Tag della risorsa. object

Proprietà di pianificazione

Nome Descrizione Valore
Dailyrecurrence Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera. DayDetails
hourlyRecurrence Se la pianificazione si verificherà più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. string
status Stato della pianificazione (ad esempio Abilitato, Disabilitato) 'Disabilitato'
'Enabled'
targetResourceId ID risorsa a cui appartiene la pianificazione string
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. string
timeZoneId ID del fuso orario (ad esempio, ora solare del Pacifico). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (GUID). string
weeklyRecurrence Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

DayDetails

Nome Descrizione Valore
time Ora del giorno in cui verrà eseguita la pianificazione. string

HourDetails

Nome Descrizione Valore
minute Minuti dell'ora in cui verrà eseguita la pianificazione. INT

NotificationSettings

Nome Descrizione Valore
status Se le notifiche sono abilitate per questa pianificazione ,ad esempio Abilitato, Disabilitato. 'Disabilitato'
'Enabled'
timeInMinutes Tempo in minuti prima dell'evento in cui verrà inviata la notifica. INT
webhookUrl URL del webhook a cui verrà inviata la notifica. string

WeekDetails

Nome Descrizione Valore
time Ora del giorno in cui verrà eseguita la pianificazione. string
giorni feriali Giorni della settimana per cui è impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via). string[]

ArtifactDeploymentStatusProperties

Nome Descrizione Valore
artifactsApplied Conteggio totale degli artefatti applicati correttamente. INT
deploymentStatus Stato della distribuzione dell'artefatto. string
totalArtifacts Conteggio totale degli artefatti applicati provvisoriamente. INT

ArtifactInstallProperties

Nome Descrizione Valore
artifactId Identificatore dell'artefatto. string
deploymentStatusMessage Messaggio di stato della distribuzione. string
installTime Ora in cui l'artefatto inizia a essere installato nella macchina virtuale. string
parametri Parametri dell'artefatto. ArtifactParameterProperties[]
status Stato dell'artefatto. string
vmExtensionStatusMessage Messaggio di stato dall'estensione macchina virtuale. string

ArtifactParameterProperties

Nome Descrizione valore
name Nome del parametro dell'artefatto. string
Valore Valore del parametro dell'artefatto. string

ComputeVmProperties

Nome Descrizione Valore
dataDiskIds Ottiene l'URI BLOB dei dischi dati per la macchina virtuale. string[]
dataDisks Ottiene tutti i dischi dati collegati alla macchina virtuale. ComputeDataDisk[]
networkInterfaceId Ottiene l'ID dell'interfaccia di rete della macchina virtuale. string
osDiskId Ottiene l'URI BLOB del disco del sistema operativo per la macchina virtuale. string
osType Ottiene il tipo di sistema operativo della macchina virtuale. string
statuses Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. string

ComputeDataDisk

Nome Descrizione Valore
diskSizeGiB Ottiene le dimensioni del disco dati in GiB. INT
diskUri Quando è supportato da un BLOB, l'URI del BLOB sottostante. string
managedDiskId Se supportato dal disco gestito, si tratta dell'ID della risorsa disco di calcolo. string
name Ottiene il nome del disco dati. string

ComputeVmInstanceViewStatus

Nome Descrizione Valore
codice Ottiene il codice di stato. string
displayStatus Ottiene l'etichetta localizzata breve per lo stato. string
message Ottiene il messaggio associato allo stato. string

GalleryImageReference

Nome Descrizione Valore
offer Offerta dell'immagine della raccolta. string
osType Tipo di sistema operativo dell'immagine della raccolta. string
publisher Autore dell'immagine della raccolta. string
sku SKU dell'immagine della raccolta. string
version Versione dell'immagine della raccolta. string

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. string
privateIpAddress Indirizzo IP privato. string
publicIpAddress Indirizzo IP pubblico. string
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. string
rdpAuthority La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configurazione per la condivisione di un indirizzo IP pubblico in più macchine virtuali. SharedPublicIpAddressConfiguration
sshAuthority La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH. string
subnetId ID risorsa della rete secondaria. string
virtualNetworkId ID risorsa della rete virtuale. string

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso InboundNatRule[]

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. INT
frontendPort Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore. INT
transportProtocol Protocollo di trasporto per l'endpoint. 'Tcp'
'Udp'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale Windows Server

Distribuisci in Azure
Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta

Distribuisci in Azure
Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

labs/virtualmachines

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.DevTestLab/labs/virtualmachines'
apiVersion Versione dell'API della risorsa '2016-05-15'
name Nome della risorsa

Informazioni su come impostare nomi e tipi per le risorse figlio nei modelli di Resource Manager JSON.
stringa (obbligatorio)

Limite di caratteri: 1-15 (Windows)
1-64 (Linux)

Caratteri validi:
Caratteri alfanumerici e trattini.

Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione Il percorso della risorsa. string
tags Tag della risorsa. Dizionario di nomi e valori di tag. Vedere Tag nei modelli
properties Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome Descrizione Valore
allowClaim Indica se un altro utente può assumere la proprietà della macchina virtuale bool
applicableSchedule Pianificazione applicabile per la macchina virtuale. ApplicableSchedule
artifactDeploymentStatus Stato di distribuzione dell'artefatto per la macchina virtuale. ArtifactDeploymentStatusProperties
Artefatti Artefatti da installare nella macchina virtuale. ArtifactInstallProperties[]
computeVm Proprietà della macchina virtuale di calcolo. ComputeVmProperties
createdByUser Indirizzo di posta elettronica dell'autore della macchina virtuale. string
createByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. string
createdDate Data di creazione della macchina virtuale. string
customImageId Identificatore di immagine personalizzato della macchina virtuale. string
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. bool
environmentId ID risorsa dell'ambiente contenente questa macchina virtuale, se presente. string
expirationDate Data di scadenza per la macchina virtuale. string
fqdn Nome di dominio completo della macchina virtuale. string
galleryImageReference Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale. GalleryImageReference
isAuthenticationWithSshKey Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione. bool
labSubnetName Nome della subnet lab della macchina virtuale. string
labVirtualNetworkId Identificatore di rete virtuale lab della macchina virtuale. string
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
di HDInsight Note della macchina virtuale. string
osType Tipo di sistema operativo della macchina virtuale. string
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. string
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. string
password Password dell'amministratore della macchina virtuale. string
provisioningState Stato del provisioning della risorsa. string
size Dimensioni della macchina virtuale. string
sshKey Chiave SSH dell'amministratore della macchina virtuale. string
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (Guid). string
userName Nome utente della macchina virtuale. string
virtualMachineCreationSource Indica l'origine della creazione di macchina virtuale lab. Solo la proprietà output. 'FromCustomImage'
'FromGalleryImage'

ApplicabileSchedule

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicabileScheduleProperties (obbligatorio)
tags Tag della risorsa. object
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicabileScheduleProperties (obbligatorio)
tags Tag della risorsa. object

ApplicabileScheduleProperties

Nome Descrizione Valore
labVmsShutdown Pianificazione di arresto automatico, se è stata impostata a livello di lab o risorse lab. Pianificare
labVmsStartup Pianificazione di avvio automatico, se è stata impostata a livello di lab o risorse lab. Pianificare

Pianifica

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ScheduleProperties (obbligatorio)
tags Tag della risorsa. object

Proprietà di pianificazione

Nome Descrizione Valore
Dailyrecurrence Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera. DayDetails
hourlyRecurrence Se la pianificazione si verificherà più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. string
status Stato della pianificazione (ad esempio Abilitato, Disabilitato) 'Disabilitato'
'Enabled'
targetResourceId ID risorsa a cui appartiene la pianificazione string
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. string
timeZoneId ID fuso orario (ad esempio Pacifico Standard). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (Guid). string
settimanaleRecurrence Se la pianificazione si verificherà solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

DayDetails

Nome Descrizione Valore
time L'ora del giorno verrà eseguita la pianificazione. string

HourDetails

Nome Descrizione Valore
minute Minuti dell'ora in cui verrà eseguita la pianificazione. INT

NotificationSettings

Nome Descrizione Valore
status Se le notifiche sono abilitate per questa pianificazione( ad esempio Abilitato, Disabilitato). 'Disabilitato'
'Enabled'
timeInMinutes Tempo in minuti prima dell'evento in cui verrà inviata la notifica. INT
webhookUrl URL webhook a cui verrà inviata la notifica. string

WeekDetails

Nome Descrizione Valore
time L'ora del giorno verrà eseguita la pianificazione. string
giorni feriali Giorni della settimana per cui viene impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via). string[]

ArtifactDeploymentStatusProperties

Nome Descrizione Valore
artefattiApplied Numero totale degli artefatti applicati correttamente. INT
deploymentStatus Stato della distribuzione dell'artefatto. string
totalArtifacts Conteggio totale degli artefatti applicati provvisoriamente. INT

ArtifactInstallProperties

Nome Descrizione Valore
artifactId Identificatore dell'artefatto. string
deploymentStatusMessage Messaggio di stato della distribuzione. string
installTime Ora in cui l'artefatto inizia a essere installato nella macchina virtuale. string
parametri Parametri dell'artefatto. ArtifactParameterProperties[]
status Stato dell'artefatto. string
vmExtensionStatusMessage Messaggio di stato dall'estensione macchina virtuale. string

ArtifactParameterProperties

Nome Descrizione valore
name Nome del parametro dell'artefatto. string
Valore Valore del parametro dell'artefatto. string

ComputeVmProperties

Nome Descrizione Valore
dataDiskIds Ottiene l'URI BLOB dei dischi dati per la macchina virtuale. string[]
dataDisks Ottiene tutti i dischi dati collegati alla macchina virtuale. ComputeDataDisk[]
networkInterfaceId Ottiene l'ID dell'interfaccia di rete della macchina virtuale. string
osDiskId Ottiene l'URI del BLOB del disco del sistema operativo per la macchina virtuale. string
osType Ottiene il tipo di sistema operativo della macchina virtuale. string
statuses Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. string

ComputeDataDisk

Nome Descrizione Valore
diskSizeGiB Ottiene le dimensioni del disco dati in GiB. INT
diskUri Se supportato da un BLOB, l'URI del BLOB sottostante. string
managedDiskId Se supportato da disco gestito, si tratta dell'ID della risorsa disco di calcolo. string
name Ottiene il nome del disco dati. string

ComputeVmInstanceViewStatus

Nome Descrizione Valore
codice Ottiene il codice di stato. string
displayStatus Ottiene l'etichetta localizzabile breve per lo stato. string
message Ottiene il messaggio associato allo stato. string

GalleryImageReference

Nome Descrizione Valore
offer Offerta dell'immagine della raccolta. string
osType Tipo di sistema operativo dell'immagine della raccolta. string
publisher Autore dell'immagine della raccolta. string
sku SKU dell'immagine della raccolta. string
version Versione dell'immagine della raccolta. string

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. string
privateIpAddress Indirizzo IP privato. string
publicIpAddress Indirizzo IP pubblico. string
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. string
rdpAuthority La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configurazione per la condivisione di un indirizzo IP pubblico tra più macchine virtuali. SharedPublicIpAddressConfiguration
sshAuthority La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH. string
subnetId ID risorsa della rete secondaria. string
virtualNetworkId ID risorsa della rete virtuale. string

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso InboundNatRule[]

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. INT
frontendPort Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore. INT
transportProtocol Protocollo di trasporto per l'endpoint. 'Tcp'
'Udp'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale Windows Server

Distribuisci in Azure
Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta

Distribuisci in Azure
Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice Terraform seguente al modello.

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"
    }
  })
}

Valori delle proprietà

labs/virtualmachines

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 1-15 (Windows)
1-64 (Linux)

Caratteri validi:
Caratteri alfanumerici e trattini.

Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione Il percorso della risorsa. string
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: labs
tags Tag della risorsa. Dizionario di nomi e valori di tag.
properties Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome Descrizione Valore
allowClaim Indica se un altro utente può assumere la proprietà della macchina virtuale bool
applicableSchedule Pianificazione applicabile per la macchina virtuale. ApplicableSchedule
artifactDeploymentStatus Stato di distribuzione dell'artefatto per la macchina virtuale. ArtifactDeploymentStatusProperties
Artefatti Artefatti da installare nella macchina virtuale. ArtifactInstallProperties[]
computeVm Proprietà della macchina virtuale di calcolo. ComputeVmProperties
createdByUser Indirizzo di posta elettronica dell'autore della macchina virtuale. string
createdByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. string
createdDate Data di creazione della macchina virtuale. string
customImageId Identificatore di immagine personalizzato della macchina virtuale. string
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. bool
environmentId ID risorsa dell'ambiente che contiene la macchina virtuale, se presente. string
expirationDate Data di scadenza per la macchina virtuale. string
fqdn Nome di dominio completo della macchina virtuale. string
galleryImageReference Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale. GalleryImageReference
isAuthenticationWithSshKey Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione. bool
labSubnetName Nome della subnet del lab della macchina virtuale. string
labVirtualNetworkId Identificatore della rete virtuale del lab della macchina virtuale. string
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
di HDInsight Note della macchina virtuale. string
osType Tipo di sistema operativo della macchina virtuale. string
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. string
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. string
password Password dell'amministratore della macchina virtuale. string
provisioningState Stato del provisioning della risorsa. string
size Dimensioni della macchina virtuale. string
sshKey Chiave SSH dell'amministratore della macchina virtuale. string
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (GUID). string
userName Nome utente della macchina virtuale. string
virtualMachineCreationSource Indica l'origine della creazione di una macchina virtuale lab. Solo proprietà di output. "FromCustomImage"
"FromGalleryImage"

ApplicableSchedule

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicableScheduleProperties (obbligatorio)
tags Tag della risorsa. object
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ApplicableScheduleProperties (obbligatorio)
tags Tag della risorsa. object

ApplicableScheduleProperties

Nome Descrizione Valore
labVmsShutdown Pianificazione dell'arresto automatico, se è stato impostato a livello di risorsa lab o lab. Pianificare
labVmsStartup La pianificazione di avvio automatico, se è stata impostata a livello di risorsa lab o lab. Pianificare

Pianifica

Nome Descrizione valore
posizione Il percorso della risorsa. string
properties Proprietà della risorsa. ScheduleProperties (obbligatorio)
tags Tag della risorsa. object

ScheduleProperties

Nome Descrizione Valore
Dailyrecurrence Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera. DayDetails
hourlyRecurrence Se la pianificazione verrà eseguita più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. string
status Stato della pianificazione (ad esempio Abilitato, Disabilitato) "Disabilitato"
"Abilitato"
targetResourceId ID risorsa a cui appartiene la pianificazione string
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. string
timeZoneId ID del fuso orario (ad esempio, ora solare del Pacifico). string
Uniqueidentifier Identificatore univoco non modificabile di una risorsa (GUID). string
weeklyRecurrence Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

DayDetails

Nome Descrizione Valore
time Ora del giorno in cui verrà eseguita la pianificazione. string

HourDetails

Nome Descrizione Valore
minute Minuti dell'ora in cui verrà eseguita la pianificazione. INT

NotificationSettings

Nome Descrizione Valore
status Se le notifiche sono abilitate per questa pianificazione( ad esempio Abilitato, Disabilitato). "Disabilitato"
"Abilitato"
timeInMinutes Tempo in minuti prima dell'evento in cui verrà inviata la notifica. INT
webhookUrl URL webhook a cui verrà inviata la notifica. string

WeekDetails

Nome Descrizione Valore
time L'ora del giorno verrà eseguita la pianificazione. string
giorni feriali Giorni della settimana per cui viene impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via). string[]

ArtifactDeploymentStatusProperties

Nome Descrizione Valore
artefattiApplied Numero totale degli artefatti applicati correttamente. INT
deploymentStatus Stato della distribuzione dell'artefatto. string
totaliArtifacts Numero totale degli artefatti applicati in modo provvisorio. INT

ArtifactInstallProperties

Nome Descrizione Valore
artifactId Identificatore dell'artefatto. string
deploymentStatusMessage Messaggio di stato dalla distribuzione. string
installTime Ora in cui l'artefatto inizia a essere installato nella macchina virtuale. string
parametri Parametri dell'artefatto. ArtifactParameterProperties[]
status Stato dell'artefatto. string
vmExtensionStatusMessage Messaggio di stato dall'estensione della macchina virtuale. string

ArtifactParameterProperties

Nome Descrizione valore
name Nome del parametro dell'artefatto. string
Valore Valore del parametro dell'artefatto. string

ComputeVmProperties

Nome Descrizione Valore
dataDiskIds Ottiene l'URI BLOB dei dischi dati per la macchina virtuale. string[]
dataDisks Ottiene tutti i dischi dati collegati alla macchina virtuale. ComputeDataDisk[]
networkInterfaceId Ottiene l'ID dell'interfaccia di rete della macchina virtuale. string
osDiskId Ottiene l'URI BLOB del disco del sistema operativo per la macchina virtuale. string
osType Ottiene il tipo di sistema operativo della macchina virtuale. string
statuses Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. string

ComputeDataDisk

Nome Descrizione Valore
diskSizeGiB Ottiene le dimensioni del disco dati in GiB. INT
diskUri Se supportato da un BLOB, l'URI del BLOB sottostante. string
managedDiskId Se supportato da disco gestito, si tratta dell'ID della risorsa disco di calcolo. string
name Ottiene il nome del disco dati. string

ComputeVmInstanceViewStatus

Nome Descrizione Valore
codice Ottiene il codice di stato. string
displayStatus Ottiene l'etichetta localizzabile breve per lo stato. string
message Ottiene il messaggio associato allo stato. string

GalleryImageReference

Nome Descrizione Valore
offer Offerta dell'immagine della raccolta. string
osType Tipo di sistema operativo dell'immagine della raccolta. string
publisher Autore dell'immagine della raccolta. string
sku SKU dell'immagine della raccolta. string
version Versione dell'immagine della raccolta. string

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. string
privateIpAddress Indirizzo IP privato. string
publicIpAddress Indirizzo IP pubblico. string
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. string
rdpAuthority La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol). string
sharedPublicIpAddressConfiguration Configurazione per la condivisione di un indirizzo IP pubblico tra più macchine virtuali. SharedPublicIpAddressConfiguration
sshAuthority La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH. string
subnetId ID risorsa della rete secondaria. string
virtualNetworkId ID risorsa della rete virtuale. string

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso InboundNatRule[]

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. INT
frontendPort Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore. INT
transportProtocol Protocollo di trasporto per l'endpoint. "Tcp"
"Udp"