Tous les produits
Search
Centre de documentation

Elastic Compute Service:CreateLaunchTemplateVersion

Dernière mise à jour :Aug 18, 2026

Crée une nouvelle version dans un modèle de lancement ECS spécifié pour la création ultérieure d'instances ECS, de groupes de mise à l'échelle élastique ou de groupes de provisionnement automatique.

Description de l'opération

Description de l'opération

Pour modifier les paramètres d'une version spécifique, créez une nouvelle version du modèle. Chaque modèle de lancement d'instance prend en charge un maximum de 30 versions.

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:CreateLaunchTemplateVersion

create

*LaunchTemplate

acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région. Vous pouvez appeler DescribeRegions pour interroger la liste des régions la plus récente.

cn-hangzhou

RegionId

string

Oui

L'identifiant de la région. Vous pouvez appeler DescribeRegions pour interroger la liste des régions la plus récente.

cn-hangzhou

LaunchTemplateId

string

Non

L'identifiant du modèle de lancement. Pour plus d'informations, appelez DescribeLaunchTemplates. Vous devez spécifier LaunchTemplateId ou LaunchTemplateName pour déterminer le modèle de lancement.

lt-m5eiaupmvm2op9d****

LaunchTemplateName

string

Non

Le nom du modèle de lancement. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

testLaunchTemplateName

VersionDescription

string

Non

La description de la version du modèle de lancement. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.

testVersionDescription

ImageId

string

Non

L'identifiant de l'image utilisée pour créer l'instance. Vous pouvez appeler DescribeImages pour interroger les ressources d'images disponibles.

win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd

ImageOwnerAlias

string

Non

La source de l'image.

Remarque

Ce paramètre sera obsolète. Pour améliorer la compatibilité, utilisez d'autres paramètres.

system

PasswordInherit

boolean

Non

Indique s'il faut utiliser le mot de passe prédéfini de l'image. Valeurs valides :

  • true

  • false

Valeur par défaut : false.

Remarque

Lorsque vous utilisez ce paramètre, le paramètre Password doit être vide. Vous devez également vous assurer que l'image possède un mot de passe prédéfini.

false

InstanceType

string

Non

Le type d'instance. Pour plus d'informations, consultez Famille d'instances. Vous pouvez également appeler DescribeInstanceTypes pour interroger la liste des types d'instances la plus récente.

ecs.g5.large

SecurityGroupId

string

Non

L'identifiant du groupe de sécurité auquel l'instance créée à l'aide de cette version appartient. Les instances d'un même groupe de sécurité peuvent communiquer entre elles.

Remarque

Vous ne pouvez pas spécifier à la fois SecurityGroupId et SecurityGroupIds.N.

sg-bp15ed6xe1yxeycg****

VpcId

string

Non

L'identifiant du cloud privé virtuel (VPC) auquel l'instance appartient.

vpc-bp12433upq1y5scen****

VSwitchId

string

Non

L'identifiant du vSwitch. Vous devez spécifier ce paramètre lorsque vous créez une instance connectée à un VPC.

vsw-bp1s5fnvk4gn2tws0****

InstanceName

string

Non

Le nom de l'instance. Le nom doit comporter de 2 à 128 caractères et peut contenir des lettres, des chiffres et des caractères de la catégorie des lettres Unicode (qui inclut des caractères de diverses langues). Le nom peut contenir des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-). La valeur par défaut est l'InstanceId de l'instance.

Lorsque vous créez plusieurs instances ECS à la fois, vous pouvez configurer par lot des noms d'instance séquentiels contenant des crochets ([]) et des virgules (,). Pour plus d'informations, consultez Configurer par lot des noms ou des noms d'hôte séquentiels pour plusieurs instances.

k8s-node-[1,4]-alibabacloud

Description

string

Non

La description de l'instance. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.

testDescription

InternetMaxBandwidthIn

integer

Non

La bande passante publique entrante maximale. Unité : Mbit/s. Valeurs valides :

  • Si la bande passante publique sortante achetée est inférieure ou égale à 10 Mbit/s : 1 à 10. Valeur par défaut : 10.

  • Si la bande passante publique sortante achetée est supérieure à 10 Mbit/s : 1 à la valeur de InternetMaxBandwidthOut. Valeur par défaut : la valeur de InternetMaxBandwidthOut.

50

InternetMaxBandwidthOut

integer

Non

La bande passante publique sortante maximale. Unité : Mbit/s. Valeurs valides : 0 à 100.

5

HostName

string

Non

Le nom d'hôte du serveur Elastic Compute Service (ECS).

  • Le nom d'hôte ne peut pas commencer ou se terminer par un point (.) ou un trait d'union (-), et ne peut pas contenir de points ou de traits d'union consécutifs.

  • Instances Windows : le nom d'hôte doit comporter entre 2 et 15 caractères et ne peut pas contenir de points (.) ni être composé uniquement de chiffres. Il peut contenir des lettres, des chiffres et des traits d'union (-).

  • Autres instances (telles que Linux) : le nom d'hôte doit comporter entre 2 et 64 caractères. Il peut contenir plusieurs points (.), chaque segment entre les points pouvant contenir des lettres, des chiffres et des traits d'union (-).

testHostName

ZoneId

string

Non

L'identifiant de la zone de l'instance.

cn-hangzhou-g

SystemDisk.Category

string

Non

La catégorie du disque système. Valeurs valides :

  • cloud : disque de base.

  • cloud_efficiency : disque ultra.

  • cloud_ssd : SSD standard.

  • cloud_auto : disque ESSD AutoPL.

  • cloud_essd : SSD d'entreprise (ESSD). Vous pouvez utiliser le paramètre SystemDisk.PerformanceLevel pour configurer le niveau de performance du disque.

  • cloud_essd_entry : disque ESSD Entry.

Pour les types d'instances obsolètes qui ne sont pas des instances optimisées pour les E/S, la valeur par défaut est cloud. Pour les autres types d'instances, la valeur par défaut est cloud_efficiency.

cloud_ssd

SystemDisk.Size

integer

Non

La taille du disque système. Unité : GiB. Valeurs valides :\n\n- cloud : 20 à 500.\n- Autres catégories de disques : 20 à 2048.\n\nLa valeur de ce paramètre doit être supérieure ou égale à max{20, ImageSize}.

40

SystemDisk.DiskName

string

Non

Le nom du disque système. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

cloud_ssdSystem

SystemDisk.Description

string

Non

La description du disque système. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.

testSystemDiskDescription

SystemDisk.Iops

integer

Non

Remarque

Ce paramètre n'est pas disponible publiquement.

30000

SystemDisk.PerformanceLevel

string

Non

Le niveau de performance du disque ESSD utilisé comme disque système. Configurez le niveau de performance en fonction des valeurs valides suivantes :

  • PL0 (par défaut) : un disque unique peut fournir jusqu'à 10 000 IOPS en lecture/écriture aléatoire.

  • PL1 : un disque unique peut fournir jusqu'à 50 000 IOPS en lecture/écriture aléatoire.

  • PL2 : un disque unique peut fournir jusqu'à 100 000 IOPS en lecture/écriture aléatoire.

  • PL3 : un disque unique peut fournir jusqu'à 1 000 000 IOPS en lecture/écriture aléatoire.

Pour plus d'informations sur la sélection d'un niveau de performance ESSD, consultez ESSD.

PL0

SystemDisk.DeleteWithInstance

boolean

Non

Indique si le disque système doit être libéré lorsque l'instance est libérée. Valeurs valides :

  • true : libère le disque système lorsque l'instance est libérée.

  • false : ne libère pas le disque système lorsque l'instance est libérée.

Valeur par défaut : true.

true

SystemDisk.AutoSnapshotPolicyId

string

Non

L'identifiant de la stratégie d'instantané automatique appliquée au disque système.

sp-bp1dgzpaxwc4load****

SystemDisk.ProvisionedIops

integer

Non

