ServiceRoot
更新时间: 2026/06/26
在AtomGit上查看源码ResourceDefinition
uris
/redfish/redfish/v1
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| v1 | string | true | - | 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
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| UUID | UUID值 | ● 格式满足正则表达式:^[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