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 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 console do Quick Sight APIs ou do Quick Suite.
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 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.
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"