Les IOPS de lecture/écriture provisionnés du disque ESSD AutoPL utilisé comme disque système. Valeurs valides : 0 à min{50000, 1000 × Capacité - Performances de base}.

Performances de base = min{1 800 + 50 × Capacité, 50 000}.

Remarque

Ce paramètre est disponible uniquement lorsque DiskCategory est défini sur cloud_auto. Pour plus d'informations, consultez Disques ESSD AutoPL et Modifier les performances provisionnées d'un disque ESSD AutoPL.

50000

SystemDisk.BurstingEnabled

boolean

Non

Indique si la fonctionnalité de burst de performances doit être activée. Valeurs valides :

  • true : active la fonctionnalité de burst de performances.

  • false : n'active pas la fonctionnalité de burst de performances.

true

IoOptimized

string

Non

Indique si l'instance est optimisée pour les E/S. Valeurs valides :

  • none : l'instance n'est pas optimisée pour les E/S.

  • optimized : l'instance est optimisée pour les E/S.

optimized

InstanceChargeType

string

Non

Le mode de facturation de l'instance. Valeurs valides :

  • PrePaid : abonnement. Si vous définissez ce paramètre sur PrePaid, vérifiez que votre compte prend en charge le paiement par crédit. Sinon, une erreur InvalidPayMethod est renvoyée.

  • PostPaid : paiement à l'usage.

PrePaid

Period

integer

Non

La durée d'abonnement de la ressource. Unité : mois. Ce paramètre prend effet et n'est requis que lorsque InstanceChargeType est défini sur PrePaid. Valeurs valides : 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 et 60.

1

InternetChargeType

string

Non

La méthode de facturation de la bande passante Internet sortante. Valeurs valides :

  • PayByBandwidth : facturation par bande passante.

  • PayByTraffic : facturation par trafic.

Remarque

En mode facturation par trafic, les bandes passantes de crête entrante et sortante sont utilisées comme limites supérieures de bande passante au lieu de spécifications de performances garanties. En cas de contention de ressources, les bandes passantes de crête peuvent être limitées. Si vous souhaitez une bande passante garantie, utilisez le mode facturation par bande passante.

PayByTraffic

EnableVmOsConfig

boolean

Non

Indique si la configuration du système d'exploitation de l'instance doit être activée.

false

NetworkType

string

Non

Le type de réseau de l'instance. Valeurs valides :

  • vpc : VPC.

  • classic : réseau classique. Le réseau classique a été retiré. Pour plus d'informations, consultez Avis de retrait.

vpc

UserData

string

Non

Les données utilisateur de l'instance. Les données utilisateur de l'instance doivent être encodées en Base64. Les données brutes peuvent avoir une taille maximale de 32 Ko.

ZWNobyBoZWxsbyBl****

KeyPairName

string

Non

Le nom de la paire de clés.

  • Pour les instances Windows, ce paramètre est ignoré. Même si vous spécifiez ce paramètre, seul le contenu de Password est utilisé.

  • Pour les instances Linux, la connexion par mot de passe est désactivée lors de l'initialisation.

testKeyPairName

RamRoleName

string

Non

Le nom du rôle RAM de l'instance. Vous pouvez appeler l'API RAM ListRoles pour interroger les rôles RAM d'instance que vous avez créés.

testRamRoleName

AutoReleaseTime

string

Non

L'heure de libération automatique. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.

  • Si la valeur des secondes (ss) n'est pas 00, l'heure est automatiquement arrondie au début de la minute en cours (mm).

  • L'heure de libération la plus précoce est 30 minutes après l'heure actuelle.

  • L'heure de libération la plus tardive ne peut pas excéder trois ans à compter de l'heure actuelle.

2018-01-01T12:05:00Z

SpotStrategy

string

Non

La stratégie de préemption de l'instance à la demande. Ce paramètre prend effet lorsque InstanceChargeType est défini sur PostPaid. Valeurs valides :

  • NoSpot : l'instance est une instance à la demande standard.

  • SpotWithPriceLimit : l'instance est une instance spot avec un prix horaire maximum défini par l'utilisateur.

  • SpotAsPriceGo : l'instance est une instance spot pour laquelle le prix du marché au moment de l'achat est automatiquement utilisé comme prix de l'offre.

