download free 30 days trial version buy bucket explorer
Documentation  Download  Purchase  Support  FAQs   Forum   ScreenShots & Demos

How to get Amazon S3 Bucket Properties (GET Bucket)

To get the Properties of Amazon S3 Buckets in your AWS account, you can send an HTTP GET Bucket Request to Amazon S3 Server. You must be a valid registered AWS Account holder to authenticate the request.

You can send the HTTP GET Bucket Request to Amazon S3 Server in two ways:

a) Programmatically, by using Amazon S3 APIs in your own program-

To get S3 Bucket details, you can do GET Bucket Amazon S3 Rest API request. We will only talk about REST API (GET Bucket) in this documentation. You can visit AWS Documentation site to read more about SOAP APIs.

b) By Point and Click, using Bucket Explorer User Interface

If you do not want to write single line of code for Bucket Details. You can use Bucket Explorer which helps you to get multiple details of S3 Bucket. You can do all this on single mouse click using Bucket Explorer.

The following sections describe how you can follow the above two options to access properties of S3 Buckets in your account.

1. Bucket Property using Amazon S3 REST API (GET Bucket)

To get the properties of the S3 Bucket of your AWS Account, you can request GET Bucket with appropriate request parameters. You do not need to have any parameter in the request body except common Requester headers.

Syntax :

To Get Location of the S3 Bucket

GET /?location HTTP/1.1
Host: yourBucketname
Date: date
Authorization: signatureValue
To Get Owner of the S3 Bucket

GET /?acl HTTP/1.1
Host: yourBucketname
Date: date
Authorization: signatureValue

2. Bucket Property using Bucket Explorer

You can use Bucket Explorer with REST API to access S3 Bucket Properties with point and click.

Bucket Explorer shows many details in its Bucket Property as following. Bucket Explorer does other more Rest API requests to show more Bucket Details like GET Bucket Location, GET Bucket ACL etc.

  1. Bucket Name – In creating a bucket, you need a unique bucket name . In naming a bucket , there are naming conventions or things that need to be considered as mentioned in creating a bucket .
  2. Creation Date of Bucket – It is the time when the bucket was created.
  3. Bucket Location – Also called as Region Endpoint. It is where you create the bucket.
  4. Owner name – It is the AWS User Name who created the Bucket.
  5. Owner id – It is the canonical ID of the AWS user. You need this when you want to share and grant access permissions to buckets and objects within your Amazon S3 account to your friends or to anybody (Update ACL option). The canonical user id is specific to S3 and is a 64 character long hex string. In Bucket Explorer, you can use it as an alternative to email ID when you share your bucket with any other user with his/her AWS registered email ID.
  6. Logging Status –This option lets you know that if Bucket Logging is enabled on the selected Bucket, then it shows the Bucket Name where S3 log file will be created about the S3 operation done on the selected Bucket e.g. “Logged to <bucket name>”, else it shows “Bucket Logging not enabled”.
  7. Versioning Status – The versioning status of your bucket can either be “Enabled” or “Suspended”. If versioning is set on the bucket, then versioning status will show “Enabled’; otherwise, it will show as “Suspended”.
  8. Total virtual folder in selected bucket – Virtual Folders in the selected Bucket is the list of “Common Prefixes”. Common Prefixes are prefixes that end with “/”. In S3, there is no folder concept. So each file resides at root level of the Bucket. Bucket Explorer provides an option to view the files in folder structure.
  9. Total number of files in selected bucket – These are files that reside in the Bucket.
  10. Total size of bucket – It shows the total size of all the objects contained in the selected bucket.
  11. Total number of objects – It shows the total number of files and folders (Common Prefixes) in the Bucket.

Bucket Explorer easily displays the above properties by following the steps below:

  1. Select a bucket from Bucket listing with the properties that you want to see.
  2. Right click on the selected bucket.
  3. Then click on “Properties” option.
  4. You can also click on the Properties icon in toolbar instead of doing the three steps above.
  5. The properties of the selected bucket will then be displayed.