CreateLaunchTemplate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les modèles de lancement contiennent des configurations prédéfinies utilisées pour créer des instances, telles que la région, l'ID d'image, le type d'instance, l'ID de groupe de sécurité et les paramètres de bande passante publique. Si un paramètre spécifique que vous souhaitez utiliser n'est pas inclus dans un modèle de lancement, spécifiez ce paramètre lorsque vous utilisez le modèle pour créer une instance.

Après avoir créé un modèle de lancement en appelant l'opération CreateLaunchTemplate, le numéro de version du modèle est défini sur 1 par défaut. Vous pouvez créer plusieurs versions en appelant l'opération CreateLaunchTemplateVersion pour le modèle de lancement. Les numéros de version commencent à 1 et s'incrémentent d'un. Si vous ne spécifiez pas de numéro de version de modèle lors de l'utilisation d'un modèle de lancement pour créer des instances via l'opération RunInstances, la version par défaut est utilisée.

Tenez compte des éléments suivants :

Vous pouvez créer jusqu'à 30 modèles de lancement par région. Chaque modèle de lancement peut comporter jusqu'à 30 versions.
La plupart des paramètres des modèles de lancement sont facultatifs. Lorsque vous créez un modèle de lancement, ECS ne vérifie pas l'existence ni la validité des valeurs de paramètre spécifiées. Les valeurs des paramètres ne sont vérifiées que lorsque vous utilisez le modèle de lancement pour créer des instances.
Si vous configurez un paramètre spécifique dans un modèle de lancement, vous ne pouvez pas exclure ce paramètre lors de l'utilisation du modèle pour créer des instances via l'opération RunInstances. Par exemple, si vous définissez HostName sur LocalHost dans un modèle de lancement mais que vous ne spécifiez pas HostName lors de l'appel de l'opération RunInstances pour créer des instances à partir du modèle, le nom d'hôte de l'instance reste LocalHost. Si vous souhaitez remplacer la valeur LocalHost de HostName fournie par le modèle de lancement, vous pouvez définir HostName sur MyHost ou une autre valeur lors de l'appel de l'opération RunInstances.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateLaunchTemplate	L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateLaunchTemplate.
RegionId	String	Yes	cn-hangzhou	L'ID de région du modèle de lancement. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
TemplateTag.N.Key	String	No	TestKey	La clé du tag N que vous souhaitez ajouter au modèle de lancement. Valeurs valides de N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. La clé du tag peut contenir jusqu'à 128 caractères et ne doit pas contenir `http://` ni `https://`. La clé du tag ne doit pas commencer par `acs`: ou `aliyun`.
TemplateTag.N.Value	String	No	TestValue	La valeur du tag N que vous souhaitez ajouter au modèle de lancement. Valeurs valides de N : 1 à 20. La valeur du tag peut être une chaîne vide. La valeur du tag peut contenir jusqu'à 128 caractères et ne doit pas contenir `http://` ni `https://`. La valeur du tag ne doit pas commencer par `acs`: ou `aliyun`.
LaunchTemplateName	String	Yes	testLaunchTemplateName	Le nom du modèle de lancement. Le nom doit contenir entre 2 et 128 caractères. Le nom doit commencer par une lettre mais ne doit pas commencer par `http://` ni `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
VersionDescription	String	No	testVersionDescription	La description de la version du modèle de lancement. La description doit contenir entre 2 et 256 caractères et ne doit pas commencer par `http://` ni `https://`.
ImageId	String	No	win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd	L'ID de l'image. Vous pouvez appeler l'opération DescribeImages pour interroger les images disponibles.
ImageOwnerAlias	String	No	system	La source de l'image. Valeurs valides : system : images publiques fournies par Alibaba Cloud. self : images personnalisées que vous avez créées. others : images partagées provenant d'autres comptes Alibaba Cloud. marketplace : images issues de Alibaba Cloud Marketplace. Si des images Alibaba Cloud Marketplace sont disponibles, vous pouvez les utiliser sans avoir besoin de vous y abonner. Tenez compte des détails de facturation des images Alibaba Cloud Marketplace.
PasswordInherit	Boolean	No	false	Indique s'il faut utiliser le mot de passe prédéfini dans l'image. Remarque Si vous utilisez ce paramètre, laissez Password vide et assurez-vous que l'image sélectionnée possède un mot de passe prédéfini.
InstanceType	String	No	ecs.g5.large	Le type d'instance de l'instance. Pour plus d'informations, consultez Familles d'instances. Vous pouvez également appeler l'opération DescribeInstanceTypes pour interroger la liste des types d'instances la plus récente.
SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	L'ID du groupe de sécurité auquel l'instance appartient. Les instances d'un même groupe de sécurité peuvent communiquer entre elles. Chaque groupe de sécurité peut contenir jusqu'à 1 000 instances. Remarque Vous ne pouvez pas spécifier `SecurityGroupId` et `SecurityGroupIds.N` simultanément.
VpcId	String	No	vpc-bp12433upq1y5scen****	L'ID du réseau privé virtuel (VPC).
VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	L'ID du vSwitch auquel vous souhaitez connecter l'instance. Ce paramètre est requis si vous spécifiez VpcId.
InstanceName	String	No	testInstanceName	Le nom de l'instance. Le nom doit contenir entre 2 et 128 caractères. Le nom doit commencer par une lettre mais ne doit pas commencer par `http://` ni `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
Description	String	No	testECSDescription	La description de l'instance. La description doit contenir entre 2 et 256 caractères et ne doit pas commencer par `http://` ni `https://`.
InternetMaxBandwidthIn	Integer	No	10	La bande passante entrante publique maximale. Unité : Mbit/s. Valeurs valides : Si la bande passante sortante publique achetée est inférieure ou égale à 10 Mbit/s, les valeurs valides de ce paramètre sont comprises entre 1 et 10, et la valeur par défaut est 10. Si la bande passante sortante publique achetée est supérieure à 10 Mbit/s, les valeurs valides de ce paramètre sont comprises entre 1 et la valeur `InternetMaxBandwidthOut`, et la valeur par défaut est la valeur `InternetMaxBandwidthOut`.
InternetMaxBandwidthOut	Integer	No	10	La bande passante sortante publique maximale. Unité : Mbit/s. Valeurs valides : 0 à 100.
HostName	String	No	testHostName	Le nom d'hôte de l'instance. Le nom d'hôte ne doit pas commencer ni se terminer par un point (.) ou un tiret (-). Le nom d'hôte ne doit pas contenir de points (.) ou de tirets (-) consécutifs. Pour les instances Windows, le nom d'hôte doit contenir entre 2 et 15 caractères et ne doit pas contenir de points (.) ni être composé uniquement de chiffres. Le nom d'hôte peut contenir des lettres, des chiffres et des tirets (-). Pour les instances exécutant d'autres systèmes d'exploitation, tels que Linux, le nom d'hôte doit contenir entre 2 et 64 caractères. Séparez le nom d'hôte en plusieurs segments avec des points (.). Chaque segment peut contenir des lettres, des chiffres et des tirets (-).
ZoneId	String	No	cn-hangzhou-g	L'ID de zone de l'instance.
SystemDisk.Category	String	No	cloud_ssd	La catégorie du disque système. Valeurs valides : cloud : disque basique. cloud_efficiency : ultra-disque. cloud_ssd : SSD. cloud_essd : SSD amélioré (ESSD). Vous pouvez utiliser `SystemDisk.PerformanceLevel` pour définir le niveau de performance de l'ESSD à utiliser comme disque système. Pour les instances non optimisées pour les E/S d'un type d'instance retiré, la valeur par défaut est cloud. Pour les autres types d'instances, la valeur par défaut est cloud_efficiency.
SystemDisk.Size	Integer	No	40	La taille du disque système. Unité : GiB. Valeurs valides : 20 à 500. La valeur de ce paramètre doit être d'au moins 20 et supérieure ou égale à la taille de l'image.
SystemDisk.DiskName	String	No	testSystemDiskName	Le nom du disque système. Le nom doit contenir entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des points (.), des deux-points (:), des traits de soulignement (_) et des tirets (-). Le nom doit commencer par une lettre mais ne doit pas commencer par `http://` ni `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
SystemDisk.Description	String	No	testSystemDiskDescription	La description du disque système. La description doit contenir entre 2 et 256 caractères et ne doit pas commencer par `http://` ni `https://`.
SystemDisk.Iops	Integer	No	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
SystemDisk.PerformanceLevel	String	No	PL0	Le niveau de performance de l'ESSD à utiliser comme disque système. Valeurs valides : PL0 (par défaut) : un seul ESSD peut fournir jusqu'à 10 000 IOPS de lecture/écriture aléatoires. PL1 : un seul ESSD peut fournir jusqu'à 50 000 IOPS de lecture/écriture aléatoires. PL2 : un seul ESSD peut fournir jusqu'à 100 000 IOPS de lecture/écriture aléatoires. PL3 : un seul ESSD peut fournir jusqu'à 1 million d'IOPS de lecture/écriture aléatoires. Pour plus d'informations sur les niveaux de performance des ESSD, consultez Disques ESSD.
SystemDisk.DeleteWithInstance	Boolean	No	true	Indique s'il faut libérer le disque système lors de la libération de l'instance. Valeurs valides : true false Valeur par défaut : true.
SystemDisk.AutoSnapshotPolicyId	String	No	sp-gc7c37d4ylw7mtnk****	L'ID de la politique de snapshot automatique que vous souhaitez appliquer au disque système.
SystemDisk.ProvisionedIops	Long	No	50000	Les IOPS de lecture/écriture provisionnés du disque ESSD AutoPL. Valeurs valides : 0 à min{50 000, 1 000 × Capacité - IOPS de base}. IOPS de base = min{1 800 + 50 × Capacité, 50 000}. Remarque Ce paramètre est disponible uniquement si SystemDisk.Category est défini sur cloud_auto. Pour plus d'informations, consultez Disques ESSD AutoPL et Modifier les configurations de performance d'un disque ESSD AutoPL.
SystemDisk.BurstingEnabled	Boolean	No	true	Indique s'il faut activer la fonctionnalité de burst de performance. Valeurs valides : true false
IoOptimized	String	No	optimized	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.
InstanceChargeType	String	No	PrePaid	La méthode de facturation de l'instance. Valeurs valides : PrePaid : abonnement. Si vous définissez ce paramètre sur PrePaid, assurez-vous que votre compte dispose de crédits suffisants. Sinon, une erreur `InvalidPayMethod` est renvoyée. PostPaid : paiement à l'utilisation.
Period	Integer	No	1	La durée de l'abonnement de l'instance. Unité : mois. Ce paramètre prend effet et est requis uniquement si vous définissez `InstanceChargeType` sur `PrePaid`. Valeurs valides : 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 et 60.
InternetChargeType	String	No	PayByTraffic	La méthode de facturation pour l'utilisation du réseau. Valeurs valides : PayByBandwidth PayByTraffic Remarque Si la méthode de facturation pay-by-traffic est utilisée pour l'utilisation du réseau, les bandes passantes entrantes et sortantes maximales sont utilisées comme limites supérieures de bande passante plutôt que comme performances garanties. Dans les scénarios où la demande dépasse l'offre de ressources, les valeurs de bande passante maximales peuvent ne pas être atteintes. Si vous souhaitez des bandes passantes garanties pour vos instances, utilisez la méthode de facturation pay-by-bandwidth pour l'utilisation du réseau.
EnableVmOsConfig	Boolean	No	false	Indique s'il faut activer les configurations du système d'exploitation de l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Pour garantir la compatibilité future, nous vous recommandons d'utiliser d'autres paramètres.
NetworkType	String	No	vpc	Le type de réseau de l'instance. Valeurs valides : classic : réseau classique. vpc : VPC.
UserData	String	No	ZWNobyBoZWxsbyBlY3Mh	Les données utilisateur de l'instance. Les données utilisateur doivent être encodées en Base64. La taille maximale des données brutes est de 16 Ko.
KeyPairName	String	No	testKeyPairName	Le nom de la paire de clés. Pour les instances Windows, ce paramètre est ignoré. `Password` prend effet que vous spécifiiez ou non KeyPairName. Pour les instances Linux, la méthode d'authentification par mot de passe est désactivée par défaut.
RamRoleName	String	No	testRamRoleName	Le nom du rôle Resource Access Management (RAM) de l'instance. Vous pouvez appeler l'opération ListRoles fournie par RAM pour interroger les rôles RAM d'instance que vous avez créés.
AutoReleaseTime	String	No	2018-01-01T12:05:00Z	L'heure de libération automatique de l'instance. 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 de `ss` n'est pas `00`, l'heure est automatiquement arrondie à la minute la plus proche en fonction de la valeur de `mm`. L'heure spécifiée doit être d'au moins 30 minutes postérieure à l'heure actuelle. L'heure spécifiée peut aller jusqu'à trois ans après l'heure actuelle.
SpotStrategy	String	No	NoSpot	La politique de préemption pour l'instance à paiement à l'utilisation. Ce paramètre prend effet uniquement si vous définissez `InstanceChargeType` sur `PostPaid`. Valeurs valides : NoSpot : l'instance est une instance à paiement à l'utilisation. SpotWithPriceLimit : l'instance est une instance préemptible avec un prix horaire maximum défini par l'utilisateur. SpotAsPriceGo : l'instance est une instance préemptible pour laquelle le prix du marché au moment de l'achat est automatiquement utilisé comme prix d'enchère.
SpotPriceLimit	Float	No	0.97	Le prix horaire maximum de l'instance. La valeur est précise à trois décimales. Ce paramètre prend effet uniquement si vous définissez `SpotStrategy` sur `SpotWithPriceLimit`.
SpotDuration	Integer	No	1	La période de protection de l'instance préemptible. Unité : heures. Valeur par défaut : 1. Valeurs valides : 1 : après la création d'une instance préemptible, Alibaba Cloud garantit que l'instance n'est pas libérée automatiquement dans l'heure qui suit. À la fin de la période de protection d'une heure, le système compare le prix d'enchère avec le prix du marché et vérifie l'inventaire des ressources pour déterminer s'il faut conserver ou libérer l'instance. 0 : après la création d'une instance préemptible, Alibaba Cloud ne garantit pas que l'instance fonctionnera pendant une heure. Le système compare le prix d'enchère avec le prix du marché et vérifie l'inventaire des ressources pour déterminer s'il faut conserver ou libérer l'instance. Alibaba Cloud envoie des événements système ECS pour vous notifier 5 minutes avant la libération de l'instance. Les instances préemptibles sont facturées à la seconde. Nous vous recommandons de spécifier une période de protection en fonction de vos besoins métier. Remarque Si vous définissez SpotStrategy sur SpotWithPriceLimit ou SpotAsPriceGo, ce paramètre prend effet.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	L'ID du groupe de ressources auquel l'instance, le périphérique Elastic Block Storage (EBS) et l'interface réseau élastique (ENI) appartiennent.
TemplateResourceGroupId	String	No	rg-bp67acfmxazb4p****	L'ID du groupe de ressources auquel le modèle de lancement appartient.
SecurityEnhancementStrategy	String	No	Deactive	Indique s'il faut activer le durcissement de la sécurité pour le système d'exploitation. Valeurs valides : Active : active le durcissement de la sécurité pour le système d'exploitation. Deactive : désactive le durcissement de la sécurité pour le système d'exploitation.
PrivateIpAddress	String	No	10.1..	L'adresse IP privée de l'instance. Pour attribuer une adresse IP privée à une instance résidant dans un VPC, assurez-vous que l'adresse IP est une adresse IP libre au sein du bloc CIDR du vSwitch spécifié par `VSwitchId`.
DeploymentSetId	String	No	ds-bp1brhwhoqinyjd6****	L'ID de l'ensemble de déploiement.
Ipv6AddressCount	Integer	No	1	Le nombre d'adresses IPv6 à générer de manière aléatoire pour l'interface réseau élastique (ENI) principale. Valeurs valides : 1 à 10.
DataDisk.N.PerformanceLevel	String	No	PL1	Le niveau de performance de l'ESSD N utilisé comme disque de données. La valeur de N doit être identique à celle de `DataDisk.N.Category` si vous définissez DataDisk.N.Category sur cloud_essd. Valeurs valides : PL0 : un seul ESSD peut fournir jusqu'à 10 000 IOPS de lecture/écriture aléatoires. PL1 (par défaut) : un seul ESSD peut fournir jusqu'à 50 000 IOPS de lecture/écriture aléatoires. PL2 : un seul ESSD peut fournir jusqu'à 100 000 IOPS de lecture/écriture aléatoires. PL3 : un seul ESSD peut fournir jusqu'à 1 million d'IOPS de lecture/écriture aléatoires. Pour plus d'informations sur les niveaux de performance des ESSD, consultez Disques ESSD.
DataDisk.N.Description	String	No	testDataDiskDescription	La description du disque de données N. La description doit contenir entre 2 et 256 caractères et ne doit pas commencer par `http://` ni `https://`.
DataDisk.N.SnapshotId	String	No	s-bp17441ohwka0yuh****	L'ID du snapshot que vous souhaitez utiliser pour créer le disque de données N. Valeurs valides de N : 1 à 16. Si vous spécifiez `DataDisk.N.SnapshotId`, `DataDisk.N.Size` est ignoré. Le disque de données est créé en fonction de la taille du snapshot spécifié. Remarque Utilisez des snapshots créés après le 15 juillet 2013. Sinon, une erreur est renvoyée et votre requête est rejetée.
DataDisk.N.Size	Integer	No	2000	La taille du disque de données N. Valeurs valides de N : 1 à 16. Unité : GiB. Valeurs valides : Valeurs valides si vous définissez DataDisk.N.Category sur cloud : 5 à 2 000. Valeurs valides si vous définissez DataDisk.N.Category sur cloud_efficiency : 20 à 32 768. Valeurs valides si vous définissez DataDisk.N.Category sur cloud_ssd : 20 à 32 768. Valeurs valides si vous définissez DataDisk.N.Category sur cloud_essd : varient en fonction de la valeur de `DataDisk.N.PerformanceLevel`. Valeurs valides si vous définissez DataDisk.N.PerformanceLevel sur PL0 : 40 à 32 768. Valeurs valides si vous définissez DataDisk.N.PerformanceLevel sur PL1 : 20 à 32 768. Valeurs valides si vous définissez DataDisk.N.PerformanceLevel sur PL2 : 461 à 32 768. Valeurs valides si vous définissez DataDisk.N.PerformanceLevel sur PL3 : 1 261 à 32 768. La valeur de ce paramètre doit être supérieure ou égale à la taille du snapshot spécifié par `DataDisk.N.SnapshotId`.
DataDisk.N.Device	String	No	null	Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour garantir la compatibilité future.
DataDisk.N.DiskName	String	No	testDataDiskName	Le nom du disque de données N. Le nom doit contenir entre 2 et 128 caractères. Le nom doit commencer par une lettre mais ne doit pas commencer par `http://` ni `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
DataDisk.N.Category	String	No	cloud_ssd	La catégorie du disque de données N. Valeurs valides : cloud : disque basique. cloud_efficiency : ultra-disque. cloud_ssd : SSD. cloud_essd : SSD amélioré (ESSD). 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.
DataDisk.N.DeleteWithInstance	Boolean	No	true	Indique s'il faut libérer le disque de données N lors de la libération de l'instance. Valeurs valides : true false Valeur par défaut : true.
DataDisk.N.Encrypted	String	No	false	Indique s'il faut chiffrer le disque de données N.
DataDisk.N.AutoSnapshotPolicyId	String	No	sp-m5e7fa9ute44ssa****	L'ID de la politique de snapshot automatique à appliquer au disque de données N.
DataDisk.N.ProvisionedIops	Long	No	50000	Les IOPS de lecture/écriture provisionnés du disque ESSD AutoPL. Valeurs valides : 0 à min{50 000, 1 000 × Capacité - IOPS de base}. IOPS de base = min{1 800 + 50 × Capacité, 50 000}. Remarque Ce paramètre est disponible uniquement si vous définissez SystemDisk.Category sur cloud_auto. Pour plus d'informations, consultez Disques ESSD AutoPL et Modifier les configurations de performance d'un disque ESSD AutoPL.
DataDisk.N.BurstingEnabled	Boolean	No	true	Indique s'il faut activer la fonctionnalité de burst de performance. Valeurs valides : true false
NetworkInterface.N.VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	L'ID du vSwitch auquel associer l'ENI N. Tenez compte des éléments suivants : Valeurs valides de N : 1 et 2. Si la valeur de N est 1, vous pouvez spécifier une ENI principale ou secondaire. Si la valeur de N est 2, vous devez spécifier une ENI principale et une ENI secondaire. Si vous définissez `NetworkInterface.N.InstanceType` sur `Primary`, ce paramètre est requis. Dans ce cas, ce paramètre est équivalent à `VSwitchId`. Vous ne pouvez pas spécifier NetworkInterface.N.VSwitchId et `VSwitchId` simultanément. Si vous définissez `NetworkInterface.N.InstanceType` sur `Secondary` ou laissez le paramètre vide, ce paramètre est facultatif. La valeur par défaut est l'ID du vSwitch auquel connecter l'instance.
NetworkInterface.N.NetworkInterfaceName	String	No	testEniName	Le nom de l'ENI N. Tenez compte des éléments suivants : Valeurs valides de N : 1 et 2. Si la valeur de N est 1, une ENI principale ou secondaire peut être configurée. Si la valeur de N est 2, une ENI principale et une ENI secondaire doivent être configurées. Si vous définissez `NetworkInterface.N.InstanceType` sur `Primary`, vous n'avez pas besoin de définir ce paramètre.
NetworkInterface.N.Description	String	No	testEniDescription	La description de l'ENI secondaire N. La description doit contenir entre 2 et 256 caractères et ne doit pas commencer par `http://` ni `https://`. La valeur de N dans `NetworkInterface.N` ne peut pas être supérieure à 1.
NetworkInterface.N.SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	L'ID du groupe de sécurité auquel l'ENI N appartient. Tenez compte des éléments suivants : Valeurs valides de N : 1 et 2. Si la valeur de N est 1, une ENI principale ou secondaire peut être configurée. Si la valeur de N est 2, une ENI principale et une ENI secondaire doivent être configurées. Si `NetworkInterface.N.InstanceType` est défini sur `Primary`, ce paramètre est requis. Dans ce cas, ce paramètre est équivalent à `SecurityGroupId`. Vous ne pouvez pas spécifier `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupIds.N`. Si vous définissez `NetworkInterface.N.InstanceType` sur `Secondary` ou laissez ce paramètre vide, NetworkInterface.SecurityGroupIds est facultatif. La valeur par défaut est l'ID du groupe de sécurité auquel l'instance appartient.
NetworkInterface.N.PrimaryIpAddress	String	No	192.168..	L'adresse IP principale de l'ENI N. Tenez compte des éléments suivants : Valeurs valides de N : 1 et 2. Si la valeur de N est 1, vous pouvez spécifier une ENI principale ou secondaire. Si ce paramètre est spécifié, `Amount` est défini sur une valeur numérique supérieure à 1 et NetworkInterface.N.InstanceType est défini sur Primary, le nombre spécifié d'instances est créé et des adresses IP principales consécutives commençant par celle spécifiée sont attribuées aux instances. Dans ce cas, vous ne pouvez pas lier d'ENI secondaires à ces instances. Si la valeur de N est 2, une ENI principale et une ENI secondaire doivent être configurées. Si ce paramètre est spécifié, `Amount` est défini sur une valeur numérique supérieure à 1 et NetworkInterface.N.InstanceType est défini sur Primary, vous ne pouvez pas définir `NetworkInterface.2.InstanceType` sur Secondary pour attacher une ENI secondaire. Si `NetworkInterface.N.InstanceType` est défini sur `Primary`, ce paramètre est équivalent à `PrivateIpAddress`. Vous ne pouvez pas spécifier NetworkInterface.N.PrimaryIpAddress et `PrivateIpAddress` simultanément. Si `NetworkInterface.N.InstanceType` est défini sur `Secondary` ou laissé vide, l'adresse IP principale spécifiée est attribuée à l'ENI secondaire. La valeur par défaut est une adresse IP sélectionnée de manière aléatoire au sein du bloc CIDR du vSwitch auquel associer l'ENI secondaire. Remarque Vous pouvez attacher une seule ENI secondaire lors de la création d'une instance. Une fois l'instance créée, vous pouvez appeler les opérations CreateNetworkInterface et AttachNetworkInterface pour attacher davantage d'ENI secondaires à l'instance.
NetworkInterface.N.SecurityGroupIds.N	String	No	sg-bp67acfmxazb4p****	L'ID du groupe de sécurité N auquel attribuer l'ENI N. Valeurs valides du premier N : 1 et 2. Si la valeur du premier N est 1, vous pouvez configurer une ENI principale ou secondaire. Si la valeur du premier N est 2, vous devez configurer une ENI principale et une ENI secondaire. Le deuxième N indique qu'un ou plusieurs ID de groupe de sécurité peuvent être spécifiés. Les valeurs valides du deuxième N varient en fonction du nombre maximal de groupes de sécurité auxquels une instance peut appartenir. Pour plus d'informations, consultez la section « Limites des groupes de sécurité » dans Limites. Tenez compte des éléments suivants : Si `NetworkInterface.N.InstanceType` est défini sur `Primary`, ce paramètre ou `NetworkInterface.N.SecurityGroupId` est requis. Dans ce cas, ce paramètre est équivalent à `SecurityGroupIds.N`. Vous ne pouvez pas spécifier `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupId`. Si vous définissez `NetworkInterface.N.InstanceType` sur `Secondary` ou laissez ce paramètre vide, NetworkInterface.SecurityGroupIds est facultatif. La valeur par défaut est l'ID du groupe de sécurité auquel l'instance appartient.
NetworkInterface.N.InstanceType	String	No	Secondary	Le type de l'ENI N. Valeurs valides de N : 1 et 2. Si la valeur de N est 1, vous pouvez spécifier une ENI principale ou secondaire. Si la valeur de N est 2, vous devez spécifier une ENI principale et une ENI secondaire. Valeurs valides : Primary Secondary Valeur par défaut : Secondary.
NetworkInterface.N.NetworkInterfaceTrafficMode	String	No	Standard	Le mode de communication de l'ENI principale. Valeurs valides : Standard : utilise le mode de communication TCP. HighPerformance : active l'interface RDMA élastique (ERI) et utilise le mode de communication RDMA (Remote Direct Memory Access).
Tag.N.Key	String	No	TestKey	La clé du tag N que vous souhaitez ajouter à l'instance, au périphérique EBS ou à l'ENI. Valeurs valides de N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. La clé du tag peut contenir jusqu'à 64 caractères et ne doit pas commencer par `acs:` ni `aliyun`. La clé du tag ne doit pas contenir `http://` ni `https://`.
Tag.N.Value	String	No	TestValue	La valeur du tag N que vous souhaitez ajouter à l'instance, au périphérique EBS ou à l'ENI. Valeurs valides de N : 1 à 20. La valeur du tag peut être une chaîne vide. La valeur du tag peut contenir jusqu'à 128 caractères et ne doit pas commencer par acs: ni aliyun. La valeur du tag ne doit pas contenir http:// ni https://.
SecurityGroupIds.N	String	No	sg-bp15ed6xe1yxeycg7****	L'ID du groupe de sécurité N auquel l'instance appartient. Les valeurs valides de N varient en fonction du nombre maximal de groupes de sécurité auxquels une instance peut appartenir. Pour plus d'informations, consultez la section « Limites des groupes de sécurité » dans Limites. Remarque Vous ne pouvez pas spécifier `SecurityGroupId` et `SecurityGroupIds.N` simultanément.
SystemDisk.Encrypted	String	No	false	Indique s'il faut chiffrer le disque système. Valeurs valides : true false Valeur par défaut : false. Remarque Si vous créez des instances dans la zone D de Hong Kong ou la zone A de Singapour, vous ne pouvez pas chiffrer les disques système.
DeletionProtection	Boolean	No	false	Indique s'il faut activer la protection contre la suppression pour l'instance. Ce paramètre détermine si vous pouvez utiliser la console ECS ou appeler l'opération DeleteInstance pour libérer l'instance. Valeurs valides : true false Valeur par défaut : false. Remarque Ce paramètre s'applique uniquement aux instances à paiement à l'utilisation. Il peut protéger les instances contre les suppressions manuelles, mais pas contre les suppressions automatiques.
CreditSpecification	String	No	Standard	Le mode de performance de l'instance éclatable. Valeurs valides : Standard : mode standard. Pour plus d'informations, consultez la section « Mode standard » dans Instances éclatables. Unlimited : mode illimité. Pour plus d'informations, consultez la section « Mode illimité » dans Instances éclatables.

