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

Crea una nueva versión en una plantilla de lanzamiento de ECS especificada para la creación posterior de instancias de ECS, grupos de escalado elástico o grupos de aprovisionamiento automático.

Descripción de la operación

Para modificar los parámetros de una versión específica, cree una nueva versión de la plantilla. Cada plantilla de lanzamiento de instancias admite un máximo de 30 versiones.

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

create

*LaunchTemplate

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

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
RegionId	string	Sí	El ID de la región. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
LaunchTemplateId	string	No	El ID de la plantilla de lanzamiento. Para obtener más información, llame a DescribeLaunchTemplates. Debe especificar `LaunchTemplateId` o `LaunchTemplateName` para determinar la plantilla de lanzamiento.	lt-m5eiaupmvm2op9d****
LaunchTemplateName	string	No	El nombre de la plantilla de lanzamiento. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` o `https://`. 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 entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`.	testVersionDescription
ImageId	string	No	El ID de la imagen utilizada para crear la instancia. 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. Nota Este parámetro quedará obsoleto. Para mejorar la compatibilidad, utilice otros parámetros.	system
PasswordInherit	boolean	No	Especifica si se debe utilizar la contraseña preestablecida de la imagen. Valores válidos: true false Valor predeterminado: false. Nota Cuando utilice este parámetro, el parámetro Password debe estar vacío. También debe asegurarse de que la imagen 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 llamar a DescribeInstanceTypes para consultar la lista de tipos de instancia más reciente.	ecs.g5.large
SecurityGroupId	string	No	El ID del security group al que pertenece la instancia creada mediante esta versión. Las instancias del mismo security group pueden comunicarse entre sí. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` simultáneamente.	sg-bp15ed6xe1yxeycg****
VpcId	string	No	El ID de la nube privada virtual (VPC) a la que pertenece la instancia.	vpc-bp12433upq1y5scen****
VSwitchId	string	No	El ID del vSwitch. Debe especificar este parámetro cuando crea una instancia conectada a una VPC.	vsw-bp1s5fnvk4gn2tws0****
InstanceName	string	No	El nombre de la instancia. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras, dígitos y caracteres de la categoría de letras Unicode (que incluye caracteres de varios idiomas). El nombre puede contener dos puntos (:), guiones bajos (_), puntos (.) y guiones (-). El valor predeterminado es el `InstanceId` de la instancia. Cuando crea varias instancias de ECS a la vez, puede configurar por lotes nombres secuenciales de instancias que contengan corchetes ([]) y comas (,). Para obtener más información, consulte Configurar por lotes nombres secuenciales o nombres de host para múltiples instancias.	k8s-node-[1,4]-alibabacloud
Description	string	No	La descripción de la instancia. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`.	testDescription
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 a 10 Mbit/s: 1 al valor de `InternetMaxBandwidthOut`. Valor predeterminado: el valor de `InternetMaxBandwidthOut`.	50
InternetMaxBandwidthOut	integer	No	El ancho de banda público de salida máximo. Unidad: Mbit/s. Valores válidos: 0 a 100.	5
HostName	string	No	El nombre de host del servidor de Elastic Compute Service (ECS). El nombre de host no puede comenzar ni terminar con un punto (.) o un guion (-), y no puede contener puntos o guiones consecutivos. Instancias Windows: El nombre de host debe tener entre 2 y 15 caracteres de longitud y no puede contener puntos (.) ni consistir completamente en dígitos. Puede contener letras, dígitos y guiones (-). Otras instancias (como Linux): El nombre de host debe tener entre 2 y 64 caracteres de longitud. Puede contener múltiples puntos (.), permitiendo cada segmento entre puntos 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_auto: disco ESSD AutoPL. cloud_essd: SSD empresarial (ESSD). Puede utilizar el parámetro `SystemDisk.PerformanceLevel` para configurar el nivel de rendimiento del disco. cloud_essd_entry: disco ESSD Entry. Para 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 discos: 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 entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` o `https://`. Puede contener dígitos, dos puntos (:), guiones bajos (_) y guiones (-).	cloud_ssdSystem
SystemDisk.Description	string	No	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://` o `https://`.	testSystemDiskDescription
SystemDisk.Iops	integer	No	Nota Este parámetro no está disponible públicamente.	30000
SystemDisk.PerformanceLevel	string	No	El nivel de rendimiento del ESSD utilizado como disco del sistema. Configure el nivel de rendimiento basándose en los siguientes 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 un nivel de rendimiento de ESSD, consulte ESSD.	PL0
SystemDisk.DeleteWithInstance	boolean	No	Especifica si se debe liberar el disco del sistema cuando se libera la instancia. Valores válidos: true: libera el disco del sistema cuando se libera la instancia. false: no libera el disco del sistema cuando se libera 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-bp1dgzpaxwc4load****
SystemDisk.ProvisionedIops	integer	No	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL utilizado como disco del sistema. 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: no habilita la función de ráfaga de rendimiento.	true
IoOptimized	string	No	Especifica si la instancia es una instancia optimizada para E/S. Valores válidos: none: La instancia no está optimizada para E/S. optimized: La instancia tiene habilitada la optimización 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 pago con 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 ancho de banda de salida a Internet. 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 pico de entrada y salida se utilizan como límites superiores de ancho de banda en lugar de especificaciones de rendimiento garantizado. Cuando ocurre contención de recursos, los anchos de banda pico pueden limitarse. Si desea un ancho de banda garantizado, utilice el modo de pago por ancho de banda.	PayByTraffic
EnableVmOsConfig	boolean	No	Especifica si se debe habilitar la configuración del sistema operativo de la instancia.	false
NetworkType	string	No	El tipo de red de la instancia. Valores válidos: vpc: VPC. classic: red clásica. La red clásica ha sido retirada. Para obtener más información, consulte Aviso de retiro.	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.	ZWNobyBoZWxsbyBl****
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 inicio de sesión basado en contraseña se deshabilita durante la inicialización.	testKeyPairName
RamRoleName	string	No	El nombre del rol RAM de la instancia. Puede llamar a la API de RAM ListRoles para consultar los roles RAM de instancia que ha creado.	testRamRoleName
AutoReleaseTime	string	No	La hora de liberación automática. Especifique la hora en formato estándar ISO 8601 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 al inicio del minuto actual (`mm`). La hora de liberación más temprana es 30 minutos después de la hora actual. La hora de liberación más tardía no puede superar los tres años a partir de la hora actual.	2018-01-01T12:05:00Z
SpotStrategy	string	No	La política de apropiación 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 se utiliza automáticamente el precio de mercado en el momento de la compra como precio de oferta.	NoSpot
SpotPriceLimit	number	No	El precio máximo por hora de la instancia. Se admiten hasta tres decimales.	0.97
SpotDuration	integer	No	El período 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 dentro de 1 hora. Una vez finalizado el período de protección de 1 hora, el sistema compara el precio de oferta con el precio de mercado y verifica el inventario de recursos para determinar si se debe conservar 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 verifica el inventario de recursos para determinar si se debe conservar 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. Le recomendamos seleccionar un período de protección adecuado según la duración esperada de ejecución de la tarea. Nota Este parámetro solo surte efecto cuando SpotStrategy se establece en SpotWithPriceLimit o SpotAsPriceGo.	1
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-bp67acfmxazb4p****
SecurityEnhancementStrategy	string	No	Especifica si se debe habilitar el endurecimiento de seguridad para el sistema operativo. Valores válidos: Active: habilita el endurecimiento de seguridad. Este valor solo es aplicable a imágenes públicas. Deactive: no habilita el endurecimiento de seguridad. Este valor es aplicable a todos los tipos de imágenes.	Active
PrivateIpAddress	string	No	La dirección IP privada de la instancia. Cuando especifica una dirección IP privada para una instancia de ECS conectada a una VPC, la dirección IP debe pertenecer al bloque CIDR libre del vSwitch (`VSwitchId`).	10.1..
Ipv6AddressCount	integer	No	El número de direcciones IPv6 para generar aleatoriamente para la ENI principal. Valores válidos: 1 a 10.	1
DeploymentSetId	string	No	El ID del conjunto de despliegue.	ds-bp1brhwhoqinyjd6****
DataDisk	array<object>	No	La lista de discos de datos.
	object	No	La lista 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`. Configure el nivel de rendimiento basándose en los siguientes 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 un nivel de rendimiento de ESSD, consulte ESSD.	PL1
Description	string	No	La descripción del disco de datos. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `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. Cuando se especifica `DataDisk.N.SnapshotId`, se ignora `DataDisk.N.Size`. El tamaño real del disco creado es el tamaño de la instantánea especificada. No se pueden utilizar instantáneas creadas el 15 de julio de 2013 o antes. Las solicitudes que utilicen dichas instantáneas serán rechazadas.	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 depende del 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. Las convenciones de nomenclatura para los puntos de montaje varían 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 nombra /dev/xvdaa, el disco de datos número 27 se nombra /dev/xvdab, y así sucesivamente. Nota Este parámetro solo es aplicable a escenarios de imagen completa (imagen del sistema). 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 entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con `http://` o `https://`. 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. 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 configura como 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 del valor predeterminado: Cuando 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: libera el disco de datos cuando se libera la instancia. false: no libera el disco de datos cuando se libera la instancia. Valor predeterminado: true.	true
Encrypted	string	No	Especifica si se debe cifrar el disco de datos.	false
ProvisionedIops	integer	No	Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL utilizado como disco del sistema. 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: no habilita la función de ráfaga de rendimiento.	true
AutoSnapshotPolicyId	string	No	El ID de la política de instantáneas automáticas aplicada al disco de datos.	sp-bp67acfmxazb4p****
KMSKeyId	string	No	El ID de clave KMS para el disco de datos.	0e478b7a-4262-4802-b8cb-00d****
NetworkInterface	array<object>	No	La información del controlador de interfaz de red (NIC).
	object	No	La información del controlador de interfaz de red (NIC).
