Get Defined Entities By Entity Type No Version Specified

Get Defined Entities By Entity Type No Version Specified

Gets the collection of defined entities for the vCD-defined type with the specified vendor and nss without restrictions on the version.

Request
URI
GET
https://{api_host}/cloudapi/1.0.0/entities/types/{vendor}/{nss}
COPY
Path Parameters
string
vendor
Required

vendor

string
nss
Required

nss

string
vendor
Required

vendor

string
nss
Required

nss

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

string
sortAsc
Optional

Field to use for ascending sort

string
sortDesc
Optional

Field to use for descending sort

integer
page
Required

Page to fetch, zero offset.

integer
pageSize
Required

Results per page to fetch.

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

string
sortAsc
Optional

Field to use for ascending sort

string
sortDesc
Optional

Field to use for descending sort

integer
page
Required

Page to fetch, zero offset.

integer
pageSize
Required

Results per page to fetch.


Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns DefinedEntities of type(s) application/json;version=37.1
This response body class contains all of the following: Page , InlineDefinedEntities1
{
    "resultTotal": 0,
    "pageCount": 0,
    "page": 0,
    "pageSize": 0,
    "associations": [
        {
            "entityId": "string",
            "associationId": "string"
        }
    ],
    "values": [
        {
            "id": "urn:vcloud:entity:vmware.vspheresddc:1.0.0:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "entityType": "urn:vcloud:type:vmware.vspheresddc:1.0.0",
            "name": "vspheresddc1",
            "externalId": "123",
            "state": "string",
            "entityState": "string",
            "owner": {
                "name": "string",
                "id": "string"
            },
            "org": {
                "name": "string",
                "id": "string"
            }
        }
    ]
}