??????????????
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 173
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 174
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 175
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 176
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 177
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 178
Udac @ s i d d 6d g d 6d d 6Z d Z d Z d Z d d
l Z d d
l Z d d l m Z d d l m Z d d
l
m Z m Z d d l
m Z d d l m Z m Z d d l m Z m Z y d d
l Z Wn e k
r n Xd d g Z d e f d YZ e e d Z e d Z e d Z e d Z e d Z d Z! d Z" d Z# d Z$ d Z% d Z& d Z' d! Z( e d" Z) e e d# Z* e d$ Z+ d% Z, e- d& Z. d' Z/ e0 d( k re/ n d
S() s 1.1t metadata_versiont stableinterfacet statust coret supported_bys
---
module: aws_s3
short_description: manage objects in S3.
description:
- This module allows the user to manage S3 buckets and the objects within them. Includes support for creating and
deleting both objects and buckets, retrieving objects as files or strings and generating download links.
This module has a dependency on boto3 and botocore.
notes:
- In 2.4, this module has been renamed from C(s3) into M(aws_s3).
version_added: "1.1"
options:
aws_access_key:
description:
- AWS access key id. If not set then the value of the AWS_ACCESS_KEY environment variable is used.
aliases: [ 'ec2_access_key', 'access_key' ]
aws_secret_key:
description:
- AWS secret key. If not set then the value of the AWS_SECRET_KEY environment variable is used.
aliases: ['ec2_secret_key', 'secret_key']
bucket:
description:
- Bucket name.
required: true
dest:
description:
- The destination file path when downloading an object/key with a GET operation.
version_added: "1.3"
encrypt:
description:
- When set for PUT mode, asks for server-side encryption.
default: True
version_added: "2.0"
type: bool
encryption_mode:
description:
- What encryption mode to use if C(encrypt) is set
default: AES256
choices:
- AES256
- aws:kms
version_added: "2.7"
expiration:
description:
- Time limit (in seconds) for the URL generated and returned by S3/Walrus when performing a mode=put or mode=geturl operation.
default: 600
headers:
description:
- Custom headers for PUT operation, as a dictionary of 'key=value' and 'key=value,key=value'.
version_added: "2.0"
marker:
description:
- Specifies the key to start with when using list mode. Object keys are returned in alphabetical order, starting with key after the marker in order.
version_added: "2.0"
max_keys:
description:
- Max number of results to return in list mode, set this if you want to retrieve fewer than the default 1000 keys.
default: 1000
version_added: "2.0"
metadata:
description:
- Metadata for PUT operation, as a dictionary of 'key=value' and 'key=value,key=value'.
version_added: "1.6"
mode:
description:
- Switches the module behaviour between put (upload), get (download), geturl (return download url, Ansible 1.3+),
getstr (download object as string (1.3+)), list (list keys, Ansible 2.0+), create (bucket), delete (bucket),
and delobj (delete object, Ansible 2.0+).
required: true
choices: ['get', 'put', 'delete', 'create', 'geturl', 'getstr', 'delobj', 'list']
object:
description:
- Keyname of the object inside the bucket. Can be used to create "virtual directories", see examples.
permission:
description:
- This option lets the user set the canned permissions on the object/bucket that are created.
The permissions that can be set are 'private', 'public-read', 'public-read-write', 'authenticated-read' for a bucket or
'private', 'public-read', 'public-read-write', 'aws-exec-read', 'authenticated-read', 'bucket-owner-read',
'bucket-owner-full-control' for an object. Multiple permissions can be specified as a list.
default: private
version_added: "2.0"
prefix:
description:
- Limits the response to keys that begin with the specified prefix for list mode
default: ""
version_added: "2.0"
version:
description:
- Version ID of the object inside the bucket. Can be used to get a specific version of a file if versioning is enabled in the target bucket.
version_added: "2.0"
overwrite:
description:
- Force overwrite either locally on the filesystem or remotely with the object/key. Used with PUT and GET operations.
Boolean or one of [always, never, different], true is equal to 'always' and false is equal to 'never', new in 2.0.
When this is set to 'different', the md5 sum of the local file is compared with the 'ETag' of the object/key in S3.
The ETag may or may not be an MD5 digest of the object data. See the ETag response header here
U(https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html)
default: 'always'
aliases: ['force']
version_added: "1.2"
region:
description:
- "AWS region to create the bucket in. If not set then the value of the AWS_REGION and EC2_REGION environment variables
are checked, followed by the aws_region and ec2_region settings in the Boto config file. If none of those are set the
region defaults to the S3 Location: US Standard. Prior to ansible 1.8 this parameter could be specified but had no effect."
version_added: "1.8"
retries:
description:
- On recoverable failure, how many times to retry before actually failing.
default: 0
version_added: "2.0"
s3_url:
description:
- S3 URL endpoint for usage with Ceph, Eucalyptus and fakes3 etc. Otherwise assumes AWS.
aliases: [ S3_URL ]
dualstack:
description:
- Enables Amazon S3 Dual-Stack Endpoints, allowing S3 communications using both IPv4 and IPv6.
- Requires at least botocore version 1.4.45.
type: bool
default: "no"
version_added: "2.7"
rgw:
description:
- Enable Ceph RGW S3 support. This option requires an explicit url via s3_url.
default: false
version_added: "2.2"
type: bool
src:
description:
- The source file path when performing a PUT operation.
version_added: "1.3"
ignore_nonexistent_bucket:
description:
- "Overrides initial bucket lookups in case bucket or iam policies are restrictive. Example: a user may have the
GetObject permission but no other permissions. In this case using the option mode: get will fail without specifying
ignore_nonexistent_bucket: True."
version_added: "2.3"
type: bool
encryption_kms_key_id:
description:
- KMS key id to use when encrypting objects using C(aws:kms) encryption. Ignored if encryption is not C(aws:kms)
version_added: "2.7"
requirements: [ "boto3", "botocore" ]
author:
- "Lester Wade (@lwade)"
- "Sloane Hertel (@s-hertel)"
extends_documentation_fragment:
- aws
- ec2
s
- name: Simple PUT operation
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
src: /usr/local/myfile.txt
mode: put
- name: Simple PUT operation in Ceph RGW S3
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
src: /usr/local/myfile.txt
mode: put
rgw: true
s3_url: "http://localhost:8000"
- name: Simple GET operation
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
dest: /usr/local/myfile.txt
mode: get
- name: Get a specific version of an object.
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
version: 48c9ee5131af7a716edc22df9772aa6f
dest: /usr/local/myfile.txt
mode: get
- name: PUT/upload with metadata
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
src: /usr/local/myfile.txt
mode: put
metadata: 'Content-Encoding=gzip,Cache-Control=no-cache'
- name: PUT/upload with custom headers
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
src: /usr/local/myfile.txt
mode: put
headers: 'x-amz-grant-full-control=emailAddress=owner@example.com'
- name: List keys simple
aws_s3:
bucket: mybucket
mode: list
- name: List keys all options
aws_s3:
bucket: mybucket
mode: list
prefix: /my/desired/
marker: /my/desired/0023.txt
max_keys: 472
- name: Create an empty bucket
aws_s3:
bucket: mybucket
mode: create
permission: public-read
- name: Create a bucket with key as directory, in the EU region
aws_s3:
bucket: mybucket
object: /my/directory/path
mode: create
region: eu-west-1
- name: Delete a bucket and all contents
aws_s3:
bucket: mybucket
mode: delete
- name: GET an object but don't download if the file checksums match. New in 2.0
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
dest: /usr/local/myfile.txt
mode: get
overwrite: different
- name: Delete an object from a bucket
aws_s3:
bucket: mybucket
object: /my/desired/key.txt
mode: delobj
s
msg:
description: msg indicating the status of the operation
returned: always
type: str
sample: PUT operation complete
url:
description: url of the object
returned: (for put and geturl operations)
type: str
sample: https://my-bucket.s3.amazonaws.com/my-key.txt?AWSAccessKeyId=&Expires=1506888865&Signature=
expiry:
description: number of seconds the presigned url is valid for
returned: (for geturl operation)
type: int
sample: 600
contents:
description: contents of the object as string
returned: (for getstr operation)
type: str
sample: "Hello, world!"
s3_keys:
description: list of object keys
returned: (for list operation)
type: list
sample:
- prefix1/
- prefix1/key1
- prefix1/key2
iN( t urlparse( t SSLError( t to_textt to_native( t AnsibleAWSModule( t calculate_etagt HAS_MD5( t get_aws_connection_infot
boto3_connt XNotImplementedt NotImplementedt
Sigv4Requiredc B s e Z RS( ( t __name__t
__module__( ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyR = s c C s t } y? | r. | j d | d | d | n | j d | d | Wn t j j k
r } t | j d d } | d k r t } q | d k r | t k r q | j | d d | n0 t j j k
r } | j | d d | n X| S(
Nt Buckett Keyt VersionIdt Errort Codei i t msgs5 Failed while looking up object (during key check) %s.(
t Truet head_objectt botocoret
exceptionst ClientErrort intt responset Falset
fail_json_awst
BotoCoreError( t modulet s3t buckett objt versiont validatet existst et
error_code( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt key_checkA s c C s@ t | | | d | } t | | | | | | | } | | k S( NR' ( t get_etagR
( R# t
local_fileR$ R% R& R' t s3_etagt
local_etag( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt etag_compareW s c C sQ | r' | j d | d | d | } n | j d | d | } | sI d S| d S( NR R R t ETag( R t None( R$ R% R& R' R, ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyR- ^ s !c C s t } y | j d | Wn t j j k
r } t | j d d } | d k r^ t } q | d k ry | t k ry q | j | d d | n[ t j j k
r } | j | d d n0 t j j
k
r } | j | d d | n X| S( NR R R i i R s8 Failed while looking up bucket (during bucket_check) %s.s Invalid endpoint provided( R t head_bucketR R R R R R R! t EndpointConnectionErrorR" ( R# R$ R% R( R) R* R+ ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt bucket_checkh s c C sp | j r" | j d d d t n i } | d k rA | | d R R R R" R! t format( R# R$ R% t prefixt markert max_keysRO t
param_namet param_valuet keysR* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt list_keys s
.!c C s | j r" | j d d d t n y t | | | } | t k rG t Sx` t | d | D]L } g | D] } i | d 6^ qg } | rZ | j d | d i | d 6 qZ qZ W| j d | t SWn< t j j
t j j f k
r } | j | d d | n Xd S( NR s0 DELETE operation skipped - running in check modeR7 R R t Deletet Objectss Failed while deleting bucket %s.(
R= R> R R6 R RS t delete_objectst
delete_bucketR R R R" R! ( R# R$ R% R) R_ t keyt formatted_keysR* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyRd s $!c C s | j r" | j d d d t n y4 | j d | d | | j d d | d t Wn< t j j t j j f k
r } | j | d d | n Xd S( NR s0 DELETE operation skipped - running in check modeR7 R R s Object deleted from bucket %s.s! Failed while trying to delete %s.( R= R> R t
delete_objectR R R R" R! ( R# R$ R% R& R* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt
delete_key s !c C s | j r" | j d d d t n y i | d 6| d 6d d 6} | rZ | j d | d R RA t
put_objectRB t put_object_aclR R R R RF RG R! R" ( R# R$ R% R& t encryptRA RJ R* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt
create_dirkey s$
$c C s t j j | r t St Sd S( N( t ost pathR) R R ( Rt ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt
path_check s c C s | j d d j } i d d 6d d 6d d 6d d
6d d 6d
d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d! d" 6d# d$ 6d% d& 6d' d( 6d) d* 6} | | k r | | Sd S(+ Nt -Ri R< RJ t CacheControlt cachecontrolt ContentDispositiont contentdispositiont ContentEncodingt contentencodingt ContentLanguaget contentlanguaget ContentTypet contenttypet Expirest expirest GrantFullControlt grantfullcontrolt GrantReadt grantreadt GrantReadACPt grantreadacpt
GrantWriteACPt
grantwriteacpt Metadatat metadatat RequestPayert requestpayerRl t serversideencryptiont StorageClasst storageclasst SSECustomerAlgorithmt ssecustomeralgorithmt SSECustomerKeyt ssecustomerkeyt SSECustomerKeyMD5t ssecustomerkeymd5Rn t ssekmskeyidt WebsiteRedirectLocationt websiteredirectlocation( t replacet lower( t optiont temp_optiont allowed_extra_args( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt option_in_extra_args s c
C s | j r" | j d d d t n yi } | rE | j d | d R RA R R3 t mimetypest
guess_typet upload_fileR R R R" R! RB Rp R RF RG t generate_presigned_url( R# R$ R% R& t srct expiryR Rq t headerst extraR t extra_args_optiont content_typeR* RJ R ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt
upload_s3file sN
&!$
!c C s
| j r" | j d d d t n yC | rL | j d | d | d | } n | j d | d | } Wn t j j k
r } | j d d d k r d
t | k r t q| j d d d k r| j
| d d
| qn0 t j j k
r} | j
| d d
| n X| r0i i | d 6d 6n i } x t d | d D] }
y0 | j
| | | | | j d d d t WqJt j j t j j f k
r} |
| k r| j
| d d | qqJt k
r} |
| k r| j
| d d qqJXqJWd S( NR s- GET operation skipped - running in check modeR7 R R R R R t InvalidArguments require AWS Signature Version 4t 403t 404s Could not find the key %s.R i i s GET operation completes Failed while downloading %s.s s3 download failed( R R ( R= R> R t
get_objectR R R R R R R! R" t ranget
download_fileR ( R# R$ R% R& t destt retriesR' Re R* t optional_kwargst x( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt download_s3file$ s0 ! ) ! c C s< | j r" | j d d d t n y | r\ t | j d | d | d | d j } n( t | j d | d | d j } | j d d d | d t Wn t j j k
r} | j d
d d k r d
t
| k r t q8| j | d d | n0 t j j
k
r7} | j | d d | n Xd S( NR s- GET operation skipped - running in check modeR7 R R R Rj s GET operation completet contentsR R R s require AWS Signature Version 4s7 Failed while getting contents of object %s as a string.( R= R> R R R t readR R R R R R R! R" ( R# R$ R% R& R' R( R R* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt download_s3strI s 1( ) c C s yR | j d d d i | d 6| d 6d | } | j d d d | d
| d | Wn8 t j j t j j f k
r } | j | d d n Xd S(
NR R R R R R R s
Download url:R R R7 s" Failed while getting download url.( R R> R R R R" R! ( R# R$ R% R& R R7 R R* ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt get_download_url[ s &!c C s' | d k r t | j d k St Sd S( s, Return True if s3_url has scheme fakes3:// t fakes3t fakes3sN( s fakes3R ( R3 R t schemeR ( t s3_url( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt is_fakes3e s c C s | rT | rT t | } t d | d d d d d | j d k d | d | | } nt | rt | } | j } | j d
k r d } | d k r d } q n d } | d k r d
} n t d | d d d d d | d d | | j t | f d | j d
k | } n t d | d d d d d | d | | } | j d d k r{| j d d k r{t j
j d d | d }
n |
d? k rt r| j d@ dA n t
| dB t \ } } } | dd k r(dC } n | } | j j d" rl| j d" } | j dD rl| dE } qln | r|
d k r| j d@ dF n | rd. t j
k rt j
d. } n | r| d k rdG | k r| j d@ dH n | r| j dI r| j d@ dJ n | r1| r1| j d@ dK n | rdx* dL dM dN g D] } | j | d qGWn t | | | | | } | } g | j j d# D] } | | k r| ^ q} g | j j d# D] } | | k r| ^ q} g | j j d# D]$ } | | k r| | k r| ^ q}! |! r?| j d@ dO |! n t | | | dP | }" | r|
de k r|" r| j d@ dQ n |
d k rt | | | | d% | dP | }# |# t k r| r| j d@ dR | | f q| j d@ dS | n t | rm|
d( k rm|
d> k r3| j d@ dT dU t n t | | | | | d% | rm| j d@ dV dU t qmn y# t | | | | | | d% | Wqt k
rt | | | | | dW t } t | | | | | | d% | qXn |
d k rt | s| j d@ dX n |" r9t | | | | d% | dP | }# n | | j d# k st | | | | | rt | | | | | dU t qn | | j d# = 1.4.45s rgw flavour requires s3_urlt validate_certst security_tokent profile_names Unknown permission specified: %sR( s Source bucket cannot be found.s) Key %s with version id %s does not exist.s Key %s does not exist.s6 Local object already exists and overwrite is disabled.R7 sY Local and remote object are identical, ignoring. Use overwrite=always parameter to force.R s# Local object for PUT does not exists object parameter is requireds Object deleted from bucket %s.s Bucket parameter is required.s) Bucket %s and all keys have been deleted.s" Target bucket (%s) cannot be founds Bucket already exists.s Bucket created successfullys$ Bucket %s and key %s already exists.s( Bucket and Object parameters must be sett failed( s alwaysR R ( s us-east-1Ri N( R s putR (! R R R3 R R RA RB t booleanR t fail_jsonR t
startswithRs t environt botocore_at_leastt popR R6 R, Ru R> R1 R R R@ R R Rh Rd R` t endswithRr R (( R R# R% Rq R R R R[ R\ R R R& R' R RZ R R R R R R t object_canned_aclt bucket_canned_aclR t ec2_urlR RH Re R$ R( RJ t
bucket_aclt
object_aclt error_aclt bucketrtnt keyrtnt deletertnR) t dirobjt created( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt main s\ -
11= ! #
& $
$"
%
(
#
! !
t __main__(1 t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR Rs t+ ansible.module_utils.six.moves.urllib.parseR t sslR t ansible.module_utils.basicR R t ansible.module_utils.aws.coreR t ansible.module_utils.aws.s3R
R t ansible.module_utils.ec2R R
R t ImportErrorRF t ExceptionR R3 R R, R1 R- R6 R@ RS R` Rd Rh Rr Ru R R R R R R R R R R ( ( ( sG /usr/lib/python2.7/site-packages/ansible/modules/cloud/amazon/aws_s3.pyt sR
^
1 %
!