CreateLaunchTemplate - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Crea una plantilla de lanzamiento de instancias de ECS. Una plantilla de lanzamiento elimina la necesidad de configurar una gran cantidad de parámetros cada vez que se crea una instancia.

Descripción de la operación

Después de llamar a CreateLaunchTemplate para crear una plantilla, se genera automáticamente una versión predeterminada con el número de versión 1. A continuación, puede crear varias versiones basadas en esta plantilla (CreateLaunchTemplateVersion), con números de versión que se incrementan secuencialmente a partir de 1. Si no especifica una versión de plantilla al crear instancias (RunInstances), se utiliza la versión predeterminada.

Una versión de plantilla de lanzamiento contiene las configuraciones que se utilizan para crear instancias, como la región, el ID de imagen, el tipo de instancia, el ID de grupo de seguridad y el ancho de banda público. Si no se especifica una configuración de instancia concreta en la versión, debe especificarla al crear las instancias.

Al llamar a esta operación, tenga en cuenta los siguientes puntos:

Cada cuenta puede crear hasta 30 plantillas de lanzamiento por región, y cada plantilla puede tener hasta 30 versiones.
La mayoría de los parámetros en una plantilla de lanzamiento son opcionales. Al crear una plantilla, Alibaba Cloud no verifica la existencia ni la validez de los valores de los parámetros. La validez de los valores de los parámetros solo se verifica cuando realmente se crean las instancias.
Si se establece una configuración específica en la plantilla de lanzamiento, no se puede filtrar al crear instancias (RunInstances). Por ejemplo, si la plantilla establece HostName=LocalHost y el valor de HostName se deja vacío en RunInstances, el nombre de host de la instancia seguirá siendo LocalHost. Para anular la configuración HostName=LocalHost, establezca HostName=MyHost u otro valor en RunInstances.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:CreateLaunchTemplate

create

*LaunchTemplate

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
TemplateTag	array<object>	No	La información de etiquetas de la propia plantilla de lanzamiento. Nota Actualmente, solo puede crear y consultar etiquetas para plantillas de lanzamiento mediante llamadas a operaciones de API. No puede crear ni ver estas etiquetas en la consola.
	object	No	Los pares clave-valor de etiqueta de la propia plantilla de lanzamiento.
Key	string	No	La clave de etiqueta de la plantilla de lanzamiento. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `aliyun` ni `acs:`. La clave de etiqueta no puede contener `http://` ni `https://`.	TestKey
Value	string	No	El valor de etiqueta de la plantilla de lanzamiento. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `aliyun` ni `acs:`. El valor de etiqueta no puede contener `http://` ni `https://`.	TestValue
LaunchTemplateName	string	Sí	El nombre de la plantilla de lanzamiento. El nombre debe tener de 2 a 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` ni `https://`. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_) y guiones (-).	testLaunchTemplateName
VersionDescription	string	No	La descripción de la versión de la plantilla de lanzamiento. La descripción debe tener de 2 a 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	testVersionDescription
ImageId	string	No	El ID de la imagen. Puede llamar a DescribeImages para consultar los recursos de imagen disponibles.	win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
ImageOwnerAlias	string	No	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 proporcionadas por Alibaba Cloud Marketplace. Puede usar las imágenes de Alibaba Cloud Marketplace directamente sin suscribirse a ellas previamente. Consulte los detalles de facturación de las imágenes de Alibaba Cloud Marketplace por su cuenta.	system
PasswordInherit	boolean	No	Especifica si se debe usar la contraseña preestablecida de la imagen. Nota Cuando use este parámetro, el parámetro Password debe estar vacío. Asegúrese de que la imagen que utiliza tenga una contraseña preestablecida.	false
InstanceType	string	No	El tipo de instancia. Para obtener más información, consulte Familia de instancias. También puede invocar DescribeInstanceTypes para consultar la lista de tipos de instancia más reciente.	ecs.g5.large
SecurityGroupId	string	No	El ID del grupo de seguridad al que pertenece la nueva instancia. Las instancias del mismo grupo de seguridad pueden comunicarse entre sí. Un grupo de seguridad puede contener hasta 1,000 instancias. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` al mismo tiempo.	sg-bp15ed6xe1yxeycg****
VpcId	string	No	El ID de la nube privada virtual (VPC).	vpc-bp12433upq1y5scen****
VSwitchId	string	No	El ID del vSwitch. Este parámetro es obligatorio cuando se crea una instancia conectada a una VPC.	vsw-bp1s5fnvk4gn2tws0****
InstanceName	string	No	El nombre de la instancia. El nombre debe tener de 2 a 128 caracteres de longitud y puede contener caracteres de la categoría de letras Unicode (incluidas letras en inglés, chino y dígitos). El nombre puede contener dos puntos (:), guiones bajos (_), puntos (.) y guiones (-). El valor predeterminado es el `InstanceId` de la instancia. Cuando cree varias instancias de ECS, puede establecer nombres de instancia secuenciales que contengan corchetes ([]) y comas (,). Para obtener más información, consulte Configurar por lotes nombres o nombres de host secuenciales para varias instancias.	k8s-node-[1,4]-alibabacloud
Description	string	No	La descripción de la instancia. La descripción debe tener de 2 a 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	testECSDescription
InternetMaxBandwidthIn	integer	No	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: 1 a 10. Valor predeterminado: 10. Si el ancho de banda público de salida adquirido es mayor que 10 Mbit/s: 1 al valor de `InternetMaxBandwidthOut`. Valor predeterminado: el valor de `InternetMaxBandwidthOut`.	10
InternetMaxBandwidthOut	integer	No	El ancho de banda público de salida máximo. Unidad: Mbit/s. Valores válidos: 0 a 100.	10
HostName	string	No	El nombre de host del servidor de Elastic Compute Service. El nombre de host no puede comenzar ni terminar con un punto (.) ni un guion (-). No puede contener puntos (.) ni guiones (-) consecutivos. Para instancias Windows: El nombre de host debe tener de 2 a 15 caracteres de longitud y no puede contener puntos (.) ni consistir únicamente en dígitos. Puede contener letras, dígitos y guiones (-). Para otras instancias como Linux: El nombre de host debe tener de 2 a 64 caracteres de longitud. Puede usar puntos (.) para separar el nombre de host en varios segmentos. Cada segmento puede contener letras, dígitos y guiones (-).	testHostName
ZoneId	string	No	El ID de zona de la instancia.	cn-hangzhou-g
SystemDisk.Category	string	No	La categoría del disco del sistema. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD estándar. cloud_essd: SSD empresarial (ESSD). Puede usar el parámetro `SystemDisk.PerformanceLevel` para configurar el nivel de rendimiento del disco. cloud_auto: disco ESSD AutoPL. cloud_essd_entry: disco ESSD Entry. Para los tipos de instancia retirados que no son instancias optimizadas para E/S, el valor predeterminado es cloud. Para otros tipos de instancia, el valor predeterminado es cloud_efficiency.	cloud_ssd
SystemDisk.Size	integer	No	El tamaño del disco del sistema. Unidad: GiB. Valores válidos: cloud: 20 a 500. Otras categorías de disco: 20 a 2048. El valor de este parámetro debe ser mayor o igual a max{20, ImageSize}.	40
SystemDisk.DiskName	string	No	El nombre del disco del sistema. El nombre debe tener de 2 a 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` ni `https://`. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_) y guiones (-).	testSystemDiskName
SystemDisk.Description	string	No	La descripción del disco del sistema. La descripción debe tener de 2 a 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	testSystemDiskDescription
SystemDisk.Iops	integer	No	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.	null
SystemDisk.PerformanceLevel	string	No	El nivel de rendimiento del ESSD utilizado como disco del sistema. Configuración para el nivel de rendimiento del disco. Valores válidos: PL0 (predeterminado): Un solo disco puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria. PL1: Un solo disco puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria. PL2: Un solo disco puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria. PL3: Un solo disco puede ofrecer hasta 1,000,000 IOPS de lectura/escritura aleatoria. Para obtener información sobre cómo seleccionar los niveles de rendimiento de ESSD, consulte SSD empresariales.	PL0
SystemDisk.DeleteWithInstance	boolean	No	Especifica si se debe liberar el disco del sistema cuando se libera la instancia. Valores válidos: true: El disco del sistema se libera junto con la instancia. false: El disco del sistema no se libera junto con la instancia. Valor predeterminado: true.	true
SystemDisk.AutoSnapshotPolicyId	string	No	El ID de la política de instantáneas automáticas aplicada al disco del sistema.	sp-gc7c37d4ylw7mtnk****
SystemDisk.ProvisionedIops	integer	No	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline performance}. Rendimiento base = min{1,800 + 50 × Capacity, 50,000} Nota Este parámetro solo está disponible cuando DiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL y Modificar el rendimiento aprovisionado de un disco ESSD AutoPL.	50000
SystemDisk.BurstingEnabled	boolean	No	Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos: true: Habilita la función de ráfaga de rendimiento. false: Deshabilita la función de ráfaga de rendimiento.	true
IoOptimized	string	No	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.	optimized
InstanceChargeType	string	No	El método de facturación de la instancia. Valores válidos: PrePaid: suscripción. Si establece este parámetro en PrePaid, confirme que su cuenta admite pagos a crédito. De lo contrario, se devuelve un error `InvalidPayMethod`. PostPaid: pago por uso.	PrePaid
Period	integer	No	La duración de la suscripción del recurso. Unidad: meses. Este parámetro surte efecto y es obligatorio solo cuando `InstanceChargeType` se establece en `PrePaid`. Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 y 60.	1
InternetChargeType	string	No	El método de facturación para el uso de la red. Valores válidos: PayByBandwidth: pago por ancho de banda. PayByTraffic: pago por tráfico. Nota En el modo de pago por tráfico, los anchos de banda máximos de entrada y salida se utilizan como límites superiores de ancho de banda en lugar de especificaciones de rendimiento garantizado. Cuando se produce contención de recursos, estos anchos de banda máximos pueden limitarse. Si desea anchos de banda garantizados para su negocio, utilice el modo de facturación de pago por ancho de banda.	PayByTraffic
EnableVmOsConfig	boolean	No	Especifica si se debe habilitar la configuración del sistema operativo de la instancia. Nota Este parámetro quedará obsoleto. Utilice otros parámetros para una mejor compatibilidad.	false
NetworkType	string	No	El tipo de red de la instancia. Valores válidos: classic: red clásica. Esta función ha sido retirada. Para obtener más información, consulte Aviso de retiro. vpc: VPC.	vpc
UserData	string	No	Los datos de usuario de la instancia. Los datos de usuario de la instancia deben codificarse en Base64. Los datos sin procesar pueden tener un tamaño de hasta 32 KB.	ZWNobyBoZWxsbyBlY3Mh
KeyPairName	string	No	El nombre del par de claves. Para instancias Windows, este parámetro se ignora. Incluso si especifica este parámetro, solo se utiliza el contenido de `Password`. Para instancias Linux, el método de inicio de sesión con contraseña se deshabilita durante la inicialización.	testKeyPairName
RamRoleName	string	No	El nombre del rol de RAM de la instancia. Puede llamar a la API de RAM ListRoles para consultar los roles de RAM de instancia que ha creado.	testRamRoleName
AutoReleaseTime	string	No	La hora de liberación automática. Especifique la hora en formato ISO 8601 con el formato yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Si el valor de los segundos (`ss`) no es `00`, la hora se redondea automáticamente hacia abajo al inicio del minuto actual (`mm`). La hora de liberación más temprana debe ser al menos media hora después de la hora actual. La hora de liberación más tardía no puede ser superior a tres años a partir de la hora actual.	2018-01-01T12:05:00Z
SpotStrategy	string	No	La estrategia de instancia spot para la instancia de pago por uso. Este parámetro surte efecto cuando `InstanceChargeType` se establece en `PostPaid`. Valores válidos: NoSpot: la instancia es una instancia regular de pago por uso. SpotWithPriceLimit: la instancia es una instancia spot con un precio máximo por hora definido por el usuario. SpotAsPriceGo: la instancia es una instancia spot para la cual el precio de mercado en el momento de la compra se utiliza automáticamente como precio de oferta.	NoSpot
SpotPriceLimit	number	No	El precio máximo por hora de la instancia. Este parámetro admite hasta tres decimales y surte efecto cuando `SpotStrategy` se establece en `SpotWithPriceLimit`.	0.97
SpotDuration	integer	No	El periodo de protección de la instancia spot. Unidad: horas. Valor predeterminado: 1. Valores válidos: 1: después de crear una instancia spot, Alibaba Cloud garantiza que la instancia no se libere automáticamente en un plazo de 1 hora. Una vez que finaliza el periodo de protección de 1 hora, el sistema compara el precio de oferta con el precio de mercado y comprueba el inventario de recursos para determinar si se debe retener o liberar automáticamente la instancia. 0: después de crear una instancia spot, Alibaba Cloud no garantiza que la instancia se ejecute durante 1 hora. El sistema compara el precio de oferta con el precio de mercado y comprueba el inventario de recursos para determinar si se debe retener o liberar automáticamente la instancia. Alibaba Cloud envía una notificación de evento del sistema de ECS 5 minutos antes de que se libere la instancia. Las instancias spot se facturan por segundo. Seleccione un periodo de protección adecuado en función de la duración esperada de ejecución de la tarea. Nota Este parámetro surte efecto cuando SpotStrategy se establece en SpotWithPriceLimit o SpotAsPriceGo.	1
ResourceGroupId	string	No	El ID del grupo de recursos empresariales al que pertenecen la instancia, el almacenamiento de bloques y el controlador de interfaz de red (NIC).	rg-bp67acfmxazb4p****
TemplateResourceGroupId	string	No	El ID del grupo de recursos empresariales al que pertenece la plantilla de lanzamiento.	rg-bp67acfmxazb4p****
SecurityEnhancementStrategy	string	No	Especifica si se debe habilitar el refuerzo de seguridad para el sistema operativo. Valores válidos: Active: habilita el refuerzo de seguridad. Este valor solo es aplicable a imágenes públicas. Deactive: deshabilita el refuerzo de seguridad. Este valor es aplicable a todos los tipos de imagen.	Deactive
PrivateIpAddress	string	No	La dirección IP privada de la instancia. Para asignar una dirección IP privada a una instancia de ECS conectada a una VPC, seleccione una dirección IP disponible del bloque CIDR del vSwitch (`VSwitchId`).	10.1..
DeploymentSetId	string	No	El ID del conjunto de despliegue.	ds-bp1brhwhoqinyjd6****
Ipv6AddressCount	integer	No	El número de direcciones IPv6 generadas aleatoriamente para asignar a la ENI principal. Valores válidos: 1 a 10.	1
DataDisk	array<object>	No	La lista de configuraciones de discos de datos.
	object	No	La lista de configuraciones de discos de datos.
