Paws::S3 - Perl Interface to AWS Amazon Simple Storage Service
use Paws; my $obj = Paws->service('S3'); my $res = $obj->Method( Arg1 => $val1, Arg2 => [ 'V1', 'V2' ], # if Arg3 is an object, the HashRef will be used as arguments to the constructor # of the arguments type Arg3 => { Att1 => 'Val1' }, # if Arg4 is an array of objects, the HashRefs will be passed as arguments to # the constructor of the arguments type Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ], );
Amazon Simple Storage Service
Amazon Simple Storage Service is storage for the Internet. It is designed to make web-scale computing easier for developers.
Amazon S3 has a simple web services interface that you can use to store and retrieve any amount of data, at any time, from anywhere on the web. It gives any developer access to the same highly scalable, reliable, fast, inexpensive data storage infrastructure that Amazon uses to run its own global network of web sites. The service aims to maximize benefits of scale and to pass those benefits on to developers.
Each argument is described in detail in: Paws::S3::AbortMultipartUpload
Returns: a Paws::S3::AbortMultipartUploadOutput instance
Aborts a multipart upload.
To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.
Each argument is described in detail in: Paws::S3::CompleteMultipartUpload
Returns: a Paws::S3::CompleteMultipartUploadOutput instance
Completes a multipart upload by assembling previously uploaded parts.
Each argument is described in detail in: Paws::S3::CopyObject
Returns: a Paws::S3::CopyObjectOutput instance
Creates a copy of an object that is already stored in Amazon S3.
Each argument is described in detail in: Paws::S3::CreateBucket
Returns: a Paws::S3::CreateBucketOutput instance
Creates a new bucket.
Each argument is described in detail in: Paws::S3::CreateMultipartUpload
Returns: a Paws::S3::CreateMultipartUploadOutput instance
Initiates a multipart upload and returns an upload ID.
Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.
Each argument is described in detail in: Paws::S3::DeleteBucket
Returns: nothing
Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.
Each argument is described in detail in: Paws::S3::DeleteBucketAnalyticsConfiguration
Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).
Each argument is described in detail in: Paws::S3::DeleteBucketCors
Deletes the cors configuration information set for the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketInventoryConfiguration
Deletes an inventory configuration (identified by the inventory ID) from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketLifecycle
Deletes the lifecycle configuration from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketMetricsConfiguration
Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketPolicy
Deletes the policy from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketReplication
Deletes the replication configuration from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketTagging
Deletes the tags from the bucket.
Each argument is described in detail in: Paws::S3::DeleteBucketWebsite
This operation removes the website configuration from the bucket.
Each argument is described in detail in: Paws::S3::DeleteObject
Returns: a Paws::S3::DeleteObjectOutput instance
Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.
Each argument is described in detail in: Paws::S3::DeleteObjects
Returns: a Paws::S3::DeleteObjectsOutput instance
This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.
Each argument is described in detail in: Paws::S3::DeleteObjectTagging
Returns: a Paws::S3::DeleteObjectTaggingOutput instance
Removes the tag-set from an existing object.
Each argument is described in detail in: Paws::S3::GetBucketAccelerateConfiguration
Returns: a Paws::S3::GetBucketAccelerateConfigurationOutput instance
Returns the accelerate configuration of a bucket.
Each argument is described in detail in: Paws::S3::GetBucketAcl
Returns: a Paws::S3::GetBucketAclOutput instance
Gets the access control policy for the bucket.
Each argument is described in detail in: Paws::S3::GetBucketAnalyticsConfiguration
Returns: a Paws::S3::GetBucketAnalyticsConfigurationOutput instance
Gets an analytics configuration for the bucket (specified by the analytics configuration ID).
Each argument is described in detail in: Paws::S3::GetBucketCors
Returns: a Paws::S3::GetBucketCorsOutput instance
Returns the cors configuration for the bucket.
Each argument is described in detail in: Paws::S3::GetBucketInventoryConfiguration
Returns: a Paws::S3::GetBucketInventoryConfigurationOutput instance
Returns an inventory configuration (identified by the inventory ID) from the bucket.
Each argument is described in detail in: Paws::S3::GetBucketLifecycle
Returns: a Paws::S3::GetBucketLifecycleOutput instance
Deprecated, see the GetBucketLifecycleConfiguration operation.
Each argument is described in detail in: Paws::S3::GetBucketLifecycleConfiguration
Returns: a Paws::S3::GetBucketLifecycleConfigurationOutput instance
Returns the lifecycle configuration information set on the bucket.
Each argument is described in detail in: Paws::S3::GetBucketLocation
Returns: a Paws::S3::GetBucketLocationOutput instance
Returns the region the bucket resides in.
Each argument is described in detail in: Paws::S3::GetBucketLogging
Returns: a Paws::S3::GetBucketLoggingOutput instance
Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.
Each argument is described in detail in: Paws::S3::GetBucketMetricsConfiguration
Returns: a Paws::S3::GetBucketMetricsConfigurationOutput instance
Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.
Each argument is described in detail in: Paws::S3::GetBucketNotification
Returns: a Paws::S3::NotificationConfigurationDeprecated instance
Deprecated, see the GetBucketNotificationConfiguration operation.
Each argument is described in detail in: Paws::S3::GetBucketNotificationConfiguration
Returns: a Paws::S3::NotificationConfiguration instance
Returns the notification configuration of a bucket.
Each argument is described in detail in: Paws::S3::GetBucketPolicy
Returns: a Paws::S3::GetBucketPolicyOutput instance
Returns the policy of a specified bucket.
Each argument is described in detail in: Paws::S3::GetBucketReplication
Returns: a Paws::S3::GetBucketReplicationOutput instance
Returns the replication configuration of a bucket.
Each argument is described in detail in: Paws::S3::GetBucketRequestPayment
Returns: a Paws::S3::GetBucketRequestPaymentOutput instance
Returns the request payment configuration of a bucket.
Each argument is described in detail in: Paws::S3::GetBucketTagging
Returns: a Paws::S3::GetBucketTaggingOutput instance
Returns the tag set associated with the bucket.
Each argument is described in detail in: Paws::S3::GetBucketVersioning
Returns: a Paws::S3::GetBucketVersioningOutput instance
Returns the versioning state of a bucket.
Each argument is described in detail in: Paws::S3::GetBucketWebsite
Returns: a Paws::S3::GetBucketWebsiteOutput instance
Returns the website configuration for a bucket.
Each argument is described in detail in: Paws::S3::GetObject
Returns: a Paws::S3::GetObjectOutput instance
Retrieves objects from Amazon S3.
Each argument is described in detail in: Paws::S3::GetObjectAcl
Returns: a Paws::S3::GetObjectAclOutput instance
Returns the access control list (ACL) of an object.
Each argument is described in detail in: Paws::S3::GetObjectTagging
Returns: a Paws::S3::GetObjectTaggingOutput instance
Returns the tag-set of an object.
Each argument is described in detail in: Paws::S3::GetObjectTorrent
Returns: a Paws::S3::GetObjectTorrentOutput instance
Return torrent files from a bucket.
Each argument is described in detail in: Paws::S3::HeadBucket
This operation is useful to determine if a bucket exists and you have permission to access it.
Each argument is described in detail in: Paws::S3::HeadObject
Returns: a Paws::S3::HeadObjectOutput instance
The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.
Each argument is described in detail in: Paws::S3::ListBucketAnalyticsConfigurations
Returns: a Paws::S3::ListBucketAnalyticsConfigurationsOutput instance
Lists the analytics configurations for the bucket.
Each argument is described in detail in: Paws::S3::ListBucketInventoryConfigurations
Returns: a Paws::S3::ListBucketInventoryConfigurationsOutput instance
Returns a list of inventory configurations for the bucket.
Each argument is described in detail in: Paws::S3::ListBucketMetricsConfigurations
Returns: a Paws::S3::ListBucketMetricsConfigurationsOutput instance
Lists the metrics configurations for the bucket.
Each argument is described in detail in: Paws::S3::ListBuckets
Returns: a Paws::S3::ListBucketsOutput instance
Returns a list of all buckets owned by the authenticated sender of the request.
Each argument is described in detail in: Paws::S3::ListMultipartUploads
Returns: a Paws::S3::ListMultipartUploadsOutput instance
This operation lists in-progress multipart uploads.
Each argument is described in detail in: Paws::S3::ListObjects
Returns: a Paws::S3::ListObjectsOutput instance
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.
Each argument is described in detail in: Paws::S3::ListObjectsV2
Returns: a Paws::S3::ListObjectsV2Output instance
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.
Each argument is described in detail in: Paws::S3::ListObjectVersions
Returns: a Paws::S3::ListObjectVersionsOutput instance
Returns metadata about all of the versions of objects in a bucket.
Each argument is described in detail in: Paws::S3::ListParts
Returns: a Paws::S3::ListPartsOutput instance
Lists the parts that have been uploaded for a specific multipart upload.
Each argument is described in detail in: Paws::S3::PutBucketAccelerateConfiguration
Sets the accelerate configuration of an existing bucket.
Each argument is described in detail in: Paws::S3::PutBucketAcl
Sets the permissions on a bucket using access control lists (ACL).
Each argument is described in detail in: Paws::S3::PutBucketAnalyticsConfiguration
Sets an analytics configuration for the bucket (specified by the analytics configuration ID).
Each argument is described in detail in: Paws::S3::PutBucketCors
Sets the cors configuration for a bucket.
Each argument is described in detail in: Paws::S3::PutBucketInventoryConfiguration
Adds an inventory configuration (identified by the inventory ID) from the bucket.
Each argument is described in detail in: Paws::S3::PutBucketLifecycle
Deprecated, see the PutBucketLifecycleConfiguration operation.
Each argument is described in detail in: Paws::S3::PutBucketLifecycleConfiguration
Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.
Each argument is described in detail in: Paws::S3::PutBucketLogging
Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.
Each argument is described in detail in: Paws::S3::PutBucketMetricsConfiguration
Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
Each argument is described in detail in: Paws::S3::PutBucketNotification
Deprecated, see the PutBucketNotificationConfiguraiton operation.
Each argument is described in detail in: Paws::S3::PutBucketNotificationConfiguration
Enables notifications of specified events for a bucket.
Each argument is described in detail in: Paws::S3::PutBucketPolicy
Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.
Each argument is described in detail in: Paws::S3::PutBucketReplication
Creates a new replication configuration (or replaces an existing one, if present).
Each argument is described in detail in: Paws::S3::PutBucketRequestPayment
Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
Each argument is described in detail in: Paws::S3::PutBucketTagging
Sets the tags for a bucket.
Each argument is described in detail in: Paws::S3::PutBucketVersioning
Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.
Each argument is described in detail in: Paws::S3::PutBucketWebsite
Set the website configuration for a bucket.
Each argument is described in detail in: Paws::S3::PutObject
Returns: a Paws::S3::PutObjectOutput instance
Adds an object to a bucket.
Each argument is described in detail in: Paws::S3::PutObjectAcl
Returns: a Paws::S3::PutObjectAclOutput instance
uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket
Each argument is described in detail in: Paws::S3::PutObjectTagging
Returns: a Paws::S3::PutObjectTaggingOutput instance
Sets the supplied tag-set to an object that already exists in a bucket
Each argument is described in detail in: Paws::S3::RestoreObject
Returns: a Paws::S3::RestoreObjectOutput instance
Restores an archived copy of an object back into Amazon S3
Each argument is described in detail in: Paws::S3::UploadPart
Returns: a Paws::S3::UploadPartOutput instance
Uploads a part in a multipart upload.
Each argument is described in detail in: Paws::S3::UploadPartCopy
Returns: a Paws::S3::UploadPartCopyOutput instance
Uploads a part by copying data from an existing object as data source.
Paginator methods are helpers that repetively call methods that return partial results
If passed a sub as first parameter, it will call the sub for each element found in :
- Uploads, passing the object as the first parameter, and the string 'Uploads' as the second parameter - CommonPrefixes, passing the object as the first parameter, and the string 'CommonPrefixes' as the second parameter
If not, it will return a a Paws::S3::ListMultipartUploadsOutput instance with all the params; andparams; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
param
- Contents, passing the object as the first parameter, and the string 'Contents' as the second parameter - CommonPrefixes, passing the object as the first parameter, and the string 'CommonPrefixes' as the second parameter
If not, it will return a a Paws::S3::ListObjectsOutput instance with all the params; andparams; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
If not, it will return a a Paws::S3::ListObjectsV2Output instance with all the params; andparams; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
- Versions, passing the object as the first parameter, and the string 'Versions' as the second parameter - DeleteMarkers, passing the object as the first parameter, and the string 'DeleteMarkers' as the second parameter - CommonPrefixes, passing the object as the first parameter, and the string 'CommonPrefixes' as the second parameter
If not, it will return a a Paws::S3::ListObjectVersionsOutput instance with all the params; andparams; andparams; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
- Parts, passing the object as the first parameter, and the string 'Parts' as the second parameter
If not, it will return a a Paws::S3::ListPartsOutput instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
This service class forms part of Paws
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues
To install Paws::SDK::Config, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Paws::SDK::Config
CPAN shell
perl -MCPAN -e shell install Paws::SDK::Config
For more information on module installation, please visit the detailed CPAN module installation guide.