ec2_elb – De-registers or registers instances from EC2 ELBs

• Synopsis
• Requirements
• Parameters
• Notes
• Examples
• Status

Synopsis

• This module de-registers or registers an AWS EC2 instance from the ELBs that it belongs to.
• Returns fact “ec2_elbs” which is a list of elbs attached to the instance if state=absent is passed as an argument.
• Will be marked changed when called only if there are ELBs found to operate on.

Requirements

The below requirements are needed on the host that executes this module.

• python >= 2.6
• boto

Parameters

Notes

Examples

# basic pre_task and post_task example
pre_tasks:
  - name: Gathering ec2 facts
    action: ec2_facts
  - name: Instance De-register
    local_action:
      module: ec2_elb
      instance_id: "{{ ansible_ec2_instance_id }}"
      state: absent
roles:
  - myrole
post_tasks:
  - name: Instance Register
    local_action:
      module: ec2_elb
      instance_id: "{{ ansible_ec2_instance_id }}"
      ec2_elbs: "{{ item }}"
      state: present
    loop: "{{ ec2_elbs }}"

Status

• This module is guaranteed to have backward compatible interface changes going forward. [stableinterface]
• This module is maintained by the Ansible Community. [community]

Authors

• John Jarvis (@jarv)