GetBucketPolicy用於擷取指定儲存空間（Bucket）或向量儲存空間（Vector Bucket）的權限原則（Policy）。
請求文法
GET /?policy
Host: Host
Date: GMT Date
Authorization: SignatureValue要求標頭
此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。
回應標頭
此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。
樣本
Bucket樣本
請求樣本
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:*/*"] } ] }
向量Bucket樣本
向量 Bucket 的Host中的地區參數使用阿里雲標準地區 ID（如 cn-hangzhou），而非用於通用 Bucket 的舊版 OSS 地區（如 oss-cn-hangzhou）
請求樣本
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
此介面所對應的各語言SDK如下：
命令列工具ossutil
GetBucketPolicy介面所對應的ossutil命令，請參見get-bucket-policy。
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
NoSuchBucketPolicy | 404 | 請求的Bucket沒有配置權限原則（Policy）。 |