NAME

Paws::S3 - Perl Interface to AWS Amazon Simple Storage Service

SYNOPSIS

  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' } ],
  );

DESCRIPTION

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.

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01

METHODS

AbortMultipartUpload

Bucket => Str
Key => Str
UploadId => Str
[RequestPayer => Str]

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.

CompleteMultipartUpload

Bucket => Str
Key => Str
UploadId => Str
[MultipartUpload => Paws::S3::CompletedMultipartUpload]
[RequestPayer => Str]

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.

CopyObject

Bucket => Str
CopySource => Str
Key => Str
[ACL => Str]
[CacheControl => Str]
[ContentDisposition => Str]
[ContentEncoding => Str]
[ContentLanguage => Str]
[ContentType => Str]
[CopySourceIfMatch => Str]
[CopySourceIfModifiedSince => Str]
[CopySourceIfNoneMatch => Str]
[CopySourceIfUnmodifiedSince => Str]
[CopySourceSSECustomerAlgorithm => Str]
[CopySourceSSECustomerKey => Str]
[CopySourceSSECustomerKeyMD5 => Str]
[Expires => Str]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWriteACP => Str]
[Metadata => Paws::S3::Metadata]
[MetadataDirective => Str]
[ObjectLockLegalHoldStatus => Str]
[ObjectLockMode => Str]
[ObjectLockRetainUntilDate => Str]
[RequestPayer => Str]
[ServerSideEncryption => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]
[SSEKMSKeyId => Str]
[StorageClass => Str]
[Tagging => Str]
[TaggingDirective => Str]
[WebsiteRedirectLocation => Str]

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.

CreateBucket

Bucket => Str
[ACL => Str]
[ContentLength => Int]
[CreateBucketConfiguration => Paws::S3::CreateBucketConfiguration]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWrite => Str]
[GrantWriteACP => Str]
[ObjectLockEnabledForBucket => Bool]

Each argument is described in detail in: Paws::S3::CreateBucket

Returns: a Paws::S3::CreateBucketOutput instance

Creates a new bucket.

CreateMultipartUpload

Bucket => Str
Key => Str
[ACL => Str]
[CacheControl => Str]
[ContentDisposition => Str]
[ContentEncoding => Str]
[ContentLanguage => Str]
[ContentType => Str]
[Expires => Str]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWriteACP => Str]
[Metadata => Paws::S3::Metadata]
[ObjectLockLegalHoldStatus => Str]
[ObjectLockMode => Str]
[ObjectLockRetainUntilDate => Str]
[RequestPayer => Str]
[ServerSideEncryption => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]
[SSEKMSKeyId => Str]
[StorageClass => Str]
[Tagging => Str]
[WebsiteRedirectLocation => Str]

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.

DeleteBucket

Bucket => Str

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.

DeleteBucketAnalyticsConfiguration

Bucket => Str
Id => Str

Each argument is described in detail in: Paws::S3::DeleteBucketAnalyticsConfiguration

Returns: nothing

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

DeleteBucketCors

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketCors

Returns: nothing

Deletes the CORS configuration information set for the bucket.

DeleteBucketEncryption

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketEncryption

Returns: nothing

Deletes the server-side encryption configuration from the bucket.

DeleteBucketInventoryConfiguration

Bucket => Str
Id => Str

Each argument is described in detail in: Paws::S3::DeleteBucketInventoryConfiguration

Returns: nothing

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

DeleteBucketLifecycle

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketLifecycle

Returns: nothing

Deletes the lifecycle configuration from the bucket.

DeleteBucketMetricsConfiguration

Bucket => Str
Id => Str

Each argument is described in detail in: Paws::S3::DeleteBucketMetricsConfiguration

Returns: nothing

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

DeleteBucketPolicy

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketPolicy

Returns: nothing

Deletes the policy from the bucket.

DeleteBucketReplication

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketReplication

Returns: nothing

Deletes the replication configuration from the bucket. For information about replication configuration, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

DeleteBucketTagging

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketTagging

Returns: nothing

Deletes the tags from the bucket.

DeleteBucketWebsite

