Permettre à tous les utilisateurs de votre QuickSight compte Amazon d'accéder à un tableau de bord avec l' QuickSight API

Public cible : QuickSight développeurs Amazon

Vous pouvez également autoriser tous les utilisateurs de votre compte à accéder au tableau de bord à l'aide de l'QuickSight API en utilisant l'UpdateDashboardPermissionsopération.

L'exemple de demande d'API suivant illustre comment procéder à l'aide d'une AWS CLI commande. Il accorde des autorisations de lien sur le tableau de bord de votre compte et permet les opérations suivantes : DescribeDashboard QueryDashboard et 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"

La réponse à la demande précédente ressemble à ce qui suit.

{
		"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"
	}

Vous pouvez également empêcher tous les utilisateurs de votre compte d'accéder au tableau de bord à l'aide de la même opération d'API. L'exemple de demande suivant illustre comment faire cela en utilisant une commande de l'interface de la ligne de commande.

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"

Pour plus d'informations, consultez UpdateDashboardPermissionsle Amazon QuickSight API Reference.

Lorsque tous les utilisateurs QuickSight d'un compte utilisateur ont accès au tableau de bord, l'extrait suivant est ajouté au AWS CloudTrail journal dans le cadre du eventNameUpdateDashboardAccess, et du. eventCategory Management

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