Sdílet prostřednictvím

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • Článek

Definice prostředku Bicep

Typ prostředku labs/virtualmachines je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevTestLab/labs/virtualmachines, přidejte do šablony následující bicep.

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

Hodnoty vlastností

ApplicableSchedule

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. applicableScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ApplicableScheduleProperties

Jméno Popis Hodnota
labVmsShutdown Plán automatického vypnutí, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán
labVmsStartup Plán automatického spuštění, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán

ArtifactDeploymentStatusProperties

Jméno Popis Hodnota
artifactsApplied Celkový počet artefaktů, které byly úspěšně použity. Int
deploymentStatus Stav nasazení artefaktu. řetězec
totalArtifacts Celkový počet artefaktů, které byly nezávazně použity. Int

ArtifactInstallProperties

Jméno Popis Hodnota
artifactId Identifikátor artefaktu. řetězec
deploymentStatusMessage Stavová zpráva z nasazení řetězec
installTime Čas, kdy se artefakt začne instalovat na virtuální počítač. řetězec
parametry Parametry artefaktu. ArtifactParameterProperties[]
stav Stav artefaktu. řetězec
vmExtensionStatusMessage Stavová zpráva z rozšíření virtuálního počítače řetězec

ArtifactParameterProperties

Jméno Popis Hodnota
Jméno Název parametru artefaktu. řetězec
hodnota Hodnota parametru artefaktu. řetězec

ComputeDataDisk

Jméno Popis Hodnota
diskSizeGiB Získá velikost datového disku v GiB. Int
diskUri Při zálohování objektem blob je identifikátor URI podkladového objektu blob. řetězec
managedDiskId Při zálohování spravovaným diskem se jedná o ID prostředku výpočetního disku. řetězec
Jméno Získá název datového disku. řetězec

ComputeVmInstanceViewStatus

Jméno Popis Hodnota
kód Získá stavový kód. řetězec
displayStatus Získá krátký lokalizovatelný popisek pro stav. řetězec
zpráva Získá zprávu přidruženou ke stavu. řetězec

ComputeVmProperties

Jméno Popis Hodnota
dataDiskIds Získá identifikátor URI objektu blob datových disků pro virtuální počítač. string[]
dataDisks Získá všechny datové disky připojené k virtuálnímu počítači. ComputeDataDisk[]
networkInterfaceId Získá ID síťového rozhraní virtuálního počítače. řetězec
osDiskId Získá identifikátor URI objektu blob disku s operačním systémem pro virtuální počítač. řetězec
osType Získá typ operačního systému virtuálního počítače. řetězec
Stavy Získá stav virtuálního počítače. ComputeVmInstanceViewStatus[]
vmSize Získá velikost virtuálního počítače. řetězec

DayDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec

GalerieImageReference

Jméno Popis Hodnota
nabídnout Nabídka obrázku galerie řetězec
osType Typ operačního systému image galerie. řetězec
vydavatel Vydavatel obrázku galerie. řetězec
sku Skladová položka obrázku galerie. řetězec
verze Verze image galerie. řetězec

HourDetails

Jméno Popis Hodnota
minuta Minuty hodiny, po které se plán spustí. Int

InboundNatRule

Jméno Popis Hodnota
backendPort Port, do kterého se bude externí provoz přesměrovat. Int
frontendPort Port externího koncového bodu příchozího připojení. Možné hodnoty v rozsahu od 1 do 65535 včetně. Pokud není zadáno, automaticky se přidělí hodnota. Int
transportProtocol Přenosový protokol pro koncový bod. Tcp
Udp

LabVirtualMachineProperties

