GetBucketLocation
Returns the Region the bucket resides in.
Permissions
| Action | Description | Resource |
|---|---|---|
| GetBucketLocation | Grants permission to return the Region that an Astran S3 bucket resides in | bucket |
The following operations are related to GetBucketLocation:
Request Syntax
GET /Bucket?location HTTP/1.1
Host: <partition>.s3.astran.io
URI Request Parameters
The request uses the following URI parameters.
The name of the bucket for which to get the location.
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint>
<LocationConstraint>string</LocationConstraint>
</LocationConstraint>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
Root level tag for the LocationConstraint parameters.
Required: Yes
Specifies the Region where the bucket resides.
Type: String
Valid Values: eu
Examples
Sample Request
The following request returns the Region of the specified bucket.
GET /bucket?location HTTP/1.1
Host: <partition>.s3.astran.io
Date: Tue, 09 Oct 2007 20:26:04 +0000
Authorization: signatureValue
Sample Response
This example illustrates one usage of GetBucketLocation.
<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint xmlns="http://s3.amazonaws.com/doc/2006-03-01/">eu</LocationConstraint>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: