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 Amazon Quick Sight APIs
<a name="topics-cli"></a>


|  | 
| --- |
|  Berlaku untuk: Enterprise Edition  | 


|  | 
| --- |
|    Pemirsa yang dituju: Pengembang Amazon Quick  | 

Gunakan bagian ini untuk mempelajari cara bekerja dengan topik Quick Sight menggunakan antarmuka baris perintah Amazon Quick Sight (CLI).

**Prasyarat**

Sebelum memulai, pastikan bahwa Anda memiliki peran AWS Identity and Access Management (IAM) yang memberikan akses pengguna CLI untuk memanggil operasi Quick Sight API. Tabel berikut menunjukkan izin mana yang harus ditambahkan ke kebijakan IAM untuk menggunakan operasi API tertentu. Untuk menggunakan semua operasi API topik, tambahkan semua izin yang tercantum dalam tabel.


| Operasi API | Kebijakan IAM | 
| --- | --- | 
|  `CreateTopic`  |  `quicksight:CreateTopic` `quicksight:PassDataSet`  | 
|  `ListTopics`  |  `quicksight:ListTopics`  | 
|  `DescribeTopic`  |  `quicksight:DescribeTopic`  | 
|  `DescribeTopicPermissions`  |  `quicksight:DescribeTopicPermissions`  | 
|  `DescribeTopicRefresh`  |  `quicksight:DescribeTopicRefresh`  | 
|  `DeleteTopic`  |  `quicksight:DeleteTopic`  | 
|  `UpdateTopic`  |  `quicksight:UpdateTopic` `quicksight:PassDataSet`  | 
|  `UpdateTopicPermissions`  |  `quicksight:UpdateTopicPermissions`  | 
|  `CreateTopicRefreshSchedule`  |  `quicksight:CreateTopicRefreshSchedule`  | 
|  `ListTopicRefreshSchedules`  |  `quicksight:ListTopicRefreshSchedules`  | 
|  `DescribeTopicRefreshSchedule`  |  `quicksight:DescribeTopicRefreshSchedule`  | 
|  `UpdateTopicRefreshSchedule`  |  `quicksight:UpdateTopicRefreshSchedule`  | 
|  `DeleteTopicRefreshSchedule`  |  `quicksight:DeleteTopicRefreshSchedule`  | 
|  `BatchCreateTopicReviewedAnswer`  |  `quicksight:BatchCreateTopicReviewedAnswer`  | 
|  `BatchDeleteTopicReviewedAnswer`  |  `quicksight:BatchDeleteTopicReviewedAnswer`  | 
|  `ListTopicReviewedAnswers`  |  `quicksight:ListTopicReviewedAnswers`  | 

Contoh berikut menunjukkan kebijakan IAM yang memungkinkan pengguna untuk menggunakan operasi `ListTopics` API.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "quicksight:ListTopics"
            ],
            "Resource": "*"
        }
    ]
}
```

------

Setelah Anda mengonfigurasi izin untuk membuat topik Quick Sight dengan Quick Sight APIs, gunakan topik berikut untuk membuat dan bekerja dengan topik APIs Quick Sight.

**Topics**
+ [Bekerja dengan topik Quick Sight menggunakan Quick Sight APIs](topic-cli-examples.md)
+ [Konfigurasikan jadwal penyegaran topik Quick Sight dengan CLI Quick Sight](topic-refresh-apis.md)
+ [Menyalin dan memigrasikan topik Quick Sight di dalam dan di antara Akun AWS](topic-cli-walkthroughs.md)
+ [Membuat dan memodifikasi jawaban yang ditinjau dalam topik Quick Sight dengan Quick Sight APIs](topic-reviewed-answer-apis.md)

# 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).

# Konfigurasikan jadwal penyegaran topik Quick Sight dengan CLI Quick Sight
<a name="topic-refresh-apis"></a>

Perintah berikut membuat jadwal penyegaran topik.

```
aws quicksight create-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-arn DATASETARN
--refresh-schedule REFRESHSCHEDULE
```

Setelah membuat jadwal penyegaran untuk suatu topik, Anda dapat memperbarui, menghapus, membuat daftar, atau meminta ringkasan jadwal penyegaran topik.

Perintah berikut memperbarui jadwal penyegaran suatu topik.

```
aws quicksight update-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
--refresh-schedule REFRESHSCHEDULE
```

Contoh berikut menyediakan daftar semua jadwal penyegaran yang dikonfigurasi ke topik.

```
aws quicksight list-topic-refresh-schedules
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```

Contoh berikut menghapus jadwal penyegaran topik.

```
aws quicksight delete-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

