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

5.6 KiB

Raw Permalink Blame History

GET Bucket location

Only the bucket owner or a user that is granted with the s3:GetBucketLocation permission in the bucket policy can obtain the bucket location information.

Request Syntax

GET /?location HTTP/1.1 
 User-Agent: agent
 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: Server Name 
 x-amz-request-id: request id 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 x-amz-id-2: id 
 Content-Type: type 
 Date: date 
 Content-Length: length 

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <CreateBucketConfiguration xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <LocationConstraint>Location</LocationConstraint> 
 </CreateBucketConfiguration>

Response Headers

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

Response Elements

This response contains an element to describe the bucket Region. Table 1 describes this element.

**Table 1** Response element
Element	Description
LocationConstraint	Indicates information about a bucket's Region. Type: String

Error Responses

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

Sample Request

GET /?location HTTP/1.1 
 User-Agent: Jakarta Commons-HttpClient/3.1 
 Host: bucketname.obs.example.com
 Accept: */*
 Date: Sun, 26 Sep 2010 09:16:00 GMT  
 Authorization: AWS 04RZT432N80TGDF2Y2G2:JUtd9kkJFjbKbkP9f6T/tAxozYY=

Sample Response

HTTP/1.1 200 OK 
 Server: OBS 
 x-amz-request-id: 367CB63A2F283044981285492719060 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 x-amz-id-2: MzY3Q0I2M0EyRjI4MzA0NDk4MTI4NTQ5MjcxOTA2MEFBQUFBQUFBYmJiYmJiYmJD 
 Content-Type: application/xml 
 Date: Sun, 26 Sep 2010 09:18:36 GMT 
 Content-Length: 560 

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <CreateBucketConfiguration xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <LocationConstraint>example</LocationConstraint> 
 </CreateBucketConfiguration>

Parent topic: Operations on Buckets

5.6 KiB Raw Permalink Blame History