Appflow / Client / describe_connectors

describe_connectors#

Appflow.Client.describe_connectors(**kwargs)#

Describes the connectors vended by Amazon AppFlow for specified connector types. If you don’t specify a connector type, this operation describes all connectors vended by Amazon AppFlow. If there are more connectors than can be returned in one page, the response contains a nextToken object, which can be be passed in to the next call to the DescribeConnectors API operation to retrieve the next page.

See also: AWS API Documentation

Request Syntax

response = client.describe_connectors(
    connectorTypes=[
        'Salesforce'|'Singular'|'Slack'|'Redshift'|'S3'|'Marketo'|'Googleanalytics'|'Zendesk'|'Servicenow'|'Datadog'|'Trendmicro'|'Snowflake'|'Dynatrace'|'Infornexus'|'Amplitude'|'Veeva'|'EventBridge'|'LookoutMetrics'|'Upsolver'|'Honeycode'|'CustomerProfiles'|'SAPOData'|'CustomConnector'|'Pardot',
    ],
    maxResults=123,
    nextToken='string'
)
Parameters:
  • connectorTypes (list) –

    The type of connector, such as Salesforce, Amplitude, and so on.

    • (string) –

  • maxResults (integer) – The maximum number of items that should be returned in the result set. The default is 20.

  • nextToken (string) – The pagination token for the next page of data.

Return type:

dict

Returns:

Response Syntax

