Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Trabaje con temas de Quick Sight mediante las API de Amazon Quick Sight
<a name="topics-cli"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de  Amazon Quick  | 

Utilice esta sección para aprender a trabajar con los temas de Quick Sight mediante la interfaz de línea de comandos (CLI) de Amazon Quick Sight.

**Requisitos previos**

Antes de empezar, asegúrese de tener una función AWS Identity and Access Management (IAM) que conceda al usuario de la CLI acceso para llamar a las operaciones de la API de Quick Sight. En la siguiente tabla, se muestran los permisos que se deben añadir a la política de IAM para utilizar operaciones de API específicas.


| Operación de la API | Política de IAM | 
| --- | --- | 
| `CreateTopic` | `quicksight:CreateTopic`<br />`quicksight:PassDataSet` | 
| `ListTopics` | `quicksight:ListTopics` | 
| `DescribeTopic` | `quicksight:DescribeTopic` | 
| `UpdateTopic` | `quicksight:UpdateTopic`<br />`quicksight:PassDataSet` | 
| `DeleteTopic` | `quicksight:DeleteTopic` | 
| `UpdateTopicPermissions` | `quicksight:UpdateTopicPermissions` | 
| `DescribeTopicPermissions` | `quicksight:DescribeTopicPermissions` | 
| `CreateTopicRefreshSchedule` | `quicksight:CreateTopicRefreshSchedule` | 
| `ListTopicRefreshSchedules` | `quicksight:ListTopicRefreshSchedules` | 
| `DescribeTopicRefreshSchedule` | `quicksight:DescribeTopicRefreshSchedule` | 
| `UpdateTopicRefreshSchedule` | `quicksight:UpdateTopicRefreshSchedule` | 
| `DeleteTopicRefreshSchedule` | `quicksight:DeleteTopicRefreshSchedule` | 

En el siguiente ejemplo, se crea un tema nuevo.

```
aws quicksight create-topic
--aws-account-id {{AWSACCOUNTID}}
--topic-id {{TOPICID}}
--topic {{TOPIC}}
```

En el ejemplo siguiente se actualiza un tema.

```
aws quicksight update-topic
--aws-account-id {{AWSACCOUNTID}}
--topic-id {{TOPICID}}
--topic {{TOPIC}}
```

El siguiente ejemplo proporciona una lista de todos los temas de una cuenta.

```
aws quicksight list-topics
--aws-account-id {{AWSACCOUNTID}}
```

En el ejemplo siguiente se elimina un tema.

```
aws quicksight delete-topic
--aws-account-id {{AWSACCOUNTID}}
--topic-id {{TOPICID}}
```

El siguiente ejemplo proporciona información sobre cómo se configuró un tema.

```
aws quicksight describe-topic
--aws-account-id {{AWSACCOUNTID}}
--topic-id {{TOPICID}}
```