Skip to main content

role_custom_permissions

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

Overview

Namerole_custom_permissions
TypeResource
Idaws.quicksight.role_custom_permissions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
custom_permissions_namestringThe name of the custom permission that is described. (pattern: <code>^[a-zA-Z0-9+=,.@_-]+$</code>)
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_role_custom_permissionselectrole, aws_account_id, namespace, regionDescribes all custom permissions that are mapped to a role.
update_role_custom_permissionupdaterole, aws_account_id, namespace, region, CustomPermissionsNameUpdates the custom permissions that are associated with a role.
delete_role_custom_permissiondeleterole, aws_account_id, namespace, regionRemoves custom permissions from the role.

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 for the Amazon Web Services account that the group is in. Currently, you use the ID for the Amazon Web Services account that contains your Amazon Quick Sight account.
namespacestringThe namespace that includes the role.
regionstringAWS region (default: us-east-1)
rolestringThe role that you want to remove permissions from.

SELECT examples

Describes all custom permissions that are mapped to a role.

SELECT
custom_permissions_name,
request_id,
status
FROM aws.quicksight.role_custom_permissions
WHERE role = '{{ role }}' -- required
AND aws_account_id = '{{ aws_account_id }}' -- required
AND namespace = '{{ namespace }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Updates the custom permissions that are associated with a role.

UPDATE aws.quicksight.role_custom_permissions
SET
CustomPermissionsName = '{{ CustomPermissionsName }}'
WHERE
role = '{{ role }}' --required
AND aws_account_id = '{{ aws_account_id }}' --required
AND namespace = '{{ namespace }}' --required
AND region = '{{ region }}' --required
AND CustomPermissionsName = '{{ CustomPermissionsName }}' --required
RETURNING
request_id,
status;

DELETE examples

Removes custom permissions from the role.

DELETE FROM aws.quicksight.role_custom_permissions
WHERE role = '{{ role }}' --required
AND aws_account_id = '{{ aws_account_id }}' --required
AND namespace = '{{ namespace }}' --required
AND region = '{{ region }}' --required
;