REST API - list

vcenter settings namespaces items: list

Returns a map of item values corresponding to the keys in the namespace. The readPrivilege defined in the namespace is checked before the operation is initiated. If keys is not passed in, the entire map of KV pairs are returned. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

GET https://{server}/rest/vcenter/settings/namespaces/{namespace}/items

?keys.1=string
&keys.2=string

Path Parameters

Name Type Description
Required
namespace string the targetted namespace.

Request Query Parameters:

Name Type Description
bold = required
keys string[] Optional.

Response:

HTTP Status Code: 200

Representation:

{
    "value"[
        {
            "value""string",
            "key""string"
        }
    ]
}

Response Type:

Name Type Description
bold = required
value list the map of key value items in the namespace. List of {"key": string, "value": string}
value[].key string
value[].value string

Errors:

HTTP Status Code Type Description
403 unauthorized If the user is not authorized.
404 not_found if the namespace is not found
500 error if the system reports an error while responding to the request.