Uso de los temas de QuickSight Q mediante las API de QuickSight

En el siguiente ejemplo, se crea un nuevo tema de Q.

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

También puede crear un tema de Q nuevo mediante un archivo de esqueleto de la CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de la CLI, consulte Using CLI skeleton files en la Guía para desarrolladores de Amazon QuickSight.

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

Al crear un tema de Q nuevo, la configuración de actualización del conjunto de datos no se copia en el tema. Para establecer una programación de actualización del tema para su nuevo tema, puede realizar una llamada a la API create-topic-refresh-schedule. Para obtener más información acerca de la configuración de las programaciones de actualización de temas con la CLI, consulte Configuración de programaciones de actualización de temas de QuickSight Q con la CLI de QuickSight.

Tras crear el primer tema de Q, puede actualizarlo, eliminarlo, incluirlo en una lista o solicitar un resumen de este.

En el siguiente ejemplo, se actualiza un tema de Q.

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

También puede actualizar un tema de Q utilizando un archivo de esqueleto de la CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de la CLI, consulte Using CLI skeleton files en la Guía para desarrolladores de Amazon QuickSight.

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

En el siguiente ejemplo, se proporciona una lista de todos los temas de Q de una cuenta de QuickSight.

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

En el siguiente ejemplo, se borra un tema de Q.

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

En el siguiente ejemplo, se proporciona información sobre cómo se configuró un tema de Q.

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

El siguiente comando actualiza los permisos de un tema de 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

Utilice el parámetro grant-permissions para conceder permisos de lectura y autor a los usuarios de una cuenta de QuickSight. Para conceder permisos de lectura a un usuario de cuenta, introduzca el siguiente valor: "quicksight:DescribeTopic". Para conceder permisos a un usuario de cuenta, introduzca los siguientes valores:

El parámetro RevokePermissions revoca todos los permisos concedidos a un usuario de cuenta.

El siguiente comando describe todos los permisos de un tema de Q.

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

Tras crear un tema de QuickSight Q, podrá usar las API de Amazon QuickSight para configurar programaciones de actualización de temas, migrar los temas de QuickSight Q en cuentas o entre ellas y crear respuestas revisadas.