Jméno Popis Hodnota
allowClaim Určuje, jestli může jiný uživatel převzít vlastnictví virtuálního počítače. Bool
applicableSchedule Platný plán pro virtuální počítač. applicableSchedule
artifactDeploymentStatus Stav nasazení artefaktů pro virtuální počítač. ArtifactDeploymentStatusProperties
Artefakty Artefakty, které se mají nainstalovat na virtuální počítač. ArtifactInstallProperties[]
computeVm Vlastnosti výpočetního virtuálního počítače. ComputeVmProperties
createdByUser E-mailová adresa tvůrce virtuálního počítače. řetězec
createdByUserId Identifikátor objektu tvůrce virtuálního počítače. řetězec
createdDate Datum vytvoření virtuálního počítače. řetězec
customImageId Identifikátor vlastní image virtuálního počítače. řetězec
disallowPublicIpAddress Určuje, jestli se má virtuální počítač vytvořit bez veřejné IP adresy. Bool
environmentId ID prostředku prostředí, které obsahuje tento virtuální počítač, pokud existuje. řetězec
datum vypršení platnosti Datum vypršení platnosti virtuálního počítače řetězec
Fqdn Plně kvalifikovaný název domény virtuálního počítače. řetězec
galleryImageReference Odkaz na image Microsoft Azure Marketplace virtuálního počítače. GalleryImageReference
isAuthenticationWithSshKey Určuje, jestli tento virtuální počítač k ověřování používá klíč SSH. Bool
labSubnetName Název podsítě testovacího prostředí virtuálního počítače. řetězec
labVirtualNetworkId Identifikátor virtuální sítě testovacího prostředí virtuálního počítače. řetězec
networkInterface Vlastnosti síťového rozhraní. NetworkInterfaceProperties
poznámky Poznámky k virtuálnímu počítači. řetězec
osType Typ operačního systému virtuálního počítače. řetězec
ownerObjectId Identifikátor objektu vlastníka virtuálního počítače. řetězec
ownerUserPrincipalName Hlavní název uživatele vlastníka virtuálního počítače. řetězec
heslo Heslo správce virtuálního počítače. řetězec
provisioningState Stav zřizování prostředku. řetězec
velikost Velikost virtuálního počítače. řetězec
sshKey Klíč SSH správce virtuálního počítače. řetězec
storageType Typ úložiště, který se má použít pro virtuální počítač (tj. Standard, Premium). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
userName Uživatelské jméno virtuálního počítače. řetězec
virtualMachineCreationSource Řekne zdroj vytvoření virtuálního počítače testovacího prostředí. Pouze výstupní vlastnost. FromCustomImage
FromGalleryImage

