describe_connector_entity

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