Tous les produits
Search
Centre de documentation

Elastic Compute Service:CreateLaunchTemplate

Dernière mise à jour :Sep 17, 2026

Crée un modèle de lancement d'instance ECS. Un modèle de lancement élimine le besoin de configurer un grand nombre de paramètres à chaque création d'instance.

Description de l'opération

Après avoir appelé CreateLaunchTemplate pour créer un modèle, une version par défaut avec le numéro de version 1 est automatiquement générée. Vous pouvez ensuite créer plusieurs versions basées sur ce modèle (CreateLaunchTemplateVersion), avec des numéros de version s'incrémentant séquentiellement à partir de 1. Si vous ne spécifiez pas de version de modèle lors de la création d'instances (RunInstances), la version par défaut est utilisée.

Une version de modèle de lancement contient les configurations utilisées pour créer des instances, telles que la région, l'identifiant de l'image, le type d'instance, l'identifiant du groupe de sécurité et la bande passante publique. Si une configuration d'instance spécifique n'est pas spécifiée dans la version, vous devez la spécifier lors de la création des instances.

Lorsque vous appelez cette opération, prenez note des éléments suivants :

  • Chaque compte peut créer jusqu'à 30 modèles de lancement par région, et chaque modèle peut comporter jusqu'à 30 versions.

  • La plupart des paramètres d'un modèle de lancement sont facultatifs. Lorsque vous créez un modèle, Alibaba Cloud ne vérifie pas l'existence ou la validité des valeurs des paramètres. La validité des valeurs des paramètres n'est vérifiée que lorsque vous créez réellement des instances.

  • Si une configuration spécifique est définie dans le modèle de lancement, elle ne peut pas être filtrée lorsque vous créez des instances (RunInstances). Par exemple, si le modèle définit HostName=LocalHost et que la valeur HostName est laissée vide dans RunInstances, le nom d'hôte de l'instance reste LocalHost. Pour remplacer la configuration HostName=LocalHost, définissez HostName=MyHost ou une autre valeur dans RunInstances.

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

create

*LaunchTemplate

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

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 obtenir la liste des régions la plus récente.

cn-hangzhou

TemplateTag

array<object>

Non

Les informations de balise du modèle de lancement lui-même.

Remarque

Actuellement, vous pouvez créer et interroger des balises pour les modèles de lancement uniquement en appelant des opérations d'API. Vous ne pouvez pas créer ou afficher ces balises dans la console.

object

Non

Les paires clé-valeur de balise du modèle de lancement lui-même.

Key

string

Non

La clé de balise du modèle de lancement. Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. La clé de balise ne peut pas contenir http:// ou https://.

TestKey

Value

string

Non

La valeur de balise du modèle de lancement. Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. La valeur de balise ne peut pas contenir http:// ou https://.

TestValue

RegionId

string

Oui

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://. Le nom peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

testLaunchTemplateName

LaunchTemplateName

string

Oui

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

VersionDescription

string

Non

L'identifiant de l'image. Vous pouvez appeler DescribeImages pour interroger les ressources d'images disponibles.

win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd

ImageId

string

Non

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 fournies par Alibaba Cloud Marketplace. Vous pouvez utiliser les images d'Alibaba Cloud Marketplace directement sans vous y abonner au préalable. Vérifiez vous-même les détails de facturation des images d'Alibaba Cloud Marketplace.

system

ImageOwnerAlias

string

Non

Indique si le mot de passe prédéfini de l'image doit être utilisé.

Remarque

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

false

PasswordInherit

boolean

Non

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

ecs.g5.large

InstanceType

string

Non

L'identifiant du groupe de sécurité auquel la nouvelle instance appartient. Les instances d'un même groupe de sécurité peuvent communiquer entre elles. Un groupe de sécurité peut contenir jusqu'à 1 000 instances.

Remarque

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

sg-bp15ed6xe1yxeycg****

SecurityGroupId

string

Non

L'identifiant du cloud privé virtuel (VPC).

vpc-bp12433upq1y5scen****

VpcId

string

Non

L'identifiant du vSwitch. Ce paramètre est requis lorsque vous créez une instance connectée à un VPC.

vsw-bp1s5fnvk4gn2tws0****

VSwitchId

string

Non

Le nom de l'instance. Le nom doit comporter de 2 à 128 caractères et peut contenir des caractères de la catégorie des lettres Unicode (y compris des lettres en anglais, en chinois et des chiffres). 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, vous pouvez définir des noms d'instance séquentiels contenant des crochets ([]) et des virgules (,). Pour plus d'informations, consultez Batch configure sequential names or hostnames for multiple instances.

