TriggersCollection
更新时间： 2026/06/29
在Gitcode上查看源码ResourceDefinition
uris
/redfish/v1/TelemetryService/Triggers
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | Triggers资源模型的OData描述信息 |
| @odata.id | string | true | - | Triggers资源节点的访问路径 |
| @odata.type | string | true | - | Triggers资源类型 |
| Name | string | false | - | 触发器集合资源名称 |
| Members | object | true | - | 触发器集合资源成员 |
| Members@odata.count | int | true | - | 触发器集合资源成员总数 |
supported_methods
- GET
- POST
HTTP methods
GET
命令功能
查询触发器集合资源信息
说明
BMC300 5.9.0.1及以上版本支持
命令格式
URL: https://device_ip/redfish/v1/TelemetryService/Triggers
请求头:
X-Auth-Token: auth_value请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 执行该GET请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/TelemetryService/Triggers请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#TriggersCollection.TriggersCollection",
"@odata.id": "/redfish/v1/TelemetryService/Triggers",
"@odata.type": "#TriggersCollection.TriggersCollection",
"Name": "Triggers",
"Members@odata.count": 2,
"Members": [
{
"@odata.id": "/redfish/v1/TelemetryService/Triggers/CPUUsageTriggers"
},
{
"@odata.id": "/redfish/v1/TelemetryService/Triggers/MemoryUsageTriggers"
}
]
}响应码：200
POST (CREATE)
命令功能
创建触发器
说明
BMC300 5.9.0.1及以上版本支持
命令格式
URL: https://device_ip/redfish/v1/TelemetryService/Triggers
请求头:
X-Auth-Token: auth_value
Content-Type: header_type请求消息体:
json
{
"Id": id,
"Name": name,
"Description": description,
"Links": {
"MetricReportDefinitions": [
{
"@odata.id": metricreportdefinitions_value
}
]
},
"MetricIds": metricids_value,
"MetricType": metrictype_value,
"NumericThresholds": {
"LowerCritical": {
"Reading": lowercritical_reading_value,
"Activation": lowercritical_activation_value,
"DwellTime": lowercritical_dwelltime_value
},
"LowerWarning": {
"Reading": lowerwarning_reading_value,
"Activation": lowerwarning_activation_value,
"DwellTime": lowerwarning_dwelltime_value
},
"UpperCritical": {
"Reading": uppercritical_reading_value,
"Activation": uppercritical_activation_value,
"DwellTime": uppercritical_dwelltime_value
},
"UpperWarning": {
"Reading": upperwarning_reading_value,
"Activation": upperwarning_activation_value,
"DwellTime": upperwarning_dwelltime_value
}
},
"TriggerActions": triggeractions_value,
"TriggerEnabled": triggerenabled_value
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| id | 新建触发器Id | 字符串，只能由大小写字母、数字和下划线组成，长度为1-64 |
| name | 新建触发器名称 | 字符串，长度为1-64 |
| description | 新建触发器描述 | 可选，字符串，最长不超过128个字符 |
| metricreportdefinitions_value | 触发器关联的指标报告定义 | 可选，字符串 |
| metricids_value | 触发器引用的指标项定义Id | 可选，字符串数组，字符串长度为1-64 |
| metrictype_value | 触发器类型 | 可选，字符串，支持：Numeric |
| lowercritical_reading_value | 低值严重告警门限值 | 可选，数字 |
| lowercritical_activation_value | 低值严重告警触发门限方向 | 可选，字符串，支持：Increasing、Decreasing、Either、Disabled |
| lowercritical_dwelltime_value | 低值严重告警触发门限违反多长时间后触发器被激活 | 可选，字符串 |
| lowerwarning_reading_value | 低值一般告警门限值 | 可选，数字 |
| lowerwarning_activation_value | 低值一般告警触发门限方向 | 可选，字符串，支持：Increasing、Decreasing、Either、Disabled |
| lowerwarning_dwelltime_value | 低值一般告警触发门限违反多长时间后触发器被激活 | 可选，字符串 |
| uppercritical_reading_value | 高值严重告警门限值 | 可选，数字 |
| uppercritical_activation_value | 高值严重告警触发门限方向 | 可选，字符串，支持：Increasing、Decreasing、Either、Disabled |
| uppercritical_dwelltime_value | 高值严重告警触发门限违反多长时间后触发器被激活 | 可选，字符串 |
| upperwarning_reading_value | 高值一般告警门限值 | 可选，数字 |
| upperwarning_activation_value | 高值一般告警触发门限方向 | 可选，字符串，支持：Increasing、Decreasing、Either、Disabled |
| upperwarning_dwelltime_value | 高值一般告警触发门限违反多长时间后触发器被激活 | 可选，字符串 |
| triggeractions_value | 触发器触发后的行为 | 可选，数组，支持：RedfishEvent、RedfishMetricReport |
| triggerenabled_value | 触发器使能状态 | 可选，布尔值 |
使用指南
无
使用实例
请求样例：
http
POST https://device_ip/redfish/v1/TelemetryService/Triggers请求头：
X-Auth-Token: 123456789***********************
Content-Type: application/json请求消息体：
json
{
"Id": "MemoryUsageTrigger",
"Name": "Memory Usage Trigger",
"Description": "Trigger for memory usage.",
"Links": {
"MetricReportDefinitions": [
{
"@odata.id": "/redfish/v1/TelemetryService/MetricReportDefinitions/MemoryUsageReport"
}
]
},
"MetricIds": [
"MemoryUsage"
],
"MetricType": "Numeric",
"NumericThresholds": {
"UpperCritical": {
"Reading": 50,
"Activation": "Increasing",
"DwellTime": "PT0.001S"
},
"UpperWarning": {
"Reading": 45.5,
"Activation": "Increasing",
"DwellTime": "PT0.004S"
}
},
"TriggerActions": [
"RedfishMetricReport"
],
"TriggerEnabled": true
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Triggers.v1_4_0.Triggers",
"@odata.id": "/redfish/v1/TelemetryService/Triggers/MemoryUsageTriggers",
"@odata.type": "#Triggers.v1_4_0.Triggers",
"Id": "MemoryUsageTrigger",
"Name": "Memory Usage Trigger",
"Description": "Trigger for memory usage.",
"Links": {
"MetricReportDefinitions": [
{
"@odata.id": "/redfish/v1/TelemetryService/MetricReportDefinitions/MemoryUsageReport"
}
]
},
"MetricIds": [
"MemoryUsage"
],
"MetricType": "Numeric",
"NumericThresholds": {
"LowerCritical": {
"Reading": 0,
"Activation": "Disabled",
"DwellTime": "PT0S"
},
"LowerWarning": {
"Reading": 0,
"Activation": "Disabled",
"DwellTime": "PT0S"
},
"UpperCritical": {
"Reading": 50,
"Activation": "Increasing",
"DwellTime": "PT0.001S"
},
"UpperWarning": {
"Reading": 45.5,
"Activation": "Increasing",
"DwellTime": "PT0.004S"
}
},
"TriggerActions": [
"RedfishMetricReport"
],
"TriggerEnabled": true
}响应码：200