Crée une version pour un modèle de lancement.
Notes d'utilisation
Pour modifier les paramètres d'une version de modèle de lancement, créez une nouvelle version avec des paramètres différents. Chaque modèle de lancement peut comporter jusqu'à 30 versions.
Débogage
Paramètres de requête
|
Parameter |
Type |
Required |
Example |
Description |
| Action | String | Yes | CreateLaunchTemplateVersion |
L'opération à effectuer. Définissez la valeur sur CreateLaunchTemplateVersion. |
| RegionId | String | Yes | cn-hangzhou |
ID de région du modèle de lancement. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente. |
| LaunchTemplateId | String | No | lt-m5eiaupmvm2op9d**** |
ID du modèle de lancement. Pour plus d'informations, appelez l'opération DescribeLaunchTemplates. Spécifiez |
| LaunchTemplateName | String | No | testLaunchTemplateName |
Nom du modèle de lancement. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par |
| VersionDescription | String | No | testVersionDescription |
Description de la version du modèle de lancement. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par |
| ImageId | String | No | win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd |
ID de l'image à utiliser pour créer des instances Elastic Compute Service (ECS). Appelez l'opération DescribeImages pour obtenir la liste des images disponibles. |
| ImageOwnerAlias | String | No | system |
Source de l'image. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour garantir la compatibilité future. |
| PasswordInherit | Boolean | No | false |
Indique s'il faut utiliser le mot de passe prédéfini dans l'image. Valeurs possibles :
Valeur par défaut : false. Remarque Si PasswordInherit est spécifié, laissez Password vide et assurez-vous que l'image sélectionnée comporte un mot de passe prédéfini. |
| InstanceType | String | No | ecs.g5.large |
Type d'instance. Pour plus d'informations, consultez la Présentation des familles d'instances ou appelez l'opération DescribeInstanceTypes pour obtenir la liste des types d'instances la plus récente. |
| SecurityGroupId | String | No | sg-bp15ed6xe1yxeycg**** |
ID du groupe de sécurité auquel attribuer l'instance. Les instances appartenant au même groupe de sécurité peuvent communiquer entre elles. Remarque Vous ne pouvez pas spécifier à la fois SecurityGroupId et SecurityGroupIds.N. |
| VpcId | String | No | vpc-bp12433upq1y5scen**** |
ID du réseau privé virtuel (VPC). |
| VSwitchId | String | No | vsw-bp1s5fnvk4gn2tws0**** |
ID du vSwitch auquel connecter l'instance. Ce paramètre est requis si vous spécifiez VpcId. |
| InstanceName | String | No | testInstanceName |
Nom de l'instance. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par |
| Description | String | No | testDescription |
Description de l'instance. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par |
| InternetMaxBandwidthIn | Integer | No | 50 |
Bande passante publique entrante maximale. Unité : Mbit/s. Valeurs possibles :
|
| InternetMaxBandwidthOut | Integer | No | 5 |
Bande passante publique sortante maximale. Unité : Mbit/s. Valeurs possibles : 0 à 100. |
| HostName | String | No | testHostName |
Nom d'hôte de l'instance.
|
| ZoneId | String | No | cn-hangzhou-g |
ID de la zone dans laquelle créer l'instance. |
| SystemDisk.Category | String | No | cloud_ssd |
Catégorie du disque système. Valeurs possibles :
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 instances d'autres types, la valeur par défaut est cloud_efficiency. |
| SystemDisk.Size | Integer | No | 40 |
Taille du disque système. Unité : GiB. Valeurs possibles : 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 | cloud_ssdSystem |
Nom du disque système. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par |
| SystemDisk.Description | String | No | testSystemDiskDescription |
Description du disque système. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par |
| SystemDisk.Iops | Integer | No | 30000 |
Remarque Ce paramètre n'est pas disponible publiquement. |
| SystemDisk.PerformanceLevel | String | No | PL0 |
Niveau de performance du disque ESSD à utiliser comme disque système. Valeurs possibles :
Pour plus d'informations sur les niveaux de performance des disques ESSD, consultez la rubrique 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 possibles :
Valeur par défaut : true. |
| SystemDisk.AutoSnapshotPolicyId | String | No | sp-bp1dgzpaxwc4load**** |
ID de la politique de snapshot automatique à appliquer au disque système. |
| SystemDisk.ProvisionedIops | Long | No | 50000 |
IOPS en lecture/écriture provisionnés du disque ESSD AutoPL à utiliser comme disque de données N. Valeurs possibles : 0 à min{50 000, 1 000 × Capacité - Performances de base} Performances de base = min{1 800 + 50 × Capacité, 50 000} Remarque Ce paramètre est disponible uniquement si le paramètre DataDisk.N.Category est défini sur cloud_auto. Pour plus d'informations, consultez les rubriques 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 possibles :
|
| IoOptimized | String | No | optimized |
Indique si l'instance est optimisée pour les E/S. Valeurs possibles :
|
| InstanceChargeType | String | No | PrePaid |
Méthode de facturation de l'instance. Valeurs possibles :
|
| Period | Integer | No | 1 |
Durée d'abonnement de l'instance. Unité : mois. Ce paramètre est valide et requis uniquement lorsque |
| InternetChargeType | String | No | PayByTraffic |
Méthode de facturation pour l'utilisation du réseau. Valeurs possibles :
Remarque Lorsque 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 spécifications de performance garanties. Dans les scénarios où la demande dépasse l'offre de ressources, les valeurs de bande passante maximales peuvent être limitées. 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 la configuration du système d'exploitation de l'instance. |
| NetworkType | String | No | vpc |
Type de réseau de l'instance. Valeurs possibles :
|
| UserData | String | No | ZWNobyBoZWxsbyBl**** |
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 |
Nom de la paire de clés.
|
| RamRoleName | String | No | testRamRoleName |
Nom du rôle Resource Access Management (RAM) de l'instance. Appelez l'opération ListRoles fournie par RAM pour obtenir la liste des rôles RAM d'instance que vous avez créés. |
| AutoReleaseTime | String | No | 2018-01-01T12:05:00Z |
Heure de libération automatique de l'instance. Spécifiez l'heure selon la norme ISO 8601 au format aaaa-MM-jjTHH:mm:ssZ. L'heure doit être exprimée en UTC.
|
| SpotStrategy | String | No | NoSpot |
Politique de préemption pour l'instance de paiement à l'utilisation. Ce paramètre prend effet uniquement lorsque
|
| SpotPriceLimit | Float | No | 0.97 |
Prix horaire maximal de l'instance préemptible. Jusqu'à trois décimales sont autorisées. |
| SpotDuration | Integer | No | 1 |
Période de protection de l'instance préemptible. Unité : heures. Valeur par défaut : 1. Valeurs possibles :
Alibaba Cloud envoie un événement 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 appropriée 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**** |
ID du groupe de ressources. |
| SecurityEnhancementStrategy | String | No | Active |
Indique s'il faut activer le durcissement de la sécurité pour le système d'exploitation. Valeurs possibles :
|
| PrivateIpAddress | String | No | 10.1.**.** |
Adresse IP privée à attribuer à 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 dans le bloc CIDR du vSwitch spécifié par |
| Ipv6AddressCount | Integer | No | 1 |
Nombre d'adresses IPv6 à générer de manière aléatoire pour l'interface réseau élastique (ENI) principale. Valeurs possibles : 1 à 10. |
| DeploymentSetId | String | No | ds-bp1brhwhoqinyjd6**** |
ID du jeu de déploiement dans lequel déployer l'instance. |
| DataDisk.N.PerformanceLevel | String | No | PL1 |
Niveau de performance du disque ESSD à utiliser comme disque de données N. La valeur de N doit être identique à celle de
Pour plus d'informations sur les niveaux de performance des disques ESSD, consultez la rubrique Disques ESSD. |
| DataDisk.N.Description | String | No | testDataDiskDescription |
Description du disque de données N. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par |
| DataDisk.N.SnapshotId | String | No | s-bp17441ohwka0yuh**** |
ID du snapshot à utiliser pour créer le disque de données N. Valeurs possibles pour N : 1 à 16. Si 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 |
Taille du disque de données N. Valeurs possibles pour N : 1 à 16. Unité : GiB. Valeurs possibles :
La valeur de ce paramètre doit être supérieure ou égale à la taille du snapshot spécifié par |
| 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 |
Nom du disque de données N. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par |
| DataDisk.N.Category | String | No | cloud_ssd |
Catégorie du disque de données N. Valeurs possibles :
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 possibles :
Valeur par défaut : true. |
| DataDisk.N.Encrypted | String | No | false |
Indique s'il faut chiffrer le disque de données N. |
| DataDisk.N.ProvisionedIops | Long | No | 50000 |
IOPS en lecture/écriture provisionnés du disque ESSD AutoPL à utiliser comme disque de données N. Valeurs possibles : 0 à min{50 000, 1 000 × Capacité - Performances de base} Performances de base = min{1 800 + 50 × Capacité, 50 000} Remarque Ce paramètre est disponible uniquement si le paramètre DataDisk.N.Category est défini sur cloud_auto. Pour plus d'informations, consultez les rubriques 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 possibles :
|
| DataDisk.N.AutoSnapshotPolicyId | String | No | sp-bp67acfmxazb4p**** |
ID de la politique de snapshot automatique à appliquer au disque de données N. |
| NetworkInterface.N.VSwitchId | String | No | vsw-bp1s5fnvk4gn2tws0**** |
ID du vSwitch auquel connecter l'ENI secondaire. L'instance et l'ENI secondaire doivent résider dans la même zone du même VPC, mais elles peuvent être connectées à des vSwitch différents. La valeur de N dans |
| NetworkInterface.N.NetworkInterfaceName | String | No | testNetworkInterfaceName |
Nom de l'ENI secondaire. La valeur de N dans |
| NetworkInterface.N.Description | String | No | testNetworkInterfaceDescription |
Description de l'ENI secondaire. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par |
| NetworkInterface.N.SecurityGroupId | String | No | sg-bp15ed6xe1yxeycg**** |
ID du groupe de sécurité auquel attribuer l'ENI secondaire. Les groupes de sécurité de l'ENI secondaire et de l'instance doivent appartenir au même VPC. La valeur de N dans Remarque Vous ne pouvez pas spécifier à la fois NetworkInterface.N.SecurityGroupId et NetworkInterface.N.SecurityGroupIds.N. |
| NetworkInterface.N.PrimaryIpAddress | String | No | 192.168.**.** |
Adresse IP privée principale de l'ENI secondaire. La valeur de N dans |
| NetworkInterface.N.SecurityGroupIds.N | String | No | sg-bp67acfmxazb4p**** |
ID du groupe de sécurité N auquel attribuer l'ENI secondaire. Le groupe de sécurité et l'ENI secondaire doivent appartenir au même VPC. Les valeurs valides de N dans Remarque Vous ne pouvez pas spécifier à la fois NetworkInterface.N.SecurityGroupId et NetworkInterface.N.SecurityGroupIds.N. |
| NetworkInterface.N.InstanceType | String | No | Secondary |
Type de l'ENI N. Valeurs possibles pour N : 1 et 2. Si la valeur de N est 1, vous pouvez configurer une ENI principale ou une ENI secondaire. Si la valeur de N est 2, vous pouvez configurer une ENI principale et une ENI secondaire. Valeurs possibles :
Valeur par défaut : Secondary. |
| NetworkInterface.N.NetworkInterfaceTrafficMode | String | No | Standard |
Mode de communication de l'ENI principale. Valeurs possibles :
|
| Tag.N.Key | String | No | TestKey |
Clé du tag N à ajouter à l'instance, aux périphériques Elastic Block Storage (EBS) ou à l'ENI principale. Valeurs possibles pour N : 1 à 5. La clé du tag ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 64 caractères et ne peut pas commencer par |
| Tag.N.Value | String | No | TestValue |
Valeur du tag N à ajouter à l'instance, aux périphériques EBS ou à l'ENI principale. Valeurs possibles pour N : 1 à 5. La valeur du tag peut être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne peut pas commencer par |
| SecurityGroupIds.N | String | No | sg-bp15ed6xe1yxeycg7**** |
ID du groupe de sécurité N auquel attribuer l'instance. 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 rubrique Limites. Remarque Vous ne pouvez pas spécifier à la fois SecurityGroupId et SecurityGroupIds.N. |
| SystemDisk.Encrypted | String | No | false |
Indique s'il faut chiffrer le disque système. Valeurs possibles :
Valeur par défaut : false. Remarque Lorsque 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 possibles :
Valeur par défaut : false. Remarque Ce paramètre s'applique uniquement aux instances de paiement à l'utilisation. Il peut protéger les instances contre les suppressions manuelles, mais pas contre les suppressions automatiques. |
| CreditSpecification | String | No | Standard |
Mode de performance de l'instance à capacité variable. Valeurs possibles :
|
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
| LaunchTemplateVersionNumber | Long | 2 |
Numéro de version du modèle de lancement. |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DEX**** |
ID de la requête. |
| LaunchTemplateId | String | lt-bp1apo0bbbkuy0rj**** |
ID du modèle de lancement. Pour plus d'informations, consultez DescribeLaunchTemplates. Spécifiez LaunchTemplateId ou LaunchTemplateName pour identifier un modèle de lancement. |
Exemples
Exemples de requêtes
http(s)://ecs.aliyuncs.com/?Action=CreateLaunchTemplateVersion
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-m5eiaupmvm2op9d****
&LaunchTemplateName=testLaunchTemplateName
&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-bp1s5fnvk4gn2tws0****
&InstanceName=testInstanceName
&Description=testDescription
&InternetMaxBandwidthIn=50
&InternetMaxBandwidthOut=5
&HostName=testHostName
&ZoneId=cn-hangzhou-g
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=40
&SystemDisk.DiskName=testSystemDiskName
&SystemDisk.Description=testSystemDiskDescription
&DataDisk.1.Size=2000
&DataDisk.1.SnapshotId=s-bp17441ohwka0yuh****
&DataDisk.1.Category=cloud_ssd
&DataDisk.1.Encrypted=false
&DataDisk.1.DiskName=cloud_ssdData
&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=testNetworkInterfaceName
&NetworkInterface.1.Description=testNetworkInterfaceDescription
&PrivateIpAddress=10.1.**.**
&InstanceChargeType=PrePaid
&Period=1
&InternetChargeType=PayByTraffic
&NetworkType=vpc
&UserData=ZWNobyBoZWxsbyBl****
&RamRoleName=testRamRoleName
&AutoReleaseTime=2020-02-02T12:05:00Z
&SpotStrategy=NoSpot
&SpotPriceLimit=0.97
&SecurityEnhancementStrategy=Active
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>
Exemples de réponses réussies
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateLaunchTemplateVersionResponse>
<LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DEX****</RequestId>
<LaunchTemplateId>lt-bp1apo0bbbkuy0rj****</LaunchTemplateId>
</CreateLaunchTemplateVersionResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"LaunchTemplateVersionNumber" : 2,
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DEX****",
"LaunchTemplateId" : "lt-bp1apo0bbbkuy0rj****"
}
Codes d'erreur
|
HTTP status code |
Error code |
Error message |
Description |
| 400 | InvalidRegion.NotExist | %s | The specified region is not found. |
| 400 | MissingParameter | %s | A required parameter is not specified. |
| 400 | InvalidParameter | %s | Invalid parameter value. |
| 400 | InvalidDescription.Malformed | The specified parameter "Description" is not valid. | Invalid Description format. The description must be 2 to 256 characters in length and cannot start with http:// or https://. |
| 400 | InvalidUserData.SizeExceeded | %s | The maximum size of the specified user data 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. |
| 403 | LaunchTemplateVersionLimitExceed | %s | The maximum number of launch template versions is exceeded. |
| 404 | InvalidLaunchTemplate.NotFound | %s | The specified launch template is not found. Check whether the parameter value is correct. |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | The resource group is not found. |
| 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 la rubrique Codes d'erreur de service.