DataAcquisitionReport
更新时间: 2026/06/26
在Gitcode上查看源码

ResourceDefinition

uris

  • /redfish/v1/DataAcquisitionService/DataAcquisitionReport

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-数据表资源模型的OData描述信息
@odata.idstringtrue-数据表资源节点的访问路径
@odata.typestringtrue-数据表资源类型
Idstringtrue-数据表资源的ID
Namestringtrue-数据表资源的名称
Dataarraytrue-数据列表
Data[].@odata.idstringtrue-资源索引。当component参数值为OpticalModule时,资源索引返回的是网口资源,而非光模块资源
Data[].IndicatorLEDstringtrueLit,Off,Blinking,Unknown指定机箱资源的定位指示灯的状态
Data.MetricInfoarraytrue-Metric信息列表
Data[].MetricInfo.TypestringtrueTemperature,Voltage,Current,Performance Indicator,Health Status Indicator,Log,SmartMetric类型
Data[].MetricInfo.Sourcestringtrue-Metric对应的资源名称
Data[].MetricInfo.CacheIntervalSecnumbertrue-采集频率,单位秒
Data[].MetricInfo.CacheIntervalHournumbertrue-采集间隔时长,单位小时
Data[].MetricInfo.UpperThresholdFatalstringtrue-致命告警上门限值
Data[].MetricInfo.UpperThresholdCriticalstringtrue-紧急告警上门限值
Data[].MetricInfo.UpperThresholdNonCriticalstringtrue-非紧急告警上门限值
Data[].MetricInfo.LowerThresholdNonCriticalstringtrue-非紧急告警下门限值
Data[].MetricInfo.LowerThresholdCriticalstringtrue-紧急告警下门限值
Data[].MetricInfo.LowerThresholdFatalstringtrue-致命告警下门限值
Data[].TagInfoobjecttrue-Tag信息
Data[].TagInfo.TypestringtrueCPU,Memory,Disk,Mainboard,PSU,Chassis,System,Fan,OpticalModule,NPU部件类型
Data[].TagInfo.SystemIdstringtrue-采集到的部件的系统资源的ID
Data.TagInfo.Classificationsarraytrue-分类信息
Data[].TagInfo.Classifications.PropertyNamestringtrue-分类属性名称
Data[].TagInfo.Classifications.PropertyValuestringtrue-分类属性值
Data.TagInfo.Identificationsarraytrue-标识信息
Data[].TagInfo.Identifications.PropertyNamestringtrue-标识属性名称
Data[].TagInfo.Identifications.PropertyValuestringtrue-标识属性值
Data.DataPointarraytrue-采集到的部件相关指标的数据
Data[].DataPoint.TypestringtrueTemperature,Voltage,Current,Performance Indicator,Health Status Indicator,Log,SmartMetric类型
Data[].DataPoint.Sourcestringtrue-Metric对应的资源名称
Data[].DataPoint.TimeStampnumbertrue-时间戳
Data[].DataPoint.Valuestringtrue-部件对应指标该时间点采集到的数据

supported_methods

  • GET

HTTP methods

GET

命令功能

查询数据表资源信息

说明

  1. 当查询参数EndTime与StartTime的时间间隔大于对应查询指标的最大查询时间段TimeLimit时,返回EndTime – TimeLimit到EndTime时间范围内的数据采集结果。
  2. 该资源已屏蔽属性值频繁变化导致的事件上报。

命令格式

URL: https://device_ip/redfish/v1/DataAcquisitionService/DataAcquisitionReport?ComponentType=component&MetricType=metric&StartTime=start_time&EndTime=end_time

请求头:


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
auth_value请求消息的鉴权参数可通过/redfish/v1/SessionService/Sessions创建会话时获得
component需要查询的部件名,未指定时默认查询所有部件CPU、Memory、Disk、Mainboard、PSU、Chassis、System、Fan、OpticalModule、NPU
metric需要查询的指标类型,未指定时默认查询所有指标Temperature:温度;Voltage:电压;Current:电流;Performance:部件性能指标;Health:内存的health信息可查询6小时以内的数据,其他类型数据仅支持20分钟时间内的数据查询;Log:内存和系统的ErrorLog,可查询6小时以内的数据;硬盘的Log信息可查询24小时内的数据;Smart:硬盘的Smart信息,可查询6小时以内的数据
start_time起始时间时间戳
end_time结束时间时间戳