PerformanceLevel	string	No	El nivel de rendimiento del ESSD utilizado como disco de datos. El valor de N debe ser el mismo que en `DataDisk.N.Category=cloud_essd`. Configuración para el nivel de rendimiento del disco. Valores válidos: PL0: un solo disco puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria. PL1 (predeterminado): un solo disco puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria. PL2: un solo disco puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria. PL3: un solo disco puede ofrecer hasta 1,000,000 IOPS de lectura/escritura aleatoria. Para obtener información sobre cómo seleccionar los niveles de rendimiento de ESSD, consulte SSD empresariales.	PL1
Description	string	No	La descripción del disco de datos. La descripción debe tener de 2 a 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	testDataDiskDescription
SnapshotId	string	No	El ID de la instantánea utilizada para crear el disco de datos N. Valores válidos de N: 1 a 16. Después de especificar `DataDisk.N.SnapshotId`, se ignora `DataDisk.N.Size`. El tamaño real del disco creado es el tamaño de la instantánea especificada. Nota No se pueden utilizar las instantáneas creadas el 15 de julio de 2013 o antes. Las solicitudes que utilizan dichas instantáneas se rechazan.	s-bp17441ohwka0yuh****
Size	integer	No	El tamaño del disco de datos N. Valores válidos de N: 1 a 16. Unidad: GiB. Valores válidos: cloud: 5 a 2000 cloud_efficiency: 20 a 32768 cloud_ssd: 20 a 32768 cloud_essd: el rango de valores válidos varía según el valor de `DataDisk.N.PerformanceLevel`. PL0: 1 a 32768. PL1: 20 a 32768. PL2: 461 a 32768. PL3: 1261 a 32768. cloud_auto: 1 a 32,768. cloud_essd_entry: 10 a 32,768. El valor de este parámetro debe ser mayor o igual al tamaño de la instantánea especificada por `SnapshotId`.	2000
Device	string	No	El punto de montaje del disco de datos. La convención de nomenclatura varía según el número de discos de datos conectados: 1 a 25 discos de datos: /dev/xvd`[b-z]` Más de 25 discos de datos: /dev/xvd`[aa-zz]`. Por ejemplo, el disco de datos número 26 se denomina /dev/xvdaa, el disco de datos número 27 se denomina /dev/xvdab, y así sucesivamente. Nota Este parámetro solo es aplicable a escenarios de imagen completa (imagen de máquina completa). Puede establecer este parámetro en el punto de montaje del disco de datos en la imagen completa y modificar los parámetros correspondientes `DataDisk.N.Size` y `DataDisk.N.Category` para cambiar la categoría y el tamaño del disco de datos en la imagen completa.	/dev/xvdb
DiskName	string	No	El nombre del disco de datos. El nombre debe tener de 2 a 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` ni `https://`. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_) y guiones (-).	testDataDiskName
Category	string	No	La categoría del disco de datos N. Valores válidos: cloud_efficiency: disco ultra. cloud_ssd: SSD estándar. cloud_essd: SSD empresarial (ESSD). cloud: disco básico. cloud_auto: disco ESSD AutoPL. cloud_regional_disk_auto: ESSD regional. cloud_essd_entry: disco ESSD Entry. Nota El valor cloud_essd_entry solo se admite cuando `InstanceType` se establece en un tipo de instancia de la familia `ecs.u1` o `ecs.e`. elastic_ephemeral_disk_standard: disco efímero elástico - Estándar. elastic_ephemeral_disk_premium: disco efímero elástico - Edición Premium. Para instancias optimizadas para E/S, el valor predeterminado es cloud_efficiency. Para instancias no optimizadas para E/S, el valor predeterminado es cloud. Detalles de optimización del valor predeterminado: Si InstanceType se establece en un tipo de instancia retirado que no está optimizado para E/S, el valor predeterminado del parámetro es `cloud`. En otros casos, el valor predeterminado es `cloud_efficiency`.	cloud_ssd
DeleteWithInstance	boolean	No	Especifica si se debe liberar el disco de datos cuando se libera la instancia. Valores válidos: true: el disco de datos se libera junto con la instancia. false: el disco de datos no se libera junto con la instancia. Valor predeterminado: true.	true
Encrypted	string	No	Especifica si se debe cifrar el disco de datos.	false
AutoSnapshotPolicyId	string	No	El ID de la política de instantáneas automáticas aplicada al disco de datos.	sp-m5e7fa9ute44ssa****
ProvisionedIops	integer	No	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline performance}. Rendimiento base = min{1,800 + 50 × Capacity, 50,000} Nota Este parámetro solo está disponible cuando DiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL y Modificar el rendimiento aprovisionado de un disco ESSD AutoPL.	50000
BurstingEnabled	boolean	No	Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos: true: Habilita la función de ráfaga de rendimiento. false: Deshabilita la función de ráfaga de rendimiento.	true
KMSKeyId	string	No	El ID de clave de KMS para el disco de datos.	0e478b7a-4262-4802-b8cb-00d****
NetworkInterface	array<object>	No	La información de la interfaz de red elástica (ENI).
	object	No	La información de la interfaz de red elástica (ENI).
