Création de dossiers QuickSight redimensionnés à l'aide du QuickSight APIs

Vous pouvez utiliser Amazon QuickSight APIs pour créer des dossiers à échelle spéciale qui peuvent être partagés avec jusqu'à 3 000 espaces de noms. Chaque espace de noms ajouté à un dossier peut contenir jusqu'à 100 principaux. Un principal est un utilisateur ou un groupe d'utilisateurs. Après avoir créé un dossier redimensionné et ajouté les éléments principaux souhaités, vous pouvez ajouter n'importe quel QuickSight actif au dossier. Il peut ensuite être partagé avec tous les principaux des espaces de noms auxquels les principaux du dossier sont affectés. Cela rationalise le processus de partage des QuickSight actifs avec des milliers d'utilisateurs.

Les dossiers redimensionnés ne peuvent être créés qu'avec le QuickSight APIs. Lorsque vous créez un dossier dimensionné, vous pouvez le partager avec un maximum de 100 principaux qui se trouvent dans le même espace de noms. Vous pouvez ajouter des principes appartenant à un espace de noms différent par un UpdateFolderPermissions API appel. Une fois le dossier créé, vous pouvez ajouter et supprimer des éléments du dossier à l'aide de la console QuickSight APIs ou de la QuickSight console.

Chaque QuickSight compte Amazon contient 100 dossiers redimensionnés. Vous pouvez ajouter jusqu'à 100 ressources à un dossier dimensionné. Si vous voulez partager un dossier dimensionné avec plus de 3000 espaces de noms, contactez l'assistance AWS.

Exemples

Les exemples suivants montrent comment créer un dossier redimensionné avec le QuickSight APIs.

Prérequis

Avant de commencer, vérifiez que vous disposez d'un AWS Identity and Access Management rôle qui autorise l'APIutilisateur à appeler les QuickSight API opérations. L'exemple suivant montre une IAM politique que vous pouvez ajouter à un IAM rôle existant pour créer, supprimer ou modifier un dossier redimensionné. Avec l'exemple de politique, les utilisateurs peuvent ajouter des tableaux de bord, des analyses et des jeux de données à un dossier dimensionné.

{
    "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": "*"
        }
    ]
}

L'exemple suivant crée un dossier dimensionné.

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

Après avoir créé un dossier dimensionné, partagez le dossier avec un principal de votre compte. Vous ne pouvez accorder ou révoquer des autorisations qu'aux utilisateurs et aux groupes appartenant au même espace de noms lors de chaque API appel. L'exemple suivant partage un dossier dimensionné avec un utilisateur du même compte que celui dans lequel le dossier 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"
        }
    ]'

Après avoir partagé le dossier avec un nouveau principal, validez les autorisations du nouveau dossier par un describe-folder-permissions API appel.

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

Après avoir validé les nouvelles autorisations du dossier, créez un sous-dossier dans le dossier dimensionné. Le sous-dossier hérite des autorisations du dossier dimensionné dans lequel il a été créé.

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"

L'exemple suivant valide les autorisations héritées du nouveau sous-dossier.

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

Après avoir validé les autorisations du sous-dossier, ajoutez la ressource que vous voulez partager au dossier. Une fois la ressource ajoutée au sous-dossier, elle est partagée avec tous les principaux avec lesquels le sous-dossier est partagé. L'exemple suivant ajoute un tableau de bord à un sous-dossier.

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"