Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Organización de los activos en carpetas para Amazon Quick Sight
| |
| --- |
| Se aplica a: Enterprise Edition |
En la edición Quick Enterprise, los miembros de su equipo pueden crear carpetas personales y compartidas para añadir una estructura jerárquica a la gestión de activos de Quick Sight. Al utilizar las carpetas, las personas pueden organizar, explorar y descubrir paneles, análisis, conjuntos de datos, orígenes de datos y temas con mayor facilidad. Dentro de una carpeta, puede seguir utilizando las herramientas habituales para buscar activos o agregarlos a su lista de favoritos.
Puede usar los siguientes tipos de carpetas con Quick Sight:
+ Carpetas personales para organizar el trabajo por sí mismo.
Las carpetas personales solo son visibles para la persona que las posee. No puede transferir la propiedad de las carpetas personales a nadie más.
+ Carpetas compartidas:
+ Las **carpetas compartidas** organizan el trabajo y simplifican el uso compartido entre varias personas. Para crear y administrar carpetas compartidas, debe ser administrador de Quick Sight.
+ Las **carpetas restringidas compartidas** son un tipo de carpeta compartida de Quick Sight que garantiza que los activos permanezcan en la carpeta compartida. Los activos que se crean a partir de activos que existen en una carpeta restringida compartida también deben permanecer en la carpeta restringida. Los activos que se encuentran en carpetas restringidas no se pueden mover ni compartir fuera de la carpeta restringida. Por ejemplo, si crea un conjunto de datos que utiliza un origen de datos ubicado en una carpeta restringida compartida, el nuevo conjunto de datos no se puede mover fuera de esa carpeta restringida compartida.
Los activos que se encuentran en una carpeta restringida se pueden mover dentro del árbol de carpetas restringidas a una o más subcarpetas. Las subcarpetas de las carpetas restringidas se comportan como carpetas restringidas, pero los activos dependientes pueden estar en distintas subcarpetas de la misma carpeta restringida raíz. La carpeta restringida raíz actúa como un límite en el que pueden existir todos los activos de todas las subcarpetas siempre que permanezcan dentro del árbol de carpetas raíz. Por ejemplo, un conjunto de datos ubicado en una subcarpeta puede usar un origen de datos que esté ubicado en otra subcarpeta del mismo árbol de carpetas o en la carpeta raíz. Se puede crear cualquier tipo de activo compatible en una carpeta raíz o en cualquiera de sus subcarpetas. Los usuarios pueden tener diferentes roles en distintas subcarpetas. Los permisos de subcarpeta se heredan de las carpetas principales de esa subcarpeta.
Las carpetas restringidas solo se pueden crear con la operación de la [https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html](https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html)API Quick Sight.
+ Los usuarios que visualizan una carpeta y tienen el rol de autor o administrador en Quick pueden ver todos los tipos de activos que hay en la carpeta. Los usuarios que visualizan una carpeta y tienen la función de lector en Quick solo pueden ver los paneles y las historias que estén en la carpeta.
Todas las carpetas compartidas son visibles para las personas que tienen acceso a ellas.
Utilice los siguientes temas para obtener más información sobre cómo crear y configurar una carpeta o subcarpeta en Quick Sight.
**Topics**
+ [Consideraciones sobre las carpetas Quick Sight](folders-limitations.md)
+ [Descripción general de las carpetas Quick Sight](folders-functionality.md)
+ [Permisos para las carpetas compartidas de Quick Sight](folders-security.md)
+ [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md)
+ [Creación de carpetas escaladas de Quick Sight con Quick Sight APIs](folders-scaled.md)
# Consideraciones sobre las carpetas Quick Sight
Antes de empezar a crear y modificar carpetas en Amazon Quick Sight, revise las siguientes limitaciones que se aplican a las carpetas de Quick Sight.
+ No puedes compartir carpetas de tu AWS cuenta con personas de otras cuentas Cuentas de AWS.
+ Para las personas que tienen permisos de lectura rápida, se aplican las siguientes limitaciones:
+ Los lectores no pueden ser propietarios de una carpeta personal o compartida.
+ Los lectores no pueden crear ni administrar carpetas ni su contenido.
+ Los lectores no pueden tener el nivel de acceso de *colaborador*.
+ En las carpetas compartidas, los lectores solo pueden ver los activos del panel.
Además, estas limitaciones se aplican específicamente a las carpetas compartidas:
+ El nombre de una carpeta compartida (en el nivel superior del árbol) debe ser único en tu AWS cuenta.
+ En una sola carpeta, varios activos no pueden tener el mismo nombre. Por ejemplo, en la carpeta de nivel superior, no puede crear dos subcarpetas con el mismo nombre. En la misma carpeta, no puedes añadir dos activos con el mismo nombre, aunque tengan un activo diferente IDs. La ruta a cada activo se comporta como un nombre clave de Amazon S3. Debe ser único en tu AWS cuenta.
+ Las carpetas compartidas restringidas solo se pueden crear con la CLI de Quick Sight.
Consulte [Descripción general de las carpetas Quick Sight](folders-functionality.md) para obtener más información sobre los distintos tipos de carpetas disponibles en Amazon Quick Sight.
# Descripción general de las carpetas Quick Sight
En Quick Sight, puede crear carpetas personales y compartidas. También puede marcar como favoritas sus carpetas personales o compartidas para acceder rápidamente a ellas seleccionando el icono de favoritos (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/favorite-icon.png)) situado junto a ellas.
Puede hacer lo siguiente con las carpetas personales:
+ Cree subcarpetas.
+ Agregue activos a su carpeta, incluidos análisis, paneles, conjuntos de datos y orígenes de datos. Para agregar activos a una carpeta personal, ya debe tener acceso a los activos. Varios activos pueden tener el mismo nombre.
**Carpetas compartidas (sin restricciones)**
Los administradores rápidos pueden realizar las siguientes tareas con las carpetas compartidas.
+ Cree o elimine una carpeta compartida y las subcarpetas que contenga. Puede mover cualquiera de estas opciones dentro de la carpeta de nivel superior.
+ Agregue o elimine propietarios, colaboradores y espectadores. Al convertir a una persona en *propietaria* de la carpeta, le otorga la propiedad de todos los activos de la carpeta. Para obtener más información, consulte [Permisos para las carpetas compartidas de Quick Sight](folders-security.md).
En la siguiente tabla se resumen las acciones que un usuario de Quick puede realizar cuando trabaja con carpetas compartidas sin restricciones en función de su función.
****
| Action | Propietario | Colaborador | Lector |
| --- | --- | --- | --- |
| Compartir un activo de una carpeta con los usuarios que no tengan acceso a la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Modificar los permisos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear activos en la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Modificar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Agregar un activo existente a una carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar un recurso de una carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Ver los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí |
| Crear activos descendentes fuera de la carpeta compartida que utilicen los activos que se encuentran en la carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1 |
| Crear activos descendentes en la carpeta que utilicen los activos que se encuentran fuera de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Administrar permisos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Agregar los activos existentes a las subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear nuevos activos en subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar activos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
\$1Se debe asignar al usuario un rol de administrador o autor para crear activos.
**Carpetas compartidas restringidas**
Las carpetas compartidas restringidas proporcionan un límite de seguridad adicional que restringe el uso compartido de datos fuera de la carpeta. Los administradores con los permisos de IAM adecuados pueden realizar las siguientes tareas con carpetas compartidas restringidas.
+ Las carpetas restringidas se pueden crear con la operación de la API `CreateFolder`. Para obtener más información sobre el funcionamiento de la `CreatFolder` API, consulte [CreateFolder](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html).
+ El rol de colaborador se asigna a los usuarios que pueden crear y editar activos dentro de las carpetas restringidas. Los colaboradores no pueden administrar los permisos de la carpeta ni de los activos que se encuentran en la carpeta restringida.
+ Los administradores pueden asignar permisos de colaborador y espectador de la carpeta a los usuarios mediante la operación de la API `UpdateFolderPermissions`. Para obtener más información sobre el funcionamiento `UpdateFolderPermissions` de la API, consulte [UpdateFolderPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateFolderPermissions.html).
En la siguiente tabla se resumen las acciones que un usuario de Quick Sight puede realizar cuando trabaja con carpetas compartidas restringidas en función de su función.
****
| Action | Colaborador | Lector |
| --- | --- | --- |
| Compartir un activo de una carpeta con los usuarios que no tengan acceso a la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Modificar los permisos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear activos en la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Modificar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Agregar un activo existente a una carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar un recurso de una carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Ver los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí |
| Crear activos descendentes fuera de la carpeta compartida que utilicen los activos que se encuentran en la carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear activos descendentes en la carpeta que utilicen los activos que se encuentran fuera de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Administración de permisos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Agregar los activos existentes a las subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Crear nuevos activos en subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
| Eliminar activos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No |
El rol de propietario no se admite en las carpetas compartidas restringidas.
Una vez que haya elegido el tipo de carpeta que mejor se adapte a su caso de uso, consulte [Permisos para las carpetas compartidas de Quick Sight](folders-security.md) y [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md) para crear carpetas y configurar los permisos de las carpetas.
# Permisos para las carpetas compartidas de Quick Sight
Las carpetas compartidas tienen tres niveles de permisos. Para configurar los permisos a nivel de carpeta para un usuario o grupo, consulte [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md).
+ **Propietarios**: el *propietario* de la carpeta es el propietario de todo el contenido de la carpeta (carpetas, análisis, paneles, conjuntos de datos, orígenes de datos y temas). Pueden crear, editar y eliminar los activos de la carpeta, modificar los permisos de la carpeta y sus activos y eliminar la carpeta por completo. El rol de propietario no se admite en las carpetas compartidas restringidas.
+ **Colaboradores**: un *colaborador* puede crear, editar y eliminar activos de una carpeta igual que un propietario. No pueden eliminar la carpeta ni modificar los permisos de la carpeta o de los activos en los que tienen acceso de colaborador y que hayan heredado de la carpeta.
+ **Espectadores**: un *espectador* solo puede ver los activos (carpetas, paneles, conjuntos de datos, orígenes de datos y temas) de la carpeta. Un espectador no puede editar ni compartir esos activos.
Las siguientes reglas también se aplican a la seguridad de las carpetas compartidas:
+ El estado de uso compartido de una carpeta por parte de los lectores rápidos se comparte con la carpeta. Sin embargo, el lector solo tiene acceso de lectura a las carpetas y solo acceso de panel a los elementos visuales.
+ AWS la seguridad se aplica a todos los objetos de una carpeta. La carpeta aplica el mismo tipo de seguridad a los activos de la persona con la que se comparte la carpeta según su nivel de acceso (administrador, autor o lector).
+ La *carpeta de nivel superior* es la carpeta raíz de todas las subcarpetas. Cuando se comparte una subcarpeta en cualquier nivel, la persona con la que se compartió verá la carpeta raíz en la vista de carpetas de nivel superior.
+ El permiso de carpeta es el permiso de la carpeta actual, combinado con los permisos de todas las carpetas que conducen a la carpeta raíz.
+ Un *recurso compartido* hereda su permiso de la carpeta. Un activo compartido se crea cuando un activo que pertenece al propietario de la carpeta se agrega a una carpeta compartida.
+ Si tienes una carpeta compartida sin restricciones, puedes transferir la propiedad de la carpeta a otro administrador de Quick.
+ El rol de propietario no se admite en las carpetas restringidas. El rol de colaborador se asigna a los autores que crean y editan activos dentro de las carpetas restringidas. Los colaboradores de la carpeta no pueden administrar los permisos de la carpeta restringida ni sus activos.
+ Se requieren los permisos de IAM correctos para actualizar los permisos de una carpeta compartida restringida con la API `UpdateFolderPermissions`.
Para crear y administrar los permisos de una carpeta compartida, consulte [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md).
# Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight
**Carpetas compartidas (sin restricciones)**
Para crear una carpeta compartida y compartirla con uno o más grupos en la consola rápida, debe ser QuickSight administrador de Amazon. También puede crear una carpeta compartida con la operación de la API `CreateFolder`. Utilice el siguiente procedimiento para compartir o modificar los permisos de membresía de una carpeta compartida.
1. En el menú de navegación de la izquierda, selecciona **Carpetas** y, a continuación, **Carpetas compartidas**. Busca la carpeta en la que quieres compartir o gestionar los permisos.
1. Para abrir el menú de acciones de la fila de esa carpeta, seleccione los puntos suspensivos (tres puntos).
1. Elija **Compartir**.
1. En el modal **Compartir carpeta**, agregue los grupos y usuarios con los que quiere compartir el contenido de la carpeta.
1. Para cada usuario y grupo que añada, elija un nivel de permisos en el menú **Permisos** de esa fila.
1. Para actualizar el tipo de permiso de un usuario existente, elija **Administrar el acceso a las carpetas**.
1. Cuando haya terminado de configurar los permisos de usuario y grupo para la carpeta, elija **Compartir**. No se notifica a los usuarios que ahora tienen acceso a la carpeta.
**Carpetas compartidas restringidas**
Las carpetas compartidas restringidas solo se pueden crear con la operación de la API `CreateFolder`. En el ejemplo siguiente se crea una carpeta compartida restringida.
```
aws quicksight create-folder \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--folder-type RESTRICTED \
--name "Example Folder" \
```
Tras crear una carpeta compartida restringida, asigne los permisos de colaborador y espectador de la carpeta mediante una llamada a la API `UpdateFolderPermissions`. En el siguiente ejemplo, se actualizan los permisos de una carpeta compartida restringida para conceder permisos de colaborador a un usuario.
```
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 \
```
Los permisos que se transfieren al usuario dependen del tipo de función de carpeta que se le quiera conceder. Utilice las siguientes listas para determinar qué permisos son necesarios para el usuario al que desee conceder acceso a la carpeta.
**Propietario de la carpeta**
+ vista rápida: CreateFolder
+ vista rápida: DescribeFolder
+ vista rápida: UpdateFolder
+ vista rápida: DeleteFolder
+ vista rápida: CreateFolderMembership
+ vista rápida: DeleteFolderMembership
+ vista rápida: DescribeFolderPermissions
+ vista rápida: UpdateFolderPermissions
**Colaborador de la carpeta**
+ vista rápida: CreateFolder
+ vista rápida: DescribeFolder
+ vista rápida: CreateFolderMembership
+ vista rápida: DeleteFolderMembership
+ vista rápida: DescribeFolderPermissions
**Visualizador de la carpeta**
+ vista rápida: DescribeFolder
Tras crear una carpeta compartida, puede empezar a utilizarla en Quick Sight.
También puedes usar Quick Sight APIs para crear carpetas a una escala especial que se puedan compartir con hasta 3000 espacios de nombres. Para obtener más información sobre cómo crear una carpeta escalada, consulte [Creación de carpetas escaladas de Quick Sight con Quick Sight APIs](folders-scaled.md).
# Creación de carpetas escaladas de Quick Sight con Quick Sight APIs
Puede usar Amazon Quick Sight APIs para crear carpetas a escala especiales que se pueden compartir con hasta 3000 espacios de nombres. Cada espacio de nombres que se agrega a una carpeta puede contener hasta 100 entidades principales. Una *entidad principal* es un usuario o un grupo de usuarios. Tras crear una carpeta a escala y añadir los elementos principales que desee, podrá añadir cualquier QuickSight activo a la carpeta. A continuación, se puede compartir con todas las entidades principales de los espacios de nombres a los que están asignadas las entidades principales de la carpeta. Esto agiliza el proceso de compartir los activos de Quick Sight con miles de usuarios.
Las carpetas escaladas solo se pueden crear con Quick Sight. APIs Al crear una carpeta escalada, puede compartirla con hasta 100 entidades principales que estén en el mismo espacio de nombres. Puede agregar entidades principales que pertenezcan a un espacio de nombres diferente con una llamada a la API `UpdateFolderPermissions`. Una vez creada la carpeta, puede añadir y eliminar activos de la carpeta con Quick Sight APIs o la consola Quick.
Cada cuenta de Amazon Quick Sight contiene hasta 100 carpetas escaladas. Puede agregar hasta 100 activos a una carpeta escalada. Si quiere compartir una carpeta escalada con más de 3000 espacios de nombres, póngase en contacto con [AWS Support](https://aws.amazon.com/contact-us/).
## Ejemplos
Los siguientes ejemplos muestran cómo crear una carpeta a escala con Quick Sight. APIs
**Requisitos previos**
Antes de empezar, compruebe que tiene una AWS Identity and Access Management función que conceda al usuario de la API acceso para llamar a las operaciones de la API de Quick Sight. En el siguiente ejemplo se muestra una política de IAM que puede agregar a un rol de IAM existente para crear, eliminar o modificar una carpeta escalada. Con el ejemplo de política, los usuarios pueden agregar paneles, análisis y conjuntos de datos a una carpeta escalada.
------
#### [ 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": "*"
}
]
}
```
------
En el ejemplo siguiente se crea una carpeta escalada.
```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "eastcoast-users" \
--sharing-model "NAMESPACE" \
--folder-id "eastcoast-users"
```
Tras crear una carpeta escalada, compártala con una entidad principal de la cuenta. Solo puede conceder o revocar permisos a los usuarios y grupos que estén dentro del mismo espacio de nombres en cada llamada a la API. En el siguiente ejemplo, se comparte una carpeta escalada con un usuario de la misma cuenta en la que se encuentra la carpeta.
```
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"
}
]'
```
Después de compartir la carpeta con una nueva entidad principal, valide los permisos de la nueva carpeta con una llamada a la API `describe-folder-permissions`.
```
aws quicksight describe-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--namespace "default"
```
Tras validar los permisos de la nueva carpeta, crea una subcarpeta dentro de la carpeta escalada. La subcarpeta hereda los permisos de la carpeta escalada en la que se creó.
```
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"
```
En el siguiente ejemplo, se validan los permisos heredados de la nueva subcarpeta.
```
aws quicksight describe-folder-resolved-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "new-york-users" \
--namespace "default"
```
Tras validar los permisos de la subcarpeta, añada a la carpeta el activo de Quick Sight que desee compartir. Tras agregar el recurso a la subcarpeta, se comparte con todas las entidades principales con las que se comparte la subcarpeta. En el siguiente ejemplo, se agrega un panel a una subcarpeta.
```
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"
```