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

# 为 Amazon Quick Sight 整理资产到文件夹中
<a name="folders"></a>


|  | 
| --- |
|  适用于：企业版  | 

在 Quick Enterprise 版中，您的团队成员可以创建个人和共享文件夹，为 Quick Sight 资产管理添加分层结构。使用文件夹，人们可以更轻松地组织、浏览和发现控制面板、分析、数据集、数据来源和主题。在文件夹中，您仍然可以使用常用工具搜索资产或将资产添加到收藏夹列表中。

您可以在 Quick Sight 中使用以下类型的文件夹：
+ 个人文件夹，用于自己整理工作。

  只有拥有个人文件夹的人才能看到这些文件夹。您不能将个人文件夹的所有权转让给其他任何人。
+ 共享文件夹：
  + **共享文件夹**可以整理工作并简化多人之间的共享。要创建和管理共享文件夹，您需要成为 Quick Sight 管理员。
  + **共享受限文件夹**是 Quick Sight 中的一种共享文件夹，可确保资源保留在共享文件夹中。使用共享受限文件夹中的资产创建的资产也必须保留在受限文件夹中。位于受限文件夹中的资产不能在受限文件夹之外移动或共享。例如，如果您创建的数据集使用位于共享受限文件夹中的数据来源，则无法将新数据集移到该共享受限文件夹之外。

    可以将位于受限文件夹中的资产移动到受限文件夹树内的一个或多个子文件夹中。受限文件夹的子文件夹的行为与受限文件夹类似，但依赖资产可以存在于同一根受限文件夹下的不同子文件夹中。根受限文件夹充当边界，只要所有子文件夹中的资产仍在根文件夹树内，它们就可以存在。例如，位于一个子文件夹中的数据集可以使用位于同一文件夹树中的另一个子文件夹或根文件夹中的数据来源。可以在根文件夹或其任何子文件夹中创建任何受支持的资产类型。用户可以在不同的子文件夹中拥有不同的角色。子文件夹权限从该子文件夹的父文件夹继承。

    只能通过 Quick Sight [https://www.amazonaws.cn/quicksight/latest/APIReference/API_CreateFolder.html](https://www.amazonaws.cn/quicksight/latest/APIReference/API_CreateFolder.html)API 操作创建受限文件夹。
  + 作为文件夹查看者且在 Quick 中具有 “作者” 或 “管理员” 角色的用户可以查看该文件夹中的所有资产类型。作为文件夹查看者且在 Quick 中具有 “读者” 角色的用户只能看到该文件夹中的仪表板和故事。

  所有共享文件夹对有权访问的用户可见。

使用以下主题了解有关在 Quick Sight 中创建和配置文件夹或子文件夹的更多信息。

**Topics**
+ [

# 快速浏览文件夹的注意事项
](folders-limitations.md)
+ [

# Quick Sight 文件夹概述
](folders-functionality.md)
+ [

# Quick Sight 共享文件夹的权限
](folders-security.md)
+ [

# 创建和管理 Quick Sight 共享文件夹的成员权限
](sharing-folders.md)
+ [

# 使用快速瞄准器创建 Quick Sight 缩放的文件夹 APIs
](folders-scaled.md)

# 快速浏览文件夹的注意事项
<a name="folders-limitations"></a>

在开始在 Amazon Quick Sight 中创建和修改文件夹之前，请查看适用于 Quick Sight 文件夹的以下限制。
+ 您无法与其他人共享您 Amazon 账户中的文件夹 Amazon Web Services 账户。
+ 对于拥有 Quick Reader 权限的用户，以下限制适用：
  + 读者不能拥有个人或共享文件夹。
  + 读者无法创建或管理文件夹或文件夹内容。
  + 读者不能拥有*贡献者*访问级别。
  + 在共享文件夹中，读者只能看到控制面板资产。

此外，以下限制特别适用于共享文件夹：
+ 共享文件夹（位于树的顶层）的名称在您的 Amazon 帐户中必须是唯一的。
+ 在单个文件夹中，多个资产不能具有相同的名称。例如，在顶层文件夹中，您不能创建两个同名的子文件夹。在同一个文件夹中，不能添加两个同名资源，即使它们有不同的资产 IDs。每项资产的路径的行为类似于 Amazon S3 密钥名称。它在您的 Amazon 账户中必须是唯一的。
+ 只能使用 Quick Sight CLI 创建受限制的共享文件夹。

[Quick Sight 文件夹概述](folders-functionality.md)要详细了解 Amazon Quick Sight 中提供的不同类型的文件夹，请参阅。

# Quick Sight 文件夹概述
<a name="folders-functionality"></a>

在 Quick Sight 中，您可以创建个人和共享文件夹。您还可以选择个人或共享文件夹旁边的收藏夹（![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/favorite-icon.png)）图标，以便快速访问。

您可以使用个人文件夹执行以下操作：
+ 创建子文件夹。
+ 将资产添加到您的文件夹，包括分析、控制面板、数据集和数据来源。要将资产添加到个人文件夹，您必须已经可以访问这些资产。多个资产可以具有相同的名称。

**共享文件夹（不受限）**

Quick 管理员可以使用共享文件夹执行以下任务。
+ 创建或删除共享文件夹及其中的子文件夹。您可以在顶级文件夹中移动其中任何一个。
+ 添加或移除所有者、贡献者和查看者。当您让某人成为某个文件夹的*所有者*时，您就赋予了他们对该文件夹中每项资产的所有权。有关更多信息，请参阅 [Quick Sight 共享文件夹的权限](folders-security.md)。

下表汇总了 Quick 用户在根据其角色处理不受限制的共享文件夹时可以采取的操作。


****  

| Action | 所有者 | 贡献者 | 查看者 | 
| --- | --- | --- | --- | 
| 与无权访问文件夹的用户共享该文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 修改文件夹权限 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 在文件夹中创建资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 修改文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 删除文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 将现有资产添加到文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 从共享文件夹中移除资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 查看文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | 
| 在共享文件夹之外创建使用位于共享文件夹中的资产的下游资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是\$1 | 
| 在使用位于该文件夹之外的资产的文件夹中创建下游资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 创建子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 删除子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 管理子文件夹权限 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 将现有资源添加到子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 在子文件夹中创建新资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 删除子文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 

\$1必须为用户分配管理员或作者角色才能创建资产。

**受限共享文件夹**

受限共享文件夹提供额外的安全边界，限制在文件夹之外共享数据。具有相应 IAM 权限的管理员可以使用受限共享文件夹执行以下任务。
+ 可以使用 `CreateFolder` API 操作创建受限文件夹。有关 `CreatFolder` API 操作的更多信息，请参阅[CreateFolder](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_CreateFolder.html)。
+ 贡献者角色分配给可以在受限文件夹中创建和编辑资产的用户。贡献者无法管理该文件夹或受限文件夹中资产的权限。
+ 管理员可以通过 `UpdateFolderPermissions` API 操作向用户分配文件夹贡献者和查看者权限。有关 `UpdateFolderPermissions` API 操作的更多信息，请参阅[UpdateFolderPermissions](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_UpdateFolderPermissions.html)。

下表汇总了 Quick Sight 用户在根据其角色处理受限共享文件夹时可以采取的操作。


****  

| Action | 贡献者 | 查看者 | 
| --- | --- | --- | 
| 与无权访问文件夹的用户共享该文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 修改文件夹权限 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 在文件夹中创建资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 修改文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 从文件夹中删除资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 将现有资产添加到文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 从共享文件夹中移除资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 查看文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | 
| 在共享文件夹之外创建使用位于共享文件夹中的资产的下游资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 在使用位于该文件夹之外的资产的文件夹中创建下游资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 创建子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 删除子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 管理子文件夹权限 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 将现有资源添加到子文件夹 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 在子文件夹中创建新资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 
| 删除子文件夹中的资产 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/negative_icon.svg)没有 | 

