Updated on 2024-01-02 GMT+08:00

Obtaining Bucket Storage Class Information

Functions

This operation obtains the default storage class of a bucket.

To perform this operation, you must have the GetBucketStoragePolicy permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.

Request Syntax

1
2
3
4
GET /?storageClass HTTP/1.1 
Host: bucketname.obs.region.example.com
Date: date 
Authorization: authorization

Request Parameters

This request contains no message parameters.

Request Headers

This request uses common headers. For details, see Table 3.

Request Elements

This request contains no elements.

Response Syntax

1
2
3
4
5
6
7
8
HTTP/1.1 status_code 
Date: date 
Content-Type: type 
Content-Length: length 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 

<StorageClass xmlns="http://obs.example.com/doc/2015-06-30/">STANDARD</StorageClass>

Response Headers

The response to the request uses common headers. For details, see Table 1.

Response Elements

This response contains elements to provide details about the storage class information of a bucket. Table 1 describes the elements.

Table 1 Response elements

Element

Description

StorageClass

Default storage class of the bucket.

Type: string. For details about the enumeration types, see Table 1.

Error Responses

No special error responses are returned. For details about error responses, see Table 2.

Sample Request

1
2
3
4
5
6
GET /?storageClass HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 03:20:28 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:0zVTSdKG6OFCIH2dKvmsVGYCQyw=

Sample Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016436BE45820FDF3A65B42C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSCju1CZy3ZfRVW5hiNd024lRFdUoqWy
Content-Type: application/xml
Date: WED, 01 Jul 2015 03:20:28 GMT
Content-Length: 142

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<StorageClass xmlns="http://obs.example.com/doc/2015-06-30/">STANDARD</StorageClass>