Obtaining Bucket Location
Functions
This operation obtains the location of a bucket. To use this operation, you must have the permission to read the bucket.
Request Syntax
GET /?location HTTP/1.1Host: bucketname.obs.region.example.comDate: dateAuthorization: authorization
Request Parameters
This request contains no parameters.
Request Headers
This request uses common headers. For details, see Table 3.
Request Elements
This request contains no elements.
Response Syntax
HTTP/1.1 status_codeDate: dateContent-Type: typeContent-Length: length<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Location xmlns="http://obs.region.example.com/doc/2015-06-30/">region</Location>
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains elements of information about a bucket's region. Table 1 describes the elements.
Element | Description |
---|---|
Location | Indicates the region where the bucket resides. Type: string |
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
GET /?location HTTP/1.1User-Agent: curl/7.29.0Host: examplebucket.obs.region.example.comAccept: */*Date: WED, 01 Jul 2015 02:30:25 GMTAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:1DrmbCV+lhz3zV7uywlj7lrh0MY=
Sample Response
HTTP/1.1 200 OKServer: OBSx-obs-request-id: BF260000016435D9F27CB2758E9B41A5x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSKWoJmaMyRXqofHgapbETDyI2LM9rUwContent-Type: application/xmlDate: WED, 01 Jul 2015 02:30:25 GMTContent-Length: 128<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Location xmlns="http://obs.region.example.com/doc/2015-06-30/">region</Location>
Parent topic: Operations on Buckets
- Functions
- Request Syntax
- Request Parameters
- Request Headers
- Request Elements
- Response Syntax
- Response Headers
- Response Elements
- Error Responses
- Sample Request
- Sample Response