GET Location

Description

This GET operation will use the ‘location’ resource to return the region of user space . The user uses’ LocationConstraint ‘in the’ PUT Bucket 'request to set the region of user space. For more information, please click PUT Bucket.

Using this interface requires the user to be the owner of this space.

Request

Grammar

GET /?location HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: authorization string

Note:

• Corresponding relationship between Endpoint and Region
• SignatureValue signature algorithm

Request parameters

The interface does not use request parameters.

Request header

This interface only uses common request headers. For more information, please click Public request headers.

Request content

The interface does not use the requested content.

Response

Response header

This interface can use all common response headers. For more information, please click Public response headers.

Response content

Name	Description
LocationConstraint	Specify the region where the user space will be placed. Type: String Valid value: [ BEIJING ; SHANGHAI ; HONGKONG ]

Special errors

The interface does not return any special errors.

Example

Request example

GET /?location HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2010 12:00:00 GMT
Authorization: authorization string

Response example

<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint xmlns="http://s3.amazonaws.com/doc/2006-03-01/">BEIJING</LocationConstraint>