Portainer icon

Portainer

Work with Portainer API data to manage Docker

Actions86

Image → Get History

AI-generated

Overview

This node operation retrieves the history of a specific Docker image from a Portainer-managed environment. It is useful for users who want to inspect the layers and changes made to a Docker image over time, which can help in debugging, auditing, or understanding the image's build process.

Use Case Examples

  1. A DevOps engineer wants to see the detailed history of a Docker image to verify the layers and commands used during its creation.
  2. A developer needs to audit the changes made to a Docker image to ensure compliance with security policies.

Properties

Name Meaning
Environment ID The ID of the environment/endpoint in Portainer where the Docker image is located.
Image ID The unique identifier of the Docker image whose history is to be retrieved.
Request Options Additional HTTP request options such as batching, SSL certificate validation, proxy settings, and timeout configuration to customize the API request behavior.

Output

JSON

  • body - The JSON response body containing the history details of the specified Docker image.

Dependencies

  • Requires an API key credential for authenticating with the Portainer API.

Troubleshooting

  • Ensure the Environment ID and Image ID are correct and correspond to existing resources in Portainer.
  • Check network connectivity and proxy settings if the request fails to reach the Portainer API.
  • If SSL certificate validation errors occur, consider enabling the option to ignore SSL issues, but be aware of security implications.
  • Timeout errors may occur if the Portainer server is slow to respond; increase the timeout setting if necessary.

Links

Discussion