全部產品
Search
文件中心

Object Storage Service:put-object-acl

更新時間:Mar 01, 2025

put-object-acl用於設定或修改檔案(Object)的存取權限(ACL)。

注意事項

  • 阿里雲帳號預設擁有設定檔案ACL的許可權。如果您需要通過RAM使用者或者STS的方式進行設定,您必須擁有oss:PutObjectAcl許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。此操作只有Bucket的擁有者有許可權執行,且需對Object有讀寫權限。

  • Object ACL優先順序高於Bucket ACL。例如Bucket ACL是private的,而Object ACL是public-read-write的,則所有使用者都擁有該Object的存取權限,即使該Bucket是私人Bucket。如果某個Object未設定過ACL,則存取權限遵循Bucket ACL。

命令格式

ossutil api put-object-acl --bucket value --key value --object-acl value [flags]

參數

類型

說明

--bucket

string

Bucket名稱。

--key

string

Object的完整路徑。

--object-acl

string

指定OSS建立Object時的存取權限,取值:

  • private:私人。

  • public-read:公用讀取。

  • public-read-write:公用讀寫。

  • default:繼承Bucket。

--version-id

string

Object對應的版本

說明

使用樣本

設定目標儲存空間examplebucket的存取權限為private。

ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private