putbucketpolicy 操作とは - Object Storage Service - Alibaba Cloud ドキュメントセンター

PutBucketPolicy 操作を呼び出して、指定されたバケットまたはベクターバケットに権限付与ポリシーを設定できます。

権限

Alibaba Cloud アカウントは、デフォルトですべての権限を持っています。対照的に、Resource Access Management (RAM) ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して、RAM ユーザーまたは RAM ロールに権限を付与する必要があります。

API	アクション	説明
PutBucketPolicy	oss:PutBucketPolicy	指定されたバケットの権限付与ポリシーを設定します。

リクエスト構文

PUT /?policy
Host: Host
Date: GMT Date
Authorization: SignatureValue
Policy written in JSON

リクエストヘッダー

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

レスポンスヘッダー

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

例

バケットの例

リクエストサンプル

PUT /?policy
Content-Length: 230
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 12:51:09 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
{
   "Version":"1",
   "Statement":[
   {
     "Action":[
       "oss:PutObject",
       "oss:GetObject"
    ],
    "Effect":"Deny",
    "Principal":["1234567890"],
    "Resource":["acs:oss:*:1234567890:*/*"]
   }
  ]
}

レスポンスの例

HTTP/1.1 200 OK
content-length: 0
server: AliyunOSS
x-oss-server-time: 87
connection: keep-alive
x-oss-request-id: 5C6E9EBD5CC26B28EE41****
date: Thu, 21 Feb 2019 12:51:09 GMT

ベクターバケットの例

ベクターバケットの場合、Host の region パラメーターは、汎用バケットで使用される oss-cn-hangzhou などの従来の OSS リージョンではなく、cn-hangzhou などの標準の Alibaba Cloud リージョン ID を使用します。

リクエストサンプル

PUT /?policy
Content-Length: 230
Host: exampebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 12:51:09 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
{
   "Version":"1",
   "Statement":[
       {
         "Action":[
           "oss:PutVectors",
           "oss:GetVectors"
        ],
        "Effect":"Deny",
        "Principal":["1234567890"],
        "Resource":["acs:ossvector:cn-hangzhou:1234567890:bucket/vector-example/*"]
       }
    ]
 }

レスポンスの例

HTTP/1.1 200 OK
content-length: 0
server: AliyunOSS
x-oss-server-time: 87
connection: keep-alive
x-oss-request-id: 5C6E9EBD5CC26B28EE41****
date: Thu, 21 Feb 2019 12:51:09 GMT

SDK

この操作は、次のプログラミング言語の SDK を使用して呼び出すことができます。

ossutil コマンドラインツール

対応する ossutil コマンドの詳細については、「put-bucket-policy」をご参照ください。