Skip to main content

q_app_permissions

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

Overview

Nameq_app_permissions
TypeResource
Idaws.qapps.q_app_permissions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
app_idstringThe unique identifier of the Amazon Q App for which permissions are returned.
permissionsarrayThe list of permissions granted for the Amazon Q App.
resource_arnstringThe Amazon Resource Name (ARN) of the Amazon Q App for which permissions are returned.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_q_app_permissionsselectinstance-id, appId, regionDescribes read permissions for a Amazon Q App in Amazon Q Business application environment instance.
update_q_app_permissionsupdateinstance-id, region, appIdUpdates read permissions for a Amazon Q App in Amazon Q Business application environment instance.

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
appIdstringThe unique identifier of the Amazon Q App for which to retrieve permissions.
instance-idstringThe unique identifier of the Amazon Q Business application environment instance.
regionstringAWS region (default: us-east-1)

SELECT examples

Describes read permissions for a Amazon Q App in Amazon Q Business application environment instance.

SELECT
app_id,
permissions,
resource_arn
FROM aws.qapps.q_app_permissions
WHERE `instance-id` = '{{ instance-id }}' -- required
AND appId = '{{ appId }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Updates read permissions for a Amazon Q App in Amazon Q Business application environment instance.

UPDATE aws.qapps.q_app_permissions
SET
appId = '{{ appId }}',
grantPermissions = '{{ grantPermissions }}',
revokePermissions = '{{ revokePermissions }}'
WHERE
`instance-id` = '{{ instance-id }}' --required
AND region = '{{ region }}' --required
AND appId = '{{ appId }}' --required
RETURNING
app_id,
permissions,
resource_arn;