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á.
Criação de pastas escalonadas do Quick Sight com as APIs do Quick Sight
Você pode usar as APIs do Amazon Quick Sight 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 as APIs do Quick Sight. 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 as APIs do Quick Sight ou o console do 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
Exemplos
Os exemplos a seguir mostram como criar uma pasta escalonada com as APIs do Quick Sight.
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.
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"
