As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Organização de ativos em pastas para o Amazon Quick Sight
| |
| --- |
| Aplica-se a: Enterprise Edition |
Na edição Quick Enterprise, os membros da sua equipe podem criar pastas pessoais e compartilhadas para adicionar estrutura hierárquica ao gerenciamento de ativos do Quick Sight. Ao usar as pastas, as pessoas podem organizar, navegar e descobrir painéis, análises, conjuntos de dados, fontes de dados e tópicos com mais facilidade. Em uma pasta, você ainda pode usar suas ferramentas habituais para pesquisar ativos ou adicioná-los à sua lista de favoritos.
Você pode usar os seguintes tipos de pastas com o Quick Sight:
+ Pastas pessoais que organizam o trabalho para si.
As pastas pessoais são visíveis somente para seus proprietários. Você não pode transferir a propriedade de pastas pessoais para outras pessoas.
+ Pastas compartilhadas:
+ As **pastas compartilhadas** organizam o trabalho e simplificam o compartilhamento entre várias pessoas. Para criar e gerenciar pastas compartilhadas, você precisa ser administrador do Quick Sight.
+ As **pastas restritas compartilhadas** são um tipo de pasta compartilhada no Quick Sight que garante que os ativos permaneçam na pasta compartilhada. Os ativos criados com ativos que existem em uma pasta compartilhada restrita também devem permanecer na pasta restrita. Os ativos localizados em pastas restritas não podem ser movidos ou compartilhados fora da pasta restrita. Por exemplo, se você criar um conjunto de dados que usa uma fonte de dados localizada em uma pasta compartilhada restrita, o novo conjunto de dados não poderá ser movido para fora dessa pasta compartilhada restrita.
Os ativos localizados em uma pasta restrita podem ser movidos dentro da árvore dessa pasta para uma ou mais subpastas. As subpastas em pastas restritas se comportam como pastas restritas, mas ativos dependentes podem existir em subpastas diferentes sob a mesma pasta raiz restrita. A pasta raiz restrita atua como uma delimitação na qual todos os ativos em todas as subpastas podem existir, desde que permaneçam dentro da árvore da pasta raiz. Por exemplo, um conjunto de dados localizado em uma subpasta pode usar uma fonte de dados que esteja em outra subpasta na mesma árvore de pastas ou na pasta raiz. Qualquer tipo de ativo compatível pode ser criado em uma pasta raiz ou em qualquer uma das suas subpastas. Os usuários podem ter diferentes perfis em subpastas distintas. As permissões das subpastas são herdadas das pastas principais dessa subpasta.
Pastas restritas só podem ser criadas com a operação da [https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html](https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html)API Quick Sight.
+ Os usuários que são visualizadores em uma pasta e têm a função Autor ou Administrador no Quick podem visualizar todos os tipos de ativos que estão na pasta. Os usuários que são visualizadores em uma pasta e têm a função de Leitor no Quick só podem ver painéis e histórias que estão na pasta.
Todas as pastas compartilhadas são visíveis para as pessoas que têm acesso a elas.
Use os tópicos a seguir para saber mais sobre como criar e configurar uma pasta ou subpasta no Quick Sight.
**Topics**
+ [Considerações sobre as pastas do Quick Sight](folders-limitations.md)
+ [Visão geral das pastas do Quick Sight](folders-functionality.md)
+ [Permissões para pastas compartilhadas do Quick Sight](folders-security.md)
+ [Crie e gerencie permissões de associação para pastas compartilhadas do Quick Sight](sharing-folders.md)
+ [Criação de pastas escalonadas do Quick Sight com o Quick Sight APIs](folders-scaled.md)
# Considerações sobre as pastas do Quick Sight
Antes de começar a criar e modificar pastas no Amazon Quick Sight, analise as seguintes limitações que se aplicam às pastas do Quick Sight.
+ Você não pode compartilhar pastas na sua AWS conta com pessoas em outras Contas da AWS.
+ Para pessoas que têm permissões de leitura rápida, as seguintes limitações se aplicam:
+ Os leitores não podem ter uma pasta pessoal ou compartilhada.
+ Os leitores não podem criar ou gerenciar pastas ou conteúdo de pastas.
+ Os leitores não podem ter o nível de acesso do *colaborador*.
+ Nas pastas compartilhadas, os leitores só podem ver os ativos do painel.
Além disso, as seguintes limitações se aplicam especificamente às pastas compartilhadas:
+ O nome de uma pasta compartilhada (no nível superior da árvore) deve ser exclusivo em sua AWS conta.
+ Em uma única pasta, vários ativos não podem ter o mesmo nome. Por exemplo, na sua pasta de nível superior, você não pode criar duas subpastas com o mesmo nome. Na mesma pasta, você não pode adicionar dois ativos com o mesmo nome, mesmo que eles tenham ativos diferentes IDs. O caminho para cada ativo se comporta como um nome de chave do Amazon S3. Ele deve ser exclusivo em sua AWS conta.
+ Pastas compartilhadas restritas só podem ser criadas com a CLI do Quick Sight.
Consulte [Visão geral das pastas do Quick Sight](folders-functionality.md) para saber mais sobre os diferentes tipos de pasta disponíveis no Amazon Quick Sight.
# Visão geral das pastas do Quick Sight
No Quick Sight, você pode criar pastas pessoais e compartilhadas. Você também pode adicionar suas pastas pessoais ou compartilhadas aos favoritos para acesso rápido escolhendo o ícone de favorito (![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/favorite-icon.png)) ao lado dela.
É possível fazer as ações a seguir com suas pastas pessoais.
+ Criar subpastas.
+ Adicionar ativos à sua pasta, incluindo análises, painéis, conjuntos de dados e fontes de dados. Para adicionar ativos a uma pasta pessoal, você já deve ter acesso aos ativos. Vários ativos podem ter o mesmo nome.
**Pastas compartilhadas (sem restrições)**
Administradores rápidos podem realizar as seguintes tarefas com pastas compartilhadas.
+ Criar ou excluir uma pasta compartilhada e subpastas dentro dela. Você pode mover qualquer uma delas dentro da pasta de nível superior.
+ Adicionar ou remover proprietários, colaboradores e visualizadores. Ao tornar uma pessoa *proprietária* da pasta, você dá a ela a propriedade de todos os ativos da pasta. Para obter mais informações, consulte [Permissões para pastas compartilhadas do Quick Sight](folders-security.md).
A tabela a seguir resume as ações que um usuário do Quick pode realizar ao trabalhar com pastas compartilhadas irrestritas com base em sua função.
****
| Ação | Proprietário | Colaborador | Visualizador |
| --- | --- | --- | --- |
| Compartilhar um ativo em uma pasta com usuários que não têm acesso à pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Modificar as permissões da pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Modificar os ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir os ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Adicionar um ativo existente para uma pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Remover um ativo de uma pasta compartilhada | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Visualizar os ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) |
| Criar ativos downstream externos à pasta compartilhada que usam ativos localizados na pasta compartilhada | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim\$1 |
| Criar ativos downstream na pasta que usam ativos localizados de forma externa à pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Criar subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Gerenciar as permissões das subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Adicionar ativos existentes às subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar novos ativos em subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir os ativos em subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
\$1O usuário deve ter um perfil de administrador ou autor para criar ativos.
**Pastas compartilhadas restritas**
As pastas compartilhadas restritas fornecem um limite de segurança adicional que restringe o compartilhamento de dados fora da pasta. Os administradores com as permissões apropriadas do IAM podem realizar as tarefas a seguir com pastas compartilhadas restritas.
+ Pastas restritas podem ser criadas usando a operação `CreateFolder` de API. Para obter mais informações sobre a operação `CreatFolder` da API, consulte [CreateFolder](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html).
+ O perfil de colaborador é atribuído aos usuários que podem criar e editar ativos dentro das pastas restritas. Os colaboradores não podem gerenciar as permissões da pasta ou dos ativos que estão na pasta restrita.
+ Os administradores podem atribuir permissões de colaborador e visualizador da pasta aos usuários com a operação `UpdateFolderPermissions` de API. Para obter mais informações sobre a operação `UpdateFolderPermissions` da API, consulte [UpdateFolderPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateFolderPermissions.html).
A tabela a seguir resume as ações que um usuário do Quick Sight pode realizar ao trabalhar com pastas compartilhadas restritas com base em sua função.
****
| Ação | Colaborador | Visualizador |
| --- | --- | --- |
| Compartilhar um ativo em uma pasta com usuários que não têm acesso à pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Modificar as permissões da pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Modificar os ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir os ativos da pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Adicionar um ativo existente para uma pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Remover um ativo de uma pasta compartilhada | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Visualizar os ativos na pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Yes (Sim) |
| Criar ativos downstream externos à pasta compartilhada que usam ativos localizados na pasta compartilhada | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar ativos downstream na pasta que usam ativos localizados de forma externa à pasta | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Gerenciar as permissões das subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Adicionar ativos existentes às subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Nº |
| Criar novos ativos em subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
| Excluir os ativos das subpastas | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/negative_icon.svg) Não |
O perfil de proprietário não é compatível com pastas compartilhadas restritas.
Após escolher o tipo de pasta que melhor atende ao seu caso de uso, consulte [Permissões para pastas compartilhadas do Quick Sight](folders-security.md) e [Crie e gerencie permissões de associação para pastas compartilhadas do Quick Sight](sharing-folders.md) para criar as pastas e configurar as permissões das pastas.
# Permissões para pastas compartilhadas do Quick Sight
As pastas compartilhadas têm três níveis de permissão. Para definir permissões em nível de pasta para um usuário ou grupo, consulte [Crie e gerencie permissões de associação para pastas compartilhadas do Quick Sight](sharing-folders.md).
+ **Proprietários**: o *proprietário* da pasta detém todos os elementos (incluindo pastas, análises, painéis, conjuntos de dados, fontes de dados e tópicos) dentro de uma pasta. Eles podem criar, editar e excluir os ativos na pasta, modificar as permissões na pasta e nos seus ativos, bem como excluir totalmente a pasta. O perfil de proprietário não é compatível com pastas compartilhadas restritas.
+ **Colaboradores**: um *colaborador* pode criar, editar e excluir ativos em uma pasta da mesma forma que um proprietário. Eles não podem excluir a pasta nem modificar as permissões nela ou nos ativos em que tenham acesso de colaborador que herdaram da pasta.
+ **Visualizadores**: um *visualizador* pode visualizar somente os ativos (que incluem as pastas, os painéis, os conjuntos de dados, as fontes de dados e os tópicos) na pasta. Um visualizador não pode editar nem compartilhar esses ativos.
As seguintes regras também se aplicam à segurança de pastas compartilhadas:
+ O status de compartilhamento rápido dos leitores de uma pasta é compartilhado com a pasta. No entanto, um leitor só tem acesso de leitura às pastas e somente acesso de painel aos elementos visuais.
+ AWS a segurança é aplicada em cada objeto dentro de uma pasta. A pasta aplica o mesmo tipo de segurança aos ativos de qualquer pessoa com quem a pasta é compartilhada, de acordo com seu nível de acesso (administrador, autor ou leitor).
+ A *pasta de nível superior* é a pasta raiz de todas as subpastas. Quando uma subpasta é compartilhada em qualquer nível, a pessoa com quem a pasta foi compartilhada vê a pasta raiz na visualização das pastas de nível superior.
+ A permissão da pasta é a permissão na pasta atual, combinada com as permissões de todas as pastas que levam à pasta raiz.
+ Um *ativo compartilhado* herda sua permissão da pasta. Um ativo compartilhado é criado quando um ativo que pertence ao proprietário da pasta é adicionado a uma pasta compartilhada.
+ Se você tiver uma pasta compartilhada sem restrições, poderá transferir a propriedade da pasta para outro administrador do Quick.
+ O perfil de proprietário não é compatível com pastas restritas. O perfil de colaborador é atribuído aos autores que criam e editam ativos nas pastas restritas. Os colaboradores da pasta não podem gerenciar as permissões da pasta restrita ou de seus ativos.
+ As permissões corretas do IAM são necessárias para atualizar as permissões de uma pasta compartilhada restrita com a API de `UpdateFolderPermissions`.
Para criar e gerenciar permissões de uma pasta compartilhada, consulte [Crie e gerencie permissões de associação para pastas compartilhadas do Quick Sight](sharing-folders.md).
# Crie e gerencie permissões de associação para pastas compartilhadas do Quick Sight
**Pastas compartilhadas (sem restrições)**
Para criar uma pasta compartilhada e compartilhar a pasta com um ou mais grupos no console rápido, você deve ser QuickSight administrador da Amazon. Você também pode criar uma pasta compartilhada com a operação `CreateFolder` de API. Use o procedimento apresentado a seguir para compartilhar ou modificar as permissões de associação de uma pasta compartilhada.
1. No painel de navegação à esquerda, escolha **Pastas e depois Pastas** **compartilhadas**. Encontre a pasta para a qual você deseja compartilhar ou gerenciar permissões.
1. Para abrir o menu de ações da linha dessa pasta, selecione as reticências (três pontos).
1. Selecione **Share**.
1. No modal **Compartilhar pasta**, adicione os grupos e usuários com os quais deseja compartilhar o conteúdo da pasta.
1. Para cada usuário e grupo que você adicionar, escolha um nível de permissão no menu **Permissões** nessa linha.
1. Para atualizar o tipo de permissão de um usuário existente, escolha **Gerenciar acesso à pasta**.
1. Quando terminar de definir as permissões de usuário e grupo da pasta, selecione **Compartilhar**. Os usuários não são notificados de que agora têm acesso à pasta.
**Pastas compartilhadas restritas**
Pastas compartilhadas restritas só podem ser criadas com a operação `CreateFolder` de API. O exemplo a seguir cria uma pasta compartilhada restrita.
```
aws quicksight create-folder \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--folder-type RESTRICTED \
--name "Example Folder" \
```
Depois de criar uma pasta compartilhada restrita, atribua permissões de colaborador e visualizador da pasta com uma chamada `UpdateFolderPermissions` de API. O exemplo apresentado a seguir atualiza as permissões de uma pasta compartilhada restrita para conceder permissões de colaborador a um usuário.
```
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 \
```
As permissões fornecidas ao usuário dependem do tipo de perfil para acesso à pasta que você deseja conceder. Use as listas apresentadas a seguir para determinar quais permissões são necessárias para o usuário ao qual você deseja conceder acesso à pasta.
**Proprietário da pasta**
+ visão rápida: CreateFolder
+ visão rápida: DescribeFolder
+ visão rápida: UpdateFolder
+ visão rápida: DeleteFolder
+ visão rápida: CreateFolderMembership
+ visão rápida: DeleteFolderMembership
+ visão rápida: DescribeFolderPermissions
+ visão rápida: UpdateFolderPermissions
**Colaborador da pasta**
+ visão rápida: CreateFolder
+ visão rápida: DescribeFolder
+ visão rápida: CreateFolderMembership
+ visão rápida: DeleteFolderMembership
+ visão rápida: DescribeFolderPermissions
**Visualizador da pasta**
+ visão rápida: DescribeFolder
Depois de criar uma pasta compartilhada, você pode começar a usar a pasta no Quick Sight.
Você também pode usar o Quick Sight APIs para criar pastas especiais em escala que podem ser compartilhadas com até 3.000 namespaces. Para saber mais sobre como criar uma pasta escalável, consulte [Criação de pastas escalonadas do Quick Sight com o Quick Sight APIs](folders-scaled.md).
# Criação de pastas escalonadas do Quick Sight com o Quick Sight APIs
Você pode usar o Amazon Quick Sight APIs para criar pastas escaláveis especiais que podem ser compartilhadas com até 3.000 namespaces. Cada namespace adicionado a uma pasta pode conter até cem entidades principais. Uma *entidade principal* é um usuário ou um grupo de usuários. Depois de criar uma pasta escalonada e adicionar os principais desejados, qualquer QuickSight ativo pode ser adicionado à pasta. Em seguida, ela pode ser compartilhada com cada entidade principal nos namespaces aos quais as entidades principais da pasta estão atribuídas. Isso simplifica o processo de compartilhamento de ativos do Quick Sight com milhares de usuários.
Pastas escalonadas só podem ser criadas com o Quick Sight APIs. Ao criar uma pasta dimensionada, você pode compartilhar a pasta com até cem entidades principais que estejam no mesmo namespace. Você pode adicionar entidades principais que pertençam a um namespace diferente com uma chamada `UpdateFolderPermissions` de API. Depois que a pasta for criada, você poderá adicionar e remover ativos da pasta com o Quick Sight APIs ou o console Quick.
Cada conta do Amazon Quick Sight contém até 100 pastas escaláveis. Você pode adicionar até cem ativos a uma pasta dimensionada. Se quiser compartilhar uma pasta dimensionada com mais de três mil namespaces, entre em contato com o [suporte da AWS](https://aws.amazon.com/contact-us/).
## Exemplos
Os exemplos a seguir mostram como criar uma pasta em escala com o Quick Sight APIs.
**Pré-requisitos**
Antes de começar, verifique se você tem uma AWS Identity and Access Management função que conceda ao usuário da API acesso para chamar as operações da API Quick Sight. O exemplo a seguir mostra uma política do IAM que você pode adicionar a um perfil do IAM existente para criar, excluir ou modificar uma pasta dimensionada. Com a política de exemplo, os usuários podem adicionar painéis, análises e conjuntos de dados a uma pasta dimensionada.
------
#### [ 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": "*"
}
]
}
```
------
O exemplo a seguir cria uma pasta dimensionada.
```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "eastcoast-users" \
--sharing-model "NAMESPACE" \
--folder-id "eastcoast-users"
```
Depois de criar uma pasta dimensionada, compartilhe a pasta com uma entidade principal na sua conta. Você só pode conceder ou revogar permissões para usuários e grupos que estejam no mesmo namespace em cada chamada de API. O exemplo a seguir compartilha uma pasta dimensionada com um usuário na mesma conta em que a pasta existe.
```
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"
}
]'
```
Depois de compartilhar a pasta com uma nova entidade principal, valide as novas permissões da pasta com uma chamada `describe-folder-permissions` de API.
```
aws quicksight describe-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--namespace "default"
```
Depois de validar as novas permissões da pasta, crie uma subpasta dentro da pasta dimensionada. A subpasta herda as permissões da pasta dimensionada na qual foi criada.
```
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"
```
O exemplo a seguir valida as permissões herdadas da nova subpasta.
```
aws quicksight describe-folder-resolved-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "new-york-users" \
--namespace "default"
```
Depois de validar as permissões da subpasta, adicione o ativo do Quick Sight que você deseja compartilhar à pasta. Depois de adicionar o ativo à subpasta, o ativo é compartilhado com cada entidade principal com a qual a subpasta é compartilhada. O exemplo a seguir adiciona um painel a uma subpasta.
```
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"
```