UpdateFolderPermissions - Amazon QuickSight

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 的詳細資訊,請參閱下列說明: