Appflow / Client / describe_connector_entity

describe_connector_entity

Appflow.Client.describe_connector_entity(**kwargs)

Provides details regarding the entity used with the connector, with a description of the data model for each field in that entity.

See also: AWS API Documentation

Request Syntax

response = client.describe_connector_entity(
    connectorEntityName='string',
    connectorType='Salesforce'|'Singular'|'Slack'|'Redshift'|'S3'|'Marketo'|'Googleanalytics'|'Zendesk'|'Servicenow'|'Datadog'|'Trendmicro'|'Snowflake'|'Dynatrace'|'Infornexus'|'Amplitude'|'Veeva'|'EventBridge'|'LookoutMetrics'|'Upsolver'|'Honeycode'|'CustomerProfiles'|'SAPOData'|'CustomConnector'|'Pardot',
    connectorProfileName='string',
    apiVersion='string'
)

Parameters:

• connectorEntityName (string) –

  [REQUIRED]

  The entity name for that connector.

• connectorType (string) – The type of connector application, such as Salesforce, Amplitude, and so on.

• connectorProfileName (string) – The name of the connector profile. The name is unique for each ConnectorProfile in the Amazon Web Services account.

• apiVersion (string) – The version of the API that’s used by the connector.

Return type:

dict

Returns:

Response Syntax

{
    'connectorEntityFields': [
        {
            'identifier': 'string',
            'parentIdentifier': 'string',
            'label': 'string',
            'isPrimaryKey': True|False,
            'defaultValue': 'string',
            'isDeprecated': True|False,
            'supportedFieldTypeDetails': {
                'v1': {
                    'fieldType': 'string',
                    'filterOperators': [
                        'PROJECTION'|'LESS_THAN'|'GREATER_THAN'|'CONTAINS'|'BETWEEN'|'LESS_THAN_OR_EQUAL_TO'|'GREATER_THAN_OR_EQUAL_TO'|'EQUAL_TO'|'NOT_EQUAL_TO'|'ADDITION'|'MULTIPLICATION'|'DIVISION'|'SUBTRACTION'|'MASK_ALL'|'MASK_FIRST_N'|'MASK_LAST_N'|'VALIDATE_NON_NULL'|'VALIDATE_NON_ZERO'|'VALIDATE_NON_NEGATIVE'|'VALIDATE_NUMERIC'|'NO_OP',
                    ],
                    'supportedValues': [
                        'string',
                    ],
                    'valueRegexPattern': 'string',
                    'supportedDateFormat': 'string',
                    'fieldValueRange': {
                        'maximum': 123.0,
                        'minimum': 123.0
                    },
                    'fieldLengthRange': {
                        'maximum': 123.0,
                        'minimum': 123.0
                    }
                }
            },
            'description': 'string',
            'sourceProperties': {
                'isRetrievable': True|False,
                'isQueryable': True|False,
                'isTimestampFieldForIncrementalQueries': True|False
            },
            'destinationProperties': {
                'isCreatable': True|False,
                'isNullable': True|False,
                'isUpsertable': True|False,
                'isUpdatable': True|False,
                'isDefaultedOnCreate': True|False,
                'supportedWriteOperations': [
                    'INSERT'|'UPSERT'|'UPDATE'|'DELETE',
                ]
            },
            'customProperties': {
                'string': 'string'
            }
        },
    ]
}

Response Structure

• (dict) –

  • connectorEntityFields (list) –

    Describes the fields for that connector entity. For example, for an account entity, the fields would be account name, account ID, and so on.

    • (dict) –

      Describes the data model of a connector field. For example, for an account entity, the fields would be account name, account ID, and so on.

      • identifier (string) –

        The unique identifier of the connector field.

      • parentIdentifier (string) –

        The parent identifier of the connector field.

      • label (string) –

        The label applied to a connector entity field.

      • isPrimaryKey (boolean) –

        Booelan value that indicates whether this field can be used as a primary key.

      • defaultValue (string) –

        Default value that can be assigned to this field.

      • isDeprecated (boolean) –

        Booelan value that indicates whether this field is deprecated or not.

      • supportedFieldTypeDetails (dict) –

        Contains details regarding the supported FieldType, including the corresponding filterOperators and supportedValues.

        • v1 (dict) –

          The initial supported version for fieldType. If this is later changed to a different version, v2 will be introduced.

          • fieldType (string) –

            The type of field, such as string, integer, date, and so on.

          • filterOperators (list) –

            The list of operators supported by a field.

            • (string) –

          • supportedValues (list) –

            The list of values that a field can contain. For example, a Boolean fieldType can have two values: “true” and “false”.

            • (string) –

          • valueRegexPattern (string) –

            The regular expression pattern for the field name.

          • supportedDateFormat (string) –

            The date format that the field supports.

          • fieldValueRange (dict) –

            The range of values this field can hold.

            • maximum (float) –

              Maximum value supported by the field.

            • minimum (float) –

              Minimum value supported by the field.

          • fieldLengthRange (dict) –

            This is the allowable length range for this field’s value.

            • maximum (float) –

              Maximum value supported by the field.

            • minimum (float) –

              Minimum value supported by the field.

      • description (string) –

        A description of the connector entity field.

      • sourceProperties (dict) –

        The properties that can be applied to a field when the connector is being used as a source.

        • isRetrievable (boolean) –

          Indicates whether the field can be returned in a search result.

        • isQueryable (boolean) –

          Indicates if the field can be queried.

        • isTimestampFieldForIncrementalQueries (boolean) –

          Indicates if this timestamp field can be used for incremental queries.

      • destinationProperties (dict) –

        The properties applied to a field when the connector is being used as a destination.

        • isCreatable (boolean) –

          Specifies if the destination field can be created by the current user.

        • isNullable (boolean) –

          Specifies if the destination field can have a null value.

        • isUpsertable (boolean) –

          Specifies if the flow run can either insert new rows in the destination field if they do not already exist, or update them if they do.

        • isUpdatable (boolean) –

          Specifies whether the field can be updated during an UPDATE or UPSERT write operation.

        • isDefaultedOnCreate (boolean) –

          Specifies whether the field can use the default value during a Create operation.

        • supportedWriteOperations (list) –

          A list of supported write operations. For each write operation listed, this field can be used in idFieldNames when that write operation is present as a destination option.

          • (string) –

            The possible write operations in the destination connector. When this value is not provided, this defaults to the INSERT operation.

      • customProperties (dict) –

        A map that has specific properties related to the ConnectorEntityField.

        • (string) –

          • (string) –

Exceptions

• Appflow.Client.exceptions.ValidationException

• Appflow.Client.exceptions.ResourceNotFoundException

• Appflow.Client.exceptions.ConnectorAuthenticationException

• Appflow.Client.exceptions.ConnectorServerException

• Appflow.Client.exceptions.InternalServerException