USBMgmtService
更新时间： 2026/11/04
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Managers/manager_id/USBMgmtService
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | USBMgmtService资源模型的OData描述信息 |
| @odata.id | string | true | - | USBMgmtService资源的访问路径 |
| @odata.type | string | true | - | USBMgmtService资源的类型 |
| Description | string | true | - | USBMgmtService资源的描述 |
| Name | string | true | - | USBMgmtService资源的名称 |
| Id | string | true | - | USBMgmtService资源的ID |
| ServiceEnabled | boolean | false | - | USB管理服务是否使能 ● true: 使能，允许PC或手机接入BMC直连管理接口后访问BMC的网络 ● false: 禁用，禁止PC或手机接入BMC直连管理接口后访问BMC的网络 |
| USBDevicePresence | boolean | true | - | BMC直连管理接口上是否有USB设备在位 ● true:在位 ● false:不在位 |
| USBUncompressPassword | string | false | - | U盘近端运维配置文件压缩密码 |
supported_methods
- GET
- PATCH
HTTP methods
GET
命令功能
查询 USB 管理服务资源信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/USBMgmtService
请求头:
text
X-Auth-Token: auth_value请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
openUBMC 25.12 LTS及以上版本支持此功能。 支持的服务器类型详见表2-1。
使用实例
请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/USBMgmtService
X-Auth-Token: auth_value 请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#USBMgmtService.USBMgmtService",
"@odata.id": "/redfish/v1/Managers/1/USBMgmtService",
"@odata.type": "#USBMgmtService.v1_0_0.USBMgmtService",
"Description": "USB Mgmt Service",
"Name": "USBMgmtService",
"Id": "USBMgmtService",
"ServiceEnabled": true,
"USBDevicePresence": false,
"USBUncompressPassword": null
}响应码：200
PATCH
命令功能
修改 USB 管理服务资源信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/USBMgmtService
请求头:
text
X-Auth-Token: auth_value
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"ServiceEnabled": ServiceEnabled_value,
"USBUncompressPassword": Password
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| ServiceEnabled | USB管理服务使能状态 | ● true：使能，允许PC或手机接入BMC直连管理接口后访问BMC的网络 ● false：禁用，禁止PC或手机接入BMC直连管理接口后访问BMC的网络 |
| USBUncompressPassword | U盘近端运维配置文件压缩密码 | 长度为1~32的字符串 |
使用指南
openUBMC 25.12 LTS及以上版本支持此功能。 支持的服务器类型详见表2-1。
使用实例
请求样例： PATCH https://device_ip/redfish/v1/Managers/manager_id/USBMgmtService
X-Auth-Token: auth_value Content-Type: header_type If-Match: ifmatch_value 请求消息体：
json
{
"ServiceEnabled": ServiceEnabled_value,
"USBUncompressPassword": Password
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#USBMgmtService.USBMgmtService",
"@odata.id": "/redfish/v1/Managers/1/USBMgmtService",
"@odata.type": "#USBMgmtService.v1_0_0.USBMgmtService",
"Description": "USB Mgmt Service",
"Name": "USBMgmtService",
"Id": "USBMgmtService",
"ServiceEnabled": true,
"USBDevicePresence": false,
"USBUncompressPassword": null
}响应码：200