Share via


Virtual Machines - List

Belirli bir laboratuvardaki sanal makineleri listeleme.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
labName
path True

string

Laboratuvarın adı.

resourceGroupName
path True

string

Kaynak grubunun adı.

subscriptionId
path True

string

Abonelik kimliği.

api-version
query True

string

İstemci API sürümü.

$expand
query

string

$expand sorgusunu belirtin. Örnek: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'

$filter
query

string

İşleme uygulanacak filtre. Örnek: '$filter=contains(name,'myName')

$orderby
query

string

OData gösterimi kullanılarak sonuçların sıralama ifadesi. Örnek: '$orderby=name desc'

$top
query

integer

int32

İşlemden döndürülecek kaynak sayısı üst sınırı. Örnek: '$top=10'

Yanıtlar

Name Tür Description
200 OK

LabVirtualMachineList

Tamam

Other Status Codes

CloudError

BadRequest

Güvenlik

azure_auth

OAuth2 Örtük Verme

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Microsoft Azure'a erişme

Örnekler

VirtualMachines_List

Sample Request

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

Sample Response

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

Tanımlar

Name Description
ApplicableSchedule

Bir sanal makine için geçerli zamanlamalar. Zamanlamalar bir VM'de veya laboratuvar düzeyinde tanımlanmış olabilir.

ArtifactDeploymentStatusProperties

Yapıt dağıtımının özellikleri.

ArtifactInstallProperties

Yapıtın özellikleri.

ArtifactParameterProperties

Yapıt parametresinin özellikleri.

AttachNewDataDiskOptions

Sanal Makineye yeni disk eklemek için özellikler.

CloudError

REST isteğinden kaynaklanan hata.

CloudErrorBody

REST isteğinden gelen hatanın gövdesi.

ComputeDataDisk

Sanal makineye bağlı veri diskleri.

ComputeVmInstanceViewStatus

Sanal makine hakkındaki durum bilgileri.

ComputeVmProperties

Microsoft.Compute API tarafından döndürülen bir sanal makinenin özellikleri.

DataDiskProperties

Sanal makineye yeni veya mevcut bir veri diski eklemek için istek gövdesi.

DayDetails

Günlük zamanlamanın özellikleri.

EnableStatus

Zamanlamanın durumu (etkin, devre dışı)

GalleryImageReference

bir Azure Market görüntüsünün başvuru bilgileri.

HostCachingOptions

Veri diski için önbelleğe alma seçeneği (yok, Salt Okunur, Okuma Yazma).

HourDetails

Saatlik zamanlamanın özellikleri.

InboundNatRule

NAT kuralı: Yük dengeleyici kullanarak genel IP adresinde vm'nin bağlantı noktasını (backendPort) kullanıma açma.

LabVirtualMachine

Bir sanal makine.

LabVirtualMachineList

Liste işleminin yanıtı.

NetworkInterfaceProperties

Ağ arabiriminin özellikleri.

NotificationSettings

Zamanlama için bildirim ayarları.

Schedule

Bir zamanlama.

ScheduleCreationParameter

Zamanlama oluşturma özellikleri.

SharedPublicIpAddressConfiguration

Yük dengeleyiciye nasıl bağlandığını belirleyen bir sanal makinenin özellikleri.

StorageType

Diskin depolama türü (standart, Premium gibi).

TransportProtocol

Uç nokta için aktarım protokolü.

VirtualMachineCreationSource

Laboratuvar sanal makinesi oluşturma kaynağını bildirir. Yalnızca output özelliği.

WeekDetails

Haftalık zamanlamanın özellikleri.

ApplicableSchedule

Bir sanal makine için geçerli zamanlamalar. Zamanlamalar bir VM'de veya laboratuvar düzeyinde tanımlanmış olabilir.

Name Tür Description
id

string

Kaynağın tanımlayıcısı.

location

string

Kaynağın konumu.

name

string

Kaynağın adı.

properties.labVmsShutdown

