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

# 使用 Amazon Quick 为 Amazon Quick 分析设置默认主题 APIs
<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 资源名称 (ARNs)。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

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

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

   以下示例显示了使用[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 的默认主题或。 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"
   ```

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