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

使用 API 设置默认主题

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

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

   以下示例显示了 AWS CLI中使用 list-themes 命令的 shell 脚本。它设置 AWS 账户 ID 和 a AWS 区域 s 变量。如果您之前曾使用 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或 ListGroupsAPI 操作收集需要使用默认主题的用户或群组的 Amazon 资源名称 (ARNs)。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

   有关更多信息 QuickSight ARNs，请参阅《亚马逊 QuickSight API 参考》中的 ARN 格式。

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

   以下示例显示了使用update-theme-permissions命令的 shell 脚本。grant-permissions参数使用速记语法显示。您可以使用 JSON 或 YAML。有关更多信息，请参阅《AWS Command Line Interface 版本 2 的用户指南》中的指定参数值。

   #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 的默认主题或。 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"