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時的存取權限,取值:
|
--version-id | string | Object對應的版本 |
說明
put-object-acl命令對應API介面PutObjectACL。關於API中的具體參數含義,請參見PutObjectACL。
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
設定目標儲存空間examplebucket的存取權限為private。
ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private