Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


 Image Added

 

 

Create  Create Resource Pool

This activity creates a new Resource Pool on the existing Resource Pool or the specified Cluster.

...

  • Output  (type: string): outputs the new created Resource Pool ID.
  • Output Status  (type: boolean): outputs True if the operation succeeded otherwise False.

 

...

 




Edit Resource Pool

This activity edits the specified Resource Pool.

...

  • Name (text box editor type) (type: string): the new name of the Resource Pool.
  • Resource Pool ID (text box editor type) (type: string): the ID of the Resource Pool.
    The value can also be obtained from activity: Get Resource Pool using the following steps:
    • use a Get Resource Pool activity to extract the ResourcePoolID: 
       
    • bind the obtained ResourcePoolID(stored in variable) to the Resource Pool ID field from Edit Resource Pool activity:
       
         
  • Resource Pool ID (text box editor type) (type: string): the ID of the Resource Pool or bind this parameter with the output parameter from Get VM Resource Pool.

Resources (parameters):

  • CPU Limit (text box editor type) (type: int32): limit the utilization of the resource pool, and it will not exceed it even if there are available resources. This is typically used to ensure a consistent performance of resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MHz.
  • CPU Reservation (text box editor type) (type: int32): amount of resource that is guaranteed available to the resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MHz.
  • CPU Shares (text box editor type) (type: int32): the number of shares allocated. Used to determine resource allocation in case of resource contention. This value is only set if level is set to custom. If level is not set to custom, this value is ignored. Therefore, only shares with custom values can be compared.
  • CPU Shares Level (combo box control) (type: string): set the allocation level, it is a simplified view of shares. Levels map to a pre-determined set of numeric values for shares. If the shares value does not map to a predefined size, then the level is set as custom.If custom -> Shares value is specified in the 'shares' parameter, if high -> Shares = 2000 * number of virtual CPUs, if low -> Shares = 500 * number of virtual CPUs, or if normal -> Shares = 1000 * number of virtual CPUs.
  • Expandable CPU Reservation (combo box control) (type: string): in a resource pool with an expandable reservation, the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has unreserved resources. A non-expandable reservation is called a fixed reservation.
  • Expandable Memory Reservation (combo box control) (type: string): in a resource pool with an expandable reservation, the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has unreserved resources. A non-expandable reservation is called a fixed reservation.
  • Memory Limit (text box editor type) (type: int32): limit the utilization of the resource pool,and it will not exceed it even if there are available resources. This is typically used to ensure a consistent performance of resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB.
  • Memory Reservation (text box editor type) (type: int32): amount of resource that is guaranteed available to the resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB.
  • Memory Shares (text box editor type) (type: int32): the number of shares allocated. Used to determine resource allocation in case of resource contention. This value is only set if level is set to custom. If level is not set to custom, this value is ignored. Therefore, only shares with custom values can be compared.
  • Memory Shares Level (combo box control) (type: string): this is the allocation level, it is a simplified view of shares. Levels map to a pre-determined set of numeric values for shares. If the shares value does not map to a predefined size, then the level is set as custom.

...

  • Output Status  (type: boolean): outputs True if the operation succeeded otherwise False.

...

 



 

Get Resource Pool

This activity returns the specified Resource Pool ID.

...

  • Output  (type: string): outputs the resulting Resource Pool ID.

...


Execution: The example below is an execution where a new datastore will be created on the specified host:



 

Get Resource Pool Properties

...

The Get Resource Pool Properties activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • Resource Pool ID (text box editor type) (type: string): the ResourcePool ID. The output from the
    The value can also be obtained from activity: Get Resource Pool using the following steps:
    • use a Get Resource Pool activity to extract the ResourcePoolID: 
       Image Added
    • bind the obtained ResourcePoolID(stored in variable) to the Resource Pool ID field from Get Resource Pool
    activity can be used as an input value.
    • Properties activity: 
      Image Added   

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: collection<string>): outputs a collection of Properties and their corresponding values.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bound to this parameter.
 

Image Removed

 

In order to extract the values from the ResPoolProperties collection, For Each and Log Track Data activities should be used:

Image Added


Execution: The example below is an execution where all properties are returned for resource pool with ID: resgroup-697:

Image Added


 

List Resource Pools

This activity retrieves a list of all the resource pools.

...

The List Resource Pools activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • Datacenter Name (text box editor type) (type: string): the name of the Datacenter.
  • Cluster Name (text box editor type) (type: string): the name of the Cluster.
  • Path (text box editor type) (type: string): thepath where the desired Resource Pool is. If left empty it will return the Parent Resource Pool. For example: ResourcePoolName1/ResourcePoolName2/DesiredResourcePool.

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the List Resource Pools activity:

Image Removed


The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: collection<string>): outputs a collection of Resource Pools found on the specified path.
 

Image Removed

In order to extract the values from the ListResPools output collection , For Each and Log Track Data activities should be used:

Image Added


Execution: The example below is an execution where all multipaths are returned for DemoDatastore datastore:

Image Added

 

Remove Resource Pool

This activity removes the specified Resource Pool..

...

The Remove Resource Pool activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

    • Resource Pool ID (text box editor type) (type: string): the ID of the Resource Pool.
      The value can also be obtained from activity: Get Resource Pool
    or bind this parameter with the output parameter from
    • using the following steps:
      • use a Get Resource Pool activity
    .
      • to extract the ResourcePoolID: 
         Image Added
      • bind the obtained ResourcePoolID(stored in variable) to the Resource Pool ID field from Remove Resource Pool activity: 
           Image Added


The Read Only Output variable are the possible output values that the activity will provide:

...