PutResourceMetricRules - Cloud Monitor - Centro de documentación de Alibaba Cloud

Llama a la operación PutResourceMetricRules para crear múltiples reglas de alerta de umbral para una métrica especificada de un recurso especificado.

Descripción de la operación

Este tema proporciona un ejemplo de cómo crear una regla de alerta de umbral para la métrica cpu_total de la instancia de Elastic Computing Service (ECS) i-uf6j91r34rnwawoo**** en el espacio de nombres acs_ecs_dashboard. El grupo de contactos de alerta se establece en ECS_Group, el nombre de la regla de alerta se establece en test123, el ID de la regla de alerta se establece en a151cd6023eacee2f0978e03863cc1697c89508****, el método estadístico para el nivel Critical se establece en Average, el operador de comparación para el nivel Critical se establece en GreaterThanOrEqualToThreshold, el umbral para el nivel Critical se establece en 90 y el número de reintentos para el nivel Critical se establece en 3.

Nota

A partir del 15 de agosto de 2024, se agregó la validación de Statistics. Solo puede establecer el valor de statistics en el valor de Statistics que corresponde a la métrica. Para obtener más información sobre cómo obtener el valor de este parámetro, consulte Métricas de monitoreo de servicios de Alibaba Cloud.

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

cms:PutResourceMetricRules

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Rules	array<object>	Sí	La lista de reglas de alerta de umbral. Valores válidos de N: 1 a 50.
	array<object>	No	Ninguna.
