ModifyImageAttribute - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ModifyImageAttribute	Opération à effectuer. Définissez la valeur sur ModifyImageAttribute.
RegionId	String	Oui	cn-hangzhou	ID de région de l'image personnalisée. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ImageId	String	Oui	m-bp18ygjuqnwhechc****	ID de l'image personnalisée.
ImageName	String	Non	testImageName	Nouveau nom de l'image personnalisée. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par acs: ou aliyun. Il ne peut pas contenir http:// ou https://. Il peut contenir des lettres, des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Ce paramètre est vide par défaut, ce qui signifie que le nom d'origine est conservé.
Status	String	Non	Deprecated	Nouvel état de l'image personnalisée. Valeurs valides : Deprecated : place l'image dans l'état Deprecated. Si l'image personnalisée est partagée, annulez le partage avant de la placer dans l'état Deprecated. Les images dans l'état Deprecated ne peuvent pas être partagées ni copiées, mais elles permettent de créer des instances ou de remplacer des disques système. Available : place l'image dans l'état Available. Vous pouvez restaurer une image de l'état Deprecated vers l'état Available. Remarque Pour revenir à une version antérieure d'une image personnalisée au sein d'une famille d'images, placez la dernière image personnalisée disponible dans l'état Deprecated. Une famille d'images ne contenant aucune image personnalisée dans l'état Available ne permet pas de créer des instances. Soyez prudent si une seule image personnalisée de la famille se trouve dans l'état Available.
ImageFamily	String	Non	hangzhou-daily-update	Nouveau nom de la famille d'images. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par acs: ou aliyun. Il ne peut pas contenir http:// ou https://. Il peut contenir des lettres, des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Ce paramètre est vide par défaut.
BootMode	String	Non	BIOS	Nouveau mode de démarrage de l'image. Valeurs valides : BIOS UEFI Remarque Si vous créez des instances à partir d'une image après avoir modifié son mode de démarrage, les nouvelles instances démarrent avec le nouveau mode. Pour garantir un démarrage correct, assurez-vous que l'image prend en charge le mode spécifié. Si vous ignorez les modes pris en charge, utilisez la fonctionnalité de vérification d'image. Pour plus d'informations, consultez la rubrique Présentation de la vérification d'image.
LicenseType	String	Non	BYOL	Type de licence utilisé pour activer le système d'exploitation après l'importation de l'image source. Définissez la valeur sur BYOL. BYOL : utilise la licence fournie avec le système d'exploitation source. Assurez-vous que votre clé de licence est compatible avec Alibaba Cloud.
Description	String	Non	testDescription	Nouvelle description de l'image personnalisée. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://. Ce paramètre est vide par défaut, ce qui signifie que la description d'origine est conservée.
Features.NvmeSupport	String	Non	supported	Indique si le protocole Non-Volatile Memory Express (NVMe) est pris en charge. Valeurs valides : supported : l'image prend en charge NVMe. Les instances créées à partir de cette image prennent en charge le protocole NVMe. unsupported : l'image ne prend pas en charge NVMe. Les instances créées à partir de cette image ne prennent pas en charge le protocole NVMe.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID de la requête.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

XML format

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

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

JSON format

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

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	Format ImageName non valide. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par acs: ou aliyun. Il ne peut pas contenir http:// ou https://. Il peut contenir des lettres, des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) et des traits d'union (-).
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	Le nom d'image spécifié existe déjà.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Format Description non valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
403	ImageStatus.NotAvailable	The specified image status is not available.	L'image spécifiée n'est pas dans l'état Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	L'image spécifiée n'est pas dans l'état Deprecated.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	Le mode de démarrage de l'image ne peut pas être modifié tant que l'image possède des instances associées.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	L'image spécifiée est introuvable dans ce compte. Vérifiez si l'ID d'image est correct.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.