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á.
Você pode usar a Amazon QuickSight APIs para criar pastas escalonadas 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 QuickSight ativos com milhares de usuários.
Pastas escalonadas só podem ser criadas com o. QuickSight 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 QuickSight APIs ou com o QuickSight console.
Cada QuickSight conta da Amazon 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. QuickSight APIs
Pré-requisitos
Antes de começar, verifique se você tem uma AWS Identity and Access Management função que concede ao usuário da API acesso para chamar as operações da QuickSight API. 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.
{
"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": "*"
}
]
}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 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"