1
0
forked from docs/doc-exports
doc-exports/docs/obs/s3api/en-us_topic_0125560369.html
Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-16 14:51:13 +00:00

4.4 KiB

GET Bucket policy

You can use this operation to return the policy of a specified bucket.

Only the bucket owner or users granted the s3:GetBucketPolicy permission can get the bucket policy.

If the bucket specified in this operation does not have a policy, OBS returns 404 error NoSuchBucketPolicy.

Request Syntax

GET /?policy HTTP/1.1 
 Host: bucketname.obs.example.com 
 Accept: */*
 Date: date 
 Authorization: authorization

Request Parameters

This request involves no parameters.

Request Headers

This request uses common headers. For details about common request headers, see section Common Request Headers.

Request Elements

This request involves no elements.

Response Syntax

HTTP/1.1 status_code 
 Server: OBS 
 x-amz-request-id: 90E2BA26427C00000140F21821AA017A 
 x-amz-id-2: kwE/ohXjGAEm+DJ6Q0bu/ovJsX99na/V16xuDPFFp6C4OXrF+8V1Uu8nK6tvppvE 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 Content-Type: application/xml 
 Date: date 
 Content-Length: length

 Policy Content

Response Headers

This response uses common headers. For details about common response headers, see section Common Response Headers.

Response elements

The response body is a JSON string containing bucket policies.

Error Responses

No special error responses are returned. For details about error responses, see Table 1.

Sample Request

GET /?policy HTTP/1.1 
 Host: bucketname.obs.example.com
Accept: */*
Date: Fri, 06 Sep 2013 07:06:42 GMT
Authorization: signature

Sample Response

HTTP/1.1 200 OK
Server: OBS 
 x-amz-request-id: 90E2BA26427C00000140F21821AA017A 
 x-amz-id-2: kwE/ohXjGAEm+DJ6Q0bu/ovJsX99na/V16xuDPFFp6C4OXrF+8V1Uu8nK6tvppvE 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 Content-Type: application/xml 
 Date: Fri, 06 Sep 2013 07:06:42 GMT
 Content-Length: 184
{ 
 "Id": "Policy1375342051334", 
 "Statement": [ 
 { 
 "Sid": "Stmt1375240018061", 
 "Action": [ 
 "s3:GetBucketLogging" 
 ], 
 "Effect": "Allow", 
 "Resource": "arn:aws:s3:::logging.bucket3", 
 "Principal": { 
 "AWS": [ 
 "norman" 
 ] 
 } 
 } 
 ] 
 }