USBMgmtService
更新时间： 2026/07/01
在Gitcode上查看源码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
请求头:
X-Auth-Token: auth_value请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
BMC300 5.3.0.1及以上版本支持此功能。 支持的服务器类型详见表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
请求头:
X-Auth-Token: auth_value
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"ServiceEnabled": ServiceEnabled_value,
"USBUncompressPassword": Password
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| ifmatch_value | 请求消息的匹配参数 | 可通过对相应资源发起GET操作，从响应头中获取（对应于“ETag”参数） |
| ServiceEnabled_value | USB管理服务使能状态 | ● true：使能，允许PC或手机接入BMC直连管理接口后访问BMC的网络 ● false：禁用，禁止PC或手机接入BMC直连管理接口后访问BMC的网络 |
| Password | U盘近端运维配置文件压缩密码 | 长度为1~32的字符串 |
使用指南
BMC300 5.3.0.1及以上版本支持此功能。 支持的服务器类型详见表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