受限共享文件夹不支持所有者角色。

选择最适合您的使用案例的文件夹类型后，请参阅 [Quick Sight 共享文件夹的权限](folders-security.md) 和 [创建和管理 Quick Sight 共享文件夹的成员权限](sharing-folders.md) 以创建文件夹并设置文件夹权限。

# Quick Sight 共享文件夹的权限
<a name="folders-security"></a>

共享文件夹有三个权限级别。要为用户或组设置文件夹级别的权限，请参阅 [创建和管理 Quick Sight 共享文件夹的成员权限](sharing-folders.md)。
+ **所有者** – 文件夹*所有者*拥有文件夹内的所有内容（文件夹、分析、控制面板、数据集、数据来源、主题）。他们可以创建、编辑和删除文件夹中的资产，修改文件夹及其资产的权限，以及完全删除该文件夹。受限共享文件夹不支持所有者角色。
+ **贡献者** – *贡献者*可以像所有者一样创建、编辑和删除文件夹中的资产。他们无法删除该文件夹，也无法修改该文件夹或从该文件夹继承的拥有贡献者访问权限的资产的权限。
+ **查看者** – *查看者*只能查看文件夹中的资产（文件夹、控制面板、数据集、数据来源、主题）。查看者无法编辑或共享这些资产。

