Udostępnij za pośrednictwem

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • Artykuł

Definicja zasobu Bicep

Typ zasobu labs/virtualmachines można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

ApplicableSchedule

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ApplicableScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

ApplicableScheduleProperties

Nazwa Opis Wartość
labVmsShutdown Harmonogram automatycznego zamykania, jeśli został ustawiony na poziomie laboratorium lub zasobu laboratorium. harmonogram
labVmsStartup Harmonogram automatycznego uruchamiania, jeśli został ustawiony na poziomie zasobu laboratorium lub laboratorium. harmonogram

ArtifactDeploymentStatusProperties

Nazwa Opis Wartość
artifactsApplied Łączna liczba artefaktów, które zostały pomyślnie zastosowane. Int
deploymentStatus Stan wdrożenia artefaktu. struna
totalArtifacts Łączna liczba artefaktów, które zostały wstępnie zastosowane. Int

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. struna
deploymentStatusMessage Komunikat o stanie z wdrożenia. struna
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. struna
Parametry Parametry artefaktu. ArtifactParameterProperties[]
stan Stan artefaktu. struna
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. struna

ArtifactParameterProperties

Nazwa Opis Wartość
nazwa Nazwa parametru artefaktu. struna
wartość Wartość parametru artefaktu. struna

ComputeDataDisk

Nazwa Opis Wartość
diskSizeGiB Pobiera rozmiar dysku danych w giB. Int
diskUri Po utworzeniu kopii zapasowej przez obiekt blob identyfikator URI bazowego obiektu blob. struna
managedDiskId Po utworzeniu kopii zapasowej dysku zarządzanego jest to identyfikator zasobu dysku obliczeniowego. struna
nazwa Pobiera nazwę dysku danych. struna

ComputeVmInstanceViewStatus

Nazwa Opis Wartość
kod Pobiera kod stanu. struna
displayStatus Pobiera krótką etykietę lokalizowalny dla stanu. struna
Komunikat Pobiera komunikat skojarzony ze stanem. struna

ComputeVmProperties

Nazwa Opis Wartość
dataDiskIds Pobiera identyfikator URI obiektów blob dysków danych dla maszyny wirtualnej. string[]
dataDisks Pobiera wszystkie dyski danych dołączone do maszyny wirtualnej. ComputeDataDisk[]
networkInterfaceId Pobiera identyfikator interfejsu sieciowego maszyny wirtualnej. struna
osDiskId Pobiera identyfikator URI obiektu blob dysku systemu operacyjnego dla maszyny wirtualnej. struna
osType Pobiera typ systemu operacyjnego maszyny wirtualnej. struna
Statusy Pobiera stany maszyny wirtualnej. ComputeVmInstanceViewStatus[]
vmSize Pobiera rozmiar maszyny wirtualnej. struna

DayDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna

GalleryImageReference

