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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
lab
|
path | True |
string |
ラボの名前。 |
resource
|
path | True |
string |
リソース グループの名前。 |
subscription
|
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 |
OK |
|
Other Status Codes |
BadRequest |
セキュリティ
azure_auth
OAuth2 暗黙的な許可
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | Microsoft Azure にアクセスする |
例
VirtualMachines_List
要求のサンプル
応答のサンプル
{
"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"
}
}
]
}
定義
名前 | 説明 |
---|---|
Applicable |
仮想マシンに適用できるスケジュール。 スケジュールは、VM またはラボ レベルで定義されている可能性があります。 |
Artifact |
成果物のデプロイのプロパティ。 |
Artifact |
成果物のプロパティ。 |
Artifact |
成果物パラメーターのプロパティ。 |
Attach |
仮想マシンに新しいディスクをアタッチするためのプロパティ。 |
Cloud |
REST 要求からのエラー。 |
Cloud |
REST 要求からのエラーの本文。 |
Compute |
仮想マシンに接続されているデータ ディスク。 |
Compute |
仮想マシンに関する状態情報。 |
Compute |
Microsoft.Compute API によって返される仮想マシンのプロパティ。 |
Data |
仮想マシンに新規または既存のデータ ディスクを追加するための要求本文。 |
Day |
毎日のスケジュールのプロパティ。 |
Enable |
スケジュールの状態 (有効、無効) |
Gallery |
Azure Marketplaceイメージの参照情報。 |
Host |
データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。 |
Hour |
1 時間ごとのスケジュールのプロパティ。 |
Inbound |
NAT の規則 - ロード バランサーを使用して、パブリック IP アドレスで VM のポート (backendPort) を公開します。 |
Lab |
仮想マシン。 |
Lab |
リスト操作の応答。 |
Network |
ネットワーク インターフェイスのプロパティ。 |
Notification |
スケジュールの通知設定。 |
Schedule |
スケジュール。 |
Schedule |
スケジュールを作成するためのプロパティ。 |
Shared |
ロード バランサーへの接続方法を決定する仮想マシンのプロパティ。 |
Storage |
ディスクのストレージの種類 (Standard、Premium など)。 |
Transport |
エンドポイントのトランスポート プロトコル。 |
Virtual |
ラボ仮想マシンの作成元に指示します。 Output プロパティのみ。 |
Week |
週単位のスケジュールのプロパティ。 |
ApplicableSchedule
仮想マシンに適用できるスケジュール。 スケジュールは、VM またはラボ レベルで定義されている可能性があります。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの識別子。 |
location |
string |
リソースの場所。 |
name |
string |
リソースの名前。 |
properties.labVmsShutdown |
自動シャットダウン スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。 |
|
properties.labVmsStartup |
自動起動スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。 |
|
tags |
object |
リソースのタグ。 |
type |
string |
リソースの型。 |
ArtifactDeploymentStatusProperties
成果物のデプロイのプロパティ。
名前 | 型 | 説明 |
---|---|---|
artifactsApplied |
integer |
正常に適用された成果物の合計数。 |
deploymentStatus |
string |
成果物のデプロイ状態。 |
totalArtifacts |
integer |
仮適用された成果物の合計数。 |
ArtifactInstallProperties
成果物のプロパティ。
名前 | 型 | 説明 |
---|---|---|
artifactId |
string |
成果物の識別子。 |
artifactTitle |
string |
成果物のタイトル。 |
deploymentStatusMessage |
string |
デプロイからのステータス メッセージ。 |
installTime |
string |
成果物が仮想マシンへのインストールを開始する時間。 |
parameters |
成果物のパラメーター。 |
|
status |
string |
成果物の状態。 |
vmExtensionStatusMessage |
string |
仮想マシン拡張機能からのステータス メッセージ。 |
ArtifactParameterProperties
成果物パラメーターのプロパティ。
名前 | 型 | 説明 |
---|---|---|
name |
string |
成果物パラメーターの名前。 |
value |
string |
成果物パラメーターの値。 |
AttachNewDataDiskOptions
仮想マシンに新しいディスクをアタッチするためのプロパティ。
名前 | 型 | 説明 |
---|---|---|
diskName |
string |
アタッチするディスクの名前。 |
diskSizeGiB |
integer |
ギビバイト単位で接続するディスクのサイズ。 |
diskType |
ディスクのストレージの種類 (Standard、Premium など)。 |
CloudError
REST 要求からのエラー。
名前 | 型 | 説明 |
---|---|---|
error |
発生したクラウド エラー |
CloudErrorBody
REST 要求からのエラーの本文。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
details |
内部エラー。 |
|
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 |
仮想マシンに接続されているすべてのデータ ディスクを取得します。 |
|
networkInterfaceId |
string |
仮想マシンのネットワーク インターフェイス ID を取得します。 |
osDiskId |
string |
仮想マシンの OS ディスク BLOB URI を取得します。 |
osType |
string |
仮想マシンの OS の種類を取得します。 |
statuses |
仮想マシンの状態を取得します。 |
|
vmSize |
string |
仮想マシンのサイズを取得します。 |
DataDiskProperties
仮想マシンに新規または既存のデータ ディスクを追加するための要求本文。
名前 | 型 | 説明 |
---|---|---|
attachNewDataDiskOptions |
新しいディスクを仮想マシンにアタッチするオプションを指定します。 |
|
existingLabDiskId |
string |
仮想マシンにアタッチする既存のラボ ディスク ID を指定します。 |
hostCaching |
データ ディスクのキャッシュ オプション (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 |
エンドポイントのトランスポート プロトコル。 |
LabVirtualMachine
仮想マシン。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
id |
string |
リソースの識別子。 |
|
location |
string |
リソースの場所。 |
|
name |
string |
リソースの名前。 |
|
properties.allowClaim |
boolean |
False |
別のユーザーが仮想マシンの所有権を取得できるかどうかを示します |
properties.applicableSchedule |
仮想マシンに適用されるスケジュール。 |
||
properties.artifactDeploymentStatus |
仮想マシンの成果物のデプロイ状態。 |
||
properties.artifacts |
仮想マシンにインストールする成果物。 |
||
properties.computeId |
string |
仮想マシンのリソース識別子 (Microsoft.Compute)。 |
|
properties.computeVm |
コンピューティング仮想マシンのプロパティ。 |
||
properties.createdByUser |
string |
仮想マシンの作成者のメール アドレス。 |
|
properties.createdByUserId |
string |
仮想マシンの作成者のオブジェクト識別子。 |
|
properties.createdDate |
string |
仮想マシンの作成日。 |
|
properties.customImageId |
string |
仮想マシンのカスタム イメージ識別子。 |
|
properties.dataDiskParameters |
作成後に仮想マシンにアタッチする新規または既存のデータ ディスク |
||
properties.disallowPublicIpAddress |
boolean |
False |
パブリック IP アドレスなしで仮想マシンを作成するかどうかを示します。 |
properties.environmentId |
string |
この仮想マシンを含む環境のリソース ID (存在する場合)。 |
|
properties.expirationDate |
string |
VM の有効期限。 |
|
properties.fqdn |
string |
仮想マシンの完全修飾ドメイン名。 |
|
properties.galleryImageReference |
仮想マシンの Microsoft Azure Marketplace イメージ参照。 |
||
properties.isAuthenticationWithSshKey |
boolean |
この仮想マシンが認証に SSH キーを使用するかどうかを示します。 |
|
properties.labSubnetName |
string |
仮想マシンのラボ サブネット名。 |
|
properties.labVirtualNetworkId |
string |
仮想マシンのラボ仮想ネットワーク識別子。 |
|
properties.lastKnownPowerState |
string |
DTL でキャプチャされた最後の既知のコンピューティング電力状態 |
|
properties.networkInterface |
ネットワーク インターフェイスのプロパティ。 |
||
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 |
作成する仮想マシンのスケジュール |
||
properties.size |
string |
仮想マシンのサイズ。 |
|
properties.sshKey |
string |
仮想マシン管理者の SSH キー。 |
|
properties.storageType |
string |
labStorageType |
仮想マシンに使用するストレージの種類 (Standard、Premium など)。 |
properties.uniqueIdentifier |
string |
リソースの一意の不変識別子 (Guid)。 |
|
properties.userName |
string |
仮想マシンのユーザー名。 |
|
properties.virtualMachineCreationSource |
ラボ仮想マシンの作成元に指示します。 Output プロパティのみ。 |
||
tags |
object |
リソースのタグ。 |
|
type |
string |
リソースの型。 |
LabVirtualMachineList
リスト操作の応答。
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
次の結果セットへのリンク。 |
value |
リスト操作の結果。 |
NetworkInterfaceProperties
ネットワーク インターフェイスのプロパティ。
名前 | 型 | 説明 |
---|---|---|
dnsName |
string |
DNS 名。 |
privateIpAddress |
string |
プライベート IP アドレス。 |
publicIpAddress |
string |
パブリック IP アドレス。 |
publicIpAddressId |
string |
パブリック IP アドレスのリソース ID。 |
rdpAuthority |
string |
RdpAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に RDP (リモート デスクトップ プロトコル) のサービス ポート番号が続くものです。 |
sharedPublicIpAddressConfiguration |
複数の仮想マシン間でパブリック IP アドレスを共有するための構成。 |
|
sshAuthority |
string |
SshAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に SSH のサービス ポート番号が続くものです。 |
subnetId |
string |
サブネットのリソース ID。 |
virtualNetworkId |
string |
仮想ネットワークのリソース ID。 |
NotificationSettings
スケジュールの通知設定。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
emailRecipient |
string |
通知を送信する電子メール受信者 (セミコロンで区切られた電子メール アドレスの一覧を指定できます)。 |
|
notificationLocale |
string |
通知を送信するときに使用するロケール (サポートされていない言語のフォールバックは EN です)。 |
|
status | Disabled |
このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。 |
|
timeInMinutes |
integer |
通知が送信されるイベントの前の時間 (分)。 |
|
webhookUrl |
string |
通知の送信先となる Webhook URL。 |
Schedule
スケジュール。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
id |
string |
リソースの識別子。 |
|
location |
string |
リソースの場所。 |
|
name |
string |
リソースの名前。 |
|
properties.createdDate |
string |
スケジュールの作成日。 |
|
properties.dailyRecurrence |
スケジュールが曜日ごとに 1 回発生する場合は、毎日の繰り返しを指定します。 |
||
properties.hourlyRecurrence |
スケジュールが 1 日に複数回発生する場合は、時間単位の繰り返しを指定します。 |
||
properties.notificationSettings |
通知設定。 |
||
properties.provisioningState |
string |
リソースのプロビジョニング状態。 |
|
properties.status | Disabled |
スケジュールの状態 (有効、無効) |
|
properties.targetResourceId |
string |
スケジュールが属するリソース ID |
|
properties.taskType |
string |
スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。 |
|
properties.timeZoneId |
string |
タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティで使用できる値は、 (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にあります |
|
properties.uniqueIdentifier |
string |
リソースの一意の不変識別子 (Guid)。 |
|
properties.weeklyRecurrence |
スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。 |
||
tags |
object |
リソースのタグ。 |
|
type |
string |
リソースの型。 |
ScheduleCreationParameter
スケジュールを作成するためのプロパティ。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
location |
string |
新しい仮想マシンまたは環境の場所 |
|
name |
string |
仮想マシンまたは環境の名前 |
|
properties.dailyRecurrence |
スケジュールが曜日ごとに 1 回発生する場合は、毎日の繰り返しを指定します。 |
||
properties.hourlyRecurrence |
スケジュールが 1 日に複数回発生する場合は、時間単位の繰り返しを指定します。 |
||
properties.notificationSettings |
通知設定。 |
||
properties.status | Disabled |
スケジュールの状態 (有効、無効) |
|
properties.targetResourceId |
string |
スケジュールが属するリソース ID |
|
properties.taskType |
string |
スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。 |
|
properties.timeZoneId |
string |
タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティで使用できる値は、 (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にあります |
|
properties.weeklyRecurrence |
スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。 |
||
tags |
object |
リソースのタグ。 |
SharedPublicIpAddressConfiguration
ロード バランサーへの接続方法を決定する仮想マシンのプロパティ。
名前 | 型 | 説明 |
---|---|---|
inboundNatRules |
受信 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[] |
スケジュールが設定されている曜日 (日曜日、月曜日、火曜日など)。 |