Updated on 2022-02-10 GMT+08:00

Obtain 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 storage class and CORS rules (if set).

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 Result

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)
              }
       }
}