Todos os produtos
Search
Central de documentação

Auto Scaling:DescribeAlarms

Última atualização: Jul 03, 2026

Consulta tarefas acionadas por eventos, incluindo configurações e alterações nos dados de monitoramento. Use esta operação para detectar anomalias de recursos do sistema antecipadamente e garantir a estabilidade e a confiabilidade do ambiente.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Yes

DescribeAlarms

Operação a ser executada. Defina o valor como DescribeAlarms.

RegionId

String

Yes

cn-qingdao

ID da região da tarefa acionada por evento.

ScalingGroupId

String

No

asg-bp18p2yfxow2dloq****

ID do grupo de dimensionamento monitorado pela tarefa acionada por evento.

AlarmTaskId

String

No

asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1**

ID da tarefa acionada por evento.

State

String

No

OK

Status da tarefa acionada por evento. Valores válidos:

  • ALARM: condição de alerta atendida e alerta acionado.

  • OK: condição de alerta não atendida.

  • INSUFFICIENT_DATA: o Auto Scaling não consegue determinar se a condição de alerta foi atendida devido à insuficiência de dados.

IsEnable

Boolean

No

true

Especifica se o recurso de tarefa acionada por evento está ativado. Valores válidos:

  • true: ativa o recurso de tarefa acionada por evento.

  • false: desativa o recurso de tarefa acionada por evento.

MetricType

String

No

system

Tipo de métrica usada pela tarefa acionada por evento. Valores válidos:

  • system: métricas de sistema do CloudMonitor.

  • custom: métricas personalizadas relatadas ao CloudMonitor.

MetricName

String

No

CpuUtilization

Nome da métrica.

PageSize

Integer

No

10

Número de entradas por página. Valor máximo: 50.

Valor padrão: 10.

PageNumber

Integer

No

1

Número da página. Valor mínimo: 1.

Valor padrão: 1.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

PageSize

Integer

10

Número de entradas por página.

RequestId

String

871C7C53-34A4-45AA-8C14-4B72FA6A****

ID da solicitação.

PageNumber

Integer

1

Número da página.

TotalCount

Integer

2

Número total de tarefas acionadas por evento.

AlarmList

Array of Alarm

Tarefas acionadas por evento.

Alarm

AlarmTaskId

String

asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1**

ID da tarefa acionada por evento.

MetricName

String

CpuUtilization

Nome da métrica. Valores válidos:

  • CpuUtilization (ECS): utilização da CPU. Unidade: %.

  • ConcurrentConnections (ECS): número de conexões simultâneas.

  • IntranetTx (ECS): tráfego de saída em rede interna. Unidade: KB/min.

  • IntranetRx (ECS): tráfego de entrada em rede interna. Unidade: KB/min.

  • VpcInternetTx (ECS): tráfego de saída em uma Virtual Private Cloud (VPC). Unidade: KB/min.

  • VpcInternetRx (ECS): tráfego de entrada em uma VPC. Unidade: KB/min.

  • SystemDiskReadBps (ECS): bytes lidos do disco do sistema por segundo.

  • SystemDiskWriteBps (ECS): bytes gravados no disco do sistema por segundo.

  • SystemDiskReadOps (ECS): IOPS de leitura do disco do sistema. Unidade: contagens/s.

  • SystemDiskWriteOps (ECS): IOPS de gravação do disco do sistema. Unidade: contagens/s.

  • CpuUtilizationAgent (Agent): utilização da CPU. Unidade: %.

  • GpuUtilizationAgent (Agent): utilização da GPU. Unidade: %.

  • GpuMemoryFreeUtilizationAgent (Agent): memória ociosa da GPU. Unidade: %.

  • GpuMemoryUtilizationAgent (Agent): uso de memória da GPU. Unidade: %.

  • MemoryUtilization (Agent): uso de memória. Unidade: %.

  • LoadAverage (Agent): carga média do sistema do agente.

  • TcpConnection (Agent): número total de conexões TCP.

  • TcpConnection (Agent): número de conexões TCP estabelecidas.

  • PackagesNetOut (Agent): pacotes enviados pela placa de interface de rede (NIC) interna. Unidade: contagens/s.

  • PackagesNetIn (Agent): pacotes recebidos pela NIC interna. Unidade: contagens/s.

  • PackagesNetOut (Agent): pacotes enviados pela NIC pública. Unidade: contagens/s.

  • PackagesNetIn (Agent): pacotes recebidos pela NIC pública.

  • EciPodCpuUtilization: utilização da CPU. Unidade: %.

  • EciPodMemoryUtilization: uso de memória. Unidade: %.

  • LoadBalancerRealServerAverageQps (ALB): consultas por segundo (QPS).

