本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon Quick API 为 Amazon Quick 分析设置默认主题
<a name="customizing-quicksight-default-theme"></a>

**使用 API 设置默认主题**

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

   要获取自定义主题的主题 ID，请使用该主题所在区域的 [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html)API 操作。确保主题与需要使用该主题的用户或组位于同一区域。

   以下示例显示了 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'
   ```

   

1. 使用[ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html)或 [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html)API 操作收集需要使用默认主题的用户或群组的 Amazon 资源名称 (ARN)。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

   有关 Amazon Quick AR [N 的更多信息，请参阅快*速 API 参考中的* ARN](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) 格式。

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

   以下示例显示了使用 [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html) 命令的 shell 脚本。`grant-permissions` 参数使用速记语法显示。您可以使用 JSON 或 YAML。有关更多信息，请参阅《AWS Command Line Interface 用户指南》**中的[指定参数值](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html)。

   ```
   #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. 将主题指定为同一 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}}"
   ```

目前，有三个入门主题：Classic、Midnight 和 Seaside。它们的 ARN 是其主题名称的大写拼写。如果您使用的是入门主题而不是自定义主题，请使用以下主题 ARN 之一：
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`