藉助 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"。若要向帳戶使用者授予許可，請輸入下列值：

RevokePermissions 參數會撤銷授予帳戶使用者的所有許可。

以下命令描述 Q 主題的所有許可。

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

建立 QuickSight Q 主題後，您可以使用 Amazon QuickSight API 來設定主題重新整理排程、在帳戶內或帳戶之間遷移 QuickSight Q 主題，以及建立已檢閱答案。