VSwitchId	string	No	El ID del vSwitch al que pertenece la interfaz de red elástica (ENI). Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. Si NetworkInterface.N.InstanceType se establece en `Primary`, debe configurar este parámetro. En este caso, este parámetro tiene el mismo efecto que `VSwitchId`. Sin embargo, no puede especificar este parámetro y `VSwitchId` al mismo tiempo. Si NetworkInterface.N.InstanceType se establece en `Secondary` o se deja vacío, este parámetro es opcional. Valor predeterminado: el vSwitch al que pertenece la instancia de ECS.	vsw-bp1s5fnvk4gn2tws0****
NetworkInterfaceName	string	No	El nombre de la interfaz de red elástica (ENI). Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. Si NetworkInterface.N.InstanceType se establece en `Primary`, no necesita configurar este parámetro.	testEniName
Description	string	No	La descripción de la interfaz de red elástica (ENI) secundaria. La descripción debe tener una longitud de 2 a 256 caracteres y no puede comenzar con `http://` o `https://`. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.	testEniDescription
SecurityGroupId	string	No	El ID del grupo de seguridad al que pertenece la interfaz de red elástica (ENI). Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. Si NetworkInterface.N.InstanceType se establece en `Primary`, debe configurar este parámetro. En este caso, este parámetro tiene el mismo efecto que `SecurityGroupId`. Sin embargo, no puede especificar `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupIds.N`. Si NetworkInterface.N.InstanceType se establece en `Secondary` o se deja vacío, este parámetro es opcional. Valor predeterminado: el grupo de seguridad de la instancia de ECS.	sg-bp15ed6xe1yxeycg****
PrimaryIpAddress	string	No	Agrega una interfaz de red elástica (ENI) y establece la dirección IP principal. Tenga en cuenta los siguientes puntos: Valores válidos de N: 1 a 2: Si configura una ENI, puede configurar una ENI principal o una ENI secundaria. Si el parámetro `Amount` se establece en un valor mayor que 1 y configura una ENI principal con este parámetro especificado, se asignan direcciones IP principales consecutivas a partir de la dirección IP especificada a varias instancias de ECS durante la creación por lotes. En este caso, no puede conectar una ENI secundaria a las instancias. Si configura dos ENI, debe configurar una ENI principal y una ENI secundaria al mismo tiempo. Si el parámetro `Amount` se establece en un valor mayor que 1 y este parámetro se especifica para la ENI principal, no puede configurar una ENI secundaria (es decir, no puede establecer `NetworkInterface.2.InstanceType=Secondary`). Si NetworkInterface.N.InstanceType se establece en `Primary`, este parámetro tiene el mismo efecto que `PrivateIpAddress`. Sin embargo, no puede especificar este parámetro y `PrivateIpAddress` al mismo tiempo. Si NetworkInterface.N.InstanceType se establece en `Secondary` o se deja vacío, este parámetro especifica la dirección IP principal de la ENI secundaria. De forma predeterminada, se selecciona una dirección IP aleatoria del bloque CIDR del vSwitch al que pertenece la ENI. Nota Puede conectar hasta una ENI secundaria cuando crea una instancia de ECS. Una vez creada la instancia, puede invocar a CreateNetworkInterface y AttachNetworkInterface para conectar más ENI secundarias.	192.168..
SecurityGroupIds	array	No	Los ID de uno o más grupos de seguridad a los que pertenece la interfaz de red elástica (ENI). La primera N especifica el índice de la ENI. Valores válidos: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. La segunda N especifica uno o más ID de grupo de seguridad. Los valores válidos de N dependen del número máximo de grupos de seguridad a los que puede pertenecer una instancia. Para obtener más información, consulte Límites de los grupos de seguridad. Tenga en cuenta los siguientes puntos: Si NetworkInterface.N.InstanceType se establece en `Primary`, debe configurar este parámetro o `NetworkInterface.N.SecurityGroupId`. En este caso, este parámetro tiene el mismo efecto que `SecurityGroupIds.N`. Sin embargo, no puede especificar `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupId`. Si NetworkInterface.N.InstanceType se establece en `Secondary` o se deja vacío, este parámetro es opcional. Valor predeterminado: el grupo de seguridad de la instancia de ECS.	sg-bp67acfmxazb4p****
	string	No	Los ID de uno o más grupos de seguridad a los que pertenece la interfaz de red elástica (ENI). La primera N especifica el índice de la ENI. Valores válidos: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. La segunda N especifica uno o más ID de grupo de seguridad. Los valores válidos de N dependen del número máximo de grupos de seguridad a los que puede pertenecer una instancia. Para obtener más información, consulte Límites de los grupos de seguridad. Tenga en cuenta los siguientes puntos: Si NetworkInterface.N.InstanceType se establece en `Primary`, debe configurar este parámetro o `NetworkInterface.N.SecurityGroupId`. En este caso, este parámetro tiene el mismo efecto que `SecurityGroupIds.N`. Sin embargo, no puede especificar `SecurityGroupId`, `SecurityGroupIds.N` ni `NetworkInterface.N.SecurityGroupId`. Si NetworkInterface.N.InstanceType se establece en `Secondary` o se deja vacío, este parámetro es opcional. Valor predeterminado: el grupo de seguridad de la instancia de ECS.	sg-bp67acfmxazb4p****