Bucket => Str

Each argument is described in detail in: Paws::S3::DeleteBucketWebsite

Returns: nothing

This operation removes the website configuration from the bucket.

DeleteObject

Bucket => Str
Key => Str
[BypassGovernanceRetention => Bool]
[MFA => Str]
[RequestPayer => Str]
[VersionId => Str]

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.

DeleteObjects

Bucket => Str
Delete => Paws::S3::Delete
[BypassGovernanceRetention => Bool]
[ContentLength => Int]
[ContentMD5 => Str]
[MFA => Str]
[RequestPayer => Str]

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.

DeleteObjectTagging

Bucket => Str
Key => Str
[VersionId => Str]

Each argument is described in detail in: Paws::S3::DeleteObjectTagging

Returns: a Paws::S3::DeleteObjectTaggingOutput instance

Removes the tag-set from an existing object.

DeletePublicAccessBlock

Bucket => Str

Each argument is described in detail in: Paws::S3::DeletePublicAccessBlock

Returns: nothing

Removes the PublicAccessBlock configuration from an Amazon S3 bucket.

GetBucketAccelerateConfiguration

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketAccelerateConfiguration

Returns: a Paws::S3::GetBucketAccelerateConfigurationOutput instance

Returns the accelerate configuration of a bucket.

GetBucketAcl

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketAcl

Returns: a Paws::S3::GetBucketAclOutput instance

Gets the access control policy for the bucket.

GetBucketAnalyticsConfiguration

Bucket => Str
Id => Str

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).

GetBucketCors

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketCors

Returns: a Paws::S3::GetBucketCorsOutput instance

Returns the CORS configuration for the bucket.

GetBucketEncryption

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketEncryption

Returns: a Paws::S3::GetBucketEncryptionOutput instance

Returns the server-side encryption configuration of a bucket.

GetBucketInventoryConfiguration

Bucket => Str
Id => Str

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.

GetBucketLifecycle

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketLifecycle

Returns: a Paws::S3::GetBucketLifecycleOutput instance

Deprecated, see the GetBucketLifecycleConfiguration operation.

GetBucketLifecycleConfiguration

Bucket => Str

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.

GetBucketLocation

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketLocation

Returns: a Paws::S3::GetBucketLocationOutput instance

Returns the region the bucket resides in.

GetBucketLogging

Bucket => Str

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.

GetBucketMetricsConfiguration

Bucket => Str
Id => Str

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.

GetBucketNotification

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketNotification

Returns: a Paws::S3::NotificationConfigurationDeprecated instance

Deprecated, see the GetBucketNotificationConfiguration operation.

GetBucketNotificationConfiguration

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketNotificationConfiguration

Returns: a Paws::S3::NotificationConfiguration instance

Returns the notification configuration of a bucket.

GetBucketPolicy

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketPolicy

Returns: a Paws::S3::GetBucketPolicyOutput instance

Returns the policy of a specified bucket.

GetBucketPolicyStatus

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketPolicyStatus

Returns: a Paws::S3::GetBucketPolicyStatusOutput instance

Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.

GetBucketReplication

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketReplication

Returns: a Paws::S3::GetBucketReplicationOutput instance

Returns the replication configuration of a bucket.

It can take a while to propagate the put or delete a replication configuration to all Amazon S3 systems. Therefore, a get request soon after put or delete can return a wrong result.

GetBucketRequestPayment

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketRequestPayment

Returns: a Paws::S3::GetBucketRequestPaymentOutput instance

Returns the request payment configuration of a bucket.

GetBucketTagging

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketTagging

Returns: a Paws::S3::GetBucketTaggingOutput instance

Returns the tag set associated with the bucket.

GetBucketVersioning

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketVersioning

Returns: a Paws::S3::GetBucketVersioningOutput instance

Returns the versioning state of a bucket.

GetBucketWebsite

Bucket => Str

Each argument is described in detail in: Paws::S3::GetBucketWebsite

Returns: a Paws::S3::GetBucketWebsiteOutput instance

Returns the website configuration for a bucket.

GetObject

