Skip to content

Virtualization API (1.2.0)

Virtualization API

Download OpenAPI description
index.json
index.yaml
Overview
License

HPE End User License Agreement

Languages
Servers

https://us-west.api.greenlake.hpe.com/

https://eu-west.api.greenlake.hpe.com/

https://eu-central.api.greenlake.hpe.com/

https://ap-northeast.api.greenlake.hpe.com/

Mock server

https://developer.greenlake.hpe.com/_mock/docs/greenlake/services/virtualization/public/openapi/virtualization-public-v1beta1/

csp-machine-images

Operations on cloud service provider (CSP) machine images.

Operations

csp-machine-instance-types

Operations on cloud service provider (CSP) machine instance types.

Operations

csp-machine-instances

Operations on cloud service provider (CSP) machine instances.

Operations

datastores

The datastores API allows the registration and management of datastores.

Operations

hypervisor-clusters

The hypervisor clusters API enables you to get the details of the hypervisor clusters in a hypervisor manager.

Operations

hypervisor-folders

The hypervisor folders API enables you to get the details of the hypervisor folders in a hypervisor manager.

Operations

Get a hypervisor folder resource identified by {folder-id}

Request

Details of a hypervisors folder.

Security
bearer
Path
hypervisor-idstringrequired

UUID string uniquely identifying the hypervisor manager.

Example: 9b4c14a6-3cd5-4907-97c4-cf44c5b641e4
folder-idstringrequired

UUID string uniquely identifying the hypervisor folder.

Example: 9b4c14a6-3cd5-4907-97c4-cf44c5b641e4
curl -i -X GET \
  https://us-west.api.greenlake.hpe.com/virtualization/v1beta1/hypervisor-managers/9b4c14a6-3cd5-4907-97c4-cf44c5b641e4/folders/9b4c14a6-3cd5-4907-97c4-cf44c5b641e4 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
idstringrequired

UUID string uniquely identifying the hypervisor folder.

Example: "9b4c14a6-3cd5-4907-97c4-cf44c5b641e4"
typestringread-onlyrequired
generationinteger(int64)read-onlyrequired
createdAtstring(date-time)required

Time in UTC at which the object was created.

updatedAtstring(date-time)required

Time in UTC at which the object was last updated.

appInfoobject

Application specific information for this folder.

customerIdstring

The customer application identifier.

displayNamestring

A user-friendly name that identifies the hypervisor folder. This will always be same as name since adding or updating hypervisor folders is not supported when managed from a manager, such as the vCenter.

Example: "myVmFolder"
folderTypestring

The type of the hypervisor folder.

Enum"DATASTORE""VM""HOST"
hypervisorManagerInfoobject
namestring<= 255 charactersread-only

Name of the folder as reported by the hypervisor manager.

Example: "myVmFolder"
parentFolderInfoobject

The immediate parent folder on which this resource is hosted in the inventory of hypervisor-manager.

resourceUristring

The 'self' reference for this resource.

Example: "/virtualization/v1beta1/hypervisor-managers/{hypervisor-id}/folders/{folder-id}"
servicesArray of strings(Services)
subFoldersArray of objects

Captures the list of all sub folders of this folder

