跳到主要内容

PATCH – 更新 KeyRepoServers 和其他属性

使用 PATCH 方法更新 Redfish 服务的 SecureKeyLifecycleService 资源中的属性。

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/Managers/1/Oem/Lenovo/SecureKeyLifecycleService

请求正文​

要更新的属性如下所示，所有这些属性都可以单独更改。

字段类型错误消息 ID

KeyRepoServers[N]

对象

已展开

注
当层级低于 2 时，不会显示此对象。

所有项都应添加到 PATCH 正文中。

 

HostName

字符串

远程服务器地址。它可以是 IPv4 地址、IPv6 地址、主机名或 FQDN。

 

Port

数字

远程服务器端口。有效值为 1 到 65535。

DeviceGroup

字符串

最大长度为 16 个字节的字符串。

注
当层级低于 2 时，不会显示此属性。

Protocol

字符串

服务器协议。值：SKLM 或 KMIP。ST250/SR250/ST50 平台仅支持 SKLM。

注
当层级低于 2 时，不会显示此属性。

EKMSLocalCachedKeySettings

对象

已展开

注
此对象不会在边缘平台上显示。
 

LocalCachedKeyEnabled

布尔

本地缓存密钥的已启用状态

 

CacheExpirationTime

数字

缓存到期时间

响应正文​

响应返回的内容与 GET 操作相同，但更新了属性。

状态代码​

HTTP 状态代码错误消息 ID
500InternalError

示例​

以下示例是 PATCH 正文。

{
    "KeyRepoServers": [
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        }
    ],
    "EKMSLocalCachedKeySettings": {
        "LocalCachedKeyEnabled": false,
        "CacheExpirationIntervalHours": 1
    },
    "Protocol": "SKLM",
    "DeviceGroup": "TKLM_DEV_GROUP"
}

成功运行 PATCH 操作后，资源查询将返回以下示例 JSON 响应：

{
    "Name": "SecureKeyLifecycleService",
    "@odata.type": "#LenovoSecureKeyLifecycle.v1_0_0.LenovoSecureKeyLifecycle",
    "@odata.id": "/redfish/v1/Managers/1/Oem/Lenovo/SecureKeyLifecycleService",
    "@odata.context": "/redfish/v1/$metadata#LenovoSecureKeyLifecycle.LenovoSecureKeyLifecycle",
    "Description": "This resource is used to represent a secure key lifecycle service for a Redfish implementation.",
    "EKMSLocalCachedKeySettings": {
        "LocalCachedKeyEnabled": false,
        "CacheExpirationIntervalHours": 1
    },
    "KeyRepoServers": [
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        },
        {
            "Port": 5696,
            "HostName": ""
        }
    ],
    "@odata.etag": "\"71103de0be6a24f03b3\"",
    "ServerCertificate": {
        "@odata.id": "/redfish/v1/Managers/1/Oem/Lenovo/SecureKeyLifecycleService/ServerCertificate"
    },
    "DeviceGroup": "TKLM_DEV_GROUP",
    "Protocol@Redfish.AllowableValues": [
        "SKLM",
        "KMIP"
    ],
    "Protocol": "SKLM",
    "ClientCertificate": {
        "@odata.id": "/redfish/v1/Managers/1/Oem/Lenovo/SecureKeyLifecycleService/ClientCertificate"
    },
    "Id": "SecureKeyLifecycleService"
}