ModifyImageAttribute - Elastic Compute Service - Centre de documentation Alibaba Cloud

Modifie les attributs d'une image personnalisée, tels que la famille d'images, le nom, le mode de démarrage, l'état et la prise en charge NVMe, en appelant l'opération ModifyImageAttribute avec des paramètres tels que ImageId et ImageFamily.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:ModifyImageAttribute

update

*Image.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'image personnalisée. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
ImageId	string	Oui	L'identifiant de l'image personnalisée.	m-bp18ygjuqnwhechc****
ImageName	string	Non	Le nom de l'image personnalisée. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre ou un caractère chinois et ne peut pas commencer par `aliyun` ou `acs:`. Il ne peut pas contenir `http://` ou `https://`. Il peut contenir des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) ou des traits d'union (-). Valeur par défaut : null, ce qui indique que le nom d'origine est conservé.	testImageName
Status	string	Non	L'état de l'image. Valeurs valides : Deprecated : place l'image dans l'état obsolète. Si vous avez partagé l'image personnalisée, vous devez annuler le partage avant de pouvoir la placer dans l'état obsolète. Une image obsolète ne peut être ni partagée ni copiée. Cependant, vous pouvez utiliser l'image pour créer des instances ou remplacer des disques système. Available : place l'image dans l'état disponible. Vous pouvez restaurer une image obsolète à l'état disponible. Remarque Pour restaurer une image personnalisée d'une famille d'images à la version précédente, vous pouvez placer la dernière image personnalisée disponible dans l'état obsolète. Cependant, si l'image est la seule image personnalisée disponible dans la famille d'images, la famille d'images n'aura plus d'image personnalisée disponible pour la création d'instances une fois l'image rendue obsolète. Procédez avec prudence.	Deprecated
ImageFamily	string	Non	Le nom de la famille d'images. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre ou un caractère chinois et ne peut pas commencer par `aliyun` ou `acs:`. Il ne peut pas contenir `http://` ou `https://`. Il peut contenir des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) ou des traits d'union (-). Valeur par défaut : null.	hangzhou-daily-update
BootMode	string	Non	Le mode de démarrage de l'image. Valeurs valides : BIOS : mode de démarrage BIOS (Basic Input/Output System). UEFI : mode de démarrage UEFI (Unified Extensible Firmware Interface). UEFI-Preferred : mode de double démarrage. Important Pour éviter que les instances ne parviennent pas à démarrer en raison d'un mode de démarrage non pris en charge, assurez-vous de bien comprendre les modes de démarrage pris en charge par l'image avant de modifier ce paramètre. Pour plus d'informations sur les modes de démarrage des images, consultez Modes de démarrage des images. Valeurs valides : BIOS : BIOS. UEFI : UEFI. UEFI-Preferred : UEFI-Preferred.	BIOS
LicenseType	string	Non	Le type de licence utilisé pour activer le système d'exploitation après l'importation de l'image. Actuellement, seul BYOL est pris en charge. BYOL : la licence fournie avec le système d'exploitation source. Lorsque vous utilisez BYOL, assurez-vous que votre clé de licence prend en charge l'utilisation sur Alibaba Cloud.	BYOL
Description	string	Non	La description de l'image personnalisée. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par `http://` ou `https://`. Valeur par défaut : null, ce qui indique que la description d'origine est conservée.	testDescription
Features	object	Non	Les attributs de fonctionnalité de l'image.
NvmeSupport	string	Non	Modifie l'attribut de prise en charge NVMe de l'image. Si ce paramètre n'est pas spécifié, la valeur actuelle est conservée. Important Avant d'activer cette fonctionnalité, assurez-vous que le pilote NVMe est préinstallé dans le système d'exploitation. Procédure recommandée : installez le pilote sur une instance, créez une image personnalisée, puis appelez cette opération. L'activation forcée de cette fonctionnalité sans le pilote entraînera des échecs de démarrage de l'instance.	supported
ImdsSupport	string	Non	Le mode d'accès aux métadonnées de l'image. Valeurs valides : v1 : lorsque vous créez une instance ECS à partir de cette image, vous ne pouvez pas définir le mode d'accès aux métadonnées sur IMDSv2 uniquement (mode renforcé). v2 : lorsque vous créez une instance ECS à partir de cette image, vous pouvez définir le mode d'accès aux métadonnées sur IMDSv2 uniquement (mode renforcé). Important ImdsSupport ne peut pas être modifié de v2 à v1. Si vous devez le modifier, créez une nouvelle image à partir de l'instantané associé à cette image et définissez la valeur sur v1.	v2
DryRun	boolean	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.	Le nom de l'image doit comporter de 2 à 128 caractères. Il doit commencer par une lettre ou un caractère chinois et peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) ou des traits d'union (-).
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.	Le nom d'image spécifié est déjà utilisé.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Le paramètre description spécifié est invalide.
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.	Le paramètre Features.ImdsSupport spécifié n'est pas pris en charge.
403	ImageStatus.NotAvailable	The specified image status is not available.	L'état de l'image spécifiée n'est pas Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	L'état de l'image spécifiée n'est pas Deprecated.
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.	L'attribut de mode de démarrage de l'image ne peut pas être modifié lorsque des instances y sont associées.
403	InvalidOperation.FeaturesImdsSupportNotMatch	The specified parameter Features.ImdsSupport can not be set to v1 from v2.	Le paramètre Features.ImdsSupport spécifié ne peut pas être modifié de v2 à v1.
403	InvalidStatus.ImageIsCreating	The operation cannot be performed because the image is creating. Please wait until the creation is complete and try again.	L'image est toujours en cours de création. Cette opération ne peut pas être effectuée. Attendez que l'image soit créée et réessayez.
403	InvalidOperation.PublicImageUnsupported	The community image's publisher is not the current account. Modification is not permitted.	L'éditeur de l'image communautaire n'est pas le compte actuel. La modification n'est pas autorisée.
403	InvalidDescription.Malformed	The specified parameter description is not valid.	Le paramètre description spécifié est invalide.
403	InvalidBootMode.SecureBootUnsupported	Secure Boot requires UEFI or UEFI-Preferred boot mode. Please check the BootMode and try again.	Le paramètre BootMode spécifié n'est pas valide. Ce mode de démarrage ne prend pas en charge le démarrage sécurisé.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	L'image spécifiée est introuvable. Assurez-vous que l'image existe dans la région actuelle et qu'elle est à l'état Available.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.