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

# 使用快速瞄准器创建 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 个命名空间的扩展的文件夹，请联系 [AWS 支持人员](https://aws.amazon.com/contact-us/)。

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

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

**先决条件**

在开始之前，请验证您的 AWS 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"
```