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

# Amazon Quick 品牌定制
<a name="brand-customization"></a>

Amazon Quick 允许账户管理员自定义其应用程序的品牌和视觉主题，使其符合其组织的指导方针。此自定义包括以下视觉元素，用于在所有非管理的 Amazon Quick 控制台页面、日程安排、提醒和电子邮件报告中创建统一的外观。
+ Logo
+ 网页图标
+ 视觉资产的关联替代文本

以下列表显示了可自定义主题颜色所分组的不同区域。

**品牌颜色**
+ **全局导航栏**的颜色应用于 Amazon Quick 用户界面中最顶部的栏，包括标准和嵌入式 Amazon Quick 控制台中显示的公司徽标。
+ **应用程序栏**颜色应用于包含上下文操作的辅助导航栏。

**交互颜色**
+ **强调**颜色应用于按钮、边框和图标等交互元素。

**表面颜色**
+ **原色**应用于高强度表面，例如主页背景和文本。
+ **间色**应用于实际表面，例如边框、背景和表单域。间色与原色一起使用。

**状态颜色**
+ **成功**颜色应用于成功消息。
+ **危险**颜色应用于错误消息。
+ **警告**颜色应用于警告消息。
+ **信息**颜色应用于信息性消息。

**数据可视化颜色**
+ **维度**颜色用于标识具有相同角色的数据列之间的关联。
+ **度量**颜色用于标识指标或测量值。

**功能**
+ **可视化**颜色应用于**可视化**图标。
+ “**洞察**” 颜色应用于 “**洞察**” 图标。
+ **连接**颜色应用于 “**连接**” 图标。
+ **自动化**颜色应用于 “**自动化**” 图标。

使用以下章节开始在 Amazon Quick 中进行品牌定制。

