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 (s3api)

Before you begin: Install and configure AWS CLI and set up your profile. For more information, see Installing and Configuring AWS CLI.

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

Request sample
$ aws s3api list-buckets \
    --profile YOUR_PROFILE \
    --endpoint https://oos.eu-west-2.outscale.com

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:

    • Name: The name you specified for your bucket.

    • CreationDate: The date and time of creation, in ISO 8601 format.

Result Sample
{

    "Owner": {
        "DisplayName": "ACCOUNT_ID",
        "ID": "USER_ID"
    },
    "Buckets": [
        {
            "Name": "bucket1",
            "CreationDate": "2023-11-29T08:51:46.760000+00:00"
        },
        {
            "Name": "bucket2",
            "CreationDate": "2024-01-31T14:47:33.303000+00:00"
        },
        {
            "Name": "bucket3",
            "CreationDate": "2024-01-30T14:59:21.190000+00:00"
        }
    ]
}

Listing Your Buckets Using AWS CLI (s3)

Before you begin: Install and configure AWS CLI and set up your profile. For more information, see Installing and Configuring AWS CLI.

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

$ aws s3 ls \
    --profile YOUR_PROFILE \
    --debug \
    --endpoint https://oos.eu-west-2.outscale.com

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.

  • (optional) debug: When included, returns the detailed log of the operation. This is useful to analyze and troubleshoot issues you may be encountering.

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

The ls command returns a list of buckets as well as their date and time of creation, in local time.

Result Sample
2023-11-29 09:51:46 bucket1
2024-01-30 10:30:46 bucket2
2024-01-30 15:59:21 bucket3

Listing Your Buckets Using s3cmd

You can 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.