QuickSight / Client / describe_action_connector_permissions

describe_action_connector_permissions

QuickSight.Client.describe_action_connector_permissions(**kwargs)

Retrieves the permissions configuration for an action connector, showing which users, groups, and namespaces have access and what operations they can perform.

See also: AWS API Documentation

Request Syntax

response = client.describe_action_connector_permissions(
    AwsAccountId='string',
    ActionConnectorId='string'
)
Parameters:
  • AwsAccountId (string) –

    [REQUIRED]

    The Amazon Web Services account ID that contains the action connector.

  • ActionConnectorId (string) –

    [REQUIRED]

    The unique identifier of the action connector whose permissions you want to describe.

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'ActionConnectorId': 'string',
    'Permissions': [
        {
            'Principal': 'string',
            'Actions': [
                'string',
            ]
        },
    ],
    'RequestId': 'string',
    'Status': 123
}

Response Structure

  • (dict) –

    • Arn (string) –

      The Amazon Resource Name (ARN) of the action connector.

    • ActionConnectorId (string) –

      The unique identifier of the action connector.

    • Permissions (list) –

      The list of permissions associated with the action connector, including the principals and their allowed actions.

      • (dict) –

        Permission for the resource.

        • Principal (string) –

          The Amazon Resource Name (ARN) of the principal. This can be one of the following:

          • The ARN of an Quick Sight user or group associated with a data source or dataset. (This is common.)

          • The ARN of an Quick Sight user, group, or namespace associated with an analysis, dashboard, template, or theme. Namespace sharing is not supported for action connectors. (This is common.)

          • The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a Quick Sight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. Account root sharing is not supported for action connectors. (This is less common.)

        • Actions (list) –

          The IAM action to grant or revoke permissions on.

          • (string) –

    • RequestId (string) –

      The Amazon Web Services request ID for this operation.

    • Status (integer) –

      The HTTP status code of the request.

Exceptions

  • QuickSight.Client.exceptions.ThrottlingException

  • QuickSight.Client.exceptions.InvalidParameterValueException

  • QuickSight.Client.exceptions.InternalFailureException

  • QuickSight.Client.exceptions.ResourceNotFoundException

  • QuickSight.Client.exceptions.AccessDeniedException