**Topics**
+ [

## Amazon Quick 品牌定制权限
](#brand-customization-permissions)
+ [

## 在 Amazon Quick 中创建自定义品牌
](#brand-customization-create)
+ [

# 使用 Amazon Quick 为 Amazon Quick 分析设置默认主题 APIs
](customizing-quicksight-default-theme.md)

## Amazon Quick 品牌定制权限
<a name="brand-customization-permissions"></a>

要设置品牌，必须通过 IAM Identity Center 或 IAM 向您授予管理员角色。在 Amazon Quick 中被授予角色的管理员无法创建品牌。要详细了解如何将您的账户与 IAM 身份中心集成，请参阅使用 IAM [身份中心配置您的 Amazon Quick 账户](https://docs.amazonaws.cn/quicksight/latest/user/sec-identity-management-identity-center.html)。有关管理员角色和权能的信息，请参阅[了解 Amazon Quick 订阅和角色](https://docs.amazonaws.cn/quicksight/latest/user/user-types.html#subscription-role-mapping)。

管理员用户只能管理与其 Amazon Quick 账户位于相同容量区域的品牌。

您用于在 Amazon Quick 中创建品牌的 IAM 角色必须包含`quicksight:*`或精细的操作权限，才能在管理员控制台中管理品牌。管理员需要以下精细权限才能使用 Amazon Quick 品牌：
+ `quicksight:CreateBrand`
+ `quicksight:UpdateBrand`
+ `quicksight:DescribeBrand`
+ `quicksight:DescribeBrandPublishedVersion`
+ `quicksight:UpdateBrandPublishedVersion`
+ `quicksight:DeleteBrand`
+ `quicksight:ListBrands`
+ `quicksight:UpdateBrandAssignment`
+ `quicksight:DescribeBrandAssignment`
+ `quicksight:DeleteBrandAssignment`

确认您的管理员角色包含所需权限后，您可以在 Amazon Quick 管理控制台中[创建自定义品牌](https://docs.amazonaws.cn/quicksight/latest/user/brand-customization-create.html)。

## 在 Amazon Quick 中创建自定义品牌
<a name="brand-customization-create"></a>

使用以下步骤在 Amazon Quick 中创建自定义品牌。

1. 打开 [Quick 控制台](https://quicksight.aws.amazon.com/)。

1. 选择右上角的用户图标，然后选择**快速管理**。

1. 选择**自定义应用程序**。

1. 在打开的**自定义应用程序**页面上，选择**添加品牌**。将打开**品牌设置**页面。

1. 导航至**品牌信息**部分。

1. 对于**品牌名称**，输入品牌的名称。品牌名称最多可包含 512 个字符。

1. （可选）在**品牌描述**中，输入自定义品牌的描述。品牌描述最多可包含 512 个字符。

1. 导航到**徽**标部分。  
![\[品牌信息页面的徽标部分。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/logo.png)

1. 对于 “**主要**”，选择主图标旁边的省略号（三个点），然后选择 “**替换图像**”。

1. 在打开的**选择图像**弹出窗口中，执行以下操作之一：

   1. 将图像拖放到**将图像拖到此处**框中。

   1. 选择**选择文件**从您的计算机中选择一个文件。

   1. 在文本栏中输入公共 URL 或 Amazon S3 URI。

   您选择的图像必须是 `.jpeg`、`.png` 或 `.svg` 格式，且大小不能超过 1MB。

   选择完图像后，选择**应用**。

1. 对于**网页图标**，选择网页图标旁边的省略号（三个点），然后选择**替换图像**。

1. 在打开的**选择图像**弹出窗口中，执行以下操作之一：

   1. 将图像拖放到**将图像拖到此处**框中。

   1. 选择**选择文件**从您的计算机中选择一个文件。

   1. 在文本栏中输入公共 URL 或 Amazon S3 URI。

   您选择的图像必须是 `.jpeg`、`.png` 或 `.svg` 格式，且大小不能超过 1MB。

   选择完图像后，选择**应用**。

1. （可选）对于**替代文本**，请输入要与徽标一起显示的替代文本。替代文本最多可包含 512 个字符。

1. 要更改品牌的主题颜色，请导航至左侧的**外观**窗格并选择**主题**。

1. **模版设置**页面将出现，并显示可自定义的 Amazon Quick 主题的所有部分。下图显示了全局导航栏的配置设置。  
![\[全局导航栏的配置设置。使用背景和前景色板来自定义主题设置页面上列出的每个主题项目的颜色。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/navigation-bar.png)

1. 要更改某个区域的背景颜色，请导航到要更改的项，然后选择**背景**颜色样本。

1. 在出现的**自定义颜色**弹出窗口中，从颜色渐变中选择一种颜色或在**十六进制**栏中输入十六进制代码值，然后选择**应用**。

1. 要更改某个区域的前景颜色，请导航到要更改的项，然后选择**前景**颜色样本。

1. 在出现的**自定义颜色**弹出窗口中，从颜色渐变中选择一种颜色或在**十六进制**栏中输入十六进制代码值，然后选择**应用**。

1. 配置完自定义品牌后，选择 PUBLISH 进行**发布**，并将品牌自定义应用于所有 Amazon Quick 用户账户。如果您不想发布品牌，请选择 “**保存**” 以保存品牌以备后用。

在 Amazon Quick 中完成品牌创建后，新品牌将显示在 Quick 管理控制台的 “**自定义” 应用程序**页面的品牌表中。品牌表的**状态**列显示了当前发布到Quick账户的品牌。要更改自定义品牌，请在品牌表中找到要更改的品牌，选择**操作**列中的省略号（三个点）图标，然后选择**发布**、**编辑**或**删除**。

发布品牌后，新品牌最多可能需要 10 分钟才能在所有用户中传播。

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

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

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

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

   以下示例显示了 Amazon CLI中使用 `list-themes` 命令的 shell 脚本。它设置 Amazon 账户 ID 和 a Amazon Web Services 区域 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.amazonaws.cn//quicksight/latest/APIReference/API_ListUsers.html)或 [ListGroups](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_ListGroups.html)API 操作收集需要使用默认主题的用户或群组的 Amazon 资源名称 (ARNs)。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

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

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

   以下示例显示了使用[update-theme-permissions](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_UpdateThemePermissions.html)命令的 shell 脚本。`grant-permissions`参数使用速记语法显示。您可以使用 JSON 或 YAML。有关更多信息，请参阅《Amazon Command Line Interface 用户指南》**中的[指定参数值](https://docs.amazonaws.cn/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`