ニフクラAPI (オブジェクトストレージサービス: GetBucketPolicy)

GetBucketPolicy

処理概要

バケットに設定されたポリシーを表示します。

awscliを使用するとポリシーの表示が簡単にできます。

• 例(east-1リージョン)
  aws --endpoint-url https://jp-east-1.storage.api.nifcloud.com s3api get-bucket-policy --bucket {bucket_name}

• 例(jp-west-2リージョン)
  aws --endpoint-url https://jp-west-2.storage.api.nifcloud.com s3api get-bucket-policy --bucket {bucket_name}

※ awscliなど、OSSのツールにつきましては、サポート範囲外となりますのでご了承ください。

リクエストURL

GET /{Bucket}?policy

指定するパラメーター

ヘッダーパラメーター

パラメーター	型	説明	必須
x-amz-content-sha256	string	ペイロード全体の計算されたSHA256チェックサム	○
x-amz-date	string	リクエスト側で生成した現在日時	○
Authorization	string	リクエスト認証に用いる文字列	○

パスパラメーター

パラメーター	型	説明	必須
Bucket	string	バケット名	○

応答フィールド

レスポンスヘッダー

フィールド (項目)	型	説明
Date	string	トランザクションが実行された日時
Content-Type	string	コンテンツのMIMEタイプ
Content-Length	string	レスポンスボディのバイト数
Connection	string	持続接続の状態を表示します。
x-amz-request-id	string	このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。
x-amz-id-2	string	このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。
x-ntap-sg-trace-id	string	このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。
X-Fcx-Endpoint-Request	string	APIエンドポイントとしてリクエストを受け付けたことを示す番号

レスポンスボディ

フィールド (項目)	型	説明
Id	string	ポリシーで使用する任意の識別子
Statement	list	ポリシーの主要エレメント
␣Sid	string	ポリシードキュメントに与える任意の識別子
␣Effect	string	条件に対して許可(Allow)または拒否(Deny)が表示されます。
␣Principal	string	リソースへのアクセス許可設定
␣NotPrincipal	string	リソースへのアクセス拒否設定
␣Action	string[]	許可するアクションが表示されます。
␣NotAction	string[]	拒否するアクションが表示されます。
␣Resource	string[]	Statementで取り扱う対象のオブジェクトがURNで表示されます。
␣NotResource	string[]	Statementで取り扱わない対象のオブジェクトがURNで表示されます。
␣Condition	string	ポリシーを適用する条件を示す式が表示されます。

リクエストサンプル

    GET /general-bucket?policy HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T023816Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=53dcd21efe5c765ced2a68b6c4ac5cf5ecd0cddee674a9bf9b50cc75eefdcda7

  

応答サンプル

    HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 02:38:16 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
x-amz-request-id: 2368149440
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 1201b7baab515945
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-1.local-28847-754077-1_200

{
  "Statement": [
    {
      "Sid": "TestPolicy",
      "Effect": "Allow",
      "Principal": {
        "SGWS": "urn:sgws:identity::42242073901014718101:user/ABC00000"
      },
      "Action": "s3:*",
      "Resource": "urn:sgws:s3:::general-bucket/*"
    }
  ]
}