ansible / ansible.builtin / v2.3.2.0-1 / module / cs_nic Manages NICs and secondary IPs of an instance on Apache CloudStack based clouds. | "added in version" 2.3 of ansible.builtin" Authors: René Moser (@resmo) stableinterface | supported by communityansible.builtin.cs_nic (v2.3.2.0-1) — module
pip
Install with pip install ansible==2.3.2.0.post1
Add and remove secondary IPs to and from a NIC.
# Assign a specific IP to the default NIC of the VM - local_action: module: cs_nic vm: customer_xy vm_guest_ip: 10.10.10.10
# Assign an IP to the default NIC of the VM # Note: If vm_guest_ip is not set, you will get a new IP address on every run. - local_action: module: cs_nic vm: customer_xy
# Remove a specific IP from the default NIC - local_action: module: cs_nic vm: customer_xy vm_guest_ip: 10.10.10.10 state: absent
vm: aliases: - name description: - Name of instance. required: true vpc: default: null description: - Name of the VPC the C(vm) is related to. required: false zone: default: null description: - Name of the zone in which the instance is deployed in. - If not set, default zone is used. required: false state: choices: - present - absent default: present description: - State of the ipaddress. required: false domain: default: null description: - Domain the instance is related to. required: false account: default: null description: - Account the instance is related to. required: false api_key: description: - API key of the CloudStack API. - If not given, the C(CLOUDSTACK_KEY) env variable is considered. required: true type: str api_url: description: - URL of the CloudStack API e.g. https://cloud.example.com/client/api. - If not given, the C(CLOUDSTACK_ENDPOINT) env variable is considered. required: true type: str network: default: null description: - Name of the network. - Required to find the NIC if instance has multiple networks assigned. required: false project: default: null description: - Name of the project the instance is deployed in. required: false api_secret: description: - Secret key of the CloudStack API. - If not set, the C(CLOUDSTACK_SECRET) env variable is considered. required: true type: str poll_async: default: true description: - Poll async jobs until job has finished. required: false api_timeout: default: 10 description: - HTTP timeout in seconds. - If not given, the C(CLOUDSTACK_TIMEOUT) env variable is considered. type: int vm_guest_ip: aliases: - secondary_ip default: null description: - 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. required: false api_http_method: choices: - get - post default: get description: - HTTP method used to query the API endpoint. - If not given, the C(CLOUDSTACK_METHOD) env variable is considered. type: str api_verify_ssl_cert: description: - Verify CA authority cert file. - If not given, the C(CLOUDSTACK_VERIFY) env variable is considered. type: str
account: description: Account the VM is related to. returned: success sample: example account type: string domain: description: Domain the VM is related to. returned: success sample: example domain type: string id: description: UUID of the nic. returned: success sample: 87b1e0ce-4e01-11e4-bb66-0050569e64b8 type: string ip_address: description: Primary IP of the NIC. returned: success sample: 10.10.10.10 type: string mac_address: description: MAC address of the NIC. returned: success sample: 02:00:33:31:00:e4 type: string netmask: description: Netmask of the NIC. returned: success sample: 255.255.255.0 type: string network: description: Name of the network if not default. returned: success sample: sync network type: string project: description: Name of project the VM is related to. returned: success sample: Production type: string vm: description: Name of the VM. returned: success sample: web-01 type: string vm_guest_ip: description: Secondary IP of the NIC. returned: success sample: 10.10.10.10 type: string