QBusiness / Client / list_data_accessors

list_data_accessors

QBusiness.Client.list_data_accessors(**kwargs)

Lists the data accessors for a Amazon Q Business application. This operation returns a paginated list of data accessor summaries, including the friendly name, unique identifier, ARN, associated IAM role, and creation/update timestamps for each data accessor.

See also: AWS API Documentation

Request Syntax

response = client.list_data_accessors(
    applicationId='string',
    nextToken='string',
    maxResults=123
)
Parameters:
  • applicationId (string) –

    [REQUIRED]

    The unique identifier of the Amazon Q Business application.

  • nextToken (string) – The token for the next set of results. (You received this token from a previous call.)

  • maxResults (integer) – The maximum number of results to return in a single call.

Return type:

dict

Returns:

Response Syntax

{
    'dataAccessors': [
        {
            'displayName': 'string',
            'dataAccessorId': 'string',
            'dataAccessorArn': 'string',
            'idcApplicationArn': 'string',
            'principal': 'string',
            'authenticationDetail': {
                'authenticationType': 'AWS_IAM_IDC_TTI'|'AWS_IAM_IDC_AUTH_CODE',
                'authenticationConfiguration': {
                    'idcTrustedTokenIssuerConfiguration': {
                        'idcTrustedTokenIssuerArn': 'string'
                    }
                },
                'externalIds': [
                    'string',
                ]
            },
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • dataAccessors (list) –

      The list of data accessors.

      • (dict) –

        Provides summary information about a data accessor.

        • displayName (string) –

          The friendly name of the data accessor.

        • dataAccessorId (string) –

          The unique identifier of the data accessor.

        • dataAccessorArn (string) –

          The Amazon Resource Name (ARN) of the data accessor.

        • idcApplicationArn (string) –

          The Amazon Resource Name (ARN) of the associated IAM Identity Center application.

        • principal (string) –

          The Amazon Resource Name (ARN) of the IAM role for the ISV associated with this data accessor.

        • authenticationDetail (dict) –

          The authentication configuration details for the data accessor. This specifies how the ISV authenticates when accessing data through this data accessor.

          • authenticationType (string) –

            The type of authentication to use for the data accessor. This determines how the ISV authenticates when accessing data. You can use one of two authentication types:

            • AWS_IAM_IDC_TTI - Authentication using IAM Identity Center Trusted Token Issuer (TTI). This authentication type allows the ISV to use a trusted token issuer to generate tokens for accessing the data.

            • AWS_IAM_IDC_AUTH_CODE - Authentication using IAM Identity Center authorization code flow. This authentication type uses the standard OAuth 2.0 authorization code flow for authentication.

          • authenticationConfiguration (dict) –

            The specific authentication configuration based on the authentication type.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: idcTrustedTokenIssuerConfiguration. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            
            • idcTrustedTokenIssuerConfiguration (dict) –

              Configuration for IAM Identity Center Trusted Token Issuer (TTI) authentication used when the authentication type is AWS_IAM_IDC_TTI.

              • idcTrustedTokenIssuerArn (string) –

                The Amazon Resource Name (ARN) of the IAM Identity Center Trusted Token Issuer that will be used for authentication.

          • externalIds (list) –

            A list of external identifiers associated with this authentication configuration. These are used to correlate the data accessor with external systems.

            • (string) –

        • createdAt (datetime) –

          The timestamp when the data accessor was created.

        • updatedAt (datetime) –

          The timestamp when the data accessor was last updated.

    • nextToken (string) –

      The token to use to retrieve the next set of results, if there are any.

Exceptions