Delen via

Virtual Machines - List

Service:
Dev Test Labs
API-versie:
2018-09-15

Een lijst weergeven van virtuele machines in een bepaald lab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines?api-version=2018-09-15
Met optionele parameters: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines?api-version=2018-09-15&$expand={$expand}&$filter={$filter}&$top={$top}&$orderby={$orderby}

URI-parameters

Name In Vereist Type Description
labName
 path True

string

De naam van het lab.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId
 path True

string

minLength: 1

De id van het doelabonnement.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
$expand
 query

string

Geef de $expand-query op. Voorbeeld: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'
$filter
 query

string

Het filter dat moet worden toegepast op de bewerking. Voorbeeld: '$filter=contains(name,'myName')
$orderby
 query

string

De volgorde-expressie voor de resultaten met behulp van OData-notatie. Voorbeeld: '$orderby=name desc'
$top
 query

integer (int32)

Het maximum aantal resources dat moet worden geretourneerd door de bewerking. Voorbeeld: '$top=10'

Antwoorden

Name Type Description
200 OK

LabVirtualMachineList

De Azure-bewerking is voltooid.
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

VirtualMachines_List

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines?api-version=2018-09-15

Voorbeeldrespons

Statuscode:
200 
{
  "value": [
    {
      "name": "{vmName}",
      "type": "Microsoft.DevTestLab/labs/virtualMachines",
      "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/virtualmachines/{vmName}",
      "location": "{location}",
      "properties": {
        "allowClaim": true,
        "artifactDeploymentStatus": {
          "artifactsApplied": 0,
          "totalArtifacts": 0
        },
        "computeId": "/subscriptions/{subscriptionId}/resourceGroups/{labName}-{vmName}-{randomSuffix}/providers/Microsoft.Compute/virtualMachines/{vmName}",
        "createdByUser": "",
        "createdByUserId": "",
        "createdDate": "2018-10-01T16:53:02.4830866-07:00",
        "dataDiskParameters": [],
        "disallowPublicIpAddress": true,
        "galleryImageReference": {
          "offer": "UbuntuServer",
          "osType": "Linux",
          "publisher": "Canonical",
          "sku": "16.04-LTS",
          "version": "Latest"
        },
        "labSubnetName": "{virtualNetworkName}Subnet",
        "labVirtualNetworkId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/virtualnetworks/{virtualNetworkName}",
        "networkInterface": {},
        "osType": "Linux",
        "ownerObjectId": "",
        "ownerUserPrincipalName": "",
        "provisioningState": "Succeeded",
        "size": "Standard_A2_v2",
        "storageType": "Standard",
        "uniqueIdentifier": "{uniqueIdentifier}",
        "userName": "{userName}",
        "virtualMachineCreationSource": "FromGalleryImage"
      },
      "tags": {
        "tagName1": "tagValue1"
      }
    }
  ]
}

Definities

Name Description
ApplicableSchedule

Schema's die van toepassing zijn op een virtuele machine. De planningen zijn mogelijk gedefinieerd op een VIRTUELE machine of op labniveau.
ArtifactDeploymentStatusProperties

Eigenschappen van een artefactimplementatie.
ArtifactInstallProperties

Eigenschappen van een artefact.
ArtifactParameterProperties

Eigenschappen van een artefactparameter.
AttachNewDataDiskOptions

Eigenschappen voor het koppelen van een nieuwe schijf aan de virtuele machine.
ComputeDataDisk

Een gegevensschijven die zijn gekoppeld aan een virtuele machine.
ComputeVmInstanceViewStatus

Statusinformatie over een virtuele machine.
ComputeVmProperties

Eigenschappen van een virtuele machine die wordt geretourneerd door de Microsoft.Compute-API.
DataDiskProperties

Aanvraagbody voor het toevoegen van een nieuwe of bestaande gegevensschijf aan een virtuele machine.
DayDetails

Eigenschappen van een dagelijkse planning.
EnableStatus

Geeft aan of de artefactbron is ingeschakeld (waarden: Ingeschakeld, Uitgeschakeld).
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
GalleryImageReference

De referentie-informatie voor een Azure Marketplace-installatiekopieën.
HostCachingOptions

Cacheoptie voor een gegevensschijf (bijvoorbeeld Geen, ReadOnly, ReadWrite).
HourDetails

Eigenschappen van een uurschema.
InboundNatRule

