vcenter_resourcepool_info
Retrieves information about the resource pool indicated by resourcePool
Collection: vmware.vmware_rest
Full Name: vmware.vmware_rest.vcenter_resourcepool_info
Synopsis
Retrieves information about the resource pool indicated by resourcePool
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| vcenter_hostname | string | yes | The hostname or IP address of the vSphere vCenter | |
| If the value is not specified in the task, the value of environment variable C(VMWARE_HOST) will be used instead. | ||||
| vcenter_username | string | yes | The vSphere vCenter username | |
| If the value is not specified in the task, the value of environment variable C(VMWARE_USER) will be used instead. | ||||
| vcenter_password | string | yes | The vSphere vCenter password | |
| If the value is not specified in the task, the value of environment variable C(VMWARE_PASSWORD) will be used instead. | ||||
| vcenter_validate_certs | bool | true | Allows connection when SSL certificates are not valid. Set to C(false) when certificates are not trusted. | |
| If the value is not specified in the task, the value of environment variable C(VMWARE_VALIDATE_CERTS) will be used instead. | ||||
| vcenter_rest_log_file | string | You can use this optional parameter to set the location of a log file. | ||
| This file will be used to record the HTTP REST interaction. | ||||
| The file will be stored on the host that runs the module. | ||||
| If the value is not specified in the task, the value of | ||||
| environment variable C(VMWARE_REST_LOG_FILE) will be used instead. | ||||
| session_timeout | float | Timeout settings for client session. | ||
| The maximal number of seconds for the whole operation including connection establishment, request sending and response. | ||||
| The default value is 300s. | ||||
| clusters | list | Clusters that must contain the resource pool for the resource pool to match the filter. | ||
| If unset or empty, resource pools in any cluster match the filter. | ||||
| When clients pass a value of this structure as a parameter, the field must contain the id of resources returned by M(vmware.vmware_rest.vcenter_cluster_info). | ||||
| datacenters | list | Datacenters that must contain the resource pool for the resource pool to match the filter. | ||
| If unset or empty, resource pools in any datacenter match the filter. | ||||
| When clients pass a value of this structure as a parameter, the field must contain the id of resources returned by M(vmware.vmware_rest.vcenter_datacenter_info). | ||||
| hosts | list | Hosts that must contain the resource pool for the resource pool to match the filter. | ||
| If unset or empty, resource pools in any host match the filter. | ||||
| When clients pass a value of this structure as a parameter, the field must contain the id of resources returned by M(vmware.vmware_rest.vcenter_host_info). | ||||
| names | list | Names that resource pools must have to match the filter (see I(name)). | ||
| If unset or empty, resource pools with any name match the filter. | ||||
| parent_resource_pools | list | Resource pools that must contain the resource pool for the resource pool to match the filter. | ||
| If unset or empty, resource pools in any resource pool match the filter. | ||||
| When clients pass a value of this structure as a parameter, the field must contain the id of resources returned by M(vmware.vmware_rest.vcenter_resourcepool_info). | ||||
| resource_pool | string | Identifier of the resource pool for which information should be retrieved. | ||
| The parameter must be the id of a resource returned by M(vmware.vmware_rest.vcenter_resourcepool_info). Required with I(state=[‘get’]) | ||||
| resource_pools | list | Identifiers of resource pools that can match the filter. | ||
| If unset or empty, resource pools with any identifier match the filter. | ||||
| When clients pass a value of this structure as a parameter, the field must contain the id of resources returned by M(vmware.vmware_rest.vcenter_resourcepool_info). |
Example
yaml
- name: Get the existing resource pools
vmware.vmware_rest.vcenter_resourcepool_info:
register: resource_pools
- name: Get the existing resource pool
vmware.vmware_rest.vcenter_resourcepool_info:
resource_pool: '{{ resource_pools.value[0].resource_pool }}'
register: my_resource_pool
- name: Create a generic resource pool
vmware.vmware_rest.vcenter_resourcepool:
name: my_resource_pool
parent: '{{ resource_pools.value[0].resource_pool }}'
register: my_resource_pool
- name: Read details from a specific resource pool
vmware.vmware_rest.vcenter_resourcepool_info:
resource_pool: '{{ my_resource_pool.id }}'
register: my_resource_pool