Définition d'un thème par défaut pour les QuickSight analyses Amazon à l'aide du QuickSight APIs

Pour définir un thème par défaut à l'aide du API

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

   Pour obtenir l'ID de thème d'un thème personnalisé, utilisez l'ListThemesAPIopération correspondant à 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. Il définit l'ID du AWS compte et les variables Région AWS as. 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'ListGroupsAPIopération ListUsersou pour collecter les Amazon Resource Names (ARNs) pour les utilisateurs ou les groupes qui doivent utiliser le thème par défaut. Vous n'avez besoin que du plus haut niveau. ARN Si tous vos utilisateurs font partie du même groupe, utilisez-leARN.

   Pour plus d'informations sur les ARNformats QuickSight ARNs, consultez la section Amazon QuickSight API Reference.

3. Si vous utilisez un thème personnalisé, accordez l'accès au thème pour celui ARNs que vous avez collecté à 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 qui utilise la update-theme-permissionscommande Le grant-permissions paramètre est affiché à l'aide d'une syntaxe abrégée. Vous pouvez utiliser JSON ou YAML remplacer. 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 même ARN ouARNs.

   #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"