@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonAppflowClient extends AmazonWebServiceClient implements AmazonAppflow
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.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
static AmazonAppflowClientBuilder |
builder() |
CancelFlowExecutionsResult |
cancelFlowExecutions(CancelFlowExecutionsRequest request)
Cancels active runs for a flow.
|
CreateConnectorProfileResult |
createConnectorProfile(CreateConnectorProfileRequest request)
Creates a new connector profile associated with your Amazon Web Services account.
|
CreateFlowResult |
createFlow(CreateFlowRequest request)
Enables your application to create a new flow using Amazon AppFlow.
|
DeleteConnectorProfileResult |
deleteConnectorProfile(DeleteConnectorProfileRequest request)
Enables you to delete an existing connector profile.
|
DeleteFlowResult |
deleteFlow(DeleteFlowRequest request)
Enables your application to delete an existing flow.
|
DescribeConnectorResult |
describeConnector(DescribeConnectorRequest request)
Describes the given custom connector registered in your Amazon Web Services account.
|
DescribeConnectorEntityResult |
describeConnectorEntity(DescribeConnectorEntityRequest request)
Provides details regarding the entity used with the connector, with a description of the data model for each
field in that entity.
|
DescribeConnectorProfilesResult |
describeConnectorProfiles(DescribeConnectorProfilesRequest request)
Returns a list of
connector-profile details matching the provided connector-profile
names and connector-types . |
DescribeConnectorsResult |
describeConnectors(DescribeConnectorsRequest request)
Describes the connectors vended by Amazon AppFlow for specified connector types.
|
DescribeFlowResult |
describeFlow(DescribeFlowRequest request)
Provides a description of the specified flow.
|
DescribeFlowExecutionRecordsResult |
describeFlowExecutionRecords(DescribeFlowExecutionRecordsRequest request)
Fetches the execution history of the flow.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
ListConnectorEntitiesResult |
listConnectorEntities(ListConnectorEntitiesRequest request)
Returns the list of available connector entities supported by Amazon AppFlow.
|
ListConnectorsResult |
listConnectors(ListConnectorsRequest request)
Returns the list of all registered custom connectors in your Amazon Web Services account.
|
ListFlowsResult |
listFlows(ListFlowsRequest request)
Lists all of the flows associated with your account.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Retrieves the tags that are associated with a specified flow.
|
RegisterConnectorResult |
registerConnector(RegisterConnectorRequest request)
Registers a new custom connector with your Amazon Web Services account.
|
ResetConnectorMetadataCacheResult |
resetConnectorMetadataCache(ResetConnectorMetadataCacheRequest request)
Resets metadata about your connector entities that Amazon AppFlow stored in its cache.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
StartFlowResult |
startFlow(StartFlowRequest request)
Activates an existing flow.
|
StopFlowResult |
stopFlow(StopFlowRequest request)
Deactivates the existing flow.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Applies a tag to the specified flow.
|
UnregisterConnectorResult |
unregisterConnector(UnregisterConnectorRequest request)
Unregisters the custom connector registered in your account that matches the connector label provided in the
request.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes a tag from the specified flow.
|
UpdateConnectorProfileResult |
updateConnectorProfile(UpdateConnectorProfileRequest request)
Updates a given connector profile associated with your account.
|
UpdateConnectorRegistrationResult |
updateConnectorRegistration(UpdateConnectorRegistrationRequest request)
Updates a custom connector that you've previously registered.
|
UpdateFlowResult |
updateFlow(UpdateFlowRequest request)
Updates an existing flow.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
public static AmazonAppflowClientBuilder builder()
public CancelFlowExecutionsResult cancelFlowExecutions(CancelFlowExecutionsRequest request)
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.
cancelFlowExecutions
in interface AmazonAppflow
cancelFlowExecutionsRequest
- ValidationException
- The request has invalid or missing parameters.AccessDeniedException
- AppFlow/Requester has invalid or missing permissions.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ThrottlingException
- API calls have exceeded the maximum allowed API request rate per account and per Region.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public CreateConnectorProfileResult createConnectorProfile(CreateConnectorProfileRequest request)
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.
createConnectorProfile
in interface AmazonAppflow
createConnectorProfileRequest
- ValidationException
- The request has invalid or missing parameters.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public CreateFlowResult createFlow(CreateFlowRequest request)
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.
createFlow
in interface AmazonAppflow
createFlowRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.AccessDeniedException
- AppFlow/Requester has invalid or missing permissions.public DeleteConnectorProfileResult deleteConnectorProfile(DeleteConnectorProfileRequest request)
Enables you to delete an existing connector profile.
deleteConnectorProfile
in interface AmazonAppflow
deleteConnectorProfileRequest
- ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DeleteFlowResult deleteFlow(DeleteFlowRequest request)
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.
deleteFlow
in interface AmazonAppflow
deleteFlowRequest
- ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DescribeConnectorResult describeConnector(DescribeConnectorRequest request)
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.
describeConnector
in interface AmazonAppflow
describeConnectorRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.public DescribeConnectorEntityResult describeConnectorEntity(DescribeConnectorEntityRequest request)
Provides details regarding the entity used with the connector, with a description of the data model for each field in that entity.
describeConnectorEntity
in interface AmazonAppflow
describeConnectorEntityRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DescribeConnectorProfilesResult describeConnectorProfiles(DescribeConnectorProfilesRequest request)
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.
describeConnectorProfiles
in interface AmazonAppflow
describeConnectorProfilesRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DescribeConnectorsResult describeConnectors(DescribeConnectorsRequest request)
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.
describeConnectors
in interface AmazonAppflow
describeConnectorsRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DescribeFlowResult describeFlow(DescribeFlowRequest request)
Provides a description of the specified flow.
describeFlow
in interface AmazonAppflow
describeFlowRequest
- ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public DescribeFlowExecutionRecordsResult describeFlowExecutionRecords(DescribeFlowExecutionRecordsRequest request)
Fetches the execution history of the flow.
describeFlowExecutionRecords
in interface AmazonAppflow
describeFlowExecutionRecordsRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public ListConnectorEntitiesResult listConnectorEntities(ListConnectorEntitiesRequest request)
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.
listConnectorEntities
in interface AmazonAppflow
listConnectorEntitiesRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public ListConnectorsResult listConnectors(ListConnectorsRequest request)
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.
listConnectors
in interface AmazonAppflow
listConnectorsRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public ListFlowsResult listFlows(ListFlowsRequest request)
Lists all of the flows associated with your account.
listFlows
in interface AmazonAppflow
listFlowsRequest
- ValidationException
- The request has invalid or missing parameters.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Retrieves the tags that are associated with a specified flow.
listTagsForResource
in interface AmazonAppflow
listTagsForResourceRequest
- InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.public RegisterConnectorResult registerConnector(RegisterConnectorRequest request)
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.
registerConnector
in interface AmazonAppflow
registerConnectorRequest
- ValidationException
- The request has invalid or missing parameters.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.AccessDeniedException
- AppFlow/Requester has invalid or missing permissions.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ThrottlingException
- API calls have exceeded the maximum allowed API request rate per account and per Region.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.public ResetConnectorMetadataCacheResult resetConnectorMetadataCache(ResetConnectorMetadataCacheRequest request)
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.
resetConnectorMetadataCache
in interface AmazonAppflow
resetConnectorMetadataCacheRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public StartFlowResult startFlow(StartFlowRequest request)
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.
startFlow
in interface AmazonAppflow
startFlowRequest
- ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.public StopFlowResult stopFlow(StopFlowRequest request)
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.
stopFlow
in interface AmazonAppflow
stopFlowRequest
- ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.UnsupportedOperationException
- The requested operation is not supported for the current flow.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public TagResourceResult tagResource(TagResourceRequest request)
Applies a tag to the specified flow.
tagResource
in interface AmazonAppflow
tagResourceRequest
- InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.public UnregisterConnectorResult unregisterConnector(UnregisterConnectorRequest request)
Unregisters the custom connector registered in your account that matches the connector label provided in the request.
unregisterConnector
in interface AmazonAppflow
unregisterConnectorRequest
- ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes a tag from the specified flow.
untagResource
in interface AmazonAppflow
untagResourceRequest
- InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.public UpdateConnectorProfileResult updateConnectorProfile(UpdateConnectorProfileRequest request)
Updates a given connector profile associated with your account.
updateConnectorProfile
in interface AmazonAppflow
updateConnectorProfileRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.public UpdateConnectorRegistrationResult updateConnectorRegistration(UpdateConnectorRegistrationRequest request)
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
updateConnectorRegistration
in interface AmazonAppflow
updateConnectorRegistrationRequest
- ValidationException
- The request has invalid or missing parameters.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.AccessDeniedException
- AppFlow/Requester has invalid or missing permissions.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ThrottlingException
- API calls have exceeded the maximum allowed API request rate per account and per Region.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.public UpdateFlowResult updateFlow(UpdateFlowRequest request)
Updates an existing flow.
updateFlow
in interface AmazonAppflow
updateFlowRequest
- ValidationException
- The request has invalid or missing parameters.ResourceNotFoundException
- The resource specified in the request (such as the source or destination connector profile) is not found.ServiceQuotaExceededException
- The request would cause a service quota (such as the number of flows) to be exceeded.ConflictException
- There was a conflict when processing the request (for example, a flow with the given name already exists
within the account. Check for conflicting resource names and try again.ConnectorAuthenticationException
- An error occurred when authenticating with the connector endpoint.ConnectorServerException
- An error occurred when retrieving data from the connector endpoint.InternalServerException
- An internal service error occurred during the processing of your request. Try again later.AccessDeniedException
- AppFlow/Requester has invalid or missing permissions.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AmazonAppflow
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AmazonAppflow
shutdown
in class AmazonWebServiceClient