Create Supervisor Services
DescriptionCreate a Supervisor Service. If version specs are provided in the spec, new Supervisor Service versions will be created as part of the operation.
Request
URLURL
https://{api_host}/api/vcenter/namespace-management/supervisor-services
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
NamespaceManagementSupervisorServicesCreateSpec of mimetype application/json
Required
Specification for the Supervisor Service with version definition.
{
"carvel_spec": {
"version_spec": {
"content": "string"
}
},
"custom_spec": {
"description": "string",
"display_name": "string",
"supervisor_service": "string",
"version_spec": {
"content": "string",
"description": "string",
"display_name": "string",
"trusted_provider": false,
"version": "string"
}
},
"vsphere_spec": {
"version_spec": {
"accept_EULA": false,
"content": "string",
"trusted_provider": false
}
}
}
carvel_spec
Optional
The specification required to create a Supervisor Service with a version from inline content that is based on the Carvel application package format.
If set, the service will be created from a version 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 with a version from inline content that is based on a plain Kubernetes YAML format.
If set, the service will be created from a version based on a plain Kubernetes YAML format.
vsphere_spec
Optional
The specification required to create a Supervisor Service with a version from inline content that is based on the vSphere application service format.
If set, the service will be created from a version 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 with the same identifier already exists. | com.vmware.vapi.std.errors.invalid_argument : if spec contain any errors or if an invalid name is specified. For example, when the service is from a trusted provider, but no signature is provided or it is invalid.
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have the SupervisorServices.Manage privilege.
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
$NamespaceManagementSupervisorServicesCustomCreateSpec = Initialize-NamespaceManagementSupervisorServicesCustomCreateSpec -SupervisorService "MySupervisorService" -DisplayName "MyDisplayName" -Description "MyDescription" -VersionSpec $NamespaceManagementSupervisorServicesVersionsCustomCreateSpec
$NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec -Content "MyContent" -TrustedProvider $false -AcceptEULA $false
$NamespaceManagementSupervisorServicesVsphereCreateSpec = Initialize-NamespaceManagementSupervisorServicesVsphereCreateSpec -VersionSpec $NamespaceManagementSupervisorServicesVersionsVsphereCreateSpec
$NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec = Initialize-NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec -Content "MyContent"
$NamespaceManagementSupervisorServicesCarvelCreateSpec = Initialize-NamespaceManagementSupervisorServicesCarvelCreateSpec -VersionSpec $NamespaceManagementSupervisorServicesVersionsCarvelCreateSpec
$NamespaceManagementSupervisorServicesCreateSpec = Initialize-NamespaceManagementSupervisorServicesCreateSpec -CustomSpec $NamespaceManagementSupervisorServicesCustomCreateSpec -VsphereSpec $NamespaceManagementSupervisorServicesVsphereCreateSpec -CarvelSpec $NamespaceManagementSupervisorServicesCarvelCreateSpec
Invoke-CreateNamespaceManagementSupervisorServices -NamespaceManagementSupervisorServicesCreateSpec $NamespaceManagementSupervisorServicesCreateSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"carvel_spec":{"version_spec":{"content":"string"}},"custom_spec":{"description":"string","display_name":"string","supervisor_service":"string","version_spec":{"content":"string","description":"string","display_name":"string","trusted_provider":false,"version":"string"}},"vsphere_spec":{"version_spec":{"accept_EULA":false,"content":"string","trusted_provider":false}}}' https://{api_host}/api/vcenter/namespace-management/supervisor-services
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
