Skip to main content

topic_permissions

Creates, updates, deletes, gets or lists a topic_permissions resource.

Overview​

Nametopic_permissions
TypeResource
Idaws.quicksight.topic_permissions

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
permissionsarrayA list of resource permissions that are configured to the topic.
request_idstringThe Amazon Web Services request ID for this operation.
statusintegerThe HTTP status of the request.
topic_arnstringThe Amazon Resource Name (ARN) of the topic.
topic_idstringThe ID of the topic that you want to describe. This ID is unique per Amazon Web Services Region for each Amazon Web Services account. (pattern: <code>^[A-Za-z0-9-_.\+]*$</code>)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_topic_permissionsselectaws_account_id, topic_id, regionDescribes the permissions of a topic.
update_topic_permissionsupdateaws_account_id, topic_id, regionUpdates the permissions of a topic.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
aws_account_idstringThe ID of the Amazon Web Services account that contains the topic that you want to update the permissions for.
regionstringAWS region (default: us-east-1)
topic_idstringThe ID of the topic that you want to modify. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.

SELECT examples​

Describes the permissions of a topic.

SELECT
permissions,
request_id,
status,
topic_arn,
topic_id
FROM aws.quicksight.topic_permissions
WHERE aws_account_id = '{{ aws_account_id }}' -- required
AND topic_id = '{{ topic_id }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples​

Updates the permissions of a topic.

UPDATE aws.quicksight.topic_permissions
SET
GrantPermissions = '{{ GrantPermissions }}',
RevokePermissions = '{{ RevokePermissions }}'
WHERE
aws_account_id = '{{ aws_account_id }}' --required
AND topic_id = '{{ topic_id }}' --required
AND region = '{{ region }}' --required
RETURNING
permissions,
request_id,
status,
topic_arn,
topic_id;