Schedule

Laboratuvar veya laboratuvar kaynak düzeyinde ayarlanmışsa otomatik kapatma zamanlaması.

properties.labVmsStartup

Schedule

Laboratuvar veya laboratuvar kaynak düzeyinde ayarlanmışsa otomatik başlatma zamanlaması.

tags

object

Kaynağın etiketleri.

type

string

Kaynağın türü.

ArtifactDeploymentStatusProperties

Yapıt dağıtımının özellikleri.

Name Tür Description
artifactsApplied

integer

Başarıyla uygulanan yapıtların toplam sayısı.

deploymentStatus

string

Yapıtın dağıtım durumu.

totalArtifacts

integer

Kesin olmayan şekilde uygulanan yapıtların toplam sayısı.

ArtifactInstallProperties

Yapıtın özellikleri.

Name Tür Description
artifactId

string

Yapıtın tanımlayıcısı.

artifactTitle

string

Yapıtın başlığı.

deploymentStatusMessage

string

Dağıtımdan gelen durum iletisi.

installTime

string

Yapıtın sanal makineye yüklenmeye başladığı zaman.

parameters

ArtifactParameterProperties[]

Yapıtın parametreleri.

status

string

Yapıtın durumu.

vmExtensionStatusMessage

string

Sanal makine uzantısından gelen durum iletisi.

ArtifactParameterProperties

Yapıt parametresinin özellikleri.

Name Tür Description
name

string

Yapıt parametresinin adı.

value

string

Yapıt parametresinin değeri.

AttachNewDataDiskOptions

Sanal Makineye yeni disk eklemek için özellikler.

Name Tür Description
diskName

string

Eklenecek diskin adı.

diskSizeGiB

integer

Gibibayt cinsinden eklenecek diskin boyutu.

diskType

StorageType

Diskin depolama türü (standart, Premium gibi).

CloudError

REST isteğinden kaynaklanan hata.

Name Tür Description
error

CloudErrorBody

Oluşan bulut hatası

CloudErrorBody

REST isteğinden gelen hatanın gövdesi.

Name Tür Description
code

string

Hata kodu.

details

CloudErrorBody[]

İç hatalar.

message

string

Hata iletisi.

target

string

Hata hedefi.

ComputeDataDisk

Sanal makineye bağlı veri diskleri.

Name Tür Description
diskSizeGiB

integer

GiB'de veri diski boyutunu alır.

diskUri

string

Bir blob tarafından yedeklendiğinde, temel blobun URI'si.

managedDiskId

string

Yönetilen disk tarafından yedeklendiğinde, bu işlem diski kaynağının kimliğidir.

name

string

Veri diski adını alır.

ComputeVmInstanceViewStatus

Sanal makine hakkındaki durum bilgileri.

Name Tür Description
code

string

Durum Kodunu alır.

displayStatus

string

Durum için kısa yerelleştirilebilir etiketi alır.

message

string

Durumla ilişkili iletiyi alır.

ComputeVmProperties

Microsoft.Compute API tarafından döndürülen bir sanal makinenin özellikleri.

Name Tür Description
dataDiskIds

string[]

Sanal makine için veri diskleri blob uri'sini alır.

dataDisks

ComputeDataDisk[]

Sanal makineye bağlı tüm veri disklerini alır.

networkInterfaceId

string

Sanal makinenin ağ arabirimi kimliğini alır.

osDiskId

string

Sanal makine için işletim sistemi disk blobu uri'sini alır.

osType

string

Sanal makinenin işletim sistemi türünü alır.

statuses

ComputeVmInstanceViewStatus[]

Sanal makinenin durumlarını alır.

vmSize

string

Sanal makinenin boyutunu alır.

DataDiskProperties

Sanal makineye yeni veya mevcut bir veri diski eklemek için istek gövdesi.

Name Tür Description
attachNewDataDiskOptions

AttachNewDataDiskOptions

