跳到主要内容

PATCH – 添加 KMIP 服务器

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

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/Systems/1/

请求正文​

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

字段

类型

描述

KeyManagement

对象

已展开

 

KMIPServers

数组

此计算机系统订阅的 KMIP 服务器的数组。

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

KMIPServers[N]

对象

已展开

   

Address

字符串

KMIP 服务器地址。

   

Port

整数

KMIP 服务器端口。

响应​

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

状态代码​

HTTP 状态代码错误消息 ID

200

RebootRequired

403

InsufficientPrivilege

500

InternalError

503

ServiceUnavailable

示例​

以下示例是 PATCH 正文。
注

  • 请记住在对 KMIPServers 执行 PATCH 之前获取计算机系统资源，以确保响应数据符合预期。

  • 请不要在此 PATCH 情况下使用 null 发出请求，否则会返回 403。

  • PATCH 请求中的元素数量需要等于 4。

{
    "KeyManagement": {
        "KMIPServers": [
            {
                "Address": "10.10.10.10",
                "Port": 5696
            },
            {
                "Address": "",
                "Port": 5696
            },
            {
                "Address": "",
                "Port": 5696
            },
            {
                "Address": "",
                "Port": 5696
            }
        ]
    }
}

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

{
    "KeyManagement": {
        "KMIPServers": [
            {
                "Address": "10.10.10.10",
                "Port": 5696
            },
            {
                "Address": null,
                "Port": 5696
            },
            {
                "Address": null,
                "Port": 5696
            },
            {
                "Address": null,
                "Port": 5696
            }
        ],
        "KMIPCertificates": {
            "@odata.id": "/redfish/v1/Systems/1/KeyManagement/KMIPCertificates"
        }
    },
    "IndicatorLED": "Off",
    "UUID": "037a178e-7fdd-11ed-8eb7-833f7a16b2d6",
    "PCIeDevices": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_1"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_2"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_4"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_3"
        }
    ],
    "Manufacturer": "Lenovo",
    "PCIeFunctions": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_4/PCIeFunctions/ob_4.00"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_1/PCIeFunctions/ob_1.00"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_3/PCIeFunctions/ob_3.00"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_2/PCIeFunctions/ob_2.00"
        }
    ],
    "Links": {
        "Chassis": [
            {
                "@odata.id": "/redfish/v1/Chassis/1"
            }
        ],
        "ManagedBy": [
            {
                "@odata.id": "/redfish/v1/Managers/1"
            }
        ],
        "PoweredBy": [],
        "CooledBy": [
            {
                "@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/0"
            },
            {
                "@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/1"
            },
            {
                "@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/2"
            },
            {
                "@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/3"
            }
        ]
    },
    …
}