* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.applicationdiscovery.AbstractAWSApplicationDiscovery} instead. *
*
*
* Amazon Web Services Application Discovery Service (Application Discovery Service) helps you plan application * migration projects. It automatically identifies servers, virtual machines (VMs), and network dependencies in your * on-premises data centers. For more information, see the Amazon Web Services Application Discovery Service FAQ. *
** Application Discovery Service offers three ways of performing discovery and collecting data about your on-premises * servers: *
** Agentless discovery using Amazon Web Services Application Discovery Service Agentless Collector (Agentless * Collector), which doesn't require you to install an agent on each host. *
** Agentless Collector gathers server information regardless of the operating systems, which minimizes the time required * for initial on-premises infrastructure assessment. *
** Agentless Collector doesn't collect information about network dependencies, only agent-based discovery collects that * information. *
** Agent-based discovery using the Amazon Web Services Application Discovery Agent (Application Discovery Agent) * collects a richer set of data than agentless discovery, which you install on one or more hosts in your data center. *
** The agent captures infrastructure and application information, including an inventory of running processes, system * performance information, resource utilization, and network dependencies. *
** The information collected by agents is secured at rest and in transit to the Application Discovery Service database * in the Amazon Web Services cloud. For more information, see Amazon Web Services * Application Discovery Agent. *
** Amazon Web Services Partner Network (APN) solutions integrate with Application Discovery Service, enabling you * to import details of your on-premises environment directly into Amazon Web Services Migration Hub (Migration Hub) * without using Agentless Collector or Application Discovery Agent. *
** Third-party application discovery tools can query Amazon Web Services Application Discovery Service, and they can * write to the Application Discovery Service database using the public API. *
** In this way, you can import data into Migration Hub and view it, so that you can associate applications with servers * and track migrations. *
** Working With This Guide *
** 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 Amazon Web Services SDKs to access an API that is tailored to the programming * language or platform that you're using. For more information, see Amazon * Web Services SDKs. *
** Remember that you must set your Migration Hub home Region before you call any of these APIs. *
*
* You must make API calls for write actions (create, notify, associate, disassociate, import, or put) while in your
* home Region, or a HomeRegionNotSetException error is returned.
*
* API calls for read actions (list, describe, stop, and delete) are permitted outside of your home Region. *
*
* Although it is unlikely, the Migration Hub home Region could change. If you call APIs outside the home Region, an
* InvalidInputException is returned.
*
* You must call GetHomeRegion to obtain the latest Migration Hub home Region.
*
* This guide is intended for use with the Amazon Web Services Application Discovery * Service User Guide. *
** All data is handled according to the Amazon Web Services Privacy * Policy. You can operate Application Discovery Service offline to inspect collected data before it is shared with * the service. *
** Callers can pass in just the endpoint (ex: "discovery.us-west-2.amazonaws.com") or a full URL, including the * protocol (ex: "https://discovery.us-west-2.amazonaws.com"). If the protocol is not specified here, the default * protocol from this client's {@link ClientConfiguration} will be used, which by default is HTTPS. *
* For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available * endpoints for all AWS services, see: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- * choose-endpoint *
* This method is not threadsafe. An endpoint should be configured when the client is created and before any * service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in * transit or retrying. * * @param endpoint * The endpoint (ex: "discovery.us-west-2.amazonaws.com") or a full URL, including the protocol (ex: * "https://discovery.us-west-2.amazonaws.com") of the region specific AWS endpoint this client will * communicate with. * @deprecated use {@link AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)} for * example: * {@code builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));} */ @Deprecated void setEndpoint(String endpoint); /** * An alternative to {@link AWSApplicationDiscovery#setEndpoint(String)}, sets the regional endpoint for this * client's service calls. Callers can use this method to control which AWS region they want to work with. *
* By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the * {@link ClientConfiguration} supplied at construction. *
* This method is not threadsafe. A region should be configured when the client is created and before any service * requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit * or retrying. * * @param region * The region this client will communicate with. See {@link Region#getRegion(com.amazonaws.regions.Regions)} * for accessing a given region. Must not be null and must be a region where the service is available. * * @see Region#getRegion(com.amazonaws.regions.Regions) * @see Region#createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration) * @see Region#isServiceSupported(String) * @deprecated use {@link AwsClientBuilder#setRegion(String)} */ @Deprecated void setRegion(Region region); /** *
* Associates one or more configuration items with an application. *
* * @param associateConfigurationItemsToApplicationRequest * @return Result of the AssociateConfigurationItemsToApplication operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.AssociateConfigurationItemsToApplication */ AssociateConfigurationItemsToApplicationResult associateConfigurationItemsToApplication( AssociateConfigurationItemsToApplicationRequest associateConfigurationItemsToApplicationRequest); /** ** Deletes one or more import tasks, each identified by their import ID. Each import task has a number of records * that can identify servers or applications. *
** Amazon Web Services Application Discovery Service has built-in matching logic that will identify when discovered * servers match existing entries that you've previously discovered, the information for the already-existing * discovered server is updated. When you delete an import task that contains records that were used to match, the * information in those matched records that comes from the deleted records will also be deleted. *
* * @param batchDeleteImportDataRequest * @return Result of the BatchDeleteImportData operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.BatchDeleteImportData */ BatchDeleteImportDataResult batchDeleteImportData(BatchDeleteImportDataRequest batchDeleteImportDataRequest); /** ** Creates an application with the given name and description. *
* * @param createApplicationRequest * @return Result of the CreateApplication operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.CreateApplication */ CreateApplicationResult createApplication(CreateApplicationRequest createApplicationRequest); /** ** 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. *
** Do not store sensitive information (like personal data) in tags. *
** Deletes a list of applications and their associations with configuration items. *
* * @param deleteApplicationsRequest * @return Result of the DeleteApplications operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.DeleteApplications */ DeleteApplicationsResult deleteApplications(DeleteApplicationsRequest deleteApplicationsRequest); /** ** Deletes the association between configuration items and one or more tags. This API accepts a list of multiple * configuration items. *
* * @param deleteTagsRequest * @return Result of the DeleteTags operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws ResourceNotFoundException * The specified configuration ID was not located. Verify the configuration ID and try again. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.DeleteTags */ DeleteTagsResult deleteTags(DeleteTagsRequest deleteTagsRequest); /** *
* Lists agents or collectors as specified by ID or other filters. All agents/collectors associated with your user
* can be listed if you call DescribeAgents as is without passing any parameters.
*
* Retrieves attributes for a list of configuration item IDs. *
** All of the supplied IDs must be for the same asset type from one of the following: *
** server *
** application *
** process *
** connection *
** Output fields are specific to the asset type specified. For example, the output for a server configuration * item includes a list of attributes about the server, such as host name, operating system, number of network * cards, etc. *
** For a complete list of outputs for each asset type, see Using the DescribeConfigurations Action in the Amazon Web Services Application Discovery Service User * Guide. *
*
* Lists exports as specified by ID. All continuous exports associated with your user can be listed if you call
* DescribeContinuousExports as is without passing any parameters.
*
* DescribeExportConfigurations is deprecated. Use DescribeExportTasks, instead.
*
* Retrieve status of one or more export tasks. You can retrieve the status of up to 100 export tasks. *
* * @param describeExportTasksRequest * @return Result of the DescribeExportTasks operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.DescribeExportTasks */ DescribeExportTasksResult describeExportTasks(DescribeExportTasksRequest describeExportTasksRequest); /** ** Returns an array of import tasks for your account, including status information, times, IDs, the Amazon S3 Object * URL for the import file, and more. *
* * @param describeImportTasksRequest * @return Result of the DescribeImportTasks operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.DescribeImportTasks */ DescribeImportTasksResult describeImportTasks(DescribeImportTasksRequest describeImportTasksRequest); /** *
* Retrieves a list of configuration items that have tags as specified by the key-value pairs, name and value,
* passed to the optional parameter filters.
*
* There are three valid tag filter names: *
** tagKey *
** tagValue *
** configurationId *
*
* Also, all configuration items associated with your user that have tags can be listed if you call
* DescribeTags as is without passing any parameters.
*
* Disassociates one or more configuration items from an application. *
* * @param disassociateConfigurationItemsFromApplicationRequest * @return Result of the DisassociateConfigurationItemsFromApplication operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.DisassociateConfigurationItemsFromApplication */ DisassociateConfigurationItemsFromApplicationResult disassociateConfigurationItemsFromApplication( DisassociateConfigurationItemsFromApplicationRequest disassociateConfigurationItemsFromApplicationRequest); /** *
* 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. *
* * @param exportConfigurationsRequest * @return Result of the ExportConfigurations operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws OperationNotPermittedException * This operation is not permitted. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.ExportConfigurations */ @Deprecated ExportConfigurationsResult exportConfigurations(ExportConfigurationsRequest exportConfigurationsRequest); /** ** Retrieves a short summary of discovered assets. *
** This API operation takes no request parameters and is called as is at the command prompt as shown in the example. *
* * @param getDiscoverySummaryRequest * @return Result of the GetDiscoverySummary operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.GetDiscoverySummary */ GetDiscoverySummaryResult getDiscoverySummary(GetDiscoverySummaryRequest getDiscoverySummaryRequest); /** *
* Retrieves a list of configuration items as specified by the value passed to the required parameter
* configurationType. Optional filtering may be applied to refine search results.
*
* Retrieves a list of servers that are one network hop away from a specified server. *
* * @param listServerNeighborsRequest * @return Result of the ListServerNeighbors operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.ListServerNeighbors */ ListServerNeighborsResult listServerNeighbors(ListServerNeighborsRequest listServerNeighborsRequest); /** ** Start the continuous flow of agent's discovered data into Amazon Athena. *
* * @param startContinuousExportRequest * @return Result of the StartContinuousExport operation returned by the service. * @throws ConflictErrorException * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws OperationNotPermittedException * This operation is not permitted. * @throws ResourceInUseException * This issue occurs when the sameclientRequestToken is used with the
* StartImportTask action, but with different parameters. For example, you use the same request
* token but have two different import URLs, you can encounter this issue. If the import tasks are meant to
* be different, use a different clientRequestToken, and try again.
* @throws HomeRegionNotSetException
* The home Region is not set. Set the home Region to continue.
* @sample AWSApplicationDiscovery.StartContinuousExport
*/
StartContinuousExportResult startContinuousExport(StartContinuousExportRequest startContinuousExportRequest);
/**
* * Instructs the specified agents to start collecting data. *
* * @param startDataCollectionByAgentIdsRequest * @return Result of the StartDataCollectionByAgentIds operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.StartDataCollectionByAgentIds */ StartDataCollectionByAgentIdsResult startDataCollectionByAgentIds(StartDataCollectionByAgentIdsRequest startDataCollectionByAgentIdsRequest); /** ** Begins the export of a discovered data report to an Amazon S3 bucket managed by Amazon Web Services. *
** Exports might provide an estimate of fees and savings based on certain information that you provide. Fee * estimates do not include any taxes that might apply. Your actual fees and savings depend on a variety of factors, * including your actual usage of Amazon Web Services services, which might vary from the estimates provided in this * report. *
*
* If you do not specify preferences or agentIds in the filter, a summary of all servers,
* applications, tags, and performance is generated. This data is an aggregation of all server data collected
* through on-premises tooling, file import, application grouping and applying tags.
*
* If you specify agentIds 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. Export of detailed agent data is limited to two exports per
* day.
*
* If you enable ec2RecommendationsPreferences in preferences , an Amazon EC2 instance
* matching the characteristics of each server in Application Discovery Service is generated. Changing the
* attributes of the ec2RecommendationsPreferences changes the criteria of the recommendation.
*
* Starts an import task, which allows you to import details of your on-premises environment directly into Amazon * Web Services Migration Hub without having to use the Amazon Web Services Application Discovery Service * (Application Discovery Service) tools such as the Amazon Web Services Application Discovery Service Agentless * Collector or Application Discovery Agent. This gives you the option to perform migration assessment and planning * directly from your imported data, including the ability to group your devices as applications and track their * migration status. *
** To start an import request, do this: *
** Download the specially formatted comma separated value (CSV) import template, which you can find here: https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv. *
** Fill out the template with your server and application data. *
** Upload your import file to an Amazon S3 bucket, and make a note of it's Object URL. Your import file must be in * the CSV format. *
*
* Use the console or the StartImportTask command with the Amazon Web Services CLI or one of the Amazon
* Web Services SDKs to import the records from your file.
*
* For more information, including step-by-step procedures, see Migration Hub * Import in the Amazon Web Services Application Discovery Service User Guide. *
** There are limits to the number of import tasks you can create (and delete) in an Amazon Web Services account. For * more information, see Amazon Web * Services Application Discovery Service Limits in the Amazon Web Services Application Discovery Service * User Guide. *
*clientRequestToken is used with the
* StartImportTask action, but with different parameters. For example, you use the same request
* token but have two different import URLs, you can encounter this issue. If the import tasks are meant to
* be different, use a different clientRequestToken, and try again.
* @throws AuthorizationErrorException
* The user does not have permission to perform the action. Check the IAM policy associated with this user.
* @throws InvalidParameterException
* One or more parameters are not valid. Verify the parameters and try again.
* @throws InvalidParameterValueException
* The value of one or more parameters are either invalid or out of range. Verify the parameter values and
* try again.
* @throws ServerInternalErrorException
* The server experienced an internal error. Try again.
* @throws HomeRegionNotSetException
* The home Region is not set. Set the home Region to continue.
* @sample AWSApplicationDiscovery.StartImportTask
*/
StartImportTaskResult startImportTask(StartImportTaskRequest startImportTaskRequest);
/**
* * Stop the continuous flow of agent's discovered data into Amazon Athena. *
* * @param stopContinuousExportRequest * @return Result of the StopContinuousExport operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws OperationNotPermittedException * This operation is not permitted. * @throws ResourceNotFoundException * The specified configuration ID was not located. Verify the configuration ID and try again. * @throws ResourceInUseException * This issue occurs when the sameclientRequestToken is used with the
* StartImportTask action, but with different parameters. For example, you use the same request
* token but have two different import URLs, you can encounter this issue. If the import tasks are meant to
* be different, use a different clientRequestToken, and try again.
* @throws HomeRegionNotSetException
* The home Region is not set. Set the home Region to continue.
* @sample AWSApplicationDiscovery.StopContinuousExport
*/
StopContinuousExportResult stopContinuousExport(StopContinuousExportRequest stopContinuousExportRequest);
/**
* * Instructs the specified agents to stop collecting data. *
* * @param stopDataCollectionByAgentIdsRequest * @return Result of the StopDataCollectionByAgentIds operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.StopDataCollectionByAgentIds */ StopDataCollectionByAgentIdsResult stopDataCollectionByAgentIds(StopDataCollectionByAgentIdsRequest stopDataCollectionByAgentIdsRequest); /** ** Updates metadata about an application. *
* * @param updateApplicationRequest * @return Result of the UpdateApplication operation returned by the service. * @throws AuthorizationErrorException * The user does not have permission to perform the action. Check the IAM policy associated with this user. * @throws InvalidParameterException * One or more parameters are not valid. Verify the parameters and try again. * @throws InvalidParameterValueException * The value of one or more parameters are either invalid or out of range. Verify the parameter values and * try again. * @throws ServerInternalErrorException * The server experienced an internal error. Try again. * @throws HomeRegionNotSetException * The home Region is not set. Set the home Region to continue. * @sample AWSApplicationDiscovery.UpdateApplication */ UpdateApplicationResult updateApplication(UpdateApplicationRequest updateApplicationRequest); /** * Shuts down this client object, releasing any resources that might be held open. This is an optional method, and * callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client * has been shutdown, it should not be used to make any more requests. */ void shutdown(); /** * Returns additional metadata for a previously executed successful request, typically used for debugging issues * where a service isn't acting as expected. This data isn't considered part of the result data returned by an * operation, so it's available through this separate, diagnostic interface. ** 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 a request. * * @param request * The originally executed request. * * @return The response metadata for the specified request, or null if none is available. */ ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request); }