[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get Defined Entities By Entity Type

Description

Gets the collection of defined entities for the vCD-defined type with the specified vendor, nss and version. The version can act as a wildcard. If only ‘1’ is specified as the version, all entity types with a major version of ‘1’ will be matched (e.g. 1.0.0, 1.1.2). If ‘1.0’ is specified, all entity types with a major version of ‘1’ and a minor version of ‘0’ will be included (e.g. 1.0.0, 1.0.1). If the full semver is specified, then no search will be performed. Depending on the requested items per page, and the number of returned entities, one or more metadata summary cursor links will be returned in the headers. In order to retrieve the summaries of all the entities, clients need to fetch each separate cursor and merge the results.

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/entities/types/{vendor}/{nss}/{version}
Copy

Path Parameters

Path Parameters

string
vendor Required

string
nss Required

string
version Required

Query Parameters

Query Parameters

string
filter Optional

Filter for a query. FIQL format.


string
metadata Optional

Metadata filter for a query. FIQL format. A single statement is of the form namespace|key operator value. The namespace is optional, has to be separated by ‘|’ from the key and therefore this character is not supported as part of the namespace or key. The value is not optional, however one can omit a value search if ‘*’ is specified. Note that API clients will need to encode these characters accordingly. The framework will try to infer the type of the value in the following order:

  • if it starts and ends with single unescaped quotes it is a string and the quotes are removed from the beginning and end of the string
  • else if it parses to a long it is a long
  • else if it is either ’true’ or ‘false’(case insensitive) it is a boolean
  • else an error id returned

Examples: namespace|com:vmware:key1=='42' here the value 42 will be searched as a string entry com:vmware:key2==''string'' here the value 'string' (with the quotes) com.key3=gt=42 here a search for a number entry will be performed, with a value greater than 42 ns|com.key4==* here a search for an entry with the namespace 'ns' and key 'key4' and any value will be performed


integer
page Required

Page to fetch, zero offset.


integer
pageSize Required

Results per page to fetch.


string
sortAsc Optional

Field to use for ascending sort


string
sortDesc Optional

Field to use for descending sort


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns DefinedEntities of type(s) application/json;version=37.2
This response body class contains all of the following: Page, InlineDefinedEntities1

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/entities/types/{vendor}/{nss}/{version}?page=10&pageSize=10
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-vcloud-multisite: true


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Feedback

Was this page helpful?