Create Policies
Creates a new compute policy. if you do not have all of the privileges described as follows: - Operation execution requires ComputePolicy.Manage.
Request
URLURL
https://{api_host}/api/vcenter/compute/policies
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
object of mimetype application/json
Required
Specification for the new policy to be created. The new policy will be an instance of the capability that has the creation type (see Capabilities.Info.create-spec-type) equal to the type of the specified value (see spec). The parameter must contain all the attributes defined in CreateSpec.
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
201 Created returns
string
of type application/json
The identifier of the newly created policy. Use this identifier to get or destroy the policy. The result will be an identifier for the resource type: com.vmware.vcenter.compute.Policy.
Errors
400
com.vmware.vapi.std.errors.already_exists : if a policy with the same name is already present on this vCenter server. | com.vmware.vapi.std.errors.invalid_argument : if a parameter passed in the spec is invalid.
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have the required privileges.
500
com.vmware.vapi.std.errors.unable_to_allocate_resource : if more than 100 policies are created.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" https://{api_host}/api/vcenter/compute/policies
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