NoSpot

SpotPriceLimit

number

Non

Le prix horaire maximum de l'instance. Un maximum de trois décimales est pris en charge.

0.97

SpotDuration

integer

Non

La période de protection de l'instance spot. Unité : heures. Valeur par défaut : 1. Valeurs valides :

  • 1 : Après la création d'une instance spot, Alibaba Cloud garantit que l'instance n'est pas libérée automatiquement dans l'heure qui suit. Une fois la période de protection d'une heure terminée, le système compare le prix proposé au prix du marché et vérifie l'inventaire des ressources pour déterminer s'il faut conserver ou libérer automatiquement l'instance.

  • 0 : Après la création d'une instance spot, Alibaba Cloud ne garantit pas que l'instance s'exécute pendant une heure. Le système compare le prix proposé au prix du marché et vérifie l'inventaire des ressources pour déterminer s'il faut conserver ou libérer automatiquement l'instance.

Alibaba Cloud envoie une notification d'événement système ECS 5 minutes avant la libération de l'instance. Les instances spot sont facturées à la seconde. Nous vous recommandons de sélectionner une période de protection appropriée en fonction de la durée d'exécution prévue de la tâche.

Remarque

Ce paramètre prend effet uniquement lorsque SpotStrategy est défini sur SpotWithPriceLimit ou SpotAsPriceGo.

1

ResourceGroupId

string

Non

L'identifiant du groupe de ressources.

rg-bp67acfmxazb4p****

SecurityEnhancementStrategy

string

Non

Indique si le renforcement de la sécurité du système d'exploitation doit être activé. Valeurs valides :\n\n- Active : active le renforcement de la sécurité. Cette valeur s'applique uniquement aux images publiques.\n- Deactive : n'active pas le renforcement de la sécurité. Cette valeur s'applique à tous les types d'images.

Active

PrivateIpAddress

string

Non

L'adresse IP privée de l'instance.

Lorsque vous spécifiez une adresse IP privée pour une instance ECS connectée à un VPC, l'adresse IP doit provenir du bloc CIDR disponible du vSwitch VSwitchId.

10.1.**.**

Ipv6AddressCount

integer

Non

Le nombre d'adresses IPv6 à générer aléatoirement pour l'interface réseau élastique (ENI) principale. Valeurs valides : 1 à 10.

1

DeploymentSetId

string

Non

L'identifiant du jeu de déploiement.

ds-bp1brhwhoqinyjd6****

DataDisk

array<object>

Non

La liste des disques de données.

object

Non

La liste des disques de données.

PerformanceLevel

string

Non

Le niveau de performance du disque ESSD utilisé comme disque de données. La valeur de N doit être identique à celle de DataDisk.N.Category=cloud_essd. Configurez le niveau de performance en fonction des valeurs valides suivantes :

  • PL0 : Un disque unique peut fournir jusqu'à 10 000 IOPS en lecture/écriture aléatoires.

  • PL1 (par défaut) : Un disque unique peut fournir jusqu'à 50 000 IOPS en lecture/écriture aléatoires.

  • PL2 : Un disque unique peut fournir jusqu'à 100 000 IOPS en lecture/écriture aléatoires.

  • PL3 : Un disque unique peut fournir jusqu'à 1 000 000 IOPS en lecture/écriture aléatoires.

Pour plus d'informations sur la sélection d'un niveau de performance ESSD, consultez ESSD.

PL1

Description

string

Non

La description du disque de données. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.

testDataDiskDescription

SnapshotId

string

Non

L'identifiant de l'instantané utilisé pour créer le disque de données N. Valeurs valides de N : 1 à 16. Lorsque DataDisk.N.SnapshotId est spécifié, DataDisk.N.Size est ignoré. La taille réelle du disque créé est celle de l'instantané spécifié.

Les instantanés créés le 15 juillet 2013 ou avant ne peuvent pas être utilisés. Les requêtes utilisant de tels instantanés sont rejetées.

