Virtual Machines - List

特定のラボ内の仮想マシンを一覧表示します。

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 パラメーター

名前 / 必須 説明
labName
path True

string

ラボの名前。

resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

サブスクリプション ID です。

api-version
query True

string

クライアント API バージョン。

$expand
query

string

$expand クエリを指定します。 例: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'

$filter
query

string

操作に適用するフィルター。 例: '$filter=contains(name,'myName')

$orderby
query

string

OData 表記を使用した結果の順序付け式。 例: '$orderby=name desc'

$top
query

integer

int32

操作から返されるリソースの最大数。 例: '$top=10'

応答

名前 説明
200 OK

LabVirtualMachineList

OK

Other Status Codes

CloudError

BadRequest

セキュリティ

azure_auth

OAuth2 暗黙的な許可

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation Microsoft Azure にアクセスする

VirtualMachines_List

要求のサンプル

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

応答のサンプル

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

定義

名前 説明
ApplicableSchedule

仮想マシンに適用できるスケジュール。 スケジュールは、VM またはラボ レベルで定義されている可能性があります。

ArtifactDeploymentStatusProperties

成果物のデプロイのプロパティ。

ArtifactInstallProperties

成果物のプロパティ。

ArtifactParameterProperties

成果物パラメーターのプロパティ。

AttachNewDataDiskOptions

仮想マシンに新しいディスクをアタッチするためのプロパティ。

CloudError

REST 要求からのエラー。

CloudErrorBody

REST 要求からのエラーの本文。

ComputeDataDisk

仮想マシンに接続されているデータ ディスク。

ComputeVmInstanceViewStatus

仮想マシンに関する状態情報。

ComputeVmProperties

Microsoft.Compute API によって返される仮想マシンのプロパティ。

DataDiskProperties

仮想マシンに新規または既存のデータ ディスクを追加するための要求本文。

DayDetails

毎日のスケジュールのプロパティ。

EnableStatus

スケジュールの状態 (有効、無効)

GalleryImageReference

Azure Marketplaceイメージの参照情報。

HostCachingOptions

データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。

HourDetails

1 時間ごとのスケジュールのプロパティ。

InboundNatRule

NAT の規則 - ロード バランサーを使用して、パブリック IP アドレスで VM のポート (backendPort) を公開します。

LabVirtualMachine

仮想マシン。

LabVirtualMachineList

リスト操作の応答。

NetworkInterfaceProperties

ネットワーク インターフェイスのプロパティ。

NotificationSettings

スケジュールの通知設定。

Schedule

スケジュール。

ScheduleCreationParameter

スケジュールを作成するためのプロパティ。

SharedPublicIpAddressConfiguration

ロード バランサーへの接続方法を決定する仮想マシンのプロパティ。

StorageType

ディスクのストレージの種類 (Standard、Premium など)。

TransportProtocol

エンドポイントのトランスポート プロトコル。

VirtualMachineCreationSource

ラボ仮想マシンの作成元に指示します。 Output プロパティのみ。

WeekDetails

週単位のスケジュールのプロパティ。

ApplicableSchedule

仮想マシンに適用できるスケジュール。 スケジュールは、VM またはラボ レベルで定義されている可能性があります。

名前 説明
id

string

リソースの識別子。

location

string

リソースの場所。

name

string

リソースの名前。

properties.labVmsShutdown

Schedule

自動シャットダウン スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。

properties.labVmsStartup

Schedule

自動起動スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。

tags

object

リソースのタグ。

type

string

リソースの型。

ArtifactDeploymentStatusProperties

成果物のデプロイのプロパティ。

名前 説明
artifactsApplied

integer

正常に適用された成果物の合計数。

deploymentStatus

string

成果物のデプロイ状態。

totalArtifacts

integer

仮適用された成果物の合計数。

ArtifactInstallProperties

成果物のプロパティ。

名前 説明
artifactId

string

成果物の識別子。

artifactTitle

string

成果物のタイトル。

deploymentStatusMessage

string

