翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Quick Sight APIs
<a name="topic-cli-examples"></a>

次の の例では、新しいトピックを作成します。

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

次のコマンドで CLI スケルトンファイルを使用して、新しいトピックを作成することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。

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

新しいトピックを作成すると、データセットの更新設定はトピックにコピーされません。新しいトピックのトピック更新スケジュールを設定するために、`create-topic-refresh-schedule` API 呼び出しを実行できます。CLI を使用したトピック更新スケジュールの設定の詳細については、「[Quick Sight CLI を使用して Quick Sight トピックの更新スケジュールを設定する](topic-refresh-apis.md)」を参照してください。

最初のトピックを作成したら、トピックの概要を更新、削除、一覧表示、またはリクエストできます。

次の の例では、トピックを更新します。

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

次のコマンドで CLI スケルトンファイルを使用してトピックを更新することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。

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

次の の例では、クイックアカウントのすべてのトピックのリストを示します。

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

次の の例では、トピックを削除します。

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

次の例では、トピックの設定方法に関する情報を提供します。

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

次のコマンドは、トピックのアクセス許可を更新します。

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

`grant-permissions` パラメータを使用して、クイックアカウントユーザーに読み取りおよび作成者のアクセス許可を付与します。アカウントユーザーに読み取り許可を付与するには、次の値を入力します: `"quicksight:DescribeTopic"` アカウントユーザーにアクセス許可を付与するには、次の値を入力します:
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

`RevokePermissions` パラメータは、アカウントユーザーに付与されているすべての許可を取り消します。

次のコマンドは、トピックからのすべてのアクセス許可を記述します。

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

Quick Sight トピックを作成したら、Amazon Quick Sight APIs を使用して[トピックの更新スケジュールを設定し](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis)、[Quick Sight トピックをアカウント内またはアカウント間で移行](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs)し、[レビュー済みの回答を作成できます](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis)。