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 |
---|---|---|---|---|
lab
|
path | True |
string |
Laboratuvarın adı. |
resource
|
path | True |
string |
Kaynak grubunun adı. |
subscription
|
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 |
Tamam |
|
Other Status Codes |
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
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 |
---|---|
Applicable |
Bir sanal makine için geçerli zamanlamalar. Zamanlamalar bir VM'de veya laboratuvar düzeyinde tanımlanmış olabilir. |
Artifact |
Yapıt dağıtımının özellikleri. |
Artifact |
Yapıtın özellikleri. |
Artifact |
Yapıt parametresinin özellikleri. |
Attach |
Sanal Makineye yeni disk eklemek için özellikler. |
Cloud |
REST isteğinden kaynaklanan hata. |
Cloud |
REST isteğinden gelen hatanın gövdesi. |
Compute |
Sanal makineye bağlı veri diskleri. |
Compute |
Sanal makine hakkındaki durum bilgileri. |
Compute |
Microsoft.Compute API tarafından döndürülen bir sanal makinenin özellikleri. |
Data |
Sanal makineye yeni veya mevcut bir veri diski eklemek için istek gövdesi. |
Day |
Günlük zamanlamanın özellikleri. |
Enable |
Zamanlamanın durumu (etkin, devre dışı) |
Gallery |
bir Azure Market görüntüsünün başvuru bilgileri. |
Host |
Veri diski için önbelleğe alma seçeneği (yok, Salt Okunur, Okuma Yazma). |
Hour |
Saatlik zamanlamanın özellikleri. |
Inbound |
NAT kuralı: Yük dengeleyici kullanarak genel IP adresinde vm'nin bağlantı noktasını (backendPort) kullanıma açma. |
Lab |
Bir sanal makine. |
Lab |
Liste işleminin yanıtı. |
Network |
Ağ arabiriminin özellikleri. |
Notification |
Zamanlama için bildirim ayarları. |
Schedule |
Bir zamanlama. |
Schedule |
Zamanlama oluşturma özellikleri. |
Shared |
Yük dengeleyiciye nasıl bağlandığını belirleyen bir sanal makinenin özellikleri. |
Storage |
Diskin depolama türü (standart, Premium gibi). |
Transport |
Uç nokta için aktarım protokolü. |
Virtual |
Laboratuvar sanal makinesi oluşturma kaynağını bildirir. Yalnızca output özelliği. |
Week |
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 |
Laboratuvar veya laboratuvar kaynak düzeyinde ayarlanmışsa otomatik kapatma zamanlaması. |
|
properties.labVmsStartup |
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 |
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 |
Diskin depolama türü (standart, Premium gibi). |
CloudError
REST isteğinden kaynaklanan hata.
Name | Tür | Description |
---|---|---|
error |
Oluşan bulut hatası |
CloudErrorBody
REST isteğinden gelen hatanın gövdesi.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
details |
İç 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 |
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 |
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 |
Sanal makineye yeni disk ekleme seçeneklerini belirtir. |
|
existingLabDiskId |
string |
Sanal makineye eklenecek mevcut laboratuvar disk kimliğini belirtir. |
hostCaching |
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 |
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 |
Sanal makine için geçerli zamanlama. |
||
properties.artifactDeploymentStatus |
Sanal makine için yapıt dağıtım durumu. |
||
properties.artifacts |
Sanal makineye yüklenecek yapıtlar. |
||
properties.computeId |
string |
Sanal makinenin kaynak tanımlayıcısı (Microsoft.Compute). |
|
properties.computeVm |
İş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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 | 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 |
Zamanlama haftanın her günü bir kez gerçekleşecekse, günlük yinelenmeyi belirtin. |
||
properties.hourlyRecurrence |
Zamanlama günde birden çok kez gerçekleşecekse saatlik yinelenmeyi belirtin. |
||
properties.notificationSettings |
Bildirim ayarları. |
||
properties.provisioningState |
string |
Kaynağın sağlama durumu. |
|
properties.status | 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 |
|
properties.uniqueIdentifier |
string |
Kaynağın benzersiz sabit tanımlayıcısı (Guid). |
|
properties.weeklyRecurrence |
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 |
Zamanlama haftanın her günü bir kez gerçekleşecekse, günlük yinelenmeyi belirtin. |
||
properties.hourlyRecurrence |
Zamanlama günde birden çok kez gerçekleşecekse saatlik yinelenmeyi belirtin. |
||
properties.notificationSettings |
Bildirim ayarları. |
||
properties.status | 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 |
|
properties.weeklyRecurrence |
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 |
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.). |