:ImportImage

Remarques sur l'utilisation

Tenez compte des points suivants :

• Avant d'importer une image, téléchargez-la dans un compartiment Object Storage Service (OSS). Pour plus d'informations, consultez Upload objects.

• Dans certains scénarios, vous pouvez créer une image à partir des données du système d'exploitation d'un serveur source, l'importer vers ECS, puis créer une instance ECS à partir de cette image. Le serveur source peut être un serveur physique, une machine virtuelle ou un hôte cloud. Si le pilote virtio n'est pas installé sur le serveur source, l'instance ECS créée risque de ne pas démarrer. Pour éviter ce problème, vérifiez que le pilote virtio est installé sur le serveur source avant d'importer l'image. Pour plus d'informations, consultez Install the virtio driver.

• Lors de votre première importation d'images, autorisez ECS à accéder à vos compartiments OSS via Resource Access Management (RAM). Si ECS n'est pas autorisé à accéder à vos compartiments OSS, le code d'erreur NoSetRoletoECSServiceAcount est renvoyé lors de l'appel de l'opération ImportImage. Accordez cette autorisation en un clic sur la page Cloud Resource Access Authorization de la console RAM. Vous pouvez également accorder l'autorisation en utilisant un rôle RAM et des politiques RAM. Les exemples suivants illustrent les politiques et les autorisations requises pour certaines étapes de la procédure d'autorisation. Pour plus d'informations, consultez Control access to resources by using RAM users.

  1. Créez un rôle nommé AliyunECSImageImportDefaultRole. Utilisez exactement ce nom de rôle, sans quoi l'image ne pourra pas être importée. Configurez la politique de confiance suivante pour le rôle : { "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "ecs.aliyuncs.com" ] } } ], "Version": "1" }

  2. Associez la politique système AliyunECSImageImportRolePolicy au rôle. Vous pouvez également créer une politique personnalisée contenant le contenu suivant et l'associer au rôle : { "Version": "1", "Statement": [ { "Action": [ "oss:GetObject", "oss:GetBucketLocation", "oss:GetBucketInfo" ], "Resource": "*", "Effect": "Allow" } ] }

• Vous ne pouvez pas supprimer une image en cours d'importation. Toutefois, appelez l'opération CancelTask pour annuler la tâche d'importation de l'image.

• Importez l'image uniquement dans la même région que le compartiment OSS dans lequel le fichier image a été téléchargé.

• Les valeurs valides de N dans DiskDeviceMapping.N vont de 1 à 17. Lorsque N est défini sur 1, le disque est un disque système. Lorsque N est compris entre 2 et 17, le disque est un disque de données. Lorsque N est supérieur à 17, les paramètres préfixés par DiskDeviceMapping.N sont ignorés.

• Lorsque vous définissez Architecture sur arm64 ou Platform sur CentOS Stream, Anolis, AlmaLinux, UOS, Kylin ou Rocky Linux, tenez compte des points suivants :

  • Pour garantir que le mot de passe puisse être défini ou que la paire de clés puisse être modifiée pour une image importée, assurez-vous que l'image répond aux exigences suivantes avant de l'importer :

    • Le noyau du système d'exploitation prend en charge la fonctionnalité CONFIG_FW_CFG_SYSFS. Par défaut, les noyaux de la communauté Linux version 4.6 et ultérieure, ainsi que les noyaux CentOS version 3.10.0-826.el7 et ultérieure, prennent en charge cette fonctionnalité. Exécutez la commande grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r) sur le serveur source de l'image. Si la sortie de la commande contient CONFIG_FW_CFG_SYSFS=y, le noyau de l'image prend en charge la fonctionnalité CONFIG_FW_CFG_SYSFS.

    • La dernière version de cloud-init Alibaba Cloud est installée sur le système d'exploitation. Si la version de cloud-init est 19.1, la version mineure doit être 19.1.3 ou ultérieure. Si la version de cloud-init est 0.7.6a dans certaines versions anciennes des systèmes d'exploitation, la version mineure doit être 0.7.6a15 ou ultérieure. Pour plus d'informations, consultez Install cloud-init.

    • Le système d'exploitation prend en charge l'algorithme de chiffrement SHA-512.

  • Si vous souhaitez qu'une image importée prenne en charge le redimensionnement des disques et des systèmes de fichiers, assurez-vous que l'image répond aux exigences suivantes avant de l'importer :

    • La version du noyau du système d'exploitation est supérieure à 3,6.

    • L'image prend en charge la commande growpart. Pour prendre en charge cette commande, installez le package cloud-utils-growpart. Les méthodes d'installation du package varient selon les systèmes d'exploitation. Pour plus d'informations, consultez Extend the partitions and file systems of disks on a Linux instance.

    • L'image prend en charge la commande resize2fs. Pour prendre en charge cette commande, installez le package e2fsprogs. Par défaut, ce package est installé sur le système d'exploitation. S'il n'est pas installé, installez-le.

    • La dernière version de cloud-init Alibaba Cloud est installée sur le système d'exploitation. Si la version de cloud-init est 19.1, la version mineure doit être 19.1.3 ou ultérieure. Si la version de cloud-init est 0.7.6a dans certaines versions anciennes des systèmes d'exploitation, la version mineure doit être 0.7.6a15 ou ultérieure. Pour plus d'informations, consultez Install cloud-init.

• Si l'image que vous souhaitez importer utilise l'architecture ARM64, configurez l'horloge temps réel (RTC) pour utiliser le standard de temps universel coordonné (UTC). Pour plus d'informations, consultez Linux time and time zones.

• Lors de l'importation d'images, spécifiez DetectionStrategy. Cela vous permet d'optimiser les images en fonction des résultats de la vérification. Pour plus d'informations, consultez Image check items.

Paramètres de requête

Paramètres de réponse

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.Format=QCOW2
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&DiskDeviceMapping.1.DiskImageSize=80
&ImageName=Test
&Description=Test
&Architecture=x86_64
&OSType=linux
&Platform=Aliyun
&LicenseType=Aliyun
&DetectionStrategy=Standard
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ImportImageResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <ImageId>m-bp67acfmxazb4p****</ImageId>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RegionId>cn-hangzhou</RegionId>
</ImportImageResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ImageId" : "m-bp67acfmxazb4p****",
  "TaskId" : "t-bp67acfmxazb4p****",
  "RegionId" : "cn-hangzhou"
}

Codes d'erreur

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