Response
application/json
{
  "appInfo": {
    "vmware": { … }
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "customerId": "string",
  "displayName": "myVmFolder",
  "folderType": "DATASTORE",
  "generation": 0,
  "hypervisorManagerInfo": {
    "displayName": "myvcenter1",
    "id": "9b4c14a6-3cd5-4907-97c4-cf44c5b641e4",
    "name": "vcenter123.hpe.com",
    "resourceUri": "string",
    "type": "string"
  },
  "id": "9b4c14a6-3cd5-4907-97c4-cf44c5b641e4",
  "name": "myVmFolder",
  "parentFolderInfo": {
    "displayName": "myVmFolder",
    "id": "9b4c14a6-3cd5-4907-97c4-cf44c5b641e4",
    "name": "myVmFolder",
    "resourceUri": "string",
    "type": "string"
  },
  "resourceUri": "/virtualization/v1beta1/hypervisor-managers/{hypervisor-id}/folders/{folder-id}",
  "services": [
    "hci-manager",
    "backup-and-recovery"
  ],
  "subFolders": [
    { … }
  ],
  "type": "string",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Get all folders in a registered hypervisor manager.

Request

List all the hypervisors folders in a registered hypervisor manager.

Security
bearer
Path
uuidstringrequired

UUID string uniquely identifying the hypervisor manager.

Example: 9b4c14a6-3cd5-4907-97c4-cf44c5b641e4
Query
offsetinteger

The number of items to skip before starting to collect the result set

limitinteger(int32)[ 1 .. 1000 ]

The numbers of items to return

Default 20
filterstring

The filter query parameter is used to filter the set of resources returned in the response. The returned set of resources must match the criteria in the filter query parameter.

A comparison compares a property name to a literal. The following comparisons are supported:

  • “eq” : Is a property equal to value. Valid for number, boolean and string properties.
  • “ne” : Is a property not equal to value. Valid for number, boolean and string properties.
  • “gt” : Is a property greater than a value. Valid for number or string timestamp properties.
  • “lt” : Is a property less than a value. Valid for number or string timestamp properties
  • “in” : Is a value in a property (that is an array of strings)

Examples:

  • GET /virtualization/v1beta1/hypervisor-managers/{uuid}/folders?filter="folderType eq DATASTORE"

Filters are supported on the following attributes:

  • folderType
  • createdAt
  • name
  • services
  • displayName
sortstring

A comma separated list of properties to sort by, followed by a direction indicator ("asc" or "desc"). If no direction indicator is specified, the default order is ascending.

selectstring

The select query parameter is used to limit the properties returned with a resource or collection-level GET. Multiple properties can be listed to be returned. The server must only return the set of properties requested by the client. The property “select” is the name of the select query parameter; its value is the list of properties to return separated by commas.

curl -i -X GET \
  https://us-west.api.greenlake.hpe.com/virtualization/v1beta1/hypervisor-managers/9b4c14a6-3cd5-4907-97c4-cf44c5b641e4/folders \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
countintegerrequired

Total number of records returned.

itemsArray of objects(HypervisorFolder)required
items[].​idstringrequired

UUID string uniquely identifying the hypervisor folder.

Example: "9b4c14a6-3cd5-4907-97c4-cf44c5b641e4"
items[].​typestringread-onlyrequired
items[].​generationinteger(int64)read-onlyrequired
items[].​createdAtstring(date-time)required

Time in UTC at which the object was created.

items[].​updatedAtstring(date-time)required

Time in UTC at which the object was last updated.

items[].​appInfoobject

Application specific information for this folder.

items[].​customerIdstring

The customer application identifier.

items[].​displayNamestring

A user-friendly name that identifies the hypervisor folder. This will always be same as name since adding or updating hypervisor folders is not supported when managed from a manager, such as the vCenter.

Example: "myVmFolder"
items[].​folderTypestring

The type of the hypervisor folder.

Enum"DATASTORE""VM""HOST"
items[].​hypervisorManagerInfoobject
items[].​namestring<= 255 charactersread-only

Name of the folder as reported by the hypervisor manager.

Example: "myVmFolder"
items[].​parentFolderInfoobject

The immediate parent folder on which this resource is hosted in the inventory of hypervisor-manager.

items[].​resourceUristring

The 'self' reference for this resource.

Example: "/virtualization/v1beta1/hypervisor-managers/{hypervisor-id}/folders/{folder-id}"
items[].​servicesArray of strings(Services)
items[].​subFoldersArray of objects

Captures the list of all sub folders of this folder

offsetintegerrequired

The number of items to skip before starting to collect the result set

totalinteger

Total number of documents matching filter criteria.

Response
application/json
{
  "count": 0,
  "items": [
    { … }
  ],
  "offset": 0,
  "total": 0
}

hypervisor-hosts

The hypervisor hosts API enables you to get the details of the hypervisor hosts in a hypervisor manager.

Operations

hypervisor-managers

The hypervisor managers API allows the registration and management of hypervisor managers.

Operations

hypervisor-networks

The hypervisor networks API enables you to get the details of the hypervisor networks in a hypervisor manager.

Operations

hypervisor-tags

The hypervisor tags API enables you to get the details of the hypervisor tags in a hypervisor manager.

Operations

resource-pools

The resource pool API enables you to get the details of the hypervisor resource pools in a hypervisor manager.

Operations

virtual-machines

The virtual machines API allows the registration and management of virtual machines.

Operations