{
    'connectorConfigurations': {
        'string': {
            'canUseAsSource': True|False,
            'canUseAsDestination': True|False,
            'supportedDestinationConnectors': [
                'Salesforce'|'Singular'|'Slack'|'Redshift'|'S3'|'Marketo'|'Googleanalytics'|'Zendesk'|'Servicenow'|'Datadog'|'Trendmicro'|'Snowflake'|'Dynatrace'|'Infornexus'|'Amplitude'|'Veeva'|'EventBridge'|'LookoutMetrics'|'Upsolver'|'Honeycode'|'CustomerProfiles'|'SAPOData'|'CustomConnector'|'Pardot',
            ],
            'supportedSchedulingFrequencies': [
                'BYMINUTE'|'HOURLY'|'DAILY'|'WEEKLY'|'MONTHLY'|'ONCE',
            ],
            'isPrivateLinkEnabled': True|False,
            'isPrivateLinkEndpointUrlRequired': True|False,
            'supportedTriggerTypes': [
                'Scheduled'|'Event'|'OnDemand',
            ],
            'connectorMetadata': {
                'Amplitude': {},
                'Datadog': {},
                'Dynatrace': {},
                'GoogleAnalytics': {
                    'oAuthScopes': [
                        'string',
                    ]
                },
                'InforNexus': {},
                'Marketo': {},
                'Redshift': {},
                'S3': {},
                'Salesforce': {
                    'oAuthScopes': [
                        'string',
                    ],
                    'dataTransferApis': [
                        'AUTOMATIC'|'BULKV2'|'REST_SYNC',
                    ]
                },
                'ServiceNow': {},
                'Singular': {},
                'Slack': {
                    'oAuthScopes': [
                        'string',
                    ]
                },
                'Snowflake': {
                    'supportedRegions': [
                        'string',
                    ]
                },
                'Trendmicro': {},
                'Veeva': {},
                'Zendesk': {
                    'oAuthScopes': [
                        'string',
                    ]
                },
                'EventBridge': {},
                'Upsolver': {},
                'CustomerProfiles': {},
                'Honeycode': {
                    'oAuthScopes': [
                        'string',
                    ]
                },
                'SAPOData': {},
                'Pardot': {}
            },
            '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',
            'connectorLabel': 'string',
            'connectorDescription': 'string',
            'connectorOwner': 'string',
            'connectorName': 'string',
            'connectorVersion': 'string',
            'connectorArn': 'string',
            'connectorModes': [
                'string',
            ],
            'authenticationConfig': {
                'isBasicAuthSupported': True|False,
                'isApiKeyAuthSupported': True|False,
                'isOAuth2Supported': True|False,
                'isCustomAuthSupported': True|False,
                'oAuth2Defaults': {
                    'oauthScopes': [
                        'string',
                    ],
                    'tokenUrls': [
                        'string',
                    ],
                    'authCodeUrls': [
                        'string',
                    ],
                    'oauth2GrantTypesSupported': [
                        'CLIENT_CREDENTIALS'|'AUTHORIZATION_CODE',
                    ],
                    'oauth2CustomProperties': [
                        {
                            'key': 'string',
                            'isRequired': True|False,
                            'label': 'string',
                            'description': 'string',
                            'isSensitiveField': True|False,
                            'connectorSuppliedValues': [
                                'string',
                            ],
                            'type': 'TOKEN_URL'|'AUTH_URL'
                        },
                    ]
                },
                'customAuthConfigs': [
                    {
                        'customAuthenticationType': 'string',
                        'authParameters': [
                            {
                                'key': 'string',
                                'isRequired': True|False,
                                'label': 'string',
                                'description': 'string',
                                'isSensitiveField': True|False,
                                'connectorSuppliedValues': [
                                    'string',
                                ]
                            },
                        ]
                    },
                ]
            },
            'connectorRuntimeSettings': [
                {
                    'key': 'string',
                    'dataType': 'string',
                    'isRequired': True|False,
                    'label': 'string',
                    'description': 'string',
                    'scope': 'string',
                    'connectorSuppliedValueOptions': [
                        'string',
                    ]
                },
            ],
            'supportedApiVersions': [
                'string',
            ],
            'supportedOperators': [
                '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',
            ],
            'supportedWriteOperations': [
                'INSERT'|'UPSERT'|'UPDATE'|'DELETE',
            ],
            'connectorProvisioningType': 'LAMBDA',
            'connectorProvisioningConfig': {
                'lambda': {
                    'lambdaArn': 'string'
                }
            },
            'logoURL': 'string',
            'registeredAt': datetime(2015, 1, 1),
            'registeredBy': 'string'
        }
    },
    'connectors': [
        {
            'connectorDescription': 'string',
            'connectorName': 'string',
            'connectorOwner': 'string',
            'connectorVersion': 'string',
            'applicationType': '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',
            'connectorLabel': 'string',
            'registeredAt': datetime(2015, 1, 1),
            'registeredBy': 'string',
            'connectorProvisioningType': 'LAMBDA',
            'connectorModes': [
                'string',
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • connectorConfigurations (dict) –

      The configuration that is applied to the connectors used in the flow.

      • (string) –

        • (dict) –

          The configuration settings related to a given connector.

          • canUseAsSource (boolean) –

            Specifies whether the connector can be used as a source.

          • canUseAsDestination (boolean) –

            Specifies whether the connector can be used as a destination.

          • supportedDestinationConnectors (list) –

            Lists the connectors that are available for use as destinations.

            • (string) –

          • supportedSchedulingFrequencies (list) –

            Specifies the supported flow frequency for that connector.

            • (string) –

          • isPrivateLinkEnabled (boolean) –

            Specifies if PrivateLink is enabled for that connector.

          • isPrivateLinkEndpointUrlRequired (boolean) –

            Specifies if a PrivateLink endpoint URL is required.

          • supportedTriggerTypes (list) –

            Specifies the supported trigger types for the flow.

            • (string) –

          • connectorMetadata (dict) –

            Specifies connector-specific metadata such as oAuthScopes, supportedRegions, privateLinkServiceUrl, and so on.

            • Amplitude (dict) –

              The connector metadata specific to Amplitude.

            • Datadog (dict) –

              The connector metadata specific to Datadog.

            • Dynatrace (dict) –

              The connector metadata specific to Dynatrace.

            • GoogleAnalytics (dict) –

              The connector metadata specific to Google Analytics.

              • oAuthScopes (list) –

                The desired authorization scope for the Google Analytics account.

                • (string) –

            • InforNexus (dict) –

              The connector metadata specific to Infor Nexus.

            • Marketo (dict) –

              The connector metadata specific to Marketo.

            • Redshift (dict) –

              The connector metadata specific to Amazon Redshift.

            • S3 (dict) –

              The connector metadata specific to Amazon S3.

            • Salesforce (dict) –

              The connector metadata specific to Salesforce.

              • oAuthScopes (list) –

                The desired authorization scope for the Salesforce account.

                • (string) –

              • dataTransferApis (list) –

                The Salesforce APIs that you can have Amazon AppFlow use when your flows transfers data to or from Salesforce.

                • (string) –

            • ServiceNow (dict) –

              The connector metadata specific to ServiceNow.

            • Singular (dict) –

              The connector metadata specific to Singular.

            • Slack (dict) –

              The connector metadata specific to Slack.

              • oAuthScopes (list) –

                The desired authorization scope for the Slack account.

                • (string) –

            • Snowflake (dict) –

              The connector metadata specific to Snowflake.

              • supportedRegions (list) –

                Specifies the supported Amazon Web Services Regions when using Snowflake.

                • (string) –

            • Trendmicro (dict) –

              The connector metadata specific to Trend Micro.

            • Veeva (dict) –

              The connector metadata specific to Veeva.

            • Zendesk (dict) –

              The connector metadata specific to Zendesk.

              • oAuthScopes (list) –

                The desired authorization scope for the Zendesk account.

                • (string) –

            • EventBridge (dict) –

              The connector metadata specific to Amazon EventBridge.

            • Upsolver (dict) –

              The connector metadata specific to Upsolver.

            • CustomerProfiles (dict) –

              The connector metadata specific to Amazon Connect Customer Profiles.

            • Honeycode (dict) –

              The connector metadata specific to Amazon Honeycode.

              • oAuthScopes (list) –

                The desired authorization scope for the Amazon Honeycode account.

                • (string) –

            • SAPOData (dict) –

              The connector metadata specific to SAPOData.

            • Pardot (dict) –

              The connector metadata specific to Salesforce Pardot.

          • connectorType (string) –

            The connector type.

          • connectorLabel (string) –

            The label used for registering the connector.

          • connectorDescription (string) –

            A description about the connector.

          • connectorOwner (string) –

            The owner who developed the connector.

          • connectorName (string) –

            The connector name.

          • connectorVersion (string) –

            The connector version.

          • connectorArn (string) –

            The Amazon Resource Name (ARN) for the registered connector.

          • connectorModes (list) –

            The connection modes that the connector supports.

            • (string) –

          • authenticationConfig (dict) –

            The authentication config required for the connector.

            • isBasicAuthSupported (boolean) –

              Indicates whether basic authentication is supported by the connector.

            • isApiKeyAuthSupported (boolean) –

              Indicates whether API key authentication is supported by the connector

            • isOAuth2Supported (boolean) –

              Indicates whether OAuth 2.0 authentication is supported by the connector.

            • isCustomAuthSupported (boolean) –

              Indicates whether custom authentication is supported by the connector

            • oAuth2Defaults (dict) –

              Contains the default values required for OAuth 2.0 authentication.

              • oauthScopes (list) –

                OAuth 2.0 scopes that the connector supports.

                • (string) –

              • tokenUrls (list) –

                Token URLs that can be used for OAuth 2.0 authentication.

                • (string) –

              • authCodeUrls (list) –

                Auth code URLs that can be used for OAuth 2.0 authentication.

                • (string) –

              • oauth2GrantTypesSupported (list) –

                OAuth 2.0 grant types supported by the connector.

                • (string) –

              • oauth2CustomProperties (list) –

                List of custom parameters required for OAuth 2.0 authentication.

                • (dict) –

                  Custom parameter required for OAuth 2.0 authentication.

                  • key (string) –

                    The key of the custom parameter required for OAuth 2.0 authentication.

                  • isRequired (boolean) –

                    Indicates whether the custom parameter for OAuth 2.0 authentication is required.

                  • label (string) –

                    The label of the custom parameter used for OAuth 2.0 authentication.

                  • description (string) –

                    A description about the custom parameter used for OAuth 2.0 authentication.

                  • isSensitiveField (boolean) –

                    Indicates whether this authentication custom parameter is a sensitive field.

                  • connectorSuppliedValues (list) –

                    Contains default values for this authentication parameter that are supplied by the connector.

                    • (string) –

                  • type (string) –

                    Indicates whether custom parameter is used with TokenUrl or AuthUrl.

            • customAuthConfigs (list) –

              Contains information required for custom authentication.

              • (dict) –

                Configuration information required for custom authentication.

                • customAuthenticationType (string) –

                  The authentication type that the custom connector uses.

                • authParameters (list) –

                  Information about authentication parameters required for authentication.

                  • (dict) –

                    Information about required authentication parameters.

                    • key (string) –

                      The authentication key required to authenticate with the connector.

                    • isRequired (boolean) –

                      Indicates whether this authentication parameter is required.

                    • label (string) –

                      Label used for authentication parameter.

                    • description (string) –

                      A description about the authentication parameter.

                    • isSensitiveField (boolean) –

                      Indicates whether this authentication parameter is a sensitive field.

                    • connectorSuppliedValues (list) –

                      Contains default values for this authentication parameter that are supplied by the connector.

                      • (string) –

          • connectorRuntimeSettings (list) –

            The required connector runtime settings.

            • (dict) –

              Contains information about the connector runtime settings that are required for flow execution.

              • key (string) –

                Contains value information about the connector runtime setting.

              • dataType (string) –

                Data type of the connector runtime setting.

              • isRequired (boolean) –

                Indicates whether this connector runtime setting is required.

              • label (string) –

                A label used for connector runtime setting.

              • description (string) –

                A description about the connector runtime setting.

              • scope (string) –

                Indicates the scope of the connector runtime setting.

              • connectorSuppliedValueOptions (list) –

                Contains default values for the connector runtime setting that are supplied by the connector.

                • (string) –

          • supportedApiVersions (list) –

            A list of API versions that are supported by the connector.

            • (string) –

          • supportedOperators (list) –

            A list of operators supported by the connector.

            • (string) –

          • supportedWriteOperations (list) –

            A list of write operations supported by the connector.

            • (string) –

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

          • connectorProvisioningType (string) –

            The provisioning type used to register the connector.

          • connectorProvisioningConfig (dict) –

            The configuration required for registering the connector.

            • lambda (dict) –

              Contains information about the configuration of the lambda which is being registered as the connector.

              • lambdaArn (string) –

                Lambda ARN of the connector being registered.

          • logoURL (string) –

            Logo URL of the connector.

          • registeredAt (datetime) –

            The date on which the connector was registered.

          • registeredBy (string) –

            Information about who registered the connector.

    • connectors (list) –

      Information about the connectors supported in Amazon AppFlow.

      • (dict) –

        Information about the registered connector.

        • connectorDescription (string) –

          A description about the registered connector.

        • connectorName (string) –

          The name of the connector.

        • connectorOwner (string) –

          The owner of the connector.

        • connectorVersion (string) –

          The connector version.

        • applicationType (string) –

          The application type of the connector.

        • connectorType (string) –

          The connector type.

        • connectorLabel (string) –

          A label used for the connector.

        • registeredAt (datetime) –

          The time at which the connector was registered.

        • registeredBy (string) –

          The user who registered the connector.

        • connectorProvisioningType (string) –

          The provisioning type that the connector uses.

        • connectorModes (list) –

          The connection mode that the connector supports.

          • (string) –

    • nextToken (string) –

      The pagination token for the next page of data.

Exceptions

  • Appflow.Client.exceptions.ValidationException

  • Appflow.Client.exceptions.InternalServerException