Skip to main content

analysis_permissions

Creates, updates, deletes, gets or lists an analysis_permissions resource.

Overview

Nameanalysis_permissions
TypeResource
Idaws.quicksight.analysis_permissions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
analysis_arnstringThe Amazon Resource Name (ARN) of the analysis whose permissions you're describing.
analysis_idstringThe ID of the analysis whose permissions you're describing. (pattern: <code>[\w-]+</code>)
permissionsarrayA structure that describes the principals and the resource-level permissions on an analysis.
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_analysis_permissionsselectaws_account_id, analysis_id, regionProvides the read and write permissions for an analysis.
update_analysis_permissionsupdateaws_account_id, analysis_id, regionUpdates the read and write permissions for an analysis.

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
analysis_idstringThe ID of the analysis whose permissions you're updating. The ID is part of the analysis URL.
aws_account_idstringThe ID of the Amazon Web Services account that contains the analysis whose permissions you're updating. You must be using the Amazon Web Services account that the analysis is in.
regionstringAWS region (default: us-east-1)

SELECT examples

Provides the read and write permissions for an analysis.

SELECT
analysis_arn,
analysis_id,
permissions,
request_id,
status
FROM aws.quicksight.analysis_permissions
WHERE aws_account_id = '{{ aws_account_id }}' -- required
AND analysis_id = '{{ analysis_id }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Updates the read and write permissions for an analysis.

UPDATE aws.quicksight.analysis_permissions
SET
GrantPermissions = '{{ GrantPermissions }}',
RevokePermissions = '{{ RevokePermissions }}'
WHERE
aws_account_id = '{{ aws_account_id }}' --required
AND analysis_id = '{{ analysis_id }}' --required
AND region = '{{ region }}' --required
RETURNING
analysis_arn,
analysis_id,
permissions,
request_id,
status;