This API has a deprecated equivalent from v7.0U1.
Update Service
Updates the properties of a service.
Request
URLURL
https://{api_host}/api/vcenter/services/{service}
Path Parameters
Path Parameters
string
service
Required
identifier of the service whose properties are being updated.
The parameter must be an identifier for the resource type: com.vmware.vcenter.services.Service.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Request Body
Request Body
ServicesServiceUpdateSpec of mimetype application/json
Required
Service Update specification. The Service.UpdateSpec structure describes the changes to be made to the configuration of the service.
(The request body parameter is missing description)
{
"startup_type": "enum"
}
startup_type
Optional
Startup Type If unspecified, leaves value unchanged.
Possible values are: MANUAL , AUTOMATIC , DISABLED
cURL Command
curl -X PATCH -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"startup_type":"enum"}' https://{api_host}/api/vcenter/services/{service}
Errors
400
com.vmware.vapi.std.errors.not_allowed_in_current_state : if the operation is denied in the current state of the service. If a start, stop or restart operation is in progress, update operation will fail with this error.
if a request to set the Service.UpdateSpec.startup-type field of spec to DISABLED comes in for a service that is not in STOPPED state.
404
com.vmware.vapi.std.errors.not_found : if the service associated with service does not exist.
500
com.vmware.vapi.std.errors.error : if any other error occurs during the execution of the operation.
Availability
Added in 7.0U2
On This Page
Service Operations
get
patch
post
post
post