帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>API 文档>存储桶策略>GetBucketPolicy

GetBucketPolicy

最近更新时间：2026-10-21 18:34:04
我的收藏

本页目录：

GetBucketPolicy 接口请求用于读取存储桶上当前生效的全部授权策略。响应以 JSON 格式返回，结构与 PutBucketPolicy 请求体一致。

请求

请求语法

GET /?policy HTTP/1.1
Host: <BucketName>-x--<APPID>.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization 字段的具体格式见 公共请求头部。

请求参数

参数名称
描述
类型
是否必选
policy
用于声明本次请求操作的是存储桶策略。该参数无需取值，以 ?policy 形式附加在请求 URL 中，见请求语法。
string
是

请求头部

此接口仅使用 公共请求头部，无私有请求头部。

请求体

该请求的请求体为空。

响应

响应头部

除 公共响应头部 外，本接口的响应头部 Content-Type 固定为 application/json。

响应体

请求成功，返回 application/json 数据。
{
    "Version": "2.0",
    "Statement": [
        {
            "Sid": "string",
            "Effect": "allow",
            "Action": ["name/cos:GetObject"],
            "Resource": [
                "qcs::cosrapid:<Region>:uid/<APPID>:<BucketName>-x--<APPID>/*"
            ],
            "Principal": {
                "qcs": [
                    "qcs::cam::uin/<OwnerUin>:uin/<SubUin>"
                ]
            },
            "Condition": {}
        }
    ]
}
响应体结构与 PutBucketPolicy 请求体一致。存储桶上没有配置任何策略时，本接口返回 404 Not Found，错误码为 NoSuchPolicy，响应体为标准错误 XML（<Error> 中 Code 为 NoSuchPolicy），而非返回 statement 为空数组的成功响应。各字段含义详见 PutBucketPolicy 请求体说明。

错误码

本接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

请求

GET /?policy HTTP/1.1
Host: examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com
Date: Fri, 13 Oct 2023 09:13:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1484814099;32557710099&q-key-time=1484814099;32557710099&q-header-list=date;host&q-url-param-list=policy&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应

HTTP/1.1 200 OK
Content-Type: application/json
Date: Fri, 13 Oct 2023 09:13:10 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw

{
    "Version": "2.0",
    "Statement": [
        {
            "Sid": "grant-getobject",
            "Effect": "allow",
            "Action": ["name/cos:GetObject"],
            "Resource": [
      "qcs::cosrapid:ap-guangzhou:uid/1250000000:examplebucket-x--1250000000/*"
            ],
            "Principal": {
                "qcs": ["qcs::cam::uin/100000000001:uin/100000000011"]
            }
        }
    ]
}

中国站