k8s-node-[1,4]-alibabacloud

InstanceName

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://.

testECSDescription

Description

string

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.

10

InternetMaxBandwidthIn

integer

Non

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

10

InternetMaxBandwidthOut

integer

Non

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

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

  • Pour les instances Windows : le nom d'hôte doit comporter de 2 à 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 (-).

  • Pour les autres instances telles que Linux : le nom d'hôte doit comporter de 2 à 64 caractères. Vous pouvez utiliser des points (.) pour séparer le nom d'hôte en plusieurs segments. Chaque segment peut contenir des lettres, des chiffres et des traits d'union (-).

testHostName

HostName

string

Non

L'identifiant de la zone de l'instance.

cn-hangzhou-g

ZoneId

string

Non

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

  • cloud : disque de base.

  • cloud_efficiency : disque ultra.

  • cloud_ssd : SSD standard.

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

  • cloud_auto : disque ESSD AutoPL.

  • cloud_essd_entry : disque ESSD Entry.

Pour les types d'instances retirés 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.Category

string

Non

La taille du disque système. Unité : Gio. Valeurs valides :

  • cloud : 20 à 500.

  • Autres catégories de disques : 20 à 2048.

La valeur de ce paramètre doit être supérieure ou égale à max{20, ImageSize}.

40

SystemDisk.Size

integer

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://. Le nom peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

testSystemDiskName

SystemDisk.DiskName

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.Description

string

Non

Remarque

Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.

null

SystemDisk.Iops

integer

Non

Le niveau de performance de l'ESSD utilisé comme disque système. Paramètres du niveau de performance du disque. Valeurs valides :

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

  • PL1 : un seul disque peut fournir jusqu'à 50 000 IOPS de lecture/écriture aléatoires.

  • PL2 : un seul disque peut fournir jusqu'à 100 000 IOPS de lecture/écriture aléatoires.

  • PL3 : un seul disque peut fournir jusqu'à 1 000 000 IOPS de lecture/écriture aléatoires.

Pour plus d'informations sur la façon de sélectionner les niveaux de performance des ESSD, consultez Enterprise SSDs.

PL0

SystemDisk.PerformanceLevel

string

Non

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

  • true : le disque système est libéré en même temps que l'instance.

  • false : le disque système n'est pas libéré en même temps que l'instance.

Valeur par défaut : true.

true

SystemDisk.DeleteWithInstance

boolean

Non

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

sp-gc7c37d4ylw7mtnk****

SystemDisk.AutoSnapshotPolicyId

string

Non

Les IOPS de lecture/écriture provisionnés du disque ESSD AutoPL. Valeurs valides : 0 à min{50000, 1000 × Capacity - Baseline performance}.

Baseline performance = min{1,800 + 50 × Capacity, 50,000}

Remarque

Ce paramètre n'est disponible que lorsque DiskCategory est défini sur cloud_auto. Pour plus d'informations, consultez ESSD AutoPL disks et Modify the provisioned performance of an ESSD AutoPL disk.

50000

SystemDisk.ProvisionedIops

integer

Non

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

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

  • false : désactive la fonctionnalité de burst de performance.

true

SystemDisk.BurstingEnabled

boolean

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

IoOptimized

string

Non

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

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

  • PostPaid : paiement à l'usage.

PrePaid

InstanceChargeType

string

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

Period

integer

Non

Le mode de facturation pour l'utilisation du réseau. Valeurs valides :

  • PayByBandwidth : paiement par bande passante.

  • PayByTraffic : paiement par trafic.

Remarque

En mode paiement par trafic, les bandes passantes entrantes et sortantes de crête sont utilisées comme limites supérieures de bande passante au lieu de spécifications de performance garanties. Lorsque la contention des ressources se produit, ces bandes passantes de crête peuvent être limitées. Si vous souhaitez des bandes passantes garanties pour votre activité, utilisez le mode de facturation paiement par bande passante.

PayByTraffic

InternetChargeType

string

Non

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

Remarque

Ce paramètre sera obsolète. Utilisez d'autres paramètres pour une meilleure compatibilité.

false

EnableVmOsConfig

boolean

Non

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

  • classic : réseau classique. Cette fonctionnalité a été retirée. Pour plus d'informations, consultez Retirement notice.

  • vpc : VPC.

vpc

NetworkType

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.