Contoh berikut memberikan informasi tentang bagaimana jadwal penyegaran topik dikonfigurasi.

```
aws quicksight describe-topic-refresh-schedule  
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

# Menyalin dan memigrasikan topik Quick Sight di dalam dan di antara Akun AWS
<a name="topic-cli-walkthroughs"></a>

Anda dapat memigrasikan topik Quick Sight Anda dari satu akun ke akun lainnya dengan antarmuka baris perintah Quick Sight (CLI). Alih-alih mereplikasi topik yang sama secara manual di beberapa dasbor, ruang nama, atau akun, Anda dapat menggunakan CLI Quick Sight untuk menggunakan kembali topik yang sama berulang kali. Kemampuan ini menghemat waktu penulis Quick Sight dan menciptakan pengalaman topik standar untuk pembaca dasbor di beberapa dasbor.

Untuk memigrasikan topik dengan CLI Quick Sight, gunakan prosedur berikut

**Untuk memigrasikan topik ke akun lain**

1. Pertama, identifikasi topik yang ingin Anda migrasikan. Anda dapat melihat daftar setiap topik di akun Cepat Anda dengan perintah `list-topics` API.

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

1. Setelah Anda memiliki daftar topik, cari topik yang ingin Anda migrasi dan lakukan `describe-topic` panggilan untuk menerima struktur JSON dari konfigurasi topik.

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

   Berikut ini adalah contoh respon `describe-topic` API.

   ```
   {
       "Status": 200,
       "TopicId": "TopicExample", 
       "Arn": "string",
       "Topic": [
           {
               "Name": "{}",
               "DataSets": [
               {
               "DataSetArn": "{}",
               "DataSetName": "{}",
               "DataSetDescription": "{}",
               "DataAggregation": "{}",
               "Filters": [],
               "Columns": [],
               "CalculatedFields": [],
               "NamedEntities": []
               }
               ]
           }
       ],
       "RequestId": "requestId"
       }
   ```

1. Gunakan respons JSON untuk membuat file kerangka yang dapat Anda masukkan ke dalam `create-topic` panggilan baru di akun Cepat Anda yang lain. Sebelum Anda melakukan panggilan API dengan file kerangka Anda, pastikan untuk mengubah Akun AWS ID dan ID kumpulan data dalam file kerangka agar sesuai dengan Akun AWS ID dan ID kumpulan data tempat Anda menambahkan topik baru. 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 --aws-account-id AWSACCOUNTID \
   --cli-input-json file://./create-topic-cli-input.json
   ```

Setelah Anda melakukan `create-topic` panggilan ke Quick Sight API, topik baru akan muncul di akun Anda. Untuk mengonfirmasi bahwa topik baru ada, lakukan `list-topics` panggilan ke Quick Sight API. Jika topik sumber yang diduplikasi berisi jawaban terverifikasi, jawaban tidak dimigrasikan ke topik baru. Untuk melihat daftar semua jawaban terverifikasi yang dikonfigurasi ke topik asli, gunakan panggilan `describe-topic` API.

# Membuat dan memodifikasi jawaban yang ditinjau dalam topik Quick Sight dengan Quick Sight APIs
<a name="topic-reviewed-answer-apis"></a>

Setelah Anda membuat topik Quick Sight, Anda dapat menggunakan Quick Sight APIs untuk membuat, daftar, memperbarui, dan menghapus jawaban reiewed untuk topik.

Perintah di bawah batch membuat hingga 100 jawaban yang ditinjau untuk topik Quick Sight.

```
aws quicksight batch-create-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answers ANSWERS
```

Anda juga dapat membuat jawaban yang ditinjau secara batch dari 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 batch-create-topic-reviewed-answer \ 
--cli-input-json file://createTopicReviewedAnswer.json
```

Perintah di bawah ini mencantumkan semua jawaban yang ditinjau dalam topik Quick Sight.

```
aws quicksight list-topic-reviewed-answers \
--aws-account-id AWSACCOUNTID \
--topic-id TOPICID \
```

Contoh di bawah ini menghapus hingga 100 jawaban yang ditinjau dari suatu topik.

```
aws quicksight batch-delete-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answer-ids: ["AnswerId1, AnswerId2…"]
```

Anda juga dapat membuat jawaban yang ditinjau topik secara batch dari 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 batch-delete-topic-reviewed-answer \
--cli-input-json file://deleteTopicReviewedAnswer.json
```

Untuk memperbarui jawaban yang ditinjau, hapus jawaban yang ada dari topik dengan `batch-delete-topic-reviewed-answer` API. Kemudian, gunakan `batch-create-topic-reviewed-answer` API untuk menambahkan jawaban ulasan yang diperbarui ke topik.