DescribeScalingInstances - Auto Scaling - Centro de documentación de Alibaba Cloud

Consulta una lista de instancias de ECS y sus detalles en un grupo de escalado mediante el ID del grupo de escalado. Los detalles incluyen el número total de instancias spot en ejecución, el número total de instancias de ECS, el estado de calentamiento y el estado del ciclo de vida de las instancias de ECS en el grupo de escalado. Esta operación también permite filtrar las instancias de ECS por estado de salud, estado del ciclo de vida y tipo de creación.

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

ess:DescribeScalingInstances

get

*ScalingGroup.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región a la que pertenece el grupo de escalado.	cn-hangzhou
ScalingGroupId	string	No	El ID del grupo de escalado.	asg-bp1igpak5ft1flyp****
ScalingConfigurationId	string	No	El ID de la configuración de escalado asociada.	asc-bp1i65jd06v04vdh****
HealthStatus	string	No	El estado de salud de las instancias de ECS en el grupo de escalado. Las instancias de ECS que no se encuentran en estado de ejecución se consideran no saludables. Valores válidos: Healthy: La instancia de ECS está saludable. Unhealthy: La instancia de ECS no está saludable. Auto Scaling elimina automáticamente las instancias de ECS no saludables del grupo de escalado y libera las instancias de ECS creadas mediante creación automática. La liberación de las instancias de ECS agregadas manualmente depende de su estado administrado. Si el ciclo de vida de la instancia no lo administra el grupo de escalado, la instancia solo se elimina, pero no se libera. Si el ciclo de vida de la instancia lo administra el grupo de escalado, la instancia se elimina y se libera. Nota Asegúrese de que su cuenta tenga saldo activo suficiente. Si su cuenta tiene pagos vencidos, todas las instancias de ECS de pago por uso, incluidas las instancias de pago por uso y las instancias spot, se detienen o incluso se liberan. Para obtener más información sobre los cambios de estado de las instancias de ECS en un grupo de escalado después de pagos vencidos, consulte Pagos vencidos.	Healthy
LifecycleState	string	No	El estado del ciclo de vida de las instancias de ECS en el grupo de escalado. Valores válidos: InService: La instancia de ECS se agrega al grupo de escalado y proporciona servicios normalmente. Pending: La instancia de ECS se está agregando al grupo de escalado. El procedimiento para agregar una instancia de ECS a un grupo de escalado incluye agregar la instancia al grupo de servidores backend de una instancia de load balancer y agregar la dirección IP de la instancia a la lista blanca de acceso de una instancia de ApsaraDB RDS. Pending:Wait: La adición de la instancia de ECS al grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de escalado horizontal en el grupo de escalado, la instancia de ECS se suspende cuando se agrega al grupo de escalado y espera a que finalice el tiempo de espera del hook. Protected: La instancia de ECS proporciona servicios normalmente, pero Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Standby: La instancia de ECS no proporciona servicios, el peso del servidor backend de SLB se establece en cero y Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Stopped: La instancia de ECS está detenida y no proporciona servicios. Removing: La instancia de ECS se está eliminando del grupo de escalado. El procedimiento para eliminar una instancia de ECS de un grupo de escalado incluye eliminar la instancia del grupo de servidores backend de una instancia de load balancer y eliminar la dirección IP de la instancia de la lista blanca de acceso de una instancia de ApsaraDB RDS. Removing:Wait: La eliminación de la instancia de ECS del grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de reducción de escala en el grupo de escalado, la instancia de ECS se suspende cuando se elimina del grupo de escalado y espera a que finalice el tiempo de espera del hook.	InService
CreationType	string	No	El tipo de creación de las instancias en el grupo de escalado. Valores válidos: AutoCreated: La instancia de ECS es creada por Auto Scaling mediante creación automática según el origen de configuración de la instancia. Attached: La instancia de ECS no es creada por Auto Scaling, sino que se agrega manualmente al grupo de escalado. Managed: La instancia administrada no es creada por Auto Scaling, sino que se agrega manualmente al grupo de escalado.	AutoCreated
PageNumber	integer	No	El número de página de la lista de instancias de ECS. Las páginas comienzan desde la página 1. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas que se devolverán en cada página en una consulta paginada. Valor máximo: 100. Valor predeterminado: 10.	10
ScalingActivityId	string	No	El ID de la actividad de escalado.	asa-bp1c9djwrgxjyk31****
InstanceIds	array	No	Los ID de las instancias de ECS. Los InstanceIds no válidos se ignoran en los resultados de la consulta devuelta y no se reporta ningún error.
	string	No	Los ID de las instancias de ECS. Los InstanceIds no válidos se ignoran en los resultados de la consulta devuelta y no se reporta ningún error.	i-bp109k5j3dum1ce6****
CreationTypes	array	No	Los tipos de creación de las instancias en el grupo de escalado. Solo puede especificar uno de los parámetros CreationTypes y CreationType a la vez.
	string	No	El tipo de creación de las instancias en el grupo de escalado. Valores válidos: AutoCreated, Attached y Managed.	AutoCreated
LifecycleStates	array	No	Los estados del ciclo de vida de las instancias de ECS en el grupo de escalado. Solo puede especificar uno de los parámetros LifecycleStates y LifecycleState a la vez. Se recomienda utilizar este parámetro.
	string	No	El estado del ciclo de vida de las instancias de ECS en el grupo de escalado. Valores válidos: InService: La instancia de ECS se agrega al grupo de escalado y proporciona servicios normalmente. Pending: La instancia de ECS se está agregando al grupo de escalado. El procedimiento para agregar una instancia de ECS a un grupo de escalado incluye agregar la instancia al grupo de servidores backend de una instancia de load balancer y agregar la dirección IP de la instancia a la lista blanca de acceso de una instancia de ApsaraDB RDS. Pending:Wait: La adición de la instancia de ECS al grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de escalado horizontal en el grupo de escalado, la instancia de ECS se suspende cuando se agrega al grupo de escalado y espera a que finalice el tiempo de espera del hook. Protected: La instancia de ECS proporciona servicios normalmente, pero Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Standby: La instancia de ECS no proporciona servicios, el peso del servidor backend de SLB se establece en cero y Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Stopped: La instancia de ECS está detenida y no proporciona servicios. Removing: La instancia de ECS se está eliminando del grupo de escalado. El procedimiento para eliminar una instancia de ECS de un grupo de escalado incluye eliminar la instancia del grupo de servidores backend de una instancia de load balancer y eliminar la dirección IP de la instancia de la lista blanca de acceso de una instancia de ApsaraDB RDS. Removing:Wait: La eliminación de la instancia de ECS del grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de reducción de escala en el grupo de escalado, la instancia de ECS se suspende cuando se elimina del grupo de escalado y espera a que finalice el tiempo de espera del hook.	InService

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	B13527BF-1FBD-4334-A512-20F5E9D3****
PageSize	integer	El número de entradas devueltas por página.	10
PageNumber	integer	El número de página actual.	1
TotalSpotCount	integer	El número total de instancias spot en ejecución en el grupo de escalado.	4
TotalCount	integer	El número total de instancias de ECS.	1
ScalingInstances	array<object>	La colección de información de instancias de ECS.
	object	La colección de información de instancias de ECS.
