Amazon Simple Storage Service

2024/08/15 - Amazon Simple Storage Service - 1 updated api methods

Changes  Amazon Simple Storage Service / Features : Adds support for pagination in the S3 ListBuckets API.

ListBuckets (updated) Link ¶
Changes (response)
{'ContinuationToken': 'string'}

Note

This operation is not supported by directory buckets.

Returns a list of all buckets owned by the authenticated sender of the request. To use this operation, you must have the s3:ListAllMyBuckets permission.

For information about Amazon S3 buckets, see Creating, configuring, and working with Amazon S3 buckets.

See also: AWS API Documentation

Request Syntax

client.list_buckets(
    MaxBuckets=123,
    ContinuationToken='string'
)
type MaxBuckets

integer

param MaxBuckets

Maximum number of buckets to be returned in response. When the number is more than the count of buckets that are owned by an Amazon Web Services account, return all the buckets in response.

type ContinuationToken

string

param ContinuationToken

ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key. You can use this ContinuationToken for pagination of the list results.

Length Constraints: Minimum length of 0. Maximum length of 1024.

Required: No.

rtype

dict

returns

Response Syntax

{
    'Buckets': [
        {
            'Name': 'string',
            'CreationDate': datetime(2015, 1, 1)
        },
    ],
    'Owner': {
        'DisplayName': 'string',
        'ID': 'string'
    },
    'ContinuationToken': 'string'
}

Response Structure

  • (dict) --

    • Buckets (list) --

      The list of buckets owned by the requester.

      • (dict) --

        In terms of implementation, a Bucket is a resource.

        • Name (string) --

          The name of the bucket.

        • CreationDate (datetime) --

          Date the bucket was created. This date can change when making changes to your bucket, such as editing its bucket policy.

    • Owner (dict) --

      The owner of the buckets listed.

      • DisplayName (string) --

        Container for the display name of the owner. This value is only supported in the following Amazon Web Services Regions:

        • US East (N. Virginia)

        • US West (N. California)

        • US West (Oregon)

        • Asia Pacific (Singapore)

        • Asia Pacific (Sydney)

        • Asia Pacific (Tokyo)

        • Europe (Ireland)

        • South America (São Paulo)

        Note

        This functionality is not supported for directory buckets.

      • ID (string) --

        Container for the ID of the owner.

    • ContinuationToken (string) --

      ContinuationToken is included in the response when there are more buckets that can be listed with pagination. The next ListBuckets request to Amazon S3 can be continued with this ContinuationToken . ContinuationToken is obfuscated and is not a real bucket.