Sanal makineye yeni disk ekleme seçeneklerini belirtir.

existingLabDiskId

string

Sanal makineye eklenecek mevcut laboratuvar disk kimliğini belirtir.

hostCaching

HostCachingOptions

Veri diski için önbelleğe alma seçeneği (yok, Salt Okunur, Okuma Yazma).

DayDetails

Günlük zamanlamanın özellikleri.

Name Tür Description
time

string

Zamanlamanın oluşacağı günün saati.

EnableStatus

Zamanlamanın durumu (etkin, devre dışı)

Name Tür Description
Disabled

string

Enabled

string

GalleryImageReference

bir Azure Market görüntüsünün başvuru bilgileri.

Name Tür Description
offer

string

Galeri görüntüsünün teklifi.

osType

string

Galeri görüntüsünün işletim sistemi türü.

publisher

string

Galeri görüntüsünün yayımcısı.

sku

string

Galeri görüntüsünün SKU'su.

version

string

Galeri görüntüsünün sürümü.

HostCachingOptions

Veri diski için önbelleğe alma seçeneği (yok, Salt Okunur, Okuma Yazma).

Name Tür Description
None

string

ReadOnly

string

ReadWrite

string

HourDetails

Saatlik zamanlamanın özellikleri.

Name Tür Description
minute

integer

Zamanlamanın çalıştırılacağı saatin dakika sayısı.

InboundNatRule

NAT kuralı: Yük dengeleyici kullanarak genel IP adresinde vm'nin bağlantı noktasını (backendPort) kullanıma açma.

Name Tür Description
backendPort

integer

Dış trafiğin yeniden yönlendirileceği bağlantı noktası.

frontendPort

integer

Gelen bağlantının dış uç nokta bağlantı noktası. Olası değerler 1 ile 65535 (dahil) arasında değişir. Belirtilmemişse, bir değer otomatik olarak ayrılır.

transportProtocol

TransportProtocol

Uç nokta için aktarım protokolü.

LabVirtualMachine

Bir sanal makine.

Name Tür Varsayılan değer Description
id

string

Kaynağın tanımlayıcısı.

location

string

Kaynağın konumu.

name

string

Kaynağın adı.

properties.allowClaim

boolean

False

Başka bir kullanıcının sanal makinenin sahipliğini alıp alamayacağını gösterir

properties.applicableSchedule

ApplicableSchedule

Sanal makine için geçerli zamanlama.

properties.artifactDeploymentStatus

ArtifactDeploymentStatusProperties

Sanal makine için yapıt dağıtım durumu.

properties.artifacts

ArtifactInstallProperties[]

Sanal makineye yüklenecek yapıtlar.

properties.computeId

string

Sanal makinenin kaynak tanımlayıcısı (Microsoft.Compute).

properties.computeVm

ComputeVmProperties

İşlem sanal makinesi özellikleri.

properties.createdByUser

string

Sanal makineyi oluşturanın e-posta adresi.

properties.createdByUserId

string

Sanal makineyi oluşturanın nesne tanımlayıcısı.

properties.createdDate

string

Sanal makinenin oluşturulma tarihi.

properties.customImageId

string

Sanal makinenin özel görüntü tanımlayıcısı.

properties.dataDiskParameters

DataDiskProperties[]

Oluşturulduktan sonra sanal makineye eklenecek yeni veya mevcut veri diskleri

properties.disallowPublicIpAddress

boolean

False

Sanal makinenin genel IP adresi olmadan oluşturulup oluşturulmayacağını gösterir.

properties.environmentId

string

Varsa, bu sanal makineyi içeren ortamın kaynak kimliği.

properties.expirationDate

string

VM'nin sona erme tarihi.

properties.fqdn

string

Sanal makinenin tam etki alanı adı.

properties.galleryImageReference

GalleryImageReference

Sanal makinenin Microsoft Azure Market görüntü başvurusu.

properties.isAuthenticationWithSshKey

boolean

