This API is used to query the intelligent tiering configuration on a bucket.
Note:
- Only the root account or sub-accounts that are granted permission for the GET Bucket IntelligentTiering operation can call this API.
- There are two types of responses to this API request:
- If you never enabled intelligent tiering configuration on the bucket before, the response will be:
<IntelligentTieringConfiguration/>
- If you enabled intelligent tiering configuration on the bucket, the response will be:
<IntelligentTieringConfiguration xmlns="cos xmlns/">
<Status>Enabled</Status>
<Transition>
<Days>30</Days>
</Transition>
</IntelligentTieringConfiguration>
GET /?intelligenttiering HTTP 1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT date
Authorization: Auth String
Note:
Authorization: Auth String (see Request Signature for more information).
This API does not use any request parameters.
This API only uses common request headers. For more information, see Common Request Headers.
This request has no request body.
This API only returns common response headers. For more information, see Common Response Headers.
<IntelligentTieringConfiguration xmlns="cos xmlns/">
<Status>Enabled</Status>
<Transition>
<Days>30|60|90</Days>
</Transition>
</IntelligentTieringConfiguration>
The nodes are described in details below:
Node Name | Parent Node | Description | Type |
---|---|---|---|
IntelligentTieringConfiguration | None | Information on the intelligent tiering configuration | Container |
Status | IntelligentTieringConfiguration | Specifies the status of the intelligent tiering configuration once enabled. Enumerated values: Suspended, Enabled | Enum |
Transition | IntelligentTieringConfiguration | Specifies the transition for objects in the intelligent tiering configuration | Container |
Days | IntelligentTieringConfiguration.Transition | Specifies the number of consecutive days for which objects have not been accessed in the frequent access tier, and are therefore moved to the infrequent access tier. Valid values: 30 (default), 60, 90 | Int |
This API returns uniform error responses and error codes. For more information, see Error Codes.
GET /?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
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=5118a936049f9d44482bbb61309235cf4abe****
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 120
Connection: keep-alive
Date: Sun, 23 Aug 2020 08:15:16 GMT
Server: tencent-cos
x-cos-request-id: NTk5ZDM5OTRfZDNhZDM1MGFfMjYyMTFfZmU3****
<IntelligentTieringConfiguration xmlns="cos xmlns/">
<Status>Enabled</Status>
<Transition>
<Days>30</Days>
</Transition>
</IntelligentTieringConfiguration>
Was this page helpful?