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 | リクエストされたバケットにポリシーが設定されていません。 |