Condividi tramite

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • Articolo

Definizione di risorsa Bicep

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

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

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

Valori delle proprietà

ApplicableSchedule

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. ApplicableScheduleProperties (obbligatorio)
Tag Tag della risorsa. resourcetag

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

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

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome Descrizione Valore
nome Nome del parametro dell'artefatto. corda
valore Valore del parametro dell'artefatto. corda

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. corda
managedDiskId Se supportato da disco gestito, si tratta dell'ID della risorsa disco di calcolo. corda
nome Ottiene il nome del disco dati. corda

ComputeVmInstanceViewStatus

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

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. corda
osDiskId Ottiene l'URI BLOB del disco del sistema operativo per la macchina virtuale. corda
osType Ottiene il tipo di sistema operativo della macchina virtuale. corda
Stati Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. corda

DayDetails

Nome Descrizione Valore
Ore Ora del giorno in cui verrà eseguita la pianificazione. corda

GalleryImageReference

Nome Descrizione Valore
offerta Offerta dell'immagine della raccolta. corda
osType Tipo di sistema operativo dell'immagine della raccolta. corda
editore Autore dell'immagine della raccolta. corda
Sku SKU dell'immagine della raccolta. corda
Versione Versione dell'immagine della raccolta. corda

HourDetails

Nome Descrizione Valore
minuto Minuti dell'ora in cui verrà eseguita la pianificazione. Int

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. Int
frontendPort Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

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
Manufatti 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. corda
createdByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. corda
createdDate Data di creazione della macchina virtuale. corda
customImageId Identificatore dell'immagine personalizzata della macchina virtuale. corda
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. Bool
environmentId ID risorsa dell'ambiente che contiene questa macchina virtuale, se presente. corda
expirationDate Data di scadenza per la macchina virtuale. corda
Fqdn Nome di dominio completo della macchina virtuale. corda
galleryImageReference Informazioni di riferimento sull'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. corda
labVirtualNetworkId Identificatore di rete virtuale del lab della macchina virtuale. corda
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
Note Note della macchina virtuale. corda
osType Tipo di sistema operativo della macchina virtuale. corda
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. corda
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. corda
parola d’ordine Password dell'amministratore della macchina virtuale. corda
provisioningState Stato del provisioning della risorsa. corda
grandezza Dimensioni della macchina virtuale. corda
sshKey Chiave SSH dell'amministratore della macchina virtuale. corda
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
nome utente Nome utente della macchina virtuale. corda
virtualMachineCreationSource Indica l'origine della creazione della macchina virtuale del lab. Solo proprietà di output. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
genitore 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 all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: lab
proprietà Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. corda
privateIpAddress Indirizzo IP privato. corda
publicIpAddress Indirizzo IP pubblico. corda
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. corda
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). corda
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. corda
subnetId ID risorsa della rete secondaria. corda
virtualNetworkId ID risorsa della rete virtuale. corda

NotificationSettings

Nome Descrizione Valore
stato 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. corda

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

Programma

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. Proprietà pianificazione (obbligatorio)
Tag Tag della risorsa. resourcetag

Proprietà 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 verrà eseguita più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. corda
stato Stato della pianificazione (ad esempio Abilitato, Disabilitato) 'Disabilitato'
'Enabled'
targetResourceId ID risorsa a cui appartiene la pianificazione corda
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. corda
timeZoneId ID fuso orario (ad esempio, Ora solare pacifico). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
weeklyRecurrence Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso inboundNatRule[]

WeekDetails

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

Esempi di utilizzo

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

Bicep File Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta 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 in https://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:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

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

Valori delle proprietà

ApplicableSchedule

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. ApplicableScheduleProperties (obbligatorio)
Tag Tag della risorsa. resourcetag

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

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

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome Descrizione Valore
nome Nome del parametro dell'artefatto. corda
valore Valore del parametro dell'artefatto. corda

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. corda
managedDiskId Se supportato da disco gestito, si tratta dell'ID della risorsa disco di calcolo. corda
nome Ottiene il nome del disco dati. corda

