

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Establecer un tema predeterminado para los análisis rápidos de Amazon con las API de Amazon Quick
<a name="customizing-quicksight-default-theme"></a>

**Establecimiento de un tema predeterminado mediante la API**

1. Identifique el tema personalizado que quiere usar como predeterminado y localice su ID de tema. Si quieres usar uno de los temas de QuickSight inicio, omite este paso. 

   Para obtener el ID de tema de un tema personalizado, usa la operación de [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html)API de la región en la que se encuentra el tema. Asegúrese de que el tema esté en la misma región que los usuarios o grupos que lo tienen que usar.

   En el siguiente ejemplo, se muestra un script de intérprete de comandos que usa el comando `list-themes` de la AWS CLI. Establece el ID de la AWS cuenta y las variables Región de AWS as. Si anteriormente usaba `aws configure` para establecer una región predeterminada, añadir la variable `--region` al comando anulará la configuración predeterminada.

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

   

1. Utilice la operación [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 para recopilar los nombres de recursos de Amazon (ARN) para los usuarios o grupos que necesiten usar el tema de forma predeterminada. Solo necesita el ARN de nivel superior. Si todos los usuarios forman parte del mismo grupo, utilice el ARN del grupo. 

   Para obtener más información sobre los ARN rápidos de Amazon, consulte los formatos de [ARN](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) en *la Referencia rápida de API*. 

1. Si utiliza un tema personalizado, conceda acceso al tema para los ARN que recopiló en el paso anterior. Si utiliza un tema de inicio, omita este paso, porque todos los usuarios tienen acceso a los temas de inicio. 

   En el siguiente ejemplo, se muestra un script del intérprete de comandos que utiliza el comando [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html). El parámetro `grant-permissions` se muestra con una sintaxis abreviada. Puede utilizar JSON o YAML en su lugar. Para obtener más información, consulte [Especificación de valores de parámetros](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html) en la *Guía del usuario de 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. Asigne el tema como predeterminado para el mismo ARN o los mismos 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}}"
   ```

Actualmente, hay tres temas iniciales: Classic, Midnight y Seaside. Sus ARN son el mismo nombre del tema en mayúsculas. Si utiliza un tema de inicio en lugar de un tema personalizado, utilice uno de los siguientes ARN de tema:
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`