Escalations.Info.Threshold	string	No	El umbral para las alertas de nivel Info. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	90
MetricName	string	No	El nombre de la métrica. Valores válidos de N: 1 a 50. Para obtener más información sobre cómo consultar nombres de métricas, consulte Métricas de monitoreo de servicios de Alibaba Cloud.	cpu_total
Escalations.Warn.Threshold	string	No	El umbral para las alertas de nivel Warn. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	90
EffectiveInterval	string	No	El período de vigencia de la regla de alerta. Valores válidos de N: 1 a 50.	00:00-23:59
NoEffectiveInterval	string	No	El intervalo de tiempo durante el cual la regla de alerta no está vigente. Valores válidos de N: 1 a 50.	00:00-06:00
RuleId	string	Sí	El ID de la regla de alerta. Valores válidos de N: 1 a 50. Puede ingresar un nuevo ID de regla de alerta o utilizar un ID de regla de alerta existente en CloudMonitor. Para obtener más información sobre cómo consultar ID de reglas de alerta, consulte DescribeMetricRuleList. Nota Si ingresa un nuevo ID de regla de alerta, se crea una regla de alerta de umbral.	a151cd6023eacee2f0978e03863cc1697c89508****
Escalations.Critical.Times	integer	No	El número de reintentos para las alertas de nivel Critical. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	3
Escalations.Critical.Threshold	string	No	El umbral para las alertas de nivel Critical. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	90
Escalations.Critical.Statistics	string	No	El método estadístico para las alertas de nivel Critical. Valores válidos de N: 1 a 50. El valor de este parámetro está determinado por la columna `Statistics` que corresponde al `MetricName` del servicio de Alibaba Cloud especificado. Ejemplos: Maximum, Minimum y Average. Para obtener más información sobre cómo obtener el valor de este parámetro, consulte Métricas de monitoreo de servicios de Alibaba Cloud. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical (crítico), Warn (advertencia) o Info (información). Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	Average
Escalations.Warn.ComparisonOperator	string	No	El operador de comparación para las alertas de nivel Warn. Valores válidos: GreaterThanOrEqualToThreshold: mayor o igual que el umbral. GreaterThanThreshold: mayor que el umbral. LessThanOrEqualToThreshold: menor o igual que el umbral. LessThanThreshold: menor que el umbral. NotEqualToThreshold: no igual al umbral. EqualToThreshold: igual al umbral. GreaterThanYesterday: mayor que el valor a la misma hora de ayer. LessThanYesterday: menor que el valor a la misma hora de ayer. GreaterThanLastWeek: mayor que el valor a la misma hora de la semana pasada. LessThanLastWeek: menor que el valor a la misma hora de la semana pasada. GreaterThanLastPeriod: mayor que el valor en el último período. LessThanLastPeriod: menor que el valor en el último período. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	GreaterThanOrEqualToThreshold
Escalations.Info.Times	integer	No	El número de reintentos para las alertas de nivel Info. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	3
Resources	string	Sí	La información del recurso, como `[{"instanceId":"i-uf6j91r34rnwawoo**"}]` o `[{"userId":"100931896542**"}]`. Valores válidos de N: 1 a 50. Para obtener más información sobre las dimensiones admitidas, consulte Métricas de monitoreo de servicios de Alibaba Cloud.	[{"instanceId":"i-uf6j91r34rnwawoo****"}]
SilenceTime	integer	No	El período de silencio. Unidad: segundos. Valor predeterminado: 86400. Valores válidos de N: 1 a 50. Nota El período de silencio especifica el intervalo en el que se envía nuevamente una notificación de alerta si la alerta no se ha resuelto.	86400
Webhook	string	No	La URL de callback a la que se envía una solicitud POST cuando se activa una alerta. Valores válidos de N: 1 a 50.	https://alert.aliyun.com.com:8080/callback
ContactGroups	string	Sí	El grupo de contactos de alerta. Las notificaciones de alerta se envían a los contactos de alerta del grupo de contactos de alerta. Valores válidos de N: 1 a 50. Nota Un grupo de contactos de alerta contiene uno o más contactos de alerta. Para obtener más información sobre cómo crear contactos de alerta y grupos de contactos de alerta, consulte PutContact y PutContactGroup.	ECS_Group
Namespace	string	Sí	El espacio de nombres de datos del servicio de Alibaba Cloud. Valores válidos de N: 1 a 50. Para obtener más información sobre cómo consultar el espacio de nombres de datos de un servicio de Alibaba Cloud, consulte Métricas de monitoreo de servicios de Alibaba Cloud.	acs_ecs_dashboard
EmailSubject	string	No	El asunto del correo electrónico de alerta. Valores válidos de N: 1 a 50.	Alerta de instancia de ECS
Period	string	No	El período estadístico de la métrica. Unidad: segundos. Valor predeterminado: el período de reporte original de la métrica. Valores válidos de N: 1 a 50. Nota Para obtener más información sobre cómo consultar el período estadístico de una métrica, consulte Métricas de monitoreo de servicios de Alibaba Cloud.	60
RuleName	string	Sí	El nombre de la regla de alerta. Valores válidos de N: 1 a 50. Puede ingresar un nuevo nombre de regla de alerta o utilizar un nombre de regla de alerta existente en CloudMonitor. Para obtener más información sobre cómo consultar nombres de reglas de alerta, consulte DescribeMetricRuleList. Nota Si ingresa un nuevo nombre de regla de alerta, se crea una regla de alerta de umbral.	test123
Escalations.Info.Statistics	string	No	El método estadístico para las alertas de nivel Info. Valores válidos de N: 1 a 50. El valor de este parámetro está determinado por la columna `Statistics` que corresponde al `MetricName` del servicio de Alibaba Cloud especificado. Ejemplos: Maximum, Minimum y Average. Para obtener más información sobre cómo obtener el valor de este parámetro, consulte Métricas de monitoreo de servicios de Alibaba Cloud. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical (crítico), Warn (advertencia) o Info (información). Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	Average
Escalations.Warn.Times	integer	No	El número de reintentos para las alertas de nivel Warn. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	3
Escalations.Info.ComparisonOperator	string	No	El operador de comparación para las alertas de nivel Info. Valores válidos: GreaterThanOrEqualToThreshold: mayor o igual que el umbral. GreaterThanThreshold: mayor que el umbral. LessThanOrEqualToThreshold: menor o igual que el umbral. LessThanThreshold: menor que el umbral. NotEqualToThreshold: no igual al umbral. EqualToThreshold: igual al umbral. GreaterThanYesterday: mayor que el valor a la misma hora de ayer. LessThanYesterday: menor que el valor a la misma hora de ayer. GreaterThanLastWeek: mayor que el valor a la misma hora de la semana pasada. LessThanLastWeek: menor que el valor a la misma hora de la semana pasada. GreaterThanLastPeriod: mayor que el valor en el último período. LessThanLastPeriod: menor que el valor en el último período. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	GreaterThanOrEqualToThreshold
Interval	string	No	El período de activación de la regla de alerta. Unidad: segundos. Valores válidos de N: 1 a 50. Nota Para obtener más información sobre cómo consultar el período estadístico de una métrica, consulte Métricas de monitoreo de servicios de Alibaba Cloud.	60
Escalations.Critical.ComparisonOperator	string	No	El operador de comparación para las alertas de nivel Critical. Valores válidos: GreaterThanOrEqualToThreshold: mayor o igual que el umbral. GreaterThanThreshold: mayor que el umbral. LessThanOrEqualToThreshold: menor o igual que el umbral. LessThanThreshold: menor que el umbral. NotEqualToThreshold: no igual al umbral. EqualToThreshold: igual al umbral. GreaterThanYesterday: mayor que el valor a la misma hora de ayer. LessThanYesterday: menor que el valor a la misma hora de ayer. GreaterThanLastWeek: mayor que el valor a la misma hora de la semana pasada. LessThanLastWeek: menor que el valor a la misma hora de la semana pasada. GreaterThanLastPeriod: mayor que el valor en el último período. LessThanLastPeriod: menor que el valor en el último período. Valores válidos de N: 1 a 50. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical, Warn o Info. Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	GreaterThanOrEqualToThreshold
Escalations.Warn.Statistics	string	No	El método estadístico para las alertas de nivel Warn. Valores válidos de N: 1 a 50. El valor de este parámetro está determinado por la columna `Statistics` que corresponde al `MetricName` del servicio de Alibaba Cloud especificado. Ejemplos: Maximum, Minimum y Average. Para obtener más información sobre cómo obtener el valor de este parámetro, consulte Métricas de monitoreo de servicios de Alibaba Cloud. Nota Debe especificar al menos uno de los siguientes niveles de alerta: Critical (crítico), Warn (advertencia) o Info (información). Para el nivel de alerta especificado, debe configurar todos los siguientes parámetros: Statistics, ComparisonOperator, Threshold y Times.	Average
NoDataPolicy	string	No	El método de procesamiento cuando no se encuentran datos de monitoreo. Valores válidos: KEEP_LAST_STATE (predeterminado): No se realiza ninguna acción. INSUFFICIENT_DATA: Se activa una alerta cuyo contenido es "Insufficient Data". OK: El estado se considera normal. Valores válidos de N: 1 a 50.	KEEP_LAST_STATE
Labels	array<object>	No	Cuando la métrica alcanza la condición de alerta y se activa una alerta, las etiquetas se escriben en la métrica y se muestran en la notificación de alerta.
	object	No	Ninguna.
