如何使用Python SDK V2設定和擷取儲存空間讀寫權限（ACL） - Object Storage Service

儲存空間（Bucket）是儲存物件（Object）的容器，對象都隸屬於儲存空間。本文介紹如何使用Python SDK V2設定和擷取儲存空間的讀寫權限（ACL）。

注意事項

本文範例程式碼以華東1（杭州）的地區IDcn-hangzhou為例，預設使用外網Endpoint，如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。
要設定儲存空間讀寫權限，您必須有oss:PutBucketAcl許可權；要擷取儲存空間讀寫權限，您必須有oss:GetBucketAcl許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

方法定義

設定儲存空間讀寫權限

put_bucket_acl(request: PutBucketAclRequest, **kwargs) → PutBucketAclResult

讀取儲存空間讀寫權限

get_bucket_acl(request: GetBucketAclRequest, **kwargs) → GetBucketAclResult

請求參數列表

參數名	類型	說明
request	PutBucketAclRequest	佈建要求參數，具體請參見PutBucketAclRequest
request	GetBucketAclRequest	佈建要求參數，具體請參見GetBucketAclRequest

傳回值列表

類型	說明
GetBucketAclResult	傳回值，具體請參見GetBucketAclResult
PutBucketAclResult	傳回值，具體請參見PutBucketAclResult

關於設定儲存空間讀寫權限方法的完整定義，請參見put_bucket_acl。

關於擷取儲存空間讀寫權限方法的完整定義，請參見get_bucket_acl。

儲存空間的讀寫權限類型

儲存空間的讀寫權限（ACL）有以下三類：

讀寫權限	描述	許可權值
私人	儲存空間的擁有者和授權使用者有檔案的讀寫權限，其他使用者沒有許可權操作檔案。	private
公用讀取	儲存空間的擁有者和授權使用者有檔案的讀寫權限，其他使用者只有讀許可權。請謹慎使用該許可權。	public-read
公用讀寫	所有使用者都有檔案的讀寫權限。請謹慎使用該許可權。	public-read-write

範例程式碼

您可以使用以下代碼設定並擷取儲存空間的讀寫權限。

import argparse
import alibabacloud_oss_v2 as oss

# 建立一個命令列參數解析器，並添加描述資訊
parser = argparse.ArgumentParser(description="put bucket acl sample")
# 添加必需的命令列參數：region（地區）、bucket（儲存空間名稱）和acl（存取控制清單）
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
# 添加可選的命令列參數：endpoint，用於指定其他服務訪問OSS時使用的網域名稱
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
# 添加必需的命令列參數：acl（存取控制清單），用於指定儲存空間的存取權限，例如 private、public-read、public-read-write
parser.add_argument('--acl', help='Specify the access permission ACL for the bucket.', required=True)

def main():
    # 解析命令列參數
    args = parser.parse_args()

    # 從環境變數中載入認證資訊
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # 使用SDK預設配置
    cfg = oss.config.load_default()
    # 設定認證提供者
    cfg.credentials_provider = credentials_provider
    # 設定地區
    cfg.region = args.region
    # 如果提供了endpoint，則更新endpoint到配置中
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 建立OSS用戶端
    client = oss.Client(cfg)

    # 調用put_bucket_acl方法設定儲存空間的ACL
    result = client.put_bucket_acl(oss.PutBucketAclRequest(
        bucket=args.bucket,
        acl=args.acl,
    ))

    # 列印請求的狀態代碼和請求ID
    print(f'status code: {result.status_code}, request id: {result.request_id}')

    # 擷取指定儲存空間的ACL（存取控制清單）
    result = client.get_bucket_acl(oss.GetBucketAclRequest(
        bucket=args.bucket,
    ))

    # 列印結果中的狀態代碼、請求ID和ACL資訊
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' acl: {result.acl},'
    )

if __name__ == "__main__":
    main()

Object Storage Service：管理儲存空間的讀寫權限（Python SDK V2）