QBusiness / Client / get_data_accessor

get_data_accessor

QBusiness.Client.get_data_accessor(**kwargs)

Retrieves information about a specified data accessor. This operation returns details about the data accessor, including its display name, unique identifier, Amazon Resource Name (ARN), the associated Amazon Q Business application and IAM Identity Center application, the IAM role for the ISV, the action configurations, and the timestamps for when the data accessor was created and last updated.

See also: AWS API Documentation

Request Syntax

response = client.get_data_accessor(
    applicationId='string',
    dataAccessorId='string'
)

Parameters:

• applicationId (string) –

  [REQUIRED]

  The unique identifier of the Amazon Q Business application.

• dataAccessorId (string) –

  [REQUIRED]

  The unique identifier of the data accessor to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'displayName': 'string',
    'dataAccessorId': 'string',
    'dataAccessorArn': 'string',
    'applicationId': 'string',
    'idcApplicationArn': 'string',
    'principal': 'string',
    'actionConfigurations': [
        {
            'action': 'string',
            'filterConfiguration': {
                'documentAttributeFilter': {
                    'andAllFilters': [
                        {'... recursive ...'},
                    ],
                    'orAllFilters': [
                        {'... recursive ...'},
                    ],
                    'notFilter': {'... recursive ...'},
                    'equalsTo': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'containsAll': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'containsAny': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'greaterThan': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'greaterThanOrEquals': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'lessThan': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    },
                    'lessThanOrEquals': {
                        'name': 'string',
                        'value': {
                            'stringValue': 'string',
                            'stringListValue': [
                                'string',
                            ],
                            'longValue': 123,
                            'dateValue': datetime(2015, 1, 1)
                        }
                    }
                }
            }
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) –

  • 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.

  • applicationId (string) –

    The unique identifier of the Amazon Q Business application associated with this data accessor.

  • idcApplicationArn (string) –

    The Amazon Resource Name (ARN) of the IAM Identity Center application associated with this data accessor.

  • principal (string) –

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

  • actionConfigurations (list) –

    The list of action configurations specifying the allowed actions and any associated filters.

    • (dict) –

      Specifies an allowed action and its associated filter configuration.

      • action (string) –

        The Amazon Q Business action that is allowed.

      • filterConfiguration (dict) –

        The filter configuration for the action, if any.

        • documentAttributeFilter (dict) –

          Enables filtering of responses based on document attributes or metadata fields.

          • andAllFilters (list) –

            Performs a logical AND operation on all supplied filters.

            • (dict) –

              Enables filtering of responses based on document attributes or metadata fields.

          • orAllFilters (list) –

            Performs a logical OR operation on all supplied filters.

            • (dict) –

              Enables filtering of responses based on document attributes or metadata fields.

          • notFilter (dict) –

            Performs a logical NOT operation on all supplied filters.

          • equalsTo (dict) –

            Performs an equals operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue, longValue, stringListValue and stringValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • containsAll (dict) –

            Returns true when a document contains all the specified document attributes or metadata fields. Supported for the following document attribute value types: stringListValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • containsAny (dict) –

            Returns true when a document contains any of the specified document attributes or metadata fields. Supported for the following document attribute value types: stringListValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • greaterThan (dict) –

            Performs a greater than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • greaterThanOrEquals (dict) –

            Performs a greater or equals than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • lessThan (dict) –

            Performs a less than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

          • lessThanOrEquals (dict) –

            Performs a less than or equals operation on two document attributes or metadata fields.Supported for the following document attribute value type: dateValue and longValue.

            • name (string) –

              The identifier for the attribute.

            • value (dict) –

              The value of the attribute.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: stringValue, stringListValue, longValue, dateValue. 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'}
              

              • stringValue (string) –

                A string.

              • stringListValue (list) –

                A list of strings.

                • (string) –

              • longValue (integer) –

                A long integer value.

              • dateValue (datetime) –

                A date expressed as an ISO 8601 string.

                It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.

  • createdAt (datetime) –

    The timestamp when the data accessor was created.

  • updatedAt (datetime) –

    The timestamp when the data accessor was last updated.

Exceptions

• QBusiness.Client.exceptions.InternalServerException

• QBusiness.Client.exceptions.ResourceNotFoundException

• QBusiness.Client.exceptions.ThrottlingException

• QBusiness.Client.exceptions.ValidationException

• QBusiness.Client.exceptions.AccessDeniedException