デプロイからのステータス メッセージ。

installTime

string

成果物が仮想マシンへのインストールを開始する時間。

parameters

ArtifactParameterProperties[]

成果物のパラメーター。

status

string

成果物の状態。

vmExtensionStatusMessage

string

仮想マシン拡張機能からのステータス メッセージ。

ArtifactParameterProperties

成果物パラメーターのプロパティ。

名前 説明
name

string

成果物パラメーターの名前。

value

string

成果物パラメーターの値。

AttachNewDataDiskOptions

仮想マシンに新しいディスクをアタッチするためのプロパティ。

名前 説明
diskName

string

アタッチするディスクの名前。

diskSizeGiB

integer

ギビバイト単位で接続するディスクのサイズ。

diskType

StorageType

ディスクのストレージの種類 (Standard、Premium など)。

CloudError

REST 要求からのエラー。

名前 説明
error

CloudErrorBody

発生したクラウド エラー

CloudErrorBody

REST 要求からのエラーの本文。

名前 説明
code

string

エラー コード。

details

CloudErrorBody[]

内部エラー。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ComputeDataDisk

仮想マシンに接続されているデータ ディスク。

名前 説明
diskSizeGiB

integer

GiB のデータ ディスク サイズを取得します。

diskUri

string

BLOB でサポートされている場合は、基になる BLOB の URI。

managedDiskId

string

マネージド ディスクでサポートされている場合、これはコンピューティング ディスク リソースの ID です。

name

string

データ ディスク名を取得します。

ComputeVmInstanceViewStatus

仮想マシンに関する状態情報。

名前 説明
code

string

状態コードを取得します。

displayStatus

string

状態の短いローカライズ可能なラベルを取得します。

message

string

状態に関連付けられているメッセージを取得します。

ComputeVmProperties

Microsoft.Compute API によって返される仮想マシンのプロパティ。

名前 説明
dataDiskIds

string[]

仮想マシンのデータ ディスク BLOB URI を取得します。

dataDisks

ComputeDataDisk[]

仮想マシンに接続されているすべてのデータ ディスクを取得します。

networkInterfaceId

string

仮想マシンのネットワーク インターフェイス ID を取得します。

osDiskId

string

仮想マシンの OS ディスク BLOB URI を取得します。

osType

string

仮想マシンの OS の種類を取得します。

statuses

ComputeVmInstanceViewStatus[]

仮想マシンの状態を取得します。

vmSize

string

仮想マシンのサイズを取得します。

DataDiskProperties

仮想マシンに新規または既存のデータ ディスクを追加するための要求本文。

名前 説明
attachNewDataDiskOptions

AttachNewDataDiskOptions

新しいディスクを仮想マシンにアタッチするオプションを指定します。

existingLabDiskId

string

仮想マシンにアタッチする既存のラボ ディスク ID を指定します。

hostCaching

HostCachingOptions

データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。

DayDetails

毎日のスケジュールのプロパティ。

名前 説明
time

string

スケジュールが発生する時刻。

EnableStatus

スケジュールの状態 (有効、無効)

名前 説明
Disabled

string

Enabled

string

GalleryImageReference

Azure Marketplaceイメージの参照情報。

名前 説明
offer

string

ギャラリー イメージのオファー。

osType

string

ギャラリー イメージの OS の種類。

publisher

string

ギャラリー イメージの発行元。

sku

string

ギャラリー イメージの SKU。

version

string

ギャラリー イメージのバージョン。

HostCachingOptions

データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。

名前 説明
None

string

ReadOnly

string

ReadWrite

string

HourDetails

1 時間ごとのスケジュールのプロパティ。

名前 説明
minute

integer

スケジュールが実行される時間の分数。

InboundNatRule

NAT の規則 - ロード バランサーを使用して、パブリック IP アドレスで VM のポート (backendPort) を公開します。

名前 説明
backendPort

integer

外部トラフィックがリダイレクトされるポート。

frontendPort

integer

