Skip to main content

data_set_permissions

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

Overview

Namedata_set_permissions
TypeResource
Idaws.quicksight.data_set_permissions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
data_set_arnstringThe Amazon Resource Name (ARN) of the dataset.
data_set_idstringThe ID for the dataset that you want to describe. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.
permissionsarrayA list of resource permissions on the dataset.
request_idstringThe Amazon Web Services request ID for this operation.
statusintegerThe HTTP status of the request.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_data_set_permissionsselectaws_account_id, data_set_id, regionDescribes the permissions on a dataset. The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.
update_data_set_permissionsupdateaws_account_id, data_set_id, regionUpdates the permissions on a dataset. The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

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 Amazon Web Services account ID.
data_set_idstringThe ID for the dataset whose permissions you want to update. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.
regionstringAWS region (default: us-east-1)

SELECT examples

Describes the permissions on a dataset. The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

SELECT
data_set_arn,
data_set_id,
permissions,
request_id,
status
FROM aws.quicksight.data_set_permissions
WHERE aws_account_id = '{{ aws_account_id }}' -- required
AND data_set_id = '{{ data_set_id }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Updates the permissions on a dataset. The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

UPDATE aws.quicksight.data_set_permissions
SET
GrantPermissions = '{{ GrantPermissions }}',
RevokePermissions = '{{ RevokePermissions }}'
WHERE
aws_account_id = '{{ aws_account_id }}' --required
AND data_set_id = '{{ data_set_id }}' --required
AND region = '{{ region }}' --required
RETURNING
data_set_arn,
data_set_id,
request_id,
status;