{ "version": "2.0", "metadata": { "apiVersion": "2020-08-23", "endpointPrefix": "appflow", "jsonVersion": "1.1", "protocol": "rest-json", "serviceFullName": "Amazon Appflow", "serviceId": "Appflow", "signatureVersion": "v4", "signingName": "appflow", "uid": "appflow-2020-08-23" }, "operations": { "CancelFlowExecutions": { "name": "CancelFlowExecutions", "http": { "method": "POST", "requestUri": "/cancel-flow-executions" }, "input": { "shape": "CancelFlowExecutionsRequest" }, "output": { "shape": "CancelFlowExecutionsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "AccessDeniedException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ThrottlingException" }, { "shape": "InternalServerException" } ], "documentation": "
Cancels active runs for a flow.
You can cancel all of the active runs for a flow, or you can cancel specific runs by providing their IDs.
You can cancel a flow run only when the run is in progress. You can't cancel a run that has already completed or failed. You also can't cancel a run that's scheduled to occur but hasn't started yet. To prevent a scheduled run, you can deactivate the flow with the StopFlow
action.
You cannot resume a run after you cancel it.
When you send your request, the status for each run becomes CancelStarted
. When the cancellation completes, the status becomes Canceled
.
When you cancel a run, you still incur charges for any data that the run already processed before the cancellation. If the run had already written some data to the flow destination, then that data remains in the destination. If you configured the flow to use a batch API (such as the Salesforce Bulk API 2.0), then the run will finish reading or writing its entire batch of data after the cancellation. For these operations, the data processing charges for Amazon AppFlow apply. For the pricing information, see Amazon AppFlow pricing.
Creates a new connector profile associated with your Amazon Web Services account. There is a soft quota of 100 connector profiles per Amazon Web Services account. If you need more connector profiles than this quota allows, you can submit a request to the Amazon AppFlow team through the Amazon AppFlow support channel. In each connector profile that you create, you can provide the credentials and properties for only one connector.
" }, "CreateFlow": { "name": "CreateFlow", "http": { "method": "POST", "requestUri": "/create-flow" }, "input": { "shape": "CreateFlowRequest" }, "output": { "shape": "CreateFlowResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" }, { "shape": "ConnectorAuthenticationException" }, { "shape": "ConnectorServerException" }, { "shape": "AccessDeniedException" } ], "documentation": "Enables your application to create a new flow using Amazon AppFlow. You must create a connector profile before calling this API. Please note that the Request Syntax below shows syntax for multiple destinations, however, you can only transfer data to one item in this list at a time. Amazon AppFlow does not currently support flows to multiple destinations at once.
" }, "DeleteConnectorProfile": { "name": "DeleteConnectorProfile", "http": { "method": "POST", "requestUri": "/delete-connector-profile" }, "input": { "shape": "DeleteConnectorProfileRequest" }, "output": { "shape": "DeleteConnectorProfileResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" } ], "documentation": "Enables you to delete an existing connector profile.
" }, "DeleteFlow": { "name": "DeleteFlow", "http": { "method": "POST", "requestUri": "/delete-flow" }, "input": { "shape": "DeleteFlowRequest" }, "output": { "shape": "DeleteFlowResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" } ], "documentation": "Enables your application to delete an existing flow. Before deleting the flow, Amazon AppFlow validates the request by checking the flow configuration and status. You can delete flows one at a time.
" }, "DescribeConnector": { "name": "DescribeConnector", "http": { "method": "POST", "requestUri": "/describe-connector" }, "input": { "shape": "DescribeConnectorRequest" }, "output": { "shape": "DescribeConnectorResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ResourceNotFoundException" } ], "documentation": "Describes the given custom connector registered in your Amazon Web Services account. This API can be used for custom connectors that are registered in your account and also for Amazon authored connectors.
" }, "DescribeConnectorEntity": { "name": "DescribeConnectorEntity", "http": { "method": "POST", "requestUri": "/describe-connector-entity" }, "input": { "shape": "DescribeConnectorEntityRequest" }, "output": { "shape": "DescribeConnectorEntityResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ConnectorAuthenticationException" }, { "shape": "ConnectorServerException" }, { "shape": "InternalServerException" } ], "documentation": "Provides details regarding the entity used with the connector, with a description of the data model for each field in that entity.
" }, "DescribeConnectorProfiles": { "name": "DescribeConnectorProfiles", "http": { "method": "POST", "requestUri": "/describe-connector-profiles" }, "input": { "shape": "DescribeConnectorProfilesRequest" }, "output": { "shape": "DescribeConnectorProfilesResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": " Returns a list of connector-profile
details matching the provided connector-profile
names and connector-types
. Both input lists are optional, and you can use them to filter the result.
If no names or connector-types
are provided, returns all connector profiles in a paginated form. If there is no match, this operation returns an empty list.
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.
Provides a description of the specified flow.
" }, "DescribeFlowExecutionRecords": { "name": "DescribeFlowExecutionRecords", "http": { "method": "POST", "requestUri": "/describe-flow-execution-records" }, "input": { "shape": "DescribeFlowExecutionRecordsRequest" }, "output": { "shape": "DescribeFlowExecutionRecordsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" } ], "documentation": "Fetches the execution history of the flow.
" }, "ListConnectorEntities": { "name": "ListConnectorEntities", "http": { "method": "POST", "requestUri": "/list-connector-entities" }, "input": { "shape": "ListConnectorEntitiesRequest" }, "output": { "shape": "ListConnectorEntitiesResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ConnectorAuthenticationException" }, { "shape": "ConnectorServerException" }, { "shape": "InternalServerException" } ], "documentation": "Returns the list of available connector entities supported by Amazon AppFlow. For example, you can query Salesforce for Account and Opportunity entities, or query ServiceNow for the Incident entity.
" }, "ListConnectors": { "name": "ListConnectors", "http": { "method": "POST", "requestUri": "/list-connectors" }, "input": { "shape": "ListConnectorsRequest" }, "output": { "shape": "ListConnectorsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "Returns the list of all registered custom connectors in your Amazon Web Services account. This API lists only custom connectors registered in this account, not the Amazon Web Services authored connectors.
" }, "ListFlows": { "name": "ListFlows", "http": { "method": "POST", "requestUri": "/list-flows" }, "input": { "shape": "ListFlowsRequest" }, "output": { "shape": "ListFlowsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "Lists all of the flows associated with your account.
" }, "ListTagsForResource": { "name": "ListTagsForResource", "http": { "method": "GET", "requestUri": "/tags/{resourceArn}" }, "input": { "shape": "ListTagsForResourceRequest" }, "output": { "shape": "ListTagsForResourceResponse" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" } ], "documentation": "Retrieves the tags that are associated with a specified flow.
" }, "RegisterConnector": { "name": "RegisterConnector", "http": { "method": "POST", "requestUri": "/register-connector" }, "input": { "shape": "RegisterConnectorRequest" }, "output": { "shape": "RegisterConnectorResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ConflictException" }, { "shape": "AccessDeniedException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ThrottlingException" }, { "shape": "InternalServerException" }, { "shape": "ConnectorServerException" }, { "shape": "ConnectorAuthenticationException" } ], "documentation": "Registers a new custom connector with your Amazon Web Services account. Before you can register the connector, you must deploy the associated AWS lambda function in your account.
" }, "ResetConnectorMetadataCache": { "name": "ResetConnectorMetadataCache", "http": { "method": "POST", "requestUri": "/reset-connector-metadata-cache" }, "input": { "shape": "ResetConnectorMetadataCacheRequest" }, "output": { "shape": "ResetConnectorMetadataCacheResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" } ], "documentation": "Resets metadata about your connector entities that Amazon AppFlow stored in its cache. Use this action when you want Amazon AppFlow to return the latest information about the data that you have in a source application.
Amazon AppFlow returns metadata about your entities when you use the ListConnectorEntities or DescribeConnectorEntities actions. Following these actions, Amazon AppFlow caches the metadata to reduce the number of API requests that it must send to the source application. Amazon AppFlow automatically resets the cache once every hour, but you can use this action when you want to get the latest metadata right away.
" }, "StartFlow": { "name": "StartFlow", "http": { "method": "POST", "requestUri": "/start-flow" }, "input": { "shape": "StartFlowRequest" }, "output": { "shape": "StartFlowResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" } ], "documentation": "Activates an existing flow. For on-demand flows, this operation runs the flow immediately. For schedule and event-triggered flows, this operation activates the flow.
" }, "StopFlow": { "name": "StopFlow", "http": { "method": "POST", "requestUri": "/stop-flow" }, "input": { "shape": "StopFlowRequest" }, "output": { "shape": "StopFlowResponse" }, "errors": [ { "shape": "ConflictException" }, { "shape": "ResourceNotFoundException" }, { "shape": "UnsupportedOperationException" }, { "shape": "InternalServerException" } ], "documentation": " Deactivates the existing flow. For on-demand flows, this operation returns an unsupportedOperationException
error message. For schedule and event-triggered flows, this operation deactivates the flow.
Applies a tag to the specified flow.
" }, "UnregisterConnector": { "name": "UnregisterConnector", "http": { "method": "POST", "requestUri": "/unregister-connector" }, "input": { "shape": "UnregisterConnectorRequest" }, "output": { "shape": "UnregisterConnectorResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" } ], "documentation": "Unregisters the custom connector registered in your account that matches the connector label provided in the request.
" }, "UntagResource": { "name": "UntagResource", "http": { "method": "DELETE", "requestUri": "/tags/{resourceArn}" }, "input": { "shape": "UntagResourceRequest" }, "output": { "shape": "UntagResourceResponse" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" } ], "documentation": "Removes a tag from the specified flow.
" }, "UpdateConnectorProfile": { "name": "UpdateConnectorProfile", "http": { "method": "POST", "requestUri": "/update-connector-profile" }, "input": { "shape": "UpdateConnectorProfileRequest" }, "output": { "shape": "UpdateConnectorProfileResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "ConnectorAuthenticationException" }, { "shape": "InternalServerException" } ], "documentation": "Updates a given connector profile associated with your account.
" }, "UpdateConnectorRegistration": { "name": "UpdateConnectorRegistration", "http": { "method": "POST", "requestUri": "/update-connector-registration" }, "input": { "shape": "UpdateConnectorRegistrationRequest" }, "output": { "shape": "UpdateConnectorRegistrationResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ConflictException" }, { "shape": "AccessDeniedException" }, { "shape": "ResourceNotFoundException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ThrottlingException" }, { "shape": "InternalServerException" }, { "shape": "ConnectorServerException" }, { "shape": "ConnectorAuthenticationException" } ], "documentation": "Updates a custom connector that you've previously registered. This operation updates the connector with one of the following:
The latest version of the AWS Lambda function that's assigned to the connector
A new AWS Lambda function that you specify
Updates an existing flow.
" } }, "shapes": { "ARN": { "type": "string", "max": 512, "pattern": "arn:aws:.*:.*:[0-9]+:.*" }, "AccessKeyId": { "type": "string", "max": 256, "pattern": "\\S+", "sensitive": true }, "AccessToken": { "type": "string", "max": 4096, "pattern": "\\S+", "sensitive": true }, "AccountName": { "type": "string", "max": 512, "pattern": "\\S+" }, "AggregationConfig": { "type": "structure", "members": { "aggregationType": { "shape": "AggregationType", "documentation": "Specifies whether Amazon AppFlow aggregates the flow records into a single file, or leave them unaggregated.
" }, "targetFileSize": { "shape": "Long", "documentation": "The desired file size, in MB, for each output file that Amazon AppFlow writes to the flow destination. For each file, Amazon AppFlow attempts to achieve the size that you specify. The actual file sizes might differ from this target based on the number and size of the records that each file contains.
" } }, "documentation": "The aggregation settings that you can use to customize the output format of your flow data.
" }, "AggregationType": { "type": "string", "enum": [ "None", "SingleFile" ] }, "AmplitudeConnectorOperator": { "type": "string", "enum": [ "BETWEEN" ] }, "AmplitudeConnectorProfileCredentials": { "type": "structure", "required": [ "apiKey", "secretKey" ], "members": { "apiKey": { "shape": "ApiKey", "documentation": "A unique alphanumeric identifier used to authenticate a user, developer, or calling program to your API.
" }, "secretKey": { "shape": "SecretKey", "documentation": "The Secret Access Key portion of the credentials.
" } }, "documentation": "The connector-specific credentials required when using Amplitude.
" }, "AmplitudeConnectorProfileProperties": { "type": "structure", "members": {}, "documentation": "The connector-specific profile properties required when using Amplitude.
" }, "AmplitudeMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Amplitude.
" }, "AmplitudeSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Amplitude flow source.
" } }, "documentation": "The properties that are applied when Amplitude is being used as a source.
" }, "ApiKey": { "type": "string", "max": 256, "pattern": "\\S+", "sensitive": true }, "ApiKeyCredentials": { "type": "structure", "required": [ "apiKey" ], "members": { "apiKey": { "shape": "ApiKey", "documentation": "The API key required for API key authentication.
" }, "apiSecretKey": { "shape": "ApiSecretKey", "documentation": "The API secret key required for API key authentication.
" } }, "documentation": "The API key credentials required for API key authentication.
" }, "ApiSecretKey": { "type": "string", "max": 256, "pattern": "\\S+", "sensitive": true }, "ApiToken": { "type": "string", "max": 256, "pattern": "\\S+" }, "ApiVersion": { "type": "string", "max": 256, "pattern": "\\S+" }, "ApplicationHostUrl": { "type": "string", "max": 256, "pattern": "^(https?)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]" }, "ApplicationKey": { "type": "string", "max": 512, "pattern": "\\S+" }, "ApplicationServicePath": { "type": "string", "max": 512, "pattern": "\\S+" }, "ApplicationType": { "type": "string", "max": 512, "pattern": "\\S+" }, "AuthCode": { "type": "string", "max": 4096, "pattern": "\\S+" }, "AuthCodeUrl": { "type": "string", "max": 256, "pattern": "^(https?)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]" }, "AuthCodeUrlList": { "type": "list", "member": { "shape": "AuthCodeUrl" } }, "AuthParameter": { "type": "structure", "members": { "key": { "shape": "Key", "documentation": "The authentication key required to authenticate with the connector.
" }, "isRequired": { "shape": "Boolean", "documentation": "Indicates whether this authentication parameter is required.
" }, "label": { "shape": "Label", "documentation": "Label used for authentication parameter.
" }, "description": { "shape": "Description", "documentation": "A description about the authentication parameter.
" }, "isSensitiveField": { "shape": "Boolean", "documentation": "Indicates whether this authentication parameter is a sensitive field.
" }, "connectorSuppliedValues": { "shape": "ConnectorSuppliedValueList", "documentation": "Contains default values for this authentication parameter that are supplied by the connector.
" } }, "documentation": "Information about required authentication parameters.
" }, "AuthParameterList": { "type": "list", "member": { "shape": "AuthParameter" } }, "AuthenticationConfig": { "type": "structure", "members": { "isBasicAuthSupported": { "shape": "Boolean", "documentation": "Indicates whether basic authentication is supported by the connector.
" }, "isApiKeyAuthSupported": { "shape": "Boolean", "documentation": "Indicates whether API key authentication is supported by the connector
" }, "isOAuth2Supported": { "shape": "Boolean", "documentation": "Indicates whether OAuth 2.0 authentication is supported by the connector.
" }, "isCustomAuthSupported": { "shape": "Boolean", "documentation": "Indicates whether custom authentication is supported by the connector
" }, "oAuth2Defaults": { "shape": "OAuth2Defaults", "documentation": "Contains the default values required for OAuth 2.0 authentication.
" }, "customAuthConfigs": { "shape": "CustomAuthConfigList", "documentation": "Contains information required for custom authentication.
" } }, "documentation": "Contains information about the authentication config that the connector supports.
" }, "AuthenticationType": { "type": "string", "enum": [ "OAUTH2", "APIKEY", "BASIC", "CUSTOM" ] }, "BasicAuthCredentials": { "type": "structure", "required": [ "username", "password" ], "members": { "username": { "shape": "Username", "documentation": "The username to use to connect to a resource.
" }, "password": { "shape": "Password", "documentation": "The password to use to connect to a resource.
" } }, "documentation": "The basic auth credentials required for basic authentication.
" }, "Boolean": { "type": "boolean" }, "BucketName": { "type": "string", "max": 63, "min": 3, "pattern": "\\S+" }, "BucketPrefix": { "type": "string", "max": 512, "pattern": ".*" }, "BusinessUnitId": { "type": "string", "max": 18, "pattern": "\\S+" }, "CancelFlowExecutionsRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The name of a flow with active runs that you want to cancel.
" }, "executionIds": { "shape": "ExecutionIds", "documentation": "The ID of each active run to cancel. These runs must belong to the flow you specify in your request.
If you omit this parameter, your request ends all active runs that belong to the flow.
" } } }, "CancelFlowExecutionsResponse": { "type": "structure", "members": { "invalidExecutions": { "shape": "ExecutionIds", "documentation": "The IDs of runs that Amazon AppFlow couldn't cancel. These runs might be ineligible for canceling because they haven't started yet or have already completed.
" } } }, "CatalogType": { "type": "string", "enum": [ "GLUE" ] }, "ClientCredentialsArn": { "type": "string", "max": 2048, "min": 20, "pattern": "arn:aws:secretsmanager:.*:[0-9]+:.*", "sensitive": true }, "ClientId": { "type": "string", "max": 512, "pattern": "\\S+" }, "ClientNumber": { "type": "string", "max": 3, "min": 3, "pattern": "^\\d{3}$" }, "ClientSecret": { "type": "string", "max": 512, "pattern": "\\S+", "sensitive": true }, "ClientToken": { "type": "string", "max": 256, "min": 1, "pattern": "[ -~]+" }, "ClusterIdentifier": { "type": "string", "max": 512, "pattern": "\\S+" }, "ConnectionMode": { "type": "string", "enum": [ "Public", "Private" ] }, "ConnectorConfiguration": { "type": "structure", "members": { "canUseAsSource": { "shape": "Boolean", "documentation": "Specifies whether the connector can be used as a source.
" }, "canUseAsDestination": { "shape": "Boolean", "documentation": "Specifies whether the connector can be used as a destination.
" }, "supportedDestinationConnectors": { "shape": "ConnectorTypeList", "documentation": "Lists the connectors that are available for use as destinations.
" }, "supportedSchedulingFrequencies": { "shape": "SchedulingFrequencyTypeList", "documentation": "Specifies the supported flow frequency for that connector.
" }, "isPrivateLinkEnabled": { "shape": "Boolean", "documentation": "Specifies if PrivateLink is enabled for that connector.
" }, "isPrivateLinkEndpointUrlRequired": { "shape": "Boolean", "documentation": "Specifies if a PrivateLink endpoint URL is required.
" }, "supportedTriggerTypes": { "shape": "TriggerTypeList", "documentation": "Specifies the supported trigger types for the flow.
" }, "connectorMetadata": { "shape": "ConnectorMetadata", "documentation": " Specifies connector-specific metadata such as oAuthScopes
, supportedRegions
, privateLinkServiceUrl
, and so on.
The connector type.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The label used for registering the connector.
" }, "connectorDescription": { "shape": "ConnectorDescription", "documentation": "A description about the connector.
" }, "connectorOwner": { "shape": "ConnectorOwner", "documentation": "The owner who developed the connector.
" }, "connectorName": { "shape": "ConnectorName", "documentation": "The connector name.
" }, "connectorVersion": { "shape": "ConnectorVersion", "documentation": "The connector version.
" }, "connectorArn": { "shape": "ARN", "documentation": "The Amazon Resource Name (ARN) for the registered connector.
" }, "connectorModes": { "shape": "ConnectorModeList", "documentation": "The connection modes that the connector supports.
" }, "authenticationConfig": { "shape": "AuthenticationConfig", "documentation": "The authentication config required for the connector.
" }, "connectorRuntimeSettings": { "shape": "ConnectorRuntimeSettingList", "documentation": "The required connector runtime settings.
" }, "supportedApiVersions": { "shape": "SupportedApiVersionList", "documentation": "A list of API versions that are supported by the connector.
" }, "supportedOperators": { "shape": "SupportedOperatorList", "documentation": "A list of operators supported by the connector.
" }, "supportedWriteOperations": { "shape": "SupportedWriteOperationList", "documentation": "A list of write operations supported by the connector.
" }, "connectorProvisioningType": { "shape": "ConnectorProvisioningType", "documentation": "The provisioning type used to register the connector.
" }, "connectorProvisioningConfig": { "shape": "ConnectorProvisioningConfig", "documentation": "The configuration required for registering the connector.
" }, "logoURL": { "shape": "LogoURL", "documentation": "Logo URL of the connector.
" }, "registeredAt": { "shape": "Date", "documentation": "The date on which the connector was registered.
" }, "registeredBy": { "shape": "RegisteredBy", "documentation": "Information about who registered the connector.
" }, "supportedDataTransferTypes": { "shape": "SupportedDataTransferTypeList", "documentation": "The data transfer types that the connector supports.
Structured records.
Files or binary data.
The APIs of the connector application that Amazon AppFlow can use to transfer your data.
" } }, "documentation": "The configuration settings related to a given connector.
" }, "ConnectorConfigurationsMap": { "type": "map", "key": { "shape": "ConnectorType" }, "value": { "shape": "ConnectorConfiguration" } }, "ConnectorDescription": { "type": "string", "max": 2048, "pattern": "[\\w!@#\\-.?,\\s]*" }, "ConnectorDetail": { "type": "structure", "members": { "connectorDescription": { "shape": "ConnectorDescription", "documentation": "A description about the registered connector.
" }, "connectorName": { "shape": "ConnectorName", "documentation": "The name of the connector.
" }, "connectorOwner": { "shape": "ConnectorOwner", "documentation": "The owner of the connector.
" }, "connectorVersion": { "shape": "ConnectorVersion", "documentation": "The connector version.
" }, "applicationType": { "shape": "ApplicationType", "documentation": "The application type of the connector.
" }, "connectorType": { "shape": "ConnectorType", "documentation": "The connector type.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "A label used for the connector.
" }, "registeredAt": { "shape": "Date", "documentation": "The time at which the connector was registered.
" }, "registeredBy": { "shape": "RegisteredBy", "documentation": "The user who registered the connector.
" }, "connectorProvisioningType": { "shape": "ConnectorProvisioningType", "documentation": "The provisioning type that the connector uses.
" }, "connectorModes": { "shape": "ConnectorModeList", "documentation": "The connection mode that the connector supports.
" }, "supportedDataTransferTypes": { "shape": "SupportedDataTransferTypeList", "documentation": "The data transfer types that the connector supports.
Structured records.
Files or binary data.
Information about the registered connector.
" }, "ConnectorEntity": { "type": "structure", "required": [ "name" ], "members": { "name": { "shape": "Name", "documentation": "The name of the connector entity.
" }, "label": { "shape": "Label", "documentation": "The label applied to the connector entity.
" }, "hasNestedEntities": { "shape": "Boolean", "documentation": " Specifies whether the connector entity is a parent or a category and has more entities nested underneath it. If another call is made with entitiesPath = \"the_current_entity_name_with_hasNestedEntities_true\"
, then it returns the nested entities underneath it. This provides a way to retrieve all supported entities in a recursive fashion.
The high-level entity that can be queried in Amazon AppFlow. For example, a Salesforce entity might be an Account or Opportunity, whereas a ServiceNow entity might be an Incident.
" }, "ConnectorEntityField": { "type": "structure", "required": [ "identifier" ], "members": { "identifier": { "shape": "Identifier", "documentation": "The unique identifier of the connector field.
" }, "parentIdentifier": { "shape": "Identifier", "documentation": "The parent identifier of the connector field.
" }, "label": { "shape": "Label", "documentation": "The label applied to a connector entity field.
" }, "isPrimaryKey": { "shape": "Boolean", "documentation": "Booelan value that indicates whether this field can be used as a primary key.
" }, "defaultValue": { "shape": "String", "documentation": "Default value that can be assigned to this field.
" }, "isDeprecated": { "shape": "Boolean", "documentation": "Booelan value that indicates whether this field is deprecated or not.
" }, "supportedFieldTypeDetails": { "shape": "SupportedFieldTypeDetails", "documentation": " Contains details regarding the supported FieldType
, including the corresponding filterOperators
and supportedValues
.
A description of the connector entity field.
" }, "sourceProperties": { "shape": "SourceFieldProperties", "documentation": "The properties that can be applied to a field when the connector is being used as a source.
" }, "destinationProperties": { "shape": "DestinationFieldProperties", "documentation": "The properties applied to a field when the connector is being used as a destination.
" }, "customProperties": { "shape": "CustomProperties", "documentation": "A map that has specific properties related to the ConnectorEntityField.
" } }, "documentation": "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.
" }, "ConnectorEntityFieldList": { "type": "list", "member": { "shape": "ConnectorEntityField" } }, "ConnectorEntityList": { "type": "list", "member": { "shape": "ConnectorEntity" } }, "ConnectorEntityMap": { "type": "map", "key": { "shape": "Group" }, "value": { "shape": "ConnectorEntityList" } }, "ConnectorLabel": { "type": "string", "max": 256, "pattern": "[a-zA-Z0-9][\\w!@#.-]+" }, "ConnectorList": { "type": "list", "member": { "shape": "ConnectorDetail" } }, "ConnectorMetadata": { "type": "structure", "members": { "Amplitude": { "shape": "AmplitudeMetadata", "documentation": "The connector metadata specific to Amplitude.
" }, "Datadog": { "shape": "DatadogMetadata", "documentation": "The connector metadata specific to Datadog.
" }, "Dynatrace": { "shape": "DynatraceMetadata", "documentation": "The connector metadata specific to Dynatrace.
" }, "GoogleAnalytics": { "shape": "GoogleAnalyticsMetadata", "documentation": "The connector metadata specific to Google Analytics.
" }, "InforNexus": { "shape": "InforNexusMetadata", "documentation": "The connector metadata specific to Infor Nexus.
" }, "Marketo": { "shape": "MarketoMetadata", "documentation": "The connector metadata specific to Marketo.
" }, "Redshift": { "shape": "RedshiftMetadata", "documentation": "The connector metadata specific to Amazon Redshift.
" }, "S3": { "shape": "S3Metadata", "documentation": "The connector metadata specific to Amazon S3.
" }, "Salesforce": { "shape": "SalesforceMetadata", "documentation": "The connector metadata specific to Salesforce.
" }, "ServiceNow": { "shape": "ServiceNowMetadata", "documentation": "The connector metadata specific to ServiceNow.
" }, "Singular": { "shape": "SingularMetadata", "documentation": "The connector metadata specific to Singular.
" }, "Slack": { "shape": "SlackMetadata", "documentation": "The connector metadata specific to Slack.
" }, "Snowflake": { "shape": "SnowflakeMetadata", "documentation": "The connector metadata specific to Snowflake.
" }, "Trendmicro": { "shape": "TrendmicroMetadata", "documentation": "The connector metadata specific to Trend Micro.
" }, "Veeva": { "shape": "VeevaMetadata", "documentation": "The connector metadata specific to Veeva.
" }, "Zendesk": { "shape": "ZendeskMetadata", "documentation": "The connector metadata specific to Zendesk.
" }, "EventBridge": { "shape": "EventBridgeMetadata", "documentation": "The connector metadata specific to Amazon EventBridge.
" }, "Upsolver": { "shape": "UpsolverMetadata", "documentation": "The connector metadata specific to Upsolver.
" }, "CustomerProfiles": { "shape": "CustomerProfilesMetadata", "documentation": "The connector metadata specific to Amazon Connect Customer Profiles.
" }, "Honeycode": { "shape": "HoneycodeMetadata", "documentation": "The connector metadata specific to Amazon Honeycode.
" }, "SAPOData": { "shape": "SAPODataMetadata" }, "Pardot": { "shape": "PardotMetadata", "documentation": "The connector metadata specific to Salesforce Pardot.
" } }, "documentation": " A structure to specify connector-specific metadata such as oAuthScopes
, supportedRegions
, privateLinkServiceUrl
, and so on.
The code provided by the connector when it has been authenticated via the connected app.
" }, "redirectUri": { "shape": "RedirectUri", "documentation": "The URL to which the authentication server redirects the browser after authorization has been granted.
" } }, "documentation": "Used by select connectors for which the OAuth workflow is supported, such as Salesforce, Google Analytics, Marketo, Zendesk, and Slack.
" }, "ConnectorOperator": { "type": "structure", "members": { "Amplitude": { "shape": "AmplitudeConnectorOperator", "documentation": "The operation to be performed on the provided Amplitude source fields.
" }, "Datadog": { "shape": "DatadogConnectorOperator", "documentation": "The operation to be performed on the provided Datadog source fields.
" }, "Dynatrace": { "shape": "DynatraceConnectorOperator", "documentation": "The operation to be performed on the provided Dynatrace source fields.
" }, "GoogleAnalytics": { "shape": "GoogleAnalyticsConnectorOperator", "documentation": "The operation to be performed on the provided Google Analytics source fields.
" }, "InforNexus": { "shape": "InforNexusConnectorOperator", "documentation": "The operation to be performed on the provided Infor Nexus source fields.
" }, "Marketo": { "shape": "MarketoConnectorOperator", "documentation": "The operation to be performed on the provided Marketo source fields.
" }, "S3": { "shape": "S3ConnectorOperator", "documentation": "The operation to be performed on the provided Amazon S3 source fields.
" }, "Salesforce": { "shape": "SalesforceConnectorOperator", "documentation": "The operation to be performed on the provided Salesforce source fields.
" }, "ServiceNow": { "shape": "ServiceNowConnectorOperator", "documentation": "The operation to be performed on the provided ServiceNow source fields.
" }, "Singular": { "shape": "SingularConnectorOperator", "documentation": "The operation to be performed on the provided Singular source fields.
" }, "Slack": { "shape": "SlackConnectorOperator", "documentation": "The operation to be performed on the provided Slack source fields.
" }, "Trendmicro": { "shape": "TrendmicroConnectorOperator", "documentation": "The operation to be performed on the provided Trend Micro source fields.
" }, "Veeva": { "shape": "VeevaConnectorOperator", "documentation": "The operation to be performed on the provided Veeva source fields.
" }, "Zendesk": { "shape": "ZendeskConnectorOperator", "documentation": "The operation to be performed on the provided Zendesk source fields.
" }, "SAPOData": { "shape": "SAPODataConnectorOperator", "documentation": "The operation to be performed on the provided SAPOData source fields.
" }, "CustomConnector": { "shape": "Operator", "documentation": "Operators supported by the custom connector.
" }, "Pardot": { "shape": "PardotConnectorOperator", "documentation": "The operation to be performed on the provided Salesforce Pardot source fields.
" } }, "documentation": "The operation to be performed on the provided source fields.
" }, "ConnectorOwner": { "type": "string", "max": 256, "pattern": ".*" }, "ConnectorProfile": { "type": "structure", "members": { "connectorProfileArn": { "shape": "ConnectorProfileArn", "documentation": "The Amazon Resource Name (ARN) of the connector profile.
" }, "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in the Amazon Web Services account.
The type of connector, such as Salesforce, Amplitude, and so on.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The label for the connector profile being created.
" }, "connectionMode": { "shape": "ConnectionMode", "documentation": "Indicates the connection mode and if it is public or private.
" }, "credentialsArn": { "shape": "ARN", "documentation": "The Amazon Resource Name (ARN) of the connector profile credentials.
" }, "connectorProfileProperties": { "shape": "ConnectorProfileProperties", "documentation": "The connector-specific properties of the profile configuration.
" }, "createdAt": { "shape": "Date", "documentation": "Specifies when the connector profile was created.
" }, "lastUpdatedAt": { "shape": "Date", "documentation": "Specifies when the connector profile was last updated.
" }, "privateConnectionProvisioningState": { "shape": "PrivateConnectionProvisioningState", "documentation": "Specifies the private connection provisioning state.
" } }, "documentation": " Describes an instance of a connector. This includes the provided name, credentials ARN, connection-mode, and so on. To keep the API intuitive and extensible, the fields that are common to all types of connector profiles are explicitly specified at the top level. The rest of the connector-specific properties are available via the connectorProfileProperties
field.
The connector-specific properties of the profile configuration.
" }, "connectorProfileCredentials": { "shape": "ConnectorProfileCredentials", "documentation": "The connector-specific credentials required by each connector.
" } }, "documentation": "Defines the connector-specific configuration and credentials for the connector profile.
" }, "ConnectorProfileCredentials": { "type": "structure", "members": { "Amplitude": { "shape": "AmplitudeConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Amplitude.
" }, "Datadog": { "shape": "DatadogConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Datadog.
" }, "Dynatrace": { "shape": "DynatraceConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Dynatrace.
" }, "GoogleAnalytics": { "shape": "GoogleAnalyticsConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Google Analytics.
" }, "Honeycode": { "shape": "HoneycodeConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Amazon Honeycode.
" }, "InforNexus": { "shape": "InforNexusConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Infor Nexus.
" }, "Marketo": { "shape": "MarketoConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Marketo.
" }, "Redshift": { "shape": "RedshiftConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Amazon Redshift.
" }, "Salesforce": { "shape": "SalesforceConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Salesforce.
" }, "ServiceNow": { "shape": "ServiceNowConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using ServiceNow.
" }, "Singular": { "shape": "SingularConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Singular.
" }, "Slack": { "shape": "SlackConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Slack.
" }, "Snowflake": { "shape": "SnowflakeConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Snowflake.
" }, "Trendmicro": { "shape": "TrendmicroConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Trend Micro.
" }, "Veeva": { "shape": "VeevaConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Veeva.
" }, "Zendesk": { "shape": "ZendeskConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Zendesk.
" }, "SAPOData": { "shape": "SAPODataConnectorProfileCredentials" }, "CustomConnector": { "shape": "CustomConnectorProfileCredentials" }, "Pardot": { "shape": "PardotConnectorProfileCredentials", "documentation": "The connector-specific credentials required when using Salesforce Pardot.
" } }, "documentation": "The connector-specific credentials required by a connector.
" }, "ConnectorProfileDetailList": { "type": "list", "member": { "shape": "ConnectorProfile" } }, "ConnectorProfileName": { "type": "string", "max": 256, "pattern": "[\\w/!@#+=.-]+" }, "ConnectorProfileNameList": { "type": "list", "member": { "shape": "ConnectorProfileName" }, "max": 100, "min": 0 }, "ConnectorProfileProperties": { "type": "structure", "members": { "Amplitude": { "shape": "AmplitudeConnectorProfileProperties", "documentation": "The connector-specific properties required by Amplitude.
" }, "Datadog": { "shape": "DatadogConnectorProfileProperties", "documentation": "The connector-specific properties required by Datadog.
" }, "Dynatrace": { "shape": "DynatraceConnectorProfileProperties", "documentation": "The connector-specific properties required by Dynatrace.
" }, "GoogleAnalytics": { "shape": "GoogleAnalyticsConnectorProfileProperties", "documentation": "The connector-specific properties required Google Analytics.
" }, "Honeycode": { "shape": "HoneycodeConnectorProfileProperties", "documentation": "The connector-specific properties required by Amazon Honeycode.
" }, "InforNexus": { "shape": "InforNexusConnectorProfileProperties", "documentation": "The connector-specific properties required by Infor Nexus.
" }, "Marketo": { "shape": "MarketoConnectorProfileProperties", "documentation": "The connector-specific properties required by Marketo.
" }, "Redshift": { "shape": "RedshiftConnectorProfileProperties", "documentation": "The connector-specific properties required by Amazon Redshift.
" }, "Salesforce": { "shape": "SalesforceConnectorProfileProperties", "documentation": "The connector-specific properties required by Salesforce.
" }, "ServiceNow": { "shape": "ServiceNowConnectorProfileProperties", "documentation": "The connector-specific properties required by serviceNow.
" }, "Singular": { "shape": "SingularConnectorProfileProperties", "documentation": "The connector-specific properties required by Singular.
" }, "Slack": { "shape": "SlackConnectorProfileProperties", "documentation": "The connector-specific properties required by Slack.
" }, "Snowflake": { "shape": "SnowflakeConnectorProfileProperties", "documentation": "The connector-specific properties required by Snowflake.
" }, "Trendmicro": { "shape": "TrendmicroConnectorProfileProperties", "documentation": "The connector-specific properties required by Trend Micro.
" }, "Veeva": { "shape": "VeevaConnectorProfileProperties", "documentation": "The connector-specific properties required by Veeva.
" }, "Zendesk": { "shape": "ZendeskConnectorProfileProperties", "documentation": "The connector-specific properties required by Zendesk.
" }, "SAPOData": { "shape": "SAPODataConnectorProfileProperties" }, "CustomConnector": { "shape": "CustomConnectorProfileProperties", "documentation": "The properties required by the custom connector.
" }, "Pardot": { "shape": "PardotConnectorProfileProperties", "documentation": "The connector-specific properties required by Salesforce Pardot.
" } }, "documentation": "The connector-specific profile properties required by each connector.
" }, "ConnectorProvisioningConfig": { "type": "structure", "members": { "lambda": { "shape": "LambdaConnectorProvisioningConfig", "documentation": "Contains information about the configuration of the lambda which is being registered as the connector.
" } }, "documentation": "Contains information about the configuration of the connector being registered.
" }, "ConnectorProvisioningType": { "type": "string", "documentation": "The type of provisioning that the connector supports, such as Lambda.
", "enum": [ "LAMBDA" ] }, "ConnectorRuntimeSetting": { "type": "structure", "members": { "key": { "shape": "Key", "documentation": "Contains value information about the connector runtime setting.
" }, "dataType": { "shape": "ConnectorRuntimeSettingDataType", "documentation": "Data type of the connector runtime setting.
" }, "isRequired": { "shape": "Boolean", "documentation": "Indicates whether this connector runtime setting is required.
" }, "label": { "shape": "Label", "documentation": "A label used for connector runtime setting.
" }, "description": { "shape": "Description", "documentation": "A description about the connector runtime setting.
" }, "scope": { "shape": "ConnectorRuntimeSettingScope", "documentation": "Indicates the scope of the connector runtime setting.
" }, "connectorSuppliedValueOptions": { "shape": "ConnectorSuppliedValueOptionList", "documentation": "Contains default values for the connector runtime setting that are supplied by the connector.
" } }, "documentation": "Contains information about the connector runtime settings that are required for flow execution.
" }, "ConnectorRuntimeSettingDataType": { "type": "string", "max": 256, "pattern": "\\S+" }, "ConnectorRuntimeSettingList": { "type": "list", "member": { "shape": "ConnectorRuntimeSetting" } }, "ConnectorRuntimeSettingScope": { "type": "string", "max": 256, "pattern": "\\S+" }, "ConnectorSuppliedValue": { "type": "string", "max": 256, "pattern": "\\S+" }, "ConnectorSuppliedValueList": { "type": "list", "member": { "shape": "ConnectorSuppliedValue" } }, "ConnectorSuppliedValueOptionList": { "type": "list", "member": { "shape": "ConnectorSuppliedValue" } }, "ConnectorType": { "type": "string", "enum": [ "Salesforce", "Singular", "Slack", "Redshift", "S3", "Marketo", "Googleanalytics", "Zendesk", "Servicenow", "Datadog", "Trendmicro", "Snowflake", "Dynatrace", "Infornexus", "Amplitude", "Veeva", "EventBridge", "LookoutMetrics", "Upsolver", "Honeycode", "CustomerProfiles", "SAPOData", "CustomConnector", "Pardot" ] }, "ConnectorTypeList": { "type": "list", "member": { "shape": "ConnectorType" }, "max": 100, "min": 0 }, "ConnectorVersion": { "type": "string", "max": 256, "pattern": "\\S+" }, "CreateConnectorProfileRequest": { "type": "structure", "required": [ "connectorProfileName", "connectorType", "connectionMode", "connectorProfileConfig" ], "members": { "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in your Amazon Web Services account.
The ARN (Amazon Resource Name) of the Key Management Service (KMS) key you provide for encryption. This is required if you do not want to use the Amazon AppFlow-managed KMS key. If you don't provide anything here, Amazon AppFlow uses the Amazon AppFlow-managed KMS key.
" }, "connectorType": { "shape": "ConnectorType", "documentation": "The type of connector, such as Salesforce, Amplitude, and so on.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The label of the connector. The label is unique for each ConnectorRegistration
in your Amazon Web Services account. Only needed if calling for CUSTOMCONNECTOR connector type/.
Indicates the connection mode and specifies whether it is public or private. Private flows use Amazon Web Services PrivateLink to route data over Amazon Web Services infrastructure without exposing it to the public internet.
" }, "connectorProfileConfig": { "shape": "ConnectorProfileConfig", "documentation": "Defines the connector-specific configuration and credentials.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your CreateConnectorProfile
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to CreateConnectorProfile
. The token is active for 8 hours.
The Amazon Resource Name (ARN) of the connector profile.
" } } }, "CreateFlowRequest": { "type": "structure", "required": [ "flowName", "triggerConfig", "sourceFlowConfig", "destinationFlowConfigList", "tasks" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "description": { "shape": "FlowDescription", "documentation": "A description of the flow you want to create.
" }, "kmsArn": { "shape": "KMSArn", "documentation": "The ARN (Amazon Resource Name) of the Key Management Service (KMS) key you provide for encryption. This is required if you do not want to use the Amazon AppFlow-managed KMS key. If you don't provide anything here, Amazon AppFlow uses the Amazon AppFlow-managed KMS key.
" }, "triggerConfig": { "shape": "TriggerConfig", "documentation": "The trigger settings that determine how and when the flow runs.
" }, "sourceFlowConfig": { "shape": "SourceFlowConfig", "documentation": "The configuration that controls how Amazon AppFlow retrieves data from the source connector.
" }, "destinationFlowConfigList": { "shape": "DestinationFlowConfigList", "documentation": "The configuration that controls how Amazon AppFlow places data in the destination connector.
" }, "tasks": { "shape": "Tasks", "documentation": "A list of tasks that Amazon AppFlow performs while transferring the data in the flow run.
" }, "tags": { "shape": "TagMap", "documentation": "The tags used to organize, track, or control access for your flow.
" }, "metadataCatalogConfig": { "shape": "MetadataCatalogConfig", "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs the data that's transferred by the associated flow. When Amazon AppFlow catalogs the data from a flow, it stores metadata in a data catalog.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your CreateFlow
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to CreateFlow
. The token is active for 8 hours.
The flow's Amazon Resource Name (ARN).
" }, "flowStatus": { "shape": "FlowStatus", "documentation": "Indicates the current status of the flow.
" } } }, "CreatedBy": { "type": "string", "max": 256, "pattern": "\\S+" }, "CredentialsMap": { "type": "map", "key": { "shape": "CredentialsMapKey" }, "value": { "shape": "CredentialsMapValue" }, "max": 50, "min": 0 }, "CredentialsMapKey": { "type": "string", "max": 128, "min": 1, "pattern": "[\\w]+", "sensitive": true }, "CredentialsMapValue": { "type": "string", "max": 2048, "pattern": "\\S+", "sensitive": true }, "CustomAuthConfig": { "type": "structure", "members": { "customAuthenticationType": { "shape": "CustomAuthenticationType", "documentation": "The authentication type that the custom connector uses.
" }, "authParameters": { "shape": "AuthParameterList", "documentation": "Information about authentication parameters required for authentication.
" } }, "documentation": "Configuration information required for custom authentication.
" }, "CustomAuthConfigList": { "type": "list", "member": { "shape": "CustomAuthConfig" } }, "CustomAuthCredentials": { "type": "structure", "required": [ "customAuthenticationType" ], "members": { "customAuthenticationType": { "shape": "CustomAuthenticationType", "documentation": "The custom authentication type that the connector uses.
" }, "credentialsMap": { "shape": "CredentialsMap", "documentation": "A map that holds custom authentication credentials.
" } }, "documentation": "The custom credentials required for custom authentication.
" }, "CustomAuthenticationType": { "type": "string", "max": 256, "pattern": "\\S+" }, "CustomConnectorDestinationProperties": { "type": "structure", "required": [ "entityName" ], "members": { "entityName": { "shape": "EntityName", "documentation": "The entity specified in the custom connector as a destination in the flow.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig", "documentation": "The settings that determine how Amazon AppFlow handles an error when placing data in the custom connector as destination.
" }, "writeOperationType": { "shape": "WriteOperationType", "documentation": "Specifies the type of write operation to be performed in the custom connector when it's used as destination.
" }, "idFieldNames": { "shape": "IdFieldNameList", "documentation": "The name of the field that Amazon AppFlow uses as an ID when performing a write operation such as update, delete, or upsert.
" }, "customProperties": { "shape": "CustomProperties", "documentation": "The custom properties that are specific to the connector when it's used as a destination in the flow.
" } }, "documentation": "The properties that are applied when the custom connector is being used as a destination.
" }, "CustomConnectorProfileCredentials": { "type": "structure", "required": [ "authenticationType" ], "members": { "authenticationType": { "shape": "AuthenticationType", "documentation": "The authentication type that the custom connector uses for authenticating while creating a connector profile.
" }, "basic": { "shape": "BasicAuthCredentials", "documentation": "The basic credentials that are required for the authentication of the user.
" }, "oauth2": { "shape": "OAuth2Credentials", "documentation": "The OAuth 2.0 credentials required for the authentication of the user.
" }, "apiKey": { "shape": "ApiKeyCredentials", "documentation": "The API keys required for the authentication of the user.
" }, "custom": { "shape": "CustomAuthCredentials", "documentation": "If the connector uses the custom authentication mechanism, this holds the required credentials.
" } }, "documentation": "The connector-specific profile credentials that are required when using the custom connector.
" }, "CustomConnectorProfileProperties": { "type": "structure", "members": { "profileProperties": { "shape": "ProfilePropertiesMap", "documentation": "A map of properties that are required to create a profile for the custom connector.
" }, "oAuth2Properties": { "shape": "OAuth2Properties" } }, "documentation": "The profile properties required by the custom connector.
" }, "CustomConnectorSourceProperties": { "type": "structure", "required": [ "entityName" ], "members": { "entityName": { "shape": "EntityName", "documentation": "The entity specified in the custom connector as a source in the flow.
" }, "customProperties": { "shape": "CustomProperties", "documentation": "Custom properties that are required to use the custom connector as a source.
" }, "dataTransferApi": { "shape": "DataTransferApi", "documentation": "The API of the connector application that Amazon AppFlow uses to transfer your data.
" } }, "documentation": "The properties that are applied when the custom connector is being used as a source.
" }, "CustomProperties": { "type": "map", "key": { "shape": "CustomPropertyKey" }, "value": { "shape": "CustomPropertyValue" }, "max": 50, "min": 0 }, "CustomPropertyKey": { "type": "string", "max": 128, "min": 1, "pattern": "[\\w]+" }, "CustomPropertyValue": { "type": "string", "max": 2048, "pattern": "\\S+" }, "CustomerProfilesDestinationProperties": { "type": "structure", "required": [ "domainName" ], "members": { "domainName": { "shape": "DomainName", "documentation": "The unique name of the Amazon Connect Customer Profiles domain.
" }, "objectTypeName": { "shape": "ObjectTypeName", "documentation": "The object specified in the Amazon Connect Customer Profiles flow destination.
" } }, "documentation": "The properties that are applied when Amazon Connect Customer Profiles is used as a destination.
" }, "CustomerProfilesMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Amazon Connect Customer Profiles.
" }, "DataApiRoleArn": { "type": "string", "max": 512, "pattern": "arn:aws:iam:.*:[0-9]+:.*" }, "DataPullMode": { "type": "string", "enum": [ "Incremental", "Complete" ] }, "DataTransferApi": { "type": "structure", "members": { "Name": { "shape": "DataTransferApiTypeName", "documentation": "The name of the connector application API.
" }, "Type": { "shape": "DataTransferApiType", "documentation": "You can specify one of the following types:
The default. Optimizes a flow for datasets that fluctuate in size from small to large. For each flow run, Amazon AppFlow chooses to use the SYNC or ASYNC API type based on the amount of data that the run transfers.
A synchronous API. This type of API optimizes a flow for small to medium-sized datasets.
An asynchronous API. This type of API optimizes a flow for large datasets.
The API of the connector application that Amazon AppFlow uses to transfer your data.
" }, "DataTransferApiType": { "type": "string", "enum": [ "SYNC", "ASYNC", "AUTOMATIC" ] }, "DataTransferApiTypeName": { "type": "string", "max": 64, "pattern": "[\\w/-]+" }, "DatabaseName": { "type": "string", "max": 512, "pattern": "\\S+" }, "DatabaseUrl": { "type": "string", "max": 512, "pattern": "\\S+" }, "DatadogConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "BETWEEN", "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" ] }, "DatadogConnectorProfileCredentials": { "type": "structure", "required": [ "apiKey", "applicationKey" ], "members": { "apiKey": { "shape": "ApiKey", "documentation": "A unique alphanumeric identifier used to authenticate a user, developer, or calling program to your API.
" }, "applicationKey": { "shape": "ApplicationKey", "documentation": "Application keys, in conjunction with your API key, give you full access to Datadog’s programmatic API. Application keys are associated with the user account that created them. The application key is used to log all requests made to the API.
" } }, "documentation": "The connector-specific credentials required by Datadog.
" }, "DatadogConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Datadog resource.
" } }, "documentation": "The connector-specific profile properties required by Datadog.
" }, "DatadogMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Datadog.
" }, "DatadogSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Datadog flow source.
" } }, "documentation": "The properties that are applied when Datadog is being used as a source.
" }, "Date": { "type": "timestamp" }, "DatetimeTypeFieldName": { "type": "string", "max": 256, "pattern": ".*" }, "DeleteConnectorProfileRequest": { "type": "structure", "required": [ "connectorProfileName" ], "members": { "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in your account.
Indicates whether Amazon AppFlow should delete the profile, even if it is currently in use in one or more flows.
" } } }, "DeleteConnectorProfileResponse": { "type": "structure", "members": {} }, "DeleteFlowRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "forceDelete": { "shape": "Boolean", "documentation": "Indicates whether Amazon AppFlow should delete the flow, even if it is currently in use.
" } } }, "DeleteFlowResponse": { "type": "structure", "members": {} }, "DescribeConnectorEntityRequest": { "type": "structure", "required": [ "connectorEntityName" ], "members": { "connectorEntityName": { "shape": "EntityName", "documentation": "The entity name for that connector.
" }, "connectorType": { "shape": "ConnectorType", "documentation": "The type of connector application, such as Salesforce, Amplitude, and so on.
" }, "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in the Amazon Web Services account.
The version of the API that's used by the connector.
" } } }, "DescribeConnectorEntityResponse": { "type": "structure", "required": [ "connectorEntityFields" ], "members": { "connectorEntityFields": { "shape": "ConnectorEntityFieldList", "documentation": "Describes the fields for that connector entity. For example, for an account entity, the fields would be account name, account ID, and so on.
" } } }, "DescribeConnectorProfilesRequest": { "type": "structure", "members": { "connectorProfileNames": { "shape": "ConnectorProfileNameList", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in the Amazon Web Services account.
The type of connector, such as Salesforce, Amplitude, and so on.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The name of the connector. The name is unique for each ConnectorRegistration
in your Amazon Web Services account. Only needed if calling for CUSTOMCONNECTOR connector type/.
Specifies the maximum number of items that should be returned in the result set. The default for maxResults
is 20 (for all paginated API operations).
The pagination token for the next page of data.
" } } }, "DescribeConnectorProfilesResponse": { "type": "structure", "members": { "connectorProfileDetails": { "shape": "ConnectorProfileDetailList", "documentation": "Returns information about the connector profiles associated with the flow.
" }, "nextToken": { "shape": "NextToken", "documentation": " The pagination token for the next page of data. If nextToken=null
, this means that all records have been fetched.
The connector type, such as CUSTOMCONNECTOR, Saleforce, Marketo. Please choose CUSTOMCONNECTOR for Lambda based custom connectors.
" }, "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The label of the connector. The label is unique for each ConnectorRegistration
in your Amazon Web Services account. Only needed if calling for CUSTOMCONNECTOR connector type/.
Configuration info of all the connectors that the user requested.
" } } }, "DescribeConnectorsRequest": { "type": "structure", "members": { "connectorTypes": { "shape": "ConnectorTypeList", "documentation": "The type of connector, such as Salesforce, Amplitude, and so on.
" }, "maxResults": { "shape": "MaxResults", "documentation": "The maximum number of items that should be returned in the result set. The default is 20.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for the next page of data.
" } } }, "DescribeConnectorsResponse": { "type": "structure", "members": { "connectorConfigurations": { "shape": "ConnectorConfigurationsMap", "documentation": "The configuration that is applied to the connectors used in the flow.
" }, "connectors": { "shape": "ConnectorList", "documentation": "Information about the connectors supported in Amazon AppFlow.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for the next page of data.
" } } }, "DescribeFlowExecutionRecordsRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "maxResults": { "shape": "MaxResults", "documentation": " Specifies the maximum number of items that should be returned in the result set. The default for maxResults
is 20 (for all paginated API operations).
The pagination token for the next page of data.
" } } }, "DescribeFlowExecutionRecordsResponse": { "type": "structure", "members": { "flowExecutions": { "shape": "FlowExecutionList", "documentation": "Returns a list of all instances when this flow was run.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for the next page of data.
" } } }, "DescribeFlowRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" } } }, "DescribeFlowResponse": { "type": "structure", "members": { "flowArn": { "shape": "FlowArn", "documentation": "The flow's Amazon Resource Name (ARN).
" }, "description": { "shape": "FlowDescription", "documentation": "A description of the flow.
" }, "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "kmsArn": { "shape": "KMSArn", "documentation": "The ARN (Amazon Resource Name) of the Key Management Service (KMS) key you provide for encryption. This is required if you do not want to use the Amazon AppFlow-managed KMS key. If you don't provide anything here, Amazon AppFlow uses the Amazon AppFlow-managed KMS key.
" }, "flowStatus": { "shape": "FlowStatus", "documentation": "Indicates the current status of the flow.
" }, "flowStatusMessage": { "shape": "FlowStatusMessage", "documentation": "Contains an error message if the flow status is in a suspended or error state. This applies only to scheduled or event-triggered flows.
" }, "sourceFlowConfig": { "shape": "SourceFlowConfig", "documentation": "The configuration that controls how Amazon AppFlow retrieves data from the source connector.
" }, "destinationFlowConfigList": { "shape": "DestinationFlowConfigList", "documentation": "The configuration that controls how Amazon AppFlow transfers data to the destination connector.
" }, "lastRunExecutionDetails": { "shape": "ExecutionDetails", "documentation": "Describes the details of the most recent flow run.
" }, "triggerConfig": { "shape": "TriggerConfig", "documentation": "The trigger settings that determine how and when the flow runs.
" }, "tasks": { "shape": "Tasks", "documentation": "A list of tasks that Amazon AppFlow performs while transferring the data in the flow run.
" }, "createdAt": { "shape": "Date", "documentation": "Specifies when the flow was created.
" }, "lastUpdatedAt": { "shape": "Date", "documentation": "Specifies when the flow was last updated.
" }, "createdBy": { "shape": "CreatedBy", "documentation": "The ARN of the user who created the flow.
" }, "lastUpdatedBy": { "shape": "UpdatedBy", "documentation": "Specifies the user name of the account that performed the most recent update.
" }, "tags": { "shape": "TagMap", "documentation": "The tags used to organize, track, or control access for your flow.
" }, "metadataCatalogConfig": { "shape": "MetadataCatalogConfig", "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs the data that's transferred by the associated flow. When Amazon AppFlow catalogs the data from a flow, it stores metadata in a data catalog.
" }, "lastRunMetadataCatalogDetails": { "shape": "MetadataCatalogDetails", "documentation": "Describes the metadata catalog, metadata table, and data partitions that Amazon AppFlow used for the associated flow run.
" }, "schemaVersion": { "shape": "Long", "documentation": "The version number of your data schema. Amazon AppFlow assigns this version number. The version number increases by one when you change any of the following settings in your flow configuration:
Source-to-destination field mappings
Field data types
Partition keys
The properties required to query Amazon Redshift.
" }, "S3": { "shape": "S3DestinationProperties", "documentation": "The properties required to query Amazon S3.
" }, "Salesforce": { "shape": "SalesforceDestinationProperties", "documentation": "The properties required to query Salesforce.
" }, "Snowflake": { "shape": "SnowflakeDestinationProperties", "documentation": "The properties required to query Snowflake.
" }, "EventBridge": { "shape": "EventBridgeDestinationProperties", "documentation": "The properties required to query Amazon EventBridge.
" }, "LookoutMetrics": { "shape": "LookoutMetricsDestinationProperties", "documentation": "The properties required to query Amazon Lookout for Metrics.
" }, "Upsolver": { "shape": "UpsolverDestinationProperties", "documentation": "The properties required to query Upsolver.
" }, "Honeycode": { "shape": "HoneycodeDestinationProperties", "documentation": "The properties required to query Amazon Honeycode.
" }, "CustomerProfiles": { "shape": "CustomerProfilesDestinationProperties", "documentation": "The properties required to query Amazon Connect Customer Profiles.
" }, "Zendesk": { "shape": "ZendeskDestinationProperties", "documentation": "The properties required to query Zendesk.
" }, "Marketo": { "shape": "MarketoDestinationProperties", "documentation": "The properties required to query Marketo.
" }, "CustomConnector": { "shape": "CustomConnectorDestinationProperties", "documentation": "The properties that are required to query the custom Connector.
" }, "SAPOData": { "shape": "SAPODataDestinationProperties", "documentation": "The properties required to query SAPOData.
" } }, "documentation": "This stores the information that is required to query a particular connector.
" }, "DestinationField": { "type": "string", "max": 256, "pattern": ".*" }, "DestinationFieldProperties": { "type": "structure", "members": { "isCreatable": { "shape": "Boolean", "documentation": "Specifies if the destination field can be created by the current user.
" }, "isNullable": { "shape": "Boolean", "documentation": "Specifies if the destination field can have a null value.
" }, "isUpsertable": { "shape": "Boolean", "documentation": "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": { "shape": "Boolean", "documentation": " Specifies whether the field can be updated during an UPDATE
or UPSERT
write operation.
Specifies whether the field can use the default value during a Create operation.
" }, "supportedWriteOperations": { "shape": "SupportedWriteOperationList", "documentation": " 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.
The properties that can be applied to a field when connector is being used as a destination.
" }, "DestinationFlowConfig": { "type": "structure", "required": [ "connectorType", "destinationConnectorProperties" ], "members": { "connectorType": { "shape": "ConnectorType", "documentation": "The type of connector, such as Salesforce, Amplitude, and so on.
" }, "apiVersion": { "shape": "ApiVersion", "documentation": "The API version that the destination connector uses.
" }, "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": "The name of the connector profile. This name must be unique for each connector profile in the Amazon Web Services account.
" }, "destinationConnectorProperties": { "shape": "DestinationConnectorProperties", "documentation": "This stores the information that is required to query a particular connector.
" } }, "documentation": "Contains information about the configuration of destination connectors present in the flow.
" }, "DestinationFlowConfigList": { "type": "list", "member": { "shape": "DestinationFlowConfig" } }, "DocumentType": { "type": "string", "max": 512, "pattern": "[\\s\\w_-]+" }, "DomainName": { "type": "string", "max": 64, "pattern": "\\S+" }, "Double": { "type": "double" }, "DynatraceConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "BETWEEN", "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" ] }, "DynatraceConnectorProfileCredentials": { "type": "structure", "required": [ "apiToken" ], "members": { "apiToken": { "shape": "ApiToken", "documentation": "The API tokens used by Dynatrace API to authenticate various API calls.
" } }, "documentation": "The connector-specific profile credentials required by Dynatrace.
" }, "DynatraceConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Dynatrace resource.
" } }, "documentation": "The connector-specific profile properties required by Dynatrace.
" }, "DynatraceMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Dynatrace.
" }, "DynatraceSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Dynatrace flow source.
" } }, "documentation": "The properties that are applied when Dynatrace is being used as a source.
" }, "EntitiesPath": { "type": "string", "max": 256, "pattern": "[\\s\\w/!@#+=,.-]*" }, "EntityName": { "type": "string", "max": 1024, "pattern": "\\S+" }, "ErrorHandlingConfig": { "type": "structure", "members": { "failOnFirstDestinationError": { "shape": "Boolean", "documentation": "Specifies if the flow should fail after the first instance of a failure when attempting to place data in the destination.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "Specifies the Amazon S3 bucket prefix.
" }, "bucketName": { "shape": "BucketName", "documentation": "Specifies the name of the Amazon S3 bucket.
" } }, "documentation": " The settings that determine how Amazon AppFlow handles an error when placing data in the destination. For example, this setting would determine if the flow should fail after one insertion error, or continue and attempt to insert every record regardless of the initial failure. ErrorHandlingConfig
is a part of the destination connector details.
Specifies the failure count for the attempted flow.
" }, "executionMessage": { "shape": "ExecutionMessage", "documentation": "Specifies the error message that appears if a flow fails.
" } }, "documentation": "Provides details in the event of a failed flow, including the failure count and the related error messages.
" }, "EventBridgeDestinationProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Amazon EventBridge flow destination.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig" } }, "documentation": "The properties that are applied when Amazon EventBridge is being used as a destination.
" }, "EventBridgeMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Amazon EventBridge.
" }, "ExecutionDetails": { "type": "structure", "members": { "mostRecentExecutionMessage": { "shape": "MostRecentExecutionMessage", "documentation": "Describes the details of the most recent flow run.
" }, "mostRecentExecutionTime": { "shape": "Date", "documentation": "Specifies the time of the most recent flow run.
" }, "mostRecentExecutionStatus": { "shape": "ExecutionStatus", "documentation": "Specifies the status of the most recent flow run.
" } }, "documentation": "Describes the details of the flow run, including the timestamp, status, and message.
" }, "ExecutionId": { "type": "string", "max": 256, "pattern": "\\S+" }, "ExecutionIds": { "type": "list", "member": { "shape": "ExecutionId" }, "max": 100, "min": 0 }, "ExecutionMessage": { "type": "string", "max": 2048, "pattern": "[\\s\\w/!@#+=.-]*" }, "ExecutionRecord": { "type": "structure", "members": { "executionId": { "shape": "ExecutionId", "documentation": "Specifies the identifier of the given flow run.
" }, "executionStatus": { "shape": "ExecutionStatus", "documentation": "Specifies the flow run status and whether it is in progress, has completed successfully, or has failed.
" }, "executionResult": { "shape": "ExecutionResult", "documentation": "Describes the result of the given flow run.
" }, "startedAt": { "shape": "Date", "documentation": "Specifies the start time of the flow run.
" }, "lastUpdatedAt": { "shape": "Date", "documentation": "Specifies the time of the most recent update.
" }, "dataPullStartTime": { "shape": "Date", "documentation": "The timestamp that determines the first new or updated record to be transferred in the flow run.
" }, "dataPullEndTime": { "shape": "Date", "documentation": "The timestamp that indicates the last new or updated record to be transferred in the flow run.
" }, "metadataCatalogDetails": { "shape": "MetadataCatalogDetails", "documentation": "Describes the metadata catalog, metadata table, and data partitions that Amazon AppFlow used for the associated flow run.
" } }, "documentation": "Specifies information about the past flow run instances for a given flow.
" }, "ExecutionResult": { "type": "structure", "members": { "errorInfo": { "shape": "ErrorInfo", "documentation": "Provides any error message information related to the flow run.
" }, "bytesProcessed": { "shape": "Long", "documentation": "The total number of bytes processed by the flow run.
" }, "bytesWritten": { "shape": "Long", "documentation": "The total number of bytes written as a result of the flow run.
" }, "recordsProcessed": { "shape": "Long", "documentation": "The number of records processed in the flow run.
" }, "numParallelProcesses": { "shape": "Long", "documentation": "The number of processes that Amazon AppFlow ran at the same time when it retrieved your data.
" }, "maxPageSize": { "shape": "Long", "documentation": "The maximum number of records that Amazon AppFlow receives in each page of the response from your SAP application.
" } }, "documentation": "Specifies the end result of the flow run.
" }, "ExecutionStatus": { "type": "string", "enum": [ "InProgress", "Successful", "Error", "CancelStarted", "Canceled" ] }, "FieldType": { "type": "string" }, "FieldTypeDetails": { "type": "structure", "required": [ "fieldType", "filterOperators" ], "members": { "fieldType": { "shape": "FieldType", "documentation": "The type of field, such as string, integer, date, and so on.
" }, "filterOperators": { "shape": "FilterOperatorList", "documentation": "The list of operators supported by a field.
" }, "supportedValues": { "shape": "SupportedValueList", "documentation": " The list of values that a field can contain. For example, a Boolean fieldType
can have two values: \"true\" and \"false\".
The regular expression pattern for the field name.
" }, "supportedDateFormat": { "shape": "String", "documentation": "The date format that the field supports.
" }, "fieldValueRange": { "shape": "Range", "documentation": "The range of values this field can hold.
" }, "fieldLengthRange": { "shape": "Range", "documentation": "This is the allowable length range for this field's value.
" } }, "documentation": "Contains details regarding the supported field type and the operators that can be applied for filtering.
" }, "FileType": { "type": "string", "enum": [ "CSV", "JSON", "PARQUET" ] }, "FilterOperatorList": { "type": "list", "member": { "shape": "Operator" } }, "FlowArn": { "type": "string", "max": 512, "pattern": "arn:aws:appflow:.*:[0-9]+:.*" }, "FlowDefinition": { "type": "structure", "members": { "flowArn": { "shape": "FlowArn", "documentation": "The flow's Amazon Resource Name (ARN).
" }, "description": { "shape": "FlowDescription", "documentation": "A user-entered description of the flow.
" }, "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "flowStatus": { "shape": "FlowStatus", "documentation": "Indicates the current status of the flow.
" }, "sourceConnectorType": { "shape": "ConnectorType", "documentation": "Specifies the source connector type, such as Salesforce, Amazon S3, Amplitude, and so on.
" }, "sourceConnectorLabel": { "shape": "ConnectorLabel", "documentation": "The label of the source connector in the flow.
" }, "destinationConnectorType": { "shape": "ConnectorType", "documentation": "Specifies the destination connector type, such as Salesforce, Amazon S3, Amplitude, and so on.
" }, "destinationConnectorLabel": { "shape": "ConnectorLabel", "documentation": "The label of the destination connector in the flow.
" }, "triggerType": { "shape": "TriggerType", "documentation": " Specifies the type of flow trigger. This can be OnDemand
, Scheduled
, or Event
.
Specifies when the flow was created.
" }, "lastUpdatedAt": { "shape": "Date", "documentation": "Specifies when the flow was last updated.
" }, "createdBy": { "shape": "CreatedBy", "documentation": "The ARN of the user who created the flow.
" }, "lastUpdatedBy": { "shape": "UpdatedBy", "documentation": "Specifies the account user name that most recently updated the flow.
" }, "tags": { "shape": "TagMap", "documentation": "The tags used to organize, track, or control access for your flow.
" }, "lastRunExecutionDetails": { "shape": "ExecutionDetails", "documentation": "Describes the details of the most recent flow run.
" } }, "documentation": "The properties of the flow, such as its source, destination, trigger type, and so on.
" }, "FlowDescription": { "type": "string", "max": 2048, "pattern": "[\\w!@#\\-.?,\\s]*" }, "FlowErrorDeactivationThreshold": { "type": "integer", "max": 100, "min": 1 }, "FlowExecutionList": { "type": "list", "member": { "shape": "ExecutionRecord" } }, "FlowList": { "type": "list", "member": { "shape": "FlowDefinition" } }, "FlowName": { "type": "string", "max": 256, "pattern": "[a-zA-Z0-9][\\w!@#.-]+" }, "FlowStatus": { "type": "string", "enum": [ "Active", "Deprecated", "Deleted", "Draft", "Errored", "Suspended" ] }, "FlowStatusMessage": { "type": "string", "max": 2048, "pattern": "[\\s\\w/!@#+=.-]*" }, "GlueDataCatalogConfig": { "type": "structure", "required": [ "roleArn", "databaseName", "tablePrefix" ], "members": { "roleArn": { "shape": "GlueDataCatalogIAMRole", "documentation": "The Amazon Resource Name (ARN) of an IAM role that grants Amazon AppFlow the permissions it needs to create Data Catalog tables, databases, and partitions.
For an example IAM policy that has the required permissions, see Identity-based policy examples for Amazon AppFlow.
" }, "databaseName": { "shape": "GlueDataCatalogDatabaseName", "documentation": "The name of the Data Catalog database that stores the metadata tables that Amazon AppFlow creates in your Amazon Web Services account. These tables contain metadata for the data that's transferred by the flow that you configure with this parameter.
When you configure a new flow with this parameter, you must specify an existing database.
A naming prefix for each Data Catalog table that Amazon AppFlow creates for the flow that you configure with this setting. Amazon AppFlow adds the prefix to the beginning of the each table name.
" } }, "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs your data with the Glue Data Catalog. When Amazon AppFlow catalogs your data, it stores metadata in Data Catalog tables. This metadata represents the data that's transferred by the flow that you configure with these settings.
You can configure a flow with these settings only when the flow destination is Amazon S3.
The identifier for the desired client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Google Analytics resources.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The credentials used to acquire new access tokens. This is required only for OAuth2 access tokens, and is not required for OAuth1 access tokens.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" } }, "documentation": "The connector-specific profile credentials required by Google Analytics.
" }, "GoogleAnalyticsConnectorProfileProperties": { "type": "structure", "members": {}, "documentation": "The connector-specific profile properties required by Google Analytics.
" }, "GoogleAnalyticsMetadata": { "type": "structure", "members": { "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The desired authorization scope for the Google Analytics account.
" } }, "documentation": "The connector metadata specific to Google Analytics.
" }, "GoogleAnalyticsSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Google Analytics flow source.
" } }, "documentation": "The properties that are applied when Google Analytics is being used as a source.
" }, "Group": { "type": "string", "max": 128, "pattern": "\\S+" }, "HoneycodeConnectorProfileCredentials": { "type": "structure", "members": { "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Amazon Honeycode resources.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The credentials used to acquire new access tokens.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest" } }, "documentation": "The connector-specific credentials required when using Amazon Honeycode.
" }, "HoneycodeConnectorProfileProperties": { "type": "structure", "members": {}, "documentation": "The connector-specific properties required when using Amazon Honeycode.
" }, "HoneycodeDestinationProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Amazon Honeycode flow destination.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig" } }, "documentation": "The properties that are applied when Amazon Honeycode is used as a destination.
" }, "HoneycodeMetadata": { "type": "structure", "members": { "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The desired authorization scope for the Amazon Honeycode account.
" } }, "documentation": "The connector metadata specific to Amazon Honeycode.
" }, "IdFieldNameList": { "type": "list", "member": { "shape": "Name" }, "documentation": "A list of field names that can be used as an ID field when performing a write operation.
", "min": 0 }, "Identifier": { "type": "string", "max": 128, "pattern": "\\S+" }, "IncrementalPullConfig": { "type": "structure", "members": { "datetimeTypeFieldName": { "shape": "DatetimeTypeFieldName", "documentation": "A field that specifies the date time or timestamp field as the criteria to use when importing incremental records from the source.
" } }, "documentation": "Specifies the configuration used when importing incremental records from the source.
" }, "InforNexusConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "BETWEEN", "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" ] }, "InforNexusConnectorProfileCredentials": { "type": "structure", "required": [ "accessKeyId", "userId", "secretAccessKey", "datakey" ], "members": { "accessKeyId": { "shape": "AccessKeyId", "documentation": "The Access Key portion of the credentials.
" }, "userId": { "shape": "Username", "documentation": "The identifier for the user.
" }, "secretAccessKey": { "shape": "Key", "documentation": "The secret key used to sign requests.
" }, "datakey": { "shape": "Key", "documentation": "The encryption keys used to encrypt data.
" } }, "documentation": "The connector-specific profile credentials required by Infor Nexus.
" }, "InforNexusConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Infor Nexus resource.
" } }, "documentation": "The connector-specific profile properties required by Infor Nexus.
" }, "InforNexusMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Infor Nexus.
" }, "InforNexusSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Infor Nexus flow source.
" } }, "documentation": "The properties that are applied when Infor Nexus is being used as a source.
" }, "InstanceUrl": { "type": "string", "max": 256, "pattern": "\\S+" }, "JavaBoolean": { "type": "boolean" }, "JwtToken": { "type": "string", "max": 8000, "pattern": "^([a-zA-Z0-9_=]+)\\.([a-zA-Z0-9_=]+)\\.([a-zA-Z0-9_\\-\\+\\/=]*)", "sensitive": true }, "KMSArn": { "type": "string", "max": 2048, "min": 20, "pattern": "arn:aws:kms:.*:[0-9]+:.*" }, "Key": { "type": "string", "max": 512, "pattern": "\\S+" }, "Label": { "type": "string", "max": 128, "pattern": ".*" }, "LambdaConnectorProvisioningConfig": { "type": "structure", "required": [ "lambdaArn" ], "members": { "lambdaArn": { "shape": "ARN", "documentation": "Lambda ARN of the connector being registered.
" } }, "documentation": "Contains information about the configuration of the lambda which is being registered as the connector.
" }, "ListConnectorEntitiesRequest": { "type": "structure", "members": { "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile. The name is unique for each ConnectorProfile
in the Amazon Web Services account, and is used to query the downstream connector.
The type of connector, such as Salesforce, Amplitude, and so on.
" }, "entitiesPath": { "shape": "EntitiesPath", "documentation": " This optional parameter is specific to connector implementation. Some connectors support multiple levels or categories of entities. You can find out the list of roots for such providers by sending a request without the entitiesPath
parameter. If the connector supports entities at different roots, this initial request returns the list of roots. Otherwise, this request returns all entities supported by the provider.
The version of the API that's used by the connector.
" }, "maxResults": { "shape": "ListEntitiesMaxResults", "documentation": "The maximum number of items that the operation returns in the response.
" }, "nextToken": { "shape": "NextToken", "documentation": "A token that was provided by your prior ListConnectorEntities
operation if the response was too big for the page size. You specify this token to get the next page of results in paginated response.
The response of ListConnectorEntities
lists entities grouped by category. This map's key represents the group name, and its value contains the list of entities belonging to that group.
A token that you specify in your next ListConnectorEntities
operation to get the next page of results in paginated response. The ListConnectorEntities
operation provides this token if the response is too big for the page size.
Specifies the maximum number of items that should be returned in the result set. The default for maxResults
is 20 (for all paginated API operations).
The pagination token for the next page of data.
" } } }, "ListConnectorsResponse": { "type": "structure", "members": { "connectors": { "shape": "ConnectorList", "documentation": "Contains information about the connectors supported by Amazon AppFlow.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for the next page of data. If nextToken=null, this means that all records have been fetched.
" } } }, "ListEntitiesMaxResults": { "type": "integer", "max": 10000, "min": 1 }, "ListFlowsRequest": { "type": "structure", "members": { "maxResults": { "shape": "MaxResults", "documentation": "Specifies the maximum number of items that should be returned in the result set.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for next page of data.
" } } }, "ListFlowsResponse": { "type": "structure", "members": { "flows": { "shape": "FlowList", "documentation": "The list of flows associated with your account.
" }, "nextToken": { "shape": "NextToken", "documentation": "The pagination token for next page of data.
" } } }, "ListTagsForResourceRequest": { "type": "structure", "required": [ "resourceArn" ], "members": { "resourceArn": { "shape": "ARN", "documentation": "The Amazon Resource Name (ARN) of the specified flow.
", "location": "uri", "locationName": "resourceArn" } } }, "ListTagsForResourceResponse": { "type": "structure", "members": { "tags": { "shape": "TagMap", "documentation": "The tags used to organize, track, or control access for your flow.
" } } }, "LogoURL": { "type": "string", "max": 256, "pattern": "^(https?|ftp|file)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]" }, "LogonLanguage": { "type": "string", "max": 2, "pattern": "^[a-zA-Z0-9_]*$" }, "Long": { "type": "long" }, "LookoutMetricsDestinationProperties": { "type": "structure", "members": {}, "documentation": "The properties that are applied when Amazon Lookout for Metrics is used as a destination.
" }, "MarketoConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "LESS_THAN", "GREATER_THAN", "BETWEEN", "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" ] }, "MarketoConnectorProfileCredentials": { "type": "structure", "required": [ "clientId", "clientSecret" ], "members": { "clientId": { "shape": "ClientId", "documentation": "The identifier for the desired client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Marketo resources.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" } }, "documentation": "The connector-specific profile credentials required by Marketo.
" }, "MarketoConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Marketo resource.
" } }, "documentation": "The connector-specific profile properties required when using Marketo.
" }, "MarketoDestinationProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Marketo flow destination.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig" } }, "documentation": "The properties that Amazon AppFlow applies when you use Marketo as a flow destination.
" }, "MarketoMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Marketo.
" }, "MarketoSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Marketo flow source.
" } }, "documentation": "The properties that are applied when Marketo is being used as a source.
" }, "MaxResults": { "type": "integer", "max": 100, "min": 1 }, "MetadataCatalogConfig": { "type": "structure", "members": { "glueDataCatalog": { "shape": "GlueDataCatalogConfig", "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs your data with the Glue Data Catalog.
" } }, "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs your data. When Amazon AppFlow catalogs your data, it stores metadata in a data catalog.
" }, "MetadataCatalogDetail": { "type": "structure", "members": { "catalogType": { "shape": "CatalogType", "documentation": "The type of metadata catalog that Amazon AppFlow used for the associated flow run. This parameter returns the following value:
The metadata catalog is provided by the Glue Data Catalog. Glue includes the Glue Data Catalog as a component.
The name of the table that stores the metadata for the associated flow run. The table stores metadata that represents the data that the flow transferred. Amazon AppFlow stores the table in the metadata catalog.
" }, "tableRegistrationOutput": { "shape": "RegistrationOutput", "documentation": "Describes the status of the attempt from Amazon AppFlow to register the metadata table with the metadata catalog. Amazon AppFlow creates or updates this table for the associated flow run.
" }, "partitionRegistrationOutput": { "shape": "RegistrationOutput", "documentation": "Describes the status of the attempt from Amazon AppFlow to register the data partitions with the metadata catalog. The data partitions organize the flow output into a hierarchical path, such as a folder path in an S3 bucket. Amazon AppFlow creates the partitions (if they don't already exist) based on your flow configuration.
" } }, "documentation": "Describes the metadata catalog, metadata table, and data partitions that Amazon AppFlow used for the associated flow run.
" }, "MetadataCatalogDetails": { "type": "list", "member": { "shape": "MetadataCatalogDetail" } }, "MostRecentExecutionMessage": { "type": "string", "max": 2048, "pattern": "[\\w!@#\\-.?,\\s]*" }, "Name": { "type": "string", "max": 128, "pattern": "\\S+" }, "NextToken": { "type": "string", "max": 2048, "pattern": "\\S+" }, "OAuth2Credentials": { "type": "structure", "members": { "clientId": { "shape": "ClientId", "documentation": "The identifier for the desired client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The access token used to access the connector on your behalf.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The refresh token used to refresh an expired access token.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest" } }, "documentation": "The OAuth 2.0 credentials required for OAuth 2.0 authentication.
" }, "OAuth2CustomParameter": { "type": "structure", "members": { "key": { "shape": "Key", "documentation": "The key of the custom parameter required for OAuth 2.0 authentication.
" }, "isRequired": { "shape": "Boolean", "documentation": "Indicates whether the custom parameter for OAuth 2.0 authentication is required.
" }, "label": { "shape": "Label", "documentation": "The label of the custom parameter used for OAuth 2.0 authentication.
" }, "description": { "shape": "Description", "documentation": "A description about the custom parameter used for OAuth 2.0 authentication.
" }, "isSensitiveField": { "shape": "Boolean", "documentation": "Indicates whether this authentication custom parameter is a sensitive field.
" }, "connectorSuppliedValues": { "shape": "ConnectorSuppliedValueList", "documentation": "Contains default values for this authentication parameter that are supplied by the connector.
" }, "type": { "shape": "OAuth2CustomPropType", "documentation": "Indicates whether custom parameter is used with TokenUrl or AuthUrl.
" } }, "documentation": "Custom parameter required for OAuth 2.0 authentication.
" }, "OAuth2CustomPropType": { "type": "string", "enum": [ "TOKEN_URL", "AUTH_URL" ] }, "OAuth2CustomPropertiesList": { "type": "list", "member": { "shape": "OAuth2CustomParameter" } }, "OAuth2Defaults": { "type": "structure", "members": { "oauthScopes": { "shape": "OAuthScopeList", "documentation": "OAuth 2.0 scopes that the connector supports.
" }, "tokenUrls": { "shape": "TokenUrlList", "documentation": "Token URLs that can be used for OAuth 2.0 authentication.
" }, "authCodeUrls": { "shape": "AuthCodeUrlList", "documentation": "Auth code URLs that can be used for OAuth 2.0 authentication.
" }, "oauth2GrantTypesSupported": { "shape": "OAuth2GrantTypeSupportedList", "documentation": "OAuth 2.0 grant types supported by the connector.
" }, "oauth2CustomProperties": { "shape": "OAuth2CustomPropertiesList", "documentation": "List of custom parameters required for OAuth 2.0 authentication.
" } }, "documentation": "Contains the default values required for OAuth 2.0 authentication.
" }, "OAuth2GrantType": { "type": "string", "enum": [ "CLIENT_CREDENTIALS", "AUTHORIZATION_CODE", "JWT_BEARER" ] }, "OAuth2GrantTypeSupportedList": { "type": "list", "member": { "shape": "OAuth2GrantType" } }, "OAuth2Properties": { "type": "structure", "required": [ "tokenUrl", "oAuth2GrantType" ], "members": { "tokenUrl": { "shape": "TokenUrl", "documentation": "The token URL required for OAuth 2.0 authentication.
" }, "oAuth2GrantType": { "shape": "OAuth2GrantType", "documentation": "The OAuth 2.0 grant type used by connector for OAuth 2.0 authentication.
" }, "tokenUrlCustomProperties": { "shape": "TokenUrlCustomProperties", "documentation": "Associates your token URL with a map of properties that you define. Use this parameter to provide any additional details that the connector requires to authenticate your request.
" } }, "documentation": "The OAuth 2.0 properties required for OAuth 2.0 authentication.
" }, "OAuthCredentials": { "type": "structure", "required": [ "clientId", "clientSecret" ], "members": { "clientId": { "shape": "ClientId", "documentation": "The identifier for the desired client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The access token used to access protected SAPOData resources.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The refresh token used to refresh expired access token.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" } }, "documentation": "The OAuth credentials required for OAuth type authentication.
" }, "OAuthProperties": { "type": "structure", "required": [ "tokenUrl", "authCodeUrl", "oAuthScopes" ], "members": { "tokenUrl": { "shape": "TokenUrl", "documentation": "The token url required to fetch access/refresh tokens using authorization code and also to refresh expired access token using refresh token.
" }, "authCodeUrl": { "shape": "AuthCodeUrl", "documentation": "The authorization code url required to redirect to SAP Login Page to fetch authorization code for OAuth type authentication.
" }, "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The OAuth scopes required for OAuth type authentication.
" } }, "documentation": "The OAuth properties required for OAuth type authentication.
" }, "OAuthScope": { "type": "string", "max": 128, "pattern": "\\S+" }, "OAuthScopeList": { "type": "list", "member": { "shape": "OAuthScope" } }, "Object": { "type": "string", "max": 512, "pattern": "\\S+" }, "ObjectTypeName": { "type": "string", "max": 255, "pattern": "\\S+" }, "Operator": { "type": "string", "enum": [ "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" ] }, "OperatorPropertiesKeys": { "type": "string", "enum": [ "VALUE", "VALUES", "DATA_TYPE", "UPPER_BOUND", "LOWER_BOUND", "SOURCE_DATA_TYPE", "DESTINATION_DATA_TYPE", "VALIDATION_ACTION", "MASK_VALUE", "MASK_LENGTH", "TRUNCATE_LENGTH", "MATH_OPERATION_FIELDS_ORDER", "CONCAT_FORMAT", "SUBFIELD_CATEGORY_MAP", "EXCLUDE_SOURCE_FIELDS_LIST", "INCLUDE_NEW_FIELDS", "ORDERED_PARTITION_KEYS_LIST" ] }, "Operators": { "type": "string", "enum": [ "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" ] }, "PardotConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "EQUAL_TO", "NO_OP", "ADDITION", "MULTIPLICATION", "DIVISION", "SUBTRACTION", "MASK_ALL", "MASK_FIRST_N", "MASK_LAST_N", "VALIDATE_NON_NULL", "VALIDATE_NON_ZERO", "VALIDATE_NON_NEGATIVE", "VALIDATE_NUMERIC" ] }, "PardotConnectorProfileCredentials": { "type": "structure", "members": { "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Salesforce Pardot resources.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The credentials used to acquire new access tokens.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest" }, "clientCredentialsArn": { "shape": "ClientCredentialsArn", "documentation": "The secret manager ARN, which contains the client ID and client secret of the connected app.
" } }, "documentation": "The connector-specific profile credentials required when using Salesforce Pardot.
" }, "PardotConnectorProfileProperties": { "type": "structure", "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Salesforce Pardot resource.
" }, "isSandboxEnvironment": { "shape": "Boolean", "documentation": "Indicates whether the connector profile applies to a sandbox or production environment.
" }, "businessUnitId": { "shape": "BusinessUnitId", "documentation": "The business unit id of Salesforce Pardot instance.
" } }, "documentation": "The connector-specific profile properties required when using Salesforce Pardot.
" }, "PardotMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Salesforce Pardot.
" }, "PardotSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Salesforce Pardot flow source.
" } }, "documentation": "The properties that are applied when Salesforce Pardot is being used as a source.
" }, "Password": { "type": "string", "max": 512, "pattern": ".*", "sensitive": true }, "PathPrefix": { "type": "string", "enum": [ "EXECUTION_ID", "SCHEMA_VERSION" ] }, "PathPrefixHierarchy": { "type": "list", "member": { "shape": "PathPrefix" } }, "PortNumber": { "type": "integer", "max": 65535, "min": 1 }, "PrefixConfig": { "type": "structure", "members": { "prefixType": { "shape": "PrefixType", "documentation": "Determines the format of the prefix, and whether it applies to the file name, file path, or both.
" }, "prefixFormat": { "shape": "PrefixFormat", "documentation": "Determines the level of granularity for the date and time that's included in the prefix.
" }, "pathPrefixHierarchy": { "shape": "PathPrefixHierarchy", "documentation": "Specifies whether the destination file path includes either or both of the following elements:
The ID that Amazon AppFlow assigns to the flow run.
The version number of your data schema. Amazon AppFlow assigns this version number. The version number increases by one when you change any of the following settings in your flow configuration:
Source-to-destination field mappings
Field data types
Partition keys
Specifies elements that Amazon AppFlow includes in the file and folder names in the flow destination.
" }, "PrefixFormat": { "type": "string", "enum": [ "YEAR", "MONTH", "DAY", "HOUR", "MINUTE" ] }, "PrefixType": { "type": "string", "enum": [ "FILENAME", "PATH", "PATH_AND_FILENAME" ] }, "PrivateConnectionProvisioningFailureCause": { "type": "string", "enum": [ "CONNECTOR_AUTHENTICATION", "CONNECTOR_SERVER", "INTERNAL_SERVER", "ACCESS_DENIED", "VALIDATION" ] }, "PrivateConnectionProvisioningFailureMessage": { "type": "string", "max": 2048, "pattern": "[\\s\\w/!@#+=.-]*" }, "PrivateConnectionProvisioningState": { "type": "structure", "members": { "status": { "shape": "PrivateConnectionProvisioningStatus", "documentation": "Specifies the private connection provisioning status.
" }, "failureMessage": { "shape": "PrivateConnectionProvisioningFailureMessage", "documentation": "Specifies the private connection provisioning failure reason.
" }, "failureCause": { "shape": "PrivateConnectionProvisioningFailureCause", "documentation": "Specifies the private connection provisioning failure cause.
" } }, "documentation": "Specifies the private connection provisioning state.
" }, "PrivateConnectionProvisioningStatus": { "type": "string", "enum": [ "FAILED", "PENDING", "CREATED" ] }, "PrivateLinkServiceName": { "type": "string", "max": 512, "pattern": "^$|com.amazonaws.vpce.[\\w/!:@#.\\-]+" }, "ProfilePropertiesMap": { "type": "map", "key": { "shape": "ProfilePropertyKey" }, "value": { "shape": "ProfilePropertyValue" }, "max": 50, "min": 0 }, "ProfilePropertyKey": { "type": "string", "max": 128, "min": 1, "pattern": "[\\w]+" }, "ProfilePropertyValue": { "type": "string", "max": 2048, "pattern": "\\S+" }, "Property": { "type": "string", "max": 2048, "pattern": ".+" }, "Range": { "type": "structure", "members": { "maximum": { "shape": "Double", "documentation": "Maximum value supported by the field.
" }, "minimum": { "shape": "Double", "documentation": "Minimum value supported by the field.
" } }, "documentation": "The range of values that the property supports.
" }, "RedirectUri": { "type": "string", "max": 512, "pattern": "\\S+" }, "RedshiftConnectorProfileCredentials": { "type": "structure", "members": { "username": { "shape": "String", "documentation": "The name of the user.
" }, "password": { "shape": "Password", "documentation": "The password that corresponds to the user name.
" } }, "documentation": "The connector-specific profile credentials required when using Amazon Redshift.
" }, "RedshiftConnectorProfileProperties": { "type": "structure", "required": [ "bucketName", "roleArn" ], "members": { "databaseUrl": { "shape": "DatabaseUrl", "documentation": "The JDBC URL of the Amazon Redshift cluster.
" }, "bucketName": { "shape": "BucketName", "documentation": "A name for the associated Amazon S3 bucket.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the destination bucket in which Amazon AppFlow places the files.
" }, "roleArn": { "shape": "RoleArn", "documentation": "The Amazon Resource Name (ARN) of IAM role that grants Amazon Redshift read-only access to Amazon S3. For more information, and for the polices that you attach to this role, see Allow Amazon Redshift to access your Amazon AppFlow data in Amazon S3.
" }, "dataApiRoleArn": { "shape": "DataApiRoleArn", "documentation": "The Amazon Resource Name (ARN) of an IAM role that permits Amazon AppFlow to access your Amazon Redshift database through the Data API. For more information, and for the polices that you attach to this role, see Allow Amazon AppFlow to access Amazon Redshift databases with the Data API.
" }, "isRedshiftServerless": { "shape": "Boolean", "documentation": "Indicates whether the connector profile defines a connection to an Amazon Redshift Serverless data warehouse.
" }, "clusterIdentifier": { "shape": "ClusterIdentifier", "documentation": "The unique ID that's assigned to an Amazon Redshift cluster.
" }, "workgroupName": { "shape": "WorkgroupName", "documentation": "The name of an Amazon Redshift workgroup.
" }, "databaseName": { "shape": "DatabaseName", "documentation": "The name of an Amazon Redshift database.
" } }, "documentation": "The connector-specific profile properties when using Amazon Redshift.
" }, "RedshiftDestinationProperties": { "type": "structure", "required": [ "object", "intermediateBucketName" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Amazon Redshift flow destination.
" }, "intermediateBucketName": { "shape": "BucketName", "documentation": "The intermediate bucket that Amazon AppFlow uses when moving data into Amazon Redshift.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the bucket in which Amazon AppFlow places the destination files.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig", "documentation": " The settings that determine how Amazon AppFlow handles an error when placing data in the Amazon Redshift destination. For example, this setting would determine if the flow should fail after one insertion error, or continue and attempt to insert every record regardless of the initial failure. ErrorHandlingConfig
is a part of the destination connector details.
The properties that are applied when Amazon Redshift is being used as a destination.
" }, "RedshiftMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Amazon Redshift.
" }, "RefreshToken": { "type": "string", "max": 4096, "pattern": "\\S+" }, "Region": { "type": "string", "max": 64, "pattern": "\\S+" }, "RegionList": { "type": "list", "member": { "shape": "Region" } }, "RegisterConnectorRequest": { "type": "structure", "members": { "connectorLabel": { "shape": "ConnectorLabel", "documentation": " The name of the connector. The name is unique for each ConnectorRegistration
in your Amazon Web Services account.
A description about the connector that's being registered.
" }, "connectorProvisioningType": { "shape": "ConnectorProvisioningType", "documentation": "The provisioning type of the connector. Currently the only supported value is LAMBDA.
" }, "connectorProvisioningConfig": { "shape": "ConnectorProvisioningConfig", "documentation": "The provisioning type of the connector. Currently the only supported value is LAMBDA.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your RegisterConnector
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to RegisterConnector
. The token is active for 8 hours.
The ARN of the connector being registered.
" } } }, "RegisteredBy": { "type": "string", "max": 512, "pattern": "\\S+" }, "RegistrationOutput": { "type": "structure", "members": { "message": { "shape": "String", "documentation": "Explains the status of the registration attempt from Amazon AppFlow. If the attempt fails, the message explains why.
" }, "result": { "shape": "String", "documentation": "Indicates the number of resources that Amazon AppFlow created or updated. Possible resources include metadata tables and data partitions.
" }, "status": { "shape": "ExecutionStatus", "documentation": "Indicates the status of the registration attempt from Amazon AppFlow.
" } }, "documentation": "Describes the status of an attempt from Amazon AppFlow to register a resource.
When you run a flow that you've configured to use a metadata catalog, Amazon AppFlow registers a metadata table and data partitions with that catalog. This operation provides the status of that registration attempt. The operation also indicates how many related resources Amazon AppFlow created or updated.
" }, "ResetConnectorMetadataCacheRequest": { "type": "structure", "members": { "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": "The name of the connector profile that you want to reset cached metadata for.
You can omit this parameter if you're resetting the cache for any of the following connectors: Amazon Connect, Amazon EventBridge, Amazon Lookout for Metrics, Amazon S3, or Upsolver. If you're resetting the cache for any other connector, you must include this parameter in your request.
" }, "connectorType": { "shape": "ConnectorType", "documentation": "The type of connector to reset cached metadata for.
You must include this parameter in your request if you're resetting the cache for any of the following connectors: Amazon Connect, Amazon EventBridge, Amazon Lookout for Metrics, Amazon S3, or Upsolver. If you're resetting the cache for any other connector, you can omit this parameter from your request.
" }, "connectorEntityName": { "shape": "EntityName", "documentation": "Use this parameter if you want to reset cached metadata about the details for an individual entity.
If you don't include this parameter in your request, Amazon AppFlow only resets cached metadata about entity names, not entity details.
" }, "entitiesPath": { "shape": "EntitiesPath", "documentation": "Use this parameter only if you’re resetting the cached metadata about a nested entity. Only some connectors support nested entities. A nested entity is one that has another entity as a parent. To use this parameter, specify the name of the parent entity.
To look up the parent-child relationship of entities, you can send a ListConnectorEntities request that omits the entitiesPath parameter. Amazon AppFlow will return a list of top-level entities. For each one, it indicates whether the entity has nested entities. Then, in a subsequent ListConnectorEntities request, you can specify a parent entity name for the entitiesPath parameter. Amazon AppFlow will return a list of the child entities for that parent.
" }, "apiVersion": { "shape": "ApiVersion", "documentation": "The API version that you specified in the connector profile that you’re resetting cached metadata for. You must use this parameter only if the connector supports multiple API versions or if the connector type is CustomConnector.
To look up how many versions a connector supports, use the DescribeConnectors action. In the response, find the value that Amazon AppFlow returns for the connectorVersion parameter.
To look up the connector type, use the DescribeConnectorProfiles action. In the response, find the value that Amazon AppFlow returns for the connectorType parameter.
To look up the API version that you specified in a connector profile, use the DescribeConnectorProfiles action.
" } } }, "ResetConnectorMetadataCacheResponse": { "type": "structure", "members": {} }, "RoleArn": { "type": "string", "max": 512, "pattern": "arn:aws:iam:.*:[0-9]+:.*" }, "S3ConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "LESS_THAN", "GREATER_THAN", "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" ] }, "S3DestinationProperties": { "type": "structure", "required": [ "bucketName" ], "members": { "bucketName": { "shape": "BucketName", "documentation": "The Amazon S3 bucket name in which Amazon AppFlow places the transferred data.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the destination bucket in which Amazon AppFlow places the files.
" }, "s3OutputFormatConfig": { "shape": "S3OutputFormatConfig" } }, "documentation": "The properties that are applied when Amazon S3 is used as a destination.
" }, "S3InputFileType": { "type": "string", "enum": [ "CSV", "JSON" ] }, "S3InputFormatConfig": { "type": "structure", "members": { "s3InputFileType": { "shape": "S3InputFileType", "documentation": "The file type that Amazon AppFlow gets from your Amazon S3 bucket.
" } }, "documentation": "When you use Amazon S3 as the source, the configuration format that you provide the flow input data.
" }, "S3Metadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Amazon S3.
" }, "S3OutputFormatConfig": { "type": "structure", "members": { "fileType": { "shape": "FileType", "documentation": "Indicates the file type that Amazon AppFlow places in the Amazon S3 bucket.
" }, "prefixConfig": { "shape": "PrefixConfig", "documentation": "Determines the prefix that Amazon AppFlow applies to the folder name in the Amazon S3 bucket. You can name folders according to the flow frequency and date.
" }, "aggregationConfig": { "shape": "AggregationConfig" }, "preserveSourceDataTyping": { "shape": "JavaBoolean", "documentation": "If your file output format is Parquet, use this parameter to set whether Amazon AppFlow preserves the data types in your source data when it writes the output to Amazon S3.
true
: Amazon AppFlow preserves the data types when it writes to Amazon S3. For example, an integer or 1
in your source data is still an integer in your output.
false
: Amazon AppFlow converts all of the source data into strings when it writes to Amazon S3. For example, an integer of 1
in your source data becomes the string \"1\"
in the output.
The configuration that determines how Amazon AppFlow should format the flow output data when Amazon S3 is used as the destination.
" }, "S3SourceProperties": { "type": "structure", "required": [ "bucketName" ], "members": { "bucketName": { "shape": "BucketName", "documentation": "The Amazon S3 bucket name where the source files are stored.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the Amazon S3 bucket in which the source files are stored.
" }, "s3InputFormatConfig": { "shape": "S3InputFormatConfig" } }, "documentation": "The properties that are applied when Amazon S3 is being used as the flow source.
" }, "SAPODataConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "LESS_THAN", "CONTAINS", "GREATER_THAN", "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" ] }, "SAPODataConnectorProfileCredentials": { "type": "structure", "members": { "basicAuthCredentials": { "shape": "BasicAuthCredentials", "documentation": "The SAPOData basic authentication credentials.
" }, "oAuthCredentials": { "shape": "OAuthCredentials", "documentation": "The SAPOData OAuth type authentication credentials.
" } }, "documentation": "The connector-specific profile credentials required when using SAPOData.
" }, "SAPODataConnectorProfileProperties": { "type": "structure", "required": [ "applicationHostUrl", "applicationServicePath", "portNumber", "clientNumber" ], "members": { "applicationHostUrl": { "shape": "ApplicationHostUrl", "documentation": "The location of the SAPOData resource.
" }, "applicationServicePath": { "shape": "ApplicationServicePath", "documentation": "The application path to catalog service.
" }, "portNumber": { "shape": "PortNumber", "documentation": "The port number of the SAPOData instance.
", "box": true }, "clientNumber": { "shape": "ClientNumber", "documentation": "The client number for the client creating the connection.
" }, "logonLanguage": { "shape": "LogonLanguage", "documentation": "The logon language of SAPOData instance.
" }, "privateLinkServiceName": { "shape": "PrivateLinkServiceName", "documentation": "The SAPOData Private Link service name to be used for private data transfers.
" }, "oAuthProperties": { "shape": "OAuthProperties", "documentation": "The SAPOData OAuth properties required for OAuth type authentication.
" }, "disableSSO": { "shape": "Boolean", "documentation": "If you set this parameter to true
, Amazon AppFlow bypasses the single sign-on (SSO) settings in your SAP account when it accesses your SAP OData instance.
Whether you need this option depends on the types of credentials that you applied to your SAP OData connection profile. If your profile uses basic authentication credentials, SAP SSO can prevent Amazon AppFlow from connecting to your account with your username and password. In this case, bypassing SSO makes it possible for Amazon AppFlow to connect successfully. However, if your profile uses OAuth credentials, this parameter has no affect.
" } }, "documentation": "The connector-specific profile properties required when using SAPOData.
" }, "SAPODataDestinationProperties": { "type": "structure", "required": [ "objectPath" ], "members": { "objectPath": { "shape": "Object", "documentation": "The object path specified in the SAPOData flow destination.
" }, "successResponseHandlingConfig": { "shape": "SuccessResponseHandlingConfig", "documentation": "Determines how Amazon AppFlow handles the success response that it gets from the connector after placing data.
For example, this setting would determine where to write the response from a destination connector upon a successful insert operation.
" }, "idFieldNames": { "shape": "IdFieldNameList" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig" }, "writeOperationType": { "shape": "WriteOperationType" } }, "documentation": "The properties that are applied when using SAPOData as a flow destination
" }, "SAPODataMaxPageSize": { "type": "integer", "max": 10000, "min": 1 }, "SAPODataMaxParallelism": { "type": "integer", "max": 10, "min": 1 }, "SAPODataMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to SAPOData.
" }, "SAPODataPaginationConfig": { "type": "structure", "required": [ "maxPageSize" ], "members": { "maxPageSize": { "shape": "SAPODataMaxPageSize", "documentation": "The maximum number of records that Amazon AppFlow receives in each page of the response from your SAP application. For transfers of OData records, the maximum page size is 3,000. For transfers of data that comes from an ODP provider, the maximum page size is 10,000.
", "box": true } }, "documentation": "Sets the page size for each concurrent process that transfers OData records from your SAP instance. A concurrent process is query that retrieves a batch of records as part of a flow run. Amazon AppFlow can run multiple concurrent processes in parallel to transfer data faster.
" }, "SAPODataParallelismConfig": { "type": "structure", "required": [ "maxParallelism" ], "members": { "maxParallelism": { "shape": "SAPODataMaxParallelism", "documentation": "The maximum number of processes that Amazon AppFlow runs at the same time when it retrieves your data from your SAP application.
", "box": true } }, "documentation": "Sets the number of concurrent processes that transfer OData records from your SAP instance. A concurrent process is query that retrieves a batch of records as part of a flow run. Amazon AppFlow can run multiple concurrent processes in parallel to transfer data faster.
" }, "SAPODataSourceProperties": { "type": "structure", "members": { "objectPath": { "shape": "Object", "documentation": "The object path specified in the SAPOData flow source.
" }, "parallelismConfig": { "shape": "SAPODataParallelismConfig", "documentation": "Sets the number of concurrent processes that transfers OData records from your SAP instance.
" }, "paginationConfig": { "shape": "SAPODataPaginationConfig", "documentation": "Sets the page size for each concurrent process that transfers OData records from your SAP instance.
" } }, "documentation": "The properties that are applied when using SAPOData as a flow source.
" }, "SalesforceConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "LESS_THAN", "CONTAINS", "GREATER_THAN", "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" ] }, "SalesforceConnectorProfileCredentials": { "type": "structure", "members": { "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Salesforce resources.
" }, "refreshToken": { "shape": "RefreshToken", "documentation": "The credentials used to acquire new access tokens.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" }, "clientCredentialsArn": { "shape": "ClientCredentialsArn", "documentation": "The secret manager ARN, which contains the client ID and client secret of the connected app.
" }, "oAuth2GrantType": { "shape": "OAuth2GrantType", "documentation": "Specifies the OAuth 2.0 grant type that Amazon AppFlow uses when it requests an access token from Salesforce. Amazon AppFlow requires an access token each time it attempts to access your Salesforce records.
You can specify one of the following values:
Amazon AppFlow passes an authorization code when it requests the access token from Salesforce. Amazon AppFlow receives the authorization code from Salesforce after you log in to your Salesforce account and authorize Amazon AppFlow to access your records.
Amazon AppFlow passes client credentials (a client ID and client secret) when it requests the access token from Salesforce. You provide these credentials to Amazon AppFlow when you define the connection to your Salesforce account.
Amazon AppFlow passes a JSON web token (JWT) when it requests the access token from Salesforce. You provide the JWT to Amazon AppFlow when you define the connection to your Salesforce account. When you use this grant type, you don't need to log in to your Salesforce account to authorize Amazon AppFlow to access your records.
A JSON web token (JWT) that authorizes Amazon AppFlow to access your Salesforce records.
" } }, "documentation": "The connector-specific profile credentials required when using Salesforce.
" }, "SalesforceConnectorProfileProperties": { "type": "structure", "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Salesforce resource.
" }, "isSandboxEnvironment": { "shape": "Boolean", "documentation": "Indicates whether the connector profile applies to a sandbox or production environment.
" }, "usePrivateLinkForMetadataAndAuthorization": { "shape": "Boolean", "documentation": "If the connection mode for the connector profile is private, this parameter sets whether Amazon AppFlow uses the private network to send metadata and authorization calls to Salesforce. Amazon AppFlow sends private calls through Amazon Web Services PrivateLink. These calls travel through Amazon Web Services infrastructure without being exposed to the public internet.
Set either of the following values:
Amazon AppFlow sends all calls to Salesforce over the private network.
These private calls are:
Calls to get metadata about your Salesforce records. This metadata describes your Salesforce objects and their fields.
Calls to get or refresh access tokens that allow Amazon AppFlow to access your Salesforce records.
Calls to transfer your Salesforce records as part of a flow run.
The default value. Amazon AppFlow sends some calls to Salesforce privately and other calls over the public internet.
The public calls are:
Calls to get metadata about your Salesforce records.
Calls to get or refresh access tokens.
The private calls are:
Calls to transfer your Salesforce records as part of a flow run.
The connector-specific profile properties required when using Salesforce.
" }, "SalesforceDataTransferApi": { "type": "string", "enum": [ "AUTOMATIC", "BULKV2", "REST_SYNC" ] }, "SalesforceDataTransferApiList": { "type": "list", "member": { "shape": "SalesforceDataTransferApi" } }, "SalesforceDestinationProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Salesforce flow destination.
" }, "idFieldNames": { "shape": "IdFieldNameList", "documentation": "The name of the field that Amazon AppFlow uses as an ID when performing a write operation such as update or delete.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig", "documentation": " The settings that determine how Amazon AppFlow handles an error when placing data in the Salesforce destination. For example, this setting would determine if the flow should fail after one insertion error, or continue and attempt to insert every record regardless of the initial failure. ErrorHandlingConfig
is a part of the destination connector details.
This specifies the type of write operation to be performed in Salesforce. When the value is UPSERT
, then idFieldNames
is required.
Specifies which Salesforce API is used by Amazon AppFlow when your flow transfers data to Salesforce.
The default. Amazon AppFlow selects which API to use based on the number of records that your flow transfers to Salesforce. If your flow transfers fewer than 1,000 records, Amazon AppFlow uses Salesforce REST API. If your flow transfers 1,000 records or more, Amazon AppFlow uses Salesforce Bulk API 2.0.
Each of these Salesforce APIs structures data differently. If Amazon AppFlow selects the API automatically, be aware that, for recurring flows, the data output might vary from one flow run to the next. For example, if a flow runs daily, it might use REST API on one day to transfer 900 records, and it might use Bulk API 2.0 on the next day to transfer 1,100 records. For each of these flow runs, the respective Salesforce API formats the data differently. Some of the differences include how dates are formatted and null values are represented. Also, Bulk API 2.0 doesn't transfer Salesforce compound fields.
By choosing this option, you optimize flow performance for both small and large data transfers, but the tradeoff is inconsistent formatting in the output.
Amazon AppFlow uses only Salesforce Bulk API 2.0. This API runs asynchronous data transfers, and it's optimal for large sets of data. By choosing this option, you ensure that your flow writes consistent output, but you optimize performance only for large data transfers.
Note that Bulk API 2.0 does not transfer Salesforce compound fields.
Amazon AppFlow uses only Salesforce REST API. By choosing this option, you ensure that your flow writes consistent output, but you decrease performance for large data transfers that are better suited for Bulk API 2.0. In some cases, if your flow attempts to transfer a vary large set of data, it might fail with a timed out error.
The properties that are applied when Salesforce is being used as a destination.
" }, "SalesforceMetadata": { "type": "structure", "members": { "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The desired authorization scope for the Salesforce account.
" }, "dataTransferApis": { "shape": "SalesforceDataTransferApiList", "documentation": "The Salesforce APIs that you can have Amazon AppFlow use when your flows transfers data to or from Salesforce.
" }, "oauth2GrantTypesSupported": { "shape": "OAuth2GrantTypeSupportedList", "documentation": "The OAuth 2.0 grant types that Amazon AppFlow can use when it requests an access token from Salesforce. Amazon AppFlow requires an access token each time it attempts to access your Salesforce records.
Amazon AppFlow passes an authorization code when it requests the access token from Salesforce. Amazon AppFlow receives the authorization code from Salesforce after you log in to your Salesforce account and authorize Amazon AppFlow to access your records.
Amazon AppFlow passes client credentials (a client ID and client secret) when it requests the access token from Salesforce. You provide these credentials to Amazon AppFlow when you define the connection to your Salesforce account.
Amazon AppFlow passes a JSON web token (JWT) when it requests the access token from Salesforce. You provide the JWT to Amazon AppFlow when you define the connection to your Salesforce account. When you use this grant type, you don't need to log in to your Salesforce account to authorize Amazon AppFlow to access your records.
The connector metadata specific to Salesforce.
" }, "SalesforceSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Salesforce flow source.
" }, "enableDynamicFieldUpdate": { "shape": "Boolean", "documentation": "The flag that enables dynamic fetching of new (recently added) fields in the Salesforce objects while running a flow.
" }, "includeDeletedRecords": { "shape": "Boolean", "documentation": "Indicates whether Amazon AppFlow includes deleted files in the flow run.
" }, "dataTransferApi": { "shape": "SalesforceDataTransferApi", "documentation": "Specifies which Salesforce API is used by Amazon AppFlow when your flow transfers data from Salesforce.
The default. Amazon AppFlow selects which API to use based on the number of records that your flow transfers from Salesforce. If your flow transfers fewer than 1,000,000 records, Amazon AppFlow uses Salesforce REST API. If your flow transfers 1,000,000 records or more, Amazon AppFlow uses Salesforce Bulk API 2.0.
Each of these Salesforce APIs structures data differently. If Amazon AppFlow selects the API automatically, be aware that, for recurring flows, the data output might vary from one flow run to the next. For example, if a flow runs daily, it might use REST API on one day to transfer 900,000 records, and it might use Bulk API 2.0 on the next day to transfer 1,100,000 records. For each of these flow runs, the respective Salesforce API formats the data differently. Some of the differences include how dates are formatted and null values are represented. Also, Bulk API 2.0 doesn't transfer Salesforce compound fields.
By choosing this option, you optimize flow performance for both small and large data transfers, but the tradeoff is inconsistent formatting in the output.
Amazon AppFlow uses only Salesforce Bulk API 2.0. This API runs asynchronous data transfers, and it's optimal for large sets of data. By choosing this option, you ensure that your flow writes consistent output, but you optimize performance only for large data transfers.
Note that Bulk API 2.0 does not transfer Salesforce compound fields.
Amazon AppFlow uses only Salesforce REST API. By choosing this option, you ensure that your flow writes consistent output, but you decrease performance for large data transfers that are better suited for Bulk API 2.0. In some cases, if your flow attempts to transfer a vary large set of data, it might fail wituh a timed out error.
The properties that are applied when Salesforce is being used as a source.
" }, "ScheduleExpression": { "type": "string", "max": 256, "pattern": ".*" }, "ScheduleFrequencyType": { "type": "string", "enum": [ "BYMINUTE", "HOURLY", "DAILY", "WEEKLY", "MONTHLY", "ONCE" ] }, "ScheduleOffset": { "type": "long", "max": 36000, "min": 0 }, "ScheduledTriggerProperties": { "type": "structure", "required": [ "scheduleExpression" ], "members": { "scheduleExpression": { "shape": "ScheduleExpression", "documentation": " The scheduling expression that determines the rate at which the schedule will run, for example rate(5minutes)
.
Specifies whether a scheduled flow has an incremental data transfer or a complete data transfer for each flow run.
" }, "scheduleStartTime": { "shape": "Date", "documentation": "The time at which the scheduled flow starts. The time is formatted as a timestamp that follows the ISO 8601 standard, such as 2022-04-26T13:00:00-07:00
.
The time at which the scheduled flow ends. The time is formatted as a timestamp that follows the ISO 8601 standard, such as 2022-04-27T13:00:00-07:00
.
Specifies the time zone used when referring to the dates and times of a scheduled flow, such as America/New_York
. This time zone is only a descriptive label. It doesn't affect how Amazon AppFlow interprets the timestamps that you specify to schedule the flow.
If you want to schedule a flow by using times in a particular time zone, indicate the time zone as a UTC offset in your timestamps. For example, the UTC offsets for the America/New_York
timezone are -04:00
EDT and -05:00 EST
.
Specifies the optional offset that is added to the time interval for a schedule-triggered flow.
", "box": true }, "firstExecutionFrom": { "shape": "Date", "documentation": "Specifies the date range for the records to import from the connector in the first flow run.
" }, "flowErrorDeactivationThreshold": { "shape": "FlowErrorDeactivationThreshold", "documentation": "Defines how many times a scheduled flow fails consecutively before Amazon AppFlow deactivates it.
", "box": true } }, "documentation": " Specifies the configuration details of a schedule-triggered flow as defined by the user. Currently, these settings only apply to the Scheduled
trigger type.
The name of the user.
" }, "password": { "shape": "Password", "documentation": "The password that corresponds to the user name.
" }, "oAuth2Credentials": { "shape": "OAuth2Credentials", "documentation": "The OAuth 2.0 credentials required to authenticate the user.
" } }, "documentation": "The connector-specific profile credentials required when using ServiceNow.
" }, "ServiceNowConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the ServiceNow resource.
" } }, "documentation": "The connector-specific profile properties required when using ServiceNow.
" }, "ServiceNowMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to ServiceNow.
" }, "ServiceNowSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the ServiceNow flow source.
" } }, "documentation": "The properties that are applied when ServiceNow is being used as a source.
" }, "SingularConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "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" ] }, "SingularConnectorProfileCredentials": { "type": "structure", "required": [ "apiKey" ], "members": { "apiKey": { "shape": "ApiKey", "documentation": "A unique alphanumeric identifier used to authenticate a user, developer, or calling program to your API.
" } }, "documentation": "The connector-specific profile credentials required when using Singular.
" }, "SingularConnectorProfileProperties": { "type": "structure", "members": {}, "documentation": "The connector-specific profile properties required when using Singular.
" }, "SingularMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Singular.
" }, "SingularSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Singular flow source.
" } }, "documentation": "The properties that are applied when Singular is being used as a source.
" }, "SlackConnectorOperator": { "type": "string", "enum": [ "PROJECTION", "LESS_THAN", "GREATER_THAN", "BETWEEN", "LESS_THAN_OR_EQUAL_TO", "GREATER_THAN_OR_EQUAL_TO", "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" ] }, "SlackConnectorProfileCredentials": { "type": "structure", "required": [ "clientId", "clientSecret" ], "members": { "clientId": { "shape": "ClientId", "documentation": "The identifier for the client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Slack resources.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" } }, "documentation": "The connector-specific profile credentials required when using Slack.
" }, "SlackConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Slack resource.
" } }, "documentation": "The connector-specific profile properties required when using Slack.
" }, "SlackMetadata": { "type": "structure", "members": { "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The desired authorization scope for the Slack account.
" } }, "documentation": "The connector metadata specific to Slack.
" }, "SlackSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Slack flow source.
" } }, "documentation": "The properties that are applied when Slack is being used as a source.
" }, "SnowflakeConnectorProfileCredentials": { "type": "structure", "required": [ "username", "password" ], "members": { "username": { "shape": "Username", "documentation": "The name of the user.
" }, "password": { "shape": "Password", "documentation": "The password that corresponds to the user name.
" } }, "documentation": "The connector-specific profile credentials required when using Snowflake.
" }, "SnowflakeConnectorProfileProperties": { "type": "structure", "required": [ "warehouse", "stage", "bucketName" ], "members": { "warehouse": { "shape": "Warehouse", "documentation": "The name of the Snowflake warehouse.
" }, "stage": { "shape": "Stage", "documentation": "The name of the Amazon S3 stage that was created while setting up an Amazon S3 stage in the Snowflake account. This is written in the following format: < Database>< Schema><Stage Name>.
" }, "bucketName": { "shape": "BucketName", "documentation": "The name of the Amazon S3 bucket associated with Snowflake.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The bucket path that refers to the Amazon S3 bucket associated with Snowflake.
" }, "privateLinkServiceName": { "shape": "PrivateLinkServiceName", "documentation": "The Snowflake Private Link service name to be used for private data transfers.
" }, "accountName": { "shape": "AccountName", "documentation": "The name of the account.
" }, "region": { "shape": "Region", "documentation": "The Amazon Web Services Region of the Snowflake account.
" } }, "documentation": "The connector-specific profile properties required when using Snowflake.
" }, "SnowflakeDestinationProperties": { "type": "structure", "required": [ "object", "intermediateBucketName" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Snowflake flow destination.
" }, "intermediateBucketName": { "shape": "BucketName", "documentation": "The intermediate bucket that Amazon AppFlow uses when moving data into Snowflake.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the destination bucket in which Amazon AppFlow places the files.
" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig", "documentation": " The settings that determine how Amazon AppFlow handles an error when placing data in the Snowflake destination. For example, this setting would determine if the flow should fail after one insertion error, or continue and attempt to insert every record regardless of the initial failure. ErrorHandlingConfig
is a part of the destination connector details.
The properties that are applied when Snowflake is being used as a destination.
" }, "SnowflakeMetadata": { "type": "structure", "members": { "supportedRegions": { "shape": "RegionList", "documentation": "Specifies the supported Amazon Web Services Regions when using Snowflake.
" } }, "documentation": "The connector metadata specific to Snowflake.
" }, "SourceConnectorProperties": { "type": "structure", "members": { "Amplitude": { "shape": "AmplitudeSourceProperties", "documentation": "Specifies the information that is required for querying Amplitude.
" }, "Datadog": { "shape": "DatadogSourceProperties", "documentation": "Specifies the information that is required for querying Datadog.
" }, "Dynatrace": { "shape": "DynatraceSourceProperties", "documentation": "Specifies the information that is required for querying Dynatrace.
" }, "GoogleAnalytics": { "shape": "GoogleAnalyticsSourceProperties", "documentation": "Specifies the information that is required for querying Google Analytics.
" }, "InforNexus": { "shape": "InforNexusSourceProperties", "documentation": "Specifies the information that is required for querying Infor Nexus.
" }, "Marketo": { "shape": "MarketoSourceProperties", "documentation": "Specifies the information that is required for querying Marketo.
" }, "S3": { "shape": "S3SourceProperties", "documentation": "Specifies the information that is required for querying Amazon S3.
" }, "Salesforce": { "shape": "SalesforceSourceProperties", "documentation": "Specifies the information that is required for querying Salesforce.
" }, "ServiceNow": { "shape": "ServiceNowSourceProperties", "documentation": "Specifies the information that is required for querying ServiceNow.
" }, "Singular": { "shape": "SingularSourceProperties", "documentation": "Specifies the information that is required for querying Singular.
" }, "Slack": { "shape": "SlackSourceProperties", "documentation": "Specifies the information that is required for querying Slack.
" }, "Trendmicro": { "shape": "TrendmicroSourceProperties", "documentation": "Specifies the information that is required for querying Trend Micro.
" }, "Veeva": { "shape": "VeevaSourceProperties", "documentation": "Specifies the information that is required for querying Veeva.
" }, "Zendesk": { "shape": "ZendeskSourceProperties", "documentation": "Specifies the information that is required for querying Zendesk.
" }, "SAPOData": { "shape": "SAPODataSourceProperties" }, "CustomConnector": { "shape": "CustomConnectorSourceProperties" }, "Pardot": { "shape": "PardotSourceProperties", "documentation": "Specifies the information that is required for querying Salesforce Pardot.
" } }, "documentation": "Specifies the information that is required to query a particular connector.
" }, "SourceFieldProperties": { "type": "structure", "members": { "isRetrievable": { "shape": "Boolean", "documentation": "Indicates whether the field can be returned in a search result.
" }, "isQueryable": { "shape": "Boolean", "documentation": "Indicates if the field can be queried.
" }, "isTimestampFieldForIncrementalQueries": { "shape": "Boolean", "documentation": "Indicates if this timestamp field can be used for incremental queries.
" } }, "documentation": "The properties that can be applied to a field when the connector is being used as a source.
" }, "SourceFields": { "type": "list", "member": { "shape": "String" } }, "SourceFlowConfig": { "type": "structure", "required": [ "connectorType", "sourceConnectorProperties" ], "members": { "connectorType": { "shape": "ConnectorType", "documentation": "The type of connector, such as Salesforce, Amplitude, and so on.
" }, "apiVersion": { "shape": "ApiVersion", "documentation": "The API version of the connector when it's used as a source in the flow.
" }, "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": "The name of the connector profile. This name must be unique for each connector profile in the Amazon Web Services account.
" }, "sourceConnectorProperties": { "shape": "SourceConnectorProperties", "documentation": "Specifies the information that is required to query a particular source connector.
" }, "incrementalPullConfig": { "shape": "IncrementalPullConfig", "documentation": "Defines the configuration for a scheduled incremental data pull. If a valid configuration is provided, the fields specified in the configuration are used when querying for the incremental data pull.
" } }, "documentation": "Contains information about the configuration of the source connector used in the flow.
" }, "Stage": { "type": "string", "max": 512, "pattern": "\\S+" }, "StartFlowRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your StartFlow
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs for flows that run on a schedule or based on an event. However, the error doesn't occur for flows that run on demand. You set the conditions that initiate your flow for the triggerConfig
parameter.
If you use a different value for clientToken
, Amazon AppFlow considers it a new call to StartFlow
. The token is active for 8 hours.
The flow's Amazon Resource Name (ARN).
" }, "flowStatus": { "shape": "FlowStatus", "documentation": "Indicates the current status of the flow.
" }, "executionId": { "shape": "ExecutionId", "documentation": "Returns the internal execution ID of an on-demand flow when the flow is started. For scheduled or event-triggered flows, this value is null.
" } } }, "StopFlowRequest": { "type": "structure", "required": [ "flowName" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" } } }, "StopFlowResponse": { "type": "structure", "members": { "flowArn": { "shape": "FlowArn", "documentation": "The flow's Amazon Resource Name (ARN).
" }, "flowStatus": { "shape": "FlowStatus", "documentation": "Indicates the current status of the flow.
" } } }, "String": { "type": "string", "max": 2048, "pattern": ".*" }, "SuccessResponseHandlingConfig": { "type": "structure", "members": { "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The Amazon S3 bucket prefix.
" }, "bucketName": { "shape": "BucketName", "documentation": "The name of the Amazon S3 bucket.
" } }, "documentation": "Determines how Amazon AppFlow handles the success response that it gets from the connector after placing data.
For example, this setting would determine where to write the response from the destination connector upon a successful insert operation.
" }, "SupportedApiVersion": { "type": "string", "max": 256, "pattern": "\\S+" }, "SupportedApiVersionList": { "type": "list", "member": { "shape": "SupportedApiVersion" } }, "SupportedDataTransferApis": { "type": "list", "member": { "shape": "DataTransferApi" } }, "SupportedDataTransferType": { "type": "string", "enum": [ "RECORD", "FILE" ] }, "SupportedDataTransferTypeList": { "type": "list", "member": { "shape": "SupportedDataTransferType" } }, "SupportedFieldTypeDetails": { "type": "structure", "required": [ "v1" ], "members": { "v1": { "shape": "FieldTypeDetails", "documentation": " The initial supported version for fieldType
. If this is later changed to a different version, v2 will be introduced.
Contains details regarding all the supported FieldTypes
and their corresponding filterOperators
and supportedValues
.
The Amazon Resource Name (ARN) of the flow that you want to tag.
", "location": "uri", "locationName": "resourceArn" }, "tags": { "shape": "TagMap", "documentation": "The tags used to organize, track, or control access for your flow.
" } } }, "TagResourceResponse": { "type": "structure", "members": {} }, "TagValue": { "type": "string", "max": 256, "pattern": "[\\s\\w+-=\\.:/@]*" }, "Task": { "type": "structure", "required": [ "sourceFields", "taskType" ], "members": { "sourceFields": { "shape": "SourceFields", "documentation": "The source fields to which a particular task is applied.
" }, "connectorOperator": { "shape": "ConnectorOperator", "documentation": "The operation to be performed on the provided source fields.
" }, "destinationField": { "shape": "DestinationField", "documentation": "A field in a destination connector, or a field value against which Amazon AppFlow validates a source field.
" }, "taskType": { "shape": "TaskType", "documentation": "Specifies the particular task implementation that Amazon AppFlow performs.
" }, "taskProperties": { "shape": "TaskPropertiesMap", "documentation": " A map used to store task-related information. The execution service looks for particular information based on the TaskType
.
A class for modeling different type of tasks. Task implementation varies based on the TaskType
.
The Secret Access Key portion of the credentials.
" } }, "documentation": "The connector-specific profile credentials required when using Trend Micro.
" }, "TrendmicroConnectorProfileProperties": { "type": "structure", "members": {}, "documentation": "The connector-specific profile properties required when using Trend Micro.
" }, "TrendmicroMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Trend Micro.
" }, "TrendmicroSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Trend Micro flow source.
" } }, "documentation": "The properties that are applied when using Trend Micro as a flow source.
" }, "TriggerConfig": { "type": "structure", "required": [ "triggerType" ], "members": { "triggerType": { "shape": "TriggerType", "documentation": " Specifies the type of flow trigger. This can be OnDemand
, Scheduled
, or Event
.
Specifies the configuration details of a schedule-triggered flow as defined by the user. Currently, these settings only apply to the Scheduled
trigger type.
The trigger settings that determine how and when Amazon AppFlow runs the specified flow.
" }, "TriggerProperties": { "type": "structure", "members": { "Scheduled": { "shape": "ScheduledTriggerProperties", "documentation": "Specifies the configuration details of a schedule-triggered flow as defined by the user.
" } }, "documentation": " Specifies the configuration details that control the trigger for a flow. Currently, these settings only apply to the Scheduled
trigger type.
The label of the connector. The label is unique for each ConnectorRegistration
in your Amazon Web Services account.
Indicates whether Amazon AppFlow should unregister the connector, even if it is currently in use in one or more connector profiles. The default value is false.
" } } }, "UnregisterConnectorResponse": { "type": "structure", "members": {} }, "UntagResourceRequest": { "type": "structure", "required": [ "resourceArn", "tagKeys" ], "members": { "resourceArn": { "shape": "ARN", "documentation": "The Amazon Resource Name (ARN) of the flow that you want to untag.
", "location": "uri", "locationName": "resourceArn" }, "tagKeys": { "shape": "TagKeyList", "documentation": "The tag keys associated with the tag that you want to remove from your flow.
", "location": "querystring", "locationName": "tagKeys" } } }, "UntagResourceResponse": { "type": "structure", "members": {} }, "UpdateConnectorProfileRequest": { "type": "structure", "required": [ "connectorProfileName", "connectionMode", "connectorProfileConfig" ], "members": { "connectorProfileName": { "shape": "ConnectorProfileName", "documentation": " The name of the connector profile and is unique for each ConnectorProfile
in the Amazon Web Services account.
Indicates the connection mode and if it is public or private.
" }, "connectorProfileConfig": { "shape": "ConnectorProfileConfig", "documentation": "Defines the connector-specific profile configuration and credentials.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your UpdateConnectorProfile
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to UpdateConnectorProfile
. The token is active for 8 hours.
The Amazon Resource Name (ARN) of the connector profile.
" } } }, "UpdateConnectorRegistrationRequest": { "type": "structure", "required": [ "connectorLabel" ], "members": { "connectorLabel": { "shape": "ConnectorLabel", "documentation": "The name of the connector. The name is unique for each connector registration in your AWS account.
" }, "description": { "shape": "Description", "documentation": "A description about the update that you're applying to the connector.
" }, "connectorProvisioningConfig": { "shape": "ConnectorProvisioningConfig" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your UpdateConnectorRegistration
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to UpdateConnectorRegistration
. The token is active for 8 hours.
The ARN of the connector being updated.
" } } }, "UpdateFlowRequest": { "type": "structure", "required": [ "flowName", "triggerConfig", "sourceFlowConfig", "destinationFlowConfigList", "tasks" ], "members": { "flowName": { "shape": "FlowName", "documentation": "The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
" }, "description": { "shape": "FlowDescription", "documentation": "A description of the flow.
" }, "triggerConfig": { "shape": "TriggerConfig", "documentation": "The trigger settings that determine how and when the flow runs.
" }, "sourceFlowConfig": { "shape": "SourceFlowConfig" }, "destinationFlowConfigList": { "shape": "DestinationFlowConfigList", "documentation": "The configuration that controls how Amazon AppFlow transfers data to the destination connector.
" }, "tasks": { "shape": "Tasks", "documentation": "A list of tasks that Amazon AppFlow performs while transferring the data in the flow run.
" }, "metadataCatalogConfig": { "shape": "MetadataCatalogConfig", "documentation": "Specifies the configuration that Amazon AppFlow uses when it catalogs the data that's transferred by the associated flow. When Amazon AppFlow catalogs the data from a flow, it stores metadata in a data catalog.
" }, "clientToken": { "shape": "ClientToken", "documentation": "The clientToken
parameter is an idempotency token. It ensures that your UpdateFlow
request completes only once. You choose the value to pass. For example, if you don't receive a response from your request, you can safely retry the request with the same clientToken
parameter value.
If you omit a clientToken
value, the Amazon Web Services SDK that you are using inserts a value for you. This way, the SDK can safely retry requests multiple times after a network error. You must provide your own value for other use cases.
If you specify input parameters that differ from your first request, an error occurs. If you use a different value for clientToken
, Amazon AppFlow considers it a new call to UpdateFlow
. The token is active for 8 hours.
Indicates the current status of the flow.
" } } }, "UpdatedBy": { "type": "string", "max": 256, "pattern": "\\S+" }, "UpsolverBucketName": { "type": "string", "max": 63, "min": 16, "pattern": "^(upsolver-appflow)\\S*" }, "UpsolverDestinationProperties": { "type": "structure", "required": [ "bucketName", "s3OutputFormatConfig" ], "members": { "bucketName": { "shape": "UpsolverBucketName", "documentation": "The Upsolver Amazon S3 bucket name in which Amazon AppFlow places the transferred data.
" }, "bucketPrefix": { "shape": "BucketPrefix", "documentation": "The object key for the destination Upsolver Amazon S3 bucket in which Amazon AppFlow places the files.
" }, "s3OutputFormatConfig": { "shape": "UpsolverS3OutputFormatConfig", "documentation": "The configuration that determines how data is formatted when Upsolver is used as the flow destination.
" } }, "documentation": "The properties that are applied when Upsolver is used as a destination.
" }, "UpsolverMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Upsolver.
" }, "UpsolverS3OutputFormatConfig": { "type": "structure", "required": [ "prefixConfig" ], "members": { "fileType": { "shape": "FileType", "documentation": "Indicates the file type that Amazon AppFlow places in the Upsolver Amazon S3 bucket.
" }, "prefixConfig": { "shape": "PrefixConfig" }, "aggregationConfig": { "shape": "AggregationConfig" } }, "documentation": "The configuration that determines how Amazon AppFlow formats the flow output data when Upsolver is used as the destination.
" }, "Username": { "type": "string", "max": 512, "pattern": "\\S+" }, "Value": { "type": "string", "max": 128, "pattern": "\\S+" }, "VeevaConnectorOperator": { "type": "string", "enum": [ "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" ] }, "VeevaConnectorProfileCredentials": { "type": "structure", "required": [ "username", "password" ], "members": { "username": { "shape": "Username", "documentation": "The name of the user.
" }, "password": { "shape": "Password", "documentation": "The password that corresponds to the user name.
" } }, "documentation": "The connector-specific profile credentials required when using Veeva.
" }, "VeevaConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Veeva resource.
" } }, "documentation": "The connector-specific profile properties required when using Veeva.
" }, "VeevaMetadata": { "type": "structure", "members": {}, "documentation": "The connector metadata specific to Veeva.
" }, "VeevaSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Veeva flow source.
" }, "documentType": { "shape": "DocumentType", "documentation": "The document type specified in the Veeva document extract flow.
" }, "includeSourceFiles": { "shape": "Boolean", "documentation": "Boolean value to include source files in Veeva document extract flow.
" }, "includeRenditions": { "shape": "Boolean", "documentation": "Boolean value to include file renditions in Veeva document extract flow.
" }, "includeAllVersions": { "shape": "Boolean", "documentation": "Boolean value to include All Versions of files in Veeva document extract flow.
" } }, "documentation": "The properties that are applied when using Veeva as a flow source.
" }, "Warehouse": { "type": "string", "max": 512, "pattern": "[\\s\\w/!@#+=.-]*" }, "WorkgroupName": { "type": "string", "max": 512, "pattern": "\\S+" }, "WriteOperationType": { "type": "string", "documentation": " The possible write operations in the destination connector. When this value is not provided, this defaults to the INSERT
operation.
The identifier for the desired client.
" }, "clientSecret": { "shape": "ClientSecret", "documentation": "The client secret used by the OAuth client to authenticate to the authorization server.
" }, "accessToken": { "shape": "AccessToken", "documentation": "The credentials used to access protected Zendesk resources.
" }, "oAuthRequest": { "shape": "ConnectorOAuthRequest", "documentation": "The OAuth requirement needed to request security tokens from the connector endpoint.
" } }, "documentation": "The connector-specific profile credentials required when using Zendesk.
" }, "ZendeskConnectorProfileProperties": { "type": "structure", "required": [ "instanceUrl" ], "members": { "instanceUrl": { "shape": "InstanceUrl", "documentation": "The location of the Zendesk resource.
" } }, "documentation": "The connector-specific profile properties required when using Zendesk.
" }, "ZendeskDestinationProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Zendesk flow destination.
" }, "idFieldNames": { "shape": "IdFieldNameList" }, "errorHandlingConfig": { "shape": "ErrorHandlingConfig" }, "writeOperationType": { "shape": "WriteOperationType" } }, "documentation": "The properties that are applied when Zendesk is used as a destination.
" }, "ZendeskMetadata": { "type": "structure", "members": { "oAuthScopes": { "shape": "OAuthScopeList", "documentation": "The desired authorization scope for the Zendesk account.
" } }, "documentation": "The connector metadata specific to Zendesk.
" }, "ZendeskSourceProperties": { "type": "structure", "required": [ "object" ], "members": { "object": { "shape": "Object", "documentation": "The object specified in the Zendesk flow source.
" } }, "documentation": "The properties that are applied when using Zendesk as a flow source.
" } }, "documentation": "Welcome to the Amazon AppFlow API reference. This guide is for developers who need detailed information about the Amazon AppFlow API operations, data types, and errors.
Amazon AppFlow is a fully managed integration service that enables you to securely transfer data between software as a service (SaaS) applications like Salesforce, Marketo, Slack, and ServiceNow, and Amazon Web Services like Amazon S3 and Amazon Redshift.
Use the following links to get started on the Amazon AppFlow API:
Actions: An alphabetical list of all Amazon AppFlow API operations.
Data types: An alphabetical list of all Amazon AppFlow data types.
Common parameters: Parameters that all Query operations can use.
Common errors: Client and server errors that all operations can return.
If you're new to Amazon AppFlow, we recommend that you review the Amazon AppFlow User Guide.
Amazon AppFlow API users can use vendor-specific mechanisms for OAuth, and include applicable OAuth attributes (such as auth-code
and redirecturi
) with the connector-specific ConnectorProfileProperties
when creating a new connector profile using Amazon AppFlow API operations. For example, Salesforce users can refer to the Authorize Apps with OAuth documentation.