受信接続の外部エンドポイント ポート。 指定できる値は 1 以上 65535 以下です。 指定しない場合、値は自動的に割り当てられます。

transportProtocol

TransportProtocol

エンドポイントのトランスポート プロトコル。

LabVirtualMachine

仮想マシン。

名前 規定値 説明
id

string

リソースの識別子。

location

string

リソースの場所。

name

string

リソースの名前。

properties.allowClaim

boolean

False

別のユーザーが仮想マシンの所有権を取得できるかどうかを示します

properties.applicableSchedule

ApplicableSchedule

仮想マシンに適用されるスケジュール。

properties.artifactDeploymentStatus

ArtifactDeploymentStatusProperties

仮想マシンの成果物のデプロイ状態。

properties.artifacts

ArtifactInstallProperties[]

仮想マシンにインストールする成果物。

properties.computeId

string

仮想マシンのリソース識別子 (Microsoft.Compute)。

properties.computeVm

ComputeVmProperties

コンピューティング仮想マシンのプロパティ。

properties.createdByUser

string

仮想マシンの作成者のメール アドレス。

properties.createdByUserId

string

仮想マシンの作成者のオブジェクト識別子。

properties.createdDate

string

仮想マシンの作成日。

properties.customImageId

string

仮想マシンのカスタム イメージ識別子。

properties.dataDiskParameters

DataDiskProperties[]

作成後に仮想マシンにアタッチする新規または既存のデータ ディスク

properties.disallowPublicIpAddress

boolean

False

パブリック IP アドレスなしで仮想マシンを作成するかどうかを示します。

properties.environmentId

string

この仮想マシンを含む環境のリソース ID (存在する場合)。

properties.expirationDate

string

VM の有効期限。

properties.fqdn

string

仮想マシンの完全修飾ドメイン名。

properties.galleryImageReference

GalleryImageReference

仮想マシンの Microsoft Azure Marketplace イメージ参照。

properties.isAuthenticationWithSshKey

boolean

この仮想マシンが認証に SSH キーを使用するかどうかを示します。

properties.labSubnetName

string

仮想マシンのラボ サブネット名。

properties.labVirtualNetworkId

string

仮想マシンのラボ仮想ネットワーク識別子。

properties.lastKnownPowerState

string

DTL でキャプチャされた最後の既知のコンピューティング電力状態

properties.networkInterface

NetworkInterfaceProperties

ネットワーク インターフェイスのプロパティ。

properties.notes

string

仮想マシンのメモ。

properties.osType

string

仮想マシンの OS の種類。

properties.ownerObjectId

string

dynamicValue

仮想マシンの所有者のオブジェクト識別子。

properties.ownerUserPrincipalName

string

仮想マシン所有者のユーザー プリンシパル名。

properties.password

string

仮想マシン管理者のパスワード。

properties.planId

string

仮想マシン イメージに関連付けられているプランの ID

properties.provisioningState

string

リソースのプロビジョニング状態。

properties.scheduleParameters

ScheduleCreationParameter[]

作成する仮想マシンのスケジュール

properties.size

string

仮想マシンのサイズ。

properties.sshKey

string

仮想マシン管理者の SSH キー。

properties.storageType

string

labStorageType

仮想マシンに使用するストレージの種類 (Standard、Premium など)。

properties.uniqueIdentifier

string

リソースの一意の不変識別子 (Guid)。

properties.userName

string

仮想マシンのユーザー名。

properties.virtualMachineCreationSource

VirtualMachineCreationSource

ラボ仮想マシンの作成元に指示します。 Output プロパティのみ。

tags

object

リソースのタグ。

type

string

リソースの型。

LabVirtualMachineList

リスト操作の応答。

名前 説明
nextLink

string

次の結果セットへのリンク。

value

LabVirtualMachine[]

リスト操作の結果。

NetworkInterfaceProperties

ネットワーク インターフェイスのプロパティ。

名前 説明
dnsName

string

DNS 名。

privateIpAddress

string

プライベート IP アドレス。

publicIpAddress

string

パブリック IP アドレス。

publicIpAddressId

