@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSApplicationDiscoveryAsync extends AWSApplicationDiscovery
AsyncHandler can be used to
receive notification when an asynchronous operation completes.
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSApplicationDiscoveryAsync instead.
AWS Application Discovery Service helps you plan application migration projects by automatically identifying servers, virtual machines (VMs), software, and software dependencies running in your on-premises data centers. Application Discovery Service also collects application performance data, which can help you assess the outcome of your migration. The data collected by Application Discovery Service is securely retained in an Amazon-hosted and managed database in the cloud. You can export the data as a CSV or XML file into your preferred visualization tool or cloud-migration solution to plan your migration. For more information, see the Application Discovery Service FAQ.
Application Discovery Service offers two modes of operation.
Agentless discovery mode is recommended for environments that use VMware vCenter Server. This mode doesn't require you to install an agent on each host. Agentless discovery gathers server information regardless of the operating systems, which minimizes the time required for initial on-premises infrastructure assessment. Agentless discovery doesn't collect information about software and software dependencies. It also doesn't work in non-VMware environments. We recommend that you use agent-based discovery for non-VMware environments and if you want to collect information about software and software dependencies. You can also run agent-based and agentless discovery simultaneously. Use agentless discovery to quickly complete the initial infrastructure assessment and then install agents on select hosts to gather information about software and software dependencies.
Agent-based discovery mode collects a richer set of data than agentless discovery by using Amazon software, the AWS Application Discovery Agent, which you install on one or more hosts in your data center. The agent captures infrastructure and application information, including an inventory of installed software applications, system and process performance, resource utilization, and network dependencies between workloads. The information collected by agents is secured at rest and in transit to the Application Discovery Service database in the cloud.
Application Discovery Service integrates with application discovery solutions from AWS Partner Network (APN) partners. Third-party application discovery tools can query Application Discovery Service and write to the Application Discovery Service database using a public API. You can then import the data into either a visualization tool or cloud-migration solution.
Application Discovery Service doesn't gather sensitive information. All data is handled according to the AWS Privacy Policy. You can operate Application Discovery Service using offline mode to inspect collected data before it is shared with the service.
Your AWS account must be granted access to Application Discovery Service, a process called whitelisting. This is true for AWS partners and customers alike. To request access, sign up for AWS Application Discovery Service here. We send you information about how to get started.
This API reference provides descriptions, syntax, and usage examples for each of the actions and data types for Application Discovery Service. The topic for each action shows the API request parameters and the response. Alternatively, you can use one of the AWS SDKs to access an API that is tailored to the programming language or platform that you're using. For more information, see AWS SDKs.
This guide is intended for use with the AWS Application Discovery Service User Guide .
ENDPOINT_PREFIXassociateConfigurationItemsToApplication, createApplication, createTags, deleteApplications, deleteTags, describeAgents, describeConfigurations, describeExportConfigurations, describeExportTasks, describeTags, disassociateConfigurationItemsFromApplication, exportConfigurations, getCachedResponseMetadata, getDiscoverySummary, listConfigurations, listServerNeighbors, setEndpoint, setRegion, shutdown, startDataCollectionByAgentIds, startExportTask, stopDataCollectionByAgentIds, updateApplicationFuture<AssociateConfigurationItemsToApplicationResult> associateConfigurationItemsToApplicationAsync(AssociateConfigurationItemsToApplicationRequest associateConfigurationItemsToApplicationRequest)
Associates one or more configuration items with an application.
associateConfigurationItemsToApplicationRequest - Future<AssociateConfigurationItemsToApplicationResult> associateConfigurationItemsToApplicationAsync(AssociateConfigurationItemsToApplicationRequest associateConfigurationItemsToApplicationRequest, AsyncHandler<AssociateConfigurationItemsToApplicationRequest,AssociateConfigurationItemsToApplicationResult> asyncHandler)
Associates one or more configuration items with an application.
associateConfigurationItemsToApplicationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest createApplicationRequest)
Creates an application with the given name and description.
createApplicationRequest - Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest createApplicationRequest, AsyncHandler<CreateApplicationRequest,CreateApplicationResult> asyncHandler)
Creates an application with the given name and description.
createApplicationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<CreateTagsResult> createTagsAsync(CreateTagsRequest createTagsRequest)
Creates one or more tags for configuration items. Tags are metadata that help you categorize IT assets. This API accepts a list of multiple configuration items.
createTagsRequest - Future<CreateTagsResult> createTagsAsync(CreateTagsRequest createTagsRequest, AsyncHandler<CreateTagsRequest,CreateTagsResult> asyncHandler)
Creates one or more tags for configuration items. Tags are metadata that help you categorize IT assets. This API accepts a list of multiple configuration items.
createTagsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DeleteApplicationsResult> deleteApplicationsAsync(DeleteApplicationsRequest deleteApplicationsRequest)
Deletes a list of applications and their associations with configuration items.
deleteApplicationsRequest - Future<DeleteApplicationsResult> deleteApplicationsAsync(DeleteApplicationsRequest deleteApplicationsRequest, AsyncHandler<DeleteApplicationsRequest,DeleteApplicationsResult> asyncHandler)
Deletes a list of applications and their associations with configuration items.
deleteApplicationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DeleteTagsResult> deleteTagsAsync(DeleteTagsRequest deleteTagsRequest)
Deletes the association between configuration items and one or more tags. This API accepts a list of multiple configuration items.
deleteTagsRequest - Future<DeleteTagsResult> deleteTagsAsync(DeleteTagsRequest deleteTagsRequest, AsyncHandler<DeleteTagsRequest,DeleteTagsResult> asyncHandler)
Deletes the association between configuration items and one or more tags. This API accepts a list of multiple configuration items.
deleteTagsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DescribeAgentsResult> describeAgentsAsync(DescribeAgentsRequest describeAgentsRequest)
Lists agents or the Connector by ID or lists all agents/Connectors associated with your user account if you did not specify an ID.
describeAgentsRequest - Future<DescribeAgentsResult> describeAgentsAsync(DescribeAgentsRequest describeAgentsRequest, AsyncHandler<DescribeAgentsRequest,DescribeAgentsResult> asyncHandler)
Lists agents or the Connector by ID or lists all agents/Connectors associated with your user account if you did not specify an ID.
describeAgentsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DescribeConfigurationsResult> describeConfigurationsAsync(DescribeConfigurationsRequest describeConfigurationsRequest)
Retrieves attributes for a list of configuration item IDs. All of the supplied IDs must be for the same asset type (server, application, process, or connection). Output fields are specific to the asset type selected. For example, the output for a server configuration item includes a list of attributes about the server, such as host name, operating system, and number of network cards.
For a complete list of outputs for each asset type, see Using the DescribeConfigurations Action.
describeConfigurationsRequest - Future<DescribeConfigurationsResult> describeConfigurationsAsync(DescribeConfigurationsRequest describeConfigurationsRequest, AsyncHandler<DescribeConfigurationsRequest,DescribeConfigurationsResult> asyncHandler)
Retrieves attributes for a list of configuration item IDs. All of the supplied IDs must be for the same asset type (server, application, process, or connection). Output fields are specific to the asset type selected. For example, the output for a server configuration item includes a list of attributes about the server, such as host name, operating system, and number of network cards.
For a complete list of outputs for each asset type, see Using the DescribeConfigurations Action.
describeConfigurationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.@Deprecated Future<DescribeExportConfigurationsResult> describeExportConfigurationsAsync(DescribeExportConfigurationsRequest describeExportConfigurationsRequest)
Deprecated. Use DescribeExportTasks instead.
Retrieves the status of a given export process. You can retrieve status from a maximum of 100 processes.
describeExportConfigurationsRequest - @Deprecated Future<DescribeExportConfigurationsResult> describeExportConfigurationsAsync(DescribeExportConfigurationsRequest describeExportConfigurationsRequest, AsyncHandler<DescribeExportConfigurationsRequest,DescribeExportConfigurationsResult> asyncHandler)
Deprecated. Use DescribeExportTasks instead.
Retrieves the status of a given export process. You can retrieve status from a maximum of 100 processes.
describeExportConfigurationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest describeExportTasksRequest)
Retrieve status of one or more export tasks. You can retrieve the status of up to 100 export tasks.
describeExportTasksRequest - Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest describeExportTasksRequest, AsyncHandler<DescribeExportTasksRequest,DescribeExportTasksResult> asyncHandler)
Retrieve status of one or more export tasks. You can retrieve the status of up to 100 export tasks.
describeExportTasksRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DescribeTagsResult> describeTagsAsync(DescribeTagsRequest describeTagsRequest)
Retrieves a list of configuration items that are tagged with a specific tag. Or retrieves a list of all tags assigned to a specific configuration item.
describeTagsRequest - Future<DescribeTagsResult> describeTagsAsync(DescribeTagsRequest describeTagsRequest, AsyncHandler<DescribeTagsRequest,DescribeTagsResult> asyncHandler)
Retrieves a list of configuration items that are tagged with a specific tag. Or retrieves a list of all tags assigned to a specific configuration item.
describeTagsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DisassociateConfigurationItemsFromApplicationResult> disassociateConfigurationItemsFromApplicationAsync(DisassociateConfigurationItemsFromApplicationRequest disassociateConfigurationItemsFromApplicationRequest)
Disassociates one or more configuration items from an application.
disassociateConfigurationItemsFromApplicationRequest - Future<DisassociateConfigurationItemsFromApplicationResult> disassociateConfigurationItemsFromApplicationAsync(DisassociateConfigurationItemsFromApplicationRequest disassociateConfigurationItemsFromApplicationRequest, AsyncHandler<DisassociateConfigurationItemsFromApplicationRequest,DisassociateConfigurationItemsFromApplicationResult> asyncHandler)
Disassociates one or more configuration items from an application.
disassociateConfigurationItemsFromApplicationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.@Deprecated Future<ExportConfigurationsResult> exportConfigurationsAsync(ExportConfigurationsRequest exportConfigurationsRequest)
Deprecated. Use StartExportTask instead.
Exports all discovered configuration data to an Amazon S3 bucket or an application that enables you to view and evaluate the data. Data includes tags and tag associations, processes, connections, servers, and system performance. This API returns an export ID that you can query using the DescribeExportConfigurations API. The system imposes a limit of two configuration exports in six hours.
exportConfigurationsRequest - @Deprecated Future<ExportConfigurationsResult> exportConfigurationsAsync(ExportConfigurationsRequest exportConfigurationsRequest, AsyncHandler<ExportConfigurationsRequest,ExportConfigurationsResult> asyncHandler)
Deprecated. Use StartExportTask instead.
Exports all discovered configuration data to an Amazon S3 bucket or an application that enables you to view and evaluate the data. Data includes tags and tag associations, processes, connections, servers, and system performance. This API returns an export ID that you can query using the DescribeExportConfigurations API. The system imposes a limit of two configuration exports in six hours.
exportConfigurationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<GetDiscoverySummaryResult> getDiscoverySummaryAsync(GetDiscoverySummaryRequest getDiscoverySummaryRequest)
Retrieves a short summary of discovered assets.
getDiscoverySummaryRequest - Future<GetDiscoverySummaryResult> getDiscoverySummaryAsync(GetDiscoverySummaryRequest getDiscoverySummaryRequest, AsyncHandler<GetDiscoverySummaryRequest,GetDiscoverySummaryResult> asyncHandler)
Retrieves a short summary of discovered assets.
getDiscoverySummaryRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<ListConfigurationsResult> listConfigurationsAsync(ListConfigurationsRequest listConfigurationsRequest)
Retrieves a list of configuration items according to criteria that you specify in a filter. The filter criteria identifies the relationship requirements.
listConfigurationsRequest - Future<ListConfigurationsResult> listConfigurationsAsync(ListConfigurationsRequest listConfigurationsRequest, AsyncHandler<ListConfigurationsRequest,ListConfigurationsResult> asyncHandler)
Retrieves a list of configuration items according to criteria that you specify in a filter. The filter criteria identifies the relationship requirements.
listConfigurationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<ListServerNeighborsResult> listServerNeighborsAsync(ListServerNeighborsRequest listServerNeighborsRequest)
Retrieves a list of servers that are one network hop away from a specified server.
listServerNeighborsRequest - Future<ListServerNeighborsResult> listServerNeighborsAsync(ListServerNeighborsRequest listServerNeighborsRequest, AsyncHandler<ListServerNeighborsRequest,ListServerNeighborsResult> asyncHandler)
Retrieves a list of servers that are one network hop away from a specified server.
listServerNeighborsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<StartDataCollectionByAgentIdsResult> startDataCollectionByAgentIdsAsync(StartDataCollectionByAgentIdsRequest startDataCollectionByAgentIdsRequest)
Instructs the specified agents or connectors to start collecting data.
startDataCollectionByAgentIdsRequest - Future<StartDataCollectionByAgentIdsResult> startDataCollectionByAgentIdsAsync(StartDataCollectionByAgentIdsRequest startDataCollectionByAgentIdsRequest, AsyncHandler<StartDataCollectionByAgentIdsRequest,StartDataCollectionByAgentIdsResult> asyncHandler)
Instructs the specified agents or connectors to start collecting data.
startDataCollectionByAgentIdsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<StartExportTaskResult> startExportTaskAsync(StartExportTaskRequest startExportTaskRequest)
Begins the export of discovered data to an S3 bucket.
If you specify agentId in a filter, the task exports up to 72 hours of detailed data collected by
the identified Application Discovery Agent, including network, process, and performance details. A time range for
exported agent data may be set by using startTime and endTime. Export of detailed agent
data is limited to five concurrently running exports.
If you do not include an agentId filter, summary data is exported that includes both AWS Agentless
Discovery Connector data and summary data from AWS Discovery Agents. Export of summary data is limited to two
exports per day.
startExportTaskRequest - Future<StartExportTaskResult> startExportTaskAsync(StartExportTaskRequest startExportTaskRequest, AsyncHandler<StartExportTaskRequest,StartExportTaskResult> asyncHandler)
Begins the export of discovered data to an S3 bucket.
If you specify agentId in a filter, the task exports up to 72 hours of detailed data collected by
the identified Application Discovery Agent, including network, process, and performance details. A time range for
exported agent data may be set by using startTime and endTime. Export of detailed agent
data is limited to five concurrently running exports.
If you do not include an agentId filter, summary data is exported that includes both AWS Agentless
Discovery Connector data and summary data from AWS Discovery Agents. Export of summary data is limited to two
exports per day.
startExportTaskRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<StopDataCollectionByAgentIdsResult> stopDataCollectionByAgentIdsAsync(StopDataCollectionByAgentIdsRequest stopDataCollectionByAgentIdsRequest)
Instructs the specified agents or connectors to stop collecting data.
stopDataCollectionByAgentIdsRequest - Future<StopDataCollectionByAgentIdsResult> stopDataCollectionByAgentIdsAsync(StopDataCollectionByAgentIdsRequest stopDataCollectionByAgentIdsRequest, AsyncHandler<StopDataCollectionByAgentIdsRequest,StopDataCollectionByAgentIdsResult> asyncHandler)
Instructs the specified agents or connectors to stop collecting data.
stopDataCollectionByAgentIdsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest updateApplicationRequest)
Updates metadata about an application.
updateApplicationRequest - Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest updateApplicationRequest, AsyncHandler<UpdateApplicationRequest,UpdateApplicationResult> asyncHandler)
Updates metadata about an application.
updateApplicationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.