s-bp17441ohwka0yuh****

Size

integer

Non

La taille du disque de données N. Valeurs valides de N : 1 à 16. Unité : GiB. Valeurs valides :

  • cloud : 5 à 2000.

  • cloud_efficiency : 20 à 32768.

  • cloud_ssd : 20 à 32768.

  • cloud_essd : la plage de valeurs valides dépend de la valeur de DataDisk.N.PerformanceLevel.
    • PL0 : 1 à 32768.

    • PL1 : 20 à 32768.

    • PL2 : 461 à 32768.

    • PL3 : 1261 à 32768.

  • cloud_auto : 1 à 32768.

  • cloud_essd_entry : 10 à 32768.

La valeur de ce paramètre doit être supérieure ou égale à la taille de l'instantané spécifié par SnapshotId.

2000

Device

string

Non

Le point de montage du disque de données. Les conventions de nommage des points de montage varient en fonction du nombre de disques de données attachés :

  • 1 à 25 disques de données : /dev/xvd[b-z]

  • Plus de 25 disques de données : /dev/xvd[aa-zz]. Par exemple, le 26e disque de données est nommé /dev/xvdaa, le 27e disque de données est nommé /dev/xvdab, et ainsi de suite.

Remarque

Ce paramètre s'applique uniquement aux scénarios d'image complète (image système). Vous pouvez définir ce paramètre sur le point de montage du disque de données dans l'image complète et modifier les paramètres DataDisk.N.Size et DataDisk.N.Category correspondants pour changer la catégorie et la taille du disque de données dans l'image complète.

/dev/xvdb

DiskName

string

Non

Le nom du disque de données. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

testDataDiskName

Category

string

Non

La catégorie du disque de données N. Valeurs valides :

  • cloud_efficiency : disque ultra.

  • cloud_ssd : SSD standard.

  • cloud_essd : SSD d'entreprise.

  • cloud : disque de base.

  • cloud_auto : disque ESSD AutoPL.

  • cloud_regional_disk_auto : ESSD régional.

  • cloud_essd_entry : disque ESSD Entry.
    Remarque

    La valeur cloud_essd_entry n'est prise en charge que lorsque InstanceType est configuré sur un type d'instance de la famille ecs.u1 ou ecs.e.

  • elastic_ephemeral_disk_standard : disque éphémère élastique - Standard.

  • elastic_ephemeral_disk_premium : disque éphémère élastique - Édition Premium.

Pour les instances optimisées pour les E/S, la valeur par défaut est cloud_efficiency. Pour les instances non optimisées pour les E/S, la valeur par défaut est cloud. Détails de la valeur par défaut :

  • Lorsque InstanceType est défini sur un type d'instance obsolète qui n'est pas optimisé pour les E/S, la valeur par défaut du paramètre est cloud.

  • Dans les autres cas, la valeur par défaut est cloud_efficiency.

cloud_ssd

DeleteWithInstance

boolean

Non

Indique si le disque de données doit être libéré lorsque l'instance est libérée. Valeurs valides :

  • true : libère le disque de données lorsque l'instance est libérée.

  • false : ne libère pas le disque de données lorsque l'instance est libérée.

Valeur par défaut : true.

true

Encrypted

string

Non

Indique si le disque de données doit être chiffré.

false

ProvisionedIops

integer

Non

Les IOPS de lecture/écriture provisionnés du disque ESSD AutoPL utilisé comme disque système. Valeurs valides : 0 à min{50000, 1000 × Capacité - Performances de base}.

Performances de base = min{1 800 + 50 × Capacité, 50 000}.

Remarque

Ce paramètre est disponible uniquement lorsque DiskCategory est défini sur cloud_auto. Pour plus d'informations, consultez Disques ESSD AutoPL et Modifier les performances provisionnées d'un disque ESSD AutoPL.

50000

BurstingEnabled

boolean

Non

Indique si la fonctionnalité de burst de performances doit être activée. Valeurs valides :

  • true : active la fonctionnalité de burst de performances.

  • false : n'active pas la fonctionnalité de burst de performances.

