Get Bucket Policy

最近更新时间:2019-07-05 16:48:10

Get Bucket Policy


描述

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

请求

语法

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

注意:

请求参数

该接口不使用请求参数。

请求头部

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

请求内容

一段用于描述bucket policy的Json字符串。

响应头部

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

响应内容

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

特殊错误

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

示例

请求示例

GET http://ks3-example.ks3-cn-beijing.ksyun.com/?policy HTTP/1.1
Host: ks3-cn-beijing.ksyun.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
Date: Tue, 19 Jul 2016 09:25:29 GMT
Server: Tengine
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
Date: Tue, 19 Jul 2016 09:28:59 GMT
Server: Tengine
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>

金山云,开启您的云计算之旅

注册有礼