Vcenter Guest CustomizationSpecs delete
Deletes a customization specification with the specified identifier.
This operation was added in vSphere API 7.0.0.0.
Returns an authorization error if you do not have all of the privileges described as follows:
- Operation execution requires
VirtualMachine.Provisioning.ModifyCustSpecs
.
The name of the customization specification that needs to be deleted.
The parameter must be an identifier for the resource type: com.vmware.vcenter.guest.CustomizationSpec
.
Success!
if the user can not be authenticated.
{
"messages": [
{
"id": "string",
"default_message": "string",
"args": [
"string"
],
"params": {
"params": {
"s": "string",
"dt": "string",
"i": 0,
"d": "number",
"l": "Vapi Std NestedLocalizableMessage Object",
"format": "string",
"precision": 0
}
},
"localized": "string"
}
],
"data": {},
"error_type": "string",
"challenge": "string"
}
Indicates the authentication challenges applicable to the target API provider. It can be used by a client to discover the correct authentication scheme to use. The exact syntax of the value is defined by the specific provider, the protocol and authentication schemes used.
For example, a provider using REST may adhere to the WWW-Authenticate HTTP header specification, RFC7235, section 4.1. In this case an example challenge value may be: SIGN realm="27da1358-2ba4-11e9-b210-d663bd873d93",sts="http://vcenter/sso?vsphere.local", Basic realm="vCenter"
This property was added in vSphere API 7.0.0.0.
This property is optional because it was added in a newer version than its parent node.
if the user doesn't have the required privileges.
"Vapi Std Errors Unauthorized Object"
if a customization specification is not found.
"Vapi Std Errors NotFound Object"
if the system is unable to communicate with a service to complete the request.
"Vapi Std Errors ServiceUnavailable Object"
curl -X DELETE -H 'Authorization: <value>' https://{api_host}/api/vcenter/guest/customization-specs/{name}