VSwitchId	string	No	El ID del vSwitch al que pertenece el controlador de interfaz de red (NIC) secundario. La instancia y el NIC secundario deben estar en la misma VPC y en la misma zona activa, pero pueden pertenecer a diferentes vSwitches. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.	vsw-bp1s5fnvk4gn2tws0****
NetworkInterfaceName	string	No	El nombre del controlador de interfaz de red (NIC) secundario. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.	testNetworkInterfaceName
Description	string	No	La descripción del controlador de interfaz de red (NIC) secundario. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.	testNetworkInterfaceDescription
SecurityGroupId	string	No	El ID del security group al que pertenece el controlador de interfaz de red (NIC) secundario. El security group del NIC secundario debe pertenecer a la misma VPC que la instancia. El valor de N en `NetworkInterface.N` no puede ser mayor que 1. Nota No puede especificar `NetworkInterface.N.SecurityGroupId` y `NetworkInterface.N.SecurityGroupIds.N` simultáneamente.	sg-bp15ed6xe1yxeycg****
PrimaryIpAddress	string	No	La dirección IP privada principal del controlador de interfaz de red (NIC) secundario. El valor de N en `NetworkInterface.N` no puede ser mayor que 1.	192.168..
SecurityGroupIds	array	No	Los ID de uno o más security groups a los que pertenece el controlador de interfaz de red (NIC) secundario. Los security groups y el NIC secundario deben pertenecer a la misma VPC. Los valores válidos de N en `SecurityGroupIds.N` dependen de la cuota para el número máximo de security groups a los que puede pertenecer un NIC secundario. Para obtener más información, consulte Límites. El valor de N en `NetworkInterface.N` no puede ser mayor que 1. Nota No puede especificar `NetworkInterface.N.SecurityGroupId` y `NetworkInterface.N.SecurityGroupIds.N` simultáneamente.	sg-bp67acfmxazb4p****
	string	No	Los ID de uno o más security groups a los que pertenece el controlador de interfaz de red (NIC) secundario. Los security groups y el NIC secundario deben pertenecer a la misma VPC. Los valores válidos de N en `SecurityGroupIds.N` dependen de la cuota para el número máximo de security groups a los que puede pertenecer un NIC secundario. Para obtener más información, consulte Límites. El valor de N en `NetworkInterface.N` no puede ser mayor que 1. Nota No puede especificar `NetworkInterface.N.SecurityGroupId` y `NetworkInterface.N.SecurityGroupIds.N` simultáneamente.	sg-bp67acfmxazb4p****
