Impostazione di un tema predefinito per l'analisi di Amazon QuickSight con l'API QuickSight

Impostazione di un tema predefinito utilizzando l'API

1. Identifica il tema personalizzato che desideri utilizzare come predefinito e individua il relativo ID. Se desideri utilizzare uno dei temi di avvio di QuickSight, ignora questo passaggio.

   Per ottenere l'ID del tema personalizzato, utilizza l'operazione API ListThemes per la Regione in cui si trova il tema. Assicurati che il tema si trovi nella stessa Regione degli utenti o dei gruppi che devono utilizzarlo.

   L'esempio seguente mostra uno script di shell (interprete di comandi) che utilizza il comando list-themes nella AWS CLI. Imposta l'ID account AWS e la Regione AWS come variabili. Se in precedenza hai utilizzato aws configure per impostare una regione predefinita, l'aggiunta della variabile --region al comando sostituisce l'impostazione predefinita.

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

2. Utilizza l'operazione API ListUsers o ListGroups per raccogliere i nomi della risorsa Amazon (ARN) per utenti o gruppi che devono utilizzare il tema come predefinito. È necessario solo l'ARN di livello superiore. Se tutti i tuoi utenti fanno parte dello stesso gruppo, usa l'ARN del gruppo.

   Per ulteriori informazioni sugli ARN QuickSight, consulta Formati degli ARN nella Documentazione di riferimento delle API di Amazon QuickSight.

3. Se utilizzi un tema personalizzato, concedi l'accesso al tema per gli ARN raccolti nel passaggio precedente. Se utilizzi un tema iniziale, salta questo passaggio perché tutti gli utenti hanno accesso ai temi iniziali.

   L'esempio seguente mostra uno script di shell (interprete dei comandi) che utilizza il comando update-theme-permissions. Il parametro grant-permissions viene mostrato con una sintassi abbreviata. È possibile usare invece JSON o YAML. Per ulteriori informazioni, consulta Specifica dei valori dei parametri nella Guida per l'utente di 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. Assegna il tema come predefinito per lo stesso ARN o gli stessi 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"