Bucket => Str
Key => Str
[IfMatch => Str]
[IfModifiedSince => Str]
[IfNoneMatch => Str]
[IfUnmodifiedSince => Str]
[PartNumber => Int]
[Range => Str]
[RequestPayer => Str]
[ResponseCacheControl => Str]
[ResponseContentDisposition => Str]
[ResponseContentEncoding => Str]
[ResponseContentLanguage => Str]
[ResponseContentType => Str]
[ResponseExpires => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]
[VersionId => Str]

Each argument is described in detail in: Paws::S3::GetObject

Returns: a Paws::S3::GetObjectOutput instance

Retrieves objects from Amazon S3.

GetObjectAcl

Bucket => Str
Key => Str
[RequestPayer => Str]
[VersionId => Str]

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.

GetObjectLegalHold

Bucket => Str
Key => Str
[RequestPayer => Str]
[VersionId => Str]

Each argument is described in detail in: Paws::S3::GetObjectLegalHold

Returns: a Paws::S3::GetObjectLegalHoldOutput instance

Gets an object's current Legal Hold status.

GetObjectLockConfiguration

Bucket => Str

Each argument is described in detail in: Paws::S3::GetObjectLockConfiguration

Returns: a Paws::S3::GetObjectLockConfigurationOutput instance

Gets the Object Lock configuration for a bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket.

GetObjectRetention

Bucket => Str
Key => Str
[RequestPayer => Str]
[VersionId => Str]

Each argument is described in detail in: Paws::S3::GetObjectRetention

Returns: a Paws::S3::GetObjectRetentionOutput instance

Retrieves an object's retention settings.

GetObjectTagging

Bucket => Str
Key => Str
[VersionId => Str]

Each argument is described in detail in: Paws::S3::GetObjectTagging

Returns: a Paws::S3::GetObjectTaggingOutput instance

Returns the tag-set of an object.

GetObjectTorrent

Bucket => Str
Key => Str
[RequestPayer => Str]

Each argument is described in detail in: Paws::S3::GetObjectTorrent

Returns: a Paws::S3::GetObjectTorrentOutput instance

Return torrent files from a bucket.

GetPublicAccessBlock

Bucket => Str

Each argument is described in detail in: Paws::S3::GetPublicAccessBlock

Returns: a Paws::S3::GetPublicAccessBlockOutput instance

Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket.

HeadBucket

Bucket => Str

Each argument is described in detail in: Paws::S3::HeadBucket

Returns: nothing

This operation is useful to determine if a bucket exists and you have permission to access it.

HeadObject

Bucket => Str
Key => Str
[IfMatch => Str]
[IfModifiedSince => Str]
[IfNoneMatch => Str]
[IfUnmodifiedSince => Str]
[PartNumber => Int]
[Range => Str]
[RequestPayer => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]
[VersionId => Str]

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.

ListBucketAnalyticsConfigurations

Bucket => Str
[ContinuationToken => Str]

Each argument is described in detail in: Paws::S3::ListBucketAnalyticsConfigurations

Returns: a Paws::S3::ListBucketAnalyticsConfigurationsOutput instance

Lists the analytics configurations for the bucket.

ListBucketInventoryConfigurations

Bucket => Str
[ContinuationToken => Str]

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.

ListBucketMetricsConfigurations

Bucket => Str
[ContinuationToken => Str]

Each argument is described in detail in: Paws::S3::ListBucketMetricsConfigurations

Returns: a Paws::S3::ListBucketMetricsConfigurationsOutput instance

Lists the metrics configurations for the bucket.

ListBuckets

=>

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.

ListMultipartUploads

Bucket => Str
[Delimiter => Str]
[EncodingType => Str]
[KeyMarker => Str]
[MaxUploads => Int]
[Prefix => Str]
[UploadIdMarker => Str]

Each argument is described in detail in: Paws::S3::ListMultipartUploads

Returns: a Paws::S3::ListMultipartUploadsOutput instance

This operation lists in-progress multipart uploads.

ListObjects

