Configuración de un tema predeterminado para los análisis de Amazon QuickSight con las API de QuickSight

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 desea utilizar uno de los temas de inicio de QuickSight, omita este paso.

   Para obtener el ID de tema de un tema personalizado, utilice la operación de la API ListThemes para 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 cuenta de AWS y la Región de AWS como variables. 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'

2. Utilice la operación de API ListUsers o ListGroups para recopilar los nombres de recursos de Amazon (ARN) de 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 de QuickSight, consulte los formatos de ARN en la referencia de la API de Amazon QuickSight.

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

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