Petabox
  • Introduction
  • Petabox FAQ
  • Concepts
    • Bucket versioning
    • Logging actions with a bucket
    • Object Lock
  • Tools
    • Supported tools
      • CyberDuck S3 Client
      • Mountain Duck
      • S3 Browser
      • RClone
      • AWS CLI Console client
      • SDKs for different languages
        • JavaScript SDK
        • AWS SDK for Java
        • Python SDK (boto)
  • S3 Compatible API
    • How to use the API
    • Signing Requests
    • API Reference
      • Bucket
        • HeadBucket
        • ListObjects/ListObjectsV2
        • PutBucketVersioning
        • PutBucketLogging
        • ListBuckets
        • RenameBucket
        • GetBucketLocation
      • Object
        • PutObject
        • GetObject
        • HeadObject
        • RenameObject
        • PutObjectAcl
      • Multipart upload
        • General multipart upload order
        • CreateMultipartUpload
        • UploadPart
        • CompleteMultipartUpload
        • ListMultipartUploads
      • Analytics
        • GetStatistics
        • GetBandwidthAnalytics
        • GetStorageAnalytics
      • Common request headers
      • Common response headers
      • Responses
      • GetObjectTagging
      • GetObjectAcl
      • GetBucketAcl
      • ListObjectVersions
      • GetBucketRequestPayment
      • GetBucketReplication
      • GetBucketTagging
      • GetBucketLocation
      • GetBucketVersioning
      • GetBucketLifecycle
      • GetObjectLockConfiguration
      • PutObjectLockConfiguration
      • GetObjectRetention
      • GetObjectLegalHold
      • PutObjectRetention
      • PutObjectLegalHold
      • PutObjectAcl
      • PutBucketAcl
      • PutBucketVersioning
      • CopyObject
      • DeleteObjects
      • AbortMultipartUpload
      • DeleteObject
      • DeleteBucket
      • PutBucketTagging
      • PutObjectTagging
      • DeleteBucketTagging
      • DeleteObjectTagging
      • PutBucketLogging
      • GetBucketLogging
      • ListParts
      • UploadPartCopy
      • PutBucketPolicy
      • GetBucketPolicy
      • DeleteBucketPolicy
Powered by GitBook
On this page
  • Request
  • Answer
  1. S3 Compatible API
  2. API Reference
  3. Bucket

ListBuckets

PreviousPutBucketLoggingNextRenameBucket

Last updated 3 years ago

Returns a list of buckets available to the user.

Request

GET / HTTP/1.1

Headings

Use only in your request .

Answer

Headings

The response can only contain .

Answer codes

For a list of possible answers, see the section .

The successful response contains additional data in XML format, the schema of which is described below.

Data schema

<ListAllMyBucketsResult>
  <Buckets>
    <Bucket>
      <Name>bucket-name</Name>
      <CreationDate>date_time</CreationDate>
    </Bucket>
    ...
  </Buckets>
</ListAllMyBucketsResult>

Element

Description

Bucket

Contains a description of the bucket. Path: /ListAllMyBucketsResult/Buckets/Bucket.

Buckets

Contains a list of buckets. Path: /ListAllMyBucketsResult/Buckets.

CreationDate

Bucket creation time in yyyy-mm-ddThh:mm:ss.timezone. Path: /ListAllMyBucketsResult/Buckets/Bucket/CreationDate.

ListAllMyBucketsResult

The root element of the response. Path: /ListAllMyBucketsResult.

Name

Bucket name. Path: /ListAllMyBucketsResult/Buckets/Bucket/Name.

generic headers
general headers
Answers