• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. User Guide (S3cmd)
  4. Operation Guide
  5. Bucket Management
  6. Viewing Basic Information About a Bucket

Viewing Basic Information About a Bucket

Bucket owners or users that have the following permissions for the buckets can view the basic information about the bucket, including bucket locations, expiration rules, bucket policies, CORS rules, and ACL rules.

  • s3:GetBucketLocation
  • s3:GetLifecycleConfiguration
  • s3:GetBucketPolicy
  • s3:GetBucketCORS
  • s3:GetBucketAcl
NOTE:

You can obtain these permissions by configuring a bucket policy. For details about how to configure a bucket policy, see section Configuring a Bucket Policy.

Procedure

  1. Open the command line tool.
  2. Run the following command to obtain the basic information about a specific bucket:

    s3cmd info s3://my-bucket

    NOTE:

    my-bucket is the name of the bucket whose basic information you want to view.

    In the command output, the basic information about the bucket is displayed in the following format:

    s3://my-bucket/(bucket):
     Location: 
     Payer: None
     Expiration Rule: 
     policy: 
     cors: 
     ACL: 

    Table 1 describes metadata parameters.

    Table 1 Object metadata parameters

    Metadata

    Description

    Location

    The bucket location, that is, the region.

    Payer

    The payment policy of the bucket requester. OBS does not support the ability to modify the payment policy. The value of this parameter is None.

    Expiration Rule

    The expiration rule of a specific object in the bucket.

    policy

    The bucket policy that defines the access control policies of resources (buckets and objects) on OBS.

    cors

    The bucket cross-origin resource sharing (CORS) rule.

    ACL

    The bucket Access Control List (ACL) rule.