LIST Bucket IntelligentTiering Configurations

Recent Pages

LIST Bucket IntelligentTiering Configurations

最后更新时间：2024-06-21 09:57:18

功能描述
List Bucket IntelligentTiering Configurations 用于请求返回一个存储桶中的所有智能分层配置，包括低频层规则（id 为 default）、归档及深度归档层规则（id 非 default）。每一个存储桶中最多配置1000条规则。  
注意：
调用该请求时，请确保您有足够的权限对存储桶的智能分层配置进行操作。
存储桶所有者默认拥有该权限，如您无该项权限，请先向存储桶所有者申请该项操作的权限。
请求
请求示例
GET /?intelligent-tiering HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档；<Region> 为 COS 的可用地域，可参阅 地域和访问域名 文档。
Authorization: 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.1
Date: Mon, 28 Aug 2018 02:53:38 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98JM&q-sign-time=1503895278;1503895638&q-key-time=1503895278;1503895638&q-header-list=host&q-url-param-list=inventory&q-signature=f77900be432072b16afd8222b4b349aabd837cb9
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 OK
Content-Type: application/xml
Content-Length: 331
Date: Mon, 28 Aug 2018 02:53:39 GMT
Server: tencent-cos
x-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>
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

LIST Bucket IntelligentTiering Configurations

功能描述

请求

请求示例

请求参数

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

名称	父节点	描述	类型
ListBucketIntelligentTieringConfigurationOutput	无	存储桶中所有智能分层配置规则的列表	Container
IntelligentTieringConfiguration	ListBucketIntelligentTieringConfigurationOutput	包含智能分层配置的详细信息，其 XML 结构请参见 GET Bucket IntelligentTiering	Container

tencent cloud

注册

登录

Recent Pages

LIST Bucket IntelligentTiering Configurations

功能描述

请求

请求示例

请求参数

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？