TpcmService
更新时间： 2026/09/24
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Managers/manager_id/SecurityService/TpcmService
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | TPCM服务的OData描述信息 |
| @odata.id | string | true | - | TPCM服务的访问路径 |
| @odata.type | string | true | - | TPCM服务的类型 |
| Description | string | true | - | TPCM服务的描述 |
| Id | string | true | - | TPCM服务的ID |
| Name | string | true | - | TPCM服务的名称 |
| TrustedCenterServerAddr | string | true | - | 可信中心服务器地址 |
| MeasureEnabled | boolean | true | - | 度量开关 |
| ControlPolicy | string | true | - | 固件度量失败后的控制策略 |
| TsbLicenseInfo { | object | true | - | - |
| TsbLicenseInfo.Tsb的license信息 | - | true | - | Tsb的license信息 |
| TsbLicenseInfo.LicenseType | number | true | - | - |
| TsbLicenseInfo.ExpiredTime | string | true | - | - |
| } | ||||
| LicenseType | number | true | - | License的类型：1-测试版，3-正式版 |
| ExpiredTime | string | true | - | License的到期时间 |
| ActualDigest { | object | true | - | - |
| ActualDigest.启动阶段固件的实际度量值 | - | true | - | 启动阶段固件的实际度量值 |
| ActualDigest.Bios | string | true | - | - |
| ActualDigest.Shim | string | true | - | - |
| ActualDigest.Grub | string | true | - | - |
| ActualDigest.GrubCfg | string | true | - | - |
| ActualDigest.Kernel | string | true | - | - |
| ActualDigest.Initrd | string | true | - | - |
| } | ||||
| Bios | string | true | - | Bios实际度量值 |
| Shim | string | true | - | Shim实际度量值 |
| Grub | string | true | - | Grub实际度量值 |
| GrubCfg | string | true | - | GrubCfg实际度量值 |
| Kernel | string | true | - | Kernel实际度量值 |
| Initrd | string | true | - | Initrd实际度量值 |
| StandardDigest { | object | true | - | - |
| StandardDigest.启动阶段固件的基准值 | - | true | - | 启动阶段固件的基准值 |
| StandardDigest.Bios | string | true | - | - |
| StandardDigest.Shim | string | true | - | - |
| StandardDigest.Grub | string | true | - | - |
| StandardDigest.GrubCfg | string | true | - | - |
| StandardDigest.Kernel | string | true | - | - |
| StandardDigest.Initrd | string | true | - | - |
| } |
supported_methods
- GET
- PATCH
HTTP methods
GET
命令功能
查询TPCM服务信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| manager_id | 管理资源ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号） ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
| header_type | 请求消息的格式 | 支持的消息格式包括： ● application/json ● application/json;charset=utf-8 |
使用指南
支持的BMC版本：BMC300 5.3.0.1及之后的版本。插TPCM之后才支持。
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#TpcmService.TpcmService",
"@odata.id": "/redfish/v1/Managers/1/SecurityService/TpcmService",
"@odata.type": "#TpcmService.v1_0_0.TpcmService",
"Description": "Tpcm Service",
"Name": "TpcmService",
"Id": "TpcmService",
"TrustedCenterServerAddr": "10.10.10.1",
"MeasureEnabled": true,
"ControlPolicy": "intercept boot",
"TsbLicenseInfo": {
"LicenseType": 1,
"ExpiredTime": "2024-05-28 08:59:46"
},
"ActualDigest": {
"Bios": "c41937dfb6a5124d4cae70c8c54fceee1248bdd4a921eaf4f81938d37b32e261",
"Shim": "d03437f2e3d87830b17ab4cc5b060d180b04acffc9b375275677fdf704cc7320",
"Grub": "b513badc535f42d0e6cfd2a7765904e3f2751fed522685dabf59ee71160bf9f3",
"GrubCfg": "86a709533576d370ec2b7eae6c6c7b21b8afcf37fc2be6919bbb8e12addf889d",
"Kernel": "62210c63132546ead45a7723f2bd0ee33335f6ff5e242bd10996edc27cb96033",
"Initrd": "5ebca95e07fc0f418ad79ad0e25273c41d7929c51be6d8015ecf788c73094914"
},
"StandardDigest": {
"Bios": "c41937dfb6a5124d4cae70c8c54fceee1248bdd4a921eaf4f81938d37b32e261",
"Shim": "d03437f2e3d87830b17ab4cc5b060d180b04acffc9b375275677fdf704cc7320",
"Grub": "b513badc535f42d0e6cfd2a7765904e3f2751fed522685dabf59ee71160bf9f3",
"GrubCfg": "86a709533576d370ec2b7eae6c6c7b21b8afcf37fc2be6919bbb8e12addf889d",
"Kernel": "62210c63132546ead45a7723f2bd0ee33335f6ff5e242bd10996edc27cb96033",
"Initrd": "5ebca95e07fc0f418ad79ad0e25273c41d7929c51be6d8015ecf788c73094914"
}
}响应码：200
PATCH
命令功能
设置TPCM服务信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"TrustedCenterServerAddr": addr,
"MeasureEnabled":enable,
"ControlPolicy":policy,
"StandardDigest":{
"Bios":bios_value，
"Shim":shim_value,
"Grub":grub_value,
"GrubCfg":grubcfg_value,
"Kernel":kernel_value,
"Initrd":initrd_value,
}
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| manager_id | 管理资源ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号） ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
| header_type | 请求消息的格式 | 支持的消息格式包括： ● application/json ● application/json;charset=utf-8 |
| ifmatch_value | 请求消息的匹配参数 | 可通过对相应资源发起GET操作，从响应头中获取（对应于“ETag”参数） |
| addr | 可信中心服务器地址 | ipv4、IPv6或域名 |
| enable | 度量开关 | ● false：关闭 ● true：开启 ● 默认开启 |
| policy | 固件度量失败后的控制策略 | ● no action：无动作 ● intercept boot：阻止启动 ● 默认无动作 |
| StandardDigest | 启动阶段固件的基准值 | 启动阶段固件的基准值 |
| bios_value | Bios基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
| shim_value | Shim基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
| grub_value | Grub基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
| grubcfg_value | GrubCfg基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
| kernel_value | Kernel基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
| enable | Initrd基准值 | ● null：自动获取当前实际度量值 ● 字符串：64个字符 |
使用指南
支持的BMC版本：BMC300 5.3.0.1及之后的版本。插TPCM之后才支持。
使用实例
请求样例：
http
PATCH https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService请求头：
X-Auth-Token: 123456789***********************请求消息体：
{
"TrustedCenterServerAddr": "10.10.10.1",
"MeasureEnabled":true,
"ControlPolicy":policy,
"StandardDigest":{
"Bios":bios_value，
"Shim":shim_value,
"Grub":grub_value,
"GrubCfg":grubcfg_value,
"Kernel":kernel_value,
"Initrd":initrd_value,
}
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#TpcmService.TpcmService",
"@odata.id": "/redfish/v1/Managers/1/TpcmService",
"@odata.type": "#TpcmService.v1_0_0. TpcmService",
"Description": "Tpcm Service",
"Name": "TpcmService",
"Id": "TpcmService",
"TrustedCenterServerAddr": "10.10.10.1",
"MeasureEnabled":enable,
"ControlPolicy": policy,
"ActualDigest":{
"Bios":bios_value，
"Shim":shim_value,
"Grub":grub_value,
"GrubCfg":grubcfg_value,
"Kernel":kernel_value,
"Initrd":initrd_value,
}
"StandardDigest":{
"Bios":bios_value，
"Shim":shim_value,
"Grub":grub_value,
"GrubCfg":grubcfg_value,
"Kernel":kernel_value,
"Initrd":initrd_value,
}
}响应码：200