Paramètres de réponse

Parameter	Type	Example	Description
LaunchTemplateId	String	lt-m5eiaupmvm2op9d****	L'ID du modèle de lancement.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	L'ID de la requête.
LaunchTemplateVersionNumber	Long	2	Le numéro de version du modèle de lancement.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=CreateLaunchTemplate
&LaunchTemplateName=testLaunchTemplateName
&RegionId=cn-hangzhou
&TemplateTag.1.Key=TestKey
&TemplateTag.1.Value=TestValue
&VersionDescription=testVersionDescription
&ImageId=win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
&InstanceType=ecs.g5.large
&SecurityGroupId=sg-bp15ed6xe1yxeycg****
&VpcId=vpc-bp12433upq1y5scen****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&InstanceName=testInstanceName
&Description=testECSDescription
&InternetMaxBandwidthIn=10
&InternetMaxBandwidthOut=10
&HostName=testHostName
&ZoneId=cn-hangzhou-g
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=40
&SystemDisk.DiskName=testSystemDiskName
&SystemDisk.Description=TestDisk
&DataDisk.1.Size=2000
&DataDisk.1.SnapshotId=s-bp17441ohwka0yuh****
&DataDisk.1.Category=cloud_ssd
&DataDisk.1.Encrypted=false
&DataDisk.1.DiskName=testDataDiskName
&DataDisk.1.Description=testDataDiskDescription
&DataDisk.1.DeleteWithInstance=true
&IoOptimized=optimized
&NetworkInterface.1.PrimaryIpAddress=192.168.**.**
&NetworkInterface.1.VSwitchId=vsw-bp1s5fnvk4gn2tws0****
&NetworkInterface.1.SecurityGroupId=sg-bp15ed6xe1yxeycg****
&NetworkInterface.1.NetworkInterfaceName=testEniName
&NetworkInterface.1.Description=testEniDescription
&PrivateIpAddress=10.1.**.**
&InstanceChargeType=PrePaid
&Period=1
&InternetChargeType=PayByTraffic
&NetworkType=vpc
&UserData=ZWNobyBoZWxsbyBlY3Mh
&RamRoleName=testRamRoleName
&AutoReleaseTime=2018-01-01T12:05:00Z
&SpotStrategy=NoSpot
&SpotPriceLimit=0.97
&SecurityEnhancementStrategy=Deactive
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<CreateLaunchTemplateResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <LaunchTemplateId>lt-m5eiaupmvm2op9d****</LaunchTemplateId>
    <LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
</CreateLaunchTemplateResponse>

Format JSON

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

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

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidRegion.NotExist	%s	The specified region does not exist.
400	MissingParameter	%s	A required parameter is not specified.
400	InvalidParameter	%s	Invalid parameter value.
400	InvalidLaunchTemplateName.Malformed	The specified parameter LaunchTemplateName is not valid.	Invalid LaunchTemplateName value.
400	InvalidUserData.SizeExceeded	%s	The maximum user data size is exceeded.
400	InvalidUserData.Base64FormatInvalid	%s	Invalid UserData format.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The tag key already exists. Tag keys must be unique.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Invalid Tag.N.Key value.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Invalid Tag.N.Value value.
403	LaunchTemplateLimitExceed	%s	The maximum number of launch templates has been exceeded.
403	LaunchTemplateName.Duplicated	%s	The specified launch template name already exists.
403	QuotaExceed.Tags	%s	The maximum number of tags has been exceeded. %s is a variable. An error message is dynamically returned based on the call conditions.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The resource group ID does not exist.
500	InternalError	The request processing has failed due to some unknown error.	An internal error occurred. Try again later.

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