Amazon...cketV2(3pm)

📦 version 2.0.2, in ubuntu resolute, ubuntu stonking

💖 Amazon::S3::BucketV2 — the lightweight interface to various S3 methods manual, section 3pm, from the User Contributed Perl Documentation girlies ✨

okay so bestie, welcome to Amazon::S3::BucketV2 — your lil' backstage pass to the AWS S3 API. no cap, it's a whole vibe. 🦋

✨ NAME ✨

Amazon::S3::BucketV2 — a lightweight interface to various S3 methods. that's it, that's the girl. 💅

🌸 SYNOPSIS 🌸

here's the tea, literally just copy this:

use Amazon::S3;
use Amazon::S3::BucketV2;

my $s3 = Amazon::S3->new(
    {   aws_access_key_id     => $aws_access_key_id,
        aws_secret_access_key => $aws_secret_access_key,
    }
);

my $s3 = Amazon::S3->new();

my $bucket = Amazon::S3::BucketV2->new(account => $s3, bucket => 'foo');

$bucket->DeleteObject($key);

$bucket->DeleteObjects(undef,
  { Delete => { Object => [ { Key => $key, Version => $version } ] } } );

like… two whole ways to make your $s3, one way to make your $bucket, and then you're deleting things. iconic. 👑

🎀 DESCRIPTION 🎀

A lightweight, generic interface to the AWS S3 API. Amazon::S3::BucketV2 is a subclass of Amazon::S3::Bucket. so not only do you get the methods down below, you also still get to use all the convenience methods the parent class is serving. it's giving nepo baby but in a good way, she inherited everything and earned her own bag too. 💜

⚠️ heads up bestie: this is an experimental implementation and may change in the future. don't build your whole personality on it without a vibe check, k?

Every method listed below gets called with a list — or a hash reference — of key/value pairs. depending on what you need and which API you're hitting, some of these keys are optional. may not be required. read the room (and the API docs) fr fr. 🫶

key — the key in the S3 bucket. yeah. the key. in the bucket.
body — the request body. this should be a hash ref which gets converted into an XML payload that gets sent with the request.

you gotta review the required payload for whatever API you're invoking and hand over the appropriate Perl object to be converted into XML.

wanna see how your Perl object will be serialized? call the create_xml method. slay.

for example, the DeleteObjects API takes a payload that looks like this:

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Object>
      <Key>string</Key>
      <VersionId>string</VersionId>
   </Object>
   ...
   <Quiet>boolean</Quiet>
</Delete>

the corresponding Perl object would be created like this:

my $content = {
  Delete => {
    Object => [
      { Key       => '/foo',
        VersionId => 'OYcLXagmS.WaD..oyH4KRguB95_YhLs7'
      }
    ]
  }
};

…and to verify how that Perl object would be serialized as XML:

use Amazon::S3::Util qw(create_xml_request);

my $content = {
  Delete => {
    Object => [
      { Key       => '/foo',
        VersionId => 'OYcLXagmS.WaD..oyH4KRguB95_YhLs7'
      }
    ]
  }
};

print create_xml_request($content);

uri_params — a hash ref of extra query string parameters. lil' bonus params, as a treat. ✨
headers — a hash ref of extra headers to send along with the request. the API methods will automatically add the required headers for most calls. go read the API specs to figure out how to send any additional headers you might need. 🧚

Example:

$bucket->DeleteObject(key => $key);
$bucket->DeleteObject(key => $key, uri_param => { versionId => $version });

my $content
  = { Delete => { Object => [ { Key => $key, Version => $version } ] } };

$bucket->DeleteObject(body => $content);

💅 METHODS AND SUBROUTINES 💅

every method below can be called in snake_case or CamelCase — she's bilingual, she contains multitudes. 🌈

for the actual documentation on each method, consult the official AWS S3 API guide:

<https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html>

🫣 not me pointing out that yes, put_object_lock_configuraiton is spelled exactly like that, and the URL ends in API_PutObjectLockConfiguraiton.html too. i'm not fixing it, i'm not judging, i'm just the messenger bestie. type it exactly like this or it will not work. 💀

💖 put_object_retention

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html>

💖 put_object_tagging

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html>

💖 put_public_access_block

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html>

🦋 restore_object

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html>

🦋 upload_part

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html>

🦋 upload_part_copy

<https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html>

🌈 SEE OTHER 🌈

Amazon::S3
Amazon::S3::Bucket

go read those too, they're the family. the parent class is literally serving convenience methods the whole time, so show some respect. 🙈

👑 AUTHOR 👑

Rob Lauer — <bigfoot@cpan.org>

and that's the whole page, bestie, you ate. 🍓 this lil' cutie came to you via perl v5.40.1, dated 2025-12-20, straight out of the User Contributed Perl Documentation corner of the internet. mwah. 💋✨

📦 where this page comes from

ubuntu resolute: libamazon-s3-perl 2.0.2-1 · Artistic-1.0-Perl
ubuntu stonking: libamazon-s3-perl 2.0.2-1 · Artistic-1.0-Perl
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms

Amazon...cketV2(3pm)

💖 Amazon::S3::BucketV2 — the lightweight interface to various S3 methods manual, section 3pm, from the User Contributed Perl Documentation girlies ✨

✨ NAME ✨

🌸 SYNOPSIS 🌸

🎀 DESCRIPTION 🎀

💅 METHODS AND SUBROUTINES 💅

🔥 delete_bucket

🔥 delete_bucket_analytics_configuration

🔥 delete_bucket_cors

🔥 delete_bucket_encryption

🔥 delete_bucket_intelligent_tiering

🔥 delete_bucket_inventory_configuration

🔥 delete_bucket_lifecycle

🔥 delete_bucket_metrics_configuration

🔥 delete_bucket_ownership_controls

🔥 delete_bucket_policy

🔥 delete_bucket_replication

🔥 delete_bucket_tagging

🔥 delete_bucket_website

🔥 delete_object

🔥 delete_objects

🔥 delete_object_tagging

🔥 delete_public_access_block

⭐ get_bucket_accelerate_configuration

⭐ get_bucket_acl

⭐ get_bucket_analytics

⭐ get_bucket_cors

⭐ get_bucket_encryption

⭐ get_bucket_intelligent_tiering_configuration

⭐ get_bucket_inventory_configuration

⭐ get_bucket_lifecycle_configuration

⭐ get_bucket_location

⭐ get_bucket_logging

⭐ get_bucket_metrics_configuration

⭐ get_bucket_notification_configuration

⭐ get_bucket_ownership_controls

⭐ get_bucket_policy

⭐ get_bucket_policy_status

⭐ get_bucket_replication

⭐ get_bucket_request_payment

⭐ get_bucket_tagging

⭐ get_bucket_versioning

⭐ get_bucket_website

⭐ get_object_acl

⭐ get_object_attributes

⭐ get_object_legal_hold

⭐ get_object_lock_configuration

⭐ get_object_retention

⭐ get_object_tagging

⭐ get_object_torrent

⭐ get_public_access_block

💖 put_bucket_cors

💖 put_bucket_encryption

💖 put_bucket_intelligent_tiering_configuration

💖 put_bucket_lifecycle

💖 put_bucket_lifecycle_configuration

💖 put_bucket_replication_configuration

💖 put_bucket_tagging

💖 put_bucket_versioning

💖 put_object

💖 put_object_acl

💖 put_object_legal_hold

💖 put_object_lock_configuraiton