/*
* Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
/**
*
* 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. *
*