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:
- creds:
* access_key_id: AWS access key ID
* secret_access_key: AWS secret access key
* session_token: AWS temporary session token - profile: The name of a profile to use. If not given, then the default profile is used.
- anonymous: Set anonymous credentials.
- creds:
- endpoint: The complete URL to use for the constructed client.
- region: The AWS Region used in instantiating the client.
- close_connection: Immediately close all HTTP connections.
- timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
- s3_force_path_style: Set this to
true
to force the request to use path-style addressing, i.e.http://s3.amazonaws.com/BUCKET/KEY
. - sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials
Optional credentials shorthand for the config parameter
- creds:
- access_key_id: AWS access key ID
- secret_access_key: AWS secret access key
- session_token: AWS temporary session token
- profile: The name of a profile to use. If not given, then the default profile is used.
- anonymous: Set anonymous credentials.
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¶
This operation aborts a multipart upload
Completes a multipart upload by assembling previously uploaded parts
Creates a copy of an object that is already stored in Amazon S3
This action creates an Amazon S3 bucket
create_bucket_metadata_table_configuration
Creates a metadata table configuration for a general purpose bucket
This action initiates a multipart upload and returns an upload ID
Creates a session that establishes temporary security credentials to support fast authentication and authorization for the Zonal endpoint API operations on directory buckets
Deletes the S3 bucket
delete_bucket_analytics_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
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
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
Deletes the policy of a specified bucket
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Removes an object from a bucket
This operation enables you to delete multiple objects from a bucket using a single HTTP request
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Download a file from S3 and store it at a specified file location
@title Generate a presigned url given a client, its method, and arguments
get_bucket_accelerate_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
get_bucket_analytics_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
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
For an updated version of this API, see GetBucketLifecycleConfiguration
get_bucket_lifecycle_configuration
Returns the lifecycle configuration information set on the bucket
This operation is not supported for directory buckets
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
This operation is not supported for directory buckets
get_bucket_notification_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Returns the policy of a specified bucket
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Retrieves an object from Amazon S3
This operation is not supported for directory buckets
Retrieves all the metadata from an object without returning the object itself
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
You can use this operation to determine if a bucket exists and if you have permission to access it
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
This operation is not supported for directory buckets
Returns a list of all Amazon S3 directory buckets owned by the authenticated sender of the request
This operation lists in-progress multipart uploads in a bucket
This operation is not supported for directory buckets
Returns some or all (up to 1,000) of the objects in a bucket with each request
This operation is not supported for directory buckets
Lists the parts that have been uploaded for a specific multipart upload
put_bucket_accelerate_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
put_bucket_analytics_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
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
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
This operation is not supported for directory buckets
put_bucket_metrics_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
put_bucket_notification_configuration
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Applies an Amazon S3 bucket policy to an Amazon S3 bucket
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Adds an object to a bucket
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
This operation is not supported for directory buckets
Uploads a part in a multipart upload
Uploads a part by copying data from an existing object as data source
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)