This API has a deprecated equivalent from v7.0U1.
Create Resource Pool
Creates a resource pool. if you do not have all of the privileges described as follows: - The resource ResourcePool referenced by the attribute ResourcePool.CreateSpec.parent requires Resource.CreatePool.
Request
URLURL
https://{api_host}/api/vcenter/resource-pool
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
ResourcePoolCreateSpec of mimetype application/json
Required
Specification of the new resource pool to be created, see ResourcePool.CreateSpec.
{
"name": "string",
"parent": "string"
}
string
name
Required
Name of the resource pool.
string
parent
Required
Parent of the created resource pool. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: ResourcePool. When operations return a value of this structure as a result, the field will be an identifier for the resource type: ResourcePool.
cpu_allocation
Optional
Resource allocation for CPU. if unset or empty, use the default CPU allocation specification.
memory_allocation
Optional
Resource allocation for memory. if unset or empty, use the default memory allocation specification.
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 resource pool. The result will be an identifier for the resource type: ResourcePool.
Code Samples
PowerCLI Client SDK Example
$ResourcePoolCreateSpec = Initialize-ResourcePoolCreateSpec -Name "MyName" -Parent "MyParent"
Invoke-CreateResourcePool -ResourcePoolCreateSpec $ResourcePoolCreateSpec
PowerCLI Client SDK All Parameters Example
$ResourcePoolSharesInfo = Initialize-ResourcePoolSharesInfo -Level "LOW" -Shares 0
$ResourcePoolResourceAllocationCreateSpec = Initialize-ResourcePoolResourceAllocationCreateSpec -Reservation 0 -ExpandableReservation $false -Limit 0 -Shares $ResourcePoolSharesInfo
$ResourcePoolCreateSpec = Initialize-ResourcePoolCreateSpec -Name "MyName" -Parent "MyParent" -CpuAllocation $ResourcePoolResourceAllocationCreateSpec -MemoryAllocation $ResourcePoolResourceAllocationCreateSpec
Invoke-CreateResourcePool -ResourcePoolCreateSpec $ResourcePoolCreateSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"cpu_allocation":{"expandable_reservation":false,"limit":0,"reservation":0,"shares":{"level":"LOW","shares":0}},"memory_allocation":{"expandable_reservation":false,"limit":0,"reservation":0,"shares":{"level":"LOW","shares":0}},"name":"string","parent":"string"}' https://{api_host}/api/vcenter/resource-pool
Errors
400
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.
404
com.vmware.vapi.std.errors.not_found : If the resource specified in parent could not be found
500
com.vmware.vapi.std.errors.error : If the system reports an error while responding to the request. | com.vmware.vapi.std.errors.resource_inaccessible : If the specified resource in parent is not accessible. | com.vmware.vapi.std.errors.unable_to_allocate_resource : if any of the resources needed to create the resource pool could not be allocated.
503
com.vmware.vapi.std.errors.service_unavailable : If the system is unable to communicate with a service to complete the request.
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-deprecated-method: post
x-vmw-doc-deprecated-path: /rest/vcenter/resource-pool
x-vmw-doc-operation: create
Availability
Added in 7.0U2
On This Page
Resource Pool Operations
post
patch
delete
