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 Docker containers and other Docker-related resources. Specifically, the Container - Unpause operation allows you to unpause a paused Docker container within a specified environment (endpoint) managed by Portainer.
Use cases include:
- Resuming a container that was previously paused for maintenance or resource management.
- Automating container lifecycle management workflows where containers are paused and resumed based on external triggers or schedules.
- Managing container states in multi-environment Docker setups via Portainer.
Example: You have a container paused during off-hours to save resources and want to automatically unpause it at the start of the workday.
Properties
| Name | Meaning |
|---|---|
| Environment ID | The ID of the Portainer environment/endpoint where the container is running. |
| Container ID | The unique identifier of the Docker container to be unpaused. |
Output
The node outputs the JSON response returned by the Portainer API after attempting to unpause the container. This typically includes status information about the container or an empty response indicating success.
No binary data output is involved in this operation.
Dependencies
- Requires a valid connection to a Portainer instance with API access.
- An API key credential for authenticating requests to the Portainer API must be configured in n8n.
- The node uses the base URL and API key from the configured credentials to send HTTP POST requests to the Portainer API endpoint for unpausing containers.
Troubleshooting
Common issues:
- Invalid or missing Environment ID or Container ID will cause the request to fail.
- Insufficient permissions or invalid API key may result in authentication errors.
- Attempting to unpause a container that is not currently paused may return an error or no effect.
- Network connectivity issues between n8n and the Portainer server can cause request failures.
Error messages:
- Authentication errors: Check that the API key credential is correct and has sufficient permissions.
- 404 Not Found: Verify that the Environment ID and Container ID are correct and exist in Portainer.
- 409 Conflict or similar: The container might not be in a paused state; confirm container status before unpausing.
Resolution tips:
- Double-check input parameters for correctness.
- Ensure the Portainer API endpoint is reachable from n8n.
- Confirm the container's current state via a "Get" or "Inspect" operation before unpausing.