List Supervisor Services Versions
Return the information about all versions of the Supervisor Service.
Request
URLURL
https://{api_host}/api/vcenter/namespace-management/supervisor-services/{supervisor_service}/versions
Path Parameters
Path Parameters
string
supervisor_service
Required
Identifier of the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
array of
NamespaceManagementSupervisorServicesVersionsSummary of type application/json
The list of summary of all service versions of the Supervisor Service.
[
{
"description": "string",
"display_name": "string",
"state": "ACTIVATED",
"version": "string"
}
]
string
display_name
Required
A human readable name of the Supervisor Service version.
state
Required
The Versions.State enumerated type defines the state of a Supervisor Service version.
ACTIVATED : The is the default state of a Supervisor Service version upon creation. In this state, all operations on the version should work as normal.
DEACTIVATED : The is the deactivated state of a Supervisor Service version. In this state, certain operations on the version are disallowed, for example, the version cannot be created on the vSphere Supervisor clusters.
Possible values are: ACTIVATED , DEACTIVATED
string
version
Required
The identifier of the Supervisor Service version. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.
string
description
Optional
A human readable description of the Supervisor Service version. If unset, no description is available for the service version.
Errors
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have the System.Read privilege.
404
com.vmware.vapi.std.errors.not_found : if service with the ID supervisorService could not be located.
500
com.vmware.vapi.std.errors.error : if the system reports an error while responding to the request.
Code Samples
PowerCLI Client SDK Example
Invoke-ListSupervisorServiceNamespaceManagementVersions -SupervisorService "MySupervisorService"
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/namespace-management/supervisor-services/{supervisor_service}/versions
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: list
Availability
Added in 7.0.3.0