ComputeVmInstanceViewStatus

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

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. corda
osDiskId Ottiene l'URI BLOB del disco del sistema operativo per la macchina virtuale. corda
osType Ottiene il tipo di sistema operativo della macchina virtuale. corda
Stati Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. corda

DayDetails

Nome Descrizione Valore
Ore Ora del giorno in cui verrà eseguita la pianificazione. corda

GalleryImageReference

Nome Descrizione Valore
offerta Offerta dell'immagine della raccolta. corda
osType Tipo di sistema operativo dell'immagine della raccolta. corda
editore Autore dell'immagine della raccolta. corda
Sku SKU dell'immagine della raccolta. corda
Versione Versione dell'immagine della raccolta. corda

HourDetails

Nome Descrizione Valore
minuto Minuti dell'ora in cui verrà eseguita la pianificazione. Int

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. Int
frontendPort Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

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
Manufatti 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. corda
createdByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. corda
createdDate Data di creazione della macchina virtuale. corda
customImageId Identificatore dell'immagine personalizzata della macchina virtuale. corda
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. Bool
environmentId ID risorsa dell'ambiente che contiene questa macchina virtuale, se presente. corda
expirationDate Data di scadenza per la macchina virtuale. corda
Fqdn Nome di dominio completo della macchina virtuale. corda
galleryImageReference Informazioni di riferimento sull'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. corda
labVirtualNetworkId Identificatore di rete virtuale del lab della macchina virtuale. corda
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
Note Note della macchina virtuale. corda
osType Tipo di sistema operativo della macchina virtuale. corda
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. corda
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. corda
parola d’ordine Password dell'amministratore della macchina virtuale. corda
provisioningState Stato del provisioning della risorsa. corda
grandezza Dimensioni della macchina virtuale. corda
sshKey Chiave SSH dell'amministratore della macchina virtuale. corda
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
nome utente Nome utente della macchina virtuale. corda
virtualMachineCreationSource Indica l'origine della creazione della macchina virtuale del lab. Solo proprietà di output. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrizione Valore
apiVersion Versione dell'API '2016-05-15'
ubicazione Posizione della risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. corda
privateIpAddress Indirizzo IP privato. corda
publicIpAddress Indirizzo IP pubblico. corda
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. corda
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). corda
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. corda
subnetId ID risorsa della rete secondaria. corda
virtualNetworkId ID risorsa della rete virtuale. corda

NotificationSettings

Nome Descrizione Valore
stato 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. corda

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

Programma

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. Proprietà pianificazione (obbligatorio)
Tag Tag della risorsa. resourcetag

Proprietà 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 verrà eseguita più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. corda
stato Stato della pianificazione (ad esempio Abilitato, Disabilitato) 'Disabilitato'
'Enabled'
targetResourceId ID risorsa a cui appartiene la pianificazione corda
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. corda
timeZoneId ID fuso orario (ad esempio, Ora solare pacifico). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
weeklyRecurrence Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso inboundNatRule[]

WeekDetails

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

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta

Distribuire 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 in https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

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

Valori delle proprietà

ApplicableSchedule

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. ApplicableScheduleProperties (obbligatorio)
Tag Tag della risorsa. resourcetag

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

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

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome Descrizione Valore
nome Nome del parametro dell'artefatto. corda
valore Valore del parametro dell'artefatto. corda

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. corda
managedDiskId Se supportato da disco gestito, si tratta dell'ID della risorsa disco di calcolo. corda
nome Ottiene il nome del disco dati. corda

ComputeVmInstanceViewStatus

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

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. corda
osDiskId Ottiene l'URI BLOB del disco del sistema operativo per la macchina virtuale. corda
osType Ottiene il tipo di sistema operativo della macchina virtuale. corda
Stati Ottiene gli stati della macchina virtuale. ComputeVmInstanceViewStatus[]
vmSize Ottiene le dimensioni della macchina virtuale. corda

