ANSIBLE.EC2_GROUP(3)            ANSIBLE MODULES           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



1.4.5                             2014-02-12              ANSIBLE.EC2_GROUP(3)