使用指南

使用实例

请求样例:

http
GET https://device_ip/redfish/v1/DataAcquisitionService/DataAcquisitionReport?ComponentType=CPU&MetricType=Performance&StartTime=1501416640&EndTime=1501416940

请求头:


X-Auth-Token: 123456789***********************

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#HwDataAcquisitionReport.HwDataAcquisitionReport",
  "@odata.type": "#HwDataAcquisitionReport.v1_0_0.HwDataAcquisitionReport",
  "@odata.id": "/redfish/v1/DataAcquisitionService/DataAcquisitionReport",
  "Id": "DataAcquisitionReport",
  "Name": "Data Acquisition Report",
  "Data": [
    {
      "@odata.id": "/redfish/v1/Systems/Blade14/Processors/1",
      "MetricInfo": [
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "CacheIntervalSec": 60,
          "CacheIntervalHour": 336,
          "UpperThresholdFatal": "",
          "LowerThresholdFatal": "",
          "UpperThresholdCritical": "",
          "LowerThresholdCritical": "",
          "UpperThresholdNonCritical": "",
          "LowerThresholdNonCritical": ""
        }
      ],
      "TagInfo": {
        "Type": "CPU",
        "SystemId": "Blade14",
        "Classifications": [
          {
            "PropertyName": "CoreCount",
            "PropertyValue": "24"
          },
          {
            "PropertyName": "Manufacturer",
            "PropertyValue": "Intel(R) Corporation"
          },
          {
            "PropertyName": "MaxSpeed",
            "PropertyValue": "3500 MHz"
          },
          {
            "PropertyName": "ThreadCount",
            "PropertyValue": "48"
          },
          {
            "PropertyName": "Version",
            "PropertyValue": "Intel(R) Xeon(R) Gold 6252 CPU "
          }
        ],
        "Identifications": [
          {
            "PropertyName": "DeviceName",
            "PropertyValue": "CPU1"
          },
          {
            "PropertyName": "SN",
            "PropertyValue": "Unknown"
          }
        ]
      },
      "DataPoint": [
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483703,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483763,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483823,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483883,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483943,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484003,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484063,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484123,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484183,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484243,
          "Value": "65535.000"
        }
      ]
    },
    {
      "@odata.id": "/redfish/v1/Systems/Blade14/Processors/2",
      "MetricInfo": [
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "CacheIntervalSec": 60,
          "CacheIntervalHour": 336,
          "UpperThresholdFatal": "",
          "LowerThresholdFatal": "",
          "UpperThresholdCritical": "",
          "LowerThresholdCritical": "",
          "UpperThresholdNonCritical": "",
          "LowerThresholdNonCritical": ""
        }
      ],
      "TagInfo": {
        "Type": "CPU",
        "SystemId": "Blade14",
        "Classifications": [
          {
            "PropertyName": "CoreCount",
            "PropertyValue": "24"
          },
          {
            "PropertyName": "Manufacturer",
            "PropertyValue": "Intel(R) Corporation"
          },
          {
            "PropertyName": "MaxSpeed",
            "PropertyValue": "3500 MHz"
          },
          {
            "PropertyName": "ThreadCount",
            "PropertyValue": "48"
          },
          {
            "PropertyName": "Version",
            "PropertyValue": "Intel(R) Xeon(R) Gold 6252 CPU "
          }
        ],
        "Identifications": [
          {
            "PropertyName": "DeviceName",
            "PropertyValue": "CPU2"
          },
          {
            "PropertyName": "SN",
            "PropertyValue": "Unknown"
          }
        ]
      },
      "DataPoint": [
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483703,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483763,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483823,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483883,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547483943,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484003,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484063,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484123,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484183,
          "Value": "65535.000"
        },
        {
          "Type": "Performance Indicator",
          "Source": "cpu.cpuusage",
          "TimeStamp": 1547484243,
          "Value": "65535.000"
        }
      ]
    }
  ]
}

响应码:200