Einstellung eines Standardthemas für QuickSight Amazon-Analysen mit dem QuickSight APIs

Um ein Standarddesign festzulegen, verwenden Sie den API

1. Identifizieren Sie das benutzerdefinierte Theme, das Sie als Standard verwenden möchten, und suchen Sie nach seiner Theme-ID. Wenn Sie eines der QuickSight Starter-Themes verwenden möchten, überspringen Sie diesen Schritt.

   Um die Theme-ID eines benutzerdefinierten Themes abzurufen, verwenden Sie den ListThemesAPIVorgang für die Region, in der sich das Theme befindet. Stellen Sie sicher, dass sich das Theme in derselben Region befindet wie die Benutzer oder Gruppen, die es verwenden müssen.

   Das folgende Beispiel zeigt ein Shell-Skript, das den list-themes-Befehl in der AWS CLI verwendet. Es legt die AWS Konto-ID und die AWS-Region AS-Variablen fest. Wenn Sie zuvor aws configure verwendet haben, um eine Standardregion festzulegen, setzt das Hinzufügen der Variable --region zu Ihrem Befehl Ihre Standardeinstellung außer Kraft.

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

2. Verwenden Sie die ListGroupsAPIOperation ListUsersoder, um die Amazon-Ressourcennamen (ARNs) für Benutzer oder Gruppen zu sammeln, die das Thema als Standard verwenden müssen. Sie benötigen nur die oberste Ebene. ARN Wenn alle Ihre Benutzer derselben Gruppe angehören, verwenden Sie die GruppeARN.

   Weitere Informationen zu finden Sie QuickSight ARNs unter ARNFormate in der QuickSight APIAmazon-Referenz.

3. Wenn Sie ein benutzerdefiniertes Design verwenden, gewähren Sie Zugriff auf das ThemeARNs, das Sie im vorherigen Schritt gesammelt haben. Wenn Sie ein Starter-Theme verwenden, überspringen Sie diesen Schritt, da alle Benutzer Zugriff auf Starter-Themes haben.

   Das folgende Beispiel zeigt ein Shell-Skript, das den update-theme-permissionsBefehl verwendet. Der grant-permissions Parameter wird in Kurzsyntax angezeigt. Sie können stattdessen JSON oder YAML verwenden. Weitere Informationen finden Sie unter Festlegen von Parameterwerten im AWS Command Line Interface -Benutzerleitfaden.

   #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. Weisen Sie das Thema als Standard für dasselbe ARN oder zuARNs.

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