以下规则也适用于共享文件夹的安全性：
+ 快速读者对某个文件夹的共享状态会与该文件夹共享。但是，读者只能对文件夹具有读取权限，并且只能在控制面板上访问视觉对象。
+ Amazon 对文件夹中的每个对象都强制执行安全措施。该文件夹根据访问权限级别（管理员、作者或读者），对与之共享该文件夹的人的资产应用相同类型的安全保护。
+ *顶级文件夹*是所有子文件夹的根文件夹。在任何级别上共享子文件夹时，与之共享该文件夹的人员都会在顶级文件夹视图中看到该根文件夹。
+ 文件夹权限是指当前文件夹的权限，再加上通往根文件夹的所有文件夹的权限。
+ *共享资产*从该文件夹继承其权限。将属于文件夹所有者的资产添加到共享文件夹时，就会创建共享资产。
+ 如果您拥有不受限制的共享文件夹，则可以将该文件夹的所有权转让给另一个 Quick 管理员。
+ 受限文件夹不支持所有者角色。贡献者角色分配给在受限文件夹中创建和编辑资产的作者。文件夹贡献者无法管理受限文件夹或其资产的权限。
+ 使用 `UpdateFolderPermissions` API 更新受限共享文件夹的权限需要正确的 IAM 权限。

要创建和管理共享文件夹的权限，请参阅 [创建和管理 Quick Sight 共享文件夹的成员权限](sharing-folders.md)。

# 创建和管理 Quick Sight 共享文件夹的成员权限
<a name="sharing-folders"></a>

**共享文件夹（不受限）**

要在 Quick 控制台中创建共享文件夹并与 Quick 控制台中的一个或多个群组共享该文件夹，您必须是 Amazon QuickSight 管理员。您也可以使用 `CreateFolder` API 操作创建共享文件夹。使用以下过程共享或修改共享文件夹的成员资格权限。

1. 在左侧导航栏中，选择**文件夹**，然后选择**共享文件夹**。找到您要共享或管理权限的文件夹。

1. 要打开该文件夹行的操作菜单，请选择省略号（三个点）。

1. 选择**共享**。

1. 在**共享文件夹**模式中，添加要与之共享文件夹内容的组和用户。

1. 对于您添加的每个用户和组，请从该行的**权限**菜单中选择一个权限级别。

1. 要更新现有用户的权限类型，请选择**管理文件夹访问权限**。

1. 完成文件夹的用户和组权限设置后，选择**共享**。用户不会收到他们现在可以访问该文件夹的通知。

**受限共享文件夹** 

只能通过 `CreateFolder` API 操作创建受限共享文件夹。以下示例创建受限共享文件夹。

```
aws quicksight create-folder \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--folder-type RESTRICTED \
--name "Example Folder" \
```

创建受限共享文件夹后，通过 `UpdateFolderPermissions` API 调用为文件夹贡献者和查看者分配权限。以下示例更新了受限共享文件夹的权限，以向用户授予参与者权限。

```
aws quicksight update-folder-permissions \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--grant-permissions Principal=arn:aws:quicksight::us-east-
1::AWSACCOUNTID:user/default/:username,Actions=quicksight:CreateFolder
,quicksight:DescribeFolder, \
quicksight:CreateFolderMembership,quicksight:DeleteFolderMembership,qu
icksight:DescribeFolderPermissions \
```

您传递给用户的权限取决于您想要授予他们的文件夹角色的类型。使用以下列表确定您要授予文件夹访问权限的用户需要哪些权限。

**文件夹所有者**
+ 快速瞄准:CreateFolder
+ 快速瞄准:DescribeFolder
+ 快速瞄准:UpdateFolder
+ 快速瞄准:DeleteFolder
+ 快速瞄准:CreateFolderMembership
+ 快速瞄准:DeleteFolderMembership
+ 快速瞄准:DescribeFolderPermissions
+ 快速瞄准:UpdateFolderPermissions

**文件夹贡献者**
+ 快速瞄准:CreateFolder
+ 快速瞄准:DescribeFolder
+ 快速瞄准:CreateFolderMembership
+ 快速瞄准:DeleteFolderMembership
+ 快速瞄准:DescribeFolderPermissions

