ngine_io.cloudstack.cs_router – Manages routers 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_router
.
New in version 0.1.0: of ngine_io.cloudstack
Synopsis¶
Start, restart, stop and destroy routers.
state=present is not able to create routers, use cs_network instead.
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¶
# Ensure the router has the desired service offering, no matter if
# the router is running or not.
- name: Present router
ngine_io.cloudstack.cs_router:
name: r-40-VM
service_offering: System Offering for Software Router
- name: Ensure started
ngine_io.cloudstack.cs_router:
name: r-40-VM
state: started
# Ensure started with desired service offering.
# If the service offerings changes, router will be rebooted.
- name: Ensure started with desired service offering
ngine_io.cloudstack.cs_router:
name: r-40-VM
service_offering: System Offering for Software Router
state: started
- name: Ensure stopped
ngine_io.cloudstack.cs_router:
name: r-40-VM
state: stopped
- name: Remove a router
ngine_io.cloudstack.cs_router:
name: r-40-VM
state: absent
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
René Moser (@resmo)