公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ IoTサービス オンラインマニュアル

GET Bucket location

バケットが配置されているリージョン情報を返します。
このリクエストを実行するユーザは対象バケットの所有者でなければならなりません。
S3ドキュメントではPOST操作との関連性にも言及されていますが、POSTにおいても同様です。

 

リクエスト情報

シンタックス
GET /{bucket name}?location HTTP/1.1
Host: s3api.iot.iij.jp
Date: {date}
Authorization: {authorization string}

 

リクエストパラメータ

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

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

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

 

レスポンス情報

レスポンスヘッダー

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

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

表. GET Bucket location レスポンスエレメント一覧

名前説明
LocationConstraint

バケットが属するリージョン

  • 型:String
  • 取り得る値:JP-WEST1
  • 親:なし

 

エラー情報

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

 

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

 

サンプル

バケットのリージョンを取得するサンプル

リクエスト
GET /mybucket?location HTTP/1.1
Host: s3api.iot.iij.jp
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>