get-object-acl用於擷取儲存空間(Bucket)下某個檔案(Object)的存取權限(ACL)。
注意事項
阿里雲帳號預設擁有擷取檔案ACL的許可權。如果您需要通過RAM使用者或者STS的方式擷取,您必須擁有
oss:GetObjectAcl許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。如果一個Object從未設定過ACL,則調用GetObjectACL時,返回的ObjectACL為default,表示該Object的ACL遵循Bucket ACL。即如果Bucket的存取權限是private,則該Object的存取權限也是private。
命令格式
ossutil api get-object-acl --bucket value --key value [flags]參數 | 類型 | 說明 |
--bucket | string | Bucket名稱。 |
--key | string | Object的完整路徑。 |
--version-id | string | Object對應的版本。 |
說明
get-object-acl命令對應API介面GetObjectACL。關於API中的具體參數含義,請參見GetObjectACL。
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
擷取儲存空間
examplebucket的存取權限。ossutil api get-object-acl --bucket examplebucket --key exampleobject擷取儲存空間
examplebucket的存取權限,以JSON格式顯示。ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format json擷取儲存空間
examplebucket的存取權限,以YAML格式顯示。ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format yaml