Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Bekerja dengan topik Quick Sight menggunakan Quick Sight APIs
<a name="topic-cli-examples"></a>

Contoh berikut menciptakan topik baru.

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

Anda juga dapat membuat topik baru dengan menggunakan file kerangka CLI dengan perintah berikut. Untuk informasi selengkapnya tentang file kerangka CLI, lihat Menggunakan file kerangka [CLI di Panduan Pengembang *Amazon* Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html).

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

Saat Anda membuat topik baru, konfigurasi penyegaran kumpulan data tidak disalin ke topik. Untuk mengatur jadwal penyegaran topik untuk topik baru, Anda dapat melakukan panggilan `create-topic-refresh-schedule` API. Untuk informasi selengkapnya tentang mengonfigurasi jadwal penyegaran topik dengan CLI, lihat. [Konfigurasikan jadwal penyegaran topik Quick Sight dengan CLI Quick Sight](topic-refresh-apis.md)

Setelah membuat topik pertama, Anda dapat memperbarui, menghapus, membuat daftar, atau meminta ringkasan topik.

Contoh berikut memperbarui topik.

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

Anda juga dapat memperbarui topik dengan menggunakan file kerangka CLI dengan perintah berikut. Untuk informasi selengkapnya tentang file kerangka CLI, lihat Menggunakan file kerangka [CLI di Panduan Pengembang *Amazon* Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html).

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

Contoh berikut menyediakan daftar semua topik dalam akun Cepat.

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

Contoh berikut menghapus topik.

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

Contoh berikut memberikan informasi tentang bagaimana topik dikonfigurasi.

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

Perintah berikut memperbarui izin topik.

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

Gunakan `grant-permissions` parameter untuk memberikan izin baca dan penulis kepada pengguna akun Cepat. Untuk memberikan izin baca kepada pengguna akun, masukkan nilai berikut:`"quicksight:DescribeTopic"`. Untuk memberikan izin kepada pengguna akun, masukkan nilai berikut:
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

`RevokePermissions`Parameter mencabut semua izin yang diberikan kepada pengguna akun.

Perintah berikut menjelaskan semua izin dari suatu topik.

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

Setelah membuat topik Quick Sight, Anda dapat menggunakan Amazon Quick Sight APIs untuk [mengonfigurasi jadwal penyegaran topik](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [memigrasi topik Quick Sight di dalam atau di antara akun](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs), dan [membuat jawaban yang ditinjau](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).