UpdateDashboardPermissions

PDF

更新儀表板的讀取和寫入許可。

請求語法

PUT /accounts/AwsAccountId/dashboards/DashboardId/permissions HTTP/1.1
Content-type: application/json

{
   "GrantLinkPermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "GrantPermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "RevokeLinkPermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "RevokePermissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ]
}

URI 請求參數

請求會使用下列 URI 參數。

AwsAccountId

的 IDAWS包含您正在更新其權限的儀表板的帳戶。

長度限制：固定長度為 12。

模式：^[0-9]{12}$

必要：是

DashboardId

儀表板的 ID。

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

必要：是

請求主體

請求接受採用 JSON 格式的下列資料。

GrantLinkPermissions

授與連結許可給已定義的命名空間中的所有使用者。

類型：的陣列ResourcePermission對象

陣列成員：項目數上限為 2。

必要：否

GrantPermissions

您要為此資源授予的許可。

類型：的陣列ResourcePermission對象

陣列成員：項目數上限為 100。

必要：否

RevokeLinkPermissions

撤銷已定義命名空間中所有使用者的連結權限。

類型：的陣列ResourcePermission對象

陣列成員：項目數上限為 2。

必要：否

RevokePermissions

您要從此資源撤銷的許可。

類型：的陣列ResourcePermission對象

陣列成員：項目數上限為 100。

必要：否

回應語法

HTTP/1.1 Status
Content-type: application/json

{
   "DashboardArn": "string",
   "DashboardId": "string",
   "LinkSharingConfiguration": { 
      "Permissions": [ 
         { 
            "Actions": [ "string" ],
            "Principal": "string"
         }
      ]
   },
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "RequestId": "string"
}

回應元素

如果動作成功，則服務傳回下列 HTTP 回應。

Status

請求的 HTTP 狀態。

服務會傳回下列 JSON 格式的資料。

DashboardArn

儀表板的 Amazon Resource Name (ARN)。

類型：字串

DashboardId

儀表板的 ID。

類型：字串

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

LinkSharingConfiguration

更新共享鏈接到亞馬遜的許可 QuickSight 儀表板。

類型：LinkSharingConfiguration 物件

Permissions

儀表板上權限的相關資訊。

類型：的陣列ResourcePermission對象

陣列成員：項目數下限為 1。項目數上限為 64。

RequestId

所以此AWS此操作的請求 ID。

類型：字串

錯誤

如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。

ConflictException

更新或刪除資源可能會導致不一致的狀態。

HTTP 狀態碼：409

InternalFailureException

發生內部故障。

HTTP 狀態碼：500

InvalidParameterValueException

一或多個參數的值無效。

HTTP 狀態碼：400

ResourceNotFoundException

無法找到一個或多個資源。

HTTP 狀態碼：404

ThrottlingException

存取已調節。

HTTP 狀態碼：429

UnsupportedUserEditionException

此錯誤表示您正在呼叫 Amazon QuickSight訂閱版本不包括對該操作的支持。Amazon QuickSight 目前包含 Standard Edition (企業版)。不是每個版本都會提供所有操作和功能。

HTTP 狀態碼：403

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：

• AWS 命令列界面

• 適用於 .NET 的 AWS 開發套件

• 適用於 C++ 的 AWS SDK

• 適用於 Go 的 AWS 開發套件

• 適用於 Java 的 AWS 開發套件第 2 版

• AWS適用於的 SDK JavaScript

• 適用於 PHP V3 的 AWS SDK

• 適用於 Python 的 AWS SDK

• 適用於 Ruby 的 AWS 開發套件第 3 版