Connect Secure icon

Connect Secure

Consume Connect Secure API

Actions222

Overview

This node operation deletes a specific agent discovery setting mapping in the "Discovery Settings" resource of the Connect Secure API. It is useful when you need to remove outdated or incorrect mappings related to agent discovery settings, helping maintain accurate and clean configuration data.

A practical example would be automating cleanup tasks where certain agent discovery mappings are no longer valid or needed, ensuring that the system does not retain obsolete configurations.

Properties

Name Meaning
X USER ID User Id (string) - identifies the user making the request; sent as a header X-USER-ID. This is required.
Id id (number) - the identifier of the agent discovery setting mapping to delete. This is required.

Output

The node outputs JSON data representing the response from the API after attempting to delete the specified agent discovery setting mapping. The exact structure depends on the API's response but typically includes confirmation of deletion or error details.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the Connect Secure API.
  • The node depends on the Connect Secure API being accessible and properly configured.
  • The X-USER-ID header must be provided to identify the user performing the deletion.

Troubleshooting

  • Missing or invalid X USER ID header: The API may reject requests without a valid user ID header. Ensure this property is set correctly.
  • Invalid or non-existent Id: If the specified id does not exist, the API will likely return an error indicating the resource was not found.
  • Authentication errors: Ensure the API key credential is valid and has sufficient permissions to perform deletions.
  • Network or connectivity issues: Verify network access to the Connect Secure API endpoint.

Links and References

  • Refer to the official Connect Secure API documentation for details on the "Delete Agent Discoverysetting Mapping" endpoint and its expected request/response formats.

Discussion