Todos los productos
Search
Centro de documentos

Enterprise Distributed Application Service:ScaleoutApplicationWithNewInstances

Última actualización: Sep 01, 2026

Adquiere instancias de Elastic Compute Service (ECS) en la consola de Enterprise Distributed Application Service (EDAS) y agrega las instancias de ECS adquiridas al grupo de instancias especificado de una aplicación.

Descripción de la operación

Límites

Suponga que la función de escalado automático está configurada y habilitada para una aplicación. Cuando se activa un escalado horizontal automático para la aplicación, las instancias de ECS adquiridas mediante esta operación se eliminan primero.

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.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

edas:ECSPurchase

update

*All Resource

*

Ninguna Ninguna

Sintaxis de la solicitud

POST /pop/v5/scaling/scale_out HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

AppId

string

No

El ID de la aplicación que desea escalar horizontalmente. Puede llamar a la operación ListApplication para consultar el ID de la aplicación. Para obtener más información, consulte ListApplication.

e370c17f-*****-3df0721a327

GroupId

string

No

El ID del grupo de instancias que desea escalar horizontalmente. Puede llamar a la operación ListDeployGroup para consultar el ID del grupo. Para obtener más información, consulte ListDeployGroup.

e37**********-33df0721a327

ScalingNum

integer

Sí

El número de instancias que se agregarán para el escalado horizontal.

2

TemplateId

string

No

El ID de la plantilla de lanzamiento de instancias de ECS. Puede llamar a la operación DescribeLaunchTemplates para consultar el ID de la plantilla de lanzamiento. Para obtener más información, consulte DescribeLaunchTemplates.

lt-****hy9s2

TemplateVersion

string

No

La versión de la plantilla de lanzamiento de instancias de ECS. Puede llamar a la operación DescribeLaunchTemplateVersions para consultar la versión de la plantilla de lanzamiento. Para obtener más información, consulte DescribeLaunchTemplateVersions.

Nota

Si establece este parámetro en -1, se utiliza la versión predeterminada de la plantilla de lanzamiento.

-1

ScalingPolicy

string

No

El modo de recuperación de instancias del grupo de escalado. Valores válidos:

  • recycle: modo económico

  • release: modo de liberación

Para obtener más información sobre cómo eliminar instancias de un grupo de escalado especificado, consulte RemoveInstances.

release

TemplateInstanceId

string

No

El ID de la instancia de ECS existente utilizada para el escalado horizontal. Si se especifica este parámetro, las especificaciones y configuraciones de la instancia de ECS indicada se utilizan como plantilla para adquirir nuevas instancias.

i-28wt4****

ClusterId

string

No

El ID del clúster al que desea agregar instancias de ECS. Si se especifican la aplicación y el grupo de instancias de la aplicación para el escalado horizontal, este parámetro se ignora.

e37**********-33df0721a327

InstanceChargeType

string

No

El método de facturación de la instancia. Valores válidos:

  • PrePaid: suscripción.

  • PostPaid: pago por uso. Este es el valor predeterminado.

PrePaid

InstanceChargePeriodUnit

string

No

La unidad del periodo de suscripción. Valores válidos:

  • Week: facturación semanal.

  • Month: facturación mensual. Este es el valor predeterminado.

Month

InstanceChargePeriod

integer

No

La duración de la suscripción. La unidad de la duración de la suscripción se especifica mediante el parámetro InstanceChargePeriodUnit. Este parámetro solo surte efecto cuando el parámetro InstanceChargeType se establece en PrePaid.

  • Si el parámetro InstanceChargePeriodUnit se establece en Week, los valores válidos del parámetro InstanceChargePeriod son 1, 2, 3 y 4.

  • Si el parámetro InstanceChargePeriodUnit se establece en Month, los valores válidos del parámetro InstanceChargePeriod son 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 y 60.

1

AutoRenew

boolean

No

Especifica si se debe habilitar la renovación automática. Este parámetro solo surte efecto cuando el parámetro InstanceChargeType se establece en PrePaid. Valores válidos:

  • true: habilita la renovación automática.

  • false: no habilita la renovación automática. Este es el valor predeterminado.

true

AutoRenewPeriod

integer

No

El periodo de renovación automática. Valores válidos:

  • Si el parámetro InstanceChargePeriodUnit se establece en Week, los valores válidos del parámetro AutoRenewPeriod son 1, 2 y 3.

  • Si el parámetro InstanceChargePeriodUnit se establece en Month, los valores válidos del parámetro AutoRenewPeriod son 1, 2, 3, 6, 12, 24, 36, 48 y 60.

Valor predeterminado: 1.

1

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El contenido devuelto.

ChangeOrderId

string

El ID del proceso de cambio para el escalado horizontal.

e370c17f-*****-3df0721a327

Code

integer

El código de estado HTTP devuelto.

200

Message

string

La información adicional devuelta.

success

RequestId

string

El ID de la solicitud.

e370c17f-*****-3df0721a327

InstanceIds

array

Los ID de las instancias de ECS.

string

La lista de instancias de ECS adquiridas.

["i-28wt4****","i-28wt4****"]

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ChangeOrderId": "e370c17f-*****-3df0721a327",
  "Code": 200,
  "Message": "success",
  "RequestId": "e370c17f-*****-3df0721a327",
  "InstanceIds": [
    "[\"i-28wt4****\",\"i-28wt4****\"]"
  ]
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

500 Edas.errorcode.PermissionDenied.message You are not authorized to perform the operation. No permissions

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

Notas de la versión

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