DescribeAlarms - Auto Scaling: Central de Documentação do Alibaba Cloud

Consulta as informações das tarefas acionadas por eventos.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ess:DescribeAlarms

get

*ScalingGroup.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região à qual a tarefa acionada por eventos pertence.	cn-qingdao
ScalingGroupId	string	Não	O ID do grupo de dimensionamento ao qual a tarefa acionada por eventos está associada.	asg-bp18p2yfxow2dloq****
AlarmTaskId	string	Não	O ID da tarefa acionada por eventos.	asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1**
State	string	Não	O estado da tarefa acionada por eventos. Valores válidos: ALARM: O alerta é acionado porque a condição de alerta é atendida. OK: O status é normal porque a condição de alerta não é atendida. INSUFFICIENT_DATA: Os dados são insuficientes para determinar se a condição de alerta é atendida.	OK
IsEnable	boolean	Não	Especifica se a tarefa acionada por eventos está ativada. Valores válidos: true: A tarefa acionada por eventos está ativada. false: A tarefa acionada por eventos está desativada.	true
MetricType	string	Não	O tipo da métrica. Valores válidos: system: métricas do sistema do CloudMonitor custom: métricas personalizadas reportadas ao CloudMonitor	system
MetricName	string	Não	O nome da métrica.	CpuUtilization
PageSize	integer	Não	O número de entradas por página em uma consulta paginada. Valor máximo: 50. Valor padrão: 10.	10
PageNumber	integer	Não	O número da página da lista de tarefas acionadas por eventos. As páginas começam a partir da página 1. Valor padrão: 1.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações das tarefas acionadas por eventos.
PageSize	integer	O número de entradas por página.	10
RequestId	string	O ID da solicitação.	871C7C53-34A4-45AA-8C14-4B72FA6A****
PageNumber	integer	O número da página atual.	1
TotalCount	integer	O número total de tarefas acionadas por eventos.	2
AlarmList	object
Alarm	array<object>	A lista de tarefas acionadas por eventos.
	array<object>	A lista de tarefas acionadas por eventos.
