ec2_snapshot - creates a snapshot from an existing volume

Author:Will Thames

Synopsis

New in version 1.5.

creates an EC2 snapshot from an existing EBS volume

Options

parameter required default choices comments
description no
    description to be applied to the snapshot
    device_name no
      device name of a mounted volume to be snapshotted
      ec2_access_key no None
        AWS access key. If not set then the value of the AWS_ACCESS_KEY environment variable is used.
        ec2_secret_key no None
          AWS secret key. If not set then the value of the AWS_SECRET_KEY environment variable is used.
          ec2_url no
            Url to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints). Must be specified if region is not used. If not set then the value of the EC2_URL environment variable, if any, is used
            instance_id no
              instance that has a the required volume to snapshot mounted
              region no
                The AWS region to use. If not specified then the value of the EC2_REGION environment variable, if any, is used.
                volume_id no
                  volume from which to take the snapshot

                  Note

                  Requires boto

                  Examples


                  # Simple snapshot of volume using volume_id
                  - local_action:
                      module: ec2_snapshot
                      volume_id: vol-abcdef12
                      description: snapshot of /data from DB123 taken 2013/11/28 12:18:32
                  
                  # Snapshot of volume mounted on device_name attached to instance_id
                  - local_action:
                      module: ec2_snapshot
                      instance_id: i-12345678
                      device_name: /dev/sdb1
                      description: snapshot of /data from DB123 taken 2013/11/28 12:18:32
                  

                  Table Of Contents

                  Previous topic

                  ec2_key - maintain an ec2 key pair.

                  Next topic

                  ec2_tag - create and remove tag(s) to ec2 resources.