ZWNobyBoZWxsbyBlY3Mh

UserData

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 méthode de connexion par mot de passe est désactivée lors de l'initialisation.

testKeyPairName

KeyPairName

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

RamRoleName

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 à l'inférieur au début de la minute en cours (mm).

  • L'heure de libération la plus proche doit être d'au moins une demi-heure à partir de l'heure actuelle.

  • L'heure de libération la plus éloignée ne peut pas dépasser trois ans à partir de l'heure actuelle.

2018-01-01T12:05:00Z

AutoReleaseTime

string

Non

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

  • NoSpot : l'instance est une instance à paiement à l'usage 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 d'offre.

NoSpot

SpotStrategy

string

Non

Le prix horaire maximum de l'instance. Ce paramètre prend en charge jusqu'à trois décimales et prend effet lorsque SpotStrategy est défini sur SpotWithPriceLimit.

0.97

SpotPriceLimit

number

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 un délai d'une heure. Une fois la période de protection d'une heure terminée, le système compare le prix d'offre 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 d'offre 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. Sélectionnez 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 lorsque SpotStrategy est défini sur SpotWithPriceLimit ou SpotAsPriceGo.

1

SpotDuration

integer

Non

L'identifiant du groupe de ressources d'entreprise auquel l'instance, le stockage par blocs et la carte d'interface réseau (NIC) appartiennent.

rg-bp67acfmxazb4p****

ResourceGroupId

string

Non

L'identifiant du groupe de ressources d'entreprise auquel le modèle de lancement appartient.

rg-bp67acfmxazb4p****

TemplateResourceGroupId

string

Non

Indique si le renforcement de la sécurité du système d'exploitation doit être activé. Valeurs valides :

  • Active : active le renforcement de la sécurité. Cette valeur s'applique uniquement aux images publiques.

  • Deactive : désactive le renforcement de la sécurité. Cette valeur s'applique à tous les types d'images.

Deactive

SecurityEnhancementStrategy

string

Non

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

Pour attribuer une adresse IP privée à une instance ECS connectée à un VPC, sélectionnez une adresse IP disponible dans le bloc CIDR du vSwitch (VSwitchId).

10.1.**.**

PrivateIpAddress

string

Non

L'identifiant du jeu de déploiement.

ds-bp1brhwhoqinyjd6****

DeploymentSetId

string

Non

Le nombre d'adresses IPv6 générées aléatoirement à attribuer à l'ENI principale. Valeurs valides : 1 à 10.

1

Ipv6AddressCount

integer

Non

La liste des configurations de disque de données.

1

DataDisk

array<object>

Non

Les informations de l'interface réseau élastique (ENI).

object

Non

Les informations de l'interface réseau élastique (ENI).

PerformanceLevel

string

Non

The performance level of the enterprise SSD used as a data disk. The value of N must be the same as that in DataDisk.N.Category=cloud_essd. Valid values:

  • PL0: a single disk can deliver up to 10,000 random read/write IOPS.

  • PL1 (default): a single disk can deliver up to 50,000 random read/write IOPS.

  • PL2: a single disk can deliver up to 100,000 random read/write IOPS.

  • PL3: a single disk can deliver up to 1,000,000 random read/write IOPS.

For information about how to select an ESSD performance level, see ESSDs.

PL1

Description

string

Non

La description de l'interface réseau élastique (ENI) secondaire. La description doit comporter entre 2 et 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.

testEniDescription

SnapshotId

string

Non

The snapshot ID used to create data disk N. Valid values of N: 1 to 16. After you specify DataDisk.N.SnapshotId, the DataDisk.N.Size parameter is ignored. The actual size of the created disk is the size of the specified snapshot.

Remarque

Snapshots created on or before July 15, 2013 cannot be used. Requests that use such snapshots are rejected.

s-bp17441ohwka0yuh****

Size

integer

Non

The size of data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:

  • cloud: 5 to 2000.

  • cloud_efficiency: 20 to 32768.

  • cloud_ssd: 20 to 32768.

  • cloud_essd: The valid value range depends on the value of DataDisk.N.PerformanceLevel.
    • PL0: 1 to 32768.

    • PL1: 20 to 32768.

    • PL2: 461 to 32768.

    • PL3: 1261 to 32768.

  • cloud_auto: 1 to 32,768.

  • cloud_essd_entry: 10 to 32,768.

The value of this parameter must be greater than or equal to the size of the snapshot specified by SnapshotId.

2000

Device

string

