Définition d'un thème par défaut pour les analyses Amazon QuickSight avec les API QuickSight

Définir un thème à l'aide de l'API

1. Identifiez le thème personnalisé que vous désirez utiliser par défaut puis localisez son ID de thème. Si vous désirez utiliser l'un des thèmes de démarrage QuickSight, ignorez cette étape.

   Pour obtenir l'ID de thème d'un thème personnalisé, utilisez l'opération d'API ListThemes pour la région dans laquelle se trouve le thème. Assurez-vous que le thème se trouve dans la même région que les utilisateurs ou les groupes devant l'utiliser.

   L'exemple suivant montre un script shell qui utilise la commande list-themes dans l'interface AWS CLI. Cela définit l'ID du compte AWS ainsi que les Région AWS en tant que variables. Si vous avez précédemment utilisé aws configure pour définir une région par défaut, ajouter la variable --region à votre commande remplacera votre paramètre par défaut.

   #declare variables
   awsacct1='111122223333'
   region='us-west-2'
   
   aws quicksight list-themes \
   --region $region \
   --aws-account-id $awsacct1 \
   --type 'CUSTOM'

2. Utilisez l'opération d'API ListUsers ou ListGroups pour collecter les Amazon Resource Names (ARN) pour les utilisateurs ou les groupes devant utiliser le thème par défaut. Seul l'ARN de niveau supérieur est nécessaire. Si tous vos utilisateurs font partie du même groupe, utilisez l'ARN du groupe.

   Pour plus d'informations sur les ARN QuickSight, consultez les formats d'ARN dans la référence d'API Amazon QuickSight (français non garanti).

3. Si vous utilisez un thème personnalisé, accordez l'accès au thème pour les ARN que vous avez collectés à l'étape précédente. Si vous utilisez un thème de démarrage, ignorez cette étape, car tous les utilisateurs ont accès aux thèmes de démarrage.

   L'exemple suivant montre un script shell utilisant la commande update-theme-permissions. Le paramètre grant-permissions s'affiche avec une syntaxe abrégée. Vous pouvez utiliser JSON ou YAML. Pour plus d'informations, consultez Spécification des valeurs de paramètre dans le Guide de l'utilisateur AWS Command Line Interface.

   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639' #Find this with list-themes
   
   aws quicksight update-theme-permissions \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --theme-id $theme-id \
   --grant-permissions Principal="arn:aws:quicksight:$region:$awsacct1:group/$namespace/QuickSight_Group_Name",Actions="quicksight:DescribeTheme","quicksight:ListThemeVersions","quicksight:ListThemeAliases","quicksight:DescribeThemeAlias" 

4. Assignez le thème par défaut pour le ou les mêmes ARN.

   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639'
   
   aws quicksight create-account-customization \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --namespace $namespace \
   --account-customization DefaultTheme="arn:aws:quicksight:$region:$awsacct1:theme/$theme-id"