代码仓
中
ServiceRoot
更新时间: 2026/06/26
在AtomGit上查看源码

ResourceDefinition ​

uris ​

  • /redfish
  • /redfish/v1

properties ​

名称类型是否只读取值范围/枚举值说明
v1stringtrue-Redfish版本信息

supported_methods ​

  • GET
  • PATCH

HTTP methods ​

GET ​

命令功能

查询 Redfish 版本信息

命令格式

URL: https://device_ip/redfish

请求头:


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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址

使用指南

无

使用实例

请求样例:

http
GET https://device_ip/redfish

请求头:无

请求消息体:无

响应样例:

json
{
  "v1": "/redfish/v1/"
}

响应码:200

GET ​

命令功能

查询当前根服务资源

命令格式

URL: https://device_ip/redfish/v1

请求头:


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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址

使用指南

无

使用实例

请求样例:

http
GET https://device_ip/redfish/v1

请求头:无

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#ServiceRoot",
  "@odata.id": "/redfish/v1/",
  "@odata.type": "#ServiceRoot.v1_17_0.ServiceRoot",
  "Id": "RootService",
  "Name": "Root Service",
  "RedfishVersion": "1.20.1",
  "UUID": "2BFF4014-1DD2-11B2-818C-0018E1C5D866",
  "Systems": {
    "@odata.id": "/redfish/v1/Systems"
  },
  "Chassis": {
    "@odata.id": "/redfish/v1/Chassis"
  },
  "Managers": {
    "@odata.id": "/redfish/v1/Managers"
  },
  "Tasks": {
    "@odata.id": "/redfish/v1/TaskService"
  },
  "SessionService": {
    "@odata.id": "/redfish/v1/SessionService"
  },
  "AccountService": {
    "@odata.id": "/redfish/v1/AccountService"
  },
  "EventService": {
    "@odata.id": "/redfish/v1/EventService"
  },
  "Links": {
    "Sessions": {
      "@odata.id": "/redfish/v1/SessionService/Sessions"
    }
  },
  "UpdateService": {
    "@odata.id": "/redfish/v1/UpdateService"
  },
  "Registries": {
    "@odata.id": "/redfish/v1/Registries"
  },
  "JsonSchemas": {
    "@odata.id": "/redfish/v1/JSONSchemas"
  },
  "JobService": {
    "@odata.id": "/redfish/v1/JobService"
  },
  "Fabrics": {
    "@odata.id": "/redfish/v1/Fabrics"
  },
  "TelemetryService": {
    "@odata.id": "/redfish/v1/TelemetryService"
  },
  "ComponentIntegrity": {
    "@odata.id": "/redfish/v1/ComponentIntegrity"
  },
  "Vendor": "",
  "Product": "",
  "Oem": {
    "Public": {
      "SmsUpdateService": [
        {
          "@odata.id": "/redfish/v1/Sms/1/UpdateService"
        }
      ],
      "SystemOverview": {
        "@odata.id": "/redfish/v1/SystemOverview"
      },
      "PerformanceCollection": {
        "@odata.id": "/redfish/v1/PerformanceCollection"
      },
      "AssetService": {
        "@odata.id": "/redfish/v1/Oem/Public/AssetService"
      },
      "LCNService": {
        "@odata.id": "/redfish/v1/Oem/Public/LCNService"
      },
      "ObservabilityService": {
        "@odata.id": "/redfish/v1/Oem/Public/ObservabilityService"
      },
      "SecurityBanner": "WARNING! This system is PRIVATE and PROPRIETARY and may only be accessed by authorized users. Unauthorized use of the system is prohibited. The owner, or its agents, may monitor any activity or communication on the system. The owner, or its agents, may retrieve any information stored within the system. By accessing and using the system, you are consenting to such monitoring and information retrieval for law enforcement and other purposes.",
      "ProductName": "RH1288 V3",
      "ProductSerialNumber": "2M220100SL",
      "HostName": "BMC",
      "LanguageSet": "en,zh,fr,ja",
      "Copyright": "",
      "DownloadKVMLink": " ",
      "DocSupportFlag": true,
      "DomainName": [
        "",
        "",
        "",
        "",
        "",
        ""
      ],
      "ProductPicture": "img_01",
      "AccountLockoutDuration": 300,
      "ChassisHeightU": null,
      "FQDN": "BMC",
      "SmsName": "iBMA",
      "SoftwareName": "iBMC",
      "MajorVersion": "5",
      "StartupDurationSeconds": 160,
      "StartupState": "Completed"
    }
  }
}