Bu sanal makinenin kimlik doğrulaması için bir SSH anahtarı kullanıp kullanmadığını gösterir.

properties.labSubnetName

string

Sanal makinenin laboratuvar alt ağı adı.

properties.labVirtualNetworkId

string

Sanal makinenin laboratuvar sanal ağ tanımlayıcısı.

properties.lastKnownPowerState

string

DTL'de yakalanan bilinen son işlem gücü durumu

properties.networkInterface

NetworkInterfaceProperties

Ağ arabirimi özellikleri.

properties.notes

string

Sanal makinenin notları.

properties.osType

string

Sanal makinenin işletim sistemi türü.

properties.ownerObjectId

string

dynamicValue

Sanal makinenin sahibinin nesne tanımlayıcısı.

properties.ownerUserPrincipalName

string

Sanal makine sahibinin kullanıcı asıl adı.

properties.password

string

Sanal makine yöneticisinin parolası.

properties.planId

string

Sanal makine görüntüsüyle ilişkili planın kimliği

properties.provisioningState

string

Kaynağın sağlama durumu.

properties.scheduleParameters

ScheduleCreationParameter[]

Oluşturulacak Sanal Makine zamanlamaları

properties.size

string

Sanal makinenin boyutu.

properties.sshKey

string

Sanal makine yöneticisinin SSH anahtarı.

properties.storageType

string

labStorageType

Sanal makine için kullanılacak depolama türü (standart, Premium gibi).

properties.uniqueIdentifier

string

Kaynağın benzersiz sabit tanımlayıcısı (Guid).

properties.userName

string

Sanal makinenin kullanıcı adı.

properties.virtualMachineCreationSource

VirtualMachineCreationSource

Laboratuvar sanal makinesi oluşturma kaynağını bildirir. Yalnızca output özelliği.

tags

object

Kaynağın etiketleri.

type

string

Kaynağın türü.

LabVirtualMachineList

Liste işleminin yanıtı.

Name Tür Description
nextLink

string

Sonraki sonuç kümesinin bağlantısı.

value

LabVirtualMachine[]

Liste işleminin sonuçları.

NetworkInterfaceProperties

Ağ arabiriminin özellikleri.

Name Tür Description
dnsName

string

DNS adı.

privateIpAddress

string

Özel IP adresi.

publicIpAddress

string

Genel IP adresi.

publicIpAddressId

string

Genel IP adresinin kaynak kimliği.

rdpAuthority

string

RdpAuthority özelliği bir sunucu DNS ana bilgisayar adı veya IP adresi ve ardından RDP için hizmet bağlantı noktası numarasıdır (Uzak Masaüstü Protokolü).

sharedPublicIpAddressConfiguration

SharedPublicIpAddressConfiguration

Genel IP adresini birden çok sanal makine arasında paylaşma yapılandırması.

sshAuthority

string

SshAuthority özelliği bir sunucu DNS ana bilgisayar adı veya IP adresi ve ardından SSH için hizmet bağlantı noktası numarasıdır.

subnetId

string

Alt ağın kaynak kimliği.

virtualNetworkId

string

Sanal ağın kaynak kimliği.

NotificationSettings

Zamanlama için bildirim ayarları.

Name Tür Varsayılan değer Description
emailRecipient

string

Bildirim gönderilecek e-posta alıcısı (noktalı virgülle ayrılmış e-posta adreslerinin listesi olabilir).

notificationLocale

string