AlarmTaskId	string	O ID da tarefa acionada por eventos.	asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1**
MetricName	string	O nome da métrica. Valores válidos: CpuUtilization: a utilização de CPU de uma instância ECS (%). ConcurrentConnections: o número de conexões simultâneas para uma instância ECS. IntranetTx: o tráfego de saída pela rede interna de uma instância ECS (Kb/min). IntranetRx: o tráfego de entrada pela rede interna de uma instância ECS (Kb/min). VpcInternetTx: o tráfego de saída pela Internet de uma instância ECS conectada à VPC (Kb/min). VpcInternetRx: o tráfego de entrada pela Internet de uma instância ECS conectada à VPC (Kb/min). SystemDiskReadBps: o número de bytes lidos do disco em nuvem do sistema por segundo (Byte/s). SystemDiskWriteBps: o número de bytes gravados no disco em nuvem do sistema por segundo (Byte/s). SystemDiskReadOps: o número de operações de leitura no disco em nuvem do sistema por segundo (IOPS). SystemDiskWriteOps: o número de operações de gravação no disco em nuvem do sistema por segundo (IOPS). CpuUtilizationAgent: a utilização de CPU medida pelo agente do CloudMonitor (%). GpuUtilizationAgent: a utilização de GPU medida pelo agente do CloudMonitor (%). GpuMemoryFreeUtilizationAgent: a porcentagem de memória livre da GPU medida pelo agente do CloudMonitor (%). GpuMemoryUtilizationAgent: a utilização de memória da GPU medida pelo agente do CloudMonitor (%). MemoryUtilization: a utilização de memória medida pelo agente do CloudMonitor (%). LoadAverage: a carga média do sistema medida pelo agente do CloudMonitor. TcpConnection: o número total de conexões TCP medidas pelo agente do CloudMonitor. TcpConnection: o número de conexões TCP estabelecidas medidas pelo agente do CloudMonitor. PackagesNetOut: o número de pacotes enviados pela NIC da rede interna por segundo medido pelo agente do CloudMonitor. PackagesNetIn: o número de pacotes recebidos pela NIC da rede interna por segundo medido pelo agente do CloudMonitor. PackagesNetOut: o número de pacotes enviados pela NIC da Internet por segundo medido pelo agente do CloudMonitor. PackagesNetIn: o número de pacotes recebidos pela NIC da Internet por segundo medido pelo agente do CloudMonitor. EciPodCpuUtilization: a utilização de CPU (%). EciPodMemoryUtilization: a utilização de memória (%). LoadBalancerRealServerAverageQps: a média de consultas por segundo (QPS) por servidor backend em um grupo de servidores ALB. Para mais informações, consulte Tarefas acionadas por eventos de monitoramento do sistema.	CpuUtilization
EvaluationCount	integer	O número de vezes que a condição de limite deve ser atendida antes que a regra de dimensionamento seja acionada. Por exemplo, se este parâmetro for definido como 3, a regra de dimensionamento será acionada somente quando a utilização média de CPU for maior ou igual a 80% por três vezes consecutivas.	3
State	string	O estado da tarefa acionada por eventos. Valores válidos: ALARM: O alerta é acionado porque a condição de alerta é atendida. OK: O status é normal porque a condição de alerta não é atendida. INSUFFICIENT_DATA: Os dados são insuficientes para determinar se a condição de alerta é atendida.	ALARM
Period	integer	O período com base no qual os dados da métrica são coletados. Unidade: segundos. Valores válidos: 15 60 120 300 900 Nota Um período estatístico de 15 segundos é suportado apenas para grupos de dimensionamento que contêm instâncias ECS.	300
ScalingGroupId	string	O ID do grupo de dimensionamento ao qual a tarefa acionada por eventos está associada.	asg-bp18p2yfxow2dloq****
ComparisonOperator	string	O operador de comparação usado para comparar o valor da métrica com o limite. Valores válidos: Nota =: O valor da métrica é maior ou igual ao limite. <=: O valor da métrica é menor ou igual ao limite. Nota : O valor da métrica é maior que o limite. <: O valor da métrica é menor que o limite.	>=
Effective	string	O período de vigência da tarefa acionada por eventos.	* * * * * ?
Description	string	A descrição da tarefa acionada por eventos.	Test alarm task.
MetricType	string	O tipo da métrica. Valores válidos: system: métricas do sistema do CloudMonitor custom: métricas personalizadas reportadas ao CloudMonitor	system
Name	string	O nome da tarefa acionada por eventos.	TestAlarmTask
Threshold	number	O limite da métrica. Atender à expressão de limite pelo número especificado de vezes acionará a regra de dimensionamento.	80.0
Enable	boolean	Indica se a tarefa acionada por eventos está ativada. Valores válidos: true: A tarefa acionada por eventos está ativada. false: A tarefa acionada por eventos está desativada.	true
Statistics	string	O método estatístico usado para coletar dados da métrica. Valores válidos: Average: o valor médio Minimum: o valor mínimo Maximum: o valor máximo	Average
Dimensions	object
Dimension	array<object>	As informações de dimensão associadas à métrica.
	object	As informações de dimensão associadas à métrica.
DimensionKey	string	A chave da dimensão associada à métrica. Valores válidos: user_id: o ID da sua conta scaling_group: o grupo de dimensionamento monitorado device: o tipo da NIC state: o estado da conexão TCP	device
DimensionValue	string	O valor da dimensão associada à métrica. Os valores válidos são determinados pela chave da dimensão. user_id: preenchido automaticamente pelo sistema. scaling_group: preenchido automaticamente pelo sistema. Valores válidos para device: eth0: Para instâncias de rede clássica, eth0 indica a NIC interna. Para instâncias conectadas à VPC, apenas a NIC eth0 existe. eth1: Para instâncias de rede clássica, eth1 indica a NIC da Internet. Valores válidos para state: TCP_TOTAL: o número total de conexões TCP. ESTABLISHED: o número de conexões TCP estabelecidas.	eth0
AlarmActions	object
AlarmAction	array	A lista de identificadores exclusivos das regras de dimensionamento associadas à tarefa acionada por eventos.
	string	A lista de identificadores exclusivos das regras de dimensionamento associadas à tarefa acionada por eventos.	ari:acs:ess:cn-hangzhou:1406926474**:scalingrule/asr-bp163l21e07uh**
