ModifyImageAttribute - - Centro de documentación de Alibaba Cloud

Modifica el nombre, la descripción, el estado o la familia de una imagen personalizada.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyImageAttribute	La operación que desea ejecutar. Establezca el valor en ModifyImageAttribute.
RegionId	String	Sí	cn-hangzhou	El ID de región de la imagen personalizada. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ImageId	String	Sí	m-bp18ygjuqnwhechc****	El ID de la imagen personalizada.
ImageName	String	No	testImageName	El nuevo nombre de la imagen personalizada. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con acs: ni aliyun. No puede contener http:// ni https://. Puede incluir letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-). Este parámetro está vacío de forma predeterminada, lo que indica que se conserva el nombre original.
Status	String	No	Deprecated	El nuevo estado de la imagen personalizada. Valores válidos: Deprecated: coloca la imagen en el estado Deprecated. Si la imagen personalizada está compartida, debe dejar de compartirla antes de ponerla en el estado Deprecated. Las imágenes en estado Deprecated no se pueden compartir ni copiar, pero sí usar para crear instancias o reemplazar discos del sistema. Available: coloca la imagen en el estado Available. Puede restaurar una imagen del estado Deprecated al estado Available. Nota Si desea revertir una imagen personalizada dentro de la familia de imágenes a una versión anterior, coloque la última imagen personalizada disponible en el estado Deprecated. Una familia de imágenes sin imágenes personalizadas en estado Available no se puede usar para crear instancias. Proceda con precaución si solo queda una única imagen personalizada en estado Available dentro de la familia de imágenes.
ImageFamily	String	No	hangzhou-daily-update	El nuevo nombre de la familia de imágenes. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con acs: ni aliyun. No puede contener http:// ni https://. Puede incluir letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-). Este parámetro está vacío de forma predeterminada.
BootMode	String	No	BIOS	El nuevo modo de arranque de la imagen. Valores válidos: BIOS UEFI Nota Si crea instancias a partir de una imagen después de cambiar su modo de arranque, las nuevas instancias se iniciarán con el nuevo modo configurado. Para garantizar que las instancias arranquen correctamente, asegúrese de que el modo de arranque especificado sea compatible con la imagen. Si desconoce los modos de arranque admitidos por la imagen, le recomendamos usar la función de comprobación de imágenes para verificarlo. Para obtener más información sobre esta función, consulte Descripción general de la comprobación de imágenes.
LicenseType	String	No	BYOL	El tipo de licencia utilizada para activar el sistema operativo tras importar la imagen de origen. Establezca el valor en BYOL. BYOL: Se utiliza la licencia incluida con el sistema operativo de origen. En este caso, asegúrese de que su clave de licencia sea válida para usarse en Alibaba Cloud.
Description	String	No	testDescription	La nueva descripción de la imagen personalizada. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://. Este parámetro está vacío de forma predeterminada, lo que indica que se conserva la descripción original.
Features.NvmeSupport	String	No	supported	Especifica si se admite el protocolo Non-Volatile Memory Express (NVMe). Valores válidos: supported: La imagen es compatible con NVMe. Las instancias creadas a partir de esta imagen admiten el protocolo NVMe. unsupported: La imagen no es compatible con NVMe. Las instancias creadas a partir de esta imagen no admiten el protocolo NVMe.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=ModifyImageAttribute
&RegionId=cn-hangzhou
&ImageId=m-bp18ygjuqnwhechc****
&ImageName=testImageName
&Status=Deprecated
&ImageFamily=hangzhou-daily-update
&BootMode=BIOS
&Description=testDescription
&Features={"NvmeSupport":"supported"}
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyImageAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyImageAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	Formato de ImageName no válido. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con acs: ni aliyun. No puede contener http:// ni https://. Puede incluir letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-).
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	El nombre de imagen especificado ya existe.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://.
403	ImageStatus.NotAvailable	The specified image status is not available.	La imagen especificada no se encuentra en el estado Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	La imagen especificada no se encuentra en el estado Deprecated.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	No se puede modificar el modo de arranque de la imagen mientras tenga instancias asociadas.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	No se encontró la imagen especificada en esta cuenta. Compruebe si el ID de la imagen es correcto.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.