Microsoft.DevTestLab/labs/virtualmachines

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
Jméno Název prostředku string (povinné)
rodič V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.		 Symbolický název prostředku typu: testovací prostředí
vlastnosti Vlastnosti prostředku. LabVirtualMachineProperties (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

NetworkInterfaceProperties

Jméno Popis Hodnota
dnsName Název DNS. řetězec
privateIpAddress Privátní IP adresa. řetězec
publicIpAddress Veřejná IP adresa. řetězec
publicIpAddressId ID prostředku veřejné IP adresy. řetězec
rdpAuthority Vlastnost RdpAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro protokol RDP (Remote Desktop Protocol). řetězec
sharedPublicIpAddressConfiguration Konfigurace pro sdílení veřejné IP adresy napříč několika virtuálními počítači. SharedPublicIpAddressConfiguration
sshAuthority Vlastnost SshAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro SSH. řetězec
subnetId ID prostředku sub net. řetězec
virtualNetworkId ID prostředku virtuální sítě. řetězec

NotificationSettings

Jméno Popis Hodnota
stav Pokud jsou pro tento plán povolená oznámení (tj. Povoleno, Zakázáno). Zakázáno
Povoleno
timeInMinutes Čas v minutách před událostí, ve které se oznámení odešle. Int
webhookUrl Adresa URL webhooku, na kterou se oznámení odešle. řetězec

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Naplánovat

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. ScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ScheduleProperties

Jméno Popis Hodnota
dailyRecurrence Pokud plán nastane jednou denně v týdnu, zadejte denní opakování. DayDetails
hourlyRecurrence Pokud bude plán probíhat vícekrát denně, zadejte hodinové opakování. HourDetails
notificationSettings Nastavení oznámení NotificationSettings
provisioningState Stav zřizování prostředku. řetězec
stav Stav plánu (tj. Povoleno, Zakázáno) Zakázáno
Povoleno
targetResourceId ID prostředku, do kterého plán patří řetězec
taskType Typ úkolu plánu (např. LabVmsShutdownTask, LabVmAutoStart). řetězec
timeZoneId ID časového pásma (např. Tichomoří (běžný čas). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
týdennírecurrence Pokud bude plán probíhat pouze v některých dnech v týdnu, zadejte týdenní opakování. WeekDetails

SharedPublicIpAddressConfiguration

Jméno Popis Hodnota
inboundNatRules Příchozí pravidla překladu adres (NAT) příchozíNatRule []

WeekDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec
všední dny Dny v týdnu, pro které je plán nastavený (např. neděle, pondělí, úterý atd.). string[]

Příklady použití

Ukázky rychlého startu Azure

Následující šablony Azure pro rychlý start obsahují ukázky Bicep pro nasazení tohoto typu prostředku.

Soubor Bicep Popis
vytvoří testovací prostředí ve službě Azure DevTest Labs s deklarací virtuálního počítače Tato šablona vytvoří novou instanci DevTest Lab / DTL s deklarovaným virtuálním počítačem s Windows Serverem 2019 Datacenter. Další šablony azure Resource Manageru pro rychlý start pro Azure DevTest Labs dostupné na webu https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definice prostředku šablony ARM

Typ prostředku labs/virtualmachines je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevTestLab/labs/virtualmachines, přidejte do šablony následující JSON.

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

Hodnoty vlastností

ApplicableSchedule

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. applicableScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ApplicableScheduleProperties

Jméno Popis Hodnota
labVmsShutdown Plán automatického vypnutí, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán
labVmsStartup Plán automatického spuštění, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán

ArtifactDeploymentStatusProperties

Jméno Popis Hodnota
artifactsApplied Celkový počet artefaktů, které byly úspěšně použity. Int
deploymentStatus Stav nasazení artefaktu. řetězec
totalArtifacts Celkový počet artefaktů, které byly nezávazně použity. Int

ArtifactInstallProperties

Jméno Popis Hodnota
artifactId Identifikátor artefaktu. řetězec
deploymentStatusMessage Stavová zpráva z nasazení řetězec
installTime Čas, kdy se artefakt začne instalovat na virtuální počítač. řetězec
parametry Parametry artefaktu. ArtifactParameterProperties[]
stav Stav artefaktu. řetězec
vmExtensionStatusMessage Stavová zpráva z rozšíření virtuálního počítače řetězec

ArtifactParameterProperties

Jméno Popis Hodnota
Jméno Název parametru artefaktu. řetězec
hodnota Hodnota parametru artefaktu. řetězec

ComputeDataDisk

Jméno Popis Hodnota
diskSizeGiB Získá velikost datového disku v GiB. Int
diskUri Při zálohování objektem blob je identifikátor URI podkladového objektu blob. řetězec
managedDiskId Při zálohování spravovaným diskem se jedná o ID prostředku výpočetního disku. řetězec
Jméno Získá název datového disku. řetězec

ComputeVmInstanceViewStatus

Jméno Popis Hodnota
kód Získá stavový kód. řetězec
displayStatus Získá krátký lokalizovatelný popisek pro stav. řetězec
zpráva Získá zprávu přidruženou ke stavu. řetězec

ComputeVmProperties

Jméno Popis Hodnota
dataDiskIds Získá identifikátor URI objektu blob datových disků pro virtuální počítač. string[]
dataDisks Získá všechny datové disky připojené k virtuálnímu počítači. ComputeDataDisk[]
networkInterfaceId Získá ID síťového rozhraní virtuálního počítače. řetězec
osDiskId Získá identifikátor URI objektu blob disku s operačním systémem pro virtuální počítač. řetězec
osType Získá typ operačního systému virtuálního počítače. řetězec
Stavy Získá stav virtuálního počítače. ComputeVmInstanceViewStatus[]
vmSize Získá velikost virtuálního počítače. řetězec

DayDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec

GalerieImageReference

Jméno Popis Hodnota
nabídnout Nabídka obrázku galerie řetězec
osType Typ operačního systému image galerie. řetězec
vydavatel Vydavatel obrázku galerie. řetězec
sku Skladová položka obrázku galerie. řetězec
verze Verze image galerie. řetězec

HourDetails

Jméno Popis Hodnota
minuta Minuty hodiny, po které se plán spustí. Int

InboundNatRule

Jméno Popis Hodnota
backendPort Port, do kterého se bude externí provoz přesměrovat. Int
frontendPort Port externího koncového bodu příchozího připojení. Možné hodnoty v rozsahu od 1 do 65535 včetně. Pokud není zadáno, automaticky se přidělí hodnota. Int
transportProtocol Přenosový protokol pro koncový bod. Tcp
Udp

LabVirtualMachineProperties

Jméno Popis Hodnota
allowClaim Určuje, jestli může jiný uživatel převzít vlastnictví virtuálního počítače. Bool
applicableSchedule Platný plán pro virtuální počítač. applicableSchedule
artifactDeploymentStatus Stav nasazení artefaktů pro virtuální počítač. ArtifactDeploymentStatusProperties
Artefakty Artefakty, které se mají nainstalovat na virtuální počítač. ArtifactInstallProperties[]
computeVm Vlastnosti výpočetního virtuálního počítače. ComputeVmProperties
createdByUser E-mailová adresa tvůrce virtuálního počítače. řetězec
createdByUserId Identifikátor objektu tvůrce virtuálního počítače. řetězec
createdDate Datum vytvoření virtuálního počítače. řetězec
customImageId Identifikátor vlastní image virtuálního počítače. řetězec
disallowPublicIpAddress Určuje, jestli se má virtuální počítač vytvořit bez veřejné IP adresy. Bool
environmentId ID prostředku prostředí, které obsahuje tento virtuální počítač, pokud existuje. řetězec
datum vypršení platnosti Datum vypršení platnosti virtuálního počítače řetězec
Fqdn Plně kvalifikovaný název domény virtuálního počítače. řetězec
galleryImageReference Odkaz na image Microsoft Azure Marketplace virtuálního počítače. GalleryImageReference
isAuthenticationWithSshKey Určuje, jestli tento virtuální počítač k ověřování používá klíč SSH. Bool
labSubnetName Název podsítě testovacího prostředí virtuálního počítače. řetězec
labVirtualNetworkId Identifikátor virtuální sítě testovacího prostředí virtuálního počítače. řetězec
networkInterface Vlastnosti síťového rozhraní. NetworkInterfaceProperties
poznámky Poznámky k virtuálnímu počítači. řetězec
osType Typ operačního systému virtuálního počítače. řetězec
ownerObjectId Identifikátor objektu vlastníka virtuálního počítače. řetězec
ownerUserPrincipalName Hlavní název uživatele vlastníka virtuálního počítače. řetězec
heslo Heslo správce virtuálního počítače. řetězec
provisioningState Stav zřizování prostředku. řetězec
velikost Velikost virtuálního počítače. řetězec
sshKey Klíč SSH správce virtuálního počítače. řetězec
storageType Typ úložiště, který se má použít pro virtuální počítač (tj. Standard, Premium). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
userName Uživatelské jméno virtuálního počítače. řetězec
virtualMachineCreationSource Řekne zdroj vytvoření virtuálního počítače testovacího prostředí. Pouze výstupní vlastnost. FromCustomImage
FromGalleryImage

Microsoft.DevTestLab/labs/virtualmachines

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2016-05-15'
umístění Umístění prostředku. řetězec
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti prostředku. LabVirtualMachineProperties (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

Jméno Popis Hodnota
dnsName Název DNS. řetězec
privateIpAddress Privátní IP adresa. řetězec
publicIpAddress Veřejná IP adresa. řetězec
publicIpAddressId ID prostředku veřejné IP adresy. řetězec
rdpAuthority Vlastnost RdpAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro protokol RDP (Remote Desktop Protocol). řetězec
sharedPublicIpAddressConfiguration Konfigurace pro sdílení veřejné IP adresy napříč několika virtuálními počítači. SharedPublicIpAddressConfiguration
sshAuthority Vlastnost SshAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro SSH. řetězec
subnetId ID prostředku sub net. řetězec
virtualNetworkId ID prostředku virtuální sítě. řetězec

NotificationSettings

Jméno Popis Hodnota
stav Pokud jsou pro tento plán povolená oznámení (tj. Povoleno, Zakázáno). Zakázáno
Povoleno
timeInMinutes Čas v minutách před událostí, ve které se oznámení odešle. Int
webhookUrl Adresa URL webhooku, na kterou se oznámení odešle. řetězec

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Naplánovat

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. ScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ScheduleProperties

Jméno Popis Hodnota
dailyRecurrence Pokud plán nastane jednou denně v týdnu, zadejte denní opakování. DayDetails
hourlyRecurrence Pokud bude plán probíhat vícekrát denně, zadejte hodinové opakování. HourDetails
notificationSettings Nastavení oznámení NotificationSettings
provisioningState Stav zřizování prostředku. řetězec
stav Stav plánu (tj. Povoleno, Zakázáno) Zakázáno
Povoleno
targetResourceId ID prostředku, do kterého plán patří řetězec
taskType Typ úkolu plánu (např. LabVmsShutdownTask, LabVmAutoStart). řetězec
timeZoneId ID časového pásma (např. Tichomoří (běžný čas). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
týdennírecurrence Pokud bude plán probíhat pouze v některých dnech v týdnu, zadejte týdenní opakování. WeekDetails

SharedPublicIpAddressConfiguration

Jméno Popis Hodnota
inboundNatRules Příchozí pravidla překladu adres (NAT) příchozíNatRule []

WeekDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec
všední dny Dny v týdnu, pro které je plán nastavený (např. neděle, pondělí, úterý atd.). string[]

Příklady použití

Šablony azure pro rychlý start

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Šablona Popis
vytvoří testovací prostředí ve službě Azure DevTest Labs s deklarací virtuálního počítače

nasazení do Azure		 Tato šablona vytvoří novou instanci DevTest Lab / DTL s deklarovaným virtuálním počítačem s Windows Serverem 2019 Datacenter. Další šablony azure Resource Manageru pro rychlý start pro Azure DevTest Labs dostupné na webu https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku labs/virtualmachines je možné nasadit s operacemi, které cílí:

  • skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevTestLab/labs/virtualmachines, přidejte do šablony následující Terraform.

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

Hodnoty vlastností

ApplicableSchedule

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. applicableScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ApplicableScheduleProperties

Jméno Popis Hodnota
labVmsShutdown Plán automatického vypnutí, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán
labVmsStartup Plán automatického spuštění, pokud je nastavený na úrovni testovacího prostředí nebo testovacího prostředí. plán

ArtifactDeploymentStatusProperties

Jméno Popis Hodnota
artifactsApplied Celkový počet artefaktů, které byly úspěšně použity. Int
deploymentStatus Stav nasazení artefaktu. řetězec
totalArtifacts Celkový počet artefaktů, které byly nezávazně použity. Int

ArtifactInstallProperties

Jméno Popis Hodnota
artifactId Identifikátor artefaktu. řetězec
deploymentStatusMessage Stavová zpráva z nasazení řetězec
installTime Čas, kdy se artefakt začne instalovat na virtuální počítač. řetězec
parametry Parametry artefaktu. ArtifactParameterProperties[]
stav Stav artefaktu. řetězec
vmExtensionStatusMessage Stavová zpráva z rozšíření virtuálního počítače řetězec

ArtifactParameterProperties

Jméno Popis Hodnota
Jméno Název parametru artefaktu. řetězec
hodnota Hodnota parametru artefaktu. řetězec

ComputeDataDisk

Jméno Popis Hodnota
diskSizeGiB Získá velikost datového disku v GiB. Int
diskUri Při zálohování objektem blob je identifikátor URI podkladového objektu blob. řetězec
managedDiskId Při zálohování spravovaným diskem se jedná o ID prostředku výpočetního disku. řetězec
Jméno Získá název datového disku. řetězec

ComputeVmInstanceViewStatus

Jméno Popis Hodnota
kód Získá stavový kód. řetězec
displayStatus Získá krátký lokalizovatelný popisek pro stav. řetězec
zpráva Získá zprávu přidruženou ke stavu. řetězec

ComputeVmProperties

Jméno Popis Hodnota
dataDiskIds Získá identifikátor URI objektu blob datových disků pro virtuální počítač. string[]
dataDisks Získá všechny datové disky připojené k virtuálnímu počítači. ComputeDataDisk[]
networkInterfaceId Získá ID síťového rozhraní virtuálního počítače. řetězec
osDiskId Získá identifikátor URI objektu blob disku s operačním systémem pro virtuální počítač. řetězec
osType Získá typ operačního systému virtuálního počítače. řetězec
Stavy Získá stav virtuálního počítače. ComputeVmInstanceViewStatus[]
vmSize Získá velikost virtuálního počítače. řetězec

DayDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec

GalerieImageReference

Jméno Popis Hodnota
nabídnout Nabídka obrázku galerie řetězec
osType Typ operačního systému image galerie. řetězec
vydavatel Vydavatel obrázku galerie. řetězec
sku Skladová položka obrázku galerie. řetězec
verze Verze image galerie. řetězec

HourDetails

Jméno Popis Hodnota
minuta Minuty hodiny, po které se plán spustí. Int

InboundNatRule

Jméno Popis Hodnota
backendPort Port, do kterého se bude externí provoz přesměrovat. Int
frontendPort Port externího koncového bodu příchozího připojení. Možné hodnoty v rozsahu od 1 do 65535 včetně. Pokud není zadáno, automaticky se přidělí hodnota. Int
transportProtocol Přenosový protokol pro koncový bod. Tcp
Udp

LabVirtualMachineProperties

Jméno Popis Hodnota
allowClaim Určuje, jestli může jiný uživatel převzít vlastnictví virtuálního počítače. Bool
applicableSchedule Platný plán pro virtuální počítač. applicableSchedule
artifactDeploymentStatus Stav nasazení artefaktů pro virtuální počítač. ArtifactDeploymentStatusProperties
Artefakty Artefakty, které se mají nainstalovat na virtuální počítač. ArtifactInstallProperties[]
computeVm Vlastnosti výpočetního virtuálního počítače. ComputeVmProperties
createdByUser E-mailová adresa tvůrce virtuálního počítače. řetězec
createdByUserId Identifikátor objektu tvůrce virtuálního počítače. řetězec
createdDate Datum vytvoření virtuálního počítače. řetězec
customImageId Identifikátor vlastní image virtuálního počítače. řetězec
disallowPublicIpAddress Určuje, jestli se má virtuální počítač vytvořit bez veřejné IP adresy. Bool
environmentId ID prostředku prostředí, které obsahuje tento virtuální počítač, pokud existuje. řetězec
datum vypršení platnosti Datum vypršení platnosti virtuálního počítače řetězec
Fqdn Plně kvalifikovaný název domény virtuálního počítače. řetězec
galleryImageReference Odkaz na image Microsoft Azure Marketplace virtuálního počítače. GalleryImageReference
isAuthenticationWithSshKey Určuje, jestli tento virtuální počítač k ověřování používá klíč SSH. Bool
labSubnetName Název podsítě testovacího prostředí virtuálního počítače. řetězec
labVirtualNetworkId Identifikátor virtuální sítě testovacího prostředí virtuálního počítače. řetězec
networkInterface Vlastnosti síťového rozhraní. NetworkInterfaceProperties
poznámky Poznámky k virtuálnímu počítači. řetězec
osType Typ operačního systému virtuálního počítače. řetězec
ownerObjectId Identifikátor objektu vlastníka virtuálního počítače. řetězec
ownerUserPrincipalName Hlavní název uživatele vlastníka virtuálního počítače. řetězec
heslo Heslo správce virtuálního počítače. řetězec
provisioningState Stav zřizování prostředku. řetězec
velikost Velikost virtuálního počítače. řetězec
sshKey Klíč SSH správce virtuálního počítače. řetězec
storageType Typ úložiště, který se má použít pro virtuální počítač (tj. Standard, Premium). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
userName Uživatelské jméno virtuálního počítače. řetězec
virtualMachineCreationSource Řekne zdroj vytvoření virtuálního počítače testovacího prostředí. Pouze výstupní vlastnost. FromCustomImage
FromGalleryImage

Microsoft.DevTestLab/labs/virtualmachines

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
Jméno Název prostředku string (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: testovací prostředí
vlastnosti Vlastnosti prostředku. LabVirtualMachineProperties (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Jméno Popis Hodnota
dnsName Název DNS. řetězec
privateIpAddress Privátní IP adresa. řetězec
publicIpAddress Veřejná IP adresa. řetězec
publicIpAddressId ID prostředku veřejné IP adresy. řetězec
rdpAuthority Vlastnost RdpAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro protokol RDP (Remote Desktop Protocol). řetězec
sharedPublicIpAddressConfiguration Konfigurace pro sdílení veřejné IP adresy napříč několika virtuálními počítači. SharedPublicIpAddressConfiguration
sshAuthority Vlastnost SshAuthority je název hostitele DNS serveru nebo IP adresa následované číslem portu služby pro SSH. řetězec
subnetId ID prostředku sub net. řetězec
virtualNetworkId ID prostředku virtuální sítě. řetězec

NotificationSettings

Jméno Popis Hodnota
stav Pokud jsou pro tento plán povolená oznámení (tj. Povoleno, Zakázáno). Zakázáno
Povoleno
timeInMinutes Čas v minutách před událostí, ve které se oznámení odešle. Int
webhookUrl Adresa URL webhooku, na kterou se oznámení odešle. řetězec

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Značky prostředků

Jméno Popis Hodnota

Naplánovat

Jméno Popis Hodnota
umístění Umístění prostředku. řetězec
vlastnosti Vlastnosti prostředku. ScheduleProperties (povinné)
visačky Značky prostředku. značky prostředků

ScheduleProperties

Jméno Popis Hodnota
dailyRecurrence Pokud plán nastane jednou denně v týdnu, zadejte denní opakování. DayDetails
hourlyRecurrence Pokud bude plán probíhat vícekrát denně, zadejte hodinové opakování. HourDetails
notificationSettings Nastavení oznámení NotificationSettings
provisioningState Stav zřizování prostředku. řetězec
stav Stav plánu (tj. Povoleno, Zakázáno) Zakázáno
Povoleno
targetResourceId ID prostředku, do kterého plán patří řetězec
taskType Typ úkolu plánu (např. LabVmsShutdownTask, LabVmAutoStart). řetězec
timeZoneId ID časového pásma (např. Tichomoří (běžný čas). řetězec
uniqueIdentifier Jedinečný neměnný identifikátor prostředku (GUID). řetězec
týdennírecurrence Pokud bude plán probíhat pouze v některých dnech v týdnu, zadejte týdenní opakování. WeekDetails

SharedPublicIpAddressConfiguration

Jméno Popis Hodnota
inboundNatRules Příchozí pravidla překladu adres (NAT) příchozíNatRule []

WeekDetails

Jméno Popis Hodnota
Čas Nastane čas v den, kdy bude plán probíhat. řetězec
všední dny Dny v týdnu, pro které je plán nastavený (např. neděle, pondělí, úterý atd.). string[]