DeleteAgent - AWS Application Discovery Service

DeleteAgent

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.

An object representing the agent or data collector to be deleted along with the optional configurations for error handling.

Contents

agentId

The ID of the agent or data collector to delete.

Type: String

Length Constraints: Minimum length of 10. Maximum length of 20.

Pattern: \S+

Required: Yes

force

Optional flag used to force delete an agent or data collector. It is needed to delete any agent in HEALTHY/UNHEALTHY/RUNNING status. Note that deleting an agent that is actively reporting health causes it to be re-registered with a different agent ID after data collector re-connects with AWS.

Type: Boolean

Required: No

See Also

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