Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Get Bucket Location

GET /?location

Returns a bucket's region. ECS does not support regions and always returns the default region: US-Standard.

URL Format

Host Style: http://bucketname.ns1.emc.com/?location
Path Style: http://ns1.emc.com/bucketname?location

Request Headers

x-amz-date optionalThe timestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.

Prerequisites

The following conditions must be met in order to call this operation.

  • Only the owner of the bucket can get a bucket's region

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1)


Response Headers

x-amz-request-id optionalRequest id.
x-amz-id-2 optionalBucket identifier.

Response Body

Response indicating Success or Failure for this operation.