すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetBucketPolicy

最終更新日:Nov 09, 2025

GetBucketPolicy は、指定されたバケットまたはベクターバケットのアクセスポリシーを取得します。

リクエスト構文

GET /?policy
Host: Host
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

DescribeRegions リクエストへのレスポンス内のすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。

バケットの例

  • リクエスト例

    GET /?policy
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 09:09:13 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • レスポンス例

    HTTP/1.1 200 OK
    server: AliyunOSS
    x-oss-server-time: 24
    connection: keep-alive
    x-oss-request-id: 5C6E9847BE0EBCD13DA90C11
    date: Thu, 21 Feb 2019 12:23:35 GMT
    content-type: application/json
    {
      "Version":"1",
      "Statement":[
        {
          "Action":[
            "oss:PutObject",
            "oss:GetObject"
          ],
          "Effect":"Deny",
          "Principal":["1234567890"],
          "Resource":["acs:oss:*:1234567890:*/*"]
        }
      ]
    }

ベクターバケットの例

ベクターバケットの Host 内のリージョンは、汎用バケットで使用される oss-cn-hangzhou などの従来の OSS リージョン ID ではなく、cn-hangzhou などの標準の Alibaba Cloud リージョン ID で指定されます。
  • リクエスト例

    GET /?policy
    Host: exampebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
    Date: Thu, 17 Apr 2025 09:09:13 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • レスポンス例

    HTTP/1.1 200 OK
    server: AliyunOSS
    x-oss-server-time: 24
    connection: keep-alive
    x-oss-request-id: 5C6E9847BE0EBCD13DA90C11
    date: Thu, 21 Feb 2019 12:23:35 GMT
    content-type: application/json
    {
       "Version":"1",
       "Statement":[
       {
         "Action":[
           "oss:PutVectors",
           "oss:GetVectors"
        ],
        "Effect":"Deny",
        "Principal":["1234567890"],
        "Resource":["acs:ossvector:cn-hangzhou:1234567890:bucket/vector-example/*"]
       }
      ]
    }

SDK

この API で使用できる SDK は次のとおりです。

ossutil コマンドラインツール

GetBucketPolicy 操作に対応する ossutil コマンドについては、「get-bucket-policy」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

NoSuchBucketPolicy

404

リクエストされたバケットにポリシーが設定されていません。