一、请求示例
GET /?intelligent-tiering HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String
注意:说明:
二、请求参数
此接口无请求参数。
三、请求头
此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。
四、请求体
该请求的请求体为空。
五、响应头
此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。
六、响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<ListBucketIntelligentTieringConfigurationOutput> <IntelligentTieringConfiguration> <Id>default</Id> <Status>Enabled</Status> <Tiering> <AccessTier>INFREQUENT</AccessTier> <Days>30</Days> <RequestFrequent>1</RequestFrequent> </Tiering> </IntelligentTieringConfiguration> <IntelligentTieringConfiguration> <Id></Id> <Status></Status> <Filter> <And> <Prefix>string</Prefix> <Tag> <Key>string</Key> <Value>string</Value> </Tag> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </And> </Filter> <Tiering> <AccessTier>ARCHIVE_ACCESS</AccessTier> <Days></Days> </Tiering> <Tiering> <AccessTier>DEEP_ARCHIVE_ACCESS</AccessTier> <Days></Days> </Tiering> </IntelligentTieringConfiguration> <IntelligentTieringConfiguration> <Id></Id> <Status></Status> <Filter> <And> <Prefix>string</Prefix> <Tag> <Key>string</Key> <Value>string</Value> </Tag> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </And> </Filter> <Tiering> <AccessTier>ARCHIVE_ACCESS</AccessTier> <Days></Days> </Tiering> <Tiering> <AccessTier>DEEP_ARCHIVE_ACCESS</AccessTier> <Days></Days> </Tiering> </IntelligentTieringConfiguration></ListBucketIntelligentTieringConfigurationOutput>
具体的节点描述如下:
| 名称 | 父节点 | 描述 | 类型 |
| ListBucketIntelligentTieringConfigurationOutput | 无 | 存储桶中所有智能分层配置规则的列表 | Container |
| IntelligentTieringConfiguration | ListBucketIntelligentTieringConfigurationOutput | 包含智能分层配置的详细信息,其 XML 结构请参见 GET Bucket IntelligentTiering | Container |
七、错误码
此接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。
八、请求
下述请求示例展示了从存储桶 examplebucket-1250000000 中获取智能分层配置规则。
GET /?intelligent-tiering HTTP/1.1Date: Mon, 28 Aug 2018 02:53:38 GMTAuthorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1503895278;1503895638&q-key-time=1503895278;1503895638&q-header-list=host&q-url-param-list=inventory&q-signature=****************************************Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
九、响应
请求后,COS 返回以下响应,表明当前该存储桶内存在低频层规则default、归档及深度归档层规则 rule1 和 rule2 。
低频规则 default
·连续30天无访问,智能分层对象从高频访问层转换为低频访问层。
归档及深度归档层规则 rule1
·针对存储桶 examplebucket-1250000000 中前缀为 folder1 的智能分层对象生效。
·连续100天无访问,智能分层对象从低频访问层转换为归档层。
·连续200天无访问,智能分层对象从归档层转换为深度归档层。
归档及深度归档层规则 rule2
·针对存储桶 examplebucket-1250000000 中前缀为 folder2 的智能分层对象生效。
·连续91天无访问,智能分层对象从低频访问层转换为归档层。
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 331Date: Mon, 28 Aug 2018 02:53:39 GMTServer: tencent-cosx-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF8****<ListBucketIntelligentTieringConfigurationOutput> <IntelligentTieringConfiguration> <Id>default</Id> <Status>Enabled</Status> <Tiering> <AccessTier>INFREQUENT</AccessTier> <Days>30</Days> <RequestFrequent>1</RequestFrequent> </Tiering> </IntelligentTieringConfiguration> <IntelligentTieringConfiguration> <Id>rule1</Id> <Status>Enabled</Status> <Filter> <Prefix>folder1</Prefix> </Filter> <Tiering> <AccessTier>ARCHIVE_ACCESS</AccessTier> <Days>100</Days> </Tiering> <Tiering> <AccessTier>DEEP_ARCHIVE_ACCESS</AccessTier> <Days>200</Days> </Tiering> </IntelligentTieringConfiguration> <IntelligentTieringConfiguration> <Id>rule2</Id> <Status>Enabled</Status> <Filter> <Prefix>folder2</Prefix> </Filter> <Tiering> <AccessTier>ARCHIVE_ACCESS</AccessTier> <Days>91</Days> </Tiering> </IntelligentTieringConfiguration></ListBucketIntelligentTieringConfigurationOutput>