Non

The mount point of the data disk. The naming convention varies based on the number of data disks attached:

  • 1 to 25 data disks: /dev/xvd[b-z]

  • More than 25 data disks: /dev/xvd[aa-zz]. For example, the 26th data disk is named /dev/xvdaa, the 27th data disk is named /dev/xvdab, and so on.

Remarque

This parameter is intended only for full image (system image) scenarios. You can set this parameter to the mount point of a data disk in the full image and modify the corresponding DataDisk.N.Size and DataDisk.N.Category parameters to change the disk category and size of the data disk in the full image.

/dev/xvdb

DiskName

string

Non

The name of the data disk. The name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).

testDataDiskName

Category

string

Non

The category of data disk N. Valid values:

  • cloud_efficiency: ultra disk.

  • cloud_ssd: standard SSD.

  • cloud_essd: enterprise SSD.

  • cloud: basic disk.

  • cloud_auto: ESSD AutoPL disk.

  • cloud_regional_disk_auto: regional ESSD.

  • cloud_essd_entry: ESSD Entry disk.
    Remarque

    The cloud_essd_entry value is supported only when InstanceType is set to an instance type in the ecs.u1 or ecs.e family.

  • elastic_ephemeral_disk_standard: elastic ephemeral disk - Standard.

  • elastic_ephemeral_disk_premium: elastic ephemeral disk - Premium Edition.

For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud. Default value details:

  • If InstanceType is set to a retired instance type that is not I/O optimized, the default parameter value is cloud.

  • In other cases, the default value is cloud_efficiency.

cloud_ssd

DeleteWithInstance

boolean

Non

Specifies whether the data disk is released when the instance is released. Valid values:

  • true: The data disk is released together with the instance.

  • false: The data disk is not released together with the instance.

Default value: true.

true

Encrypted

string

Non

Specifies whether the data disk is encrypted.

false

AutoSnapshotPolicyId

string

Non

The ID of the automatic snapshot policy applied to the data disk.

sp-m5e7fa9ute44ssa****

ProvisionedIops

integer

Non

The provisioned read/write IOPS of the ESSD AutoPL disk. Valid values: 0 to min{50000, 1000 × Capacity - Baseline Performance}.

Baseline Performance = min{1,800 + 50 × Capacity, 50,000}

Remarque

This parameter is supported only when DiskCategory is set to cloud_auto. For more information, see ESSD AutoPL disks and Modify the provisioned performance of an ESSD AutoPL disk.

50000

BurstingEnabled

boolean

Non

Specifies whether to enable the performance burst feature. Valid values:

  • true: Enabled.

  • false: Disabled.

true

KMSKeyId

string

Non

The KMS key ID for the data disk.

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

NetworkInterface

array<object>

Non

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

Scénarios

Après avoir appelé l'opération CreateLaunchTemplate pour créer un modèle, la version par défaut générée automatiquement est utilisée pour créer des instances. Ces balises sont appliquées aux instances, aux disques et aux ENI principales.

object

Non

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

VSwitchId

string

Non

The vSwitch ID of the network interface controller (NIC).

Note the following items:

  • Valid values of N: 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

  • If NetworkInterface.N.InstanceType is set to Primary, this parameter is required. This parameter has the same effect as VSwitchId, but you cannot specify both this parameter and VSwitchId.

  • If NetworkInterface.N.InstanceType is set to Secondary or left empty, this parameter is optional. Default value: the vSwitch of the ECS instance.

vsw-bp1s5fnvk4gn2tws0****

NetworkInterfaceName

string

Non

The name of the network interface controller (NIC).

Note the following items:

  • Valid values of N: 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

  • If NetworkInterface.N.InstanceType is set to Primary, you do not need to set this parameter.

testEniName

Description

string

Non

The description of the secondary network interface controller (NIC). The description must be 2 to 256 characters in length and cannot start with http:// or https://. The value of N in NetworkInterface.N cannot be greater than 1.

testEniDescription

SecurityGroupId

string

Non

The security group ID of the network interface controller (NIC).

Note the following items:

  • Valid values of N: 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

  • If NetworkInterface.N.InstanceType is set to Primary, this parameter is required. This parameter has the same effect as SecurityGroupId, but you cannot specify SecurityGroupId, SecurityGroupIds.N, or NetworkInterface.N.SecurityGroupIds.N at the same time.

  • If NetworkInterface.N.InstanceType is set to Secondary or left empty, this parameter is optional. Default value: the security group of the ECS instance.