Nazwa Opis Wartość
oferta Oferta obrazu galerii. struna
osType Typ systemu operacyjnego obrazu galerii. struna
wydawca Wydawca obrazu galerii. struna
Numer jednostki magazynowej Jednostka SKU obrazu galerii. struna
Wersja Wersja obrazu galerii. struna

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, w których zostanie uruchomiony harmonogram. Int

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego będzie przekierowywany ruch zewnętrzny. Int
frontonPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie. Jeśli wartość nie zostanie określona, zostanie przydzielona automatycznie. Int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej Bool
applicableSchedule Odpowiedni harmonogram dla maszyny wirtualnej. ApplicableSchedule
artifactDeploymentStatus Stan wdrożenia artefaktu dla maszyny wirtualnej. ArtifactDeploymentStatusProperties
Artefakty Artefakty, które mają zostać zainstalowane na maszynie wirtualnej. ArtifactInstallProperties[]
computeVm Właściwości maszyny wirtualnej obliczeniowej. ComputeVmProperties
createdByUser Adres e-mail twórcy maszyny wirtualnej. struna
createdByUserId Identyfikator obiektu twórcy maszyny wirtualnej. struna
createdDate Data utworzenia maszyny wirtualnej. struna
customImageId Identyfikator obrazu niestandardowego maszyny wirtualnej. struna
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. Bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. struna
data wygaśnięcia Data wygaśnięcia maszyny wirtualnej. struna
Fqdn W pełni kwalifikowana nazwa domeny maszyny wirtualnej. struna
galleryImageReference Dokumentacja obrazu witryny Microsoft Azure Marketplace maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. Bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. struna
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. struna
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Notatki Uwagi dotyczące maszyny wirtualnej. struna
osType Typ systemu operacyjnego maszyny wirtualnej. struna
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. struna
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. struna
hasło Hasło administratora maszyny wirtualnej. struna
provisioningState Stan aprowizacji zasobu. struna
rozmiar Rozmiar maszyny wirtualnej. struna
sshKey Klucz SSH administratora maszyny wirtualnej. struna
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
userName Nazwa użytkownika maszyny wirtualnej. struna
virtualMachineCreationSource Informuje źródło tworzenia maszyny wirtualnej laboratorium. Tylko właściwość wyjściowa. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
nazwa Nazwa zasobu ciąg (wymagany)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Nazwa symboliczna zasobu typu: labs
Właściwości Właściwości zasobu. LabVirtualMachineProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. struna
privateIpAddress Prywatny adres IP. struna
publicIpAddress Publiczny adres IP. struna
publicIpAddressId Identyfikator zasobu publicznego adresu IP. struna
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, a następnie numerem portu usługi dla protokołu RDP (Remote Desktop Protocol). struna
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu SSH. struna
subnetId Identyfikator zasobu podsieci. struna
virtualNetworkId Identyfikator zasobu sieci wirtualnej. struna

NotificationSettings

Nazwa Opis Wartość
stan Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Czas w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. Int
webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. struna

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Harmonogram

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

Właściwości harmonogramu

