Crea una versión para una plantilla de lanzamiento.
Notas de uso
Si desea modificar los parámetros de una versión de plantilla de lanzamiento, puede crear otra versión con ajustes de parámetros diferentes para dicha plantilla. Se pueden crear hasta 30 versiones por cada plantilla de lanzamiento.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
| Action | String | Sí | CreateLaunchTemplateVersion |
La operación que se va a ejecutar. Establezca el valor en CreateLaunchTemplateVersion. |
| 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. |
| LaunchTemplateId | String | No | lt-m5eiaupmvm2op9d**** |
El ID de la plantilla de lanzamiento. Para obtener más información, llame a la operación DescribeLaunchTemplates. Debe especificar |
| LaunchTemplateName | String | No | testLaunchTemplateName |
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 empezar con |
| 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 |
| ImageId | String | No | win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd |
El ID de la imagen que desea utilizar para crear instancias de Elastic Compute Service (ECS). Puede llamar a la operación DescribeImages para consultar las imágenes disponibles. |
| ImageOwnerAlias | String | No | system |
El origen de la imagen. Nota Este parámetro se eliminará en el futuro. Le recomendamos usar otros parámetros para garantizar la compatibilidad futura. |
| PasswordInherit | Boolean | No | false |
Especifica si se debe usar la contraseña preestablecida en la imagen. Valores válidos:
Valor predeterminado: false. Nota Si se especifica PasswordInherit, debe dejar Password vacío y asegúrese de que la imagen seleccionada tenga una contraseña preestablecida. |
| InstanceType | String | No | ecs.g5.large |
El tipo de instancia. Para obtener más información, consulte Overview of instance families o llame 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 se asignará la instancia. Las instancias dentro del mismo security group pueden comunicarse entre sí. Nota No puede especificar simultáneamente SecurityGroupId y SecurityGroupIds.N. |
| 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 y no puede empezar con |
| Description | String | No | testDescription |
La descripción de la instancia. La descripción debe tener entre 2 y 256 caracteres de longitud, y no puede comenzar con |
| InternetMaxBandwidthIn | Integer | No | 50 |
El ancho de banda público entrante máximo. Unidad: Mbit/s. Valores válidos:
|
| InternetMaxBandwidthOut | Integer | No | 5 |
El ancho de banda público saliente máximo. Unidad: Mbit/s. Valores válidos: 0 a 100. |
| HostName | String | No | testHostName |
El nombre de host de la instancia.
|
| ZoneId | String | No | cn-hangzhou-g |
El ID de la zona donde desea crear la instancia. |
| SystemDisk.Category | String | No | cloud_ssd |
La categoría del disco del sistema. Valores válidos:
Para instancias no optimizadas para E/S de un tipo de instancia retirado, el valor predeterminado es cloud. Para instancias de otros tipos, 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 | cloud_ssdSystem |
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 empezar con |
| 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 |
| SystemDisk.Iops | Integer | No | 30000 |
Nota Este parámetro no está disponible públicamente. |
| SystemDisk.PerformanceLevel | String | No | PL0 |
El nivel de rendimiento del ESSD que se usará como disco del sistema. Valores válidos:
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:
Valor predeterminado: true. |
| SystemDisk.AutoSnapshotPolicyId | String | No | sp-bp1dgzpaxwc4load**** |
El ID de la directiva de instantánea automática que se aplicará al disco del sistema. |
| SystemDisk.ProvisionedIops | Long | No | 50000 |
Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL que se usará como disco de datos N. Valores válidos: 0 a min{50 000, 1 000 × Capacidad - Rendimiento base} Rendimiento base = min{1 800 + 50 × Capacidad, 50 000} Nota Este parámetro solo está disponible si el parámetro DataDisk.N.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:
|
| IoOptimized | String | No | optimized |
Especifica si la instancia está optimizada para E/S. Valores válidos:
|
| InstanceChargeType | String | No | PrePaid |
El método de facturación de la instancia. Valores válidos:
|
| Period | Integer | No | 1 |
La duración de la suscripción de la instancia. Unidad: mes. Este parámetro es válido y obligatorio solo cuando |
| InternetChargeType | String | No | PayByTraffic |
El método de facturación para el uso de red. Valores válidos:
Nota Cuando se utiliza el método de facturación pay-by-traffic para el uso de red, los anchos de banda entrantes y salientes máximos funcionan como límites superiores y no como especificaciones de rendimiento garantizado. En escenarios donde la demanda supera la oferta de recursos, los valores de ancho de banda máximo podrían verse limitados. Si requiere ancho de banda garantizado para sus instancias, utilice el método de facturación pay-by-bandwidth. |
| EnableVmOsConfig | Boolean | No | false |
Especifica si se debe habilitar la configuración del sistema operativo de la instancia. |
| NetworkType | String | No | vpc |
El tipo de red de la instancia. Valores válidos:
|
| UserData | String | No | ZWNobyBoZWxsbyBl**** |
Los datos de usuario de la instancia. Deben estar codificados 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.
|
| 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 siguiendo el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.
|
| SpotStrategy | String | No | NoSpot |
La directiva de apropiación para la instancia pay-as-you-go. Este parámetro solo surte efecto cuando
|
| SpotPriceLimit | Float | No | 0.97 |
El precio máximo por hora de la preemptible instance. Se permiten hasta tres decimales. |
| SpotDuration | Integer | No | 1 |
El periodo de protección de la preemptible instance. Unidad: horas. Valor predeterminado: 1. Valores válidos:
Alibaba Cloud envía un evento del sistema ECS para notificarle 5 minutos antes de que se libere la instancia. Las preemptible instances se facturan por segundo. Le recomendamos especificar un periodo de protección adecuado según sus necesidades comerciales. Nota Si establece SpotStrategy en SpotWithPriceLimit o SpotAsPriceGo, este parámetro surte efecto. |
| ResourceGroupId | String | No | rg-bp67acfmxazb4p**** |
El ID del resource group. |
| SecurityEnhancementStrategy | String | No | Active |
Especifica si se debe habilitar el reforzamiento de seguridad para el sistema operativo. Valores válidos:
|
| PrivateIpAddress | String | No | 10.1.**.** |
La dirección IP privada que se asignará a la instancia. Para asignar una dirección IP privada a una instancia residente en una VPC, asegúrese de que sea una dirección IP libre dentro del bloque CIDR del vSwitch especificado mediante |
| Ipv6AddressCount | Integer | No | 1 |
El número de direcciones IPv6 que se generarán aleatoriamente para la interfaz de red elástica (ENI) principal. Valores válidos: 1 a 10. |
| DeploymentSetId | String | No | ds-bp1brhwhoqinyjd6**** |
El ID del conjunto de despliegue donde se desplegará la instancia. |
| DataDisk.N.PerformanceLevel | String | No | PL1 |
El nivel de rendimiento del ESSD que se usará como disco de datos N. El valor de N debe coincidir con el de
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 |
| 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 se especifica Utilice instantáneas creadas después del 15 de julio de 2013. De lo contrario, se devolverá un error y se rechazará su solicitud. |
| 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:
El valor de este parámetro debe ser mayor o igual al tamaño de la instantánea especificada mediante |
| DataDisk.N.Device | String | No | null |
Nota Este parámetro se eliminará en el futuro. Le recomendamos usar 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 y no puede empezar con |
| DataDisk.N.Category | String | No | cloud_ssd |
La categoría del disco de datos N. Valores válidos:
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:
Valor predeterminado: true. |
| DataDisk.N.Encrypted | String | No | false |
Especifica si se debe cifrar el disco de datos N. |
| DataDisk.N.ProvisionedIops | Long | No | 50000 |
Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL que se usará como disco de datos N. Valores válidos: 0 a min{50 000, 1 000 × Capacidad - Rendimiento base} Rendimiento base = min{1 800 + 50 × Capacidad, 50 000} Nota Este parámetro solo está disponible si el parámetro DataDisk.N.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. |
| DataDisk.N.BurstingEnabled | Boolean | No | true |
Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos:
|
| DataDisk.N.AutoSnapshotPolicyId | String | No | sp-bp67acfmxazb4p**** |
El ID de la directiva de instantánea automática que se aplicará al disco de datos N. |
| NetworkInterface.N.VSwitchId | String | No | vsw-bp1s5fnvk4gn2tws0**** |
El ID del vSwitch al que desea conectar la ENI secundaria. La instancia y la ENI secundaria deben residir en la misma zona de la misma VPC, pero pueden conectarse a diferentes vSwitches. El valor de N en |
| NetworkInterface.N.NetworkInterfaceName | String | No | testNetworkInterfaceName |
El nombre de la ENI secundaria. El valor de N en |
| NetworkInterface.N.Description | String | No | testNetworkInterfaceDescription |
La descripción de la ENI secundaria. La descripción debe tener entre 2 y 256 caracteres de longitud, y no puede comenzar con |
| NetworkInterface.N.SecurityGroupId | String | No | sg-bp15ed6xe1yxeycg**** |
El ID del security group al que desea asignar la ENI secundaria. Los security groups de la ENI secundaria y de la instancia deben pertenecer a la misma VPC. El valor de N en Nota No puede especificar simultáneamente NetworkInterface.N.SecurityGroupId y NetworkInterface.N.SecurityGroupIds.N. |
| NetworkInterface.N.PrimaryIpAddress | String | No | 192.168.**.** |
La dirección IP privada principal de la ENI secundaria. El valor de N en |
| NetworkInterface.N.SecurityGroupIds.N | String | No | sg-bp67acfmxazb4p**** |
El ID del security group N al que desea asignar la ENI secundaria. El security group y la ENI secundaria deben pertenecer a la misma VPC. Los valores válidos de N en Nota No puede especificar simultáneamente NetworkInterface.N.SecurityGroupId y NetworkInterface.N.SecurityGroupIds.N. |
| 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 configurar una ENI principal o una ENI secundaria. Si el valor de N es 2, puede configurar tanto una ENI principal como una secundaria. Valores válidos:
Valor predeterminado: Secondary. |
| NetworkInterface.N.NetworkInterfaceTrafficMode | String | No | Standard |
El modo de comunicación de la ENI principal. Valores válidos:
|
| Tag.N.Key | String | No | TestKey |
La clave de la etiqueta N que se agregará a la instancia, a dispositivos Elastic Block Storage (EBS) o a la ENI principal. Valores válidos de N: 1 a 5. La clave de etiqueta no puede ser una cadena vacía. Puede tener hasta 64 caracteres de longitud y no puede comenzar con |
| Tag.N.Value | String | No | TestValue |
El valor de la etiqueta N que se agregará a la instancia, a dispositivos EBS o a la ENI principal. Valores válidos de N: 1 a 5. El valor de la etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con |
| SecurityGroupIds.N | String | No | sg-bp15ed6xe1yxeycg7**** |
El ID del security group N al que desea asignar 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 Limits. Nota No puede especificar simultáneamente SecurityGroupId y SecurityGroupIds.N. |
| SystemDisk.Encrypted | String | No | false |
Especifica si se debe cifrar el disco del sistema. Valores válidos:
Valor predeterminado: false. Nota Al crear instancias en Hong Kong Zone D o Singapore Zone A, no es posible 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 usar la consola ECS o llamar a la operación DeleteInstance para liberar la instancia. Valores válidos:
Valor predeterminado: false. Nota Este parámetro solo aplica a instancias pay-as-you-go. Protege las instancias contra liberaciones manuales, pero no contra liberaciones automáticas. |
| CreditSpecification | String | No | Standard |
El modo de rendimiento de la instancia ampliable. Valores válidos:
|
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
LaunchTemplateVersionNumber |
Long |
2 |
El número de versión de la plantilla de lanzamiento. |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DEX**** |
El ID de la solicitud. |
|
LaunchTemplateId |
String |
lt-bp1apo0bbbkuy0rj**** |
El ID de la plantilla de lanzamiento. Para obtener más información, consulte DescribeLaunchTemplates. Debe especificar LaunchTemplateId o LaunchTemplateName para identificar una plantilla de lanzamiento. |
Ejemplos
Solicitudes de ejemplo
http(s)://ecs.aliyuncs.com/?Action=CreateLaunchTemplateVersion
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-m5eiaupmvm2op9d****
&LaunchTemplateName=testLaunchTemplateName
&VersionDescription=testVersionDescription
&ImageId=win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
&InstanceType=ecs.g5.large
&SecurityGroupId=sg-bp15ed6xe1yxeycg****
&VpcId=vpc-bp12433upq1y5scen****
&VSwitchId=vsw-bp1s5fnvk4gn2tws0****
&InstanceName=testInstanceName
&Description=testDescription
&InternetMaxBandwidthIn=50
&InternetMaxBandwidthOut=5
&HostName=testHostName
&ZoneId=cn-hangzhou-g
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=40
&SystemDisk.DiskName=testSystemDiskName
&SystemDisk.Description=testSystemDiskDescription
&DataDisk.1.Size=2000
&DataDisk.1.SnapshotId=s-bp17441ohwka0yuh****
&DataDisk.1.Category=cloud_ssd
&DataDisk.1.Encrypted=false
&DataDisk.1.DiskName=cloud_ssdData
&DataDisk.1.Description=testDataDiskDescription
&DataDisk.1.DeleteWithInstance=true
&IoOptimized=optimized
&NetworkInterface.1.PrimaryIpAddress=192.168.**.**
&NetworkInterface.1.VSwitchId=vsw-bp1s5fnvk4gn2tws0****
&NetworkInterface.1.SecurityGroupId=sg-bp15ed6xe1yxeycg****
&NetworkInterface.1.NetworkInterfaceName=testNetworkInterfaceName
&NetworkInterface.1.Description=testNetworkInterfaceDescription
&PrivateIpAddress=10.1.**.**
&InstanceChargeType=PrePaid
&Period=1
&InternetChargeType=PayByTraffic
&NetworkType=vpc
&UserData=ZWNobyBoZWxsbyBl****
&RamRoleName=testRamRoleName
&AutoReleaseTime=2020-02-02T12:05:00Z
&SpotStrategy=NoSpot
&SpotPriceLimit=0.97
&SecurityEnhancementStrategy=Active
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>
Respuestas exitosas de ejemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateLaunchTemplateVersionResponse>
<LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DEX****</RequestId>
<LaunchTemplateId>lt-bp1apo0bbbkuy0rj****</LaunchTemplateId>
</CreateLaunchTemplateVersionResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"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 |
No se encontró la región especificada. |
|
400 |
MissingParameter |
%s |
No se especificó un parámetro obligatorio. |
|
400 |
InvalidParameter |
%s |
Valor de parámetro no válido. |
|
400 |
InvalidDescription.Malformed |
The specified parameter "Description" is not valid. |
Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://. |
|
400 |
InvalidUserData.SizeExceeded |
%s |
Se excedió el tamaño máximo de los datos de usuario especificados. |
|
400 |
InvalidUserData.Base64FormatInvalid |
%s |
Formato de UserData no válido. |
|
400 |
Duplicate.TagKey |
The Tag.N.Key contain duplicate key. |
La clave de etiqueta ya existe. Las claves de etiqueta deben ser únicas. |
|
403 |
LaunchTemplateVersionLimitExceed |
%s |
Se excedió el número máximo de versiones de plantilla de lanzamiento. |
|
404 |
InvalidLaunchTemplate.NotFound |
%s |
No se encontró la plantilla de lanzamiento especificada. Compruebe si el valor del parámetro es correcto. |
|
404 |
InvalidResourceGroup.NotFound |
The ResourceGroup provided does not exist in our records. |
No se encontró el resource group. |
|
500 |
InternalError |
The request processing has failed due to some unknown error. |
Ocurrió un error interno. Inténtelo de nuevo más tarde. |
Para consultar una lista de códigos de error, visite Códigos de error del servicio.