全部產品
Search
文件中心

Object Storage Service:get-object-acl

更新時間:Sep 13, 2024

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對應的版本。

說明

使用樣本

  • 擷取儲存空間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