を使用して、Amazon QuickSight アカウントの全員にダッシュボードへのアクセス権を付与する QuickSight API

対象者: Amazon QuickSight デベロッパー

または、 UpdateDashboardPermissionsオペレーションQuickSight APIを使用して、アカウント内のすべてのユーザーに ダッシュボードへのアクセスを許可することもできます。

次のAPIリクエスト例は、 AWS CLI コマンドを使用してリクエストを実行する方法を示しています。これは、アカウント内のダッシュボードに対するリンク許可を付与し、DescribeDashboard、QueryDashboard、および ListDashboard オペレーションを許可します。

aws quicksight update-dashboard-permissions 
	--aws-account-id account-id 
	--region aws-directory-region
	--dashboard-id dashboard-id
	--grant-link-permissions 
	Principal="arn:aws:quicksight:aws-directory-region:account-id:namespace/default",
	Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
	quicksight:ListDashboardVersions"

上記のリクエストに対するレスポンスは、以下のようになります。

{
		"Status": 200,
		"DashboardArn": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:dashboard/
		DASHBOARDID",
		"DashboardId": "DASHBOARDID",
		"LinkSharingConfiguration": {
			"Permissions": [
				{
					"Actions": [
						"quicksight:DescribeDashboard",
						"quicksight:ListDashboardVersions",
						"quicksight:QueryDashboard"
					],
					"Principal": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:namespace/default"
				}
			]
		},
		"Permissions": [
			// other dashboard permissions here
		],
		"RequestId": "REQUESTID"
	}

また、アカウント内のすべてのユーザーが同じAPIオペレーションを使用してダッシュボードにアクセスできないようにすることもできます。次のリクエスト例は、 CLI コマンドを使用して を使用する方法を示しています。

aws quicksight update-dashboard-permissions 
	--aws-account-id account-id 
	--region aws-directory-region
	--dashboard-id dashboard-id
	--revoke-link-permissions 
	Principal="arn:aws:quicksight:aws-directory-region:account-id:namespace/default",
	Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
	quicksight:ListDashboardVersions"

詳細については、「Amazon QuickSight API リファレンスUpdateDashboardPermissions」の「」を参照してください。

QuickSight ユーザーアカウントのすべてのユーザーにダッシュボードへのアクセスが付与されると、 eventNameUpdateDashboardAccessおよび の一部として AWS CloudTrail ログに次のスニペットが追加されますeventCategoryManagement。

"linkPermissionPolicies": 
	[
		{
			"principal": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:
							namespace/default",
			"actions": 
			[
				"quicksight:DescribeDashboard",
				"quicksight:ListDashboardVersions",
				"quicksight:QueryDashboard"
			]
		}
	]