Response Syntax Response Elements Errors Examples See Also

GetDiscoverySummary

Important

AWS Application Discovery Service will discontinue onboarding new customers starting November 7, 2025. If you would like to use the service, please sign up prior to November 7, 2025. Existing customers can continue to use the service as normal. For more information, see AWS Application Discovery Service availability change.

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.

agentlessCollectorSummary

Details about Agentless Collector collectors, including status.

Type: CustomerAgentlessCollectorInfo object

agentSummary

Details about discovered agents, including agent status and health.

Type: CustomerAgentInfo object

applications

The number of applications discovered.

Type: Long

connectorSummary

Details about discovered connectors, including connector status and health.

Type: CustomerConnectorInfo object

meCollectorSummary

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

Type: CustomerMeCollectorInfo object

servers

The number of servers discovered.

Type: Long

serversMappedToApplications

The number of servers mapped to applications.

Type: Long

serversMappedtoTags

The number of servers mapped to tags.

Type: Long

Errors

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

AuthorizationErrorException

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

HTTP Status Code: 400

HomeRegionNotSetException

Important

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

HTTP Status Code: 400

InvalidParameterException

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

HTTP Status Code: 400

InvalidParameterValueException

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

ServerInternalErrorException

The server experienced an internal error. Try again.

HTTP Status Code: 500

Examples

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
    }
}