This API is used to enable INTELLIGENT TIERING for a bucket.
Note:
- Once enabled, INTELLIGENT TIERING cannot be disabled or modified.
- Only the root account and authorized sub-accounts can call the
PUT Bucket IntelligentTiering
API.- You can use
x-cos-storage-tier
returned by the HEAD Object API to determine the storage tier of the object.
PUT /?intelligenttiering HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Connection: keep-alive
Authorization: authorization string
Content-Type: text/plain
Content-Length: Int
Note:
Authorization: Auth String (See Request Signature for details.)
This API has no request parameter.
This API only uses common request headers. For more information, please see Common Request Headers.
<IntelligentTieringConfiguration xmlns="cos xmlns/">
<Status>Enabled</Status>
<Transition>
<Days>30|60|90</Days>
</Transition>
</IntelligentTieringConfiguration>
The parameters are described as follows:
Name | Parent Node | Description | Type | Required |
---|---|---|---|---|
IntelligentTieringConfiguration | No | Detailed configuration of INTELLIGENT TIERING | Container | Yes |
Status | IntelligentTieringConfiguration | Indicates whether INTELLIGENT TIERING is enabled. Enumerated values: Suspended , Enabled |
Enum | Yes |
Transition | IntelligentTieringConfiguration | Specifies the transition configuration for INTELLIGENT TIERING | Container | Yes |
Days | IntelligentTieringConfiguration.Transition | Specifies the number of consecutive days after which objects are moved from STANDARD to STANDARD_IA. The default value is 30 (days). | Int | Yes |
This API returns only common response headers. For more information, please see Common Response Headers.
The response body of this API is empty.
This API returns common error responses and error codes. For more information, please see Error Codes.
PUT /?intelligenttiering HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.12.4
Content-Type: application/xml
Authorization: q-sign-algorithm=sha1&q-ak=AKID15IsskiBQKTZbAo6WhgcBqVls9Sm****&q-sign-time=1480932292;1981012292&q-key-time=1480932292;1981012292&q-url-param-list=versioning&q-header-list=host&q-signature=47ec2b80c73788ecd394d3b9ad90e120a32f****
Content-Length: 83
<IntelligentTieringConfiguration xmlns="cos xmlns/">
<Status>Enabled</Status>
<Transition>
<Days>30</Days>
</Transition>
</IntelligentTieringConfiguration>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Sun, 23 Aug 2020 08:14:53 GMT
Server: tencent-cos
x-cos-request-id: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0****
Was this page helpful?