GetDiscoverySummary - AWS Application Discovery Service


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.

Response Syntax

{ "agentlessCollectorSummary": { "activeAgentlessCollectors": number, "denyListedAgentlessCollectors": number, "healthyAgentlessCollectors": number, "shutdownAgentlessCollectors": number, "totalAgentlessCollectors": number, "unhealthyAgentlessCollectors": number, "unknownAgentlessCollectors": number }, "agentSummary": { "activeAgents": number, "blackListedAgents": number, "healthyAgents": number, "shutdownAgents": number, "totalAgents": number, "unhealthyAgents": number, "unknownAgents": number }, "applications": number, "connectorSummary": { "activeConnectors": number, "blackListedConnectors": number, "healthyConnectors": number, "shutdownConnectors": number, "totalConnectors": number, "unhealthyConnectors": number, "unknownConnectors": number }, "meCollectorSummary": { "activeMeCollectors": number, "denyListedMeCollectors": number, "healthyMeCollectors": number, "shutdownMeCollectors": number, "totalMeCollectors": number, "unhealthyMeCollectors": number, "unknownMeCollectors": number }, "servers": number, "serversMappedToApplications": number, "serversMappedtoTags": number }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Details about Agentless Collector collectors, including status.

Type: CustomerAgentlessCollectorInfo object


Details about discovered agents, including agent status and health.

Type: CustomerAgentInfo object


The number of applications discovered.

Type: Long


Details about discovered connectors, including connector status and health.

Type: CustomerConnectorInfo object


Details about Migration Evaluator collectors, including collector status and health.

Type: CustomerMeCollectorInfo object


The number of servers discovered.

Type: Long


The number of servers mapped to applications.

Type: Long


The number of servers mapped to tags.

Type: Long


For information about the errors that are common to all actions, see Common Errors.


The user does not have permission to perform the action. Check the IAM policy associated with this user.

HTTP Status Code: 400


The home Region is not set. Set the home Region to continue.

HTTP Status Code: 400


One or more parameters are not valid. Verify the parameters and try again.

HTTP Status Code: 400


The value of one or more parameters are either invalid or out of range. Verify the parameter values and try again.

HTTP Status Code: 400


The server experienced an internal error. Try again.

HTTP Status Code: 500


Get discovery summary of discovered assets

In the following example GetDiscoverySummary is called as is, without any request parameters, directly from the AWS CLI and returns a summary of all discovered assets associated with your account.

Sample Request

$ aws discovery get-discovery-summary

Sample Response

{ "servers": 1370, "applications": 125, "serversMappedToApplications": 212, "serversMappedtoTags": 213, "agentlessCollectorSummary": { "activeAgentlessCollectors": 3, "denyListedAgentlessCollectors": 0, "healthyAgentlessCollectors": 3, "shutdownAgentlessCollectors": 0, "totalAgentlessCollectors": 15, "unhealthyAgentlessCollectors": 0, "unknownAgentlessCollectors": 12 }, "agentSummary": { "activeAgents": 3, "healthyAgents": 3, "blackListedAgents": 0, "shutdownAgents": 0, "unhealthyAgents": 0, "totalAgents": 16, "unknownAgents": 13 }, "connectorSummary": { "activeConnectors": 1, "healthyConnectors": 1, "blackListedConnectors": 0, "shutdownConnectors": 0, "unhealthyConnectors": 1, "totalConnectors": 2, "unknownConnectors": 0 }, "meCollectorSummary": { "activeMeCollectors": 1, "denyListedMeCollectors": 0, "healthyMeCollectors": 1, "shutdownMeCollectors": 0, "totalMeCollectors": 2, "unhealthyMeCollectors": 1, "unknownMeCollectors": 0 } }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: