使用 QuickSight API 为 Amazon QuickSight 分析设置默认主题

使用 API 设置默认主题

1. 确定要用作默认主题的自定义主题，并找到其主题 ID。如果您想使用 QuickSight 入门主题之一，请跳过这一步。

   要获取自定义主题的主题 ID，请使用该主题所在区域的 ListThemes API 操作。确保主题与需要使用该主题的用户或组位于同一区域。

   以下示例显示了 Amazon CLI 中使用 list-themes 命令的 shell 脚本。它将 Amazon 账户 ID 和 Amazon Web Services 区域 设置为变量。如果您之前曾使用 aws configure 设置默认区域，则在命令中添加 --region 变量会覆盖您的默认设置。

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

2. 使用 ListUsers 或 ListGroups API 操作收集需要使用该主题作为默认主题的用户或组的 Amazon 资源名称（ARN）。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

   有关 QuickSight ARN 的更多信息，请参阅《Amazon QuickSight API Reference》 中的 ARN formats。

3. 如果您使用的是自定义主题，请授予您在上一步中收集的 ARN 的主题访问权限。如果您使用的是入门主题，请跳过此步骤，因为所有用户都有权访问入门主题。

   以下示例显示了使用 update-theme-permissions 命令的 shell 脚本。grant-permissions 参数使用速记语法显示。您可以使用 JSON 或 YAML。有关更多信息，请参阅《Amazon 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. 将主题指定为同一 ARN 或多个 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"