Bucket => Str
[Delimiter => Str]
[EncodingType => Str]
[Marker => Str]
[MaxKeys => Int]
[Prefix => Str]
[RequestPayer => Str]

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.

ListObjectsV2

Bucket => Str
[ContinuationToken => Str]
[Delimiter => Str]
[EncodingType => Str]
[FetchOwner => Bool]
[MaxKeys => Int]
[Prefix => Str]
[RequestPayer => Str]
[StartAfter => Str]

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.

ListObjectVersions

Bucket => Str
[Delimiter => Str]
[EncodingType => Str]
[KeyMarker => Str]
[MaxKeys => Int]
[Prefix => Str]
[VersionIdMarker => Str]

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.

ListParts

Bucket => Str
Key => Str
UploadId => Str
[MaxParts => Int]
[PartNumberMarker => Int]
[RequestPayer => Str]

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.

PutBucketAccelerateConfiguration

AccelerateConfiguration => Paws::S3::AccelerateConfiguration
Bucket => Str
[ContentLength => Int]

Each argument is described in detail in: Paws::S3::PutBucketAccelerateConfiguration

Returns: nothing

Sets the accelerate configuration of an existing bucket.

PutBucketAcl

Bucket => Str
[AccessControlPolicy => Paws::S3::AccessControlPolicy]
[ACL => Str]
[ContentLength => Int]
[ContentMD5 => Str]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWrite => Str]
[GrantWriteACP => Str]

Each argument is described in detail in: Paws::S3::PutBucketAcl

Returns: nothing

Sets the permissions on a bucket using access control lists (ACL).

PutBucketAnalyticsConfiguration

AnalyticsConfiguration => Paws::S3::AnalyticsConfiguration
Bucket => Str
Id => Str
[ContentLength => Int]

Each argument is described in detail in: Paws::S3::PutBucketAnalyticsConfiguration

Returns: nothing

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

PutBucketCors

Bucket => Str
CORSConfiguration => Paws::S3::CORSConfiguration
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketCors

Returns: nothing

Sets the CORS configuration for a bucket.

PutBucketEncryption

Bucket => Str
ServerSideEncryptionConfiguration => Paws::S3::ServerSideEncryptionConfiguration
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketEncryption

Returns: nothing

Creates a new server-side encryption configuration (or replaces an existing one, if present).

PutBucketInventoryConfiguration

Bucket => Str
Id => Str
InventoryConfiguration => Paws::S3::InventoryConfiguration
[ContentLength => Int]

Each argument is described in detail in: Paws::S3::PutBucketInventoryConfiguration

Returns: nothing

Adds an inventory configuration (identified by the inventory ID) from the bucket.

PutBucketLifecycle

Bucket => Str
[ContentLength => Int]
[ContentMD5 => Str]
[LifecycleConfiguration => Paws::S3::LifecycleConfiguration]

Each argument is described in detail in: Paws::S3::PutBucketLifecycle

Returns: nothing

Deprecated, see the PutBucketLifecycleConfiguration operation.

PutBucketLifecycleConfiguration

Bucket => Str
[LifecycleConfiguration => Paws::S3::BucketLifecycleConfiguration]

Each argument is described in detail in: Paws::S3::PutBucketLifecycleConfiguration

Returns: nothing

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

PutBucketLogging

Bucket => Str
BucketLoggingStatus => Paws::S3::BucketLoggingStatus
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketLogging

Returns: nothing

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.

PutBucketMetricsConfiguration

Bucket => Str
Id => Str
MetricsConfiguration => Paws::S3::MetricsConfiguration
[ContentLength => Int]

Each argument is described in detail in: Paws::S3::PutBucketMetricsConfiguration

Returns: nothing

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

PutBucketNotification

Bucket => Str
NotificationConfiguration => Paws::S3::NotificationConfigurationDeprecated
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketNotification

Returns: nothing

Deprecated, see the PutBucketNotificationConfiguraiton operation.

PutBucketNotificationConfiguration

Bucket => Str
NotificationConfiguration => Paws::S3::NotificationConfiguration

Each argument is described in detail in: Paws::S3::PutBucketNotificationConfiguration

Returns: nothing

