翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Quick Sight のフォルダへのアセットの整理
| |
| --- |
| 適用対象: Enterprise Edition |
Quick Enterprise Edition では、チームメンバーは個人フォルダと共有フォルダを作成して、Quick Sight アセット管理に階層構造を追加できます。フォルダを使用すると、ダッシュボード、分析、データセット、データソース、トピックを簡単に整理、移動、検出できます。フォルダ内では、通常どおりのツールを使用してアセットを検索したり、お気に入りリストにアセットを追加したりできます。
Quick Sight では、次のタイプのフォルダを使用できます。
+ 自分の仕事を整理するための個人用フォルダ。
個人用フォルダは、所有者のみが表示できます。個人用フォルダの所有権を他のユーザーに譲渡することはできません。
+ 共有フォルダ:
+ **共有フォルダ**は作業を整理し、複数のユーザー間での共有を簡素化します。共有フォルダを作成および管理するには、Quick Sight 管理者である必要があります。
+ **共有制限付きフォルダ**は、アセットを共有フォルダに保持する Quick Sight の共有フォルダの一種です。共有制限付きフォルダ内にあるアセットから作成されたアセットは、制限付きフォルダにも存在する必要があります。制限付きフォルダにあるアセットは、制限付きフォルダの外へ移動したり共有したりすることはできません。例えば、共有制限付きフォルダにあるデータソースを使用するデータセットを作成した場合、この新しいデータセットを共有制限付きフォルダの外へ移動することはできません。
制限付きフォルダにあるアセットを制限付きフォルダツリー内の 1 つまたは複数のサブフォルダに移動できます。制限付きフォルダのサブフォルダは制限付きフォルダと同様に動作しますが、依存アセットは同じルート制限付きフォルダの異なるサブフォルダに存在する可能性があります。ルート制限フォルダは、ルートフォルダツリー内に存在する限り、すべてのサブフォルダ内のすべてのアセットが存在できる境界として機能します。例えば、あるサブフォルダにあるデータセットは、同じフォルダツリーまたはルートフォルダにある別のサブフォルダにあるデータソースを使用できます。サポートされているアセットタイプは、ルートフォルダまたはそのいずれかのサブフォルダに作成できます。ユーザーは、さまざまなサブフォルダでさまざまなロールを持つことができます。サブフォルダのアクセス許可は、そのサブフォルダの親フォルダから継承されます。
制限付きフォルダは、Quick Sight [https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html](https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html) API オペレーションでのみ作成できます。
+ フォルダのビューワーであり、Quick の作成者または管理者ロールを持つユーザーは、フォルダ内のすべてのアセットタイプを表示できます。フォルダのビューワーであり、Quick のリーダーロールを持つユーザーは、フォルダにあるダッシュボードとストーリーのみを表示できます。
共有フォルダが、アクセス権を持つユーザーに表示されます。
Quick Sight でのフォルダまたはサブフォルダの作成と設定の詳細については、以下のトピックを参照してください。
**Topics**
+ [Quick Sight フォルダに関する考慮事項](folders-limitations.md)
+ [Quick Sight フォルダの概要](folders-functionality.md)
+ [Quick Sight 共有フォルダのアクセス許可](folders-security.md)
+ [Quick Sight 共有フォルダのメンバーシップアクセス許可の作成と管理](sharing-folders.md)
+ [Quick Sight APIs を使用した Quick Sight スケールフォルダの作成](folders-scaled.md)
# Quick Sight フォルダに関する考慮事項
Amazon Quick Sight でフォルダの作成と変更を開始する前に、Quick Sight フォルダに適用される以下の制限を確認してください。
+ AWS アカウントのフォルダを他の のユーザーと共有することはできません AWS アカウント。
+ Quick Reader のアクセス許可を持つユーザーには、次の制限が適用されます。
+ 閲覧者は、個人用フォルダや共有フォルダを所有することはできません。
+ 閲覧者は、フォルダまたはフォルダのコンテンツを作成または管理することはできません。
+ 閲覧者は投稿者アクセスレベルを持つことはできません。
+ 共有フォルダでは、閲覧者はダッシュボードアセットのみを表示できます。
さらに、次の制限が特に共有フォルダーに適用されます。
+ 共有フォルダの名前 (ツリーの最上位レベル) は、 AWS アカウント内で一意である必要があります。
+ 単一のフォルダで、複数のアセットを同じ名前にすることはできません。たとえば、最上位フォルダで、同じ名前のサブフォルダを 2 つ作成することはできません。同じフォルダに異なるアセット ID がある場合でも、同じ名前の 2 つのアセットを追加することはできません。各アセットへのパスは、Amazon S3 キー名のように動作します。 AWS アカウント内で一意である必要があります。
+ 制限付き共有フォルダは、Quick Sight CLI でのみ作成できます。
Amazon Quick Sight [Quick Sight フォルダの概要](folders-functionality.md) で使用できるさまざまなタイプのフォルダの詳細については、「」を参照してください。
# Quick Sight フォルダの概要
Quick Sight では、個人用フォルダと共有フォルダを作成できます。また、個人フォルダまたは共有フォルダの横にあるお気に入り (![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/favorite-icon.png)) アイコンを選択することで、すぐにアクセスできるようになります。
個人用フォルダでは、以下のことを実行できます。
+ サブフォルダを作成する。
+ 分析、ダッシュボード、データセット、データ ソースなどのアセットをフォルダに追加する。アセットを個人用フォルダに追加するには、アセットへのアクセス権を持っている必要があります。複数のアセットを同じ名前にすることができます。
**共有フォルダ (制限なし)**
クイック管理者は、共有フォルダを使用して次のタスクを実行できます。
+ 共有フォルダとその中のサブフォルダを作成または削除する。最上位フォルダ内で、共有フォルダとサブフォルダのいずれかを移動できます。
+ 所有者、投稿者、表示者を追加または削除する。あるユーザーを*所有者*に設定すると、フォルダ内のすべてのアセットの所有権が付与されます。詳細については、「[Quick Sight 共有フォルダのアクセス許可](folders-security.md)」を参照してください。
次の表は、クイックユーザーがロールに基づいて無制限の共有フォルダを操作するときに実行できるアクションをまとめたものです。
****
| Action | 所有者 | 寄稿者 | 表示者 |
| --- | --- | --- | --- |
| フォルダ内のアセットを、そのフォルダへのアクセス権を持たないユーザーと共有する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダのアクセス許可を変更する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダにアセットを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ内のアセットを変更する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ内のアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| 既存のアセットをフォルダに追加する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| 共有フォルダからアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ内のアセットを表示する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい |
| 共有フォルダにあるアセットを使用する下流のアセットを共有フォルダの外に作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい\$1 |
| フォルダ外にあるアセットを使用する下流のアセットをフォルダ内に作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダのアクセス許可を管理する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダに既存のアセットを追加する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダに新しいアセットを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダ内のアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
\$1アセットを作成するには、ユーザーに管理者ロールまたは作成者ロールを割り当てる必要があります。
**制限付き共有フォルダ**
制限付き共有フォルダは、フォルダ外のデータの共有を制限する追加のセキュリティ境界となります。適切な IAM アクセス許可を持つ管理者は、制限付き共有フォルダで以下のタスクを実行できます。
+ 制限付きフォルダは `CreateFolder` API オペレーションを使用して作成できます。`CreatFolder` API オペレーションの詳細については、「[CreateFolder](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html)」を参照してください。
+ 投稿者ロールは、制限付きフォルダ内のアセットを作成および編集できるユーザーに割り当てられます。寄稿者はフォルダまたは制限付きフォルダ内のアセットのアクセス許可を管理できません。
+ 管理者は `UpdateFolderPermissions` API オペレーションを使用してユーザーにフォルダの投稿者と閲覧者のアクセス許可を割り当てることができます。`UpdateFolderPermissions` API オペレーションの詳細については、「[UpdateFolderPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateFolderPermissions.html)」を参照してください。
次の表は、Quick Sight ユーザーがロールに基づいて制限付き共有フォルダを操作するときに実行できるアクションをまとめたものです。
****
| Action | 寄稿者 | 表示者 |
| --- | --- | --- |
| フォルダ内のアセットを、そのフォルダへのアクセス権を持たないユーザーと共有する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダのアクセス許可を変更する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダにアセットを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ内のアセットを変更する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダからアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| 既存のアセットをフォルダに追加する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| 共有フォルダからアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ内のアセットを表示する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい |
| 共有フォルダにあるアセットを使用する下流のアセットを共有フォルダの外に作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| フォルダ外にあるアセットを使用する下流のアセットをフォルダ内に作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダのアクセス許可を管理する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダに既存のアセットを追加する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダに新しいアセットを作成する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
| サブフォルダからアセットを削除する | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/success_icon.svg) はい | ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/negative_icon.svg) いいえ |
所有者ロールは、制限付き共有フォルダではサポートされていません。
ユースケースに最適なフォルダタイプを選択したら、「[Quick Sight 共有フォルダのアクセス許可](folders-security.md)」と「[Quick Sight 共有フォルダのメンバーシップアクセス許可の作成と管理](sharing-folders.md)」を参照してフォルダを作成し、フォルダのアクセス許可を設定します。
# Quick Sight 共有フォルダのアクセス許可
共有フォルダには 3 つのアクセス許可レベルがあります。ユーザーまたはグループにフォルダレベルのアクセス許可を設定する方法については、「[Quick Sight 共有フォルダのメンバーシップアクセス許可の作成と管理](sharing-folders.md)」を参照してください。
+ **所有者** - フォルダの*所有者*は、フォルダ内のすべて (フォルダ、分析、ダッシュボード、データセット、データソース、トピック) を所有します。フォルダ内のアセットの作成、編集、削除、フォルダとそのアセットのアクセス許可の変更、フォルダ全体の削除を行うことができます。所有者ロールは、制限付き共有フォルダではサポートされていません。
+ **寄稿者** - 寄稿者は所有者と同様にフォルダ内のアセットを作成、編集、削除できます。フォルダを削除したり、フォルダまたはフォルダから継承した寄稿者のアクセス許可を持つアセットに対するアクセス許可を変更したりすることはできません。
+ **閲覧者** - *閲覧者*は、フォルダ内のアセット (フォルダ、ダッシュボード、データセット、データソース、トピック) の表示のみを行うことができます。表示者は、これらのアセットを編集または共有することはできません。
次のルールも共有フォルダのセキュリティに適用されます。
+ フォルダのクイックリーダーの共有ステータスは、 フォルダと共有されます。ただし、閲覧者はフォルダへの読み取りアクセス権と、ビジュアルへのダッシュボードアクセス権のみを取得します。
+ AWS セキュリティは、フォルダ内のすべてのオブジェクトに適用されます。フォルダでは、アクセスレベル (管理者、作成者、閲覧者) に応じて、フォルダを共有しているユーザーのすべてのアセットに同じ種類のセキュリティが適用されます。
+ *最上位フォルダ*は、サブフォルダのルートフォルダです。サブフォルダが任意のレベルで共有されている場合、フォルダの共有相手は、最上位のフォルダビューでルートフォルダを表示できます。
+ フォルダのアクセス許可は、現在のフォルダに対するアクセス許可であり、ルートフォルダにつながるすべてのフォルダのアクセス許可と組み合わせたものです。
+ *共有アセット*は、フォルダからアクセス許可を継承します。共有アセットは、フォルダ所有者に属するアセットが共有フォルダに追加されたときに作成されます。
+ 無制限の共有フォルダを所有している場合は、フォルダの所有権を別のクイック管理者に移管できます。
+ 所有者ロールは、制限付きフォルダではサポートされていません。投稿者ロールは、制限付きフォルダ内のアセットを作成および編集する作成者に割り当てられます。フォルダの投稿者は、制限付きフォルダやそのアセットのアクセス許可を管理できません。
+ 制限付き共有フォルダのアクセス許可を API `UpdateFolderPermissions` を使用して更新するには、適切な IAM アクセス許可が必要です。
共有フォルダのアクセス許可を作成および管理するには、「[Quick Sight 共有フォルダのメンバーシップアクセス許可の作成と管理](sharing-folders.md)」を参照してください。
# Quick Sight 共有フォルダのメンバーシップアクセス許可の作成と管理
**共有フォルダ (制限なし)**
共有フォルダを作成し、クイックコンソールの 1 つ以上のグループとフォルダを共有するには、Amazon QuickSight 管理者である必要があります。`CreateFolder` API オペレーションを使用して共有フォルダを作成することもできます。共有フォルダのメンバーシップアクセス許可を共有または変更するには、次の手順を使用します。
1. 左側のナビゲーションから、**フォルダ、****共有フォルダ**を選択します。アクセス許可を共有または管理するフォルダを見つけます。
1. そのフォルダの行のアクションメニューを開くには、省略記号 (3 点リーダー) を選択します。
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 \
```
ユーザーに渡されるアクセス許可は、ユーザーに付与するフォルダロールのタイプに応じて異なります。次のリストを使用して、フォルダへのアクセスを許可するユーザーにどのアクセス許可が必要かを決定します。
**フォルダ所有者**
+ quicksight:CreateFolder
+ quicksight:DescribeFolder
+ quicksight:UpdateFolder
+ quicksight:DeleteFolder
+ quicksight:CreateFolderMembership
+ quicksight:DeleteFolderMembership
+ quicksight:DescribeFolderPermissions
+ quicksight:UpdateFolderPermissions
**フォルダ寄稿者**
+ quicksight:CreateFolder
+ quicksight:DescribeFolder
+ quicksight:CreateFolderMembership
+ quicksight:DeleteFolderMembership
+ quicksight:DescribeFolderPermissions
**フォルダ表示者**
+ quicksight:DescribeFolder
共有フォルダを作成したら、Quick Sight でそのフォルダの使用を開始できます。
Quick Sight APIs を使用して、最大 3000 個の名前空間と共有できる特別なスケールフォルダを作成することもできます。スケーリングフォルダの作成の詳細については、「[Quick Sight APIs を使用した Quick Sight スケールフォルダの作成](folders-scaled.md)」を参照してください。
# Quick Sight APIs を使用した Quick Sight スケールフォルダの作成
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/)にお問い合わせください。
## 例
次の例は、Quick Sight APIs を使用してスケールフォルダを作成する方法を示しています。
**前提条件**
開始する前に、API ユーザーに Quick Sight API オペレーションを呼び出すためのアクセス権を付与する AWS Identity and Access Management ロールがあることを確認します。次の例は、スケーリングフォルダを作成、削除、または変更するために既存の 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"
```