View a markdown version of this page

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

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 as APIs do Quick Sight

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 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 update-topic
--cli-input-json file://updatetopic.json

O exemplo a seguir fornece uma lista de todos os tópicos em uma conta rápida.

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 Quick. 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 as APIs do Amazon Quick Sight para configurar um cronograma de atualização de tópicos, migrar tópicos do Quick Sight dentro ou entre contas e criar respostas revisadas.