响应码:200

PATCH ​

命令功能

修改当前根服务资源

命令格式

URL:https://device_ip/redfish/v1

请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value

请求消息体:

json
{
  "UUID": uuid_value
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
UUIDUUID值● 格式满足正则表达式:^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$
● 00000000-0000-0000-0000-000000000000代表恢复UUID为默认值
● 单板AC掉电后自动恢复为默认值

使用指南

无

使用实例

请求样例:

http
PATCH https://device_ip/redfish/v1

请求头:


X-Auth-Token: 123456789***********************
Content-Type: application/json
If-Match: W/"3d607e36"

请求消息体:

json
{
  "UUID": "11111111-1111-1111-1111-111111111111"
}

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#ServiceRoot",
  "@odata.id": "/redfish/v1/",
  "@odata.type": "#ServiceRoot.v1_17_0.ServiceRoot",
  "Id": "RootService",
  "Name": "Root Service",
  "RedfishVersion": "1.20.1",
  "UUID": "11111111-1111-1111-1111-111111111111",
  "Systems": {
    "@odata.id": "/redfish/v1/Systems"
  },
  "Chassis": {
    "@odata.id": "/redfish/v1/Chassis"
  },
  "Managers": {
    "@odata.id": "/redfish/v1/Managers"
  },
  "Tasks": {
    "@odata.id": "/redfish/v1/TaskService"
  },
  "SessionService": {
    "@odata.id": "/redfish/v1/SessionService"
  },
  "AccountService": {
    "@odata.id": "/redfish/v1/AccountService"
  },
  "EventService": {
    "@odata.id": "/redfish/v1/EventService"
  },
  "Links": {
    "Sessions": {
      "@odata.id": "/redfish/v1/SessionService/Sessions"
    }
  },
  "UpdateService": {
    "@odata.id": "/redfish/v1/UpdateService"
  },
  "Registries": {
    "@odata.id": "/redfish/v1/Registries"
  },
  "JsonSchemas": {
    "@odata.id": "/redfish/v1/JSONSchemas"
  },
  "JobService": {
    "@odata.id": "/redfish/v1/JobService"
  },
  "Fabrics": {
    "@odata.id": "/redfish/v1/Fabrics"
  },
  "Vendor": "",
  "Product": "",
  "Oem": {
    "Public": {
      "SystemOverview": {
        "@odata.id": "/redfish/v1/SystemOverview"
      },
      "PerformanceCollection": {
        "@odata.id": "/redfish/v1/PerformanceCollection"
      },
      "ObservabilityService": {
        "@odata.id": "/redfish/v1/Oem/Public/ObservabilityService"
      },
      "SecurityBanner": "WARNING! This system is PRIVATE and PROPRIETARY and may only be accessed by authorized users. Unauthorized use of the system is prohibited. The owner, or its agents, may monitor any activity or communication on the system. The owner, or its agents, may retrieve any information stored within the system. By accessing and using the system, you are consenting to such monitoring and information retrieval for law enforcement and other purposes.",
      "ProductName": "RH1288 V3",
      "ProductSerialNumber": "2M220100SL",
      "HostName": "BMC",
      "LanguageSet": "en,zh,fr,ja",
      "Copyright": "",
      "DownloadKVMLink": " ",
      "DocSupportFlag": true,
      "DomainName": [
        "",
        "",
        "",
        "",
        "",
        ""
      ],
      "ProductPicture": "img_01",
      "AccountLockoutDuration": 300,
      "KerberosEnabled": false,
      "FQDN": "BMC",
      "Smsname":"iBMA",

      "SoftwareName": "BMC"
    }
  }
}

响应码:200