Utilisation des rubriques QuickSight Q à l'aide des API QuickSight

L'exemple suivant crée une nouvelle rubrique Q.

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

Vous pouvez également créer une nouvelle rubrique Q en utilisant un fichier squelette CLI à l'aide de la commande suivante. Pour plus d'informations sur les fichiers squelettes CLI, consultez Utilisation des fichiers squelettes CLI dans le Guide du développeur Amazon QuickSight.

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

Lorsque vous créez une nouvelle rubrique Q, la configuration de rafraîchissement du jeu de données n'est pas copiée dans la rubrique. Pour définir un calendrier de rafraîchissement des rubriques pour votre nouvelle rubrique, vous pouvez effectuer un appel d'API create-topic-refresh-schedule. Pour plus d'informations sur la configuration des calendriers de rafraîchissement des rubriques avec la CLI, consultez la rubrique Configuration des calendriers d'actualisation des rubriques Q à l'aide de QuickSight CLI.

Après avoir créé votre première rubrique Q, vous pouvez mettre à jour, supprimer, répertorier ou demander un résumé d'une rubrique Q.

L'exemple suivant met à jour une rubrique Q.

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

Vous pouvez également mettre à jour une rubrique Q en utilisant un fichier squelette CLI avec la commande suivante. Pour plus d'informations sur les fichiers squelettes CLI, consultez Utilisation des fichiers squelettes CLI dans le Guide du développeur Amazon QuickSight.

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

L'exemple suivant fournit une liste de toutes les rubriques Q d'un compte QuickSight.

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

L'exemple suivant supprime une rubrique Q.

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

L'exemple suivant fournit des informations sur la configuration d'une rubrique Q.

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

La commande suivante met à jour les autorisations d'une rubrique 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

Utilisez le paramètre grant-permissions pour accorder des autorisations de lecture et d'auteur aux utilisateurs du compte QuickSight. Pour accorder des autorisations de lecture à un utilisateur de compte, saisissez la valeur suivante : "quicksight:DescribeTopic". Pour accorder des autorisations à un utilisateur de compte, entrez les valeurs suivantes :

Le paramètre RevokePermissions révoque toutes les autorisations accordées à un utilisateur de compte.

La commande suivante décrit toutes les autorisations d'une rubrique Q.

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

Après avoir créé une rubrique QuickSight Q, vous pouvez utiliser les API Amazon QuickSight pour configurer un calendrier d'actualisation des rubriques, migrer les rubriques QuickSight Q au sein des comptes ou entre eux, et créer des réponses révisées.