The only thing this module has going for it is that it actually works. Well, that and the code is actually tidy.
The documentation recommends that you use Net::Amazon::S3::Client, which is meant as a sugar layer for the module. However, instead of being sugar it just gets in the way. Avoid it like the plague. Instead restrict yourself to Net::Amazon::S3 and Net::Amazon::S3::Bucket and you'll likely get anything you need, albeit perhaps with a bit of a struggle.
Overall I think the code is much easier to read than the documentation. The design of the module is obtuse and often gets in the way of what you really want to do. But if you can get past that, the module works, so it's hard to complain about that. Therefore I'm giving it 1 bonus star because for all it's faults, it works.