InstanceType	string	No	El tipo de la interfaz de red elástica (ENI). Valores válidos de N: 1 a 2. Cuando configura una ENI, puede configurar una ENI principal o una ENI secundaria. Cuando configura dos ENI, solo puede configurar una ENI principal y una ENI secundaria al mismo tiempo. Valores válidos: Primary: ENI principal. Secondary: ENI secundaria. Valor predeterminado: Secondary.	Secondary
NetworkInterfaceTrafficMode	string	No	El modo de comunicación de la ENI principal. Valores válidos: Standard: utiliza el modo de comunicación TCP. HighPerformance: habilita la interfaz RDMA elástica (ERI) y utiliza el modo de comunicación RDMA.	Standard
DeleteOnRelease	boolean	No	Especifica si se debe conservar la ENI cuando se libera la instancia. Valores válidos: true: no conserva la ENI. false: conserva la ENI. Valor predeterminado: true. Nota Este parámetro solo surte efecto para las ENI secundarias.	true
Tag	array<object>	No	Las etiquetas de las instancias, los discos y las ENI principales creadas mediante esta versión de la plantilla. Escenarios Después de llamar a la operación CreateLaunchTemplate para crear una plantilla, la versión predeterminada generada automáticamente se utiliza para crear instancias. Estas etiquetas se aplican a las instancias, los discos y las ENI principales.
	object	No	Las etiquetas de las instancias, los discos y las ENI principales creadas mediante esta versión de la plantilla.