Enables notifications of specified events for a bucket.

PutBucketPolicy

Bucket => Str
Policy => Str
[ConfirmRemoveSelfBucketAccess => Bool]
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketPolicy

Returns: nothing

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

PutBucketReplication

Bucket => Str
ReplicationConfiguration => Paws::S3::ReplicationConfiguration
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketReplication

Returns: nothing

Creates a replication configuration or replaces an existing one. For more information, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

PutBucketRequestPayment

Bucket => Str
RequestPaymentConfiguration => Paws::S3::RequestPaymentConfiguration
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketRequestPayment

Returns: nothing

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

PutBucketTagging

Bucket => Str
Tagging => Paws::S3::Tagging
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketTagging

Returns: nothing

Sets the tags for a bucket.

PutBucketVersioning

Bucket => Str
VersioningConfiguration => Paws::S3::VersioningConfiguration
[ContentLength => Int]
[ContentMD5 => Str]
[MFA => Str]

Each argument is described in detail in: Paws::S3::PutBucketVersioning

Returns: nothing

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

PutBucketWebsite

Bucket => Str
WebsiteConfiguration => Paws::S3::WebsiteConfiguration
[ContentLength => Int]
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutBucketWebsite

Returns: nothing

Set the website configuration for a bucket.

PutObject

Bucket => Str
Key => Str
[ACL => Str]
[Body => Str]
[CacheControl => Str]
[ContentDisposition => Str]
[ContentEncoding => Str]
[ContentLanguage => Str]
[ContentLength => Int]
[ContentMD5 => Str]
[ContentType => Str]
[Expires => Str]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWriteACP => Str]
[Metadata => Paws::S3::Metadata]
[ObjectLockLegalHoldStatus => Str]
[ObjectLockMode => Str]
[ObjectLockRetainUntilDate => Str]
[RequestPayer => Str]
[ServerSideEncryption => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]
[SSEKMSKeyId => Str]
[StorageClass => Str]
[Tagging => Str]
[WebsiteRedirectLocation => Str]

Each argument is described in detail in: Paws::S3::PutObject

Returns: a Paws::S3::PutObjectOutput instance

Adds an object to a bucket.

PutObjectAcl

Bucket => Str
Key => Str
[AccessControlPolicy => Paws::S3::AccessControlPolicy]
[ACL => Str]
[ContentLength => Int]
[ContentMD5 => Str]
[GrantFullControl => Str]
[GrantRead => Str]
[GrantReadACP => Str]
[GrantWrite => Str]
[GrantWriteACP => Str]
[RequestPayer => Str]
[VersionId => Str]

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

PutObjectLegalHold

Bucket => Str
Key => Str
[ContentMD5 => Str]
[LegalHold => Paws::S3::ObjectLockLegalHold]
[RequestPayer => Str]
[VersionId => Str]

Each argument is described in detail in: Paws::S3::PutObjectLegalHold

Returns: a Paws::S3::PutObjectLegalHoldOutput instance

Applies a Legal Hold configuration to the specified object.

PutObjectLockConfiguration

Bucket => Str
[ContentMD5 => Str]
[ObjectLockConfiguration => Paws::S3::ObjectLockConfiguration]
[RequestPayer => Str]
[Token => Str]

Each argument is described in detail in: Paws::S3::PutObjectLockConfiguration

Returns: a Paws::S3::PutObjectLockConfigurationOutput instance

Places an Object Lock configuration on the specified bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket.

PutObjectRetention

Bucket => Str
Key => Str
[BypassGovernanceRetention => Bool]
[ContentMD5 => Str]
[RequestPayer => Str]
[Retention => Paws::S3::ObjectLockRetention]
[VersionId => Str]

Each argument is described in detail in: Paws::S3::PutObjectRetention

Returns: a Paws::S3::PutObjectRetentionOutput instance

Places an Object Retention configuration on an object.

PutObjectTagging

Bucket => Str
Key => Str
Tagging => Paws::S3::Tagging
[ContentLength => Int]
[ContentMD5 => Str]
[VersionId => Str]

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

PutPublicAccessBlock