**文件夹查看者**
+ 快速瞄准:DescribeFolder

创建共享文件夹后，您可以在 Quick Sight 中开始使用该文件夹。

您还可以使用 Quick Sight APIs 创建特殊缩放的文件夹，这些文件夹最多可与 3000 个命名空间共享。要了解有关创建扩展的文件夹的更多信息，请参阅 [使用快速瞄准器创建 Quick Sight 缩放的文件夹 APIs](folders-scaled.md)。

# 使用快速瞄准器创建 Quick Sight 缩放的文件夹 APIs
<a name="folders-scaled"></a>

您可以使用 Amazon Quick Sight APIs 创建特殊缩放的文件夹，这些文件夹最多可与 3000 个命名空间共享。添加到文件夹的每个命名空间最多可以包含 100 个主体。*主体*是一个用户或一组用户。在创建缩放后的文件夹并添加所需的委托人之后，可以将任何 QuickSight 资源添加到该文件夹。然后可以将其共享给分配有文件夹主体的命名空间中的每个主体。这简化了与成千上万用户共享 Quick Sight 资产的流程。

缩放后的文件夹只能使用 Quick Sight 创建 APIs。创建扩展的文件夹时，您最多可以与同一命名空间中的 100 个主体共享该文件夹。您可以通过 `UpdateFolderPermissions` API 调用添加属于不同命名空间的主体。创建文件夹后，您可以使用 Quick Sight APIs 或 Quick 控制台在文件夹中添加和删除资源。

每个 Amazon Quick Sight 账户最多可容纳 100 个缩放文件夹 您最多可以向扩展的文件夹添加 100 个资产。如果您想共享一个包含超过 3000 个命名空间的扩展的文件夹，请联系 [Amazon 支持人员](https://www.amazonaws.cn/contact-us/)。

## 示例
<a name="folders-scaled-examples"></a>

以下示例说明如何使用 Quick Sight 创建缩放后的文件夹 APIs。

**先决条件**

在开始之前，请验证您的 Amazon Identity and Access Management 角色是否授予 API 用户调用 Quick Sight API 操作的访问权限。以下示例显示了一个 IAM 策略，您可以将其添加到现有 IAM 角色以创建、删除或修改扩展的文件夹。使用示例策略，用户可以将控制面板、分析和数据集添加到扩展的文件夹。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "quicksight:CreateFolder",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:DescribeFolderResolvedPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:UpdateDashboardPermissions",
            "quicksight:UpdateAnalysisPermissions",
            "quicksight:UpdateDataSetPermissions"
        ],
        "Resource": "*"
        }
    ]
}
```

------

以下示例创建扩展的文件夹。

```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "eastcoast-users" \
--sharing-model "NAMESPACE" \
--folder-id "eastcoast-users"
```

创建扩展的文件夹后，请与账户中的主体共享该文件夹。在每次 API 调用中，您只能向位于同一命名空间内的用户和组授予或撤销权限。以下示例与用户共享扩展的文件夹，其账户与该文件夹所在的账户相同。

```
aws quicksight update-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--grant-permissions \
    '[
        {"Actions":
            ["quicksight:DescribeFolder",
            "quicksight:UpdateFolder",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:CreateFolder"
            ],
        "Principal":"arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/my-user"
        }
    ]'
```

与新主体共享文件夹后，通过 `describe-folder-permissions` API 调用验证新文件夹的权限。

```
aws quicksight describe-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--namespace "default"
```

验证新文件夹权限后，在扩展的文件夹中创建一个子文件夹。子文件夹继承其创建时所在的扩展的文件夹的权限。

```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "new-york-users" \
--sharing-model "NAMESPACE" \
--folder-id "new-york-users" \
--parent-folder-arn "arn:aws:quicksight:us-east-1:AWSACCOUNTID:folder/eastcoast-users"
```

以下示例将对新子文件夹继承的权限进行验证。

```
aws quicksight describe-folder-resolved-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "new-york-users" \
--namespace "default"
```

验证子文件夹的权限后，将要共享的 Quick Sight 资源添加到该文件夹。将资产添加到子文件夹后，该资产将与所有共享该子文件夹的主体共享。以下示例将控制面板添加至子文件夹。

```
aws quicksight create-folder-membership \
--aws-account-id "AWSACCOUNTID" \
--folder-id "new-york-users" \
--member-id "my-dashboard" \
--member-type "DASHBOARD" \
--region "us-east-1"
```