Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Impostazione di un tema predefinito per le analisi di Amazon Quick con Amazon Quick APIs
<a name="customizing-quicksight-default-theme"></a>

**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 QuickSight iniziali, salta questo passaggio. 

   Per ottenere l'ID del tema personalizzato, utilizza l'operazione [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html)API 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 AWS dell'account e le variabili Regione AWS as. 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'
   ```

   

1. Utilizza l'operazione [ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html)o [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html)API per raccogliere Amazon Resource Names (ARNs) 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 su Amazon Quick ARNs, consulta i [formati ARN](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) nel *Quick API* Reference. 

1. Se utilizzi un tema personalizzato, concedi l'accesso al tema ARNs che hai raccolto 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 che utilizza il [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html)comando Il `grant-permissions` parametro viene mostrato utilizzando una sintassi abbreviata. È possibile usare invece JSON o YAML. Per ulteriori informazioni, consulta [Specifica dei valori dei parametri](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html) 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"
   ```

1. Assegna il tema come predefinito per lo stesso ARNs ARN o.

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

Attualmente, sono disponibili tre temi iniziali: Classic, Midnight e Seaside. ARNs Si tratta dell'ortografia in maiuscolo del nome del tema. Se utilizzi un tema iniziale anziché un tema personalizzato, utilizza uno dei seguenti temi: ARNs
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`