Definição de um tema padrão para análises do Amazon QuickSight com as APIs do QuickSight

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 deseja usar um dos temas iniciais do QuickSight, ignore esta etapa.

   Para obter o ID do tema de um tema personalizado, use a operação de API ListThemes 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 conta da AWS e a Região da AWS como variáveis. 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'

2. Use a operação de API ListUsers ou ListGroups para coletar os nomes do recurso da Amazon (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 os ARNs do QuickSight, consulte ARN formats na referência de APIs do Amazon QuickSight.

3. 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. 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 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" 

4. 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