ec2_elb - De-registers or registers instances from EC2 ELBs

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

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
    with_items: "{{ ec2_elbs }}"

Status

This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Author

• John Jarvis (@jarv)