Key	string	No	La clave de la etiqueta.	tagKey1
Value	string	No	El valor de la etiqueta. Nota El valor de la etiqueta admite parámetros de plantilla. Los parámetros de plantilla se reemplazan con los valores reales de las etiquetas.	ECS
SendOK	boolean	No	Especifica si se debe enviar una notificación de recuperación.	true

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Ninguna.
Code	string	El código de estado HTTP. Nota El valor 200 indica éxito.	200
Message	string	El mensaje de error.	El procesamiento de la solicitud falló debido a un error desconocido
RequestId	string	El ID de la solicitud.	15D1440E-BF24-5A41-93E4-36864635179E
Success	boolean	Indica si la operación se realizó correctamente. Valores válidos: true: La operación se realizó correctamente. false: La operación falló.	true
FailedListResult	object
Target	array<object>	La lista de resultados fallidos al configurar reglas de alerta en recursos.
	array<object>	Ninguna.
RuleId	string	El ID de la regla de alerta.	a151cd6023eacee2f0978e03863cc1697c89508****
Result	object	El resultado del fallo.
Code	string	El código de estado.	404
Message	string	El mensaje de error.	El procesamiento de la solicitud falló debido a un error desconocido
Success	boolean	Indica si la operación se realizó correctamente. Valores válidos: true: La operación se realizó correctamente. false: La operación falló.	false

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Code": "200",
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "15D1440E-BF24-5A41-93E4-36864635179E",
  "Success": true,
  "FailedListResult": {
    "Target": [
      {
        "RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
        "Result": {
          "Code": "404",
          "Message": "The request processing has failed due to some unknown error.",
          "Success": false
        }
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	%s	%s
422	%s	%s
499	%s	%s
500	InternalError	The request processing has failed due to some unknown error.
204	%s	%s
403	%s	%s
206	%s	%s
404	%s	%s
503	%s	%s
406	%s	%s

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.