You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

GetBucketPolicy

最近更新时间：2023.11.21 10:22:22

首次发布时间：2023.03.14 21:02:15

我的收藏

功能描述

此接口用于获取指定桶的桶策略。

注意事项

  • 调用此接口你必须为桶所有者，或桶拥有者的子账号且被授权当前桶的 GetBucketPolicy 权限。使用桶策略实现权限控制的详细介绍，请参见存储桶授权策略管理。
  • 指定桶的策略不存在时，使用此接口获取桶策略，服务端将返回 404 NoSuckBucketPolicy 的错误。

请求消息样式

Get /?policy HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

policy

Query

String

是

-

代表 GetBucketPolicy 请求的特殊标识。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

响应元素是符合 JSON 格式的字符串，包含了桶策略的信息，具体请参见桶策略模板及参数说明。

请求示例

GET /?policy HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 13:53:55 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 212
{
    "Version": "1.0",
    "Statement": [
        {
            "Sid": "桶只读策略",
            "Effect": "Allow",
            "Principal": [
                "210004xxxx/testuser"
            ],
            "Action": [
                "tos:Get*",
                "tos:List*"
            ],
            "Resource": [
                "trn:tos:::bucketname",
                "trn:tos:::bucketname/*"
            ]
        }
    ]
}