Nazwa Opis Wartość
dailyRecurrence Jeśli harmonogram będzie występować raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram będzie występować wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
provisioningState Stan aprowizacji zasobu. struna
stan Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram struna
taskType Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). struna
timeZoneId Identyfikator strefy czasowej (np. Pacyfik (czas standardowy). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
weeklyRecurrence Jeśli harmonogram będzie występować tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Przychodzące reguły NAT inboundNatRule[]

WeekDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna
Dni powszednie Dni tygodnia, dla których zaplanowano harmonogram (np. niedziela, poniedziałek, wtorek itp.). string[]

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep Opis
Tworzy laboratorium w usłudze Azure DevTest Labs z przejętą maszyną wirtualną Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab/DTL z maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla usługi Azure DevTest Labs dostępnych na stronie https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definicja zasobu szablonu usługi ARM

Typ zasobu labs/virtualmachines można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

ApplicableSchedule

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ApplicableScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

ApplicableScheduleProperties

Nazwa Opis Wartość
labVmsShutdown Harmonogram automatycznego zamykania, jeśli został ustawiony na poziomie laboratorium lub zasobu laboratorium. harmonogram
labVmsStartup Harmonogram automatycznego uruchamiania, jeśli został ustawiony na poziomie zasobu laboratorium lub laboratorium. harmonogram

ArtifactDeploymentStatusProperties

Nazwa Opis Wartość
artifactsApplied Łączna liczba artefaktów, które zostały pomyślnie zastosowane. Int
deploymentStatus Stan wdrożenia artefaktu. struna
totalArtifacts Łączna liczba artefaktów, które zostały wstępnie zastosowane. Int

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. struna
deploymentStatusMessage Komunikat o stanie z wdrożenia. struna
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. struna
Parametry Parametry artefaktu. ArtifactParameterProperties[]
stan Stan artefaktu. struna
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. struna

ArtifactParameterProperties

Nazwa Opis Wartość
nazwa Nazwa parametru artefaktu. struna
wartość Wartość parametru artefaktu. struna

ComputeDataDisk

Nazwa Opis Wartość
diskSizeGiB Pobiera rozmiar dysku danych w giB. Int
diskUri Po utworzeniu kopii zapasowej przez obiekt blob identyfikator URI bazowego obiektu blob. struna
managedDiskId Po utworzeniu kopii zapasowej dysku zarządzanego jest to identyfikator zasobu dysku obliczeniowego. struna
nazwa Pobiera nazwę dysku danych. struna

ComputeVmInstanceViewStatus

Nazwa Opis Wartość
kod Pobiera kod stanu. struna
displayStatus Pobiera krótką etykietę lokalizowalny dla stanu. struna
Komunikat Pobiera komunikat skojarzony ze stanem. struna

ComputeVmProperties

Nazwa Opis Wartość
dataDiskIds Pobiera identyfikator URI obiektów blob dysków danych dla maszyny wirtualnej. string[]
dataDisks Pobiera wszystkie dyski danych dołączone do maszyny wirtualnej. ComputeDataDisk[]
networkInterfaceId Pobiera identyfikator interfejsu sieciowego maszyny wirtualnej. struna
osDiskId Pobiera identyfikator URI obiektu blob dysku systemu operacyjnego dla maszyny wirtualnej. struna
osType Pobiera typ systemu operacyjnego maszyny wirtualnej. struna
Statusy Pobiera stany maszyny wirtualnej. ComputeVmInstanceViewStatus[]
vmSize Pobiera rozmiar maszyny wirtualnej. struna

DayDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna

GalleryImageReference

Nazwa Opis Wartość
oferta Oferta obrazu galerii. struna
osType Typ systemu operacyjnego obrazu galerii. struna
wydawca Wydawca obrazu galerii. struna
Numer jednostki magazynowej Jednostka SKU obrazu galerii. struna
Wersja Wersja obrazu galerii. struna

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, w których zostanie uruchomiony harmonogram. Int

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego będzie przekierowywany ruch zewnętrzny. Int
frontonPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie. Jeśli wartość nie zostanie określona, zostanie przydzielona automatycznie. Int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej Bool
applicableSchedule Odpowiedni harmonogram dla maszyny wirtualnej. ApplicableSchedule
artifactDeploymentStatus Stan wdrożenia artefaktu dla maszyny wirtualnej. ArtifactDeploymentStatusProperties
Artefakty Artefakty, które mają zostać zainstalowane na maszynie wirtualnej. ArtifactInstallProperties[]
computeVm Właściwości maszyny wirtualnej obliczeniowej. ComputeVmProperties
createdByUser Adres e-mail twórcy maszyny wirtualnej. struna
createdByUserId Identyfikator obiektu twórcy maszyny wirtualnej. struna
createdDate Data utworzenia maszyny wirtualnej. struna
customImageId Identyfikator obrazu niestandardowego maszyny wirtualnej. struna
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. Bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. struna
data wygaśnięcia Data wygaśnięcia maszyny wirtualnej. struna
Fqdn W pełni kwalifikowana nazwa domeny maszyny wirtualnej. struna
galleryImageReference Dokumentacja obrazu witryny Microsoft Azure Marketplace maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. Bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. struna
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. struna
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Notatki Uwagi dotyczące maszyny wirtualnej. struna
osType Typ systemu operacyjnego maszyny wirtualnej. struna
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. struna
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. struna
hasło Hasło administratora maszyny wirtualnej. struna
provisioningState Stan aprowizacji zasobu. struna
rozmiar Rozmiar maszyny wirtualnej. struna
sshKey Klucz SSH administratora maszyny wirtualnej. struna
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
userName Nazwa użytkownika maszyny wirtualnej. struna
virtualMachineCreationSource Informuje źródło tworzenia maszyny wirtualnej laboratorium. Tylko właściwość wyjściowa. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2016-05-15'
lokalizacja Lokalizacja zasobu. struna
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zasobu. LabVirtualMachineProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.DevTestLab/labs/virtualmachines"

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. struna
privateIpAddress Prywatny adres IP. struna
publicIpAddress Publiczny adres IP. struna
publicIpAddressId Identyfikator zasobu publicznego adresu IP. struna
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, a następnie numerem portu usługi dla protokołu RDP (Remote Desktop Protocol). struna
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu SSH. struna
subnetId Identyfikator zasobu podsieci. struna
virtualNetworkId Identyfikator zasobu sieci wirtualnej. struna

NotificationSettings

Nazwa Opis Wartość
stan Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Czas w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. Int
webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. struna

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Harmonogram

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

Właściwości harmonogramu

Nazwa Opis Wartość
dailyRecurrence Jeśli harmonogram będzie występować raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram będzie występować wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
provisioningState Stan aprowizacji zasobu. struna
stan Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram struna
taskType Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). struna
timeZoneId Identyfikator strefy czasowej (np. Pacyfik (czas standardowy). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
weeklyRecurrence Jeśli harmonogram będzie występować tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Przychodzące reguły NAT inboundNatRule[]

WeekDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna
Dni powszednie Dni tygodnia, dla których zaplanowano harmonogram (np. niedziela, poniedziałek, wtorek itp.). string[]

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon Opis
Tworzy laboratorium w usłudze Azure DevTest Labs z przejętą maszyną wirtualną

wdrażanie w usłudze Azure		 Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab/DTL z maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla usługi Azure DevTest Labs dostępnych na stronie https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu labs/virtualmachines można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

ApplicableSchedule

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ApplicableScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

ApplicableScheduleProperties

Nazwa Opis Wartość
labVmsShutdown Harmonogram automatycznego zamykania, jeśli został ustawiony na poziomie laboratorium lub zasobu laboratorium. harmonogram
labVmsStartup Harmonogram automatycznego uruchamiania, jeśli został ustawiony na poziomie zasobu laboratorium lub laboratorium. harmonogram

ArtifactDeploymentStatusProperties

Nazwa Opis Wartość
artifactsApplied Łączna liczba artefaktów, które zostały pomyślnie zastosowane. Int
deploymentStatus Stan wdrożenia artefaktu. struna
totalArtifacts Łączna liczba artefaktów, które zostały wstępnie zastosowane. Int

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. struna
deploymentStatusMessage Komunikat o stanie z wdrożenia. struna
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. struna
Parametry Parametry artefaktu. ArtifactParameterProperties[]
stan Stan artefaktu. struna
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. struna

ArtifactParameterProperties

Nazwa Opis Wartość
nazwa Nazwa parametru artefaktu. struna
wartość Wartość parametru artefaktu. struna

ComputeDataDisk

Nazwa Opis Wartość
diskSizeGiB Pobiera rozmiar dysku danych w giB. Int
diskUri Po utworzeniu kopii zapasowej przez obiekt blob identyfikator URI bazowego obiektu blob. struna
managedDiskId Po utworzeniu kopii zapasowej dysku zarządzanego jest to identyfikator zasobu dysku obliczeniowego. struna
nazwa Pobiera nazwę dysku danych. struna

ComputeVmInstanceViewStatus

Nazwa Opis Wartość
kod Pobiera kod stanu. struna
displayStatus Pobiera krótką etykietę lokalizowalny dla stanu. struna
Komunikat Pobiera komunikat skojarzony ze stanem. struna

ComputeVmProperties

Nazwa Opis Wartość
dataDiskIds Pobiera identyfikator URI obiektów blob dysków danych dla maszyny wirtualnej. string[]
dataDisks Pobiera wszystkie dyski danych dołączone do maszyny wirtualnej. ComputeDataDisk[]
networkInterfaceId Pobiera identyfikator interfejsu sieciowego maszyny wirtualnej. struna
osDiskId Pobiera identyfikator URI obiektu blob dysku systemu operacyjnego dla maszyny wirtualnej. struna
osType Pobiera typ systemu operacyjnego maszyny wirtualnej. struna
Statusy Pobiera stany maszyny wirtualnej. ComputeVmInstanceViewStatus[]
vmSize Pobiera rozmiar maszyny wirtualnej. struna

DayDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna

GalleryImageReference

Nazwa Opis Wartość
oferta Oferta obrazu galerii. struna
osType Typ systemu operacyjnego obrazu galerii. struna
wydawca Wydawca obrazu galerii. struna
Numer jednostki magazynowej Jednostka SKU obrazu galerii. struna
Wersja Wersja obrazu galerii. struna

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, w których zostanie uruchomiony harmonogram. Int

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego będzie przekierowywany ruch zewnętrzny. Int
frontonPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie. Jeśli wartość nie zostanie określona, zostanie przydzielona automatycznie. Int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej Bool
applicableSchedule Odpowiedni harmonogram dla maszyny wirtualnej. ApplicableSchedule
artifactDeploymentStatus Stan wdrożenia artefaktu dla maszyny wirtualnej. ArtifactDeploymentStatusProperties
Artefakty Artefakty, które mają zostać zainstalowane na maszynie wirtualnej. ArtifactInstallProperties[]
computeVm Właściwości maszyny wirtualnej obliczeniowej. ComputeVmProperties
createdByUser Adres e-mail twórcy maszyny wirtualnej. struna
createdByUserId Identyfikator obiektu twórcy maszyny wirtualnej. struna
createdDate Data utworzenia maszyny wirtualnej. struna
customImageId Identyfikator obrazu niestandardowego maszyny wirtualnej. struna
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. Bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. struna
data wygaśnięcia Data wygaśnięcia maszyny wirtualnej. struna
Fqdn W pełni kwalifikowana nazwa domeny maszyny wirtualnej. struna
galleryImageReference Dokumentacja obrazu witryny Microsoft Azure Marketplace maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. Bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. struna
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. struna
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Notatki Uwagi dotyczące maszyny wirtualnej. struna
osType Typ systemu operacyjnego maszyny wirtualnej. struna
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. struna
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. struna
hasło Hasło administratora maszyny wirtualnej. struna
provisioningState Stan aprowizacji zasobu. struna
rozmiar Rozmiar maszyny wirtualnej. struna
sshKey Klucz SSH administratora maszyny wirtualnej. struna
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
userName Nazwa użytkownika maszyny wirtualnej. struna
virtualMachineCreationSource Informuje źródło tworzenia maszyny wirtualnej laboratorium. Tylko właściwość wyjściowa. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: labs
Właściwości Właściwości zasobu. LabVirtualMachineProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. struna
privateIpAddress Prywatny adres IP. struna
publicIpAddress Publiczny adres IP. struna
publicIpAddressId Identyfikator zasobu publicznego adresu IP. struna
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, a następnie numerem portu usługi dla protokołu RDP (Remote Desktop Protocol). struna
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu SSH. struna
subnetId Identyfikator zasobu podsieci. struna
virtualNetworkId Identyfikator zasobu sieci wirtualnej. struna

NotificationSettings

Nazwa Opis Wartość
stan Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Czas w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. Int
webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. struna

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Harmonogram

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. struna
Właściwości Właściwości zasobu. ScheduleProperties (wymagane)
Tagi Tagi zasobu. ResourceTags

Właściwości harmonogramu

Nazwa Opis Wartość
dailyRecurrence Jeśli harmonogram będzie występować raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram będzie występować wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
provisioningState Stan aprowizacji zasobu. struna
stan Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram struna
taskType Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). struna
timeZoneId Identyfikator strefy czasowej (np. Pacyfik (czas standardowy). struna
uniqueIdentifier Unikatowy niezmienny identyfikator zasobu (Guid). struna
weeklyRecurrence Jeśli harmonogram będzie występować tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Przychodzące reguły NAT inboundNatRule[]

WeekDetails

Nazwa Opis Wartość
Godzina Godzina dnia, w ramach których zostanie zaplanowany harmonogram. struna
Dni powszednie Dni tygodnia, dla których zaplanowano harmonogram (np. niedziela, poniedziałek, wtorek itp.). string[]