Skip to main content
PATCH
Actualizar los metadatos de una imagen
Acción de IAM principal: compute:UpdateImage. La actualización de una imagen de plataforma requiere que un principal actúe en la cuenta de la plataforma con compute:UpdateImage; otras cuentas reciben 403. Consulte permisos de computación para obtener ejemplos de directivas.

Autorizaciones

Authorization
string
header
requerido

Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.

Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.

Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.

Parámetros de ruta

image_id
string<uuid>
requerido

ID de imagen

Cuerpo

application/json
description
string
Ejemplo:

"Ubuntu 24.04 LTS (Noble Numbat)"

current
boolean

Cambie el puntero resolver por nombre para el nombre de esta imagen. true promueve esta versión a la actual (la acción de cambio / reversión) y degrada cualquier otra que fuera actual para la misma (nombre, arquitectura); false borra el puntero. Solo las imágenes activas pueden ser actualizadas.

Ejemplo:

true

eol_date
string<date> | null

Establezca la fecha de fin de vida de la versión. Un null explícito lo borra; omitir el campo lo deja sin cambios. La eliminación es importante porque el catálogo retira las imágenes de la plataforma en esta fecha, una que se registró por error tiene que ser removible.

Ejemplo:

"2026-08-31"

tags
object
Ejemplo:
attributes
object

Respuesta

Imagen actualizada

image
object
requerido