ngine_io.cloudstack.cs_ip_address – Manages public IP address associations 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_ip_address
.
New in version 0.1.0: of ngine_io.cloudstack
Synopsis¶
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.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 2.6
cs >= 0.9.0
Parameters¶
Notes¶
Note
A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.
This module supports check mode.
Examples¶
- 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: 1.2.3.4
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
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Darren Worrall (@dazworrall)
René Moser (@resmo)