Een regel voor NAT: de poort van een virtuele machine (backendPort) wordt weergegeven op het openbare IP-adres met behulp van een load balancer.
LabVirtualMachine

Een virtuele machine.
LabVirtualMachineList

Het antwoord van een lijstbewerking.
NetworkInterfaceProperties

Eigenschappen van een netwerkinterface.
NotificationSettings

Meldingsinstellingen voor een planning.
Schedule

Een schema.
ScheduleCreationParameter

Eigenschappen voor het maken van een planning.
SharedPublicIpAddressConfiguration

Eigenschappen van een virtuele machine die bepalen hoe deze is verbonden met een load balancer.
StorageType

Het opslagtype voor de schijf (bijvoorbeeld Standard, Premium).
TransportProtocol

Het transportprotocol voor het eindpunt.
VirtualMachineCreationSource

Geeft de bron aan van het maken van een virtuele labmachine. Alleen uitvoereigenschap.
WeekDetails

Eigenschappen van een wekelijks schema.

ApplicableSchedule

Object

Schema's die van toepassing zijn op een virtuele machine. De planningen zijn mogelijk gedefinieerd op een VIRTUELE machine of op labniveau.

Name Type Description
id

string

De id van de resource.
location

string

De locatie van de resource.
name

string

De naam van de resource.
properties.labVmsShutdown

Schedule

Het schema voor automatisch afsluiten, als er een is ingesteld op het niveau van de lab- of labresource.
properties.labVmsStartup

Schedule

Het schema voor automatisch opstarten, als er een is ingesteld op het niveau van de lab- of labresource.
tags

object

De tags van de resource.
type

string

Het type resource.

ArtifactDeploymentStatusProperties

Object

Eigenschappen van een artefactimplementatie.

Name Type Description
artifactsApplied

integer (int32)

Het totale aantal artefacten dat is toegepast.
deploymentStatus

string

De implementatiestatus van het artefact.
totalArtifacts

integer (int32)

Het totale aantal artefacten dat voorlopig is toegepast.

ArtifactInstallProperties

Object

Eigenschappen van een artefact.

Name Type Description
artifactId

string

De id van het artefact.
artifactTitle

string

De titel van het artefact.
deploymentStatusMessage

string

Het statusbericht van de implementatie.
installTime

string (date-time)

Het tijdstip waarop het artefact wordt geïnstalleerd op de virtuele machine.
parameters

ArtifactParameterProperties[]

De parameters van het artefact.
status

string

De status van het artefact.
vmExtensionStatusMessage

string

Het statusbericht van de extensie van de virtuele machine.

ArtifactParameterProperties

Object

Eigenschappen van een artefactparameter.

Name Type Description
name

string

De naam van de artefactparameter.
value

string

De waarde van de artefactparameter.

AttachNewDataDiskOptions

Object

Eigenschappen voor het koppelen van een nieuwe schijf aan de virtuele machine.

Name Type Description
diskName

string

De naam van de schijf die moet worden gekoppeld.
diskSizeGiB

integer (int32)

Grootte van de schijf die moet worden gekoppeld in Gibibytes.
diskType

StorageType

Het opslagtype voor de schijf (bijvoorbeeld Standard, Premium).

ComputeDataDisk

Object

Een gegevensschijven die zijn gekoppeld aan een virtuele machine.

Name Type Description
diskSizeGiB

integer (int32)

Hiermee haalt u de grootte van de gegevensschijf op in GiB.
diskUri

string

Wanneer deze wordt ondersteund door een blob, is de URI van de onderliggende blob.
managedDiskId

string

Wanneer deze wordt ondersteund door een beheerde schijf, is dit de id van de rekenschijfresource.
name

string

Hiermee haalt u de naam van de gegevensschijf op.

ComputeVmInstanceViewStatus

Object

Statusinformatie over een virtuele machine.

Name Type Description
code

string

Hiermee haalt u de statuscode op.
displayStatus

string

Hiermee haalt u het korte lokaliseerbare label voor de status op.
message

string

Hiermee haalt u het bericht op dat is gekoppeld aan de status.

ComputeVmProperties

Object

Eigenschappen van een virtuele machine die wordt geretourneerd door de Microsoft.Compute-API.

Name Type Description
dataDiskIds

string[]

Hiermee haalt u de blob-URI van gegevensschijven op voor de virtuele machine.
dataDisks

ComputeDataDisk[]

Hiermee worden alle gegevensschijven opgehaald die zijn gekoppeld aan de virtuele machine.
networkInterfaceId

string

Hiermee haalt u de netwerkinterface-id van de virtuele machine op.
osDiskId

string

Hiermee haalt u de blob-URI van de besturingssysteemschijf op voor de virtuele machine.
osType

string

Hiermee haalt u het type besturingssysteem van de virtuele machine op.
statuses

ComputeVmInstanceViewStatus[]

Hiermee haalt u de statussen van de virtuele machine op.
vmSize

string

Hiermee haalt u de grootte van de virtuele machine op.

DataDiskProperties

Object

Aanvraagbody voor het toevoegen van een nieuwe of bestaande gegevensschijf aan een virtuele machine.

Name Type Description
attachNewDataDiskOptions

AttachNewDataDiskOptions

Hiermee geeft u opties voor het koppelen van een nieuwe schijf aan de virtuele machine.
existingLabDiskId

string

Hiermee geeft u de bestaande labschijf-id op die moet worden gekoppeld aan de virtuele machine.
hostCaching

HostCachingOptions

Cacheoptie voor een gegevensschijf (bijvoorbeeld Geen, ReadOnly, ReadWrite).

DayDetails

Object

Eigenschappen van een dagelijkse planning.

Name Type Description
time

string

Het tijdstip waarop de planning plaatsvindt.

EnableStatus

Inventarisatie

Geeft aan of de artefactbron is ingeschakeld (waarden: Ingeschakeld, Uitgeschakeld).

Waarde Description
Enabled
Disabled

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

GalleryImageReference

Object

De referentie-informatie voor een Azure Marketplace-installatiekopieën.

Name Type Description
offer

string

De aanbieding van de galerieafbeelding.
osType

string

Het type besturingssysteem van de galerie-installatiekopie.
publisher

string

De uitgever van de galerie-installatiekopieën.
sku

string

De SKU van de galerie-installatiekopieën.
version

string

De versie van de galerie-installatiekopieën.

HostCachingOptions

Inventarisatie

Cacheoptie voor een gegevensschijf (bijvoorbeeld Geen, ReadOnly, ReadWrite).

Waarde Description
None
ReadOnly
ReadWrite

HourDetails

Object

Eigenschappen van een uurschema.

Name Type Description
minute

integer (int32)

Minuten van het uur dat de planning wordt uitgevoerd.

InboundNatRule

Object

Een regel voor NAT: de poort van een virtuele machine (backendPort) wordt weergegeven op het openbare IP-adres met behulp van een load balancer.

Name Type Description
backendPort

integer (int32)

De poort waarnaar het externe verkeer wordt omgeleid.
frontendPort

integer (int32)

De poort van het externe eindpunt van de binnenkomende verbinding. Mogelijke waarden variëren tussen 1 en 65535, inclusief. Indien niet opgegeven, wordt automatisch een waarde toegewezen.
transportProtocol

TransportProtocol

Het transportprotocol voor het eindpunt.

LabVirtualMachine

Object

Een virtuele machine.

Name Type Default value Description
id

string

De id van de resource.
location

string

De locatie van de resource.
name

string

De naam van de resource.
properties.allowClaim

boolean

False

Geeft aan of een andere gebruiker eigenaar kan worden van de virtuele machine
properties.applicableSchedule

ApplicableSchedule

Het toepasselijke schema voor de virtuele machine.
properties.artifactDeploymentStatus

ArtifactDeploymentStatusProperties

De implementatiestatus van het artefact voor de virtuele machine.
properties.artifacts

ArtifactInstallProperties[]

De artefacten die op de virtuele machine moeten worden geïnstalleerd.
properties.computeId

string

De resource-id (Microsoft.Compute) van de virtuele machine.
properties.computeVm

ComputeVmProperties

De eigenschappen van de virtuele rekenmachine.
properties.createdByUser

string

Het e-mailadres van de maker van de virtuele machine.
properties.createdByUserId

string

De object-id van de maker van de virtuele machine.
properties.createdDate

string (date-time)

De aanmaakdatum van de virtuele machine.
properties.customImageId

string

De aangepaste installatiekopieën-id van de virtuele machine.
properties.dataDiskParameters

DataDiskProperties[]