true

AutoSnapshotPolicyId

string

Non

L'identifiant de la stratégie d'instantané automatique appliquée au disque de données.

sp-bp67acfmxazb4p****

KMSKeyId

string

Non

L'identifiant de la clé KMS pour le disque de données.

0e478b7a-4262-4802-b8cb-00d****

NetworkInterface

array<object>

Non

Les informations de la carte d'interface réseau (NIC).

object

Non

Les informations de la carte d'interface réseau (NIC).

VSwitchId

string

Non

L'identifiant du vSwitch auquel appartient la carte d'interface réseau (NIC) secondaire. L'instance et la NIC secondaire doivent se trouver dans le même VPC et la même zone de disponibilité, mais peuvent appartenir à des vSwitch différents. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

vsw-bp1s5fnvk4gn2tws0****

NetworkInterfaceName

string

Non

Le nom de la carte d'interface réseau (NIC) secondaire. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

testNetworkInterfaceName

Description

string

Non

La description de la carte d'interface réseau (NIC) secondaire. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

testNetworkInterfaceDescription

SecurityGroupId

string

Non

L'identifiant du groupe de sécurité auquel appartient l'interface réseau secondaire (NIC). Le groupe de sécurité de l'interface réseau secondaire doit appartenir au même VPC que l'instance. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

Remarque

Vous ne pouvez pas spécifier à la fois NetworkInterface.N.SecurityGroupId et NetworkInterface.N.SecurityGroupIds.N.

sg-bp15ed6xe1yxeycg****

PrimaryIpAddress

string

Non

L'adresse IP privée principale de la carte d'interface réseau (NIC) secondaire. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

192.168.**.**

SecurityGroupIds

array

Non

Les identifiants d'un ou plusieurs groupes de sécurité auxquels appartient l'interface réseau secondaire. Les groupes de sécurité et l'interface réseau secondaire doivent appartenir au même VPC. Les valeurs valides de N dans SecurityGroupIds.N dépendent du quota du nombre maximal de groupes de sécurité auxquels une interface réseau secondaire peut appartenir. Pour plus d'informations, consultez Limites. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

Remarque

Vous ne pouvez pas spécifier à la fois NetworkInterface.N.SecurityGroupId et NetworkInterface.N.SecurityGroupIds.N.

sg-bp67acfmxazb4p****

string

Non

Les identifiants d'un ou plusieurs groupes de sécurité auxquels appartient l'interface réseau secondaire. Les groupes de sécurité et l'interface réseau secondaire doivent appartenir au même VPC. Les valeurs valides de N dans SecurityGroupIds.N dépendent du quota du nombre maximal de groupes de sécurité auxquels une interface réseau secondaire peut appartenir. Pour plus d'informations, consultez Limites. La valeur de N dans NetworkInterface.N ne peut pas être supérieure à 1.

Remarque

Vous ne pouvez pas spécifier à la fois NetworkInterface.N.SecurityGroupId et NetworkInterface.N.SecurityGroupIds.N.

sg-bp67acfmxazb4p****

InstanceType

string

Non

Le type de l'ENI. Valeurs valides de N : 1 à 2. Si vous configurez une ENI, vous pouvez configurer soit un contrôleur d'interface réseau (NIC) principal, soit une ENI secondaire. Si vous configurez deux ENI, vous devez configurer un NIC principal et une ENI secondaire.

Valeurs valides :

  • Primary : NIC principal.

  • Secondary : ENI secondaire.

Valeur par défaut : Secondary.

Secondary

NetworkInterfaceTrafficMode

string

Non

Le mode de communication de l'ENI principale. Valeurs valides :

  • Standard : utilise le mode de communication TCP.

  • HighPerformance : active l'Elastic RDMA Interface (ERI) et utilise le mode de communication RDMA.

Standard

DeleteOnRelease

boolean

Non

Indique si l'ENI doit être conservée lorsque l'instance est libérée. Valeurs valides :

  • true : ne conserve pas l'ENI.

  • false : conserve l'ENI.

