Create Supervisor Services Versions
Create a Supervisor Service version based on the provided service definition information for the version.
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"
Request Body
Request Body
NamespaceManagementSupervisorServicesVersionsCreateSpec of mimetype application/json
Required
Specification for the Supervisor Service version to be created.
{
"carvel_spec": {
"content": "string"
},
"custom_spec": {
"content": "string",
"description": "string",
"display_name": "string",
"trusted_provider": false,
"version": "string"
},
"vsphere_spec": {
"accept_EULA": false,
"content": "string",
"trusted_provider": false
}
}
carvel_spec
Optional
The specification required to create a Supervisor Service version from inline content that is based on the Carvel application package format.
If set, the service version will be created from inline content based on the Carvel application package format (Package and PackageMetadata resources should be declared).
custom_spec
Optional
The specification required to create a Supervisor Service version from inline content that is based on a plain Kubernetes YAML format.
If set, the service version will be created from inline content based on a plain Kubernetes YAML format.
vsphere_spec
Optional
The specification required to create a Supervisor Service version from inline content that is based on the vSphere application service format.
If set, the service version will be created from inline content based on the vSphere application service format.
Authentication
This operation uses the following authentication methods.
Errors
Errors
400
com.vmware.vapi.std.errors.already_exists : if a Supervisor Service version with the same identifier already exists. | com.vmware.vapi.std.errors.invalid_argument : if an invalid field in spec is specified or if it contains any errors. For example, when the field trusted is set to be true, but no signature is provided or it is invalid or when a EULA is specified but not accepted. | com.vmware.vapi.std.errors.not_allowed_in_current_state : if the Supervisor Service version cannot be created in the current state, for example, the Supervisor Service is in DEACTIVATED state.
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have the SupervisorServices.Manage privilege.
404
com.vmware.vapi.std.errors.not_found : if Supervisor 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.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
$NamespaceManagementSupervisorServicesVersionsCustomCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsCustomCreateSpec -Version "MyVersion" -DisplayName "MyDisplayName" -Description "MyDescription" -Content "MyContent" -TrustedProvider $false
$NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec -Content "MyContent" -TrustedProvider $false -AcceptEULA $false
$NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec -Content "MyContent"
$NamespaceManagementSupervisorServicesVersionsCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsCreateSpec -CustomSpec $NamespaceManagementSupervisorServicesVersionsCustomCreateSpec -VsphereSpec $NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec -CarvelSpec $NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec
Invoke-CreateSupervisorServiceNamespaceManagementVersions -SupervisorService "MySupervisorService" -NamespaceManagementSupervisorServicesVersionsCreateSpec $NamespaceManagementSupervisorServicesVersionsCreateSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"carvel_spec":{"content":"string"},"custom_spec":{"content":"string","description":"string","display_name":"string","trusted_provider":false,"version":"string"},"vsphere_spec":{"accept_EULA":false,"content":"string","trusted_provider":false}}' 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: create
Availability
Added in 7.0.3.0
