|
NAMEPaws::S3 - Perl Interface to AWS Amazon Simple Storage ServiceSYNOPSISuse Paws; my $obj = Paws->service('S3')->new; 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' } ], ); DESCRIPTIONAmazon Simple Storage ServiceAmazon 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. METHODSAbortMultipartUpload(Bucket => Str, Key => Str, UploadId => Str, [RequestPayer => Str])Each argument is described in detail in: Paws::S3::AbortMultipartUploadReturns: 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::CompleteMultipartUploadReturns: 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, RequestPayer => Str, ServerSideEncryption => Str, SSECustomerAlgorithm => Str, SSECustomerKey => Str, SSECustomerKeyMD5 => Str, SSEKMSKeyId => Str, StorageClass => Str, WebsiteRedirectLocation => Str])Each argument is described in detail in: Paws::S3::CopyObjectReturns: a Paws::S3::CopyObjectOutput instance Creates a copy of an object that is already stored in Amazon S3. CreateBucket(Bucket => Str, [ACL => Str, CreateBucketConfiguration => Paws::S3::CreateBucketConfiguration, GrantFullControl => Str, GrantRead => Str, GrantReadACP => Str, GrantWrite => Str, GrantWriteACP => Str])Each argument is described in detail in: Paws::S3::CreateBucketReturns: 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, RequestPayer => Str, ServerSideEncryption => Str, SSECustomerAlgorithm => Str, SSECustomerKey => Str, SSECustomerKeyMD5 => Str, SSEKMSKeyId => Str, StorageClass => Str, WebsiteRedirectLocation => Str])Each argument is described in detail in: Paws::S3::CreateMultipartUploadReturns: 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::DeleteBucketReturns: 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. DeleteBucketCors(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketCorsReturns: nothing Deletes the cors configuration information set for the bucket. DeleteBucketLifecycle(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketLifecycleReturns: nothing Deletes the lifecycle configuration from the bucket. DeleteBucketPolicy(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketPolicyReturns: nothing Deletes the policy from the bucket. DeleteBucketReplication(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketReplicationReturns: nothing DeleteBucketTagging(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketTaggingReturns: nothing Deletes the tags from the bucket. DeleteBucketWebsite(Bucket => Str)Each argument is described in detail in: Paws::S3::DeleteBucketWebsiteReturns: nothing This operation removes the website configuration from the bucket. DeleteObject(Bucket => Str, Key => Str, [MFA => Str, RequestPayer => Str, VersionId => Str])Each argument is described in detail in: Paws::S3::DeleteObjectReturns: 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, [MFA => Str, RequestPayer => Str])Each argument is described in detail in: Paws::S3::DeleteObjectsReturns: 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. GetBucketAcl(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketAclReturns: a Paws::S3::GetBucketAclOutput instance Gets the access control policy for the bucket. GetBucketCors(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketCorsReturns: a Paws::S3::GetBucketCorsOutput instance Returns the cors configuration for the bucket. GetBucketLifecycle(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketLifecycleReturns: a Paws::S3::GetBucketLifecycleOutput instance Returns the lifecycle configuration information set on the bucket. GetBucketLocation(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketLocationReturns: a Paws::S3::GetBucketLocationOutput instance Returns the region the bucket resides in. GetBucketLogging(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketLoggingReturns: 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. GetBucketNotification(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketNotificationReturns: a Paws::S3::NotificationConfigurationDeprecated instance Deprecated, see the GetBucketNotificationConfiguration operation. GetBucketNotificationConfiguration(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketNotificationConfigurationReturns: a Paws::S3::NotificationConfiguration instance Returns the notification configuration of a bucket. GetBucketPolicy(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketPolicyReturns: a Paws::S3::GetBucketPolicyOutput instance Returns the policy of a specified bucket. GetBucketReplication(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketReplicationReturns: a Paws::S3::GetBucketReplicationOutput instance GetBucketRequestPayment(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketRequestPaymentReturns: 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::GetBucketTaggingReturns: 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::GetBucketVersioningReturns: a Paws::S3::GetBucketVersioningOutput instance Returns the versioning state of a bucket. GetBucketWebsite(Bucket => Str)Each argument is described in detail in: Paws::S3::GetBucketWebsiteReturns: 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, 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::GetObjectReturns: 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::GetObjectAclReturns: a Paws::S3::GetObjectAclOutput instance Returns the access control list (ACL) of an object. GetObjectTorrent(Bucket => Str, Key => Str, [RequestPayer => Str])Each argument is described in detail in: Paws::S3::GetObjectTorrentReturns: a Paws::S3::GetObjectTorrentOutput instance Return torrent files from a bucket. HeadBucket(Bucket => Str)Each argument is described in detail in: Paws::S3::HeadBucketReturns: 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, Range => Str, RequestPayer => Str, SSECustomerAlgorithm => Str, SSECustomerKey => Str, SSECustomerKeyMD5 => Str, VersionId => Str])Each argument is described in detail in: Paws::S3::HeadObjectReturns: 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. ListBuckets( => )Each argument is described in detail in: Paws::S3::ListBucketsReturns: 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::ListMultipartUploadsReturns: 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])Each argument is described in detail in: Paws::S3::ListObjectsReturns: 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. ListObjectVersions(Bucket => Str, [Delimiter => Str, EncodingType => Str, KeyMarker => Str, MaxKeys => Int, Prefix => Str, VersionIdMarker => Str])Each argument is described in detail in: Paws::S3::ListObjectVersionsReturns: 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::ListPartsReturns: a Paws::S3::ListPartsOutput instance Lists the parts that have been uploaded for a specific multipart upload. PutBucketAcl(Bucket => Str, [AccessControlPolicy => Paws::S3::AccessControlPolicy, ACL => Str, ContentMD5 => Str, GrantFullControl => Str, GrantRead => Str, GrantReadACP => Str, GrantWrite => Str, GrantWriteACP => Str])Each argument is described in detail in: Paws::S3::PutBucketAclReturns: nothing Sets the permissions on a bucket using access control lists (ACL). PutBucketCors(Bucket => Str, [ContentMD5 => Str, CORSConfiguration => Paws::S3::CORSConfiguration])Each argument is described in detail in: Paws::S3::PutBucketCorsReturns: nothing Sets the cors configuration for a bucket. PutBucketLifecycle(Bucket => Str, [ContentMD5 => Str, LifecycleConfiguration => Paws::S3::LifecycleConfiguration])Each argument is described in detail in: Paws::S3::PutBucketLifecycleReturns: nothing Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it. PutBucketLogging(Bucket => Str, BucketLoggingStatus => Paws::S3::BucketLoggingStatus, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketLoggingReturns: 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. PutBucketNotification(Bucket => Str, NotificationConfiguration => Paws::S3::NotificationConfigurationDeprecated, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketNotificationReturns: nothing Deprecated, see the PutBucketNotificationConfiguraiton operation. PutBucketNotificationConfiguration(Bucket => Str, NotificationConfiguration => Paws::S3::NotificationConfiguration)Each argument is described in detail in: Paws::S3::PutBucketNotificationConfigurationReturns: nothing Enables notifications of specified events for a bucket. PutBucketPolicy(Bucket => Str, Policy => Str, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketPolicyReturns: 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, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketReplicationReturns: nothing Creates a new replication configuration (or replaces an existing one, if present). PutBucketRequestPayment(Bucket => Str, RequestPaymentConfiguration => Paws::S3::RequestPaymentConfiguration, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketRequestPaymentReturns: 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, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketTaggingReturns: nothing Sets the tags for a bucket. PutBucketVersioning(Bucket => Str, VersioningConfiguration => Paws::S3::VersioningConfiguration, [ContentMD5 => Str, MFA => Str])Each argument is described in detail in: Paws::S3::PutBucketVersioningReturns: 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, [ContentMD5 => Str])Each argument is described in detail in: Paws::S3::PutBucketWebsiteReturns: 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, RequestPayer => Str, ServerSideEncryption => Str, SSECustomerAlgorithm => Str, SSECustomerKey => Str, SSECustomerKeyMD5 => Str, SSEKMSKeyId => Str, StorageClass => Str, WebsiteRedirectLocation => Str])Each argument is described in detail in: Paws::S3::PutObjectReturns: a Paws::S3::PutObjectOutput instance Adds an object to a bucket. PutObjectAcl(Bucket => Str, Key => Str, [AccessControlPolicy => Paws::S3::AccessControlPolicy, ACL => Str, ContentMD5 => Str, GrantFullControl => Str, GrantRead => Str, GrantReadACP => Str, GrantWrite => Str, GrantWriteACP => Str, RequestPayer => Str])Each argument is described in detail in: Paws::S3::PutObjectAclReturns: 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 RestoreObject(Bucket => Str, Key => Str, [RequestPayer => Str, RestoreRequest => Paws::S3::RestoreRequest, VersionId => Str])Each argument is described in detail in: Paws::S3::RestoreObjectReturns: a Paws::S3::RestoreObjectOutput instance Restores an archived copy of an object back into Amazon S3 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::UploadPartReturns: 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::UploadPartCopyReturns: a Paws::S3::UploadPartCopyOutput instance Uploads a part by copying data from an existing object as data source. SEE ALSOThis service class forms part of PawsBUGS and CONTRIBUTIONSThe source code is located here: https://github.com/pplu/aws-sdk-perlPlease report bugs to: https://github.com/pplu/aws-sdk-perl/issues
Visit the GSP FreeBSD Man Page Interface. |