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
<a name="topic-cli-examples"></a>

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](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) 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](topic-refresh-apis.md).

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](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) 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 rápida. 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](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [migrar tópicos do Quick Sight dentro ou entre contas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) e [criar respostas revisadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).