Client - paws: 0.9.0 (original) (raw)

Amazon Simple Storage Service

Description

Amazon Simple Storage Service

Usage

[](#%5F%5Fcodelineno-0-1)s3(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

credentials

Optional credentials shorthand for the config parameter

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

[](#%5F%5Fcodelineno-1-1)svc <- s3( [](#%5F%5Fcodelineno-1-2) config = list( [](#%5F%5Fcodelineno-1-3) credentials = list( [](#%5F%5Fcodelineno-1-4) creds = list( [](#%5F%5Fcodelineno-1-5) access_key_id = "string", [](#%5F%5Fcodelineno-1-6) secret_access_key = "string", [](#%5F%5Fcodelineno-1-7) session_token = "string" [](#%5F%5Fcodelineno-1-8) ), [](#%5F%5Fcodelineno-1-9) profile = "string", [](#%5F%5Fcodelineno-1-10) anonymous = "logical" [](#%5F%5Fcodelineno-1-11) ), [](#%5F%5Fcodelineno-1-12) endpoint = "string", [](#%5F%5Fcodelineno-1-13) region = "string", [](#%5F%5Fcodelineno-1-14) close_connection = "logical", [](#%5F%5Fcodelineno-1-15) timeout = "numeric", [](#%5F%5Fcodelineno-1-16) s3_force_path_style = "logical", [](#%5F%5Fcodelineno-1-17) sts_regional_endpoint = "string" [](#%5F%5Fcodelineno-1-18) ), [](#%5F%5Fcodelineno-1-19) credentials = list( [](#%5F%5Fcodelineno-1-20) creds = list( [](#%5F%5Fcodelineno-1-21) access_key_id = "string", [](#%5F%5Fcodelineno-1-22) secret_access_key = "string", [](#%5F%5Fcodelineno-1-23) session_token = "string" [](#%5F%5Fcodelineno-1-24) ), [](#%5F%5Fcodelineno-1-25) profile = "string", [](#%5F%5Fcodelineno-1-26) anonymous = "logical" [](#%5F%5Fcodelineno-1-27) ), [](#%5F%5Fcodelineno-1-28) endpoint = "string", [](#%5F%5Fcodelineno-1-29) region = "string" [](#%5F%5Fcodelineno-1-30))

Operations

abort_multipart_upload

This operation aborts a multipart upload

complete_multipart_upload

Completes a multipart upload by assembling previously uploaded parts

copy_object

Creates a copy of an object that is already stored in Amazon S3

create_bucket

This action creates an Amazon S3 bucket

create_bucket_metadata_table_configuration

Creates a metadata table configuration for a general purpose bucket

create_multipart_upload

This action initiates a multipart upload and returns an upload ID

create_session

Creates a session that establishes temporary security credentials to support fast authentication and authorization for the Zonal endpoint API operations on directory buckets

delete_bucket

Deletes the S3 bucket

delete_bucket_analytics_configuration

This operation is not supported for directory buckets

delete_bucket_cors

This operation is not supported for directory buckets

delete_bucket_encryption

This implementation of the DELETE action resets the default encryption for the bucket as server-side encryption with Amazon S3 managed keys (SSE-S3)

delete_bucket_intelligent_tiering_configuration

This operation is not supported for directory buckets

delete_bucket_inventory_configuration

This operation is not supported for directory buckets

delete_bucket_lifecycle

Deletes the lifecycle configuration from the specified bucket

delete_bucket_metadata_table_configuration

Deletes a metadata table configuration from a general purpose bucket

delete_bucket_metrics_configuration

This operation is not supported for directory buckets

delete_bucket_ownership_controls

This operation is not supported for directory buckets

delete_bucket_policy

Deletes the policy of a specified bucket

delete_bucket_replication

This operation is not supported for directory buckets

delete_bucket_tagging

This operation is not supported for directory buckets

delete_bucket_website

This operation is not supported for directory buckets

delete_object

Removes an object from a bucket

delete_objects

This operation enables you to delete multiple objects from a bucket using a single HTTP request

delete_object_tagging

This operation is not supported for directory buckets

delete_public_access_block

This operation is not supported for directory buckets

download_file

Download a file from S3 and store it at a specified file location

generate_presigned_url

@title Generate a presigned url given a client, its method, and arguments

get_bucket_accelerate_configuration

This operation is not supported for directory buckets

get_bucket_acl

This operation is not supported for directory buckets

get_bucket_analytics_configuration

This operation is not supported for directory buckets

get_bucket_cors

This operation is not supported for directory buckets

get_bucket_encryption

Returns the default encryption configuration for an Amazon S3 bucket

get_bucket_intelligent_tiering_configuration

This operation is not supported for directory buckets

get_bucket_inventory_configuration

This operation is not supported for directory buckets

get_bucket_lifecycle

For an updated version of this API, see GetBucketLifecycleConfiguration

get_bucket_lifecycle_configuration

Returns the lifecycle configuration information set on the bucket

get_bucket_location

This operation is not supported for directory buckets

get_bucket_logging

This operation is not supported for directory buckets

get_bucket_metadata_table_configuration

Retrieves the metadata table configuration for a general purpose bucket

get_bucket_metrics_configuration

This operation is not supported for directory buckets

get_bucket_notification

This operation is not supported for directory buckets

get_bucket_notification_configuration

This operation is not supported for directory buckets

get_bucket_ownership_controls

This operation is not supported for directory buckets

get_bucket_policy

Returns the policy of a specified bucket

get_bucket_policy_status

This operation is not supported for directory buckets

get_bucket_replication

This operation is not supported for directory buckets

get_bucket_request_payment

This operation is not supported for directory buckets

get_bucket_tagging

This operation is not supported for directory buckets

get_bucket_versioning

This operation is not supported for directory buckets

get_bucket_website

This operation is not supported for directory buckets

get_object

Retrieves an object from Amazon S3

get_object_acl

This operation is not supported for directory buckets

get_object_attributes

Retrieves all the metadata from an object without returning the object itself

get_object_legal_hold

This operation is not supported for directory buckets

get_object_lock_configuration

This operation is not supported for directory buckets

get_object_retention

This operation is not supported for directory buckets

get_object_tagging

This operation is not supported for directory buckets

get_object_torrent

This operation is not supported for directory buckets

get_public_access_block

This operation is not supported for directory buckets

head_bucket

You can use this operation to determine if a bucket exists and if you have permission to access it

head_object

The HEAD operation retrieves metadata from an object without returning the object itself

list_bucket_analytics_configurations

This operation is not supported for directory buckets

list_bucket_intelligent_tiering_configurations

This operation is not supported for directory buckets

list_bucket_inventory_configurations

This operation is not supported for directory buckets

list_bucket_metrics_configurations

This operation is not supported for directory buckets

list_buckets

This operation is not supported for directory buckets

list_directory_buckets

Returns a list of all Amazon S3 directory buckets owned by the authenticated sender of the request

list_multipart_uploads

This operation lists in-progress multipart uploads in a bucket

list_objects

This operation is not supported for directory buckets

list_objects_v2

Returns some or all (up to 1,000) of the objects in a bucket with each request

list_object_versions

This operation is not supported for directory buckets

list_parts

Lists the parts that have been uploaded for a specific multipart upload

put_bucket_accelerate_configuration

This operation is not supported for directory buckets

put_bucket_acl

This operation is not supported for directory buckets

put_bucket_analytics_configuration

This operation is not supported for directory buckets

put_bucket_cors

This operation is not supported for directory buckets

put_bucket_encryption

This operation configures default encryption and Amazon S3 Bucket Keys for an existing bucket

put_bucket_intelligent_tiering_configuration

This operation is not supported for directory buckets

put_bucket_inventory_configuration

This operation is not supported for directory buckets

put_bucket_lifecycle

This operation is not supported for directory buckets

put_bucket_lifecycle_configuration

Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle configuration

put_bucket_logging

This operation is not supported for directory buckets

put_bucket_metrics_configuration

This operation is not supported for directory buckets

put_bucket_notification

This operation is not supported for directory buckets

put_bucket_notification_configuration

This operation is not supported for directory buckets

put_bucket_ownership_controls

This operation is not supported for directory buckets

put_bucket_policy

Applies an Amazon S3 bucket policy to an Amazon S3 bucket

put_bucket_replication

This operation is not supported for directory buckets

put_bucket_request_payment

This operation is not supported for directory buckets

put_bucket_tagging

This operation is not supported for directory buckets

put_bucket_versioning

This operation is not supported for directory buckets

put_bucket_website

This operation is not supported for directory buckets

put_object

Adds an object to a bucket

put_object_acl

This operation is not supported for directory buckets

put_object_legal_hold

This operation is not supported for directory buckets

put_object_lock_configuration

This operation is not supported for directory buckets

put_object_retention

This operation is not supported for directory buckets

put_object_tagging

This operation is not supported for directory buckets

put_public_access_block

This operation is not supported for directory buckets

restore_object

This operation is not supported for directory buckets

select_object_content

This operation is not supported for directory buckets

upload_part

Uploads a part in a multipart upload

upload_part_copy

Uploads a part by copying data from an existing object as data source

write_get_object_response

This operation is not supported for directory buckets

Examples

[](#%5F%5Fcodelineno-2-1)## Not run: [](#%5F%5Fcodelineno-2-2)svc <- s3() [](#%5F%5Fcodelineno-2-3)# The following example aborts a multipart upload. [](#%5F%5Fcodelineno-2-4)svc$abort_multipart_upload( [](#%5F%5Fcodelineno-2-5) Bucket = "examplebucket", [](#%5F%5Fcodelineno-2-6) Key = "bigobject", [](#%5F%5Fcodelineno-2-7) UploadId = "xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LA..." [](#%5F%5Fcodelineno-2-8)) [](#%5F%5Fcodelineno-2-9) [](#%5F%5Fcodelineno-2-10)## End(Not run)