Listing Your Buckets

You can list the buckets you created. This action also returns information about their date and time of creation.

The buckets that other users shared with you do not appear.

Listing Your Buckets Using AWS CLI

To list your buckets, use the list-buckets command following this syntax:

Request sample
$ aws s3api list-buckets \
    --profile YOUR_PROFILE \

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The list-buckets command returns the following elements:

  • Owner: Information about the owner of the bucket. This element contains the following information:

    • DisplayName: Your OUTSCALE account ID.

    • ID: Your S3 user ID.

  • Buckets: Information about your buckets. This element contains the following information for each bucket:

    • CreationDate: The date and time of creation.

    • Name: The name you specified for your bucket.

Result Sample

    "Owner": {
        "DisplayName": "ACCOUNT_ID",
        "ID": "USER_ID"
    "Buckets": [
            "CreationDate": "2017-01-01T08:03:16.000Z",
            "Name": "BUCKET"
  • You can also perform this action using an s3 command following this syntax:

    $ aws s3 ls --profile YOUR_PROFILE --endpoint
  • You can also manage your object storage resources using s3cmd commands. For more information, see s3cmd.

Related Pages

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.