ngine_io.cloudstack.cs_ip_address – Manages public IP address associations on Apache CloudStack based clouds.
This plugin is part of the ngine_io.cloudstack collection (version 2.2.2).
You might already have this collection installed if you are using the
It is not included in
To check whether it is installed, run
ansible-galaxy collection list.
To install it, use:
ansible-galaxy collection install ngine_io.cloudstack.
To use it in a playbook, specify:
New in version 0.1.0: of ngine_io.cloudstack
Acquires and associates a public IP to an account or project.
Due to API limitations this is not an idempotent call, so be sure to only conditionally call this when state=present.
Tagging the IP address can also make the call idempotent.
The below requirements are needed on the host that executes this module.
python >= 2.6
cs >= 0.9.0
A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.
This module supports check mode.
- name: Associate an IP address conditionally ngine_io.cloudstack.cs_ip_address: network: My Network zone: zone01 register: ip_address when: instance.public_ip is undefined - name: Disassociate an IP address ngine_io.cloudstack.cs_ip_address: ip_address: 220.127.116.11 zone: zone01 state: absent - name: Associate an IP address with tags ngine_io.cloudstack.cs_ip_address: network: My Network zone: zone01 tags: - key: myCustomID value: 5510c31a-416e-11e8-9013-02000a6b00bf register: ip_address - name: Disassociate an IP address with tags ngine_io.cloudstack.cs_ip_address: state: absent zone: zone01 tags: - key: myCustomID value: 5510c31a-416e-11e8-9013-02000a6b00bf
Common return values are documented here, the following are the fields unique to this module: