Help Center> Object Storage Service> SDK Reference> Go> Bucket-Related APIs> Obtaining Bucket Metadata
View PDF

Obtaining Bucket Metadata

API Description

You can use this API to send a HEAD request to a bucket to obtain the bucket metadata such as the CORS rules (if set), storage class, and other information.

Method Definition

func (obsClient ObsClient) GetBucketMetadata(input *GetBucketMetadataInput) (output *GetBucketMetadataOutput, err error)

Method Definition If a Signed URL Is Used

func (obsClient ObsClient) GetBucketMetadataWithSignedUrl(signedUrl string, actualSignedRequestHeaders http.Header) (output *GetBucketMetadataOutput, err error)

Request Parameter

Field

Type

Optional or Mandatory

input

*GetBucketMetadataInput

Mandatory

Returned Results

Field

Type

output

*GetBucketMetadataOutput

err

error

Sample Code

func main() {
       input := &obs.GetBucketMetadataInput{}
       input.Bucket = "bucketname"
       output, err := obsClient.GetBucketMetadata(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
              fmt.Printf("StorageClass:%s\n", output.StorageClass)
       } else {
              if obsError, ok := err.(obs.ObsError); ok {
                     fmt.Printf("StatusCode:%d\n", obsError.StatusCode)
              } else {
                     fmt.Println(err)
              }
       }
}
Parent topic: Bucket-Related APIs