Python管理文件訪問權(quán)限
本文介紹如何管理文件訪問權(quán)限。
背景信息
文件的訪問權(quán)限（ACL）有以下四種：
訪問權(quán)限 | 描述 | 訪問權(quán)限值 |
繼承Bucket | 文件遵循存儲空間的訪問權(quán)限。 | oss2.OBJECT_ACL_DEFAULT |
私有 | 文件的擁有者和授權(quán)用戶有該文件的讀寫權(quán)限，其他用戶沒有權(quán)限操作該文件。 | oss2.OBJECT_ACL_PRIVATE |
公共讀 | 文件的擁有者和授權(quán)用戶有該文件的讀寫權(quán)限，其他用戶只有文件的讀權(quán)限。請謹(jǐn)慎使用該權(quán)限。 | oss2.OBJECT_ACL_PUBLIC_READ |
公共讀寫 | 所有用戶都有該文件的讀寫權(quán)限。請謹(jǐn)慎使用該權(quán)限。 | oss2.OBJECT_ACL_PUBLIC_READ_WRITE |
文件的訪問權(quán)限優(yōu)先級高于存儲空間的訪問權(quán)限。例如存儲空間的訪問權(quán)限是私有，而文件的訪問權(quán)限是公共讀寫，則所有用戶都有該文件的讀寫權(quán)限。如果某個文件沒有設(shè)置過訪問權(quán)限，則遵循存儲空間的訪問權(quán)限。
注意事項
本文以華東1（杭州）外網(wǎng)Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產(chǎn)品訪問OSS，請使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對應(yīng)關(guān)系，請參見訪問域名和數(shù)據(jù)中心。
本文以從環(huán)境變量讀取訪問憑證為例。如何配置訪問憑證，請參見配置訪問憑證。
本文以O(shè)SS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請參見初始化。
要設(shè)置Object訪問權(quán)限，您必須具有
oss:PutObjectAcl權(quán)限；要獲取Object訪問權(quán)限，您必須具有oss:GetObjectAcl權(quán)限。具體操作，請參見為RAM用戶授權(quán)自定義的權(quán)限策略。
設(shè)置文件訪問權(quán)限
以下代碼用于設(shè)置指定Object的訪問權(quán)限：
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫B(tài)ucket所在地域?qū)?yīng)的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
# yourBucketName填寫存儲空間名稱。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'yourBucketName')
# yourObjectName填寫Object完整路徑，完整路徑中不能包含Bucket名稱。
bucket.put_object_acl('yourObjectName', oss2.OBJECT_ACL_PUBLIC_READ)獲取文件訪問權(quán)限
以下代碼用于獲取指定Object的訪問權(quán)限：
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫B(tài)ucket所在地域?qū)?yīng)的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
# yourBucketName填寫存儲空間名稱。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'yourBucketName')
# yourObjectName填寫Object完整路徑，完整路徑中不能包含Bucket名稱。
print(bucket.get_object_acl('yourObjectName').acl)相關(guān)文檔
關(guān)于設(shè)置文件訪問權(quán)限的API接口說明，請參見PutObjectACL。
關(guān)于獲取文件訪問權(quán)限的API接口說明，請參見GetObjectACL。