#NEWLINE# def get( bucket = None , path = None , return_bin = False , action = None , local_file = None , key = None , keyid = None , service_url = None , verify_ssl = None , kms_keyid = None , location = None , role_arn = None ) : #NEWLINE# #INDENT# '\n    List the contents of a bucket, or return an object from a bucket. Set\n    return_bin to True in order to retrieve an object wholesale. Otherwise,\n    Salt will attempt to parse an XML response.\n\n    CLI Example to list buckets:\n\n    .. code-block:: bash\n\n        salt myminion s3.get\n\n    CLI Example to list the contents of a bucket:\n\n    .. code-block:: bash\n\n        salt myminion s3.get mybucket\n\n    CLI Example to return the binary contents of an object:\n\n    .. code-block:: bash\n\n        salt myminion s3.get mybucket myfile.png return_bin=True\n\n    CLI Example to save the binary contents of an object to a local file:\n\n    .. code-block:: bash\n\n        salt myminion s3.get mybucket myfile.png local_file=/tmp/myfile.png\n\n    It is also possible to perform an action on a bucket. Currently, S3\n    supports the following actions::\n\n        acl\n        cors\n        lifecycle\n        policy\n        location\n        logging\n        notification\n        tagging\n        versions\n        requestPayment\n        versioning\n        website\n\n    To perform an action on a bucket:\n\n    .. code-block:: bash\n\n        salt myminion s3.get mybucket myfile.png action=acl\n    ' #NEWLINE# ( key , keyid , service_url , verify_ssl , kms_keyid , location , role_arn ) = _get_key ( key , keyid , service_url , verify_ssl , kms_keyid , location , role_arn ) #NEWLINE# return salt . utils . s3 . query ( method = 'GET' , bucket = bucket , path = path , return_bin = return_bin , local_file = local_file , action = action , key = key , keyid = keyid , kms_keyid = kms_keyid , service_url = service_url , verify_ssl = verify_ssl , location = location , role_arn = role_arn )