Trabalhe com tópicos do Quick Sight usando o Quick Sight APIs - Amazon Quick Suite

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á.

Trabalhe com tópicos do Quick Sight usando o Quick Sight APIs

O exemplo a seguir cria um novo tópico.

aws quicksight create-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC

Você também pode criar um novo tópico usando um arquivo de esqueleto CLI com o comando a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de CLI no Guia do desenvolvedor do Amazon Quick Sight.

aws quicksight create-topic
--cli-input-json file://createtopic.json

Quando você cria um novo tópico, a configuração de atualização do conjunto de dados não é copiada para o tópico. Para definir uma programação de atualização para seu novo tópico, você pode fazer uma chamada de API create-topic-refresh-schedule. Para obter mais informações sobre a configuração de programações de atualização de tópicos com a CLI, consulte Configure os cronogramas de atualização de tópicos do Quick Sight com a CLI do Quick Sight.

Depois de criar seu primeiro tópico, você pode atualizar, excluir, listar ou solicitar um resumo de um tópico.

O exemplo a seguir atualiza um tópico.

aws quicksight update-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC

Você também pode atualizar um tópico usando um arquivo esqueleto CLI com o comando a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de CLI no Guia do desenvolvedor do Amazon Quick Sight.

aws quicksight update-topic
--cli-input-json file://updatetopic.json

O exemplo a seguir fornece uma lista de todos os tópicos em uma conta do Quick Suite.

aws quicksight list-topics 
--aws-account-id AWSACCOUNTID

O exemplo a seguir exclui um tópico.

aws quicksight delete-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID

O exemplo a seguir fornece informações sobre como um tópico foi configurado.

aws quicksight describe-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID

O comando a seguir atualiza as permissões de um tópico.

aws quicksight update-topic-permissions
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--grant-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic
--revoke-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic

Use o grant-permissions parâmetro para conceder permissões de leitura e autor aos usuários da conta do Quick Suite. Para conceder permissões de leitura a um usuário da conta, insira o seguinte valor: "quicksight:DescribeTopic". Para conceder permissões a um usuário da conta, insira os seguintes valores:

  • "quicksight:DescribeTopic"

  • "quicksight:DescribeTopicRefresh"

  • "quicksight:ListTopicRefreshSchedules"

  • "quicksight:DescribeTopicRefreshSchedule"

  • "quicksight:DeleteTopic"

  • "quicksight:UpdateTopic"

  • "quicksight:CreateTopicRefreshSchedule"

  • "quicksight:DeleteTopicRefreshSchedule"

  • "quicksight:UpdateTopicRefreshSchedule"

  • "quicksight:DescribeTopicPermissions"

  • "quicksight:UpdateTopicPermissions"

O parâmetro RevokePermissions revoga todas as permissões concedidas a um usuário da conta.

O comando a seguir descreve todas as permissões de um tópico.

aws quicksight describe-topic-permissions 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID

Depois de criar um tópico do Quick Sight, você pode usar o Amazon Quick Sight APIs para configurar um cronograma de atualização de tópicos, migrar tópicos do Quick Sight dentro ou entre contas e criar respostas revisadas.