ANSIBLE.EC2_GROUP(3)

NAME
ec2_group - maintain an ec2 VPC security group.

DESCRIPTION

maintains ec2 security groups. This module has a dependency on python-boto >= 2.5

OPTIONS

description
    Description of the security group.(required)

ec2_access_key
    EC2 access key

ec2_secret_key
    EC2 secret key

ec2_url
    Url to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints)

name
    Name of the security group.(required)

region
    the EC2 region to use

rules
    List of firewall rules to enforce in this group (see example).(required)

state
    create or delete security group (default: present)(Added in Ansible version 1.4.)

vpc_id
    ID of the VPC to create the group in..

EXAMPLES
- name: example ec2 group
  local_action:
    module: ec2_group
    name: example
    description: an example EC2 group
    vpc_id: 12345
    region: eu-west-1a
    ec2_secret_key: SECRET
    ec2_access_key: ACCESS
    rules:
      - proto: tcp
        from_port: 80
        to_port: 80
        cidr_ip: 0.0.0.0/0
      - proto: tcp
        from_port: 22
        to_port: 22
        cidr_ip: 10.0.0.0/8
      - proto: udp
        from_port: 10050
        to_port: 10050
        cidr_ip: 10.0.0.0/8
      - proto: udp
        from_port: 10051
        to_port: 10051
        group_id: abcdef

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#ec2-group