62 lines
2 KiB
ReStructuredText
62 lines
2 KiB
ReStructuredText
List objects in an Amazon S3 bucket
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
The following example shows how to use an Amazon S3 bucket resource to list
|
|
the objects in the bucket.
|
|
|
|
.. code-block:: python
|
|
|
|
import boto3
|
|
|
|
s3 = boto3.resource('s3')
|
|
bucket = s3.Bucket('my-bucket')
|
|
for obj in bucket.objects.all():
|
|
print(obj.key)
|
|
|
|
|
|
List top-level common prefixes in Amazon S3 bucket
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
This example shows how to list all of the top-level common prefixes in an
|
|
Amazon S3 bucket:
|
|
|
|
.. code-block:: python
|
|
|
|
import boto3
|
|
|
|
client = boto3.client('s3')
|
|
paginator = client.get_paginator('list_objects')
|
|
result = paginator.paginate(Bucket='my-bucket', Delimiter='/')
|
|
for prefix in result.search('CommonPrefixes'):
|
|
print(prefix.get('Prefix'))
|
|
|
|
|
|
Restore Glacier objects in an Amazon S3 bucket
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
The following example shows how to initiate restoration of glacier objects in
|
|
an Amazon S3 bucket, determine if a restoration is on-going, and determine if a
|
|
restoration is finished.
|
|
|
|
.. code-block:: python
|
|
|
|
import boto3
|
|
|
|
s3 = boto3.resource('s3')
|
|
bucket = s3.Bucket('glacier-bucket')
|
|
for obj_sum in bucket.objects.all():
|
|
obj = s3.Object(obj_sum.bucket_name, obj_sum.key)
|
|
if obj.storage_class == 'GLACIER':
|
|
# Try to restore the object if the storage class is glacier and
|
|
# the object does not have a completed or ongoing restoration
|
|
# request.
|
|
if obj.restore is None:
|
|
print('Submitting restoration request: %s' % obj.key)
|
|
obj.restore_object()
|
|
# Print out objects whose restoration is on-going
|
|
elif 'ongoing-request="true"' in obj.restore:
|
|
print('Restoration in-progress: %s' % obj.key)
|
|
# Print out objects whose restoration is complete
|
|
elif 'ongoing-request="false"' in obj.restore:
|
|
print('Restoration complete: %s' % obj.key)
|