DayDetails

Nome Descrizione Valore
Ore Ora del giorno in cui verrà eseguita la pianificazione. corda

GalleryImageReference

Nome Descrizione Valore
offerta Offerta dell'immagine della raccolta. corda
osType Tipo di sistema operativo dell'immagine della raccolta. corda
editore Autore dell'immagine della raccolta. corda
Sku SKU dell'immagine della raccolta. corda
Versione Versione dell'immagine della raccolta. corda

HourDetails

Nome Descrizione Valore
minuto Minuti dell'ora in cui verrà eseguita la pianificazione. Int

InboundNatRule

Nome Descrizione Valore
backendPort Porta a cui verrà reindirizzato il traffico esterno. Int
frontendPort Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

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
Manufatti 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. corda
createdByUserId Identificatore dell'oggetto dell'autore della macchina virtuale. corda
createdDate Data di creazione della macchina virtuale. corda
customImageId Identificatore dell'immagine personalizzata della macchina virtuale. corda
disallowPublicIpAddress Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico. Bool
environmentId ID risorsa dell'ambiente che contiene questa macchina virtuale, se presente. corda
expirationDate Data di scadenza per la macchina virtuale. corda
Fqdn Nome di dominio completo della macchina virtuale. corda
galleryImageReference Informazioni di riferimento sull'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. corda
labVirtualNetworkId Identificatore di rete virtuale del lab della macchina virtuale. corda
networkInterface Proprietà dell'interfaccia di rete. NetworkInterfaceProperties
Note Note della macchina virtuale. corda
osType Tipo di sistema operativo della macchina virtuale. corda
ownerObjectId Identificatore dell'oggetto del proprietario della macchina virtuale. corda
ownerUserPrincipalName Nome dell'entità utente del proprietario della macchina virtuale. corda
parola d’ordine Password dell'amministratore della macchina virtuale. corda
provisioningState Stato del provisioning della risorsa. corda
grandezza Dimensioni della macchina virtuale. corda
sshKey Chiave SSH dell'amministratore della macchina virtuale. corda
storageType Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
nome utente Nome utente della macchina virtuale. corda
virtualMachineCreationSource Indica l'origine della creazione della macchina virtuale del lab. Solo proprietà di output. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: lab
proprietà Proprietà della risorsa. LabVirtualMachineProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Nome Descrizione Valore
dnsName Nome DNS. corda
privateIpAddress Indirizzo IP privato. corda
publicIpAddress Indirizzo IP pubblico. corda
publicIpAddressId ID risorsa dell'indirizzo IP pubblico. corda
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). corda
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. corda
subnetId ID risorsa della rete secondaria. corda
virtualNetworkId ID risorsa della rete virtuale. corda

NotificationSettings

Nome Descrizione Valore
stato 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. corda

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

Programma

Nome Descrizione Valore
ubicazione Posizione della risorsa. corda
proprietà Proprietà della risorsa. Proprietà pianificazione (obbligatorio)
Tag Tag della risorsa. resourcetag

Proprietà 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 verrà eseguita più volte al giorno, specificare la ricorrenza oraria. HourDetails
notificationSettings Impostazioni di notifica. NotificationSettings
provisioningState Stato del provisioning della risorsa. corda
stato Stato della pianificazione (ad esempio Abilitato, Disabilitato) 'Disabilitato'
'Enabled'
targetResourceId ID risorsa a cui appartiene la pianificazione corda
taskType Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart. corda
timeZoneId ID fuso orario (ad esempio, Ora solare pacifico). corda
uniqueIdentifier Identificatore univoco non modificabile di una risorsa (GUID). corda
weeklyRecurrence Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale. WeekDetails

SharedPublicIpAddressConfiguration

Nome Descrizione Valore
inboundNatRules Regole NAT in ingresso inboundNatRule[]

WeekDetails

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