Key	string	No	La clave de etiqueta de las instancias, los discos y las ENI principales creadas mediante esta versión de la plantilla. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con aliyun ni acs:. La clave de etiqueta no puede contener http:// ni https://.	TestKey
Value	string	No	El valor de etiqueta de las instancias, los discos y las ENI principales creadas mediante esta versión de la plantilla. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede contener http:// ni https://.	TestValue
SecurityGroupIds	array	No	Los ID de uno o más grupos de seguridad a los que pertenece la instancia. Los valores válidos de N dependen del número máximo de grupos de seguridad a los que puede pertenecer una instancia. Para obtener más información, consulte Límites. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` al mismo tiempo.	sg-bp15ed6xe1yxeycg7****
	string	No	Los ID de uno o más grupos de seguridad a los que pertenece la instancia. Los valores válidos de N dependen del número máximo de grupos de seguridad a los que puede pertenecer una instancia. Para obtener más información, consulte Límites. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` al mismo tiempo.	sg-bp15ed6xe1yxeycg7****
SystemDisk.Encrypted	string	No	Especifica si se debe cifrar el disco del sistema. Valores válidos: true: cifra el disco del sistema. false: no cifra el disco del sistema. Valor predeterminado: false. Nota La zona D en Hong Kong (China) y la zona A en Singapur no admiten el cifrado del disco del sistema al crear una instancia.	false
DeletionProtection	boolean	No	El atributo de protección contra liberación de la instancia. Especifica si la instancia se puede liberar desde la consola de ECS o al llamar a la operación DeleteInstance. Valores válidos: true: habilita la protección contra liberación para la instancia. false: deshabilita la protección contra liberación para la instancia. Valor predeterminado: false. Nota Este atributo solo se aplica a las instancias de pago por uso. Solo puede evitar las operaciones de liberación manuales, no las operaciones de liberación iniciadas por el sistema.	false
CreditSpecification	string	No	El modo de ejecución de la instancia ampliable. Valores válidos: Standard: modo estándar. Para obtener más información, consulte la sección de modo de rendimiento restringido en Descripción general de las instancias ampliables. Unlimited: modo ilimitado. Para obtener más información, consulte la sección de modo de rendimiento ilimitado en Descripción general de las instancias ampliables.	Standard
AutoRenew	boolean	No	Especifica si se debe habilitar la renovación automática. Valores válidos: true: habilita la renovación automática. false: no habilita la renovación automática. Valor predeterminado: false. Nota Este parámetro solo surte efecto cuando InstanceChargeType se establece en PrePaid.	true
AutoRenewPeriod	integer	No	El período de renovación automática para una sola renovación. Valores válidos: Si PeriodUnit se establece en Month: 1, 2, 3, 6, 12, 24, 36, 48 y 60. Valor predeterminado: 1.	1
PeriodUnit	string	No	La unidad del período de suscripción. Valores válidos: Month (predeterminado).	Month
HttpEndpoint	string	No	Especifica si se debe habilitar el canal de acceso para los metadatos de la instancia. Valores válidos: enabled: habilita el canal de acceso. disabled: deshabilita el canal de acceso. Valor predeterminado: enabled. Nota Para obtener más información sobre los metadatos de la instancia, consulte Descripción general de los metadatos de la instancia.	enabled
HttpTokens	string	No	Especifica si se debe usar obligatoriamente el modo de seguridad reforzada (IMDSv2) para acceder a los metadatos de la instancia. Valores válidos: optional: no exige el uso del modo de seguridad reforzada. required: exige el uso del modo de seguridad reforzada. Después de establecer este parámetro en required, no podrá acceder a los metadatos de la instancia en modo normal. Valor predeterminado: optional. Nota Para obtener más información sobre los modos de acceso a los metadatos de la instancia, consulte Descripción general de los metadatos de la instancia.	optional
HttpPutResponseHopLimit	integer	No	Nota Este parámetro no está disponible para su uso.	3
SystemDisk.KMSKeyId	string	No	El ID de la clave de KMS del disco del sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
ImageOptions	object	No	La información de las propiedades relacionadas con la imagen.
LoginAsNonRoot	boolean	No	Especifica si las instancias que usan esta imagen admiten el inicio de sesión con el usuario ecs-user. Valores válidos: true: admitido. false: no admitido.	false
SecurityOptions	object	No	Las opciones de seguridad.
TrustedSystemMode	string	No	El modo de sistema de confianza. Establezca el valor en vTPM. Las siguientes familias de instancias admiten el modo de sistema de confianza: g7, c7 y r7. Familias de instancias con seguridad mejorada (g7t, c7t y r7t). Cuando crea instancias de ECS de las familias de instancias anteriores, debe configurar este parámetro. Tenga en cuenta los siguientes puntos: Para usar el sistema de confianza de Alibaba Cloud, establezca este parámetro en vTPM. Luego, el sistema de confianza de Alibaba Cloud realiza la verificación de confianza cuando se inicia la instancia. Si no desea usar el sistema de confianza de Alibaba Cloud, puede dejar este parámetro vacío. Sin embargo, si la instancia de ECS que crea utiliza el modo de computación confidencial basado en Enclave (SecurityOptions.ConfidentialComputingMode=Enclave), el sistema de confianza también se habilita para la instancia. Cuando crea una instancia de ECS de confianza mediante una operación de OpenAPI, solo puede usar RunInstances. CreateInstance no admite el parámetro SecurityOptions.TrustedSystemMode. Nota Si especifica una instancia como instancia de confianza durante la creación, solo puede reemplazar el disco del sistema con una imagen que admita el sistema de confianza. Para obtener más información sobre el sistema de confianza, consulte Descripción general de las funciones de confianza para instancias con seguridad mejorada.	vTPM
EnableSecureBoot	boolean	No

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
LaunchTemplateId	string	El ID de la plantilla de lanzamiento.	lt-m5eiaupmvm2op9d****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
LaunchTemplateVersionNumber	integer	El número de versión de la plantilla de lanzamiento.	20

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidRegion.NotExist	%s	The specified region does not exist.
400	MissingParameter	%s	A parameter is not specified.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidLaunchTemplateName.Malformed	The specified parameter LaunchTemplateName is not valid.	The specified LaunchTemplateName parameter is invalid.
400	InvalidDescription.Malformed	The specified parameter "VersionDescription" is not valid.
400	InvalidUserData.SizeExceeded	%s	The size of your specified user data exceeds the maximum allowed value.
400	InvalidUserData.Base64FormatInvalid	%s	The specified user data is invalid.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	The specified Tag.N.Key parameter is invalid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	The specified tag value is invalid.
400	InvalidHostName.Malformed	The specified parameter "HostName" is not valid.	The specified HostName parameter is invalid.
400	InvalidParams.CreateEniParams	%s
500	InternalError	The request processing has failed due to some unknown error.
403	LaunchTemplateLimitExceed	%s	The maximum number of launch templates has been reached.
403	LaunchTemplateName.Duplicated	%s	The specified launch template name already exists.
403	QuotaExceed.Tags	%s	The number of specified tags exceeds the upper limit. %s is a variable. An error message is dynamically returned based on call conditions.
403	InvalidOperation.InstanceTypeSecureBootUnsupported	The instance type does not support secure boot.	The instance type does not support secure boot.
403	InvalidOperation.SecureBootRegionNotSupported	Secure Boot is not available in the specified region.	The current region does not support enabling Secure Boot.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.