Actions72
- Image Actions
- Config Actions
- Container Actions
- Edge Group Actions
- Edge Stack Actions
- Network Actions
- Node Actions
- Registry Actions
- Secret Actions
- Service Actions
- Stack Actions
- Team Actions
- Template Actions
- User Actions
- Volume Actions
- Webhook Actions
Overview
This node integrates with the Portainer API to manage edge computing stacks ("Edge Stacks"). Specifically, the Delete operation for the Edge Stack resource allows users to delete an existing edge stack by its ID. This is useful in scenarios where you want to programmatically remove edge stacks that are no longer needed or to clean up resources in your edge computing environment.
Practical examples include:
- Automating cleanup of outdated or unused edge stacks.
- Integrating edge stack lifecycle management into CI/CD pipelines.
- Managing edge stacks remotely via workflows without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Force Delete | Whether to force deletion even if the edge stack resource is currently in use (boolean). |
| Edge Stack ID | The unique identifier of the edge stack to be deleted (string, required). |
Output
The node outputs JSON data representing the response from the Portainer API after attempting to delete the specified edge stack. Typically, this will be a confirmation of successful deletion or an error message if the deletion failed.
No binary data output is involved in this operation.
Dependencies
- Requires connection to a Portainer instance with API access.
- Needs an API key credential configured in n8n to authenticate requests to the Portainer API.
- The base URL of the Portainer API must be set in the credentials.
Troubleshooting
Common issues:
- Attempting to delete an edge stack that does not exist or providing an invalid Edge Stack ID will result in an error.
- Deletion may fail if the edge stack is currently in use and "Force Delete" is not enabled.
- Network connectivity or authentication failures with the Portainer API can cause errors.
Error messages and resolutions:
- 404 Not Found: The specified Edge Stack ID does not exist. Verify the ID is correct.
- 403 Forbidden / Unauthorized: API key is invalid or lacks permissions. Check API credentials.
- 409 Conflict: Resource is in use and cannot be deleted without forcing. Enable "Force Delete" to override.
- Network errors: Ensure the Portainer API endpoint is reachable from n8n.
Links and References
Note: This summary is based on static analysis of the node's source code and property definitions related to the Edge Stack Delete operation.