image_update

El dominio image_update tiene 7 acciones. En la superficie meta se alcanzan todas a través de arcane_image_update; en la individual, cada una es una herramienta propia; en la dinámica se ejecutan con arcane_execute_action y el ID canónico.

Resumen

Acción	Título	Tipo
image_update.check_all	Check all images	escritura
image_update.check_batch	Check multiple images	escritura
image_update.check_by_id	Check image update by ID	escritura
image_update.check_by_id_refresh	Check image update by ID (POST)	escritura
image_update.check_ref	Check image update by reference	escritura
image_update.info_by_refs	Get persisted update info for image references	lectura
image_update.summary	Get update summary	lectura

Acciones

image_update.check_all

Check all images

• Tipo: escritura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_image_update con "action": "check_all"
• Herramienta individual: arcane_image_update_check_all
• Ruta de Arcane: POST /api/environments/{id}/image-updates/check-all
• ID de operación: check-all-images
• Uso: Checks every tagged local image plus the references containers (running or stopped) use against their registries, skipping images whose containers all opted out with the label com.getarcaneapp.arcane.update-check=false. The call waits for the whole scan (slow with many images), stores the results and deletes stored records of images that no longer exist. The answer maps each image reference to its result (hasUpdate, updateType, error…). Optional credentials work as in image_update.check_batch. Afterwards image_update.summary gives the totals and updater.run applies the updates.
• Acciones relacionadas: image_update.summary, image_update.check_batch, image_update.info_by_refs, updater.run

image_update.check_batch

Check multiple images

• Tipo: escritura
• Parámetros obligatorios: imageRefs
• Meta-herramienta: arcane_image_update con "action": "check_batch"
• Herramienta individual: arcane_image_update_check_batch
• Ruta de Arcane: POST /api/environments/{id}/image-updates/check-batch
• ID de operación: check-multiple-images
• Uso: Checks the listed references (imageRefs, an array of refs like nginx:1.27, where an empty array returns an empty map) against their registries in one background workflow, waits for it and stores the results. The answer maps each reference to its result (same shape as image_update.check_ref, each carrying the workflow’s activityId), and a reference whose check failed has its message in its error field instead of failing the call. Optional credentials (each entry needs url, username, token and enabled=true, otherwise it is ignored) replace the saved registry logins of registry.list for this check only. For every image of the environment use image_update.check_all.
• Acciones relacionadas: image_update.check_ref, image_update.check_all, image_update.info_by_refs, registry.list

image_update.check_by_id

Check image update by ID

• Tipo: escritura
• Parámetros obligatorios: imageId
• Meta-herramienta: arcane_image_update con "action": "check_by_id"
• Herramienta individual: arcane_image_update_check_by_id
• Ruta de Arcane: GET /api/environments/{id}/image-updates/check/{imageId}
• ID de operación: check-image-update-by-id
• Uso: Runs the image_update.check_ref check for a local image: imageId is an image ID from image.list (sha256: prefix optional) or a name:tag. Arcane resolves it to the image’s first repo tag (else its repository with :latest, or, for a pruned image, the tag reference a running or stopped container still uses) and fails if none exists. The result has the same shape as image_update.check_ref and is stored, so image.list and image_update.summary reflect it.
• Acciones relacionadas: image.list, image_update.check_ref, image_update.summary

image_update.check_by_id_refresh

Check image update by ID (POST)

• Tipo: escritura
• Parámetros obligatorios: imageId
• Meta-herramienta: arcane_image_update con "action": "check_by_id_refresh"
• Herramienta individual: arcane_image_update_check_by_id_refresh
• Ruta de Arcane: POST /api/environments/{id}/image-updates/check/{imageId}
• ID de operación: check-image-update-by-id-post
• Uso: POST twin of image_update.check_by_id: Arcane runs the very same handler (same imageId, same stored result), so prefer image_update.check_by_id.
• Acciones relacionadas: image_update.check_by_id, image.list

image_update.check_ref

Check image update by reference

• Tipo: escritura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_image_update con "action": "check_ref"
• Herramienta individual: arcane_image_update_check_ref
• Ruta de Arcane: GET /api/environments/{id}/image-updates/check
• ID de operación: check-image-update
• Uso: Asks the registry now whether one image reference has a newer version. imageRef (e.g. nginx:1.27, from image.list or container.list) is required although the schema marks it optional. The result (hasUpdate, updateType digest, local or not_pulled (the ref resolves remotely but is not pulled locally, so nothing is compared), currentDigest/latestDigest, error, activityId, containerUpdates keyed by container ID for containers with their own tag policy) is stored, logged as an activity and may trigger update notifications. Digest-pinned refs (name@sha256:…) and locally built images are answered without asking the registry, an unparsable reference comes back in the error field, but a registry lookup failure usually fails the call. For a local image ID use image_update.check_by_id, for several refs image_update.check_batch, for stored results without a registry call image_update.info_by_refs.
• Acciones relacionadas: image_update.check_by_id, image_update.check_batch, image_update.info_by_refs, image.pull, updater.container_update

image_update.info_by_refs

Get persisted update info for image references

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_image_update con "action": "info_by_refs"
• Herramienta individual: arcane_image_update_info_by_refs
• Ruta de Arcane: GET /api/environments/{id}/image-updates/by-refs
• ID de operación: get-update-info-by-refs
• Uso: Reads the stored results of earlier checks without contacting any registry: imageRefs is one comma-separated string (e.g. nginx:1.27,redis:7), not an array. The answer maps each given reference to its last image-level result. References never checked are simply absent, so run image_update.check_ref or image_update.check_batch for those or for fresher data. Needs only the image-updates:read permission, unlike the check actions (image-updates:check).
• Acciones relacionadas: image_update.check_ref, image_update.check_batch, image_update.summary

image_update.summary

Get update summary

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_image_update con "action": "summary"
• Herramienta individual: arcane_image_update_summary
• Ruta de Arcane: GET /api/environments/{id}/image-updates/summary
• ID de operación: get-update-summary
• Uso: Totals for the environment: totalImages counts the current local images, imagesWithUpdates, digestUpdates and errorsCount come from stored check results for those images. No registry is contacted, so run image_update.check_all first for fresh numbers. To apply updates use updater.run (all) or updater.container_update (one container).
• Acciones relacionadas: image_update.check_all, image_update.info_by_refs, updater.run, updater.container_update