Expressions	object
Expression	array<object>	As informações sobre a regra de alerta de múltiplas métricas.
	object	As informações sobre a regra de alerta de múltiplas métricas.
MetricName	string	O nome da métrica para a regra de alerta de múltiplas métricas. Valores válidos: CpuUtilization: a utilização de CPU de uma instância ECS (%). ConcurrentConnections: o número de conexões simultâneas para uma instância ECS. IntranetTx: o tráfego de saída pela rede interna de uma instância ECS (Kb/min). IntranetRx: o tráfego de entrada pela rede interna de uma instância ECS (Kb/min). VpcInternetTx: o tráfego de saída pela Internet de uma instância ECS conectada à VPC (Kb/min). VpcInternetRx: o tráfego de entrada pela Internet de uma instância ECS conectada à VPC (Kb/min). SystemDiskReadBps: o número de bytes lidos do disco em nuvem do sistema por segundo (Byte/s). SystemDiskWriteBps: o número de bytes gravados no disco em nuvem do sistema por segundo (Byte/s). SystemDiskReadOps: o número de operações de leitura no disco em nuvem do sistema por segundo (IOPS). SystemDiskWriteOps: o número de operações de gravação no disco em nuvem do sistema por segundo (IOPS). CpuUtilizationAgent: a utilização de CPU medida pelo agente do CloudMonitor (%). GpuUtilizationAgent: a utilização de GPU medida pelo agente do CloudMonitor (%). GpuMemoryFreeUtilizationAgent: a porcentagem de memória livre da GPU medida pelo agente do CloudMonitor (%). GpuMemoryUtilizationAgent: a utilização de memória da GPU medida pelo agente do CloudMonitor (%). MemoryUtilization: a utilização de memória medida pelo agente do CloudMonitor (%). LoadAverage: a carga média do sistema medida pelo agente do CloudMonitor. TcpConnection: o número total de conexões TCP medidas pelo agente do CloudMonitor. TcpConnection: o número de conexões TCP estabelecidas medidas pelo agente do CloudMonitor. PackagesNetOut: o número de pacotes enviados pela controladora de interface de rede (NIC) interna por segundo medido pelo agente do CloudMonitor. PackagesNetIn: o número de pacotes recebidos pela controladora de interface de rede (NIC) interna por segundo medido pelo agente do CloudMonitor. PackagesNetOut: o número de pacotes enviados pela controladora de interface de rede (NIC) da Internet por segundo medido pelo agente do CloudMonitor. PackagesNetIn: o número de pacotes recebidos pela controladora de interface de rede (NIC) da Internet por segundo medido pelo agente do CloudMonitor. EciPodCpuUtilization: a utilização de CPU (%). EciPodMemoryUtilization: a utilização de memória (%). LoadBalancerRealServerAverageQps: a média de consultas por segundo (QPS) por servidor backend em um grupo de servidores ALB. Para mais informações, consulte Tarefas acionadas por eventos de monitoramento do sistema (nó).	CpuUtilization
ComparisonOperator	string	O operador de comparação usado para comparar o valor da métrica com o limite na regra de alerta de múltiplas métricas. Valores válidos: Nota =: O valor da métrica é maior ou igual ao limite. <=: O valor da métrica é menor ou igual ao limite. Nota : O valor da métrica é maior que o limite. <: O valor da métrica é menor que o limite. Valor padrão: >=.	>=
Period	integer	O período com base no qual os dados da métrica são coletados na regra de alerta de múltiplas métricas. Unidade: segundos. Valores válidos: 15 60 120 300 900 Nota Um período estatístico de 15 segundos é suportado apenas para grupos de dimensionamento que contêm instâncias ECS.	900
Statistics	string	O método estatístico usado para coletar dados da métrica na regra de alerta de múltiplas métricas. Valores válidos: Average: o valor médio Minimum: o valor mínimo Maximum: o valor máximo	Average
Threshold	number	O limite da métrica na regra de alerta de múltiplas métricas. Atender à expressão de limite pelo número especificado de vezes acionará a regra de dimensionamento.	40.0
ExpressionsLogicOperator	string	O operador lógico que especifica a relação entre múltiplas condições de alerta de métricas de monitoramento. Valores válidos: &&: Um alerta é acionado somente quando todas as métricas de monitoramento atendem às condições de alerta. Ou seja, um alerta é acionado somente quando todas as expressões na regra de alerta de múltiplas métricas são avaliadas como true. \|\|: Um alerta é acionado quando qualquer uma das métricas de monitoramento atende à condição de alerta.	&&
HybridMonitorNamespace	string	O ID do repositório de métricas de monitoramento para o Hybrid Cloud Monitor. Para gerenciar repositórios de métricas de monitoramento, consulte Gerenciar repositórios de métricas de monitoramento.	aliyun-test
HybridMetrics	object
HybridMetric	array<object>	As configurações de métricas de monitoramento para o Hybrid Cloud Monitor. Para mais informações sobre como definir as configurações, consulte Usar operações de fórmula para personalizar regras de dimensionamento de rastreamento de destino.
	array<object>
Id	string	O ID de referência da métrica na expressão de operação da métrica.	a
Expression	string	A expressão de operação da métrica para múltiplas métricas de monitoramento do Hybrid Cloud Monitor. O resultado do cálculo da expressão é usado para acionar o scale-out e o scale-in. A expressão de operação deve estar em conformidade com a especificação de Notação Polonesa Reversa (RPN), e apenas os operadores +, -, * e / são suportados.	(a+b)/2
MetricName	string	O nome das métricas de monitoramento no repositório do Hybrid Cloud Monitor.	AliyunSmq_NumberOfMessagesVisible
Statistic	string	O método estatístico da métrica. Valores válidos: Average: o valor médio de todos os pontos de dados dentro do período especificado. Minimum: o valor mínimo de todos os pontos de dados dentro do período especificado. Maximum: o valor máximo de todos os pontos de dados dentro do período especificado.	Average
Dimensions	object
Dimension	array<object>	A dimensão da métrica. É usada para especificar o recurso monitorado pela métrica.
	object
DimensionKey	string	A chave da dimensão da métrica.	queue
DimensionValue	string	O valor da dimensão da métrica.	testQueue
PromQL	string	A instrução de consulta PromQL para o Hybrid Cloud Monitor.	(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)

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 10,
  "RequestId": "871C7C53-34A4-45AA-8C14-4B72FA6A****",
  "PageNumber": 1,
  "TotalCount": 2,
  "AlarmList": {
    "Alarm": [
      {
        "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": {
          "Dimension": [
            {
              "DimensionKey": "device",
              "DimensionValue": "eth0"
            }
          ]
        },
        "AlarmActions": {
          "AlarmAction": [
            "ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp163l21e07uh****"
          ]
        },
        "Expressions": {
          "Expression": [
            {
              "MetricName": "CpuUtilization",
              "ComparisonOperator": ">=",
              "Period": 900,
              "Statistics": "Average",
              "Threshold": 40
            }
          ]
        },
        "ExpressionsLogicOperator": "&&",
        "HybridMonitorNamespace": "aliyun-test",
        "HybridMetrics": {
          "HybridMetric": [
            {
              "Id": "a",
              "Expression": "(a+b)/2",
              "MetricName": "AliyunSmq_NumberOfMessagesVisible",
              "Statistic": "Average",
              "Dimensions": {
                "Dimension": [
                  {
                    "DimensionKey": "queue",
                    "DimensionValue": "testQueue"
                  }
                ]
              }
            }
          ]
        },
        "PromQL": "(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)"
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.