Amazon-S3

 view release on metacpan or  search on metacpan

README-TESTING.md  view on Meta::CPAN

spend a few pennies (or don't have access to AWS credentials) you can
try one of the S3 mocking services.  The two of the most popular services
seem to be:

* [LocalStack](https://localstack.io)
* [minio](https://min.io)

Both of these implement a subset of the S3 API. __Note that Some tests will fail
on both services (as of the writing of this document).__ To make it
through the tests, try setting one or more of the environment
variables above which will selectively skip some test.

If you are using a mocking service, you might find it useful to set
the environment variable AWS_EC2_METADATA_DISABLED to a true value.

```
export AWS_EC2_METADATA_DISABLED=true
```

This will prevent the AWS CLI from looking for metadata when you are
not actually running on an EC2 instance or container.  Without this

README.md  view on Meta::CPAN

Takes the same arguments as `list_bucket`.

_You are encouraged to use the newer `list_bucket_all_v2` method._

## list\_object\_versions

    list_object_versions( args ) 

Returns metadata about all versions of the objects in a bucket. You
can also use request parameters as selection criteria to return
metadata about a subset of all the object versions.

This method will only return the raw result set and does not perform
pagination or unravel common prefixes as do other methods like
`list_bucket`. This may change in the future.

See [https://docs.aws.amazon.com/AmazonS3/latest/API/API\_ListObjectVersions.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html)
for more information about the request parameters and the result body.

`args` is hash reference containing the following parameters:

README.md  view on Meta::CPAN

    the action returns up to 1,000 key names. The response might contain
    fewer keys but will never contain more. If additional keys satisfy the
    search criteria, but were not returned because max-keys was exceeded,
    the response contains <isTruncated>true</isTruncated>. To return the
    additional keys, see key-marker and version-id-marker.

    default: 1000

- prefix            

    Use this parameter to select only those keys that begin with the
    specified prefix. You can use prefixes to separate a bucket into
    different groupings of keys. (You can think of using prefix to make
    groups in the same way that you'd use a folder in a file system.) You
    can use prefix with delimiter to roll up numerous objects into a
    single result under CommonPrefixes.

- version-id-marker 

    Specifies the object version you want to start listing from.

lib/Amazon/S3.pm  view on Meta::CPAN

Takes the same arguments as C<list_bucket>.

I<You are encouraged to use the newer C<list_bucket_all_v2> method.>

=head2 list_object_versions

 list_object_versions( args ) 

Returns metadata about all versions of the objects in a bucket. You
can also use request parameters as selection criteria to return
metadata about a subset of all the object versions.

This method will only return the raw result set and does not perform
pagination or unravel common prefixes as do other methods like
C<list_bucket>. This may change in the future.

See L<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html>
for more information about the request parameters and the result body.

C<args> is hash reference containing the following parameters:

lib/Amazon/S3.pm  view on Meta::CPAN

the action returns up to 1,000 key names. The response might contain
fewer keys but will never contain more. If additional keys satisfy the
search criteria, but were not returned because max-keys was exceeded,
the response contains <isTruncated>true</isTruncated>. To return the
additional keys, see key-marker and version-id-marker.

default: 1000

=item prefix            

Use this parameter to select only those keys that begin with the
specified prefix. You can use prefixes to separate a bucket into
different groupings of keys. (You can think of using prefix to make
groups in the same way that you'd use a folder in a file system.) You
can use prefix with delimiter to roll up numerous objects into a
single result under CommonPrefixes.

=item version-id-marker 

Specifies the object version you want to start listing from.