Amazon Simple Storage Service

{'ContinuationToken': 'string'}

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)

    • 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.