Nieuwe of bestaande gegevensschijven die aan de virtuele machine moeten worden gekoppeld na het maken
properties.disallowPublicIpAddress

boolean

False

Hiermee wordt aangegeven of de virtuele machine moet worden gemaakt zonder een openbaar IP-adres.
properties.environmentId

string

De resource-id van de omgeving die deze virtuele machine bevat, indien van toepassing.
properties.expirationDate

string (date-time)

De vervaldatum voor de VIRTUELE machine.
properties.fqdn

string

De volledig gekwalificeerde domeinnaam van de virtuele machine.
properties.galleryImageReference

GalleryImageReference

De microsoft Azure Marketplace-installatiekopieën van de virtuele machine.
properties.isAuthenticationWithSshKey

boolean

Geeft aan of deze virtuele machine gebruikmaakt van een SSH-sleutel voor verificatie.
properties.labSubnetName

string

De naam van het labsubnet van de virtuele machine.
properties.labVirtualNetworkId

string

De id van het virtuele labnetwerk van de virtuele machine.
properties.lastKnownPowerState

string

Laatst bekende status van rekenkracht vastgelegd in DTL
properties.networkInterface

NetworkInterfaceProperties

De eigenschappen van de netwerkinterface.
properties.notes

string

De notities van de virtuele machine.
properties.osType

string

Het type besturingssysteem van de virtuele machine.
properties.ownerObjectId

string

dynamicValue

De object-id van de eigenaar van de virtuele machine.
properties.ownerUserPrincipalName

string

De principal-naam van de gebruiker van de eigenaar van de virtuele machine.
properties.password

string

Het wachtwoord van de beheerder van de virtuele machine.
properties.planId

string

De id van het plan dat is gekoppeld aan de installatiekopieën van de virtuele machine
properties.provisioningState

string

De inrichtingsstatus van de resource.
properties.scheduleParameters

ScheduleCreationParameter[]

Planningen voor virtuele machines die moeten worden gemaakt
properties.size

string

De grootte van de virtuele machine.
properties.sshKey

string

De SSH-sleutel van de beheerder van de virtuele machine.
properties.storageType

string

labStorageType

Opslagtype dat moet worden gebruikt voor virtuele machine (bijvoorbeeld Standard, Premium).
properties.uniqueIdentifier

string

De unieke onveranderbare id van een resource (GUID).
properties.userName

string

De gebruikersnaam van de virtuele machine.
properties.virtualMachineCreationSource

VirtualMachineCreationSource

Geeft de bron aan van het maken van een virtuele labmachine. Alleen uitvoereigenschap.
tags

object

De tags van de resource.
type

string

Het type resource.

LabVirtualMachineList

Object

Het antwoord van een lijstbewerking.

Name Type Description
nextLink

string (uri)

De koppeling naar de volgende pagina met items
value

LabVirtualMachine[]

De LabVirtualMachine items op deze pagina

NetworkInterfaceProperties

Object

Eigenschappen van een netwerkinterface.

Name Type Description
dnsName

string

De DNS-naam.
privateIpAddress

string

Het privé-IP-adres.
publicIpAddress

string

Het openbare IP-adres.
publicIpAddressId

string

De resource-id van het openbare IP-adres.
rdpAuthority

string

De eigenschap RdpAuthority is een DNS-hostnaam of IP-adres van de server, gevolgd door het servicepoortnummer voor RDP (Remote Desktop Protocol).
sharedPublicIpAddressConfiguration

SharedPublicIpAddressConfiguration

De configuratie voor het delen van een openbaar IP-adres op meerdere virtuele machines.
sshAuthority

string

De eigenschap SshAuthority is een DNS-hostnaam of IP-adres van de server, gevolgd door het servicepoortnummer voor SSH.
subnetId

string

De resource-id van het subnet.
virtualNetworkId

string

De resource-id van het virtuele netwerk.

NotificationSettings

Object

Meldingsinstellingen voor een planning.

Name Type Default value Description
emailRecipient

string

