Consulta información sobre las versiones de la plantilla de lanzamiento de instancias de ECS, como el número total de plantillas de lanzamiento de instancias, los nombres de plantilla y los números de versión de plantilla.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
ecs:DescribeLaunchTemplateVersions |
list |
LaunchTemplate.
LaunchTemplate.
|
Ninguna | Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| RegionId |
string |
Sí |
El ID de la región de la plantilla de lanzamiento. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente. |
cn-hangzhou |
| LaunchTemplateVersion |
array |
No |
Uno o más números de versión de la plantilla de lanzamiento. |
1 |
|
integer |
No |
Uno o más números de versión de la plantilla de lanzamiento. |
1 |
|
| LaunchTemplateId |
string |
No |
El ID de la plantilla de lanzamiento. Debe especificar LaunchTemplateId o LaunchTemplateName para determinar la plantilla. |
lt-bp168lnahrdwl39p**** |
| LaunchTemplateName |
string |
No |
El nombre de la plantilla de lanzamiento. Debe especificar LaunchTemplateId o LaunchTemplateName para determinar la plantilla. |
testLaunchTemplateName |
| MinVersion |
integer |
No |
El número de versión mínimo que se utiliza para filtrar los resultados de la consulta. Se utiliza junto con MaxVersion para consultar la información de las versiones dentro del rango comprendido entre los números de versión mínimo y máximo. |
1 |
| MaxVersion |
integer |
No |
El número de versión máximo que se utiliza para filtrar los resultados de la consulta. Se utiliza junto con MinVersion para consultar la información de las versiones dentro del rango comprendido entre los números de versión mínimo y máximo. |
10 |
| DefaultVersion |
boolean |
No |
Especifica si se debe consultar la versión predeterminada. |
true |
| DetailFlag |
boolean |
No |
Especifica si se debe consultar la información detallada de configuración de la plantilla. Valores válidos:
Valor predeterminado: true. |
true |
| PageNumber |
integer |
No |
El número de página de la lista de plantillas de lanzamiento. Valor mínimo: 1. Valor predeterminado: 1. |
1 |
| PageSize |
integer |
No |
El número de entradas por página en una consulta paginada. Establece el número de filas por página para las consultas paginadas. Valor predeterminado: 10. |
10 |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
El conjunto de información de versiones. |
||
| PageSize |
integer |
El número de entradas por página. Este valor se establece para las consultas de paginación. |
10 |
| RequestId |
string |
El ID de la solicitud. |
3989ED0C-20A1-4351-A127-2067FF8390AX |
| PageNumber |
integer |
El número de página actual. |
1 |
| TotalCount |
integer |
El número total de plantillas de lanzamiento. |
1 |
| LaunchTemplateVersionSets |
object |
||
| LaunchTemplateVersionSet |
array<object> |
La información sobre las versiones de la plantilla. |
|
|
array<object> |
La información sobre las versiones de la plantilla. |
||
| LaunchTemplateName |
string |
El nombre de la plantilla. |
testLaunchTemplateName |
| DefaultVersion |
boolean |
Indica si la plantilla es la versión predeterminada. |
true |
| VersionNumber |
integer |
El número de versión de la plantilla. |
1 |
| ModifiedTime |
string |
La hora en que se modificó la plantilla. La hora se muestra en formato ISO 8601 en UTC. |
2022-01-17T08:40:00Z |
| LaunchTemplateId |
string |
El ID de la plantilla. |
lt-bp67acfmxazb4p**** |
| CreateTime |
string |
La hora en que se creó la plantilla. La hora se muestra en formato ISO 8601 en UTC. |
2022-01-17T08:22:43Z |
| CreatedBy |
string |
El creador de la plantilla, que es el ID de la cuenta de Alibaba Cloud. |
123456789**** |
| VersionDescription |
string |
La descripción de la versión de la plantilla. |
testVersionDescription |
| LaunchTemplateData |
object |
Las configuraciones específicas de la plantilla. |
|
| DeploymentSetId |
string |
El ID del conjunto de despliegue. |
ds-bp1brhwhoqinyjd6**** |
| VpcId |
string |
El ID de la VPC. |
v-bp67acfmxazb4p**** |
| SystemDisk.PerformanceLevel |
string |
La configuración del nivel de rendimiento (PL) para el disco SSD empresarial (ESSD) utilizado como disco del sistema. Valores válidos:
Para obtener más información sobre cómo seleccionar un nivel de rendimiento de ESSD, consulte ESSD. |
PL0 |
| KeyPairName |
string |
El nombre del par de claves. |
testKeyPairName |
| SecurityGroupId |
string |
El ID del grupo de seguridad de la instancia. Nota
|
sg-bp67acfmxazb4p**** |
| NetworkType |
string |
El tipo de red. Valores válidos:
|
vpc |
| SpotStrategy |
string |
La política de puja para instancias de pago por uso. Valores válidos:
|
NoSpot |
| EnableVmOsConfig |
boolean |
Indica si la configuración del sistema operativo de la instancia está habilitada. |
false |
| Description |
string |
La descripción de la instancia. |
testInstanceDescription |
| SpotDuration |
integer |
El período de protección de la instancia spot. Unidad: horas. Valores válidos:
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 período de protección adecuado según la duración esperada de la ejecución de la tarea. Nota
Este parámetro solo se devuelve cuando SpotStrategy se establece en SpotWithPriceLimit o SpotAsPriceGo. |
1 |
| InstanceName |
string |
El nombre de la instancia. |
testInstanceName |
| SecurityEnhancementStrategy |
string |
Especifica si la mejora de seguridad está habilitada. |
active |
| UserData |
string |
Los datos de usuario de la instancia, que están codificados en Base64. |
SGVsbG9FQ1M= |
| SystemDisk.DiskName |
string |
El nombre del disco del sistema. |
testSystemDiskName |
| SystemDisk.Size |
integer |
El tamaño del disco del sistema. Unidad: GiB. |
40 |
| SpotPriceLimit |
number |
El precio máximo por hora de la instancia. |
0.98 |
| PasswordInherit |
boolean |
Indica si se hereda el par de nombre de usuario y contraseña preestablecido en la imagen. |
true |
| PrivateIpAddress |
string |
La dirección IP privada de la instancia. |
10.1.**.** |
| ImageId |
string |
El ID de la imagen utilizada por la instancia. |
m-bp67acfmxazb4p**** |
| SystemDisk.DeleteWithInstance |
boolean |
Indica si el disco del sistema se libera cuando se libera la instancia. Valores válidos:
|
true |
| SystemDisk.Category |
string |
La categoría del disco del sistema. Valores válidos:
Para los tipos de instancia retirados que no son instancias con optimización de E/S, el valor predeterminado es cloud. Para otros tipos de instancia, el valor predeterminado es cloud_efficiency. |
cloud_ssd |
| AutoReleaseTime |
string |
La hora de liberación automática. La hora se muestra en formato ISO 8601 en UTC. |
2018-05-14T14:18:00Z |
| SystemDisk.Description |
string |
La descripción del disco del sistema. |
testSystemDiskDescription |
| ImageOwnerAlias |
string |
El origen de la imagen. Valores válidos:
|
system |
| HostName |
string |
El nombre de host de la instancia. |
testHostName |
| SystemDisk.Iops |
integer |
Las IOPS totales del disco del sistema. |
101800 |
| SystemDisk.AutoSnapshotPolicyId |
string |
El ID de la política de instantáneas automáticas. |
sp-bp1j0alc2z1fhvie**** |
| InternetMaxBandwidthOut |
integer |
El ancho de banda público de salida máximo. |
100 |
| InternetMaxBandwidthIn |
integer |
El ancho de banda público de entrada máximo. |
5 |
| InstanceType |
string |
El tipo de instancia. |
ecs.g5.large |
| Period |
integer |
La duración del recurso comprado. |
1 |
| InstanceChargeType |
string |
El método de facturación de la instancia. Valores válidos:
|
Postpaid |
| IoOptimized |
string |
Indica si la instancia es una instancia con optimización de E/S. |
none |
| RamRoleName |
string |
El nombre del rol de RAM de la instancia. |
testRamRoleName |
| VSwitchId |
string |
El ID del vSwitch al que pertenece la instancia. |
vsw-bp67acfmxazb4p**** |
| ResourceGroupId |
string |
El ID del grupo de recursos al que pertenece la plantilla de lanzamiento. |
rg-bp67acfmxazb4p**** |
| InternetChargeType |
string |
Los métodos de facturación para el ancho de banda público. |
PayByTraffic |
| ZoneId |
string |
El ID de la zona. |
cn-hangzhou-g |
| Ipv6AddressCount |
integer |
El número de direcciones IPv6 asignadas a la instancia. |
1 |
| DataDisks |
object |
||
| DataDisk |
array<object> |
El conjunto de discos de datos. |
|
|
object |
El conjunto de discos de datos. |
||
| PerformanceLevel |
string |
La configuración del nivel de rendimiento (PL) para el disco SSD empresarial utilizado como disco de datos. Este parámetro solo se devuelve cuando Category=cloud_essd. Valores válidos:
|
PL1 |
| Description |
string |
La descripción del disco de datos. |
testDiskDescription |
| SnapshotId |
string |
El ID de la instantánea utilizada por el disco de datos. |
s-bp67acfmxazb4p**** |
| Device |
string |
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:
Nota
Este parámetro solo se utiliza para imágenes completas (imágenes 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 |
| Size |
integer |
El tamaño del disco de datos. |
2000 |
| DiskName |
string |
El nombre del disco de datos. |
testDiskName |
| Category |
string |
La categoría del disco de datos N. Valores válidos:
Para instancias con optimización de E/S, el valor predeterminado es cloud_efficiency. Para instancias sin optimización de E/S, el valor predeterminado es cloud. Descripción del valor predeterminado:
|
cloud_ssd |
| DeleteWithInstance |
boolean |
Indica si el disco de datos se libera cuando se libera la instancia. |
true |
| Encrypted |
string |
Indica si el disco de datos está cifrado. |
false |
| ProvisionedIops |
integer |
Especifica si se modifican las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline performance}. Baseline performance = min{1,800 + 50 × Capacity, 50,000} Nota
Este parámetro solo es compatible cuando DiskCategory se establece en cloud_auto. Para obtener más información, consulte Disco ESSD AutoPL y Modificar el rendimiento aprovisionado de un disco ESSD AutoPL. |
50000 |
| BurstingEnabled |
boolean |
Indica si la función de ráfaga de rendimiento está habilitada. Valores válidos:
|
true |
| AutoSnapshotPolicyId |
string |
El ID de la política de instantáneas automáticas. |
sp-wz91dz3ghear2a5s**** |
| KMSKeyId |
string |
El ID de la clave de Key Management Service (KMS) del disco de datos. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| NetworkInterfaces |
object |
||
| NetworkInterface |
array<object> |
El conjunto de configuraciones de propiedades para las interfaces de red (NIC) secundarias. |
|
|
array<object> |
El conjunto de configuraciones de propiedades para las interfaces de red (NIC) secundarias. |
||
| NetworkInterfaceName |
string |
El nombre de la interfaz de red (NIC) secundaria. |
testNetworkInterfaceName |
| VSwitchId |
string |
El ID del vSwitch al que pertenece la interfaz de red (NIC). |
vsw-bp67acfmxazb4p**** |
| Description |
string |
La descripción de la interfaz de red (NIC) secundaria. |
testNetworkInterfacesDescription |
| PrimaryIpAddress |
string |
La dirección IP privada principal de la interfaz de red (NIC) secundaria. |
203.0.*.* |
| SecurityGroupId |
string |
El ID del grupo de seguridad de la interfaz de red (NIC) secundaria. El grupo de seguridad debe pertenecer a la misma VPC. Nota
SecurityGroupId y SecurityGroupIds no se devuelven al mismo tiempo. |
sg-bp67acfmxazb4p**** |
| SecurityGroupIds |
object |
||
| SecurityGroupId |
array |
Uno o más grupos de seguridad a los que pertenece la interfaz de red (NIC) secundaria. Nota
SecurityGroupId y SecurityGroupIds no se devuelven al mismo tiempo. |
|
|
string |
Uno o más grupos de seguridad a los que pertenece la interfaz de red (NIC) secundaria. Nota
SecurityGroupId y SecurityGroupIds no se devuelven al mismo tiempo. |
["sg-bp15ed6xe1yxeycg7****"] |
|
| InstanceType |
string |
El tipo de instancia. |
ecs.s2.xlarge |
| NetworkInterfaceTrafficMode |
string |
El modo de comunicación de la ENI principal. Valores válidos:
|
Standard |
| DeleteOnRelease |
boolean |
Indica si la ENI se conserva cuando se libera la instancia. Valores válidos:
|
true |
| Tags |
object |
||
| InstanceTag |
array<object> |
Las etiquetas de la instancia. |
|
|
object |
Las etiquetas de la instancia. |
||
| Key |
string |
La clave de la etiqueta de la instancia. |
TestKey |
| Value |
string |
El valor de la etiqueta de la instancia. |
TestValue |
| SecurityGroupIds |
object |
||
| SecurityGroupId |
array |
Los ID de los grupos de seguridad a los que pertenece la instancia. Nota
SecurityGroupId y SecurityGroupIds no se devuelven al mismo tiempo. |
|
|
string |
Los ID de los grupos de seguridad a los que pertenece la instancia. Nota
SecurityGroupId y SecurityGroupIds no se devuelven al mismo tiempo. |
["sg-bp15ed6xe1yxeycg7****"] |
|
| SystemDisk.ProvisionedIops |
integer |
Las IOPS de lectura y escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: de 0 a min{50,000, 1,000 × Capacidad - Rendimiento de referencia}. Rendimiento de referencia = min{1,800 + 50 × Capacidad, 50,000} Nota
Este parámetro solo es compatible 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 |
Indica si la función de ráfaga de rendimiento está habilitada. Valores válidos:
|
true |
| SystemDisk.Encrypted |
string |
Indica si el disco del sistema está cifrado. Valores válidos:
Valor predeterminado: false. Nota
La zona D de Hong Kong (China) y la zona A de Singapur no admiten el cifrado del disco del sistema al crear una instancia. |
false |
| DeletionProtection |
boolean |
El atributo de protección contra liberación de la instancia. Este parámetro especifica si la instancia se puede liberar desde la consola de ECS o al llamar a la operación DeleteInstance. Valores válidos:
Valor predeterminado: false. Nota
Este atributo solo se aplica a las instancias de pago por uso. Solo puede evitar la liberación manual, no la liberación iniciada por el sistema. |
false |
| CreditSpecification |
string |
El modo de rendimiento de la instancia ampliable. Valores válidos:
|
Standard |
| AutoRenew |
boolean |
Indica si la renovación automática está habilitada. Este parámetro solo surte efecto cuando InstanceChargeType se establece en PrePaid. Valores válidos:
Valor predeterminado: false. |
true |
| AutoRenewPeriod |
integer |
El periodo de renovación automática. 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 |
La unidad del periodo de los métodos de facturación por suscripción. Valores válidos: Month (valor predeterminado). |
Month |
| HttpEndpoint |
string |
Indica si el canal de acceso para los metadatos de la instancia está habilitado. Valores válidos:
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 |
Especifica si se requiere el modo reforzado (IMDSv2) al acceder a los metadatos de la instancia. Valores válidos:
Valor predeterminado: optional. Nota
Para obtener más información sobre los patrones para acceder a los metadatos de la instancia, consulte Descripción general de los metadatos de la instancia. |
optional |
| HttpPutResponseHopLimit |
integer |
Nota
Este parámetro no está disponible para su uso. |
3 |
| SystemDisk.KMSKeyId |
string |
El ID de la clave de KMS del disco del sistema. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| ImageOptions |
object |
La información de las propiedades relacionadas con la imagen. |
|
| LoginAsNonRoot |
boolean |
Indica si la instancia que utiliza esta imagen admite el inicio de sesión con el usuario ecs-user. Valores válidos:
|
false |
| SecurityOptions |
object |
Las opciones de seguridad. |
|
| TrustedSystemMode |
string |
El modo de sistema de confianza. Establezca el valor en vTPM. Las siguientes familias de instancias admiten el modo de sistema de confianza:
Al crear instancias de ECS de las familias de instancias anteriores, debe establecer este parámetro. Tenga en cuenta los siguientes puntos:
Nota
Si especifica la instancia como una instancia de confianza al crearla, 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 |
Ejemplos
Respuesta exitosa
JSON Formato
{
"PageSize": 10,
"RequestId": "3989ED0C-20A1-4351-A127-2067FF8390AX",
"PageNumber": 1,
"TotalCount": 1,
"LaunchTemplateVersionSets": {
"LaunchTemplateVersionSet": [
{
"LaunchTemplateName": "testLaunchTemplateName",
"DefaultVersion": true,
"VersionNumber": 1,
"ModifiedTime": "2022-01-17T08:40:00Z",
"LaunchTemplateId": "lt-bp67acfmxazb4p****",
"CreateTime": "2022-01-17T08:22:43Z",
"CreatedBy": "123456789****",
"VersionDescription": "testVersionDescription",
"LaunchTemplateData": {
"DeploymentSetId": "ds-bp1brhwhoqinyjd6****",
"VpcId": "v-bp67acfmxazb4p****",
"SystemDisk.PerformanceLevel": "PL0",
"KeyPairName": "testKeyPairName",
"SecurityGroupId": "sg-bp67acfmxazb4p****",
"NetworkType": "vpc",
"SpotStrategy": "NoSpot",
"EnableVmOsConfig": false,
"Description": "testInstanceDescription",
"SpotDuration": 1,
"InstanceName": "testInstanceName",
"SecurityEnhancementStrategy": "active",
"UserData": "SGVsbG9FQ1M=",
"SystemDisk.DiskName": "testSystemDiskName",
"SystemDisk.Size": 40,
"SpotPriceLimit": 0.98,
"PasswordInherit": true,
"PrivateIpAddress": "10.1.**.**",
"ImageId": "m-bp67acfmxazb4p****",
"SystemDisk.DeleteWithInstance": true,
"SystemDisk.Category": "cloud_ssd",
"AutoReleaseTime": "2018-05-14T14:18:00Z",
"SystemDisk.Description": "testSystemDiskDescription",
"ImageOwnerAlias": "system",
"HostName": "testHostName",
"SystemDisk.Iops": 101800,
"SystemDisk.AutoSnapshotPolicyId": "sp-bp1j0alc2z1fhvie****",
"InternetMaxBandwidthOut": 100,
"InternetMaxBandwidthIn": 5,
"InstanceType": "ecs.g5.large",
"Period": 1,
"InstanceChargeType": "Postpaid",
"IoOptimized": "none",
"RamRoleName": "testRamRoleName",
"VSwitchId": "vsw-bp67acfmxazb4p****",
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"InternetChargeType": "PayByTraffic",
"ZoneId": "cn-hangzhou-g",
"Ipv6AddressCount": 1,
"DataDisks": {
"DataDisk": [
{
"PerformanceLevel": "PL1",
"Description": "testDiskDescription",
"SnapshotId": "s-bp67acfmxazb4p****",
"Device": "/dev/xvdb",
"Size": 2000,
"DiskName": "testDiskName",
"Category": "cloud_ssd",
"DeleteWithInstance": true,
"Encrypted": "false",
"ProvisionedIops": 50000,
"BurstingEnabled": true,
"AutoSnapshotPolicyId": "sp-wz91dz3ghear2a5s****",
"KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****"
}
]
},
"NetworkInterfaces": {
"NetworkInterface": [
{
"NetworkInterfaceName": "testNetworkInterfaceName",
"VSwitchId": "vsw-bp67acfmxazb4p****",
"Description": "testNetworkInterfacesDescription",
"PrimaryIpAddress": "203.0.*.*",
"SecurityGroupId": "sg-bp67acfmxazb4p****",
"SecurityGroupIds": {
"SecurityGroupId": [
"[\"sg-bp15ed6xe1yxeycg7****\"]"
]
},
"InstanceType": "ecs.s2.xlarge",
"NetworkInterfaceTrafficMode": "Standard",
"DeleteOnRelease": true
}
]
},
"Tags": {
"InstanceTag": [
{
"Key": "TestKey",
"Value": "TestValue"
}
]
},
"SecurityGroupIds": {
"SecurityGroupId": [
"[\"sg-bp15ed6xe1yxeycg7****\"]"
]
},
"SystemDisk.ProvisionedIops": 50000,
"SystemDisk.BurstingEnabled": true,
"SystemDisk.Encrypted": "false",
"DeletionProtection": false,
"CreditSpecification": "Standard",
"AutoRenew": true,
"AutoRenewPeriod": 1,
"PeriodUnit": "Month",
"HttpEndpoint": "enabled",
"HttpTokens": "optional",
"HttpPutResponseHopLimit": 3,
"SystemDisk.KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****\n",
"ImageOptions": {
"LoginAsNonRoot": false
},
"SecurityOptions": {
"TrustedSystemMode": "vTPM"
}
}
}
]
}
}
Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|---|---|---|---|
| 400 | InvalidRegion.NotExist | %s | La región especificada no existe. Verifique si el parámetro es correcto. |
| 400 | MissingParameter | %s | Falta un parámetro obligatorio. |
| 400 | InvalidParameter | %s | Los parámetros de la solicitud actual no son válidos. Inténtelo de nuevo. |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | Ocurrió un error interno. Inténtelo de nuevo. |
| 403 | InnerServiceFailed | %s | No se pudo invocar el servicio interno. |
| 404 | InvalidLaunchTemplate.NotFound | The specified LaunchTemplate is not found. | No se encontró la plantilla de lanzamiento especificada. Verifique que los parámetros sean correctos. |
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.