Utilizzare gli argomenti QuickSight Q con le API QuickSight

Il seguente esempio crea un nuovo argomento Q.

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

È inoltre possibile aggiornare un nuovo argomento Q utilizzando un file scheletro della CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Utilizzo di file scheletro della CLI nella Guida per gli sviluppatori di Amazon QuickSight.

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

Quando crei un nuovo argomento Q, la configurazione di aggiornamento del set di dati non viene copiata nell'argomento. Per impostare una pianificazione di aggiornamento per il nuovo argomento, puoi effettuare una chiamata API create-topic-refresh-schedule. Per ulteriori informazioni sulla configurazione delle pianificazioni dell'aggiornamento degli argomenti con la CLI, consulta Configurare le pianificazioni di aggiornamento degli argomenti Q con la CLI di QuickSight.

Dopo aver creato il primo argomento Q, potrai aggiornare, eliminare, elencare o richiedere un riepilogo di un argomento Q.

Nell'esempio seguente viene aggiornato un argomento Q.

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

È inoltre possibile aggiornare un argomento Q utilizzando un file scheletro della CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Utilizzo di file scheletro della CLI nella Guida per gli sviluppatori di Amazon QuickSight.

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

L'esempio seguente fornisce un elenco di tutti gli argomenti Q in un account QuickSight.

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

L'esempio seguente mostra come eliminare un argomento Q.

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

L'esempio seguente fornisce informazioni su come è stata configurata la pianificazione dell'aggiornamento di un argomento.

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

Il comando seguente aggiorna le autorizzazioni di un argomento 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

Utilizza il parametro grant-permissions per concedere le autorizzazioni di lettura e autore agli utenti dell'account QuickSight. Per assegnare le autorizzazioni a un utente dell'account, immetti il seguente valore: "quicksight:DescribeTopic". Per assegnare le autorizzazioni a un utente dell'account, immetti i seguenti valori:

Il parametro RevokePermissions revoca tutte le autorizzazioni concesse a un utente dell'account.

Il comando seguente descrive tutte le autorizzazioni da un argomento Q.

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

Dopo aver creato un argomento QuickSight Q, puoi utilizzare le API di Amazon QuickSight per configurare una pianificazione di aggiornamento degli argomenti, migrare gli argomenti QuickSight Q all'interno o tra account e creare risposte revisionate.