本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
UpdateFolderPermissions
更新資料夾的權限。
請求語法
PUT /accounts/AwsAccountId/folders/FolderId/permissions HTTP/1.1
Content-type: application/json
{
   "GrantPermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "RevokePermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ]
}URI 請求參數
請求會使用下列 URI 參數。
- AwsAccountId
- 
               的 ID:AWS包含要更新的資料夾的帳戶。 長度限制:固定長度為 12。 模式: ^[0-9]{12}$必要:是 
- FolderId
- 
               資料夾的識別碼。 長度限制:長度下限為 1。長度上限為 2048。 模式: [\w\-]+必要:是 
請求主體
請求接受採用 JSON 格式的下列資料。
- GrantPermissions
- 
               您要為資源授予的許可。 類型:的陣列ResourcePermission對象 陣列成員:項目數下限為 1。項目數上限為 64。 必要:否 
- RevokePermissions
- 
               您要從資源撤銷的許可。 類型:的陣列ResourcePermission對象 陣列成員:項目數下限為 1。項目數上限為 64。 必要:否 
回應語法
HTTP/1.1 200
Content-type: application/json
{
   "Arn": "string",
   "FolderId": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "RequestId": "string",
   "Status": number
}回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Arn
- 
               資料夾的 Amazon Resource Name (ARN)。 類型:字串 
- FolderId
- 
               資料夾的識別碼。 類型:字串 長度限制:長度下限為 1。長度上限為 2048。 模式: [\w\-]+
- Permissions
- 
               資料夾權限的相關資訊。 類型:的陣列ResourcePermission對象 陣列成員:項目數下限為 1。項目數上限為 64。 
- RequestId
- 
               所以此AWS此操作的請求 ID。 類型:字串 
- Status
- 
               請求的 HTTP 狀態。 類型:整數 
錯誤
如需所有動作常見的錯誤相關資訊,請參閱常見錯誤。
- AccessDeniedException
- 
               您無法存取。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶已獲授權使用亞馬遜 QuickSight 服務,您的政策有正確許可,以及您使用正確的存取金鑰。 HTTP 狀態碼:401 
- InternalFailureException
- 
               發生內部故障。 HTTP 狀態碼:500 
- InvalidParameterValueException
- 
               一或多個參數的值無效。 HTTP 狀態碼:400 
- LimitExceededException
- 
               已超過上限。 HTTP 狀態碼:409 
- ResourceNotFoundException
- 
               無法找到一個或多個資源。 HTTP 狀態碼:404 
- ThrottlingException
- 
               存取已調節。 HTTP 狀態碼:429 
- UnsupportedUserEditionException
- 
               此錯誤表示您正在呼叫 Amazon QuickSight訂閱版本不包括對該操作的支持。Amazon QuickSight 目前包含 Standard Edition (企業版)。不是每個版本都會提供所有操作和功能。 HTTP 狀態碼:403 
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: