Todos los productos
Search
Centro de documentos

:CreateAutoProvisioningGroup

Última actualización: Sep 02, 2026

Crea un grupo de aprovisionamiento automático.

Notas de uso

  • Auto Provisioning es un servicio que permite desplegar rápidamente un clúster de instancias compuesto por preemptible instances e instancias pay-as-you-go. Auto Provisioning admite el despliegue con un solo clic de clústeres de instancias en distintos métodos de facturación, familias de instancias y zonas. Para obtener más información, consulte Use auto provisioning group-related API operations to create multiple Elastic Compute Service (ECS) instances at the same time.

  • Auto Provisioning utiliza grupos de aprovisionamiento automático para programar y mantener recursos de cómputo. Use estos grupos para obtener un suministro constante de recursos de cómputo; esto ayuda a reducir el impacto en la capacidad de cómputo cuando se recuperan las preemptible instances.

  • El servicio Auto Provisioning se proporciona sin costo adicional. Sin embargo, se le cobrarán los recursos de instancia creados dentro de los grupos de aprovisionamiento automático. Para obtener más información, consulte Overview of preemptible instances y Pay-as-you-go.

  • Si especifica tanto una plantilla de lanzamiento (LaunchTemplateId) como configuraciones extendidas (parámetros LaunchConfiguration.*), LaunchTemplateId tiene prioridad.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action String Sí CreateAutoProvisioningGroup

La operación que desea ejecutar. Establezca el valor en CreateAutoProvisioningGroup.

RegionId String Sí cn-hangzhou

ID de la región donde se creará el grupo de aprovisionamiento automático. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.

ResourceGroupId String No rg-bp67acfmxazb4p****

ID del resource group al que se asignará el grupo de aprovisionamiento automático.

AutoProvisioningGroupName String No apg-test

Nombre del grupo de aprovisionamiento automático. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con http:// ni https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).

AutoProvisioningGroupType String No maintain

Tipo de entrega del grupo de aprovisionamiento automático. Valores válidos:

  • request: entrega asíncrona única. Al iniciar el grupo, este intenta entregar de forma asíncrona un clúster de instancias que cumpla con la capacidad objetivo una sola vez. El grupo no reintenta la operación, independientemente de si se entregan todas las instancias.
  • instant: entrega síncrona única. Al iniciar el grupo, este intenta entregar de forma síncrona un clúster de instancias que cumpla con la capacidad objetivo una sola vez. La respuesta incluye la lista de instancias entregadas y las causas de los fallos de entrega.
  • maintain: entrega continua. Al iniciar el grupo, este intenta entregar un clúster de instancias que cumpla con la capacidad objetivo y monitorea la capacidad en tiempo real. Si no se alcanza la capacidad objetivo, el grupo continúa creando instancias hasta lograrla.

Valor predeterminado: maintain.

SpotAllocationStrategy String No diversified

Directiva para crear preemptible instances. Valores válidos:

  • lowest-price: directiva de optimización de costos. El grupo selecciona el tipo de instancia con el precio más bajo para crear las instancias.
  • diversified: directiva de distribución equilibrada. El grupo crea instancias en las zonas especificadas en las configuraciones extendidas y luego las distribuye uniformemente entre dichas zonas.
  • capacity-optimized: directiva de distribución optimizada por capacidad. El grupo crea instancias de los tipos óptimos en las zonas óptimas según la disponibilidad de recursos.

Valor predeterminado: lowest-price.

SpotInstanceInterruptionBehavior String No terminate

Operación que se ejecutará en la preemptible instance cuando se interrumpa. Valores válidos:

  • stop: detiene la preemptible instance.
  • terminate: libera la preemptible instance.

Valor predeterminado: terminate.

SpotInstancePoolsToUseCount Integer No 2

Número de preemptible instances del tipo de instancia con el precio más bajo que creará el grupo de aprovisionamiento automático. Este parámetro surte efecto cuando SpotAllocationStrategy se establece en lowest-price.

El valor debe ser menor que el valor N especificado en LaunchTemplateConfig.N.

PayAsYouGoAllocationStrategy String No prioritized

