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 setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_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