注意事項

• 在配置Bucket Policy之前，請確保您已了解該功能。詳情請參見Bucket Policy。

• 本文以華東1（杭州）外網(wǎng)Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產(chǎn)品訪問OSS，請使用內(nèi)網(wǎng)Endpoint。關于OSS支持的Region與Endpoint的對應關系，請參見訪問域名和數(shù)據(jù)中心。

• 本文以從環(huán)境變量讀取訪問憑證為例。如何配置訪問憑證，請參見配置訪問憑證。

• 本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請參見初始化。

• 要設置Bucket Policy，您必須有oss:PutBucketPolicy權限；要獲取Bucket Policy，您必須有oss:GetBucketPolicy權限；要刪除Bucket Policy，您必須有oss:DeleteBucketPolicy權限。具體操作，請參見為RAM用戶授權自定義的權限策略。

設置Bucket Policy

以下代碼用于設置Bucket Policy：

# -*- coding: utf-8 -*-

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import json

# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
# yourBucketName填寫B(tài)ucket名稱。
bucket = oss2.Bucket(auth, 'http://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# 以下示例用于資源擁有者（即UID為174649585760xxxx的Bucket Owner）通過Bucket Policy授權指定用戶（UID為20214760404935xxxx的RAM用戶）擁有列舉examplebucket下所有文件的權限。
policy_text = '{"Statement": [{"Effect": "Allow", "Action": ["oss:GetObject", "oss:ListObjects"], "Principal": ["20214760404935xxxx"], "Resource": ["acs:oss:*:174649585760xxxx:examplebucket/*"]}], "Version": "1"}'

# 上傳授權策略。
bucket.put_bucket_policy(policy_text)

獲取Bucket Policy

以下代碼用于獲取Bucket Policy信息：

# -*- coding: utf-8 -*-

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import json
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
# yourBucketName填寫B(tài)ucket名稱。
bucket = oss2.Bucket(auth, 'http://oss-cn-hangzhou.aliyuncs.com', 'yourBucketName')

# 獲取Bucket Policy配置信息。
result = bucket.get_bucket_policy()
policy_json = json.loads(result.policy) 
print("Get policy text: ", policy_json)

刪除Bucket Policy

以下代碼用于刪除Bucket Policy：

# -*- coding: utf-8 -*-

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
# yourBucketName填寫B(tài)ucket名稱。
bucket = oss2.Bucket(auth, 'http://oss-cn-hangzhou.aliyuncs.com', 'yourBucketName')

# 刪除Bucket Policy。
result = bucket.delete_bucket_policy()
assert int(result.status)//100 == 2

相關文檔

• 關于Bucket Policy的完整示例代碼，請參見GitHub示例。

• 關于設置Bucket Policy的API接口說明，請參見PutBucketPolicy。

• 關于獲取Bucket Policy的API接口說明，請參見GetBucketPolicy。

• 關于刪除Bucket Policyy的API接口說明，請參見DeleteBucketPolicy。