

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Arbeiten Sie mit Quick Sight-Themen mithilfe von Quick Sight APIs
<a name="topic-cli-examples"></a>

Das folgende Beispiel erstellt ein neues Thema.

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

Sie können auch ein neues Thema erstellen, indem Sie eine CLI-Skelettdatei mit dem folgenden Befehl verwenden. Weitere Informationen zu CLI-Skelettdateien finden Sie unter [Verwenden von CLI-Skelettdateien](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) im *Amazon Quick Sight Developer Guide*.

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

Wenn Sie ein neues Thema erstellen, wird die Konfiguration für die Aktualisierung des Datensatzes nicht in das Thema kopiert. Um einen Zeitplan für die Aktualisierung des Themas für Ihr neues Thema festzulegen, können Sie einen `create-topic-refresh-schedule`-API-Aufruf durchführen. Weitere Informationen zum Konfigurieren von Zeitplänen für Themenaktualisierungen mit der CLI finden Sie unter [Konfigurieren Sie Zeitpläne für die Aktualisierung von Quick Sight-Themen mit der Quick Sight CLI](topic-refresh-apis.md).

Nachdem Sie Ihr erstes Thema erstellt haben, können Sie ein Thema aktualisieren, löschen, auflisten oder eine Zusammenfassung anfordern.

Im folgenden Beispiel wird ein Thema aktualisiert.

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

Sie können ein Thema auch aktualisieren, indem Sie eine CLI-Skelettdatei mit dem folgenden Befehl verwenden. Weitere Informationen zu CLI-Skelettdateien finden Sie unter [Verwenden von CLI-Skelettdateien](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) im *Amazon Quick Sight Developer Guide*.

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

Das folgende Beispiel enthält eine Liste aller Themen in einem Quick-Konto.

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

Im folgenden Beispiel wird ein Thema gelöscht.

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

Das folgende Beispiel enthält Informationen darüber, wie ein Thema konfiguriert wurde.

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

Der folgende Befehl aktualisiert die Berechtigungen eines Themas.

```
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
```

Verwenden Sie den `grant-permissions` Parameter, um Quick Account-Benutzern Lese- und Autorenberechtigungen zu gewähren. Um einem Kontobenutzer Leserechte zu gewähren, geben Sie den folgenden Wert ein: `"quicksight:DescribeTopic"`. Um Berechtigungen für einen Kontobenutzer zu erteilen, geben Sie die folgenden Werte ein:
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

Der `RevokePermissions`-Parameter widerruft alle einem Kontonutzer erteilten Berechtigungen.

Der folgende Befehl beschreibt alle Berechtigungen für ein Thema.

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

Nachdem Sie ein Quick Sight-Thema erstellt haben, können Sie Amazon Quick Sight verwenden, APIs um [einen Zeitplan für die Themenaktualisierung zu konfigurieren](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [Quick Sight-Themen innerhalb oder zwischen Konten zu migrieren](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) und [überprüfte Antworten zu erstellen](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).