Directiva para crear instancias pay-as-you-go. Valores válidos:

  • lowest-price: directiva de optimización de costos. El grupo selecciona el tipo de instancia con el precio más bajo para crear las instancias.
  • prioritized: directiva basada en prioridad. El grupo crea instancias según la prioridad especificada por LaunchTemplateConfig.N.Priority.

Valor predeterminado: lowest-price.

ExcessCapacityTerminationPolicy String No termination

Especifica si se deben liberar las instancias reducidas cuando la capacidad en tiempo real del grupo supera la capacidad objetivo y se activa una reducción de escala. Valores válidos:

  • termination: libera las instancias eliminadas del grupo de aprovisionamiento automático.
  • no-termination: solo elimina las instancias del grupo, pero no las libera.

Valor predeterminado: no-termination.

ValidFrom String No 2019-04-01T15:10:20Z

Hora de inicio del grupo de aprovisionamiento automático. El periodo comprendido entre este momento y el especificado por ValidUntil constituye el periodo de validez del grupo.

Especifique la hora en formato yyyy-MM-ddTHH:mm:ssZ según el estándar ISO 8601. La hora debe estar en UTC.

De forma predeterminada, el grupo de aprovisionamiento automático se inicia inmediatamente después de su creación.

ValidUntil String No 2019-06-01T15:10:20Z

Hora de vencimiento del grupo de aprovisionamiento automático. El periodo comprendido entre este momento y el especificado por ValidFrom constituye el periodo de validez del grupo.

Especifique la hora en formato yyyy-MM-ddTHH:mm:ssZ según el estándar ISO 8601. La hora debe estar en UTC.

Valor predeterminado: 2099-12-31T23:59:59Z.

TerminateInstancesWithExpiration Boolean No true

Especifica si se deben liberar las instancias del grupo cuando este venza. Valores válidos:

  • true: libera las instancias.
  • false: solo elimina las instancias del grupo, pero no las libera.

Valor predeterminado: false.

TerminateInstances Boolean No true

Especifica si se deben liberar las instancias del grupo cuando se elimine el grupo de aprovisionamiento automático. Valores válidos:

  • true: libera las instancias.
  • false: conserva las instancias.

Valor predeterminado: false.

MaxSpotPrice Float No 2

Precio máximo de las preemptible instances en el grupo de aprovisionamiento automático.

Nota Si se especifican tanto MaxSpotPrice como LaunchTemplateConfig.N.MaxPrice, se utilizará el menor de los dos valores.
TotalTargetCapacity String Sí 60

Capacidad objetivo total del grupo de aprovisionamiento automático. El valor debe ser un entero positivo.

La capacidad objetivo total debe ser mayor o igual a la suma de la capacidad objetivo de instancias pay-as-you-go (especificada por PayAsYouGoTargetCapacity) y la capacidad objetivo de preemptible instances (especificada por SpotTargetCapacity).

PayAsYouGoTargetCapacity String No 30

Capacidad objetivo de instancias pay-as-you-go en el grupo de aprovisionamiento automático. El valor debe ser menor o igual al valor de TotalTargetCapacity.

SpotTargetCapacity String No 20

Capacidad objetivo de preemptible instances en el grupo de aprovisionamiento automático. El valor debe ser menor o igual al valor de TotalTargetCapacity.

DefaultTargetCapacityType String No Spot

Método de facturación de las instancias complementarias. Cuando la suma de PayAsYouGoTargetCapacity y SpotTargetCapacity es menor que TotalTargetCapacity, el grupo crea instancias del método de facturación especificado para alcanzar la capacidad objetivo total. Valores válidos:

  • PayAsYouGo: pay-as-you-go
  • Spot: preemptible instance

Valor predeterminado: Spot.

LaunchTemplateId String No lt-bp1fgzds4bdogu03****

ID de la plantilla de lanzamiento asociada al grupo de aprovisionamiento automático. Llame a la operación DescribeLaunchTemplates para consultar las plantillas disponibles. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchTemplateVersion String No 1

Versión de la plantilla de lanzamiento asociada al grupo de aprovisionamiento automático. Llame a la operación DescribeLaunchTemplateVersions para consultar las versiones de las plantillas disponibles.

Valor predeterminado: la versión predeterminada de la plantilla de lanzamiento.

Description String No testDescription

Descripción del grupo de aprovisionamiento automático.

ClientToken String No 0c593ea1-3bea-11e9-b96b-88e9fe637760

Token de cliente utilizado para garantizar la idempotencia de la solicitud. Puede generar el token desde el cliente, pero debe asegurarse de que sea único para cada solicitud. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte How to ensure idempotence.

LaunchConfiguration.ImageId String No m-bp1g7004ksh0oeuc****

ID de la imagen que se usará para crear la instancia. Llame a la operación DescribeImages para consultar los recursos de imagen disponibles. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SecurityGroupId String No sg-bp15ed6xe1yxeycg****

ID del security group al que se asignará la instancia. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.IoOptimized String No optimized

Especifica si la instancia está optimizada para E/S. Valores válidos:

  • none: La instancia no está optimizada para E/S.
  • optimized: La instancia está optimizada para E/S.

Para instancias de tipos retirados, el valor predeterminado es none. Para otros tipos de instancia, el valor predeterminado es optimized.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.InternetChargeType String No PayByTraffic

Método de facturación para el uso de la red. Valores válidos:

  • PayByBandwidth
  • PayByTraffic
Nota Cuando se utiliza el método de facturación por tráfico, los valores máximos de ancho de banda de entrada y salida funcionan como límites superiores y no como especificaciones de rendimiento garantizado. En escenarios donde la demanda supera la oferta de recursos, es posible que se limite el ancho de banda máximo. Si requiere un ancho de banda garantizado para su instancia, utilice el método de facturación por ancho de banda.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.InternetMaxBandwidthIn Integer No 10

Ancho de banda público máximo de entrada. Unidad: Mbit/s. Valores válidos:

  • Si el ancho de banda público máximo de salida es menor o igual a 10 Mbit/s, los valores válidos son de 1 a 10, y el valor predeterminado es 10.
  • Si el ancho de banda público máximo de salida es mayor a 10 Mbit/s, los valores válidos van de 1 al valor de LaunchConfiguration.InternetMaxBandwidthOut, siendo este último también el valor predeterminado.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.InternetMaxBandwidthOut Integer No 10

Ancho de banda público máximo de salida. Unidad: Mbit/s. Valores válidos: 0 a 100.

Valor predeterminado: 0.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.InstanceName String No k8s-node-[1.4]-alibabacloud

Nombre de la instancia. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con http:// ni https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).

El valor predeterminado de este parámetro es el valor de InstanceId.

Al crear instancias por lotes, puede configurar nombres secuenciales para ellas. Para obtener más información, consulte Batch configure sequential names or hostnames for multiple instances.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.HostName String No k8s-node-[1.4]-ecshost

Nombre de host de la instancia. Tenga en cuenta lo siguiente:

  • El nombre de host no puede comenzar ni terminar con un punto (.) o un guion (-). Tampoco puede contener puntos (.) o guiones (-) consecutivos.
  • Para instancias Windows, el nombre debe tener entre 2 y 15 caracteres; no puede contener puntos (.) ni consistir únicamente en dígitos. Puede incluir letras, dígitos y guiones (-).
  • Para instancias con otros sistemas operativos, como Linux, el nombre debe tener entre 2 y 64 caracteres. Puede usar puntos (.) para dividir el nombre en varios segmentos, cada uno de los cuales puede contener letras, dígitos y guiones (-).
  • No puede especificar simultáneamente LaunchConfiguration.HostName y LaunchConfiguration.HostNames.N; de lo contrario, se devolverá un error.
  • Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.
LaunchConfiguration.InstanceDescription String No Instance_Description

Descripción de la instancia. Debe tener entre 2 y 256 caracteres de longitud. Puede contener letras, pero no puede comenzar con http:// ni https://. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.KeyPairName String No KeyPair_Name

Nombre del key pair.

  • Para instancias Windows, este parámetro se ignora y queda vacío de forma predeterminada.
  • De forma predeterminada, el inicio de sesión por contraseña está deshabilitado para instancias Linux.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.RamRoleName String No RAM_Name

Nombre del rol de Resource Access Management (RAM) de la instancia. Llame a la operación ListRoles proporcionada por RAM para consultar los roles de instancia que ha creado. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SecurityEnhancementStrategy String No Active

Especifica si se debe habilitar el refuerzo de seguridad. Valores válidos:

  • Active: habilita el refuerzo de seguridad para el sistema operativo. Este valor solo aplica a imágenes públicas.
  • Deactive: no habilita el refuerzo de seguridad. Este valor aplica a todos los tipos de imagen.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.UserData String No ZWNobyBoZWxsbyBlY3Mh

Datos de usuario de la instancia. Deben estar codificados en Base64. Los datos originales pueden tener un tamaño máximo de 16 KB. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDiskCategory String No cloud_ssd

Categoría del disco del sistema. Valores válidos:

  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: enhanced SSD (ESSD)
  • cloud: basic disk

Para instancias no optimizadas para E/S de tipos retirados, el valor predeterminado es cloud. Para otros tipos de instancia, el valor predeterminado es cloud_efficiency.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDiskSize Integer No 40

Tamaño del disco del sistema. Valores válidos: 20 a 500. Unidad: GiB. El valor debe ser como mínimo 20 y mayor o igual al tamaño de la imagen especificada en LaunchConfiguration.ImageId.

Valor predeterminado: 40 o el tamaño de la imagen especificada en LaunchConfiguration.ImageId, el que sea mayor.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDiskName String No cloud_ssdSystem

Nombre del disco del sistema. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con http:// ni https://. Puede contener letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-).

Este parámetro está vacío de forma predeterminada.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDiskDescription String No SystemDisk_Description

Descripción del disco del sistema. Debe tener entre 2 y 256 caracteres de longitud. Puede contener letras, pero no puede comenzar con http:// ni https://.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDiskPerformanceLevel String No PL0

Nivel de rendimiento del ESSD utilizado como disco del sistema. Valores válidos:

  • PL0 (predeterminado): Un solo ESSD puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria.
  • PL1: Un solo ESSD puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria.
  • PL2: Un solo ESSD puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria.
  • PL3: Un solo ESSD puede ofrecer hasta 1,000,000 IOPS de lectura/escritura aleatoria.

Para obtener más información sobre los niveles de rendimiento de ESSD, consulte ESSDs.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.PasswordInherit Boolean No true

Especifica si se debe usar la contraseña preestablecida en la imagen. Valores válidos:

  • true
  • false

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.ResourceGroupId String No rg-bp67acfmxazb4p****

ID del resource group al que se asignará la instancia. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.CreditSpecification String No Standard

Modo de rendimiento de la instancia escalable. Valores válidos:

Este parámetro está vacío de forma predeterminada.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.Password String No EcsV587!

Contraseña de la instancia. Debe tener entre 8 y 30 caracteres de longitud y contener como mínimo tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Los caracteres especiales permitidos son:

()~!@#$%^&*-_+=|{}:;'<>,.?/ Para instancias Windows, la contraseña no puede comenzar con una barra diagonal (/). Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DeploymentSetId String No ds-bp1frxuzdg87zh4p****

ID del conjunto de despliegue.

LaunchTemplateConfig.N.VSwitchId String No vsw-sn5bsitu4lfzgc5o7****

ID del vSwitch en la configuración extendida N. La zona de las instancias ECS creadas a partir de esta configuración queda determinada por el vSwitch.

Nota Si especifica uno o más parámetros LaunchTemplateConfig.N.* adicionales, también debe especificar LaunchTemplateConfig.N.VSwitchId.
LaunchTemplateConfig.N.MaxPrice double No 3

Precio máximo de las preemptible instances en la configuración extendida N.

Nota Si especifica uno o más parámetros LaunchTemplateConfig.N.* adicionales, también debe especificar LaunchTemplateConfig.N.MaxPrice.
LaunchTemplateConfig.N.Priority Integer No 1

Prioridad de la configuración extendida N. Un valor de 0 indica la máxima prioridad. Valores válidos: 0 a + ∞.

LaunchTemplateConfig.N.InstanceType String No ecs.g5.large

Tipo de instancia en la configuración extendida N. Valores válidos de N: 1 a 20. Para obtener más información sobre los valores válidos de este parámetro, consulte Overview of instance families.

LaunchTemplateConfig.N.WeightedCapacity double No 2

Peso del tipo de instancia en la configuración extendida N. Un peso mayor indica que una sola instancia tiene más potencia de cómputo y que se requieren menos instancias. El valor debe ser mayor que 0.

El peso se calcula en función de la potencia de cómputo del tipo de instancia especificado y la potencia mínima de una sola instancia en el clúster que creará el grupo. Por ejemplo, suponga que la potencia mínima de una sola instancia es de 8 vCPU y 60 GiB de memoria.

  • Para un tipo de instancia con 8 vCPU y 60 GiB de memoria, puede establecer el peso en 1.
  • Para un tipo de instancia con 16 vCPU y 120 GiB de memoria, puede establecer el peso en 2.
LaunchTemplateConfig.N.MaxQuantity Integer No false
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
LaunchTemplateConfig.N.Cores.N Integer No 2

Número de vCPU del tipo de instancia en la configuración extendida N. Este parámetro se usa para filtrar tipos de instancia. Para obtener más información, consulte Overview of instance families. Valores válidos de N: 1 a 10.

LaunchTemplateConfig.N.Memories.N Float No 4

Tamaño de memoria del tipo de instancia en la configuración extendida N. Unidad: GiB. Este parámetro se usa para filtrar tipos de instancia. Para obtener más información, consulte Overview of instance families. Valores válidos de N: 1 a 10.

LaunchTemplateConfig.N.InstanceFamilyLevel String No EnterpriseLevel

Nivel de familia de instancias del tipo de instancia en la configuración extendida N. Este parámetro se usa para filtrar tipos de instancia. Valores válidos:

  • EntryLevel: nivel básico (tipos de instancia compartida). Son los más rentables, pero podrían no ofrecer un rendimiento de cómputo estable. Adecuados para escenarios con baja utilización de CPU. Para obtener más información, consulte Shared instance families.
  • EnterpriseLevel: nivel empresarial. Ofrecen rendimiento estable y recursos dedicados; adecuados para escenarios que requieren alta estabilidad. Para obtener más información, consulte Overview of instance families.
  • CreditEntryLevel: nivel básico con créditos (tipos de instancia escalables). Utilizan créditos de CPU para garantizar el rendimiento. Adecuados para escenarios con baja utilización de CPU que pueden presentar fluctuaciones puntuales. Para obtener más información, consulte Overview of burstable instances.

Valores válidos de N: 1 a 10.