Para obter mais informações, consulte Tarefa acionada por evento para monitoramento do sistema.

EvaluationCount

Integer

3

Número de vezes que o limiar deve ser atingido antes da execução de uma regra de dimensionamento. Por exemplo, se este parâmetro for definido como 3, a utilização média da CPU deverá atingir 80% três vezes consecutivas antes que a regra seja executada.

State

String

ALARM

Status da tarefa acionada por evento. Valores válidos:

  • ALARM: condição de alerta atendida e alerta acionado.

  • OK: condição de alerta não atendida.

  • INSUFFICIENT_DATA: o Auto Scaling não consegue determinar se a condição de alerta foi atendida devido à insuficiência de dados.

Period

Integer

300

Período estatístico dos dados da métrica. Unidade: segundos. Valores válidos:

  • 15

  • 60

  • 120

  • 300

  • 900

Nota

Defina este parâmetro como 15 segundos apenas para grupos de dimensionamento do tipo ECS.

ScalingGroupId

String

asg-bp18p2yfxow2dloq****

ID do grupo de dimensionamento monitorado pela tarefa acionada por evento.

ComparisonOperator

String

>=

Operador usado para comparar o valor da métrica com o limiar.

  • Valor válido se o valor da métrica for maior ou igual ao limiar: >=.

  • Valor válido se o valor da métrica for menor ou igual ao limiar: <=.

  • Valor válido se o valor da métrica for maior que o limiar: >.

  • Valor válido se o valor da métrica for menor que o limiar: <.

Effective

String

* ?

Período durante o qual a tarefa acionada por evento permanece vigente.

Description

String

Test alarm task.

Descrição da tarefa acionada por evento.

MetricType

String

system

Tipo de métrica. Valores válidos:

  • system: métricas de sistema do CloudMonitor.

  • custom: métricas personalizadas relatadas ao CloudMonitor.

Name

String

TestAlarmTask

Nome da tarefa acionada por evento.

Threshold

Float

80.0

Limiar do valor da métrica. Se o limiar for atingido o número especificado de vezes dentro do período definido, uma regra de dimensionamento será executada.

Enable

Boolean

true

Indica se o recurso de tarefa acionada por evento está ativado. Valores válidos:

  • true: recurso de tarefa acionada por evento ativado.

  • false: recurso de tarefa acionada por evento desativado.

Statistics

String

Average

Método estatístico dos dados da métrica. Unidade: segundos. Valores válidos:

  • Average

  • Minimum

  • Maximum

Dimensions

Array of Dimension

Dimensões da métrica.

Dimension

DimensionKey

String

device

Chave de dimensão da métrica. Valores válidos:

  • user_id: ID da sua conta Alibaba Cloud.

  • scaling_group: grupo de dimensionamento monitorado.

  • device: tipo da NIC.

  • state: status da conexão TCP.

DimensionValue

String

eth0

Valor da dimensão da métrica. O valor deste parâmetro varia conforme o valor de DimensionKey.

  • user_id: o sistema especifica o valor.

  • scaling_group: o sistema especifica o valor.

  • Valores válidos para device:

    • eth0: NIC interna para instâncias na rede clássica. Existe apenas uma NIC eth0 em cada instância do tipo VPC.

    • eth1: NIC pública para instâncias na rede clássica.

Valores válidos para state:

  • TCP_TOTAL: número total de conexões TCP.

  • ESTABLISHED: número de conexões TCP estabelecidas.

AlarmActions

Array of String

ari:acs:ess:cn-hangzhou:1406926474**:scalingrule/asr-bp163l21e07uh**

Identificadores exclusivos das regras de dimensionamento associadas às tarefas acionadas por evento.

Expressions

Array of Expression

Expressões definidas na regra de alerta de múltiplas métricas.

Expression

MetricName

String

CpuUtilization