string

パブリック IP アドレスのリソース ID。

rdpAuthority

string

RdpAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に RDP (リモート デスクトップ プロトコル) のサービス ポート番号が続くものです。

sharedPublicIpAddressConfiguration

SharedPublicIpAddressConfiguration

複数の仮想マシン間でパブリック IP アドレスを共有するための構成。

sshAuthority

string

SshAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に SSH のサービス ポート番号が続くものです。

subnetId

string

サブネットのリソース ID。

virtualNetworkId

string

仮想ネットワークのリソース ID。

NotificationSettings

スケジュールの通知設定。

名前 規定値 説明
emailRecipient

string

通知を送信する電子メール受信者 (セミコロンで区切られた電子メール アドレスの一覧を指定できます)。

notificationLocale

string

通知を送信するときに使用するロケール (サポートされていない言語のフォールバックは EN です)。

status

EnableStatus

Disabled

このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。

timeInMinutes

integer

通知が送信されるイベントの前の時間 (分)。

webhookUrl

string

通知の送信先となる Webhook URL。

Schedule

スケジュール。

名前 規定値 説明
id

string

リソースの識別子。

location

string

リソースの場所。

name

string

リソースの名前。

properties.createdDate

string

スケジュールの作成日。

properties.dailyRecurrence

DayDetails

スケジュールが曜日ごとに 1 回発生する場合は、毎日の繰り返しを指定します。

properties.hourlyRecurrence

HourDetails

スケジュールが 1 日に複数回発生する場合は、時間単位の繰り返しを指定します。

properties.notificationSettings

NotificationSettings

通知設定。

properties.provisioningState

string

リソースのプロビジョニング状態。

properties.status

EnableStatus

Disabled

スケジュールの状態 (有効、無効)

properties.targetResourceId

string

スケジュールが属するリソース ID

properties.taskType

string

スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。

properties.timeZoneId

string

タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティで使用できる値は、 (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にありますIReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds

properties.uniqueIdentifier

string

リソースの一意の不変識別子 (Guid)。

properties.weeklyRecurrence

WeekDetails

スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。

tags

object

リソースのタグ。

type

string

リソースの型。

ScheduleCreationParameter

スケジュールを作成するためのプロパティ。

名前 規定値 説明
location

string

新しい仮想マシンまたは環境の場所

name

string

仮想マシンまたは環境の名前

properties.dailyRecurrence

DayDetails

スケジュールが曜日ごとに 1 回発生する場合は、毎日の繰り返しを指定します。

properties.hourlyRecurrence

HourDetails

スケジュールが 1 日に複数回発生する場合は、時間単位の繰り返しを指定します。

properties.notificationSettings

NotificationSettings

通知設定。

properties.status

EnableStatus

Disabled

スケジュールの状態 (有効、無効)

properties.targetResourceId

string

スケジュールが属するリソース ID

properties.taskType

string

スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。

properties.timeZoneId

string

タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティで使用できる値は、 (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にありますIReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds

properties.weeklyRecurrence

WeekDetails

スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。

tags

object

リソースのタグ。

SharedPublicIpAddressConfiguration

ロード バランサーへの接続方法を決定する仮想マシンのプロパティ。

名前 説明
inboundNatRules

InboundNatRule[]

受信 NAT 規則

StorageType

ディスクのストレージの種類 (Standard、Premium など)。

名前 説明
Premium

string

Standard

string

StandardSSD

string

TransportProtocol

エンドポイントのトランスポート プロトコル。

名前 説明
Tcp

string

Udp

string

VirtualMachineCreationSource

ラボ仮想マシンの作成元に指示します。 Output プロパティのみ。

名前 説明
FromCustomImage

string

FromGalleryImage

string

FromSharedGalleryImage

string

WeekDetails

週単位のスケジュールのプロパティ。

名前 説明
time

string

スケジュールが発生する時刻。

weekdays

string[]

スケジュールが設定されている曜日 (日曜日、月曜日、火曜日など)。