sg-bp15ed6xe1yxeycg****

PrimaryIpAddress

string

Non

Adds a network interface controller (NIC) and sets the primary IP address.

Note the following items:

  • Valid values of N: 1 to 2.

    • If you set 1 NIC, you can set either a primary or secondary NIC. If Amount is greater than 1 and you set a primary NIC with this parameter specified, the specified primary IP address is used as the starting address to sequentially allocate consecutive primary IP addresses to multiple ECS instances in batch. In this case, you cannot attach a secondary NIC to the instance.

    • If you set 2 NICs, you must set one primary NIC and one secondary NIC. If Amount is greater than 1 and this parameter is set for the primary NIC, you cannot set a secondary NIC (that is, you cannot set NetworkInterface.2.InstanceType=Secondary).

  • If NetworkInterface.N.InstanceType is set to Primary, this parameter has the same effect as PrivateIpAddress, but you cannot specify both this parameter and PrivateIpAddress.

  • If NetworkInterface.N.InstanceType is set to Secondary or left empty, this parameter sets the primary IP address for the secondary NIC. By default, an IP address is randomly selected from the vSwitch CIDR block to which the NIC belongs.

Remarque

When you invoke the CreateLaunchTemplate operation, you can attach up to one secondary NIC. After the instance is created, you can call CreateNetworkInterface and AttachNetworkInterface to attach more secondary NICs.

192.168.**.**

SecurityGroupIds

array

Non

The IDs of one or more security groups to which the network interface controller (NIC) belongs.

  • The first N has a valid value range of 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

  • The second N indicates that you can specify one or more security group IDs. The valid value range of N depends on the maximum number of security groups to which an instance can belong. For more information, see Security group limits.

Note the following items:

  • If NetworkInterface.N.InstanceType is set to Primary, you must set this parameter or NetworkInterface.N.SecurityGroupId. This parameter has the same effect as SecurityGroupIds.N, but you cannot specify SecurityGroupId, SecurityGroupIds.N, or NetworkInterface.N.SecurityGroupId at the same time.

  • If NetworkInterface.N.InstanceType is set to Secondary or left empty, this parameter is optional. Default value: the security group of the ECS instance.

sg-bp67acfmxazb4p****

string

Non

The IDs of one or more security groups to which the network interface controller (NIC) belongs.

  • The first N has a valid value range of 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

  • The second N indicates that you can specify one or more security group IDs. The valid value range of N depends on the maximum number of security groups to which an instance can belong. For more information, see Security group limits.

Note the following items:

  • If NetworkInterface.N.InstanceType is set to Primary, you must set this parameter or NetworkInterface.N.SecurityGroupId. This parameter has the same effect as SecurityGroupIds.N, but you cannot specify SecurityGroupId, SecurityGroupIds.N, or NetworkInterface.N.SecurityGroupId at the same time.

  • If NetworkInterface.N.InstanceType is set to Secondary or left empty, this parameter is optional. Default value: the security group of the ECS instance.

sg-bp67acfmxazb4p****

InstanceType

string

Non

The type of the network interface controller (NIC). Valid values of N: 1 to 2. If you set 1 NIC, you can set either a primary or secondary NIC. If you set 2 NICs, you must set one primary NIC and one secondary NIC.

Valid values:

  • Primary: primary NIC.

  • Secondary: secondary NIC.

Default value: Secondary.

Secondary

NetworkInterfaceTrafficMode

string

Non

The communication mode of the primary ENI. Valid values:

  • Standard: uses the TCP communication mode.

  • HighPerformance: enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode.

Standard

DeleteOnRelease

boolean

Non

Specifies whether to retain the ENI when the instance is released. Valid values:

  • true: The ENI is not retained.

  • false: The ENI is retained.

Default value: true.

Remarque

This parameter takes effect only for secondary ENIs.

true

Tag

array<object>

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****

object

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****

Key

string

Non

The tag key for instances, disks, and primary ENIs created from this template version. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with aliyun or acs:. The tag key cannot contain http:// or https://.

TestKey

Value

string

Non

The tag value for instances, disks, and primary ENIs created from this template version. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain http:// or https://.

TestValue

SecurityGroupIds

array

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

La zone D à Hong Kong (Chine) et la zone A à Singapour ne prennent pas en charge le chiffrement du disque système lors de la création d'une instance.

false

string

Non

The IDs of one or more security groups to which the instance belongs. The valid value range of N depends on the maximum number of security groups to which an instance can belong. For more information, see Limits.

