GET Bucket location

バケットが配置されているリージョン情報を返します。

このリクエストを実行するユーザは対象バケットの所有者でなければならなりません。

S3ドキュメントではPOST操作との関連性にも言及されていますが、POSTにおいても同様です。

リクエスト情報

シンタックス

GET /?location HTTP/1.1
Host: {bucket name}.storage-dag.iijgio.com
Date: {date}
Authorization: {authorization string}

リクエストパラメータ

この操作ではリクエストパラメータは使用しません。

リクエストヘッダー

この操作では基本リクエストヘッダーのみ使用します。

リクエストエレメント

この操作ではリクエストエレメントは使用しません。

レスポンス情報

レスポンスヘッダー

この操作では基本レスポンスヘッダーのみ返します。

レスポンスエレメント

この操作では以下のレスポンスエレメントを返します。

表. GET Bucket location レスポンスエレメント一覧
名前 説明
LocationConstraint
バケットが属するリージョン
型:String
取り得る値:JP-WEST1
親:なし

エラー情報

この操作では以下のエラーを返します。

表. GET Bucket location エラーコード一覧
コード ステータス 内容
InvalidAccessKeyId 403 Forbidden 指定のアクセスキーIDを持つユーザが存在しません。
SignatureDoesNotMatch 403 Forbidden 指定されたリクエストのシグネチャが一致しません。
NoSuchBucket 404 Not Found 指定のバケットが存在しません。
AccessDenied 403 Forbidden アクセス権限がありません。

サンプル

バケットのリージョンを取得するサンプル
リクエスト
GET /?location HTTP/1.1
Host: myBucket.storage-dag.iijgio.com
Date: Tue, 09 Oct 2007 20:26:04 +0000
Authorization: IIJGIO 1ATXQ3HHA59CYF1CVS02:JUtd9kkJFjbKbkP9f6T/tAxozYY=
レスポンス
<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint>JP-WEST1</LocationConstraint>

ページ先頭へ