De e-mailontvanger waar meldingen naar worden verzonden (kan een lijst met door puntkomma's gescheiden e-mailadressen zijn).
notificationLocale

string

De landinstelling die moet worden gebruikt bij het verzenden van een melding (terugval voor niet-ondersteunde talen is EN).
status

EnableStatus

Disabled

Als meldingen zijn ingeschakeld voor dit schema (bijvoorbeeld Ingeschakeld, Uitgeschakeld).
timeInMinutes

integer (int32)

Tijd in minuten vóór de gebeurtenis waarop een melding wordt verzonden.
webhookUrl

string

De webhook-URL waarnaar de melding wordt verzonden.

Schedule

Object

Een schema.

Name Type Default value Description
id

string

De id van de resource.
location

string

De locatie van de resource.
name

string

De naam van de resource.
properties.createdDate

string (date-time)

De aanmaakdatum van de planning.
properties.dailyRecurrence

DayDetails

Als de planning eenmaal per dag van de week plaatsvindt, geeft u het dagelijkse terugkeerpatroon op.
properties.hourlyRecurrence

HourDetails

Als het schema meerdere keren per dag plaatsvindt, geeft u het terugkeerpatroon per uur op.
properties.notificationSettings

NotificationSettings

Meldingsinstellingen.
properties.provisioningState

string

De inrichtingsstatus van de resource.
properties.status

EnableStatus

Disabled

De status van het schema (bijvoorbeeld Ingeschakeld, Uitgeschakeld)
properties.targetResourceId

string

De resource-id waartoe de planning behoort
properties.taskType

string

Het taaktype van de planning (bijvoorbeeld LabVmsShutdownTask, LabVmAutoStart).
properties.timeZoneId

string

De tijdzone-id (bijvoorbeeld China Standard Time, Groenland Standaardtijd, Pacific Standard Time, enz.). De mogelijke waarden voor deze eigenschap vindt u in IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)
properties.uniqueIdentifier

string

De unieke onveranderbare id van een resource (GUID).
properties.weeklyRecurrence

WeekDetails

Als de planning slechts enkele dagen van de week plaatsvindt, geeft u het wekelijkse terugkeerpatroon op.
tags

object

De tags van de resource.
type

string

Het type resource.

ScheduleCreationParameter

Object

Eigenschappen voor het maken van een planning.

Name Type Default value Description
location

string

De locatie van de nieuwe virtuele machine of omgeving
name

string

De naam van de virtuele machine of omgeving
properties.dailyRecurrence

DayDetails

Als de planning eenmaal per dag van de week plaatsvindt, geeft u het dagelijkse terugkeerpatroon op.
properties.hourlyRecurrence

HourDetails

Als het schema meerdere keren per dag plaatsvindt, geeft u het terugkeerpatroon per uur op.
properties.notificationSettings

NotificationSettings

Meldingsinstellingen.
properties.status

EnableStatus

Disabled

De status van het schema (bijvoorbeeld Ingeschakeld, Uitgeschakeld)
properties.targetResourceId

string

De resource-id waartoe de planning behoort
properties.taskType

string

Het taaktype van de planning (bijvoorbeeld LabVmsShutdownTask, LabVmAutoStart).
properties.timeZoneId

string

De tijdzone-id (bijvoorbeeld China Standard Time, Groenland Standaardtijd, Pacific Standard Time, enz.). De mogelijke waarden voor deze eigenschap vindt u in IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)
properties.weeklyRecurrence

WeekDetails

Als de planning slechts enkele dagen van de week plaatsvindt, geeft u het wekelijkse terugkeerpatroon op.
tags

object

De tags van de resource.

SharedPublicIpAddressConfiguration

Object

Eigenschappen van een virtuele machine die bepalen hoe deze is verbonden met een load balancer.

Name Type Description
inboundNatRules

InboundNatRule[]

De binnenkomende NAT-regels

StorageType

Inventarisatie

Het opslagtype voor de schijf (bijvoorbeeld Standard, Premium).

Waarde Description
Standard
Premium
StandardSSD

TransportProtocol

Inventarisatie

Het transportprotocol voor het eindpunt.

Waarde Description
Tcp
Udp

VirtualMachineCreationSource

Inventarisatie

Geeft de bron aan van het maken van een virtuele labmachine. Alleen uitvoereigenschap.

Waarde Description
FromCustomImage
FromGalleryImage
FromSharedGalleryImage

WeekDetails

Object

Eigenschappen van een wekelijks schema.

Name Type Description
time

string

Het tijdstip van de dag waarop de planning plaatsvindt.
weekdays

string[]

De dagen van de week waarvoor de planning is ingesteld (bijvoorbeeld zondag, maandag, dinsdag, enzovoort).