Bucket => Str
PublicAccessBlockConfiguration => Paws::S3::PublicAccessBlockConfiguration
[ContentMD5 => Str]

Each argument is described in detail in: Paws::S3::PutPublicAccessBlock

Returns: nothing

Creates or modifies the PublicAccessBlock configuration for an Amazon S3 bucket.

RestoreObject

Bucket => Str
Key => Str
[ContentMD5 => Str]
[RequestPayer => Str]
[RestoreRequest => Paws::S3::RestoreRequest]
[VersionId => Str]

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

SelectObjectContent

Bucket => Str
Expression => Str
ExpressionType => Str
InputSerialization => Paws::S3::InputSerialization
Key => Str
OutputSerialization => Paws::S3::OutputSerialization
[RequestProgress => Paws::S3::RequestProgress]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]

Each argument is described in detail in: Paws::S3::SelectObjectContent

Returns: a Paws::S3::SelectObjectContentOutput instance

This operation filters the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response.

UploadPart

Bucket => Str
Key => Str
PartNumber => Int
UploadId => Str
[Body => Str]
[ContentLength => Int]
[ContentMD5 => Str]
[RequestPayer => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]

Each argument is described in detail in: Paws::S3::UploadPart

Returns: a Paws::S3::UploadPartOutput instance

Uploads a part in a multipart upload.

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.

UploadPartCopy

Bucket => Str
CopySource => Str
Key => Str
PartNumber => Int
UploadId => Str
[CopySourceIfMatch => Str]
[CopySourceIfModifiedSince => Str]
[CopySourceIfNoneMatch => Str]
[CopySourceIfUnmodifiedSince => Str]
[CopySourceRange => Str]
[CopySourceSSECustomerAlgorithm => Str]
[CopySourceSSECustomerKey => Str]
[CopySourceSSECustomerKeyMD5 => Str]
[RequestPayer => Str]
[SSECustomerAlgorithm => Str]
[SSECustomerKey => Str]
[SSECustomerKeyMD5 => Str]

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.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

ListAllMultipartUploads(sub { },Bucket => Str, [Delimiter => Str, EncodingType => Str, KeyMarker => Str, MaxUploads => Int, Prefix => Str, UploadIdMarker => Str])

ListAllMultipartUploads(Bucket => Str, [Delimiter => Str, EncodingType => Str, KeyMarker => Str, MaxUploads => Int, Prefix => Str, UploadIdMarker => Str])

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.

ListAllObjects(sub { },Bucket => Str, [Delimiter => Str, EncodingType => Str, Marker => Str, MaxKeys => Int, Prefix => Str, RequestPayer => Str])

ListAllObjects(Bucket => Str, [Delimiter => Str, EncodingType => Str, Marker => Str, MaxKeys => Int, Prefix => Str, RequestPayer => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - 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.

ListAllObjectsV2(sub { },Bucket => Str, [ContinuationToken => Str, Delimiter => Str, EncodingType => Str, FetchOwner => Bool, MaxKeys => Int, Prefix => Str, RequestPayer => Str, StartAfter => Str])

ListAllObjectsV2(Bucket => Str, [ContinuationToken => Str, Delimiter => Str, EncodingType => Str, FetchOwner => Bool, MaxKeys => Int, Prefix => Str, RequestPayer => Str, StartAfter => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - 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::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.

ListAllObjectVersions(sub { },Bucket => Str, [Delimiter => Str, EncodingType => Str, KeyMarker => Str, MaxKeys => Int, Prefix => Str, VersionIdMarker => Str])

ListAllObjectVersions(Bucket => Str, [Delimiter => Str, EncodingType => Str, KeyMarker => Str, MaxKeys => Int, Prefix => Str, VersionIdMarker => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - 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.

ListAllParts(sub { },Bucket => Str, Key => Str, UploadId => Str, [MaxParts => Int, PartNumberMarker => Int, RequestPayer => Str])

ListAllParts(Bucket => Str, Key => Str, UploadId => Str, [MaxParts => Int, PartNumberMarker => Int, RequestPayer => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - 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.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

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