기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Quick Sight APIs를 사용하여 Quick Sight 주제 작업
<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
```

다음 예제에서는 Quick 계정의 모든 주제 목록을 제공합니다.

```
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) 수 있습니다.