---
title: "Implements list virtual machine within subscription method"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/virtualMachines"
tags: ["VirtualMachines"]
---

# Implements list virtual machine within subscription method

`GET /subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/virtualMachines`

Returns list virtual machine within subscription

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required
- `$filter` string
- `$top` integer
- `$skipToken` string

## Response `200`

successful operation

- VirtualMachineListResponse — List of virtual machines
  - `nextLink` string — Link for next list of VirtualMachines
  - `value` VirtualMachine[] — Results of the VirtualMachine list
    - `id` string — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/virtualMachines/{virtualMachineName}
    - `location` string, required — Azure region
    - `name` string — {virtualMachineName}
    - `properties` VirtualMachineProperties — Properties of virtual machine
      - `amountOfRam` integer, required — The amount of memory
      - `controllers` VirtualDiskController[] — The list of Virtual Disks' Controllers
        - `id` string — Controller's id
        - `name` string — The display name of Controller
        - `subType` string — dik controller subtype (VMWARE_PARAVIRTUAL, BUS_PARALLEL, LSI_PARALLEL, LSI_SAS)
        - `type` string — disk controller type (SCSI)
      - `customization` GuestOSCustomization — Guest OS Customization properties
        - `dnsServers` IPV4Address[] — List of dns servers to use
        - `hostName` string — Virtual Machine hostname
        - `password` string — Password for login
        - `policyId` string — id of customization policy
        - `username` string — Username for login
      - `disks` VirtualDisk[] — The list of Virtual Disks
        - `controllerId` string, required — Disk's Controller id
        - `independenceMode` 'persistent' | 'independent_persistent' | 'independent_nonpersistent', required — Disk's independence mode type
        - `totalSize` integer, required — Disk's total size
        - `virtualDiskId` string — Disk's id
        - `virtualDiskName` string — Disk's display name
      - `dnsname` string — The DNS name of Virtual Machine in VCenter
      - `exposeToGuestVM` boolean — Expose Guest OS or not
      - `folder` string — The path to virtual machine folder in VCenter
      - `guestOS` string — The name of Guest OS
      - `guestOSType` 'linux' | 'windows' | 'other' — The Guest OS type
      - `nics` VirtualNic[] — The list of Virtual NICs
        - `customization` GuestOSNICCustomization — Guest OS nic customization
          - `allocation` 'static' | 'dynamic' — IP address allocation method
          - `dnsServers` IPV4Address[] — List of dns servers to use
          - `gateway` IPV4Address[] — Gateway addresses assigned to nic
          - `ipAddress` string
          - `mask` string
          - `primaryWinsServer` string
          - `secondaryWinsServer` string
        - `ipAddresses` string[] — NIC ip address
        - `macAddress` string — NIC MAC address
        - `network` VirtualNetwork, required — Virtual network model
          - `assignable` boolean — can be used in vm creation/deletion
          - `id` string, required — virtual network id (privateCloudId:vsphereId)
          - `location` string — Azure region
          - `name` string — {VirtualNetworkName}
          - `properties` VirtualNetworkProperties — Properties of virtual network
            - `privateCloudId` string — The Private Cloud id
          - `type` string — {resourceProviderNamespace}/{resourceType}
        - `nicType` 'E1000' | 'E1000E' | 'PCNET32' | 'VMXNET' | 'VMXNET2' | 'VMXNET3', required — NIC type
        - `powerOnBoot` boolean — Is NIC powered on/off on boot
        - `virtualNicId` string — NIC id
        - `virtualNicName` string — NIC name
      - `numberOfCores` integer, required — The number of CPU cores
      - `password` string — Password for login. Deprecated - use customization property
      - `privateCloudId` string, required — Private Cloud Id
      - `provisioningState` string — The provisioning status of the resource
      - `publicIP` string — The public ip of Virtual Machine
      - `resourcePool` ResourcePool — Resource pool model
        - `id` string, required — resource pool id (privateCloudId:vsphereId)
        - `location` string — Azure region
        - `name` string — {ResourcePoolName}
        - `privateCloudId` string — The Private Cloud Id
        - `properties` ResourcePoolProperties — Properties of resource pool
          - `fullName` string — Hierarchical resource pool name
        - `type` string — {resourceProviderNamespace}/{resourceType}
      - `status` 'running' | 'suspended' | 'poweredoff' | 'updating' | 'deallocating' | 'deleting' — The status of Virtual machine
      - `templateId` string — Virtual Machine Template Id
      - `username` string — Username for login. Deprecated - use customization property
      - `vSphereNetworks` string[] — The list of Virtual VSphere Networks
      - `vmId` string — The internal id of Virtual Machine in VCenter
      - `vmwaretools` string — VMware tools version
    - `tags` unknown
    - `type` string — {resourceProviderNamespace}/{resourceType}

## Other responses

- `default` — General Error

## Changes

- **2019-10-01** (2019-04-01) `7f9c99d00f07` — 3 info
  - api operation id `virtualMachine_ListBySubscription` removed and replaced with `VirtualMachines_ListBySubscription`
  - api tag `VirtualMachines` added
  - api tag `virtualMachine` removed
- **2019-06-20** (2019-04-01) `efec17f26250` — 3 info
  - api operation id `VirtualMachines_ListBySubscription` removed and replaced with `virtualMachine_ListBySubscription`
  - api tag `virtualMachine` added
  - api tag `VirtualMachines` removed

[Change history](https://skmtc.dev/azure/apis/vmwarecloudsimple/changes/subscriptions/:subscriptionId/providers/Microsoft.VMwareCloudSimple/virtualMachines/get.md)

---

[API](https://skmtc.dev/azure/apis/vmwarecloudsimple.md) · [All operations](https://skmtc.dev/azure/apis/vmwarecloudsimple/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/vmwarecloudsimple/revisions/e4f413d50659/schema)