Developer Documentation
Set Customization Specs
Released in v7.0.0Sets an existing specification, possibly after retrieving (by using CustomizationSpecs.get) and editing it.
Request
URLURL
https://{api_host}/rest/vcenter/guest/customization-specs/{name}
Path Parameters
Path Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| required |
|
string | The name of the customization specification that needs to be set. The parameter must be an identifier for the resource type: com.vmware.vcenter.guest.CustomizationSpec. |
Request Body
Request Body
Contains
SetRequestBody
of type application/json
(required)
{
"spec": {
"description": "string",
"fingerprint": "string",
"name": "string",
"spec": {
"configuration_spec": {},
"global_DNS_settings": {},
"interfaces": [
{
"adapter": {}
}
]
}
}
}| Required | Property Name | Type | Description |
|---|---|---|---|
| required | spec | CustomizationSpecsSpec |
The new specification that will overwrite the existing specification. |
Errors
| Code | Returns | Description |
|---|---|---|
| 400 | Error | com.vmware.vapi.std.errors.invalid_argument : If, based on the item's fingerprint value, the set process detects that the specification has changed since its retrieval, then the operation throws InvalidArgument exception to warn the client that he might overwrite another client's change. If the settings in spec are not valid. |
| 401 | Error | com.vmware.vapi.std.errors.unauthenticated : if the user can not be authenticated. | com.vmware.vapi.std.errors.unauthorized : if the user doesn't have the required privileges. |
| 404 | Error | com.vmware.vapi.std.errors.not_found : if a customization specification is not found. |
| 503 | Error | com.vmware.vapi.std.errors.service_unavailable : if the system is unable to communicate with a service to complete the request. |
| default | Error | Not available |
