# Configuring Storage Class for a Bucket

#### Functions

This operation sets or updates the default storage class of a bucket.

To perform this operation, you must have the PutBucketStoragePolicy 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.

After the default storage class has been set for a bucket, if the storage class of an object is not specified during uploading, copying, or initialization of multi-part upload, the object storage class is the same as the default storage class of the bucket.

The default storage class of a bucket is Standard.

#### Request Syntax

    1
    2
    3
    4
    5
    6
    7
    8
    9

    PUT /?storageClass HTTP/1.1
    Host: bucketname.obs.region.example.com
    Date: date
    Content-Type: type
    Content-Length: length
    Authorization: authorization

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <StorageClass xmlns="http://obs.example.com/doc/2015-06-30/">STANDARD</StorageClass>

#### Request Parameters

This request contains no parameter.

#### Request Headers

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

#### Request Elements

This request needs an additional element to specify the default bucket storage class. For details, see Table 1.

Table 1 Additional request elements
Element | Description | Mandatory
--- | --- | ---
StorageClass | Specifies the default storage class for a bucket. Type: string Value options: STANDARD | WARM | COLD There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) Therefore, the following values can be configured: STANDARD, WARM, and COLD. | Yes

#### Response Syntax

    1
    2

    HTTP/1.1 status_code
    Date: date

#### Response Headers

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

#### Response Elements

This response involves no elements.

#### Error Responses

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

#### Sample Request

    1
    2
    3
    4
    5
    6
    7
    8
    9

    PUT /?storageClass HTTP/1.1
    User-Agent: curl/7.29.0
    Host: examplebucket.obs.region.example.com
    Accept: */*
    Date: WED, 01 Jul 2015 03:18:19 GMT
    Authorization: OBS H4IPJX0TQTHTHEBQQCEC:Tf6XbndPx/yNgfAVQ6KIXr7tMj4=
    Content-Length: 87

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

#### Sample Response

    1
    2
    3
    4
    5
    6

    HTTP/1.1 200 OK
    Server: OBS
    x-obs-request-id: BF2600000164368E704B571F328A8797
    x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSIsw3tPtUn6damTI5acQmQAcEfmTwl3
    Date: WED, 01 Jul 2015 03:18:19 GMT
    Content-Length: 0

Parent topic: Advanced Bucket Settings