Bildirim gönderirken kullanılacak yerel ayar (desteklenmeyen diller için geri dönüş EN'dir).

status

EnableStatus

Disabled

Bu zamanlama için bildirimler etkinleştirildiyse (etkin, devre dışı).

timeInMinutes

integer

Bildirimin gönderileceği olaydan birkaç dakika önce.

webhookUrl

string

Bildirimin gönderileceği web kancası URL'si.

Schedule

Bir zamanlama.

Name Tür Varsayılan değer Description
id

string

Kaynağın tanımlayıcısı.

location

string

Kaynağın konumu.

name

string

Kaynağın adı.

properties.createdDate

string

Zamanlamanın oluşturulma tarihi.

properties.dailyRecurrence

DayDetails

Zamanlama haftanın her günü bir kez gerçekleşecekse, günlük yinelenmeyi belirtin.

properties.hourlyRecurrence

HourDetails

Zamanlama günde birden çok kez gerçekleşecekse saatlik yinelenmeyi belirtin.

properties.notificationSettings

NotificationSettings

Bildirim ayarları.

properties.provisioningState

string

Kaynağın sağlama durumu.

properties.status

EnableStatus

Disabled

Zamanlamanın durumu (etkin, devre dışı)

properties.targetResourceId

string

Zamanlamanın ait olduğu kaynak kimliği

properties.taskType

string

Zamanlamanın görev türü (örn. LabVmsShutdownTask, LabVmAutoStart).

properties.timeZoneId

string

Saat dilimi kimliği (ör. Çin Standart Saati, Grönland Standart Saati, Pasifik Standart saati vb.). Bu özelliğin olası değerleri (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) içinde IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds bulunabilir

properties.uniqueIdentifier

string

Kaynağın benzersiz sabit tanımlayıcısı (Guid).

properties.weeklyRecurrence

WeekDetails

Zamanlama haftanın yalnızca birkaç günü gerçekleşecekse haftalık yinelenmeyi belirtin.

tags

object

Kaynağın etiketleri.

type

string

Kaynağın türü.

ScheduleCreationParameter

Zamanlama oluşturma özellikleri.

Name Tür Varsayılan değer Description
location

string

Yeni sanal makinenin veya ortamın konumu

name

string

Sanal makinenin veya ortamın adı

properties.dailyRecurrence

DayDetails

Zamanlama haftanın her günü bir kez gerçekleşecekse, günlük yinelenmeyi belirtin.

properties.hourlyRecurrence

HourDetails

Zamanlama günde birden çok kez gerçekleşecekse saatlik yinelenmeyi belirtin.

properties.notificationSettings

NotificationSettings

Bildirim ayarları.

properties.status

EnableStatus

Disabled

Zamanlamanın durumu (etkin, devre dışı)

properties.targetResourceId

string

Zamanlamanın ait olduğu kaynak kimliği

properties.taskType

string

Zamanlamanın görev türü (örn. LabVmsShutdownTask, LabVmAutoStart).

properties.timeZoneId

string

Saat dilimi kimliği (ör. Çin Standart Saati, Grönland Standart Saati, Pasifik Standart saati vb.). Bu özelliğin olası değerleri (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) içinde IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds bulunabilir

properties.weeklyRecurrence

WeekDetails

Zamanlama haftanın yalnızca birkaç günü gerçekleşecekse haftalık yinelenmeyi belirtin.

tags

object

Kaynağın etiketleri.

SharedPublicIpAddressConfiguration

Yük dengeleyiciye nasıl bağlandığını belirleyen bir sanal makinenin özellikleri.

Name Tür Description
inboundNatRules

InboundNatRule[]

Gelen NAT kuralları

StorageType

Diskin depolama türü (standart, Premium gibi).

Name Tür Description
Premium

string

Standard

string

StandardSSD

string

TransportProtocol

Uç nokta için aktarım protokolü.

Name Tür Description
Tcp

string

Udp

string

VirtualMachineCreationSource

Laboratuvar sanal makinesi oluşturma kaynağını bildirir. Yalnızca output özelliği.

Name Tür Description
FromCustomImage

string

FromGalleryImage

string

FromSharedGalleryImage

string

WeekDetails

Haftalık zamanlamanın özellikleri.

Name Tür Description
time

string

Zamanlamanın gerçekleşeceği günün saati.

weekdays

string[]

Zamanlamanın ayarlandığı haftanın günleri (örneğin, Pazar, Pazartesi, Salı vb.).