Valeur par défaut : true.

Remarque

Ce paramètre prend effet uniquement pour les ENI secondaires.

true

Tag

array<object>

Non

Les balises des instances, des disques et des ENI principales créés à l'aide de cette version.

object

Non

Les balises des instances, des disques et des ENI principales créés à l'aide de cette version.

Key

string

Non

La clé de balise des instances, des disques et des ENI principales créés à l'aide de cette version. Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.

TestKey

Value

string

Non

La valeur de balise des instances, des disques et des ENI principales créés à l'aide de cette version. Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://.

TestValue

SecurityGroupIds

array

Non

Les identifiants d'un ou plusieurs groupes de sécurité auxquels l'instance appartient. Les valeurs valides de N dépendent du nombre maximal de groupes de sécurité auxquels une instance peut appartenir. Pour plus d'informations, consultez Limites.

Remarque

Vous ne pouvez pas spécifier à la fois SecurityGroupId et SecurityGroupIds.N.

sg-bp15ed6xe1yxeycg7****

string

Non

Les identifiants d'un ou plusieurs groupes de sécurité auxquels l'instance appartient. Les valeurs valides de N dépendent du nombre maximal de groupes de sécurité auxquels une instance peut appartenir. Pour plus d'informations, consultez Limites.

Remarque

Vous ne pouvez pas spécifier à la fois SecurityGroupId et SecurityGroupIds.N.

sg-bp15ed6xe1yxeycg7****

SystemDisk.Encrypted

string

Non

Indique si le disque système doit être chiffré. Valeurs valides :

  • true : chiffre le disque système.

  • false : ne chiffre pas le disque système.

Valeur par défaut : false.

Remarque

Le chiffrement du disque système n'est pas pris en charge dans la zone D de la région de Hong Kong (Chine) ni dans la zone A de la région de Singapour lors de la création d'une instance.

false

DeletionProtection

boolean

Non

L'attribut de protection contre la libération de l'instance. Indique si l'instance peut être libérée depuis la console ou en appelant DeleteInstance. Valeurs valides :

  • true : active la protection contre la libération.

  • false : désactive la protection contre la libération.

Valeur par défaut : false.

Remarque

Cet attribut s'applique uniquement aux instances postpayées. Il ne peut restreindre que les opérations de libération manuelle et ne prend pas effet sur les opérations de libération initiées par le système.

false

CreditSpecification

string

Non

Le mode de fonctionnement de l'instance à performances modulables. Valeurs valides :

Standard

AutoRenew

boolean

Non

Indique si le renouvellement automatique doit être activé. Ce paramètre prend effet uniquement lorsque InstanceChargeType est défini sur PrePaid. Valeurs valides :

  • true : active le renouvellement automatique.

  • false : n'active pas le renouvellement automatique.

Valeur par défaut : false.

true

AutoRenewPeriod

integer

Non

La période de renouvellement automatique. Valeurs valides :

Si PeriodUnit est défini sur Month : 1, 2, 3, 6, 12, 24, 36, 48 et 60.

Valeur par défaut : 1.

1

PeriodUnit

string

Non

L'unité de la durée de l'abonnement. Valeurs valides :

Month (par défaut).

Month

HttpEndpoint

string

Non

Indique si le canal d'accès aux métadonnées d'instance doit être activé. Valeurs valides :

  • enabled : active le canal d'accès.

  • disabled : désactive le canal d'accès.

Valeur par défaut : enabled.

Remarque

Pour plus d'informations sur les métadonnées d'instance, consultez Présentation des métadonnées d'instance ECS.

enabled

HttpTokens

string

Non

Indique si le mode de sécurité renforcée (IMDSv2) doit être imposé pour l'accès aux métadonnées de l'instance. Valeurs valides :

  • optional : n'impose pas l'utilisation du mode de sécurité renforcée.

  • required : impose l'utilisation du mode de sécurité renforcée. Après avoir défini cette valeur, le mode normal ne peut plus être utilisé pour accéder aux métadonnées de l'instance.

