ModifyImageAttribute - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Modifica los atributos de una imagen personalizada, como la familia de imágenes, el nombre, el modo de arranque, el estado y la compatibilidad con NVMe, mediante la operación ModifyImageAttribute con parámetros como ImageId e ImageFamily.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifyImageAttribute

update

*Image

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región de la imagen personalizada. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ImageId	string	Sí	El ID de la imagen personalizada.	m-bp18ygjuqnwhechc****
ImageName	string	No	El nombre de la imagen personalizada. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra o un carácter chino y no puede comenzar con `aliyun` ni con `acs:`. No puede contener `http://` ni `https://`. Puede contener dígitos, puntos (.), dos puntos (:), guiones bajos (_) o guiones (-). Valor predeterminado: null, lo que indica que se conserva el nombre original.	testImageName
Status	string	No	El estado de la imagen. Valores válidos: Deprecated: Establece la imagen en el estado obsoleto. Si ha compartido la imagen personalizada, debe dejar de compartirla antes de poder establecerla en el estado obsoleto. Una imagen obsoleta no se puede compartir ni copiar. Sin embargo, puede usar la imagen para crear instancias o reemplazar discos del sistema. Available: Establece la imagen en el estado disponible. Puede restaurar una imagen obsoleta al estado disponible. Nota Para revertir una imagen personalizada en una familia de imágenes a la versión anterior, puede establecer la última imagen personalizada disponible en el estado obsoleto. Sin embargo, si la imagen es la única imagen personalizada disponible en la familia de imágenes, la familia de imágenes no tendrá ninguna imagen personalizada disponible para crear instancias después de que la imagen quede obsoleta. Proceda con precaución.	Deprecated
ImageFamily	string	No	El nombre de la familia de imágenes. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra o un carácter chino y no puede comenzar con `aliyun` ni con `acs:`. No puede contener `http://` ni `https://`. Puede contener dígitos, puntos (.), dos puntos (:), guiones bajos (_) o guiones (-). Valor predeterminado: null.	hangzhou-daily-update
BootMode	string	No	El modo de arranque de la imagen. Valores válidos: BIOS: Modo de arranque del Sistema Básico de Entrada/Salida (BIOS). UEFI: Modo de arranque de la Interfaz de Firmware Extensible Unificada (UEFI). UEFI-Preferred: Modo de arranque dual. Importante Para evitar que las instancias no se inicien debido a un modo de arranque no compatible, asegúrese de comprender los modos de arranque admitidos por la imagen antes de modificar este parámetro. Para obtener más información sobre los modos de arranque de imágenes, consulte Modos de arranque de imágenes. Valores válidos: BIOS : BIOS. UEFI : UEFI. UEFI-Preferred : UEFI-Preferred.	BIOS
LicenseType	string	No	El tipo de licencia utilizado para activar el sistema operativo después de importar la imagen. Actualmente, solo se admite BYOL. BYOL: La licencia que viene con el sistema operativo de origen. Cuando utilice BYOL, asegúrese de que su clave de licencia admita su uso en Alibaba Cloud.	BYOL
Description	string	No	La 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 con `https://`. Valor predeterminado: null, lo que indica que se conserva la descripción original.	testDescription
Features	object	No	Los atributos de características de la imagen.
NvmeSupport	string	No	Modifica el atributo de compatibilidad con NVMe de la imagen. Si no se especifica este parámetro, se conserva el valor actual. Importante Antes de habilitar esta característica, asegúrese de que el controlador NVMe esté preinstalado en el sistema operativo. Procedimiento recomendado: instale el controlador en una instancia, cree una imagen personalizada y luego llame a esta operación. Habilitar esta característica forzosamente sin el controlador provocará fallos en el inicio de la instancia.	supported
ImdsSupport	string	No	El modo de acceso a metadatos de la imagen. Valores válidos: v1: Cuando crea una instancia de ECS a partir de esta imagen, no puede configurar el modo de acceso a metadatos como solo IMDSv2 (modo reforzado). v2: Cuando crea una instancia de ECS a partir de esta imagen, puede configurar el modo de acceso a metadatos como solo IMDSv2 (modo reforzado). Importante ImdsSupport no se puede cambiar de v2 a v1. Si necesita cambiarlo, cree una nueva imagen a partir de la instantánea asociada con esta imagen y establezca el valor en v1.	v2
DryRun	boolean	No

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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	Image names must be between 2 and 128 characters long, using either English or Chinese characters. The name must start with a letter or a Chinese character, and can include numbers, colons, underscores and hyphens.	The length of the image name is 2 to 128 English or Chinese characters. It must start with an uppercase letter or a Chinese character and can contain numbers, colons (:), underscores (_), or dashes (-).
400	MissingParameter	The input parameter "RegionId" that is mandatory for processing this request is not supplied.
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	The specified image name is already in use.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	The resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400	ImageQuotaFull.ImageFamily	The specified image family has exceeded max number of images for one image family.
400	InvalidImageFamily.Malformed	The specified parameter "ImageFamily" is malformed.
400	ImageFamilyQuotaFull	The specified region has exceeded max number of image family.
400	InvalidBootMode.NotSupport	The specified parameter BootMode is not supported.
400	InvalidLicenseType.NotSupported	The specified parameter LicenseType is not supported.
400	InvalidParameter.FeaturesImdsSupport	The specified parameter Features.ImdsSupport is not supported.	The specified parameter Features.ImdsSupport is not supported.
403	ImageStatus.NotAvailable	The specified image status is not available.	The status of the specified image is not Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	The specified image is not in the Deprecated state.
403	ImageUseShared	The specified image has been shared to others, please remove shared accounts first.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	The boot mode of the image cannot be modified while the image has associated instances.
403	InvalidOperation.FeaturesImdsSupportNotMatch	The specified parameter Features.ImdsSupport can not be set to v1 from v2.	The specified parameter Features.ImdsSupport can not be set to v1 from v2.
403	InvalidStatus.ImageIsCreating	The operation cannot be performed because the image is creating. Please wait until the creation is complete and try again.	The operation cannot be performed because the image is creating. Please wait until the creation is complete and try again.
403	InvalidOperation.PublicImageUnsupported	The community image's publisher is not the current account. Modification is not permitted.	The community image's publisher is not the current account. Modification is not permitted.
403	InvalidDescription.Malformed	The specified parameter description is not valid.	The specified parameter description is invalid.
403	InvalidBootMode.SecureBootUnsupported	Secure Boot requires UEFI or UEFI-Preferred boot mode. Please check the BootMode and try again.	Secure Boot requires UEFI or UEFI-Preferred boot mode. Please check the startup mode and try again.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	The specified image does not exist in this account. Check whether the image ID is correct.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.