GET Bucket location
バケットが配置されているリージョン情報を返します。
このリクエストを実行するユーザは対象バケットの所有者でなければなりません。
S3ドキュメントではPOST操作との関連性にも言及されていますが、POSTにおいても同様です。
詳細はこちらをご覧ください。
https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLocation.html
リクエスト情報
シンタックス
GET /{bucket name}?location HTTP/1.1 |
Host: ds.iot.iij.jp |
Date: {date} |
Authorization: {authorization string} |
リクエストパラメータ
この操作ではリクエストパラメータは使用しません。
リクエストヘッダー
この操作では基本リクエストヘッダーのみ使用します。
リクエストエレメント
この操作ではリクエストエレメントは使用しません。
レスポンス情報
レスポンスヘッダー
この操作では基本レスポンスヘッダーのみ返します。
レスポンスエレメント
この操作では以下のレスポンスエレメントを返します。
表. GET Bucket location レスポンスエレメント一覧
| 名前 | 説明 |
|---|---|
| LocationConstraint | バケットが属するリージョン
|
エラー情報
この操作では以下のエラーを返します。
表. GET Bucket location エラーコード一覧
| コード | ステータス | 内容 |
|---|---|---|
| InvalidAccessKeyId | 403 Forbidden | 指定のアクセスキーIDを持つユーザが存在しません。 |
| SignatureDoesNotMatch | 403 Forbidden | 指定されたリクエストのシグネチャが一致しません。 |
| NoSuchBucket | 404 Not Found | 指定のバケットが存在しません。 |
| AccessDenied | 403 Forbidden | アクセス権限がありません。 |
サンプル
バケットのリージョンを取得するサンプル
リクエスト
GET /mybucket?location HTTP/1.1 |
Host: ds.iot.iij.jp |
Date: Tue, 09 Oct 2007 20:26:04 +0000 |
Authorization: AWS 1ATXQ3HHA59CYF1CVS02:JUtd9kkJFjbKbkP9f6T/tAxozYY= |
レスポンス
<?xml version="1.0" encoding="UTF-8"?> |
<LocationConstraint>JP-WEST1</LocationConstraint> |
以下は現行のマニュアルです。データストレージ新環境移行後はご利用いただけません。
バケットが配置されているリージョン情報を返します。
このリクエストを実行するユーザは対象バケットの所有者でなければならなりません。
S3ドキュメントではPOST操作との関連性にも言及されていますが、POSTにおいても同様です。
リクエスト情報
シンタックス
GET /{bucket name}?location HTTP/1.1 |
Host: s3api.iot.iij.jp |
Date: {date} |
Authorization: {authorization string} |
リクエストパラメータ
この操作ではリクエストパラメータは使用しません。
リクエストヘッダー
この操作では基本リクエストヘッダーのみ使用します。リクエストエレメント
この操作ではリクエストエレメントは使用しません。
レスポンス情報
レスポンスヘッダー
この操作では基本レスポンスヘッダーのみ返します。
レスポンスエレメント
この操作では以下のレスポンスエレメントを返します。
表. GET Bucket location レスポンスエレメント一覧
| 名前 | 説明 |
|---|---|
| LocationConstraint | バケットが属するリージョン
|
エラー情報
この操作では以下のエラーを返します。
| コード | ステータス | 内容 |
|---|---|---|
| InvalidAccessKeyId | 403 Forbidden | 指定のアクセスキーIDを持つユーザが存在しません。 |
| SignatureDoesNotMatch | 403 Forbidden | 指定されたリクエストのシグネチャが一致しません。 |
| NoSuchBucket | 404 Not Found | 指定のバケットが存在しません。 |
| AccessDenied | 403 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> |