InstanceType	string	No	El tipo de ENI. Valores válidos de N: 1 a 2. Si configura una ENI, puede configurar un controlador de interfaz de red (NIC) principal o una ENI secundaria. Si configura dos ENI, debe configurar un NIC principal y una ENI secundaria. Valores válidos: Primary: NIC 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 ENI secundarias.	true
Tag	array<object>	No	Las etiquetas de las instancias, discos y ENI principales creados mediante esta versión.
	object	No	Las etiquetas de las instancias, discos y ENI principales creados mediante esta versión.
Key	string	No	La clave de etiqueta de las instancias, discos y ENI principales creados mediante esta versión. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con aliyun o acs:. No puede contener http:// o https://.	TestKey
Value	string	No	El valor de etiqueta de las instancias, discos y ENI principales creados mediante esta versión. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener http:// o https://.	TestValue
SecurityGroupIds	array	No	Los ID de uno o más security groups a los que pertenece la instancia. Los valores válidos de N dependen del número máximo de security groups a los que puede pertenecer una instancia. Para obtener más información, consulte Límites. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` simultáneamente.	sg-bp15ed6xe1yxeycg7****
	string	No	Los ID de uno o más security groups a los que pertenece la instancia. Los valores válidos de N dependen del número máximo de security groups a los que puede pertenecer una instancia. Para obtener más información, consulte Límites. Nota No puede especificar `SecurityGroupId` y `SecurityGroupIds.N` simultáneamente.	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 El cifrado del disco del sistema no es compatible con la zona D de la región China (Hong Kong) ni con la zona A de la región Singapur 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 o mediante la llamada a DeleteInstance. Valores válidos: true: habilita la protección contra liberación. false: deshabilita la protección contra liberación. Valor predeterminado: false. Nota Este atributo solo es aplicable a instancias de pago por uso. Solo puede restringir las operaciones de liberación manual y no surte efecto en 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 instancias ampliables. Unlimited: modo ilimitado. Para obtener más información, consulte la sección de modo ilimitado en Descripción general de instancias ampliables.	Standard
AutoRenew	boolean	No	Especifica si se debe habilitar la renovación automática. Este parámetro solo surte efecto cuando `InstanceChargeType` está establecido en `PrePaid`. Valores válidos: true: habilita la renovación automática. false: no habilita la renovación automática. Valor predeterminado: false.	true
AutoRenewPeriod	integer	No	El período de renovación automática. Valores válidos: Si PeriodUnit está establecido en Month: 1, 2, 3, 6, 12, 24, 36, 48 y 60. Valor predeterminado: 1.	1
PeriodUnit	string	No	La unidad de la duración de la 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 instancias de ECS.	enabled
HttpTokens	string	No	Especifica si se debe forzar el uso del modo de seguridad reforzada (IMDSv2) para acceder a los metadatos de la instancia. Valores válidos: optional: no fuerza el uso del modo de seguridad reforzada. required: fuerza el uso del modo de seguridad reforzada. Después de establecer este valor, no se puede utilizar el modo normal para acceder a los metadatos de la instancia. 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 instancias de ECS.	optional
HttpPutResponseHopLimit	integer	No	Nota Este parámetro no está disponible públicamente.	3
SystemDisk.KMSKeyId	string	No	El ID de clave KMS del disco del sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
ImageOptions	object	No	La información de propiedades relacionadas con la imagen.
LoginAsNonRoot	boolean	No	Especifica si las instancias que utilizan esta imagen admiten el inicio de sesión con el usuario ecs-user. Valores válidos: true: compatible. false: no compatible.	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. Familia de instancias con seguridad mejorada (g7t, c7t y r7t). Al crear instancias de ECS de las familias anteriores, debe configurar este parámetro. Detalles: Para utilizar el Sistema de Confianza de Alibaba Cloud, establezca este parámetro en vTPM. La verificación de confianza la realiza el Sistema de Confianza de Alibaba Cloud cuando se inicia la instancia. Si no utiliza 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. Al crear una instancia de ECS de confianza mediante una operación de API, solo puede invocar `RunInstances`. `CreateInstance` no admite la configuración del parámetro `SecurityOptions.TrustedSystemMode`. Nota Si especifica una instancia como instancia de confianza durante la creación, solo puede utilizar imágenes compatibles con el sistema de confianza al reemplazar el disco del sistema. 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

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
LaunchTemplateVersionNumber	integer	El número de versión de la plantilla de lanzamiento que se crea.	2
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DEX****
LaunchTemplateId	string	El ID de la plantilla de lanzamiento. Para obtener más información, consulte DescribeLaunchTemplates. Cuando utiliza una plantilla de lanzamiento para crear una instancia, debe especificar `LaunchTemplateId` o `LaunchTemplateName` para determinar la plantilla de lanzamiento.	lt-bp1apo0bbbkuy0rj****

Ejemplos

Respuesta exitosa

JSON Formato

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

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	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	The source description can be 2 to 256 characters in length. It cannot start with http:// and https://.
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	InvalidHostName.Malformed	The specified parameter "HostName" is not valid.	The specified parameter HostName is invalid.
400	InvalidParams.CreateEniParams	%s
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
500	InternalError	The request processing has failed due to some unknown error.
403	LaunchTemplateVersionLimitExceed	%s	The maximum number of launch template versions has been reached.
404	InvalidLaunchTemplate.NotFound	%s	The specified launch template does not exist. Check whether the parameter value is correct.
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.