Remarque

You cannot specify both SecurityGroupId and SecurityGroupIds.N.

sg-bp15ed6xe1yxeycg7****

SystemDisk.Encrypted

string

Non

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

  • true : active la protection contre la libération pour l'instance.

  • false : désactive la protection contre la libération pour l'instance.

Valeur par défaut : false.

Remarque

Cet attribut s'applique uniquement aux instances à l'usage. Il ne peut empêcher que les opérations de libération manuelles, et non les opérations de libération initiées par le système.

false

DeletionProtection

boolean

Non

Le mode d'exécution de l'instance extensible. Valeurs valides :

Standard

CreditSpecification

string

Non

Indique si le renouvellement automatique doit être activé. Valeurs valides :

  • true : active le renouvellement automatique.

  • false : n'active pas le renouvellement automatique.

Valeur par défaut : false.

Remarque

Ce paramètre prend effet uniquement lorsque InstanceChargeType est défini sur PrePaid.

true

AutoRenew

boolean

Non

La période de renouvellement automatique pour un seul renouvellement. 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

AutoRenewPeriod

integer

Non

L'unité de la période d'abonnement. Valeurs valides :

Month (par défaut).

Month

PeriodUnit

string

Non

Indique si le canal d'accès aux métadonnées de l'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.

enabled

HttpEndpoint

string

Non

Indique si le mode renforcé en matière de sécurité (IMDSv2) doit être utilisé de manière forcée pour accéder aux métadonnées de l'instance. Valeurs valides :

  • optional : n'utilise pas de manière forcée le mode renforcé en matière de sécurité.

  • required : utilise de manière forcée le mode renforcé en matière de sécurité. Après avoir défini ce paramètre sur required, vous ne pouvez pas accéder aux métadonnées de l'instance en mode normal.

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.

optional

HttpTokens

string

Non

Remarque

Ce paramètre n'est pas disponible.

3

HttpPutResponseHopLimit

integer

Non

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

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

SystemDisk.KMSKeyId

string

Non

Les informations de propriété liées à l'image.

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

ImageOptions

object

Non

Les options de sécurité.

LoginAsNonRoot

boolean

Non

Specifies whether instances that use this image support logon with the ecs-user account. Valid values:

  • true: Supported.

  • false: Not supported.

false

SecurityOptions

object

Non

The security options.

TrustedSystemMode

string

Non

The trusted system mode. Set the value to vTPM.

The following instance families support trusted system mode:

  • g7, c7, and r7.

  • Enhanced instance families (g7t, c7t, and r7t).

When you create ECS instances of the preceding instance types, you must set this parameter. Take note of the following items:

  • If you use the Alibaba Cloud Trusted System, set this parameter to vTPM. The Alibaba Cloud Trusted System performs trusted verification when the instance starts.

  • If you do not use the Alibaba Cloud Trusted System, you do not need to set this parameter. However, if the ECS instance that you create uses the Enclave-based confidential computing mode (SecurityOptions.ConfidentialComputingMode=Enclave), the trusted system is also enabled for the instance.

  • When you use an OpenAPI operation to create a trusted ECS instance, you can invoke only RunInstances. CreateInstance does not support the SecurityOptions.TrustedSystemMode parameter.

Remarque

If you specify the instance as a trusted instance during creation, you can replace the system disk only with an image that supports the trusted system.

For more information about the trusted system, see Overview of trusted features for security-enhanced instances.

vTPM

EnableSecureBoot

boolean

Non

Éléments de réponse

Élément

Type

Description

Exemple

object

LaunchTemplateId

string

L'identifiant du modèle de lancement.

lt-m5eiaupmvm2op9d****

RequestId

string

L'identifiant de la requête.

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

LaunchTemplateVersionNumber

integer

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

20

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidRegion.NotExist %s
400 MissingParameter %s
400 InvalidParameter %s
400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid.
400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
400 InvalidUserData.SizeExceeded %s
400 InvalidUserData.Base64FormatInvalid %s
400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
400 InvalidParams.CreateEniParams %s
500 InternalError The request processing has failed due to some unknown error.
403 LaunchTemplateLimitExceed %s
403 LaunchTemplateName.Duplicated %s
403 QuotaExceed.Tags %s
403 InvalidOperation.InstanceTypeSecureBootUnsupported The instance type does not support secure boot.
403 InvalidOperation.SecureBootRegionNotSupported Secure Boot is not available in the specified region.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.