Portainer icon

Portainer

Work with Portainer API data to manage Docker

Actions86

Registry → Update

AI-generated

Overview

This node operation updates an existing Docker image registry in Portainer. It allows users to modify the registry's name, URL, username, and password. This is useful for managing and maintaining access credentials and details for Docker registries used in container deployments.

Use Case Examples

  1. Updating the URL and credentials of a Docker registry to ensure the latest access details are used for pulling images.
  2. Changing the registry name and authentication details when migrating to a new registry service.

Properties

Name Meaning
Registry ID The unique identifier of the registry to update.
Registry Name The new name to assign to the registry.
Registry URL The new URL of the registry.
Username The username for authenticating with the registry.
Password The password for authenticating with the registry.
Request Options Additional HTTP request options such as batching, SSL validation, proxy, and timeout settings.

Output

JSON

  • id - The unique identifier of the updated registry.
  • name - The updated name of the registry.
  • url - The updated URL of the registry.
  • username - The updated username for the registry.

Dependencies

  • Portainer API with an API key credential for authentication

Troubleshooting

  • Ensure the Registry ID is correct and exists in Portainer to avoid 'not found' errors.
  • Verify that the API key credential has sufficient permissions to update registries.
  • Check network connectivity and proxy settings if the request fails due to connection issues.
  • If SSL validation errors occur, consider enabling the 'Ignore SSL Issues' option cautiously.

Links

Discussion