CreationTime	string	La hora en que la instancia de ECS se agregó al grupo de escalado. La hora es precisa hasta los minutos y sigue el estándar ISO 8601 en el formato AAAA-MM-DDTHH:mmZ. La hora se muestra en UTC.	2020-05-18T03:11Z
LoadBalancerWeight	integer	El peso del servidor backend de SLB. Nota [Deprecated] Este parámetro está obsoleto. No lo utilice.	50
LaunchTemplateId	string	El ID de la plantilla de lanzamiento de la instancia.	lt-m5e3ofjr1zn1aw7****
InstanceId	string	El ID de la instancia de ECS.	i-bp109k5j3dum1ce6****
SpotStrategy	string	La política de puja para la instancia spot. Valores válidos: SpotWithPriceLimit: La instancia spot con un precio máximo. SpotAsPriceGo: El sistema puja automáticamente según el precio de mercado actual.	SpotWithPriceLimit
LaunchTemplateVersion	string	La versión de la plantilla de lanzamiento de la instancia.	1
HealthStatus	string	El estado de salud de la instancia de ECS en el grupo de escalado. Las instancias de ECS que no se encuentran en estado de ejecución se consideran no saludables. Valores válidos: Healthy: La instancia de ECS está saludable. Unhealthy: La instancia de ECS no está saludable. Auto Scaling elimina automáticamente las instancias de ECS no saludables del grupo de escalado y libera las instancias de ECS creadas mediante creación automática. La liberación de las instancias de ECS agregadas manualmente depende de su estado administrado. Si el ciclo de vida de la instancia no lo administra el grupo de escalado, la instancia solo se elimina, pero no se libera. Si el ciclo de vida de la instancia lo administra el grupo de escalado, la instancia se elimina y se libera. Nota Asegúrese de que su cuenta tenga saldo activo suficiente. Si su cuenta tiene pagos vencidos, todas las instancias de ECS de pago por uso, incluidas las instancias de pago por uso y las instancias spot, se detienen o incluso se liberan. Para obtener más información sobre los cambios de estado de las instancias de ECS en un grupo de escalado después de pagos vencidos, consulte Pagos vencidos.	Healthy
ScalingGroupId	string	El ID del grupo de escalado al que pertenece la instancia.	asg-bp1igpak5ft1flyp****
WarmupState	string	El estado de calentamiento de la instancia de ECS. Valores válidos: NoNeedWarmup: No se requiere calentamiento. WaitingForInstanceWarmup: La instancia está esperando a que se complete el calentamiento. InstanceWarmupFinish: El calentamiento se ha completado.	NoNeedWarmup
LifecycleState	string	El estado del ciclo de vida de la instancia de ECS en el grupo de escalado. Valores válidos: InService: La instancia de ECS se agrega al grupo de escalado y proporciona servicios normalmente. Pending: La instancia de ECS se está agregando al grupo de escalado. El procedimiento para agregar una instancia de ECS a un grupo de escalado incluye agregar la instancia al grupo de servidores backend de una instancia de load balancer y agregar la dirección IP de la instancia a la lista blanca de acceso de una instancia de ApsaraDB RDS. Pending:Wait: La adición de la instancia de ECS al grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de escalado horizontal en el grupo de escalado, la instancia de ECS se suspende cuando se agrega al grupo de escalado y espera a que finalice el tiempo de espera del hook. Protected: La instancia de ECS proporciona servicios normalmente, pero Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Standby: La instancia de ECS no proporciona servicios, el peso del servidor backend de SLB se establece en cero y Auto Scaling no administra el ciclo de vida de la instancia de ECS. Debe administrar el ciclo de vida manualmente. Stopped: La instancia de ECS está detenida y no proporciona servicios. Removing: La instancia de ECS se está eliminando del grupo de escalado. El procedimiento para eliminar una instancia de ECS de un grupo de escalado incluye eliminar la instancia del grupo de servidores backend de una instancia de load balancer y eliminar la dirección IP de la instancia de la lista blanca de acceso de una instancia de ApsaraDB RDS. Removing:Wait: La eliminación de la instancia de ECS del grupo de escalado está suspendida. Si se crea un hook de ciclo de vida aplicable a las actividades de reducción de escala en el grupo de escalado, la instancia de ECS se suspende cuando se elimina del grupo de escalado y espera a que finalice el tiempo de espera del hook.	InService
CreationType	string	El tipo de creación de la instancia de ECS. Valores válidos: AutoCreated: La instancia de ECS es creada por Auto Scaling mediante creación automática según el origen de configuración de la instancia. Attached: La instancia de ECS no es creada por Auto Scaling, sino que se agrega manualmente al grupo de escalado.	AutoCreated
ZoneId	string	El ID de la zona a la que pertenece la instancia de ECS.	cn-hangzhou-g
ScalingConfigurationId	string	El ID de la configuración de escalado asociada.	asc-bp1i65jd06v04vdh****
Entrusted	boolean	Especifica si el grupo de escalado administra la instancia cuando se agrega manualmente al grupo de escalado. Una instancia agregada manualmente en estado administrado se libera cuando se elimina del grupo de escalado, excepto en la eliminación manual. Valores válidos: true: El grupo de escalado administra la instancia. false: El grupo de escalado no administra la instancia.	true
WeightedCapacity	integer	El peso del tipo de instancia, que indica la capacidad de una sola instancia del tipo de instancia en el grupo de escalado. Un peso mayor indica que se requieren menos instancias del tipo de instancia para alcanzar la capacidad esperada.	4
CreatedTime	string	La hora en que la instancia de ECS se agregó al grupo de escalado. La hora es precisa hasta los segundos y sigue el estándar ISO 8601 en el formato AAAA-MM-DDTHH:mm:ssZ. La hora se muestra en UTC.	2020-05-18T03:11:39Z
ScalingActivityId	string	El ID de la actividad de escalado cuando la instancia de ECS se agregó al grupo de escalado.	asa-bp1c9djwrgxjyk31****
ScalingInstanceId	string	La identidad de la instancia en el grupo de escalado, que se corresponde uno a uno con el ID de la instancia de ECS o la instancia de contenedor elástico.	asi-j6cj1gcte640ekhb****
PrivateIpAddress	string	La dirección IP interna de la instancia en el grupo de escalado.	1*.2.1.2
ReplaceStatus	string	El proceso de reemplazo de instancia en el que se encuentra la instancia. Valores válidos: Normal: La instancia no se encuentra en ningún proceso de reemplazo. ReBalance: La instancia se encuentra en el proceso de reemplazo de reequilibrio del grupo de escalado. SpotRemedy: La instancia se encuentra en el proceso de reemplazo de remedio de instancia spot. MaxInstanceLifetimeExpire: La instancia se encuentra en el proceso de reemplazo debido a la expiración de la vida útil máxima de la instancia. InstanceRefresh: La instancia se encuentra en el proceso de reemplazo de actualización de instancia. SpotReplaceOnDemand: La instancia se encuentra en el proceso de reemplazo de una instancia spot por una instancia de pago por uso.	ReBalance

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "B13527BF-1FBD-4334-A512-20F5E9D3****",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalSpotCount": 4,
  "TotalCount": 1,
  "ScalingInstances": [
    {
      "CreationTime": "2020-05-18T03:11Z",
      "LoadBalancerWeight": 50,
      "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****",
      "InstanceId": "i-bp109k5j3dum1ce6****",
      "SpotStrategy": "SpotWithPriceLimit",
      "LaunchTemplateVersion": "1",
      "HealthStatus": "Healthy",
      "ScalingGroupId": "asg-bp1igpak5ft1flyp****",
      "WarmupState": "NoNeedWarmup",
      "LifecycleState": "InService",
      "CreationType": "AutoCreated",
      "ZoneId": "cn-hangzhou-g",
      "ScalingConfigurationId": "asc-bp1i65jd06v04vdh****",
      "Entrusted": true,
      "WeightedCapacity": 4,
      "CreatedTime": "2020-05-18T03:11:39Z",
      "ScalingActivityId": "asa-bp1c9djwrgxjyk31****",
      "ScalingInstanceId": "asi-j6cj1gcte640ekhb****",
      "PrivateIpAddress": "1**.2*.1**.2**",
      "ReplaceStatus": "ReBalance"
    }
  ]
}

Códigos de error

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.