ngine_io.cloudstack.cs_instance_nic_secondaryip – Manages secondary IPs of an instance on Apache CloudStack based clouds.

Note

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 ansible package. It is not included in ansible-core. 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: ngine_io.cloudstack.cs_instance_nic_secondaryip.

New in version 0.1.0: of ngine_io.cloudstack

Synopsis

  • Add and remove secondary IPs to and from a NIC of an instance.

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
account
string
Account the instance is related to.
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.
domain
string
Domain the instance is related to.
network
string
Name of the network.
Required to find the NIC if instance has multiple networks assigned.
poll_async
boolean
    Choices:
  • no
  • yes
Poll async jobs until job has finished.
project
string
Name of the project the instance is deployed in.
state
string
    Choices:
  • present
  • absent
State of the ipaddress.
vm
string / required
Name of instance.

aliases: name
vm_guest_ip
string
Secondary IP address to be added to the instance nic.
If not set, the API always returns a new IP address and idempotency is not given.

aliases: secondary_ip
vpc
string
Name of the VPC the vm is related to.
zone
string / required
Name of the zone in which the instance is deployed in.

Notes

Note

  • A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.
  • This module supports check mode.

Examples

- name: Assign a specific IP to the default NIC of the VM
  ngine_io.cloudstack.cs_instance_nic_secondaryip:
    vm: customer_xy
    zone: zone01
    vm_guest_ip: 10.10.10.10

# Note: If vm_guest_ip is not set, you will get a new IP address on every run.
- name: Assign an IP to the default NIC of the VM
  ngine_io.cloudstack.cs_instance_nic_secondaryip:
    vm: customer_xy
    zone: zone01

- name: Remove a specific IP from the default NIC
  ngine_io.cloudstack.cs_instance_nic_secondaryip:
    vm: customer_xy
    zone: zone01
    vm_guest_ip: 10.10.10.10
    state: absent

Return Values

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

Key Returned Description
account
string
success
Account the VM is related to.

Sample:
example account
domain
string
success
Domain the VM is related to.

Sample:
example domain
id
string
success
UUID of the NIC.

Sample:
87b1e0ce-4e01-11e4-bb66-0050569e64b8
ip_address
string
success
Primary IP of the NIC.

Sample:
10.10.10.10
mac_address
string
success
MAC address of the NIC.

Sample:
02:00:33:31:00:e4
netmask
string
success
Netmask of the NIC.

Sample:
255.255.255.0
network
string
success
Name of the network if not default.

Sample:
sync network
project
string
success
Name of project the VM is related to.

Sample:
Production
vm
string
success
Name of the VM.

Sample:
web-01
vm_guest_ip
string
success
Secondary IP of the NIC.

Sample:
10.10.10.10


Authors

  • René Moser (@resmo)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_instance_nic_secondaryip_module.html