跳到主要内容

GET – SSE 订阅

为 Redfish 服务创建“服务器发送事件”的订阅,以便将事件发送到客户端并保持连接打开。

请求 URL

GET https://<BMC_IPADDR>/{ServerSentEventUri}

ServerSentEventUri:在 EventService 的 ServerSentEventUri 属性中指定。

请求正文

响应正文

状态代码

示例

订阅 SSE 事件 - curl

curl 命令的以下示例将创建 SSE 连接并通过此连接接收事件。
$ curl "https://192.168.0.1/redfish/v1/EventService/ServerSentEvent" -X GET -k -u USERID:PASSW0RD

订阅 SSE 事件 - 浏览器

使用 Web 浏览器(例如 Chrome)访问 URI https://192.168.0.1/redfish/v1/EventService/ServerSentEvent,您将看到浏览器显示收到的事件。

事件 JSON 数据响应

返回以下示例 JSON 响应。




: stream keep-alive

id:2
data:{
data: "Events@odata.count": 1,
data: "Id": "2",
data: "Events": [
data: {
data: "MessageArgs": [
data: "USERID",
data: "the standard password",
data: "web",
data: "192.168.0.2"
data: ],
data: "Message": "Remote Login Successful. Login ID: USERID using the standard password from web at IP address 192.168.0.2.",
data: "EventGroupId": 0,
data: "Oem": {
data: "SystemSerialNumber": "DSYM09X",
data: "Lenovo": {
data: "ReportingChain": "",
data: "IsLocalEvent": true,
data: "RawDebugLogURL": "",
data: "AffectedIndicatorLEDs": [
data: ],
data: "EventFlag": 0,
data: "AuxiliaryData": "",
data: "Source": "System",
data: "FailingFRU": [
data: {
data: "FRUSerialNumber": "",
data: "FRUNumber": ""
data: }
data: ],
data: "TSLVersion": "0",
data: "RelatedEventID": "",
data: "Hidden": false,
data: "EventID": "0x4000000e00000000",
data: "EventSequenceNumber": 1616,
data: "EventType": 0,
data: "@odata.type": "#LenovoLogEntry.v1_0_0.StandardLogEntry",
data: "LenovoMessageID": "Lenovo0014",
data: "TotalSequenceNumber": 1965,
data: "CommonEventID": "FQXSPSE4001I",
data: "Serviceable": "Not Serviceable"
data: },
data: "SystemMachineTypeModel": "7X05CTO1WW",
data: "SystemUUID": "F0F63E94-8E25-11E8-9A5A-7ED30A5E2267"
data: },
data: "EventId": "16ED786F53C",
data: "MemberId": "0001",
data: "MessageId": "EventRegistry.1.0.FQXSPSE4001I",
data: "MessageSeverity": "OK",
data: "OriginOfCondition": {
data: "@odata.id": "/redfish/v1/Systems/1/LogServices/StandardLog"
data: },
data: "EventTimestamp": "2019-12-05T19:26:16+00:00"
data: }
data: ],
data: "@odata.type": "#Event.v1_4_0.Event",
data: "Name": "Redfish Event",
data: "Description": "This resource represents an event for a Redfish implementation."
data:}

: stream keep-alive

: stream keep-alive



查询 SSE 事件订阅

GET https://192.168.0.1/redfish/v1/EventService/Subscriptions,然后找到集合中的 SSE 新订阅。

在本例中,是“/redfish/v1/EventService/Subscriptions/C8ECC924”。

{
"Members": [
{
"@odata.id": "/redfish/v1/EventService/Subscriptions/C8ECC924"
}
],
"@odata.type": "#EventDestinationCollection.EventDestinationCollection",
"@odata.id": "/redfish/v1/EventService/Subscriptions",
"Members@odata.count": 1,
"@odata.etag": "\"1554741700566\"",
"Name": "Subscriptions",
"@odata.context": "/redfish/v1/$metadata#EventDestinationCollection.EventDestinationCollection"
}

GET https://192.168.0.1/redfish/v1/EventService/Subscriptions/C8ECC924,然后查找订阅属性。

{
"HttpHeaders": [],
"Id": "C8ECC924",
"SubordinateResources": null,
"Context": null,
"MessageIds": [],
"SubscriptionType": "SSE",
"ResourceTypes": [],
"OriginResources@odata.count": 0,
"Protocol": "Redfish",
"Name": "Destination",
"RegistryPrefixes": [],
"@odata.type": "#EventDestination.v1_5_0.EventDestination",
"@odata.id": "/redfish/v1/EventService/Subscriptions/C8ECC924",
"Description": "This resource represents the target of an event subscription, including the types of events subscribed and context to provide to the target in the Event payload.",
"@odata.etag": "\"1575573946737\"",
"OriginResources": [],
"EventFormatType": "Event"
}

“SubscriptionType”属性值为“SSE”,表示 SSE 订阅。