QuickSight API를 사용하여 QuickSight Q 주제 작업 - Amazon QuickSight

QuickSight API를 사용하여 QuickSight Q 주제 작업

다음 예에서는 새 Q 주제를 생성합니다.

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

다음 명령으로 CLI 스켈레톤 파일을 사용하여 새 Q 주제를 생성할 수도 있습니다. CLI 스켈레톤 파일에 대한 자세한 내용은 Amazon QuickSight 개발자 안내서의 CLI 스켈레톤 파일 사용을 참조하세요.

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

새 Q 주제를 생성할 때 데이터 세트 새로 고침 구성은 주제에 복사되지 않습니다. 새 주제에 대한 주제 새로 고침 일정을 설정하려면 create-topic-refresh-schedule API 호출을 만듭니다. CLI를 사용하여 주제 새로 고침 일정을 구성하는 방법에 대한 자세한 내용은 QuickSight CLI를 사용하여 QuickSight Q 주제 새로 고침 일정 구성 섹션을 참조하세요.

첫 번째 Q 주제를 생성한 후 Q 주제를 업데이트, 삭제, 나열 또는 요약을 요청할 수 있습니다.

다음 예에서는 Q 주제를 업데이트합니다.

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

다음 명령으로 CLI 스켈레톤 파일을 사용하여 Q 주제를 업데이트할 수도 있습니다. CLI 스켈레톤 파일에 대한 자세한 내용은 Amazon QuickSight 개발자 안내서의 CLI 스켈레톤 파일 사용을 참조하세요.

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

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

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

다음 예에서는 Q 주제를 삭제합니다.

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

다음 예에서는 Q 주제가 구성된 방법에 대한 정보를 제공합니다.

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

다음 명령은 Q 주제의 권한을 업데이트합니다.

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 계정 사용자에게 읽기 및 작성자 권한을 부여할 수 있습니다. 계정 사용자에게 읽기 권한을 부여하려면 다음 "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 파라미터는 계정 사용자에게 부여된 모든 권한을 취소합니다.

다음 명령은 Q 주제의 모든 권한을 설명합니다.

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

QuickSight Q 주제를 생성한 후 Amazon QuickSight API를 사용하여 주제 새로 고침 일정을 구성하고, 계정 내 또는 계정 간에 QuickSight Q 주제를 마이그레이션하며, 검토된 답변을 생성할 수 있습니다.