software.amazon.awssdk.services.applicationdiscovery.package-info Maven / Gradle / Ivy
Show all versions of applicationdiscovery Show documentation
/*
* Copyright 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
*
* 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.
*
*
*/
package software.amazon.awssdk.services.applicationdiscovery;