代码仓
中
文档中心
SPDiagnose
更新时间： 2026/07/01
在AtomGit上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Managers/manager_id/SPService/SPDiagnose/1

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-诊断配置资源模型的OData描述信息
@odata.idstringtrue-诊断配置资源的访问路径
@odata.typestringtrue-诊断配置资源的类型
Diagnose [ {arrayfalse-诊断配置参数
Diagnose[].DeviceTypestringfalse-诊断项目，包括：
● CPU：对 CPU 进行诊断
● Memory：对内存进行诊断
● Disk：对磁盘进行诊断
● NIC：对网卡进行诊断
● NPU：对 NPU（神经网络处理单元）进行诊断
● Power：对电源进行诊断
● RAID：对 RAID 控制器进行诊断
Diagnose[].Modestringfalse-诊断类型，包括：
● Quick：快速诊断模式，执行精简测试项，耗时较短
● Full：完整诊断模式，执行全部测试项，耗时较长
● FullWithoutNic：完整诊断模式（不含网卡测试），跳过 NIC 测试项
● QuickWithoutNic：快速诊断模式（不含网卡测试），跳过 NIC 测试项
● Customized：自定义诊断模式，由用户指定测试项组合
Diagnose[].DurationMinutesnumberfalse-诊断时长，诊断CPU、RAID和内存时需要，单位是分钟。诊断CPU快速模式下缺省值为5，全量模式下缺省值为60，取值范围是1-10000的整数。诊断内存时缺省值为0，诊断RAID缺省值为60，取值范围是1-99999的整数说明SP版本Smart Provisioning 1.19.0及以上支持自定义RAID诊断时长
Diagnose[].SubItems[ ]arrayfalse-当诊断项为NPU并且诊断模式为Customized时，SubItems字段才生效， 该字段显示NPU各诊断子项的相关信息，字段内容与3.2.88创建SP服务的诊断配置中字段一致
Diagnose[].SubItems[].AssetVerification {objectfalse-核查资产类型，包括：
● CountVerification说明Smart Provisioning 1.20.0及后续版本支持核查资产
Diagnose[].SubItems[].AssetVerification.CountVerification[ ]arrayfalse-核查数量类型的资产信息说明Smart Provisioning 1.20.0及后续版本支持核查资产
Diagnose[].SubItems[].AssetVerification.CountVerification[].CountItemstringfalse-核查数量类型的资产信息子项，包括：
● Memory说明Smart Provisioning 1.20.0及后续版本支持核查资产
Diagnose[].SubItems[].AssetVerification.CountVerification[].CountValuenumberfalse-用户输入的期望值
● 针对Memory，取值范围为整数1-1000说明Smart Provisioning 1.20.0及后续版本支持核查资产
Diagnose[].SubItems[].AssetVerification.CountVerification[].ActionOnCompleted {objectfalse-诊断完成后执行动作，包括：
● LogDump：诊断完成后自动转储（Dump）日志数据
● RebootDelayMinutes说明Smart Provisioning 1.17.0及以上版本支持设置日志收集；Smart Provisioning 1.21.0及以上版本支持设置延迟重启。
Diagnose[].SubItems[].AssetVerification.CountVerification[].ActionOnCompleted.LogDump {objectfalse-设置日志收集，包括：
● DumpEnabled：启用日志转储（Dump）功能，允许在诊断完成后收集并保存日志数据
● PushTimeoutMinutes说明Smart Provisioning 1.17.0及以上版本支持设置日志收集；
Diagnose[].SubItems[].AssetVerification.CountVerification[].ActionOnCompleted.LogDump.DumpEnabledbooleanfalse-是否使能日志导出。 说明Smart Provisioning 1.17.0及以上版本支持此字段
Diagnose[].SubItems[].AssetVerification.CountVerification[].ActionOnCompleted.LogDump.PushTimeoutMinutesnumberfalse-日志导出超时时间，单位为分钟。范围为0~1440。 说明Smart Provisioning 1.17.0及以上版本支持此字段
Diagnose[].SubItems[].AssetVerification.CountVerification[].ActionOnCompleted.LogDump.RebootDelayMinutesnumberfalse-延迟重启时间，单位为分钟，取值范围是1-60分钟整数。 说明Smart Provisioning 1.21.0及以上版本支持此字段，整型
}
}
} ]
}
Diagnose[].SubItems[].ItemDurationMinutesnumbertrue-诊断子项的执行时长（分钟）
Diagnose[].SubItems[].ItemExecuteTimesnumbertrue-诊断子项的执行次数
Diagnose[].SubItems[].ItemModestringtrue-诊断子项的模式
Diagnose[].SubItems[].ItemNamestringtrue-诊断子项的名称
} ]
} ]

supported_methods ​

  • GET

HTTP methods ​

GET ​

命令功能

查询 SP 服务的诊断配置资源

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDiagnose/1

请求头:

X-Auth-Token: auth_value

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
auth_value请求消息的鉴权参数可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

GA140C机型不支持 SP版本和机型兼容性列表详见Smart Provisioning用户指南

使用实例

请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDiagnose/1

X-Auth-Token: auth_value 请求消息体：无

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#Managers/Members/1/SPService/SPDiagnose/Members/$entity",
  "@odata.id": "/redfish/v1/Managers/1/SPService/SPDiagnose/1",
  "@odata.type": "#HwSPDiagnose.v1_0_0.HwSPDiagnose",
  "Diagnose": [
    {
      "DeviceType": "CPU",
      "Mode": "Quick",
      "DurationMinutes": 100
    },
    {
      "DeviceType": "NPU",
      "Mode": "Customized",
      "SubItems": [
        {
          "ItemName": "HbmStress",
          "ItemDurationMinutes": 300
        },
        {
          "ItemName": "TDP",
          "ItemDurationMinutes": 100
        },
        {
          "ItemName": "Aicore",
          "ItemExecuteTimes": 1,
          "ItemMode": "Standard",
          "AssetVerification": {
            "CountVerification": [
              {
                "CountItem": "Memory",
                "CountValue": 10,
                "ActionOnCompleted": {
                  "LogDump": {
                    "DumpEnabled": true,
                    "PushTimeoutMinutes": 60,
                    "RebootDelayMinutes": 10
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}

响应码：200

下一篇探索openUBMC