blob: 76c78066aa39df2b54b038d8a3258fd397063cd3 [file] [log] [blame]
Ed Tanous118b1c72018-09-13 13:45:51 -07001{
Ed Tanoused761212022-09-23 15:03:29 -07002 "$id": "http://redfish.dmtf.org/schemas/v1/EventDestination.v1_12_0.json",
Ed Tanous118b1c72018-09-13 13:45:51 -07003 "$ref": "#/definitions/EventDestination",
Ed Tanous530520e2019-01-02 13:41:37 -08004 "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json",
Ed Tanoused761212022-09-23 15:03:29 -07005 "copyright": "Copyright 2014-2022 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright",
Ed Tanous118b1c72018-09-13 13:45:51 -07006 "definitions": {
7 "Actions": {
8 "additionalProperties": false,
Ed Tanoused761212022-09-23 15:03:29 -07009 "description": "The available actions for this resource.",
10 "longDescription": "This type shall contain the available actions for this resource.",
Ed Tanous118b1c72018-09-13 13:45:51 -070011 "patternProperties": {
Ed Tanouscb103132019-10-08 11:34:22 -070012 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
Ed Tanous118b1c72018-09-13 13:45:51 -070013 "description": "This property shall specify a valid odata or Redfish property.",
14 "type": [
15 "array",
16 "boolean",
Ed Tanous530520e2019-01-02 13:41:37 -080017 "integer",
Ed Tanous118b1c72018-09-13 13:45:51 -070018 "number",
19 "null",
20 "object",
21 "string"
22 ]
23 }
24 },
25 "properties": {
Ed Tanouscb103132019-10-08 11:34:22 -070026 "#EventDestination.ResumeSubscription": {
27 "$ref": "#/definitions/ResumeSubscription"
28 },
Ed Tanoused761212022-09-23 15:03:29 -070029 "#EventDestination.SuspendSubscription": {
30 "$ref": "#/definitions/SuspendSubscription"
31 },
Ed Tanous118b1c72018-09-13 13:45:51 -070032 "Oem": {
Ed Tanous530520e2019-01-02 13:41:37 -080033 "$ref": "#/definitions/OemActions",
Ed Tanoused761212022-09-23 15:03:29 -070034 "description": "The available OEM-specific actions for this resource.",
35 "longDescription": "This property shall contain the available OEM-specific actions for this resource.",
Ed Tanouscb103132019-10-08 11:34:22 -070036 "versionAdded": "v1_2_0"
Ed Tanous118b1c72018-09-13 13:45:51 -070037 }
38 },
39 "type": "object"
40 },
Ed Tanouscb103132019-10-08 11:34:22 -070041 "DeliveryRetryPolicy": {
42 "enum": [
43 "TerminateAfterRetries",
44 "SuspendRetries",
Gunnar Mills262d7d42021-01-20 16:28:41 -060045 "RetryForever",
46 "RetryForeverWithBackoff"
Ed Tanouscb103132019-10-08 11:34:22 -070047 ],
48 "enumDescriptions": {
Gunnar Mills262d7d42021-01-20 16:28:41 -060049 "RetryForever": "The subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries.",
50 "RetryForeverWithBackoff": "The subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries, but issued over time according to a service-defined backoff algorithm.",
Ed Tanouscb103132019-10-08 11:34:22 -070051 "SuspendRetries": "The subscription is suspended after the maximum number of retries is reached.",
52 "TerminateAfterRetries": "The subscription is terminated after the maximum number of retries is reached."
53 },
Gunnar Mills262d7d42021-01-20 16:28:41 -060054 "enumLongDescriptions": {
Gunnar Mills10f270b2021-05-19 15:34:06 -050055 "RetryForever": "This value shall indicate the subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries. The interval between retries remains constant and is specified by the DeliveryRetryIntervalSeconds property in the event service.",
56 "RetryForeverWithBackoff": "This value shall indicate the subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries. Retry attempts are issued over time according to a service-defined backoff algorithm. The backoff algorithm may insert an increasing amount of delay between retry attempts and may reach a maximum.",
Ed Tanoused761212022-09-23 15:03:29 -070057 "SuspendRetries": "This value shall indicate the subscription is suspended after the maximum number of retries is reached, specified by the DeliveryRetryAttempts property in the event service. The value of the State property within Status shall contain `Disabled` for a suspended subscription.",
Gunnar Mills10f270b2021-05-19 15:34:06 -050058 "TerminateAfterRetries": "This value shall indicate the subscription is terminated after the maximum number of retries is reached, specified by the DeliveryRetryAttempts property in the event service."
Gunnar Mills262d7d42021-01-20 16:28:41 -060059 },
60 "enumVersionAdded": {
61 "RetryForeverWithBackoff": "v1_10_0"
62 },
Ed Tanouscb103132019-10-08 11:34:22 -070063 "type": "string"
64 },
Ed Tanous118b1c72018-09-13 13:45:51 -070065 "EventDestination": {
66 "additionalProperties": false,
Ed Tanoused761212022-09-23 15:03:29 -070067 "description": "The EventDestination schema defines the target of an event subscription, including the event types and context to provide to the target in the event payload.",
68 "longDescription": "This resource shall represent the target of an event subscription, including the event types and context to provide to the target in the event payload.",
Ed Tanous118b1c72018-09-13 13:45:51 -070069 "patternProperties": {
Ed Tanouscb103132019-10-08 11:34:22 -070070 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
Ed Tanous118b1c72018-09-13 13:45:51 -070071 "description": "This property shall specify a valid odata or Redfish property.",
72 "type": [
73 "array",
74 "boolean",
Ed Tanous530520e2019-01-02 13:41:37 -080075 "integer",
Ed Tanous118b1c72018-09-13 13:45:51 -070076 "number",
77 "null",
78 "object",
79 "string"
80 ]
81 }
82 },
83 "properties": {
84 "@odata.context": {
Ed Tanouscb103132019-10-08 11:34:22 -070085 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context"
Ed Tanous118b1c72018-09-13 13:45:51 -070086 },
87 "@odata.etag": {
Ed Tanouscb103132019-10-08 11:34:22 -070088 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag"
Ed Tanous118b1c72018-09-13 13:45:51 -070089 },
90 "@odata.id": {
Ed Tanouscb103132019-10-08 11:34:22 -070091 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id"
Ed Tanous118b1c72018-09-13 13:45:51 -070092 },
93 "@odata.type": {
Ed Tanouscb103132019-10-08 11:34:22 -070094 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type"
Ed Tanous118b1c72018-09-13 13:45:51 -070095 },
96 "Actions": {
97 "$ref": "#/definitions/Actions",
Ed Tanoused761212022-09-23 15:03:29 -070098 "description": "The available actions for this resource.",
99 "longDescription": "This property shall contain the available actions for this resource.",
Ed Tanouscb103132019-10-08 11:34:22 -0700100 "versionAdded": "v1_2_0"
Ed Tanous118b1c72018-09-13 13:45:51 -0700101 },
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500102 "Certificates": {
103 "$ref": "http://redfish.dmtf.org/schemas/v1/CertificateCollection.json#/definitions/CertificateCollection",
104 "description": "The link to a collection of server certificates for the server referenced by the Destination property.",
105 "longDescription": "This property shall contain a link to a resource collection of type CertificateCollection that represent the server certificates for the server referenced by the Destination property. If VerifyCertificate is `true`, services shall compare the certificates in this collection with the certificate obtained during handshaking with the event destination in order to verify the identify of the event destination prior to sending an event. If the server cannot be verified, the service shall not send the event. If VerifyCertificate is `false`, the service shall not perform certificate verification.",
106 "readonly": true,
107 "versionAdded": "v1_9_0"
108 },
Gunnar Mills9d424662021-09-22 21:56:16 -0500109 "ClientCertificates": {
110 "$ref": "http://redfish.dmtf.org/schemas/v1/CertificateCollection.json#/definitions/CertificateCollection",
111 "description": "The link to a collection of client identity certificates provided to the server referenced by the Destination property.",
112 "longDescription": "This property shall contain a link to a resource collection of type CertificateCollection that represents the client identity certificates that are provided to the server referenced by the Destination property as part of TLS handshaking.",
113 "readonly": true,
114 "versionAdded": "v1_11_0"
115 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700116 "Context": {
117 "description": "A client-supplied string that is stored with the event destination subscription.",
Ed Tanouscb103132019-10-08 11:34:22 -0700118 "longDescription": "This property shall contain a client-supplied context that remains with the connection through the connection's lifetime.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700119 "readonly": false,
120 "type": [
121 "string",
122 "null"
123 ]
124 },
Ed Tanouscb103132019-10-08 11:34:22 -0700125 "DeliveryRetryPolicy": {
126 "anyOf": [
127 {
128 "$ref": "#/definitions/DeliveryRetryPolicy"
129 },
130 {
131 "type": "null"
132 }
133 ],
Gunnar Mills262d7d42021-01-20 16:28:41 -0600134 "description": "The subscription delivery retry policy for events, where the subscription type is RedfishEvent.",
135 "longDescription": "This property shall indicate the subscription delivery retry policy for events where the subscription type is RedfishEvent.",
Ed Tanouscb103132019-10-08 11:34:22 -0700136 "readonly": false,
137 "versionAdded": "v1_6_0"
138 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700139 "Description": {
140 "anyOf": [
141 {
142 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description"
143 },
144 {
145 "type": "null"
146 }
147 ],
148 "readonly": true
149 },
150 "Destination": {
Ed Tanouscb103132019-10-08 11:34:22 -0700151 "description": "The URI of the destination event receiver.",
152 "format": "uri-reference",
Gunnar Mills60c922d2021-12-01 09:28:53 -0600153 "longDescription": "This property shall contain a URI to the destination where the events are sent. If Protocol is `SMTP`, the URI shall follow the RFC6068-described format. SNMP URIs shall be consistent with RFC4088. Specifically, for SNMPv3, if a username is specified in the SNMP URI, the SNMPv3 authentication and encryption configuration associated with that user shall be utilized in the SNMPv3 traps. Syslog URIs shall be consistent with RFC3986 and contain the scheme `syslog://`. Server-sent event destinations shall be in the form `redfish-sse://ip:port` where `ip` and `port` are the IP address and the port of the client with the open SSE connection. For other URIs, such as HTTP or HTTPS, they shall be consistent with RFC3986.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700154 "readonly": true,
155 "type": "string"
156 },
Ed Tanous530520e2019-01-02 13:41:37 -0800157 "EventFormatType": {
158 "anyOf": [
159 {
160 "$ref": "http://redfish.dmtf.org/schemas/v1/EventDestination.json#/definitions/EventFormatType"
161 },
162 {
163 "type": "null"
164 }
165 ],
Ed Tanouscb103132019-10-08 11:34:22 -0700166 "description": "The content types of the message that are sent to the EventDestination.",
167 "longDescription": "This property shall indicate the content types of the message that this service sends to the EventDestination. If this property is not present, the EventFormatType shall be assumed to be Event.",
168 "readonly": true,
169 "versionAdded": "v1_4_0"
Ed Tanous530520e2019-01-02 13:41:37 -0800170 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700171 "EventTypes": {
Ed Tanoused761212022-09-23 15:03:29 -0700172 "deprecated": "This property has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property. Use EventFormatType to create subscriptions for metric reports. If the subscription does not include this property, the service shall use a single element with a default of `Other`.",
Ed Tanouscb103132019-10-08 11:34:22 -0700173 "description": "The types of events that are sent to the destination.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700174 "items": {
175 "$ref": "http://redfish.dmtf.org/schemas/v1/Event.json#/definitions/EventType"
176 },
Ed Tanoused761212022-09-23 15:03:29 -0700177 "longDescription": "This property shall contain an array that contains the types of events that shall be sent to the destination. To specify that a client is subscribing for metric reports, the EventTypes property should include 'MetricReport'. If the subscription does not include this property, the service shall use a single element with a default of `Other`.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700178 "readonly": true,
Ed Tanouscb103132019-10-08 11:34:22 -0700179 "type": "array",
180 "versionDeprecated": "v1_5_0"
Ed Tanous118b1c72018-09-13 13:45:51 -0700181 },
Ed Tanoused761212022-09-23 15:03:29 -0700182 "ExcludeMessageIds": {
183 "description": "The list of MessageIds that are not sent to this event destination.",
184 "items": {
185 "type": [
186 "string",
187 "null"
188 ]
189 },
190 "longDescription": "This property shall contain an array of exculded MessageIds that are not allowed values for the MessageId property within an event sent to the subscriber. The MessageId shall be in the `MessageRegistry.MessageId` format. If included, the MessageId major and minor version details should be ignored. Events with a MessageId that is contained in this array shall not be sent to the subscriber. If this property is an empty array or is absent, no exclusive filtering based upon the MessageId of an event is performed.",
191 "readonly": true,
192 "type": "array",
193 "versionAdded": "v1_12_0"
194 },
195 "ExcludeRegistryPrefixes": {
196 "description": "The list of prefixes for the message registries that contain the MessageIds that are not sent to this event destination.",
197 "items": {
198 "type": [
199 "string",
200 "null"
201 ]
202 },
203 "longDescription": "This property shall contain an array of prefixes of excluded message registries that contain the MessageIds that are not allowed values for the MessageId property within an event sent to the subscriber. Events with a MessageId that is from a message registry contained in this array shall not be sent to the subscriber. If this property is an empty array or is absent, no exclusive filtering based upon message registry of the MessageId of an event is performed.",
204 "readonly": true,
205 "type": "array",
206 "versionAdded": "v1_12_0"
207 },
Gunnar Mills9d424662021-09-22 21:56:16 -0500208 "HeartbeatIntervalMinutes": {
209 "description": "Interval for sending heartbeat events to the destination in minutes.",
210 "longDescription": "This property shall indicate the interval for sending periodic heartbeat events to the subscriber. The value shall be the interval, in minutes, between each periodic event. This property shall not be present if the SendHeartbeat property is not present.",
211 "maximum": 65535,
212 "minimum": 1,
213 "readonly": true,
214 "type": [
215 "integer",
216 "null"
217 ],
218 "versionAdded": "v1_11_0"
219 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700220 "HttpHeaders": {
Ed Tanouscb103132019-10-08 11:34:22 -0700221 "description": "An array of settings for HTTP headers, such as authorization information. This array is null or an empty array in responses. An empty array is the preferred return value on read operations.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700222 "items": {
223 "$ref": "#/definitions/HttpHeaderProperty"
224 },
Ed Tanoused761212022-09-23 15:03:29 -0700225 "longDescription": "This property shall contain an object consisting of the names and values of of HTTP header to be included with every event POST to the event destination. This object shall be null or an empty array in responses. An empty array is the preferred return value in responses.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700226 "type": "array"
227 },
228 "Id": {
229 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id",
230 "readonly": true
231 },
Gunnar Millsa778c022020-05-12 12:20:36 -0500232 "IncludeOriginOfCondition": {
233 "description": "An indication of whether the events subscribed to will also include the entire resource or object referenced the OriginOfCondition property in the event payload.",
234 "longDescription": "This property shall indicate whether the event payload sent to the subscription destination will expand the OriginOfCondition property to include the resource or object referenced by the OriginOfCondition property.",
235 "readonly": true,
236 "type": [
237 "boolean",
238 "null"
239 ],
240 "versionAdded": "v1_8_0"
241 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700242 "MessageIds": {
Ed Tanoused761212022-09-23 15:03:29 -0700243 "description": "The list of MessageIds that are sent to this event destination.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700244 "items": {
245 "type": [
246 "string",
247 "null"
248 ]
249 },
Ed Tanoused761212022-09-23 15:03:29 -0700250 "longDescription": "This property shall contain an array of MessageIds that are the allowable values for the MessageId property within an event sent to the subscriber. The MessageId should be in the `MessageRegistry.MessageId` format. If included, the MessageId major and minor version details should be ignored. Events with a MessageId that is not contained in this array and is not from a message registry contained in RegistryPrefixes shall not be sent to the subscriber. If this property is an empty array or is absent, no inclusive filtering based upon the MessageId of an event is performed.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700251 "readonly": true,
Ed Tanouscb103132019-10-08 11:34:22 -0700252 "type": "array",
253 "versionAdded": "v1_1_0"
254 },
255 "MetricReportDefinitions": {
256 "description": "A list of metric report definitions for which the service only sends related metric reports. If this property is absent or the array is empty, metric reports that originate from any metric report definition are sent to the subscriber.",
257 "items": {
258 "$ref": "http://redfish.dmtf.org/schemas/v1/MetricReportDefinition.json#/definitions/MetricReportDefinition"
259 },
260 "longDescription": "This property shall specify an array of metric report definitions that are the only allowable generators of metric reports for this subscription. Metric reports originating from metric report definitions not contained in this array shall not be sent to the subscriber. If this property is absent or the array is empty, the service shall send metric reports originating from any metric report definition to the subscriber.",
261 "readonly": true,
262 "type": "array",
263 "versionAdded": "v1_6_0"
264 },
265 "MetricReportDefinitions@odata.count": {
266 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
Ed Tanous118b1c72018-09-13 13:45:51 -0700267 },
268 "Name": {
269 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name",
270 "readonly": true
271 },
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500272 "OEMProtocol": {
273 "description": "The OEM-defined protocol type of the event connection.",
274 "longDescription": "This property shall contain the protocol type that the event uses to send the event to the destination. This property shall be present if Protocol is `OEM`.",
275 "readonly": true,
276 "type": "string",
277 "versionAdded": "v1_9_0"
278 },
279 "OEMSubscriptionType": {
280 "description": "The OEM-defined subscription type for events.",
281 "longDescription": "This property shall indicate the OEM-defined type of subscription for events. This property shall be present if SubscriptionType is `OEM`.",
282 "readonly": true,
283 "type": "string",
284 "versionAdded": "v1_9_0"
285 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700286 "Oem": {
287 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
Ed Tanouscb103132019-10-08 11:34:22 -0700288 "description": "The OEM extension property.",
289 "longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements."
Ed Tanous118b1c72018-09-13 13:45:51 -0700290 },
291 "OriginResources": {
Ed Tanoused761212022-09-23 15:03:29 -0700292 "description": "The array of resources for which the service sends only related events.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700293 "items": {
Ed Tanouscb103132019-10-08 11:34:22 -0700294 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/idRef"
Ed Tanous118b1c72018-09-13 13:45:51 -0700295 },
Ed Tanoused761212022-09-23 15:03:29 -0700296 "longDescription": "This property shall specify an array of resources, resource collections, or referenceable members that are the only allowable values for the OriginOfCondition property within an event that the service sends to the subscriber. Events with an OriginOfCondition that is not contained in this array, and is not subordinate to members of this array if SubordinateResources contains the value `true`, shall not be sent to the subscriber. If this property is an empty array or is absent, no filtering based upon the URI of the OriginOfCondition of an event is performed.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700297 "readonly": true,
Ed Tanouscb103132019-10-08 11:34:22 -0700298 "type": "array",
299 "versionAdded": "v1_1_0"
Ed Tanous118b1c72018-09-13 13:45:51 -0700300 },
301 "OriginResources@odata.count": {
Ed Tanouscb103132019-10-08 11:34:22 -0700302 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
Ed Tanous118b1c72018-09-13 13:45:51 -0700303 },
304 "Protocol": {
305 "$ref": "#/definitions/EventDestinationProtocol",
306 "description": "The protocol type of the event connection.",
Ed Tanouscb103132019-10-08 11:34:22 -0700307 "longDescription": "This property shall contain the protocol type that the event uses to send the event to the destination. A `Redfish` value shall indicate that the event type shall adhere to the type defined in the Redfish Specification.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700308 "readonly": true
309 },
Ed Tanous530520e2019-01-02 13:41:37 -0800310 "RegistryPrefixes": {
Ed Tanoused761212022-09-23 15:03:29 -0700311 "description": "The list of prefixes for the message registries that contain the MessageIds that are sent to this event destination.",
Ed Tanous530520e2019-01-02 13:41:37 -0800312 "items": {
313 "type": [
314 "string",
315 "null"
316 ]
317 },
Ed Tanoused761212022-09-23 15:03:29 -0700318 "longDescription": "This property shall contain an array the prefixes of message registries that contain the MessageIds that are the allowable values for the MessageId property within an event sent to the subscriber. Events with a MessageId that is not from a message registry contained in this array and is not contained by MessageIds shall not be sent to the subscriber. If this property is an empty array or is absent, no inclusive filtering based upon message registry of the MessageId of an event is performed.",
Ed Tanous530520e2019-01-02 13:41:37 -0800319 "readonly": true,
Ed Tanouscb103132019-10-08 11:34:22 -0700320 "type": "array",
321 "versionAdded": "v1_4_0"
Ed Tanous530520e2019-01-02 13:41:37 -0800322 },
323 "ResourceTypes": {
Ed Tanoused761212022-09-23 15:03:29 -0700324 "description": "The list of resource type values (schema names) that correspond to the OriginOfCondition. The version and full namespace should not be specified.",
Ed Tanous530520e2019-01-02 13:41:37 -0800325 "items": {
326 "type": [
327 "string",
328 "null"
329 ]
330 },
Ed Tanoused761212022-09-23 15:03:29 -0700331 "longDescription": "This property shall specify an array of resource type values that contain the allowable resource types for the resource referenced by the OriginOfCondition property. Events with the resource type of the resource referenced by the OriginOfCondition property that is not contained in this array shall not be sent to the subscriber. If this property is an empty array or is absent, no filtering based upon the resource type of the OriginOfCondition of an event is performed. This property shall contain only the general namespace for the type and not the versioned value. For example, it shall not contain `Task.v1_2_0.Task` and instead shall contain `Task`. To specify that a client is subscribing to metric reports, the EventTypes property should include `MetricReport`.",
Ed Tanous530520e2019-01-02 13:41:37 -0800332 "readonly": true,
Ed Tanouscb103132019-10-08 11:34:22 -0700333 "type": "array",
334 "versionAdded": "v1_4_0"
335 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600336 "SNMP": {
337 "$ref": "#/definitions/SNMPSettings",
338 "description": "Settings for an SNMP event destination.",
339 "longDescription": "This property shall contain the settings for an SNMP event destination.",
340 "versionAdded": "v1_7_0"
341 },
Gunnar Mills9d424662021-09-22 21:56:16 -0500342 "SendHeartbeat": {
343 "description": "Send a heartbeat event periodically to the destination.",
344 "longDescription": "This property shall indicate that the service shall periodically send the `RedfishServiceFunctional` message defined in the Heartbeat Event Message Registry to the subscriber. If this property is not present, no periodic event shall be sent. This property shall not apply to event destinations if the SubscriptionType property contains the value `SSE`.",
345 "readonly": true,
346 "type": [
347 "boolean",
348 "null"
349 ],
350 "versionAdded": "v1_11_0"
351 },
Ed Tanouscb103132019-10-08 11:34:22 -0700352 "Status": {
353 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status",
354 "description": "This property shall contain the status of the subscription.",
355 "longDescription": "This property shall contain the status of the subscription.",
356 "versionAdded": "v1_6_0"
Ed Tanous530520e2019-01-02 13:41:37 -0800357 },
358 "SubordinateResources": {
Ed Tanoused761212022-09-23 15:03:29 -0700359 "description": "An indication of whether the subscription is for events in the OriginResources array and its subordinate resources. If `true` and the OriginResources array is specified, the subscription is for events in the OriginResources array and its subordinate resources. Note that resources associated through the Links section are not considered subordinate. If `false` and the OriginResources array is specified, the subscription shall be for events in the OriginResources array only. If the OriginResources array is not present, this property shall have no relevance.",
360 "longDescription": "This property shall indicate whether the subscription is for events in the OriginResources array and its subordinate resources. If `true` and the OriginResources array is specified, the subscription is for events in the OriginResources array and its subordinate resources. Note that resources associated through the Links section are not considered subordinate. If `false` and the OriginResources array is specified, the subscription shall be for events in the OriginResources array only. If the OriginResources array is not present, this property shall have no relevance.",
Ed Tanous530520e2019-01-02 13:41:37 -0800361 "readonly": true,
362 "type": [
363 "boolean",
364 "null"
Ed Tanouscb103132019-10-08 11:34:22 -0700365 ],
366 "versionAdded": "v1_4_0"
Ed Tanous530520e2019-01-02 13:41:37 -0800367 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700368 "SubscriptionType": {
369 "anyOf": [
370 {
371 "$ref": "#/definitions/SubscriptionType"
372 },
373 {
374 "type": "null"
375 }
376 ],
Ed Tanouscb103132019-10-08 11:34:22 -0700377 "description": "The subscription type for events.",
378 "longDescription": "This property shall indicate the type of subscription for events. If this property is not present, the SubscriptionType shall be assumed to be RedfishEvent.",
379 "readonly": true,
380 "versionAdded": "v1_3_0"
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500381 },
382 "SyslogFilters": {
Gunnar Mills9d424662021-09-22 21:56:16 -0500383 "description": "A list of filters applied to syslog messages before sending to a remote syslog server. An empty list indicates all syslog messages are sent.",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500384 "items": {
385 "anyOf": [
386 {
387 "$ref": "#/definitions/SyslogFilter"
388 },
389 {
390 "type": "null"
391 }
392 ]
393 },
394 "longDescription": "This property shall describe all desired syslog messages to send to a remote syslog server. If this property contains an empty array or is absent, all messages shall be sent.",
395 "type": "array",
396 "versionAdded": "v1_9_0"
397 },
398 "VerifyCertificate": {
399 "description": "An indication of whether the service will verify the certificate of the server referenced by the Destination property prior to sending the event.",
Sui Chen141d9432022-02-03 22:01:27 -0800400 "longDescription": "This property shall indicate whether whether the service will verify the certificate of the server referenced by the Destination property prior to sending the event. If this property is not supported by the service or specified by the client in the create request, it shall be assumed to be `false`.",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500401 "readonly": false,
402 "type": [
403 "boolean",
404 "null"
405 ],
406 "versionAdded": "v1_9_0"
Ed Tanous118b1c72018-09-13 13:45:51 -0700407 }
408 },
409 "required": [
410 "Context",
Ed Tanous530520e2019-01-02 13:41:37 -0800411 "@odata.id",
412 "@odata.type",
Ed Tanous118b1c72018-09-13 13:45:51 -0700413 "Id",
414 "Name",
415 "SubscriptionType"
416 ],
417 "requiredOnCreate": [
418 "Destination",
Ed Tanous118b1c72018-09-13 13:45:51 -0700419 "Protocol"
420 ],
421 "type": "object"
422 },
423 "EventDestinationProtocol": {
424 "enum": [
Gunnar Mills6f44b752020-02-06 16:50:51 -0600425 "Redfish",
426 "SNMPv1",
427 "SNMPv2c",
428 "SNMPv3",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500429 "SMTP",
430 "SyslogTLS",
431 "SyslogTCP",
432 "SyslogUDP",
433 "SyslogRELP",
434 "OEM"
Ed Tanous118b1c72018-09-13 13:45:51 -0700435 ],
436 "enumDescriptions": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500437 "OEM": "The destination follows an OEM protocol for event notifications.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600438 "Redfish": "The destination follows the Redfish Specification for event notifications.",
439 "SMTP": "The destination follows the SMTP specification for event notifications.",
440 "SNMPv1": "The destination follows the SNMPv1 protocol for event notifications.",
441 "SNMPv2c": "The destination follows the SNMPv2c protocol for event notifications.",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500442 "SNMPv3": "The destination follows the SNMPv3 protocol for event notifications.",
443 "SyslogRELP": "The destination follows syslog RELP for event notifications.",
444 "SyslogTCP": "The destination follows syslog TCP-based for event notifications.",
445 "SyslogTLS": "The destination follows syslog TLS-based for event notifications.",
446 "SyslogUDP": "The destination follows syslog UDP-based for event notifications."
Gunnar Mills6f44b752020-02-06 16:50:51 -0600447 },
448 "enumLongDescriptions": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500449 "OEM": "This value shall indicate an OEM specific protocol. The OEMProtocol property shall contain the specific OEM event destination protocol.",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600450 "Redfish": "This value shall indicate the destination follows the Redfish Specification for event notifications. Destinations requesting EventFormatType of `Event` shall receive a Redfish resource of type Event. Destinations requesting EventFormatType of `MetricReport` shall receive a Redfish resource of type MetricReport.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600451 "SMTP": "This value shall indicate the destination follows the RFC5321-defined SMTP specification.",
452 "SNMPv1": "This value shall indicate the destination follows the RFC1157-defined SNMPv1 protocol.",
453 "SNMPv2c": "This value shall indicate the destination follows the SNMPv2c protocol as defined by RFC1441 and RFC1452.",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500454 "SNMPv3": "This value shall indicate the destination follows the SNMPv3 protocol as defined by RFC3411 and RFC3418.",
455 "SyslogRELP": "This value shall indicate the destination follows the Reliable Event Logging Protocol (RELP) transport for syslog as defined by www.rsyslog.com.",
456 "SyslogTCP": "This value shall indicate the destination follows the TCP-based transport for syslog as defined in RFC6587.",
457 "SyslogTLS": "This value shall indicate the destination follows the TLS-based transport for syslog as defined in RFC5424.",
458 "SyslogUDP": "This value shall indicate the destination follows the UDP-based transport for syslog as defined in RFC5424."
Gunnar Mills6f44b752020-02-06 16:50:51 -0600459 },
460 "enumVersionAdded": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500461 "OEM": "v1_9_0",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600462 "SMTP": "v1_7_0",
463 "SNMPv1": "v1_7_0",
464 "SNMPv2c": "v1_7_0",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500465 "SNMPv3": "v1_7_0",
466 "SyslogRELP": "v1_9_0",
467 "SyslogTCP": "v1_9_0",
468 "SyslogTLS": "v1_9_0",
469 "SyslogUDP": "v1_9_0"
Ed Tanous530520e2019-01-02 13:41:37 -0800470 },
471 "type": "string"
472 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700473 "HttpHeaderProperty": {
474 "additionalProperties": false,
Ed Tanouscb103132019-10-08 11:34:22 -0700475 "description": "The HTTP header value is the property value. The header name is the property name.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600476 "longDescription": "This type shall contain the HTTP header name and value to include with every event POST to the event destination.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700477 "patternProperties": {
Ed Tanouscb103132019-10-08 11:34:22 -0700478 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
Ed Tanous118b1c72018-09-13 13:45:51 -0700479 "description": "This property shall specify a valid odata or Redfish property.",
480 "type": [
481 "array",
482 "boolean",
Ed Tanous530520e2019-01-02 13:41:37 -0800483 "integer",
Ed Tanous118b1c72018-09-13 13:45:51 -0700484 "number",
485 "null",
486 "object",
487 "string"
488 ]
489 },
490 "^[^:\\\\s]+$": {
491 "type": "string"
492 }
493 },
494 "properties": {},
495 "type": "object"
496 },
497 "OemActions": {
498 "additionalProperties": true,
Ed Tanoused761212022-09-23 15:03:29 -0700499 "description": "The available OEM-specific actions for this resource.",
500 "longDescription": "This type shall contain the available OEM-specific actions for this resource.",
Ed Tanous118b1c72018-09-13 13:45:51 -0700501 "patternProperties": {
Ed Tanouscb103132019-10-08 11:34:22 -0700502 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
Ed Tanous118b1c72018-09-13 13:45:51 -0700503 "description": "This property shall specify a valid odata or Redfish property.",
504 "type": [
505 "array",
506 "boolean",
Ed Tanous530520e2019-01-02 13:41:37 -0800507 "integer",
Ed Tanous118b1c72018-09-13 13:45:51 -0700508 "number",
509 "null",
510 "object",
511 "string"
512 ]
513 }
514 },
515 "properties": {},
516 "type": "object"
517 },
Ed Tanouscb103132019-10-08 11:34:22 -0700518 "ResumeSubscription": {
519 "additionalProperties": false,
520 "description": "This action resumes a suspended event subscription.",
Ed Tanoused761212022-09-23 15:03:29 -0700521 "longDescription": "This action shall resume a suspended event subscription, which affects the subscription status. The service may deliver buffered events when the subscription is resumed.",
522 "parameters": {
523 "DeliverBufferedEventDuration": {
524 "description": "The maximum age of buffered events that should be delivered when resuming the subscription.",
525 "longDescription": "This parameter shall indicate the event age of any buffered or otherwise undelivered events that shall be delivered to this event destination when the subscription is resumed. The service shall deliver any available, previously undelivered event that was created within the duration specified. A value that equates to zero time, such as `PT0S`, shall indicate that no previously undelivered events shall be sent. If undelivered events within the duration may been discarded due to a lack of buffer space, the service should send the EventBufferExceeded message from the Base Message Registry. If the client does not provide this parameter, the service shall apply an implementation specific duration.",
526 "pattern": "-?P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(.\\d+)?S)?)?",
527 "type": "string",
528 "versionAdded": "v1_12_0"
529 }
530 },
Ed Tanouscb103132019-10-08 11:34:22 -0700531 "patternProperties": {
532 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
533 "description": "This property shall specify a valid odata or Redfish property.",
534 "type": [
535 "array",
536 "boolean",
537 "integer",
538 "number",
539 "null",
540 "object",
541 "string"
542 ]
543 }
544 },
545 "properties": {
546 "target": {
547 "description": "Link to invoke action",
548 "format": "uri-reference",
549 "type": "string"
550 },
551 "title": {
552 "description": "Friendly action name",
553 "type": "string"
554 }
555 },
556 "type": "object"
557 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600558 "SNMPAuthenticationProtocols": {
559 "enum": [
560 "None",
561 "CommunityString",
562 "HMAC_MD5",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600563 "HMAC_SHA96",
564 "HMAC128_SHA224",
565 "HMAC192_SHA256",
566 "HMAC256_SHA384",
567 "HMAC384_SHA512"
Gunnar Mills6f44b752020-02-06 16:50:51 -0600568 ],
569 "enumDescriptions": {
570 "CommunityString": "Trap community string authentication.",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600571 "HMAC128_SHA224": "HMAC-128-SHA-224 authentication.",
572 "HMAC192_SHA256": "HMAC-192-SHA-256 authentication.",
573 "HMAC256_SHA384": "HMAC-256-SHA-384 authentication.",
574 "HMAC384_SHA512": "HMAC-384-SHA-512 authentication.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600575 "HMAC_MD5": "HMAC-MD5-96 authentication.",
576 "HMAC_SHA96": "HMAC-SHA-96 authentication.",
577 "None": "No authentication."
578 },
579 "enumLongDescriptions": {
580 "CommunityString": "This value shall indicate authentication using SNMP community strings and the value of TrapCommunity.",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600581 "HMAC128_SHA224": "This value shall indicate authentication for SNMPv3 access conforms to the RFC7860-defined usmHMAC128SHA224AuthProtocol.",
582 "HMAC192_SHA256": "This value shall indicate authentication for SNMPv3 access conforms to the RFC7860-defined usmHMAC192SHA256AuthProtocol.",
583 "HMAC256_SHA384": "This value shall indicate authentication for SNMPv3 access conforms to the RFC7860-defined usmHMAC256SHA384AuthProtocol.",
584 "HMAC384_SHA512": "This value shall indicate authentication for SNMPv3 access conforms to the RFC7860-defined usmHMAC384SHA512AuthProtocol.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600585 "HMAC_MD5": "This value shall indicate authentication conforms to the RFC3414-defined HMAC-MD5-96 authentication protocol.",
586 "HMAC_SHA96": "This value shall indicate authentication conforms to the RFC3414-defined HMAC-SHA-96 authentication protocol.",
587 "None": "This value shall indicate authentication is not required."
588 },
Gunnar Mills262d7d42021-01-20 16:28:41 -0600589 "enumVersionAdded": {
590 "HMAC128_SHA224": "v1_10_0",
591 "HMAC192_SHA256": "v1_10_0",
592 "HMAC256_SHA384": "v1_10_0",
593 "HMAC384_SHA512": "v1_10_0"
594 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600595 "type": "string"
596 },
597 "SNMPEncryptionProtocols": {
598 "enum": [
599 "None",
600 "CBC_DES",
601 "CFB128_AES128"
602 ],
603 "enumDescriptions": {
604 "CBC_DES": "CBC-DES encryption.",
605 "CFB128_AES128": "CFB128-AES-128 encryption.",
606 "None": "No encryption."
607 },
608 "enumLongDescriptions": {
609 "CBC_DES": "This value shall indicate encryption conforms to the RFC3414-defined CBC-DES encryption protocol.",
610 "CFB128_AES128": "This value shall indicate encryption conforms to the RFC3414-defined CFB128-AES-128 encryption protocol.",
611 "None": "This value shall indicate there is no encryption."
612 },
613 "type": "string"
614 },
615 "SNMPSettings": {
616 "additionalProperties": false,
617 "description": "Settings for an SNMP event destination.",
618 "longDescription": "This type shall contain the settings for an SNMP event destination.",
619 "patternProperties": {
620 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
621 "description": "This property shall specify a valid odata or Redfish property.",
622 "type": [
623 "array",
624 "boolean",
625 "integer",
626 "number",
627 "null",
628 "object",
629 "string"
630 ]
631 }
632 },
633 "properties": {
634 "AuthenticationKey": {
635 "description": "The secret authentication key for SNMPv3.",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600636 "longDescription": "This property shall contain the key for SNMPv3 authentication. The value shall be `null` in responses. This property accepts a passphrase or a hex-encoded key. If the string starts with `Passphrase:`, the remainder of the string shall be the passphrase and shall be converted to the key as described in the 'Password to Key Algorithm' section of RFC3414. If the string starts with `Hex:`, then the remainder of the string shall be the key encoded in hexadecimal notation. If the string starts with neither, the full string shall be a passphrase and shall be converted to the key as described in the 'Password to Key Algorithm' section of RFC3414. The passphrase can contain any printable characters except for the double quotation mark.",
637 "pattern": "(^[ !#-~]+$)|(^Passphrase:[ ^[ !#-~]+$)|(^Hex:[0-9A-Fa-f]{24,96})|(^\\*+$)",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600638 "readonly": false,
639 "type": [
640 "string",
641 "null"
642 ],
643 "versionAdded": "v1_7_0"
644 },
Gunnar Mills262d7d42021-01-20 16:28:41 -0600645 "AuthenticationKeySet": {
646 "description": "Indicates if the AuthenticationKey property is set.",
647 "longDescription": "This property shall contain `true` if a valid value was provided for the AuthenticationKey property. Otherwise, the property shall contain `false`.",
648 "readonly": true,
649 "type": "boolean",
650 "versionAdded": "v1_10_0"
651 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600652 "AuthenticationProtocol": {
653 "anyOf": [
654 {
655 "$ref": "#/definitions/SNMPAuthenticationProtocols"
656 },
657 {
658 "type": "null"
659 }
660 ],
661 "description": "The authentication protocol for SNMPv3.",
662 "longDescription": "This property shall contain the SNMPv3 authentication protocol.",
663 "readonly": false,
664 "versionAdded": "v1_7_0"
665 },
666 "EncryptionKey": {
667 "description": "The secret authentication key for SNMPv3.",
Gunnar Mills262d7d42021-01-20 16:28:41 -0600668 "longDescription": "This property shall contain the key for SNMPv3 encryption. The value shall be `null` in responses. This property accepts a passphrase or a hex-encoded key. If the string starts with `Passphrase:`, the remainder of the string shall be the passphrase and shall be converted to the key as described in the 'Password to Key Algorithm' section of RFC3414. If the string starts with `Hex:`, then the remainder of the string shall be the key encoded in hexadecimal notation. If the string starts with neither, the full string shall be a passphrase and shall be converted to the key as described in the 'Password to Key Algorithm' section of RFC3414. The passphrase can contain any printable characters except for the double quotation mark.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600669 "pattern": "(^[A-Za-z0-9]+$)|(^\\*+$)",
670 "readonly": false,
671 "type": [
672 "string",
673 "null"
674 ],
675 "versionAdded": "v1_7_0"
676 },
Gunnar Mills262d7d42021-01-20 16:28:41 -0600677 "EncryptionKeySet": {
678 "description": "Indicates if the EncryptionKey property is set.",
679 "longDescription": "This property shall contain `true` if a valid value was provided for the EncryptionKey property. Otherwise, the property shall contain `false`.",
680 "readonly": true,
681 "type": "boolean",
682 "versionAdded": "v1_10_0"
683 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600684 "EncryptionProtocol": {
685 "anyOf": [
686 {
687 "$ref": "#/definitions/SNMPEncryptionProtocols"
688 },
689 {
690 "type": "null"
691 }
692 ],
693 "description": "The encryption protocol for SNMPv3.",
694 "longDescription": "This property shall contain the SNMPv3 encryption protocol.",
695 "readonly": false,
696 "versionAdded": "v1_7_0"
697 },
698 "TrapCommunity": {
699 "description": "The SNMP trap community string.",
700 "longDescription": "This property shall contain the SNMP trap community string. The value shall be `null` in responses.",
701 "readonly": false,
702 "type": [
703 "string",
704 "null"
705 ],
706 "versionAdded": "v1_7_0"
707 }
708 },
709 "type": "object"
710 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700711 "SubscriptionType": {
712 "enum": [
713 "RedfishEvent",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600714 "SSE",
715 "SNMPTrap",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500716 "SNMPInform",
717 "Syslog",
718 "OEM"
Ed Tanous118b1c72018-09-13 13:45:51 -0700719 ],
720 "enumDescriptions": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500721 "OEM": "The subscription is an OEM subscription.",
Ed Tanouscb103132019-10-08 11:34:22 -0700722 "RedfishEvent": "The subscription follows the Redfish Specification for event notifications. To send an event notification, a service sends an HTTP POST to the subscriber's destination URI.",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600723 "SNMPInform": "The subscription follows versions 2 and 3 of SNMP Inform for event notifications.",
724 "SNMPTrap": "The subscription follows the various versions of SNMP Traps for event notifications.",
Gunnar Mills60c922d2021-12-01 09:28:53 -0600725 "SSE": "The subscription follows the HTML5 server-sent event definition for event notifications.",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500726 "Syslog": "The subscription sends Syslog messages for event notifications."
Ed Tanous118b1c72018-09-13 13:45:51 -0700727 },
Gunnar Mills6f44b752020-02-06 16:50:51 -0600728 "enumLongDescriptions": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500729 "OEM": "This value shall indicate an OEM subscription type. The OEMSubscriptionType property shall contain the specific OEM subscription type.",
730 "SNMPInform": "This value shall indicate the subscription follows versions 2 and 3 of SNMP Inform for event notifications. Protocol shall specify the appropriate version of SNMP.",
731 "SNMPTrap": "This value shall indicate the subscription follows the various versions of SNMP Traps for event notifications. Protocol shall specify the appropriate version of SNMP.",
732 "Syslog": "This value shall indicate the subscription forwards syslog messages to the event destination. Protocol shall specify the appropriate syslog protocol."
Gunnar Mills6f44b752020-02-06 16:50:51 -0600733 },
734 "enumVersionAdded": {
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500735 "OEM": "v1_9_0",
Gunnar Mills6f44b752020-02-06 16:50:51 -0600736 "SNMPInform": "v1_7_0",
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500737 "SNMPTrap": "v1_7_0",
738 "Syslog": "v1_9_0"
Gunnar Mills6f44b752020-02-06 16:50:51 -0600739 },
Ed Tanous118b1c72018-09-13 13:45:51 -0700740 "type": "string"
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500741 },
Ed Tanoused761212022-09-23 15:03:29 -0700742 "SuspendSubscription": {
743 "additionalProperties": false,
744 "description": "This action suspends an event subscription.",
745 "longDescription": "This action shall suspend an event subscription. No events shall be sent to the event destination until invocation of the ResumeSubscription action. The value of the State property within Status shall contain `Disabled` for a suspended subscription. The service may buffer events while the subscription is suspended.",
746 "parameters": {},
747 "patternProperties": {
748 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
749 "description": "This property shall specify a valid odata or Redfish property.",
750 "type": [
751 "array",
752 "boolean",
753 "integer",
754 "number",
755 "null",
756 "object",
757 "string"
758 ]
759 }
760 },
761 "properties": {
762 "target": {
763 "description": "Link to invoke action",
764 "format": "uri-reference",
765 "type": "string"
766 },
767 "title": {
768 "description": "Friendly action name",
769 "type": "string"
770 }
771 },
772 "type": "object",
773 "versionAdded": "v1_12_0"
774 },
Asmitha Karunanithic8ccb772020-09-22 10:56:46 -0500775 "SyslogFacility": {
776 "description": "The syslog facility code is an enumeration of program types.",
777 "enum": [
778 "Kern",
779 "User",
780 "Mail",
781 "Daemon",
782 "Auth",
783 "Syslog",
784 "LPR",
785 "News",
786 "UUCP",
787 "Cron",
788 "Authpriv",
789 "FTP",
790 "NTP",
791 "Security",
792 "Console",
793 "SolarisCron",
794 "Local0",
795 "Local1",
796 "Local2",
797 "Local3",
798 "Local4",
799 "Local5",
800 "Local6",
801 "Local7"
802 ],
803 "enumDescriptions": {
804 "Auth": "Security/authentication messages.",
805 "Authpriv": "Security/authentication messages.",
806 "Console": "Log alert.",
807 "Cron": "Clock daemon.",
808 "Daemon": "System daemons.",
809 "FTP": "FTP daemon.",
810 "Kern": "Kernel messages.",
811 "LPR": "Line printer subsystem.",
812 "Local0": "Locally used facility 0.",
813 "Local1": "Locally used facility 1.",
814 "Local2": "Locally used facility 2.",
815 "Local3": "Locally used facility 3.",
816 "Local4": "Locally used facility 4.",
817 "Local5": "Locally used facility 5.",
818 "Local6": "Locally used facility 6.",
819 "Local7": "Locally used facility 7.",
820 "Mail": "Mail system.",
821 "NTP": "NTP subsystem.",
822 "News": "Network news subsystem.",
823 "Security": "Log audit.",
824 "SolarisCron": "Scheduling daemon.",
825 "Syslog": "Messages generated internally by syslogd.",
826 "UUCP": "UUCP subsystem.",
827 "User": "User-level messages."
828 },
829 "longDescription": "This type shall specify the syslog facility codes as program types. Facility values are described in the RFC5424.",
830 "type": "string"
831 },
832 "SyslogFilter": {
833 "additionalProperties": false,
834 "description": "A syslog filter.",
835 "longDescription": "This type shall contain the filter for a syslog message. The filter shall describe the desired syslog message to forward to a remote syslog server.",
836 "patternProperties": {
837 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
838 "description": "This property shall specify a valid odata or Redfish property.",
839 "type": [
840 "array",
841 "boolean",
842 "integer",
843 "number",
844 "null",
845 "object",
846 "string"
847 ]
848 }
849 },
850 "properties": {
851 "LogFacilities": {
852 "description": "The types of programs that can log messages.",
853 "items": {
854 "anyOf": [
855 {
856 "$ref": "#/definitions/SyslogFacility"
857 },
858 {
859 "type": "null"
860 }
861 ]
862 },
863 "longDescription": "This property shall contain the types of programs that can log messages. If this property contains an empty array or is absent, all facilities shall be indicated.",
864 "readonly": false,
865 "type": "array",
866 "versionAdded": "v1_9_0"
867 },
868 "LowestSeverity": {
869 "anyOf": [
870 {
871 "$ref": "#/definitions/SyslogSeverity"
872 },
873 {
874 "type": "null"
875 }
876 ],
877 "description": "The lowest severity level message that will be forwarded.",
878 "longDescription": "This property shall contain the lowest syslog severity level that will be forwarded. The service shall forward all messages equal to or greater than the value in this property. The value `All` shall indicate all severities.",
879 "readonly": false,
880 "versionAdded": "v1_9_0"
881 }
882 },
883 "type": "object"
884 },
885 "SyslogSeverity": {
886 "description": "The syslog severity is an application-specific rating used to describe the urgency of the message.",
887 "enum": [
888 "Emergency",
889 "Alert",
890 "Critical",
891 "Error",
892 "Warning",
893 "Notice",
894 "Informational",
895 "Debug",
896 "All"
897 ],
898 "enumDescriptions": {
899 "Alert": "A condition that should be corrected immediately, such as a corrupted system database.",
900 "All": "A message of any severity.",
901 "Critical": "Hard device errors.",
902 "Debug": "Messages that contain information normally of use only when debugging a program.",
903 "Emergency": "A panic condition.",
904 "Error": "An Error.",
905 "Informational": "Informational only.",
906 "Notice": "Conditions that are not error conditions, but that may require special handling.",
907 "Warning": "A Warning."
908 },
909 "longDescription": "This type shall specify the syslog severity levels as an application-specific rating used to describe the urgency of the message. `Emergency` should be reserved for messages indicating the system is unusable and `Debug` should only be used when debugging a program. Severity values are described in RFC5424.",
910 "type": "string"
Ed Tanous118b1c72018-09-13 13:45:51 -0700911 }
912 },
913 "owningEntity": "DMTF",
Ed Tanoused761212022-09-23 15:03:29 -0700914 "release": "2022.1",
915 "title": "#EventDestination.v1_12_0.EventDestination"
Ed Tanous118b1c72018-09-13 13:45:51 -0700916}