Nomes das métricas na regra de alerta de múltiplas métricas. Valores válidos:

  • CpuUtilization (ECS): utilização da CPU. Unidade: %.

  • ConcurrentConnections (ECS): número de conexões simultâneas.

  • IntranetTx (ECS): tráfego de saída em rede interna. Unidade: KB/min.

  • IntranetRx (ECS): tráfego de entrada em rede interna. Unidade: KB/min.

  • VpcInternetTx (ECS): tráfego de saída em uma VPC. Unidade: KB/min.

  • VpcInternetRx (ECS): tráfego de entrada em uma VPC. Unidade: KB/min.

  • SystemDiskReadBps (ECS): bytes lidos do disco do sistema por segundo.

  • SystemDiskWriteBps (ECS): bytes gravados no disco do sistema por segundo.

  • SystemDiskReadOps (ECS): IOPS de leitura do disco do sistema. Unidade: contagens/s.

  • SystemDiskWriteOps (ECS): IOPS de gravação do disco do sistema. Unidade: contagens/s.

  • CpuUtilizationAgent (Agent): utilização da CPU. Unidade: %.

  • GpuUtilizationAgent (Agent): utilização da GPU. Unidade: %.

  • GpuMemoryFreeUtilizationAgent (Agent): memória ociosa da GPU. Unidade: %.

  • GpuMemoryUtilizationAgent (Agent): uso de memória da GPU. Unidade: %.

  • MemoryUtilization (Agent): uso de memória. Unidade: %.

  • LoadAverage (Agent): carga média do sistema do agente.

  • TcpConnection (Agent): número total de conexões TCP.

  • TcpConnection (Agent): número de conexões TCP estabelecidas.

  • PackagesNetOut: pacotes enviados pela NIC interna. Unidade: contagens/s.

  • PackagesNetIn: pacotes recebidos pela NIC interna. Unidade: contagens/s.

  • PackagesNetOut: pacotes enviados pela NIC pública. Unidade: contagens/s.

  • PackagesNetIn (Agent): pacotes recebidos pela NIC pública.

  • EciPodCpuUtilization: utilização da CPU. Unidade: %.

  • EciPodMemoryUtilization: uso de memória. Unidade: %.

  • LoadBalancerRealServerAverageQps (ALB): QPS.

Para obter mais informações, consulte Tarefa acionada por evento para monitoramento do sistema.

ComparisonOperator

String

>=

Operador usado para comparar o valor da métrica com o limiar.

  • Valor válido se o valor da métrica for maior ou igual ao limiar: >=.

  • Valor válido se o valor da métrica for menor ou igual ao limiar: <=.

  • Valor válido se o valor da métrica for maior que o limiar: >.

  • Valor válido se o valor da métrica for menor que o limiar: <.

Valor padrão: >=.

Period

Integer

900

Período estatístico dos dados da métrica na regra de alerta de múltiplas métricas. Unidade: segundos. Valores válidos:

  • 15

  • 60

  • 120

  • 300

  • 900

Nota

Defina este parâmetro como 15 segundos apenas para grupos de dimensionamento do tipo ECS.

Statistics

String

Average

Método estatístico dos dados da métrica na regra de alerta de múltiplas métricas. Valores válidos:

  • Average

  • Minimum

  • Maximum

Threshold

Float

40.0

Limiares dos valores das métricas na regra de alerta de múltiplas métricas. Se os limiares forem atingidos o número especificado de vezes dentro do período estatístico, uma regra de dimensionamento será executada.

ExpressionsLogicOperator

String

&&

Lógica de acionamento de alerta da regra de alerta de múltiplas métricas. Valores válidos:

  • &&: um alerta é acionado somente se todas as métricas na regra de alerta de múltiplas métricas atenderem às condições de acionamento. Nesse caso, o alerta ocorre apenas se os resultados de todas as condições especificadas na regra forem true.

  • ||: um alerta é acionado se pelo menos uma das métricas na regra de alerta de múltiplas métricas atender à condição de acionamento.

HybridMonitorNamespace

String

aliyun-test

ID do namespace do Hybrid Cloud Monitoring.

Para obter informações sobre como gerenciar namespaces do Hybrid Cloud Monitoring, consulte Gerenciar namespaces.

HybridMetrics

Array of HybridMetric

Métricas do Hybrid Cloud Monitoring. Para obter mais informações, consulte Criar uma regra de dimensionamento de rastreamento de destino personalizada.

HybridMetric

Id

String

a

ID de referência da métrica na expressão da métrica.

Expression

String

(a+b)/2

