As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Definindo um tema padrão para análises do Amazon Quick com as APIs do Amazon Quick
<a name="customizing-quicksight-default-theme"></a>

**Para definir um tema padrão usando a API**

1. Identifique o tema personalizado que você deseja usar como padrão e localize o ID do tema. Se você quiser usar um dos temas QuickSight iniciais, pule esta etapa. 

   Para obter o ID do tema de um tema personalizado, use a operação de [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html)API para a região em que o tema está. Certifique-se de que o tema esteja na mesma região dos usuários ou grupos que precisam usá-lo.

   O exemplo a seguir mostra um script de shell que usa o comando `list-themes` no AWS CLI. Ele define o ID da AWS conta e Região da AWS as variáveis as. Se você usou `aws configure` anteriormente para definir uma região padrão, adicionar a variável `--region` ao comando substitui a configuração padrão.

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

   

1. Use a operação [ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html)ou [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html)API para coletar os Amazon Resource Names (ARNs) para usuários ou grupos que precisam usar o tema como padrão. Você precisa apenas do ARN de nível superior. Se todos os seus usuários fizerem parte do mesmo grupo, use o ARN do grupo. 

   Para obter mais informações sobre Amazon Quick ARNs, consulte Formatos de [ARN](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) na *Quick API Reference*. 

1. Se você estiver usando um tema personalizado, conceda acesso ele para os ARNs coletados na etapa anterior. Se estiver usando um tema inicial, pule esta etapa, pois todos os usuários têm acesso aos temas iniciais. 

   O exemplo a seguir mostra um script de shell que usa o comando [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html). O parâmetro `grant-permissions` é mostrado usando uma sintaxe abreviada. Você pode usar JSON ou YAML. Para obter mais informações, consulte [Especificar valores de parâmetro](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html) no *Guia do usuário da 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. Atribua o tema como padrão para o mesmo ARN ou ARNs.

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

Atualmente, existem três temas iniciais: Classic, Midnight e Seaside. Os ARNs deles são a grafia maiúscula do nome do tema. Se você estiver usando um tema inicial em vez de um personalizado, use um dos seguintes ARNs 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`