Valeur par défaut : optional.

Remarque

Pour plus d'informations sur les modes d'accès aux métadonnées d'instance, consultez Présentation des métadonnées d'instance ECS.

optional

HttpPutResponseHopLimit

integer

Non

Remarque

Ce paramètre n'est pas disponible publiquement.

3

SystemDisk.KMSKeyId

string

Non

L'identifiant de la clé KMS du disque système.

0e478b7a-4262-4802-b8cb-00d3fb40****

ImageOptions

object

Non

Les informations sur les propriétés liées à l'image.

LoginAsNonRoot

boolean

Non

Indique si les instances qui utilisent cette image prennent en charge la connexion avec l'utilisateur ecs-user. Valeurs valides :

  • true : pris en charge.

  • false : non pris en charge.

false

SecurityOptions

object

Non

Les options de sécurité.

TrustedSystemMode

string

Non

Le mode système de confiance. Définissez la valeur sur vTPM.

Les familles d'instances suivantes prennent en charge le mode système de confiance :

  • g7, c7 et r7.

  • Famille d'instances à sécurité renforcée (g7t, c7t et r7t).

Lorsque vous créez des instances ECS des familles d'instances précédentes, vous devez configurer ce paramètre. Détails :

  • Pour utiliser le système de confiance d'Alibaba Cloud, définissez ce paramètre sur vTPM. La vérification de confiance est effectuée par le système de confiance d'Alibaba Cloud au démarrage de l'instance.

  • Si vous n'utilisez pas le système de confiance d'Alibaba Cloud, vous pouvez laisser ce paramètre vide. Cependant, si l'instance ECS que vous créez utilise le mode de calcul confidentiel basé sur Enclave (SecurityOptions.ConfidentialComputingMode=Enclave), le système de confiance est également activé pour l'instance.

  • Lorsque vous créez une instance ECS de confiance en appelant une opération d'API, vous pouvez uniquement appeler RunInstances. CreateInstance ne prend pas en charge la configuration du paramètre SecurityOptions.TrustedSystemMode.

Remarque

Si vous spécifiez une instance comme instance de confiance lors de sa création, vous pouvez uniquement utiliser des images qui prennent en charge le système de confiance lorsque vous remplacez le disque système.

Pour plus d'informations sur le système de confiance, consultez Présentation des fonctionnalités de confiance pour les instances à sécurité renforcée.

vTPM

Éléments de réponse

Élément

Type

Description

Exemple

object

LaunchTemplateVersionNumber

integer

Le numéro de version du modèle de lancement créé.

2

RequestId

string

L'identifiant de la requête.

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

LaunchTemplateId

string

L'identifiant du modèle de lancement. Pour plus d'informations, consultez DescribeLaunchTemplates.

Lorsque vous utilisez un modèle de lancement pour créer une instance, vous devez spécifier LaunchTemplateId ou LaunchTemplateName pour déterminer le modèle de lancement.

lt-bp1apo0bbbkuy0rj****

Exemples

JSON format

{
  "LaunchTemplateVersionNumber": 2,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DEX****",
  "LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidRegion.NotExist %s The specified region does not exist.
400 MissingParameter %s A parameter is not specified.
400 InvalidParameter %s The specified parameter is invalid.
400 InvalidDescription.Malformed The specified parameter "Description" is not valid. The source description can be 2 to 256 characters in length. It cannot start with http:// and https://.
400 InvalidUserData.SizeExceeded %s The size of your specified user data exceeds the maximum allowed value.
400 InvalidUserData.Base64FormatInvalid %s The specified user data is invalid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. The specified parameter HostName is invalid.
400 InvalidParams.CreateEniParams %s
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. The specified tag key already exists. Tag keys must be unique.
500 InternalError The request processing has failed due to some unknown error.
403 LaunchTemplateVersionLimitExceed %s The maximum number of launch template versions has been reached.
404 InvalidLaunchTemplate.NotFound %s The specified launch template does not exist. Check whether the parameter value is correct.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. The specified resource group does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.