Expressão da métrica composta por múltiplas métricas do Hybrid Cloud Monitoring. Calcula um resultado usado para acionar eventos de dimensionamento.

A expressão usa o formato Notação Polonesa Reversa (RPN) e inclui apenas os seguintes operadores: +, -, *, /.

MetricName

String

AliyunSmq_NumberOfMessagesVisible

Nome da métrica do Hybrid Cloud Monitoring.

Statistic

String

Average

Método estatístico do valor da métrica. Valores válidos:

  • Average

  • Minimum

  • Maximum

Dimensions

Array of Dimension

Dimensões da métrica. Use este parâmetro para especificar os recursos monitorados.

Dimension

DimensionKey

String

queue

Chave de dimensão da métrica.

DimensionValue

String

testQueue

Valor da dimensão da métrica.

PromQL

String

(avg(last_over_time(AliyunMnsnew_ActiveMessages{region='cn-hangzhou',userId='123456**',queue='testQueue'}[900s])) by (userId))/(avg(last_over_time(AliyunEss_RunningInstanceCount{instanceId='asg-bp1**'}[900s])) by (userId) != 0)

Instrução PromQL do Hybrid Cloud Monitoring.

Exemplos

Solicitações de exemplo

http(s)://ess.aliyuncs.com/?Action=DescribeAlarms
&RegionId=cn-qingdao
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&AlarmTaskId=asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****
&State=OK
&IsEnable=true
&MetricType=system
&MetricName=CpuUtilization
&PageSize=10
&PageNumber=1
&<Common request parameters>

Respostas de sucesso de exemplo

XML formato

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

<DescribeAlarmsResponse>
    <PageSize>10</PageSize>
    <RequestId>871C7C53-34A4-45AA-8C14-4B72FA6A****</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <AlarmList>
        <AlarmTaskId>asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****</AlarmTaskId>
        <MetricName>CpuUtilization</MetricName>
        <EvaluationCount>3</EvaluationCount>
        <State>ALARM</State>
        <Period>300</Period>
        <ScalingGroupId>asg-bp18p2yfxow2dloq****</ScalingGroupId>
        <ComparisonOperator>&gt;=</ComparisonOperator>
        <Effective>* * * * * ?</Effective>
        <Description>Test alarm task.</Description>
        <MetricType>system</MetricType>
        <Name>TestAlarmTask</Name>
        <Threshold>80</Threshold>
        <Enable>true</Enable>
        <Statistics>Average</Statistics>
        <Dimensions>
            <DimensionKey>device</DimensionKey>
            <DimensionValue>eth0</DimensionValue>
        </Dimensions>
        <AlarmActions>ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp163l21e07uh****</AlarmActions>
        <Expressions>
            <MetricName>CpuUtilization</MetricName>
            <ComparisonOperator>&gt;=</ComparisonOperator>
            <Period>900</Period>
            <Statistics>Average</Statistics>
            <Threshold>40</Threshold>
        </Expressions>
        <ExpressionsLogicOperator>&amp;&amp;</ExpressionsLogicOperator>
    </AlarmList>
</DescribeAlarmsResponse>

JSON formato

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

{
  "PageSize" : 10,
  "RequestId" : "871C7C53-34A4-45AA-8C14-4B72FA6A****",
  "PageNumber" : 1,
  "TotalCount" : 2,
  "AlarmList" : [ {
    "AlarmTaskId" : "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
    "MetricName" : "CpuUtilization",
    "EvaluationCount" : 3,
    "State" : "ALARM",
    "Period" : 300,
    "ScalingGroupId" : "asg-bp18p2yfxow2dloq****",
    "ComparisonOperator" : ">=",
    "Effective" : "* * * * * ?",
    "Description" : "Test alarm task.",
    "MetricType" : "system",
    "Name" : "TestAlarmTask",
    "Threshold" : 80,
    "Enable" : true,
    "Statistics" : "Average",
    "Dimensions" : [ {
      "DimensionKey" : "device",
      "DimensionValue" : "eth0"
    } ],
    "AlarmActions" : [ "ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp163l21e07uh****" ],
    "Expressions" : [ {
      "MetricName" : "CpuUtilization",
      "ComparisonOperator" : ">=",
      "Period" : 900,
      "Statistics" : "Average",
      "Threshold" : 40
    } ],
    "ExpressionsLogicOperator" : "&&"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.