PUT Bucket IntelligentTiering

Feature Description
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.
Request
Sample request
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: 
In Host: <BucketName-APPID>.cos.<Region>.myqcloud.com,  <BucketName-APPID> is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).
Authorization: Auth String (See Request Signature for details.)
Request parameters
This API has no request parameter.
Request headers
This API only uses Common Request Headers.
Request body
<IntelligentTieringConfiguration xmlns="cos xmlns/"> 
  <Status>Enabled</Status>
  <Transition>
    <Days>30|60|90</Days>
    <RequestFrequent>1</RequestFrequent>
  </Transition>
</IntelligentTieringConfiguration>
The nodes are described as follows:
Name
Parent Node
Description
Type
Required
IntelligentTieringConfiguration
No
Detailed configuration of INTELLIGENT TIERING
Container
Yes
Status
IntelligentTieringConfiguration
Whether to enable INTELLIGENT TIERING. Enumerated value: Enabled
Enum
Yes
Transition
IntelligentTieringConfiguration
Transition configuration for INTELLIGENT TIERING
Container
Yes
Days
IntelligentTieringConfiguration.Transition
The number of consecutive days used to determine whether to move objects from STANDARD to STANDARD_IA. Valid values: 30, 60, 90. Default value: 30.
Int
Yes
RequestFrequent
IntelligentTieringConfiguration.Transition
The limit of access times used to determine whether to move objects from STANDARD to STANDARD_IA. The default value is 1. It can achieve object transition when used with Days. For example, if this parameter is set to 1 and Days is set to 30, objects accessed less than once in 30 consecutive days will be moved from STANDARD to STANDARD_IA.
Int
Yes
Response
Response headers
This API only returns Common Response Headers.
Response body
The response body of this API is empty.
Error codes
This API returns common error responses and error codes. For more information, see Error Codes.
Examples
Request
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>
    <RequestFrequent>1</RequestFrequent>
  </Transition>
</IntelligentTieringConfiguration>
Response
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?

You can also Contact Sales or Submit a Ticket for help.

Yes

Name	Parent Node	Description	Type	Required
IntelligentTieringConfiguration	No	Detailed configuration of INTELLIGENT TIERING	Container	Yes
Status	IntelligentTieringConfiguration	Whether to enable INTELLIGENT TIERING. Enumerated value: `Enabled`	Enum	Yes
Transition	IntelligentTieringConfiguration	Transition configuration for INTELLIGENT TIERING	Container	Yes
Days	IntelligentTieringConfiguration.Transition	The number of consecutive days used to determine whether to move objects from STANDARD to STANDARD_IA. Valid values: `30`, `60`, `90`. Default value: `30`.	Int	Yes
RequestFrequent	IntelligentTieringConfiguration.Transition	The limit of access times used to determine whether to move objects from STANDARD to STANDARD_IA. The default value is `1`. It can achieve object transition when used with `Days`. For example, if this parameter is set to `1` and `Days` is set to `30`, objects accessed less than once in 30 consecutive days will be moved from STANDARD to STANDARD_IA.	Int	Yes

tencent cloud

Sign Up

Log in

Compute

Microservice

Data Migration

Database SaaS Tool

Data Security

Application Security

Big Data

Tencent Big Model

Internet of Things

Stream Services

Cloud Real-time Rendering

Management and Audit Tools

Edge Computing

Serverless

Relational Database

Networking

Business Security

Domains & Websites

Face Recognition

AI Platform Service

Middleware

Media On-Demand

Game Services

Developer Tools

Container

Essential Storage Service

Enterprise Distributed DBMS

CDN and Acceleration

Security Services

Enterprise Applications

Image Creation

Natural Language Processing

Communication

Media Process Services

Education Sevices

Monitor and Operation

Distributed cloud

Data Process and Analysis

NoSQL Database

Network Security

Cloud Security

Office Collaboration

Voice Technology

Optical Character Recognition

Interactive Video Services

Media SDK

Cloud Resource Management

More

Feature Description

Request

Sample request

Request parameters

Request headers

Request body

Response

Response headers

Response body

Error codes

Examples

Request

Response