Get Bucket Policy

最近更新时间:2022-11-21 10:31:15

查看PDF

描述

此GET接口可以获取某个Bucket的BucketPolicy配置。
如果要使用此接口,你需要是这个Bucket的所有者。
若接口调用成功,则返回200以及BucketPolicy配置信息;若无权限获取BucketPolicy,则返回403 Access Denied;若不存在BucketPolicy配置,则返回404 Not Found。

请求

语法

GET /?policy HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意:

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息,请点击常用请求头部

请求内容

该接口不使用请求内容。

响应头部

该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部

响应内容

BucketPolicy配置信息,Json格式的字符串。

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

GET /?policy HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Authorization: authorization string
Date: Tue, 19 Jul 2016 09:12:54 GMT

响应示例

Bucket Policy存在时:

HTTP/1.1 200 OK
Content-Length: 232
Content-Type: application/json; charset=UTF-8
Connection: keep-alive
Date: Tue, 19 Jul 2016 09:25:29 GMT
Server: KS3
X-Kss-Request-Id: 708e01a0b42642cd94611f33a2a96874
{
  "Version": "2008-10-17",
  "Statement": [
    {
      "Sid": "1",
      "Effect": "Allow",
      "Principal": {
        "KSC": [
          "krn:ksc:iam::{userid}:root"
        ]
      },
      "Action": [
        "ks3:PutObject"
      ],
      "Resource": [
        "krn:ksc:ks3:::ks3-example/*",
        "krn:ksc:ks3:::ks3-example"
      ]
    }
  ]
}

Bucket Policy不存在时:

HTTP/1.1 404 Not Found
Content-Type: application/xml
Connection: keep-alive
Date: Tue, 19 Jul 2016 09:28:59 GMT
Server: KS3
X-Kss-Request-Id: 1f807bb266854e4487ce27857001ba38
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Error>
    <Code>NoSuchBucketPolicy</Code>
    <Message>The bucket policy does not exist.</Message>
    <Resource>/ks3-example/?policy</Resource>
    <RequestId>1f807bb266854e4487ce27857001ba38</RequestId>
</Error>

错误码

错误码 HTTP状态码 描述
NoSuchBucketPolicy 404 Not Found Bucket没有配置权限策略。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