ngine_io.cloudstack.cs_disk_offering – Manages disk offerings on Apache CloudStack based clouds.

Note

This plugin is part of the ngine_io.cloudstack collection (version 2.1.0).

To install it use: ansible-galaxy collection install ngine_io.cloudstack.

To use it in a playbook, specify: ngine_io.cloudstack.cs_disk_offering.

New in version 0.1.0: of ngine_io.cloudstack

Synopsis

• Create and delete disk offerings for guest VMs.

• Update display_text or display_offering of existing disk offering.

Requirements

The below requirements are needed on the host that executes this module.

• python >= 2.6

• cs >= 0.9.0

Parameters

Parameter	Choices/Defaults	Comments
api_http_method string	Choices: get ← post	HTTP method used to query the API endpoint. If not given, the CLOUDSTACK_METHOD env variable is considered.
api_key string / required		API key of the CloudStack API. If not given, the CLOUDSTACK_KEY env variable is considered.
api_secret string / required		Secret key of the CloudStack API. If not set, the CLOUDSTACK_SECRET env variable is considered.
api_timeout integer	Default: 10	HTTP timeout in seconds. If not given, the CLOUDSTACK_TIMEOUT env variable is considered.
api_url string / required		URL of the CloudStack API e.g. https://cloud.example.com/client/api. If not given, the CLOUDSTACK_ENDPOINT env variable is considered.
api_verify_ssl_cert string		Verify CA authority cert file. If not given, the CLOUDSTACK_VERIFY env variable is considered.
bytes_read_rate integer		Bytes read rate of the disk offering.
bytes_write_rate integer		Bytes write rate of the disk offering.
customized boolean	Choices: no yes	Whether disk offering iops is custom or not.
disk_size integer		Size of the disk offering in GB (1GB = 1,073,741,824 bytes).
display_offering boolean	Choices: no yes	An optional field, whether to display the offering to the end user or not.
display_text string		Display text of the disk offering. If not set, name will be used as display_text while creating.
domain string		Domain the disk offering is related to. Public for all domains and subdomains if not set.
hypervisor_snapshot_reserve integer		Hypervisor snapshot reserve space as a percent of a volume. Only for managed storage using Xen or VMware.
iops_max integer		Max. iops of the disk offering.
iops_min integer		Min. iops of the disk offering.
iops_read_rate integer		IO requests read rate of the disk offering.
iops_write_rate integer		IO requests write rate of the disk offering.
name string / required		Name of the disk offering.
provisioning_type string	Choices: thin sparse fat	Provisioning type used to create volumes.
state string	Choices: present ← absent	State of the disk offering.
storage_tags list / elements=string		The storage tags for this disk offering. aliases: storage_tag
storage_type string	Choices: local shared	The storage type of the disk offering.

Notes

Note

• A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.

• This module supports check mode.

Examples

- name: Create a disk offering with local storage
  ngine_io.cloudstack.cs_disk_offering:
    name: small
    display_text: Small 10GB
    disk_size: 10
    storage_type: local

- name: Create or update a disk offering with shared storage
  ngine_io.cloudstack.cs_disk_offering:
    name: small
    display_text: Small 10GB
    disk_size: 10
    storage_type: shared
    storage_tags: SAN01

- name: Remove a disk offering
  ngine_io.cloudstack.cs_disk_offering:
    name: small
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
bytes_read_rate integer	success	Bytes read rate of the disk offering Sample: 1000
bytes_write_rate integer	success	Bytes write rate of the disk offering Sample: 1000
created string	success	Date the offering was created Sample: 2017-11-19T10:48:59+0000
customized boolean	success	Whether the offering uses custom IOPS or not
disk_size integer	success	Size of the disk offering in GB Sample: 10
display_offering boolean	success	Whether to display the offering to the end user or not.
display_text string	success	Display text of the offering Sample: Small 10GB
domain string	success	Domain the offering is into Sample: ROOT
id string	success	UUID of the disk offering Sample: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
iops_max integer	success	Max iops of the disk offering Sample: 1000
iops_min integer	success	Min iops of the disk offering Sample: 500
iops_read_rate integer	success	IO requests per second read rate of the disk offering Sample: 1000
iops_write_rate integer	success	IO requests per second write rate of the disk offering Sample: 1000
name string	success	Name of the system offering Sample: Micro
provisioning_type string	success	Provisioning type used to create volumes Sample: thin
storage_tags list / elements=string	success	List of storage tags Sample: ['eco']
storage_type string	success	Storage type used to create volumes Sample: shared

Authors

• David Passante (@dpassante)

• René Moser (@resmo)