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'
)
The type of connector, such as Salesforce, Amplitude, and so on.
dict
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.
supportedSchedulingFrequencies (list) --
Specifies the supported flow frequency for that connector.
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.
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.
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.
dataTransferApis (list) --
The Salesforce APIs that you can have Amazon AppFlow use when your flows transfers data to or from Salesforce.
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.
Snowflake (dict) --
The connector metadata specific to Snowflake.
supportedRegions (list) --
Specifies the supported Amazon Web Services Regions when using Snowflake.
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.
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.
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.
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.
tokenUrls (list) --
Token URLs that can be used for OAuth 2.0 authentication.
authCodeUrls (list) --
Auth code URLs that can be used for OAuth 2.0 authentication.
oauth2GrantTypesSupported (list) --
OAuth 2.0 grant types supported by the connector.
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.
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.
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.
supportedApiVersions (list) --
A list of API versions that are supported by the connector.
supportedOperators (list) --
A list of operators supported by the connector.
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.
nextToken (string) --
The pagination token for the next page of data.
Exceptions
Appflow.Client.exceptions.ValidationExceptionAppflow.Client.exceptions.InternalServerException