CreateLaunchTemplate - - Centro de documentación de Alibaba Cloud

Cree una plantilla de lanzamiento. Una plantilla de lanzamiento elimina la necesidad de configurar una gran cantidad de parámetros cada vez que se crea una instancia de Elastic Compute Service (ECS).

Notas de uso

Las plantillas de lanzamiento contienen configuraciones predefinidas que se utilizan para crear instancias, como la región, el ID de imagen, el tipo de instancia, el ID del security group y la configuración de ancho de banda público. Si un parámetro específico que desea utilizar no está incluido en una plantilla de lanzamiento, especifique el parámetro cuando utilice la plantilla para crear una instancia.

Después de crear una plantilla de lanzamiento mediante la operación CreateLaunchTemplate, el número de versión de la plantilla se establece en 1 de forma predeterminada. Puede crear varias versiones llamando a la operación CreateLaunchTemplateVersion para la plantilla de lanzamiento. Los números de versión comienzan en 1 y aumentan de uno en uno. Si no especifica un número de versión de plantilla al usar una plantilla de lanzamiento para crear instancias mediante la operación RunInstances, se utiliza la versión predeterminada.

Tenga en cuenta los siguientes puntos:

Puede crear hasta 30 plantillas de lanzamiento en cada región. Cada plantilla de lanzamiento puede tener hasta 30 versiones.
La mayoría de los parámetros en las plantillas de lanzamiento son opcionales. Cuando crea una plantilla de lanzamiento, ECS no verifica la existencia ni la validez de los valores de parámetro especificados. Los valores de los parámetros solo se verifican cuando utiliza la plantilla de lanzamiento para crear instancias.
Si configura un parámetro específico en una plantilla de lanzamiento, no puede filtrar ese parámetro cuando utiliza la plantilla para crear instancias mediante la operación RunInstances. Por ejemplo, si establece HostName en LocalHost en una plantilla de lanzamiento pero no especifica HostName al llamar a la operación RunInstances para crear instancias desde dicha plantilla, el nombre de host de la instancia seguirá siendo LocalHost. Si desea sobrescribir el valor LocalHost de HostName proporcionado por la plantilla de lanzamiento, puede establecer HostName en MyHost u otro valor al llamar a la operación RunInstances.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su conveniencia, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateLaunchTemplate	La operación que desea ejecutar. Establezca el valor en CreateLaunchTemplate.
RegionId	String	Sí	cn-hangzhou	El ID de región de la plantilla de lanzamiento. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
TemplateTag.N.Key	String	No	TestKey	La clave de la etiqueta N que desea agregar a la plantilla de lanzamiento. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. La clave de la etiqueta no puede comenzar con `acs`: o `aliyun`.
TemplateTag.N.Value	String	No	TestValue	El valor de la etiqueta N que desea agregar a la plantilla de lanzamiento. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. El valor de la etiqueta no puede comenzar con `acs`: o `aliyun`.
LaunchTemplateName	String	Sí	testLaunchTemplateName	El nombre de la plantilla de lanzamiento. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra, pero no puede empezar con `http://` ni `https://`. El nombre puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
VersionDescription	String	No	testVersionDescription	La descripción de la versión de la plantilla de lanzamiento. La descripción debe tener entre 2 y 256 caracteres de longitud, y no puede comenzar con `http://` ni `https://`.
ImageId	String	No	win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd	El ID de la imagen. Puede llamar a la operación DescribeImages para consultar las imágenes disponibles.
ImageOwnerAlias	String	No	system	El origen de la imagen. Valores válidos: system: imágenes públicas proporcionadas por Alibaba Cloud. self: imágenes personalizadas que usted creó. others: imágenes compartidas de otras cuentas de Alibaba Cloud. marketplace: imágenes de Alibaba Cloud Marketplace. Si hay imágenes de Alibaba Cloud Marketplace disponibles, puede utilizarlas sin necesidad de suscribirse a ellas. Tenga en cuenta los detalles de facturación de las imágenes de Alibaba Cloud Marketplace.
PasswordInherit	Boolean	No	false	Especifica si se debe usar la contraseña predefinida en la imagen. Nota Si utiliza este parámetro, deje Password vacío y asegúrese de que la imagen seleccionada tenga una contraseña predefinida.
InstanceType	String	No	ecs.g5.large	El tipo de la instancia. Para obtener más información, consulte Instance families. También puede llamar a la operación DescribeInstanceTypes para consultar la lista de tipos de instancia más reciente.
SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	El ID del security group al que pertenece la instancia. Las instancias dentro del mismo security group pueden comunicarse entre sí. Cada security group puede contener hasta 1,000 instancias. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` simultáneamente.
VpcId	String	No	vpc-bp12433upq1y5scen****	El ID de la virtual private cloud (VPC).
VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	El ID del vSwitch al que desea conectar la instancia. Este parámetro es obligatorio si especifica VpcId.
InstanceName	String	No	testInstanceName	El nombre de la instancia. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra, pero no puede empezar con `http://` ni `https://`. El nombre puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
Description	String	No	testECSDescription	La descripción de la instancia. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.
InternetMaxBandwidthIn	Integer	No	10	El ancho de banda público de entrada máximo. Unidad: Mbit/s. Valores válidos: Si el ancho de banda público de salida adquirido es menor o igual a 10 Mbit/s, los valores válidos de este parámetro son de 1 a 10 y el valor predeterminado es 10. Si el ancho de banda público de salida adquirido es mayor a 10 Mbit/s, los valores válidos de este parámetro van de 1 al valor de `InternetMaxBandwidthOut` y el valor predeterminado es el valor de `InternetMaxBandwidthOut`.
InternetMaxBandwidthOut	Integer	No	10	El ancho de banda público de salida máximo. Unidad: Mbit/s. Valores válidos: 0 a 100.
HostName	String	No	testHostName	El nombre de host de la instancia. El nombre de host no puede comenzar ni terminar con un punto (.) o un guion (-). No puede contener puntos (.) o guiones (-) consecutivos. Para instancias Windows, el nombre de host debe tener entre 2 y 15 caracteres de longitud, no puede contener puntos (.) ni estar compuesto únicamente por dígitos. Puede contener letras, dígitos y guiones (-). Para instancias que ejecutan otros sistemas operativos, como Linux, el nombre de host debe tener entre 2 y 64 caracteres de longitud. Separe el nombre de host en varios segmentos mediante puntos (.). Cada segmento puede contener letras, dígitos y guiones (-).
ZoneId	String	No	cn-hangzhou-g	El ID de zona de la instancia.
SystemDisk.Category	String	No	cloud_ssd	La categoría del disco del sistema. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD. cloud_essd: SSD mejorado (ESSD). Puede usar `SystemDisk.PerformanceLevel` para establecer el nivel de rendimiento del ESSD que se utilizará como disco del sistema. Para instancias no optimizadas para E/S de un tipo de instancia retirado, el valor predeterminado es cloud. Para otros tipos de instancias, el valor predeterminado es cloud_efficiency.
SystemDisk.Size	Integer	No	40	El tamaño del disco del sistema. Unidad: GiB. Valores válidos: 20 a 500. El valor de este parámetro debe ser como mínimo 20 y mayor o igual al tamaño de la imagen.
SystemDisk.DiskName	String	No	testSystemDiskName	El nombre del disco del sistema. El nombre debe tener entre 2 y 128 caracteres de longitud, y puede contener letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-). Debe comenzar con una letra, pero no puede empezar con `http://` ni `https://`. El nombre puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
SystemDisk.Description	String	No	testSystemDiskDescription	La descripción del disco del sistema. La descripción debe tener entre 2 y 256 caracteres de longitud, y no puede comenzar con `http://` ni `https://`.
SystemDisk.Iops	Integer	No	null	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SystemDisk.PerformanceLevel	String	No	PL0	El nivel de rendimiento del ESSD que se utilizará como disco del sistema. Valores válidos: PL0 (predeterminado): Un solo ESSD puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria. PL1: Un solo ESSD puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria. PL2: Un solo ESSD puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria. PL3: Un solo ESSD puede ofrecer hasta 1 millón de IOPS de lectura/escritura aleatoria. Para obtener más información sobre los niveles de rendimiento de ESSD, consulte ESSDs.
SystemDisk.DeleteWithInstance	Boolean	No	true	Especifica si se debe liberar el disco del sistema cuando se libera la instancia. Valores válidos: true false Valor predeterminado: true.
SystemDisk.AutoSnapshotPolicyId	String	No	sp-gc7c37d4ylw7mtnk****	El ID de la directiva de instantánea automática que desea aplicar al disco del sistema.
SystemDisk.ProvisionedIops	Long	No	50000	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50,000, 1,000 × Capacidad - IOPS base}. IOPS base = min{1,800 + 50 × Capacidad, 50,000}. Nota Este parámetro solo está disponible si SystemDisk.Category se establece en cloud_auto. Para obtener más información, consulte ESSD AutoPL disks y Modify the performance configurations of an ESSD AutoPL disk.
SystemDisk.BurstingEnabled	Boolean	No	true	Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos: true false
IoOptimized	String	No	optimized	Especifica si la instancia está optimizada para E/S. Valores válidos: none: La instancia no está optimizada para E/S. optimized: La instancia está optimizada para E/S.
InstanceChargeType	String	No	PrePaid	El método de facturación de la instancia. Valores válidos: PrePaid: subscription. Si establece este parámetro en PrePaid, asegúrese de que su cuenta tenga créditos suficientes. De lo contrario, se devuelve un error `InvalidPayMethod`. PostPaid: pay-as-you-go.
Period	Integer	No	1	La duración de la suscripción de la instancia. Unidad: meses. Este parámetro surte efecto y es obligatorio solo si establece `InstanceChargeType` en `PrePaid`. Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 y 60.
InternetChargeType	String	No	PayByTraffic	El método de facturación para el uso de la red. Valores válidos: PayByBandwidth PayByTraffic Nota Si se utiliza el método de facturación pay-by-traffic para el uso de la red, los anchos de banda de entrada y salida máximos se utilizan como límites superiores en lugar de rendimiento garantizado. En escenarios donde la demanda supera la oferta de recursos, es posible que no se alcancen los valores máximos de ancho de banda. Si desea anchos de banda garantizados para sus instancias, utilice el método de facturación pay-by-bandwidth para el uso de la red.
EnableVmOsConfig	Boolean	No	false	Especifica si se deben habilitar las configuraciones del sistema operativo de la instancia. Nota Este parámetro se eliminará en el futuro. Para garantizar la compatibilidad futura, le recomendamos que utilice otros parámetros.
NetworkType	String	No	vpc	El tipo de red de la instancia. Valores válidos: classic: red clásica. vpc: VPC.
UserData	String	No	ZWNobyBoZWxsbyBlY3Mh	Los datos de usuario de la instancia. Los datos de usuario deben codificarse en Base64. El tamaño máximo de los datos sin procesar es de 16 KB.
KeyPairName	String	No	testKeyPairName	El nombre del key pair. Para instancias Windows, este parámetro se ignora. `Password` surte efecto independientemente de si especifica KeyPairName. Para instancias Linux, el método de autenticación basado en contraseña se deshabilita de forma predeterminada.
RamRoleName	String	No	testRamRoleName	El nombre del rol de Resource Access Management (RAM) de la instancia. Puede llamar a la operación ListRoles proporcionada por RAM para consultar los roles de RAM de instancia que ha creado.
AutoReleaseTime	String	No	2018-01-01T12:05:00Z	La hora de liberación automática de la instancia. Especifique la hora en formato estándar ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Si el valor de `ss` no es `00`, la hora se redondea automáticamente al minuto más cercano según el valor de `mm`. La hora especificada debe ser como mínimo 30 minutos posterior a la hora actual. La hora especificada puede ser hasta tres años posterior a la hora actual.
SpotStrategy	String	No	NoSpot	La directiva de interrupción para la instancia pay-as-you-go. Este parámetro solo surte efecto si establece `InstanceChargeType` en `PostPaid`. Valores válidos: NoSpot: La instancia es una instancia pay-as-you-go. SpotWithPriceLimit: La instancia es una preemptible instance con un precio horario máximo definido por el usuario. SpotAsPriceGo: La instancia es una preemptible instance para la cual se utiliza automáticamente el precio de mercado en el momento de la compra como precio de puja.
SpotPriceLimit	Float	No	0.97	El precio horario máximo de la instancia. El valor tiene una precisión de tres decimales. Este parámetro solo surte efecto si establece `SpotStrategy` en `SpotWithPriceLimit`.
SpotDuration	Integer	No	1	El período de protección de la preemptible instance. Unidad: horas. Valor predeterminado: 1. Valores válidos: 1: Después de crear una preemptible instance, Alibaba Cloud garantiza que la instancia no se libere automáticamente durante 1 hora. Una vez finalizado el período de protección de 1 hora, el sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. 0: Después de crear una preemptible instance, Alibaba Cloud no garantiza que la instancia se ejecute durante 1 hora. El sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. Alibaba Cloud envía eventos del sistema ECS para notificarle 5 minutos antes de que se libere la instancia. Las preemptible instances se facturan por segundo. Le recomendamos que especifique un período de protección según sus requisitos comerciales. Nota Si establece SpotStrategy en SpotWithPriceLimit o SpotAsPriceGo, este parámetro surte efecto.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que pertenecen la instancia, el dispositivo Elastic Block Storage (EBS) y la elastic network interface (ENI).
TemplateResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que pertenece la plantilla de lanzamiento.
SecurityEnhancementStrategy	String	No	Deactive	Especifica si se debe habilitar el refuerzo de seguridad para el sistema operativo. Valores válidos: Active: habilita el refuerzo de seguridad para el sistema operativo. Deactive: deshabilita el refuerzo de seguridad para el sistema operativo.
PrivateIpAddress	String	No	10.1..	La dirección IP privada de la instancia. Para asignar una dirección IP privada a una instancia que reside en una VPC, asegúrese de que la dirección IP sea una dirección IP libre dentro del bloque CIDR del vSwitch especificado por `VSwitchId`.
DeploymentSetId	String	No	ds-bp1brhwhoqinyjd6****	El ID del conjunto de despliegue.
Ipv6AddressCount	Integer	No	1	El número de direcciones IPv6 que se generarán aleatoriamente para la elastic network interface (ENI) principal. Valores válidos: 1 a 10.
DataDisk.N.PerformanceLevel	String	No	PL1	El nivel de rendimiento del ESSD N utilizado como disco de datos. El valor de N debe ser el mismo que en `DataDisk.N.Category` si establece DataDisk.N.Category en cloud_essd. Valores válidos: PL0: Un solo ESSD puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria. PL1 (predeterminado): Un solo ESSD puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria. PL2: Un solo ESSD puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria. PL3: Un solo ESSD puede ofrecer hasta 1 millón de IOPS de lectura/escritura aleatoria. Para obtener más información sobre los niveles de rendimiento de ESSD, consulte ESSDs.
DataDisk.N.Description	String	No	testDataDiskDescription	La descripción del disco de datos N. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.
DataDisk.N.SnapshotId	String	No	s-bp17441ohwka0yuh****	El ID de la instantánea que desea utilizar para crear el disco de datos N. Valores válidos de N: 1 a 16. Si especifica `DataDisk.N.SnapshotId`, se ignora `DataDisk.N.Size`. El disco de datos se crea según el tamaño de la instantánea especificada. Nota Utilice instantáneas creadas después del 15 de julio de 2013. De lo contrario, se devuelve un error y su solicitud se rechaza.
DataDisk.N.Size	Integer	No	2000	El tamaño del disco de datos N. Valores válidos de N: 1 a 16. Unidad: GiB. Valores válidos: Valores válidos si establece DataDisk.N.Category en cloud: 5 a 2000. Valores válidos si establece DataDisk.N.Category en cloud_efficiency: 20 a 32768. Valores válidos si establece DataDisk.N.Category en cloud_ssd: 20 a 32768. Valores válidos si establece DataDisk.N.Category en cloud_essd: varían según el valor de `DataDisk.N.PerformanceLevel`. Valores válidos si establece DataDisk.N.PerformanceLevel en PL0: 40 a 32768. Valores válidos si establece DataDisk.N.PerformanceLevel en PL1: 20 a 32768. Valores válidos si establece DataDisk.N.PerformanceLevel en PL2: 461 a 32768. Valores válidos si establece DataDisk.N.PerformanceLevel en PL3: 1261 a 32768. El valor de este parámetro debe ser mayor o igual al tamaño de la instantánea especificada por `DataDisk.N.SnapshotId`.
DataDisk.N.Device	String	No	null	Nota Este parámetro se eliminará en el futuro. Le recomendamos que utilice otros parámetros para garantizar la compatibilidad futura.
DataDisk.N.DiskName	String	No	testDataDiskName	El nombre del disco de datos N. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra, pero no puede empezar con `http://` ni `https://`. El nombre puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
DataDisk.N.Category	String	No	cloud_ssd	La categoría del disco de datos N. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra cloud_ssd: SSD. cloud_essd: SSD mejorado (ESSD). Para instancias optimizadas para E/S, el valor predeterminado es cloud_efficiency. Para instancias no optimizadas para E/S, el valor predeterminado es cloud.
DataDisk.N.DeleteWithInstance	Boolean	No	true	Especifica si se debe liberar el disco de datos N cuando se libera la instancia. Valores válidos: true false Valor predeterminado: true.
DataDisk.N.Encrypted	String	No	false	Especifica si se debe cifrar el disco de datos N.
DataDisk.N.AutoSnapshotPolicyId	String	No	sp-m5e7fa9ute44ssa****	El ID de la directiva de instantánea automática que se aplicará al disco de datos N.
DataDisk.N.ProvisionedIops	Long	No	50000	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50,000, 1,000 × Capacidad - IOPS base}. IOPS base = min{1,800 + 50 × Capacidad, 50,000}. Nota Este parámetro solo está disponible si establece SystemDisk.Category en cloud_auto. Para obtener más información, consulte ESSD AutoPL disks y Modify the performance configurations of an ESSD AutoPL disk.
DataDisk.N.BurstingEnabled	Boolean	No	true	Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos: true false
NetworkInterface.N.VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	El ID del vSwitch con el que asociar la ENI N. Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 y 2. Si el valor de N es 1, puede especificar una ENI principal o secundaria. Si el valor de N es 2, debe especificar una ENI principal y una secundaria. Si establece `NetworkInterface.N.InstanceType` en `Primary`, este parámetro es obligatorio. En este caso, este parámetro equivale a `VSwitchId`. No puede especificar NetworkInterface.N.VSwitchId y `VSwitchId` simultáneamente. Si establece `NetworkInterface.N.InstanceType` en `Secondary` o deja el parámetro vacío, este parámetro es opcional. El valor predeterminado es el ID del vSwitch al que conectar la instancia.
NetworkInterface.N.NetworkInterfaceName	String	No	testEniName	El nombre de la ENI N. Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 y 2. Si el valor de N es 1, se puede configurar una ENI principal o secundaria. Si el valor de N es 2, se deben configurar una ENI principal y una secundaria. Si establece `NetworkInterface.N.InstanceType` en `Primary`, no necesita establecer este parámetro.
NetworkInterface.N.Description	String	No	testEniDescription	La descripción de la ENI secundaria N. La descripción debe tener entre 2 y 256 caracteres de longitud, y no puede comenzar con `http://` ni `https://`. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.
NetworkInterface.N.SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	El ID del security group al que pertenece la ENI N. Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 y 2. Si el valor de N es 1, se puede configurar una ENI principal o secundaria. Si el valor de N es 2, se deben configurar una ENI principal y una secundaria. Si `NetworkInterface.N.InstanceType` se establece en `Primary`, este parámetro es obligatorio. En este caso, este parámetro equivale a `SecurityGroupId`. No puede especificar `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupIds.N`. Si establece `NetworkInterface.N.InstanceType` en `Secondary` o deja este parámetro vacío, NetworkInterface.SecurityGroupIds es opcional. El valor predeterminado es el ID del security group al que pertenece la instancia.
NetworkInterface.N.PrimaryIpAddress	String	No	192.168..	La dirección IP principal de la ENI N. Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 y 2. Si el valor de N es 1, puede especificar una ENI principal o secundaria. Si se especifica este parámetro, `Amount` se establece en un valor numérico mayor que 1, y NetworkInterface.N.InstanceType se establece en Primary, se crea el número especificado de instancias y se asignan direcciones IP principales consecutivas comenzando desde la especificada. En este caso, no puede vincular ENI secundarias a estas instancias. Si el valor de N es 2, se deben configurar una ENI principal y una secundaria. Si se especifica este parámetro, `Amount` se establece en un valor numérico mayor que 1, y NetworkInterface.N.InstanceType se establece en Primary, no puede establecer `NetworkInterface.2.InstanceType` en Secondary para adjuntar una ENI secundaria. Si `NetworkInterface.N.InstanceType` se establece en `Primary`, este parámetro equivale a `PrivateIpAddress`. No puede especificar NetworkInterface.N.PrimaryIpAddress y `PrivateIpAddress` simultáneamente. Si `NetworkInterface.N.InstanceType` se establece en `Secondary` o se deja vacío, la dirección IP principal especificada se asigna a la ENI secundaria. El valor predeterminado es una dirección IP seleccionada aleatoriamente dentro del bloque CIDR del vSwitch con el que asociar la ENI secundaria. Nota Solo puede adjuntar una única ENI secundaria al crear una instancia. Una vez creada la instancia, puede llamar a las operaciones CreateNetworkInterface y AttachNetworkInterface para adjuntar más ENI secundarias a la instancia.
NetworkInterface.N.SecurityGroupIds.N	String	No	sg-bp67acfmxazb4p****	El ID del security group N al que asignar la ENI N. Valores válidos del primer N: 1 y 2. Si el valor del primer N es 1, puede configurar una ENI principal o secundaria. Si el valor del primer N es 2, debe configurar una ENI principal y una secundaria. El segundo N indica que se pueden especificar uno o más ID de security group. Los valores válidos del segundo N varían según el número máximo de security groups a los que puede pertenecer una instancia. Para obtener más información, consulte la sección "Límites de security group" en Limits. Tenga en cuenta los siguientes puntos: Si `NetworkInterface.N.InstanceType` se establece en `Primary`, este parámetro o `NetworkInterface.N.SecurityGroupId` es obligatorio. En este caso, este parámetro equivale a `SecurityGroupIds.N`. No puede especificar `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupId`. Si establece `NetworkInterface.N.InstanceType` en `Secondary` o deja este parámetro vacío, NetworkInterface.SecurityGroupIds es opcional. El valor predeterminado es el ID del security group al que pertenece la instancia.
NetworkInterface.N.InstanceType	String	No	Secondary	El tipo de la ENI N. Valores válidos de N: 1 y 2. Si el valor de N es 1, puede especificar una ENI principal o secundaria. Si el valor de N es 2, debe especificar una ENI principal y una secundaria. Valores válidos: Primary Secondary Valor predeterminado: Secondary.
NetworkInterface.N.NetworkInterfaceTrafficMode	String	No	Standard	El modo de comunicación de la ENI principal. Valores válidos: Standard: utiliza el modo de comunicación TCP. HighPerformance: habilita Elastic RDMA Interface (ERI) y utiliza el modo de comunicación de acceso directo a memoria remota (RDMA).
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N que desea agregar a la instancia, dispositivo EBS o ENI. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 64 caracteres de longitud y no puede comenzar con `acs:` o `aliyun`. La clave de la etiqueta no puede contener `http://` ni `https://`.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N que desea agregar a la instancia, dispositivo EBS o ENI. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: o aliyun. El valor de la etiqueta no puede contener http:// o https://.
SecurityGroupIds.N	String	No	sg-bp15ed6xe1yxeycg7****	El ID del security group N al que pertenece la instancia. Los valores válidos de N varían según el número máximo de security groups a los que puede pertenecer una instancia. Para obtener más información, consulte la sección "Límites de security group" en Limits. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` al mismo tiempo.
SystemDisk.Encrypted	String	No	false	Especifica si se debe cifrar el disco del sistema. Valores válidos: true false Valor predeterminado: false. Nota Si crea instancias en Hong Kong Zone D o Singapore Zone A, no puede cifrar los discos del sistema.
DeletionProtection	Boolean	No	false	Especifica si se debe habilitar la protección contra liberación para la instancia. Este parámetro determina si puede utilizar la consola ECS o llamar a la operación DeleteInstance para liberar la instancia. Valores válidos: true false Valor predeterminado: false. Nota Este parámetro solo se aplica a instancias pay-as-you-go. Puede proteger instancias contra liberaciones manuales, pero no contra liberaciones automáticas.
CreditSpecification	String	No	Standard	El modo de rendimiento de la instancia escalable. Valores válidos: Standard: modo estándar. Para obtener más información, consulte la sección "Modo estándar" en Burstable instances. Unlimited: modo ilimitado. Para obtener más información, consulte la sección "Modo ilimitado" en Burstable instances.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
LaunchTemplateId	String	lt-m5eiaupmvm2op9d****	El ID de la plantilla de lanzamiento.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	El ID de la solicitud.
LaunchTemplateVersionNumber	Long	2	El número de versión de la plantilla de lanzamiento.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

XML formato

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>

JSON formato

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

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

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidRegion.NotExist	%s	La región especificada no existe.
400	MissingParameter	%s	No se especificó un parámetro obligatorio.
400	InvalidParameter	%s	Valor de parámetro no válido.
400	InvalidLaunchTemplateName.Malformed	The specified parameter LaunchTemplateName is not valid.	Valor de LaunchTemplateName no válido.
400	InvalidUserData.SizeExceeded	%s	Se excedió el tamaño máximo de datos de usuario.
400	InvalidUserData.Base64FormatInvalid	%s	Formato de UserData no válido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clave de la etiqueta ya existe. Las claves de etiqueta deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key no válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value no válido.
403	LaunchTemplateLimitExceed	%s	Se excedió el número máximo de plantillas de lanzamiento.
403	LaunchTemplateName.Duplicated	%s	El nombre de plantilla de lanzamiento especificado ya existe.
403	QuotaExceed.Tags	%s	Se excedió el número máximo de etiquetas. %s es una variable. Se devuelve un mensaje de error dinámicamente según las condiciones de la llamada.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	El ID del resource group no existe.
500	InternalError	The request processing has failed due to some unknown error.	Ocurrió un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.