Surgo /

Ansible Collection for Community AWS

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Community AWS Collection

Shippable build status

The Ansible Community AWS collection includes a variety of Ansible content to help automate the management of AWS instances. This collection is maintained by the Ansible community.

AWS related modules and plugins supported by the Ansible Cloud team are in the collection.

Ansible version compatibility

This collection has been tested against following Ansible versions: >=2.9.10.

Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions. PEP440 is the schema used to describe the versions of Ansible.

Python version compatibility

This collection depends on the AWS SDK for Python (Boto3 and Botocore). As AWS has ceased supporting Python 2.6, this collection requires Python 2.7 or greater.

Included content

Connection plugins

Name Description execute via AWS Systems Manager


Name Description Upload and delete certificates in the AWS Certificate Manager service Retrieve certificate information from AWS Certificate Manager service Manage AWS API Gateway APIs Manage Application Auto Scaling Scaling Policies Manage AWS Batch Compute Environments Manage AWS Batch Job Definitions Manage AWS Batch Job Queues Create or delete an AWS CodeBuild project Manage repositories in AWS CodeCommit Create or delete AWS CodePipelines Manage cross-account AWS Config authorizations Manage AWS Config aggregations across multiple accounts Manage AWS Config delivery channels Manage AWS Config Recorders Manage AWS Config resources Confirms the creation of a hosted DirectConnect connection. Creates, deletes, modifies a DirectConnect connection Manage AWS Direct Connect gateway Manage Direct Connect LAG bundles Manage Direct Connect virtual interfaces Manage Elastic Kubernetes Service Clusters Create, update, and delete an elastic beanstalk application Manage an AWS Glue connection Manage an AWS Glue job Create, Update and Delete Amazon Inspector Assessment Targets Perform various KMS management tasks. Gather information about AWS KMS keys Gather information about AWS regions. Lists S3 buckets in AWS Manage CORS for S3 buckets in AWS Manage secrets stored in AWS Secrets Manager. Manages SES email and domain identity Manages SES sending authorization policies Manages SES inbound receipt rule sets Fetch AWS Storage Gateway information Manage key-value pairs in aws parameter store. Manage AWS Step Functions state machines Start or stop execution of an AWS Step Functions state machine. Create and delete WAF Conditions Retrieve information for WAF ACLs, Rule , Conditions and Filters. Create and delete WAF Rules Create and delete WAF Web ACLs. Read a value from CloudFormation Exports Manage groups of CloudFormation stacks Create, update and delete AWS CloudFront distributions. Obtain facts about an AWS CloudFront distribution create invalidations for AWS CloudFront distributions Create, update and delete origin access identities for a CloudFront distribution manage CloudTrail create, delete, update Manage CloudWatch Event rules and targets create or delete log_group in CloudWatchLogs Get information about log_group in CloudWatchLogs Manage CloudWatch log group metric filter Create and manage AWS Datapipelines Creates or destroys a data migration services endpoint creates or destroys a data migration services subnet group Create, update or delete AWS Dynamo DB tables Set TTL for a given DynamoDB table copies AMI between AWS regions, return new image id Create or delete AWS AutoScaling Groups (ASGs) Gather information about ec2 Auto Scaling Groups (ASGs) in AWS Create, delete or update AWS ASG Lifecycle Hooks. Manage an AWS customer gateway Gather information about customer gateways in AWS manages EC2 elastic IP (EIP) addresses. List EC2 EIP details De-registers or registers instances from EC2 ELBs Gather information about EC2 Elastic Load Balancers in AWS Create & manage EC2 instances Gather information about ec2 instances in AWS Manage EC2 launch templates Create or delete AWS Autoscaling Launch Configurations Find AWS Autoscaling Launch Configurations Gather information about AWS Autoscaling Launch Configurations. Create/update or delete AWS Cloudwatch 'metric alarms' Create or delete an EC2 Placement Group List EC2 Placement Group(s) details Create or delete AWS scaling policies for Autoscaling groups Copies an EC2 snapshot and returns the new Snapshot ID. Create and delete AWS Transit Gateways Gather information about ec2 transit gateways in AWS Manage an AWS VPC Egress Only Internet gateway Create and delete AWS VPC Endpoints. Retrieves AWS VPC endpoints details using AWS methods. Manage an AWS VPC Internet gateway Gather information about internet gateways in AWS create and delete Network ACLs. Gather information about Network ACLs in an AWS VPC Manage AWS VPC NAT Gateways. Retrieves AWS VPC Managed Nat Gateway details using AWS methods. create, delete, accept, and reject VPC peering connections between two VPCs. Retrieves AWS VPC Peering details using AWS methods. Manage route tables for AWS virtual private clouds Gather information about ec2 VPC route tables in AWS Create and delete AWS VPN Virtual Gateways. Gather information about virtual gateways in AWS Create, modify, and delete EC2 VPN connections. Gather information about VPN Connections in AWS. Gets the default administrator password for ec2 windows instances manage ecs attributes Create or terminate ECS clusters. Manage Elastic Container Registry repositories Create, terminate, start or stop a service in ECS List or describe services in ECS create and remove tags on Amazon ECS resources Run, start or stop a task in ecs register a task definition in ecs Describe a task definition in ECS create and maintain EFS file systems Get information about Amazon EFS file systems Manage cache clusters in Amazon ElastiCache Retrieve information for AWS ElastiCache clusters Manage cache parameter groups in Amazon ElastiCache. Manage cache snapshots in Amazon ElastiCache manage ElastiCache subnet groups Manage an Application Load Balancer Gather information about application ELBs in AWS Creates or destroys Amazon ELB. Gather information about EC2 Elastic Load Balancers in AWS De-registers or registers instances from EC2 ELBs Manage a Network Load Balancer Manage a target in a target group Manage a target group for an Application or Network load balancer Gather information about ELB target groups in AWS Gathers which target groups a target is associated with. Execute an AWS Lambda function Manage IAM users, groups, roles and keys Manage server certificates for use on ELBs and CloudFront Manage AWS IAM groups Manage User Managed IAM policies List the MFA (Multi-Factor Authentication) devices registered for a user Update an IAM Password Policy Manage inline IAM policies for users, groups, and roles Retrieve inline IAM policies for users, groups, and roles Manage AWS IAM roles Gather information on IAM roles Maintain IAM SAML federation configuration. Retrieve the information of a server certificate Manage AWS IAM users Gather IAM user(s) facts in AWS Manage a Kinesis Stream. Manage AWS Lambda functions Creates, updates or deletes AWS Lambda function aliases Creates, updates or deletes AWS Lambda function event mappings Gathers AWS Lambda function details as Ansible facts Gathers AWS Lambda function details Creates, updates or deletes AWS Lambda policy statements. Manage instances in AWS Lightsail create, delete, or modify Amazon rds instances, rds snapshots, and related facts Manage RDS instances obtain information about one or more RDS instances manage RDS parameter groups manage Amazon RDS snapshots. obtain information about one or more RDS snapshots manage RDS database subnet groups create, delete, or modify an Amazon Redshift instance Manage Redshift Cross Region Snapshots Gather information about Redshift cluster(s) manage Redshift cluster subnet groups add or delete entries in Amazons Route 53 DNS service Add or delete health-checks in Amazons Route53 DNS service Retrieves route53 details using AWS methods add or delete Route53 zones Creates, updates or deletes S3 Bucket notification for lambda Manage s3 bucket lifecycle rules in AWS Manage logging facility of an s3 bucket in AWS Manage s3 bucket metrics configuration in AWS Efficiently upload multiple files to S3 Configure an s3 bucket as a website Send Amazon Simple Notification Service messages Manages AWS SNS topics and subscriptions Creates or deletes AWS SQS queues Assume a role using AWS Security Token Service and obtain temporary credentials Obtain a session token from the AWS Security Token Service

Installing this collection

You can install the AWS collection with the Ansible Galaxy CLI:

ansible-galaxy collection install

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

  - name:

A specific version of the collection can be installed by using the version keyword in the requirements.yml file:

  - name:
    version: 0.1.1

You can either call modules by their Fully Qualified Collection Namespace (FQCN), such as, or you can call modules by their short name if you list the collection in the playbook's collections keyword:

  - name: Create a DB instance using the default AWS KMS encryption key
      id: test-encrypted-db
      state: present
      engine: mariadb
      storage_encrypted: True
      db_instance_class: db.t2.medium
      username: "{{ username }}"
      password: "{{ password }}"
      allocated_storage: "{{ allocated_storage }}"

See Also:

Contributing to this collection

We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the Community AWS collection repository.

You can also join us on:

  • Freenode IRC - #ansible-aws Freenode channel

More information about contributing

Release notes


More information


GNU General Public License v3.0 or later.

See LICENSE to see the full text.


Ansible Collection for Community AWS

License:GNU General Public License v3.0


Language:Python 99.1%Language:Shell 0.5%Language:HTML 0.4%