ANSIBLE.S3(3)

NAME
s3 - idempotent s3 module putting a file into S3.

DESCRIPTION

This module allows the user to dictate the presence of a given file in an S3 bucket. If or once the key (file) exists in the bucket, it returns a time-expired download url. This module has a dependency on python-boto.

OPTIONS

bucket
    bucket you wish to present/absent for the key (file in path).(required)

dest
    the destination in s3, if different from path. Used to override the object name, which is normally the same as the filename.

expiry
    expiry period (in seconds) for returned download URL. (default: 600)

overwrite
    force overwrite if a file with the same name already exists, values true/false/yes/no. Does not support files uploaded to s3 with multipart upload.(Added in Ansible version 1.2.)

path
    path to the key (file) which you wish to be present/absent in the bucket.

state
    desired state for both bucket and file.."
    # Simple PUT operation
       s3: bucket=mybucket path=/usr/local/file state=present
    # Force and overwrite if checksums don't match
       s3: bucket=mybucket path=/usr/local/file state=present overwrite=yes

AUTHOR
Lester Wade, Ralph Tice

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