LaunchTemplateConfig.N.ExcludedInstanceTypes.N String No ecs.n1.small/ecs.n1.*/*7*

Tipo de instancia N que desea excluir en la configuración extendida N. Puede usar comodines, como el asterisco (*), para excluir un tipo de instancia o una familia completa. Ejemplos:

  • ecs.c6.large: Se excluye el tipo de instancia ecs.c6.large.
  • ecs.c6.*: Se excluye la familia de instancias c6.
LaunchTemplateConfig.N.Architectures.N String No X86

Arquitectura N del tipo de instancia en la configuración extendida N. Valores válidos:

  • X86: x86
  • Heterogeneous: cómputo heterogéneo, como aceleración por GPU o FPGA
  • BareMetal: ECS Bare Metal Instance
  • Arm: Arm
  • SuperComputeCluster: Super Computing Cluster

De forma predeterminada, se incluyen todos los valores.

LaunchTemplateConfig.N.BurstablePerformance String No Include

Especifica si se deben incluir tipos de instancia escalables. Valores válidos:

  • Exclude: no incluye tipos de instancia escalables.
  • Include: incluye tipos de instancia escalables.
  • Required: incluye únicamente tipos de instancia escalables.

Valor predeterminado: Include.

LaunchConfiguration.DataDisk.N.PerformanceLevel String No PL1

Nivel de rendimiento del ESSD utilizado como disco de datos N. El valor de N en este parámetro debe coincidir con el valor de N en LaunchConfiguration.DataDisk.N.Category. Valores válidos:

  • PL0: Un solo ESSD puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria.
  • PL1 (predeterminado): Un solo ESSD puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria.
  • PL2: Un solo ESSD puede ofrecer hasta 100,000 IOPS de lectura/escritura aleatoria.
  • PL3: Un solo ESSD puede ofrecer hasta 1,000,000 IOPS de lectura/escritura aleatoria.

Para obtener más información sobre los niveles de rendimiento de ESSD, consulte ESSDs.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.KmsKeyId String No 0e478b7a-4262-4802-b8cb-00d3fb40****

ID de la clave de Key Management Service (KMS) que se usará para el disco de datos N. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.Description String No DataDisk_Description

Descripción del disco de datos N. Debe tener entre 2 y 256 caracteres de longitud. Puede contener letras, pero no puede comenzar con http:// ni https://. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.SnapshotId String No s-bp17441ohwka0yuh****

ID de la instantánea que se usará para crear el disco de datos N. Valores válidos de N: 1 a 16.

Al especificar este parámetro, se ignora LaunchConfiguration.DataDisk.N.Size. El tamaño del disco de datos N será igual al de la instantánea especificada. Utilice instantáneas creadas a partir del 15 de julio de 2013; de lo contrario, se devolverá un error y se rechazará la solicitud.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.Size Integer No 20

Tamaño del disco de datos N. Valores válidos de N: 1 a 16. Unidad: GiB. Valores válidos:

  • Si LaunchConfiguration.DataDisk.N.Category es cloud_efficiency: 20 a 32,768.
  • Si LaunchConfiguration.DataDisk.N.Category es cloud_ssd: 20 a 32,768.
  • Si LaunchConfiguration.DataDisk.N.Category es cloud_essd: depende del valor de LaunchConfiguration.DataDisk.N.PerformanceLevel.
    • Si LaunchConfiguration.DataDisk.N.PerformanceLevel es PL0: 40 a 32,768.
    • Si LaunchConfiguration.DataDisk.N.PerformanceLevel es PL1: 20 a 32,768.
    • Si LaunchConfiguration.DataDisk.N.PerformanceLevel es PL2: 461 a 32,768.
    • Si LaunchConfiguration.DataDisk.N.PerformanceLevel es PL3: 1,261 a 32,768.
  • Si LaunchConfiguration.DataDisk.N.Category es cloud: 5 a 2,000.
Nota El valor de LaunchConfiguration.DataDisk.N.Size debe ser mayor o igual al tamaño de la instantánea especificada en LaunchConfiguration.DataDisk.N.SnapshotId.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.Device String No /dev/vd1

Punto de montaje del disco de datos N. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.DiskName String No cloud_ssdData

Nombre del disco de datos N. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con http:// ni https://. Puede contener letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-).

Este parámetro está vacío de forma predeterminada.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.Category String No cloud_ssd

Categoría del disco de datos N. Valores válidos de N: 1 a 16. Valores válidos:

  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: ESSD
  • cloud: basic disk

Para instancias optimizadas para E/S, el valor predeterminado es cloud_efficiency. Para instancias no optimizadas para E/S, el valor predeterminado es cloud.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.DeleteWithInstance Boolean No true

Especifica si se debe liberar el disco de datos N cuando se libere su instancia asociada. Valores válidos:

  • true
  • false

Valor predeterminado: true.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.DataDisk.N.Encrypted Boolean No false

Especifica si se debe cifrar el disco de datos N. Valores válidos:

  • true
  • false

Valor predeterminado: false.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.Tag.N.Key String No TestKey

Clave de la etiqueta N que se agregará a la instancia. Valores válidos de N: 1 a 20. La clave no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: ni aliyun. Tampoco puede contener http:// ni https://. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.Tag.N.Value String No TestValue

Valor de la etiqueta N que se agregará a la instancia. Valores válidos de N: 1 a 20. El valor puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener http:// ni https://. El valor no puede comenzar con acs:. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

SystemDiskConfig.N.DiskCategory String No cloud_ssd

Categoría del disco del sistema N. Puede usar este parámetro para especificar múltiples categorías de disco, las cuales se priorizarán en el orden indicado. Si una categoría no está disponible, el sistema usará la siguiente disponible. Valores válidos:

  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: ESSD
  • cloud: basic disk
DataDiskConfig.N.DiskCategory String No cloud_efficiency

Categoría del disco de datos N. Puede usar este parámetro para especificar múltiples categorías de disco, las cuales se priorizarán en el orden indicado. Si una categoría no está disponible, el sistema usará la siguiente disponible. Valores válidos:

  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: ESSD
  • cloud: basic disk
LaunchConfiguration.HostNames.N String No ecs-host-01

Nombre de host de la instancia N. Puede usar este parámetro para especificar distintos nombres de host para múltiples instancias. Tenga en cuenta lo siguiente:

  • Este parámetro solo surte efecto cuando AutoProvisioningGroupType se establece en instant.
  • El valor de N indica el número de instancias. Valores válidos de N: 1 a 1,000. El valor de N debe coincidir con el valor de TotalTargetCapacity.
  • El nombre de host no puede comenzar ni terminar con un punto (.) o un guion (-). Tampoco puede contener puntos (.) o guiones (-) consecutivos.
  • Para instancias Windows, el nombre debe tener entre 2 y 15 caracteres; no puede contener puntos (.) ni consistir únicamente en dígitos. Puede incluir letras, dígitos y guiones (-).
  • Para instancias con otros sistemas operativos, como Linux, el nombre debe tener entre 2 y 64 caracteres. Puede usar puntos (.) para dividir el nombre en varios segmentos, cada uno de los cuales puede contener letras, dígitos y guiones (-).
  • No puede especificar simultáneamente LaunchConfiguration.HostName y LaunchConfiguration.HostNames.N; de lo contrario, se devolverá un error.
  • Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.
MinTargetCapacity String No 20

Capacidad objetivo mínima del grupo de aprovisionamiento automático. El valor debe ser un entero positivo.

Al especificar este parámetro, tenga en cuenta lo siguiente:

  • Este parámetro solo surte efecto cuando AutoProvisioningGroupType se establece en instant.
  • Si el número de instancias que se pueden crear en la región actual es menor que el valor de este parámetro, la operación fallará y no se creará ninguna instancia.
  • Si el número de instancias que se pueden crear en la región actual es mayor que el valor de este parámetro, las instancias se crearán según los parámetros especificados.
LaunchConfiguration.SecurityGroupIds.N String No sg-bp15ed6xe1yxeycg****

ID del security group N al que se asignará la instancia. Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDisk.Encrypted String No false

Especifica si se debe cifrar el disco del sistema. Valores válidos:

  • true
  • false

Valor predeterminado: false.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDisk.KMSKeyId String No 0e478b7a-4262-4802-b8cb-00d3fb40****

ID de la clave KMS que se usará para el disco del sistema.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.SystemDisk.EncryptAlgorithm String No aes-256

Algoritmo que se usará para cifrar el disco del sistema. Valores válidos:

  • aes-256
  • sm4-128

Valor predeterminado: aes-256.

Si se especifican tanto LaunchTemplateId como parámetros LaunchConfiguration.*, LaunchTemplateId tiene prioridad.

LaunchConfiguration.Arn.N.Rolearn String No acs:ram::123456789012****:role/adminrole

Este parámetro no está disponible públicamente.

LaunchConfiguration.Arn.N.RoleType String No 34458433936495****:alice

Este parámetro no está disponible públicamente.

LaunchConfiguration.Arn.N.AssumeRoleFor Long No 123456789012****

Este parámetro no está disponible públicamente.

HibernationOptionsConfigured Boolean No false
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
LaunchConfiguration.AutoReleaseTime String No 2018-01-01T12:05:00Z

Hora en que se liberará automáticamente la instancia pay-as-you-go. Especifique la hora en formato yyyy-MM-ddTHH:mm:ssZ según el estándar ISO 8601 standard. La hora debe estar en UTC.

  • Si el valor de los segundos (ss) no es 00, la hora se redondeará automáticamente al minuto más cercano según el valor de los minutos (mm).
  • La hora especificada debe ser al menos 30 minutos posterior a la hora actual.
  • La hora especificada puede ser, como máximo, tres años posterior a la hora actual.
LaunchConfiguration.ImageFamily String No hangzhou-daily-update

Nombre de la familia de imágenes. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con aliyun ni acs:. No puede contener http:// ni https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

AutoProvisioningGroupId String apg-sn54avj8htgvtyh8****

ID del grupo de aprovisionamiento automático.

RequestId String 745CEC9F-0DD7-4451-9FE7-8B752F39****

ID de la solicitud.

LaunchResults Array of LaunchResult

Instancias creadas por el grupo de aprovisionamiento automático. Los valores de los parámetros en esta matriz solo se devuelven cuando AutoProvisioningGroupType se establece en instant.

LaunchResult
ZoneId String cn-hangzhou-g

ID de zona de la instancia.

ErrorMsg String Specific parameter is not valid.

Mensaje de error devuelto cuando no se puede crear la instancia.

InstanceType String ecs.g5.large

Tipo de instancia.

ErrorCode String InvalidParameter

Código de error devuelto cuando no se puede crear la instancia.

SpotStrategy String NoSpot

Directiva de puja para la instancia pay-as-you-go. Valores válidos:

  • NoSpot: La instancia es una instancia pay-as-you-go regular.
  • SpotWithPriceLimit: La instancia es una preemptible instance con precios máximos por hora definidos por el usuario.
  • SpotAsPriceGo: La instancia es una preemptible instance que utiliza automáticamente el precio de mercado al momento de la compra como precio de puja.
Amount Integer 1

Número de instancias creadas.

InstanceIds Array of String ["i-bp67acfmxazb4p****"]

ID de las instancias creadas.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=CreateAutoProvisioningGroup
&LaunchTemplateId=lt-bp1fgzds4bdogu03****
&RegionId=cn-hangzhou
&TotalTargetCapacity=60
&SpotInstancePoolsToUseCount=2
&ExcessCapacityTerminationPolicy=termination
&TerminateInstancesWithExpiration=true
&TerminateInstances=false
&PayAsYouGoTargetCapacity=30
&SpotTargetCapacity=20
&DefaultTargetCapacityType=Spot
&LaunchTemplateConfig.1.InstanceType=ecs.g5.large
&LaunchTemplateConfig.1.MaxPrice=3
&LaunchTemplateConfig.1.VSwitchId=vsw-sn5bsitu4lfzgc5o7****
&LaunchTemplateConfig.1.WeightedCapacity=2
&LaunchTemplateConfig.1.Priority=1
&<Common request parameters>

Respuestas exitosas de ejemplo

XML format

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

<CreateAutoProvisioningGroupResponse>
  <AutoProvisioningGroupId>apg-sn54avj8htgvtyh8****</AutoProvisioningGroupId>
  <RequestId>745CEC9F-0DD7-4451-9FE7-8B752F39****</RequestId>
</CreateAutoProvisioningGroupResponse>

JSON format

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

{
  "AutoProvisioningGroupId" : "apg-sn54avj8htgvtyh8****",
  "RequestId" : "745CEC9F-0DD7-4451-9FE7-8B752F39****"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

InvalidParameter

%s

Valor de parámetro no válido.

400

InternalError

The request processing has failed due to some unknown error.

Ocurrió un error interno. Inténtelo de nuevo más tarde.

400

MissingParameter

%s

No se especificó un parámetro obligatorio.

400

InvalidVSwitchId.NotFound

%s

No se encontró el vSwitch especificado.

400

InvalidImageFamily.Conflict

The specified parameter ImageFamily should be empty when the parameter ImageId is specified.

ImageFamily debe dejarse vacío si se especifica un ID de imagen.

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