1{ 2 "$id": "http://redfish.dmtf.org/schemas/v1/LogService.v1_7_0.json", 3 "$ref": "#/definitions/LogService", 4 "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json", 5 "copyright": "Copyright 2014-2024 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright", 6 "definitions": { 7 "Actions": { 8 "additionalProperties": false, 9 "description": "The available actions for this resource.", 10 "longDescription": "This type shall contain the available actions for this resource.", 11 "patternProperties": { 12 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 13 "description": "This property shall specify a valid odata or Redfish property.", 14 "type": [ 15 "array", 16 "boolean", 17 "integer", 18 "number", 19 "null", 20 "object", 21 "string" 22 ] 23 } 24 }, 25 "properties": { 26 "#LogService.ClearLog": { 27 "$ref": "#/definitions/ClearLog" 28 }, 29 "#LogService.CollectDiagnosticData": { 30 "$ref": "#/definitions/CollectDiagnosticData" 31 }, 32 "#LogService.PushDiagnosticData": { 33 "$ref": "#/definitions/PushDiagnosticData" 34 }, 35 "Oem": { 36 "$ref": "#/definitions/OemActions", 37 "description": "The available OEM-specific actions for this resource.", 38 "longDescription": "This property shall contain the available OEM-specific actions for this resource." 39 } 40 }, 41 "type": "object" 42 }, 43 "AutoClearResolvedEntries": { 44 "enum": [ 45 "ClearEventGroup", 46 "RetainCauseResolutionEntries", 47 "UpdateCauseEntry", 48 "None" 49 ], 50 "enumDescriptions": { 51 "ClearEventGroup": "Automatically clears all resolved log entries and other entries within the same `EventGroupId`.", 52 "None": "Do not automatically clear the resolved log entries.", 53 "RetainCauseResolutionEntries": "Retains log entries of the original cause and the final resolution, but automatically clears other entries containing the intermediate results within the same `EventGroupId`.", 54 "UpdateCauseEntry": "Updates log entries of the original cause, but automatically clears other entries within the same `EventGroupId`." 55 }, 56 "enumLongDescriptions": { 57 "ClearEventGroup": "This value shall indicate this log service automatically clears all log entries that contain the value `true` for the `Resolved` property and other entries within the same `EventGroupId`.", 58 "None": "This value shall indicate this log service does not automatically clear the resolved log entries.", 59 "RetainCauseResolutionEntries": "This value shall indicate this log service retains the entries containing the original cause and the final resolution, but automatically clears other entries containing the intermediate results within the same `EventGroupId`. For example, the original cause of a fan failure is indicated by an entry containing the `FanFailed` message key in the `MessageId` property, followed by the entries containing `FanRemoved` and `FanInserted` message keys corresponding to user actions. Finally, an entry showing the fan failure is repaired with `FanRestored` message key in the `MessageId` property. In this case, the entries with `FanFailed` and `FanRestored` message keys are retained, but other entries within the same `EventGroupId` are automatically cleared.", 60 "UpdateCauseEntry": "This value shall indicate this log service updates the entry containing the original cause for the repaired status, but automatically clears other entries within the same `EventGroupId`. For example, the original cause of a fan failure is indicated by an entry containing `FanFailed` message key in the `MessageId` property, followed by the entries containing `FanRemoved` and `FanInserted` message keys corresponding to user actions. Finally, an entry showing the fan failure is repaired with `FanRestored` message key in the `MessageId` property. In this case, the entry with `FanFailed` message key is updated to show the repaired status, such as updating the value of Resolved property to `true` and the timestamp contained by the `Modified` property, but other entries within the same `EventGroupId` are automatically cleared." 61 }, 62 "type": "string" 63 }, 64 "ClearLog": { 65 "additionalProperties": false, 66 "description": "The action to clear the log for this log service.", 67 "longDescription": "This action shall delete all entries found in the `LogEntryCollection` resource for this log service.", 68 "parameters": { 69 "LogEntriesETag": { 70 "description": "The ETag of the log entry collection within this log service. If the provided ETag does not match the current ETag of the log entry collection, the request is rejected.", 71 "longDescription": "This parameter shall contain the ETag of the `LogEntryCollection` resource for this log service. If the client-provided ETag does not match the current ETag of the `LogEntryCollection` resource for this log service, the service shall return the HTTP `428 Precondition Required` status code to reject the request.", 72 "type": "string", 73 "versionAdded": "v1_3_0" 74 } 75 }, 76 "patternProperties": { 77 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 78 "description": "This property shall specify a valid odata or Redfish property.", 79 "type": [ 80 "array", 81 "boolean", 82 "integer", 83 "number", 84 "null", 85 "object", 86 "string" 87 ] 88 } 89 }, 90 "properties": { 91 "target": { 92 "description": "Link to invoke action", 93 "format": "uri-reference", 94 "type": "string" 95 }, 96 "title": { 97 "description": "Friendly action name", 98 "type": "string" 99 } 100 }, 101 "type": "object" 102 }, 103 "CollectDiagnosticData": { 104 "additionalProperties": false, 105 "description": "The action to collect the diagnostic data for the given type. When the diagnostic data is collected, a new log entry will be created and the additional data referenced by the new log entry will contain the diagnostic data.", 106 "longDescription": "This action shall collect the diagnostic data for the given type. The `Location` header in the response shall contain a URI to a resource of type `LogEntry` that contains the diagnostic data. The `AdditionalDataURI` property in the referenced `LogEntry` resource shall contain the URI to download the diagnostic data.", 107 "parameters": { 108 "DiagnosticDataType": { 109 "$ref": "#/definitions/LogDiagnosticDataTypes", 110 "description": "The type of diagnostic data to collect.", 111 "longDescription": "This parameter shall contain the type of diagnostic data to collect.", 112 "requiredParameter": true 113 }, 114 "OEMDiagnosticDataType": { 115 "description": "The OEM-defined type of diagnostic data to collect.", 116 "longDescription": "This parameter shall contain the OEM-defined type of diagnostic data to collect. This parameter shall be required if `DiagnosticDataType` is `OEM`.", 117 "type": "string" 118 }, 119 "Password": { 120 "description": "The password to access the URI specified by the `TargetURI` parameter.", 121 "longDescription": "This parameter shall contain the password to access the URI specified by the `TargetURI` parameter.", 122 "type": "string", 123 "versionAdded": "v1_6_0" 124 }, 125 "TargetURI": { 126 "description": "The URI to access when sending the diagnostic data.", 127 "format": "uri-reference", 128 "longDescription": "This parameter shall contain the URI to access when sending the diagnostic data. If this parameter is not provided by the client, the service shall not send the diagnostic data.", 129 "type": "string", 130 "versionAdded": "v1_6_0" 131 }, 132 "TransferProtocol": { 133 "$ref": "#/definitions/TransferProtocolType", 134 "description": "The network protocol that the service uses to send the diagnostic data.", 135 "longDescription": "This parameter shall contain the network protocol that the service uses to send the diagnostic data.", 136 "versionAdded": "v1_6_0" 137 }, 138 "UserName": { 139 "description": "The username to access the URI specified by the `TargetURI` parameter.", 140 "longDescription": "This parameter shall contain the username to access the URI specified by the `TargetURI` parameter.", 141 "type": "string", 142 "versionAdded": "v1_6_0" 143 } 144 }, 145 "patternProperties": { 146 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 147 "description": "This property shall specify a valid odata or Redfish property.", 148 "type": [ 149 "array", 150 "boolean", 151 "integer", 152 "number", 153 "null", 154 "object", 155 "string" 156 ] 157 } 158 }, 159 "properties": { 160 "target": { 161 "description": "Link to invoke action", 162 "format": "uri-reference", 163 "type": "string" 164 }, 165 "title": { 166 "description": "Friendly action name", 167 "type": "string" 168 } 169 }, 170 "type": "object", 171 "versionAdded": "v1_2_0" 172 }, 173 "DiagnosticDataDetails": { 174 "additionalProperties": false, 175 "description": "The detailed information for the data collected with the `CollectDiagnosticData` action for a type of diagnostic data.", 176 "longDescription": "This type shall contain the detailed information for the data collected with the `CollectDiagnosticData` action for a type of diagnostic data.", 177 "patternProperties": { 178 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 179 "description": "This property shall specify a valid odata or Redfish property.", 180 "type": [ 181 "array", 182 "boolean", 183 "integer", 184 "number", 185 "null", 186 "object", 187 "string" 188 ] 189 } 190 }, 191 "properties": { 192 "DiagnosticDataType": { 193 "anyOf": [ 194 { 195 "$ref": "#/definitions/LogDiagnosticDataTypes" 196 }, 197 { 198 "type": "null" 199 } 200 ], 201 "description": "The type of diagnostic data to collect with the `CollectDiagnosticData` action.", 202 "longDescription": "This property shall contain the type of diagnostic data to collect with the `CollectDiagnosticData` action.", 203 "readonly": true, 204 "versionAdded": "v1_7_0" 205 }, 206 "EstimatedDuration": { 207 "description": "The estimated total time required to generate the data with the `CollectDiagnosticData` action.", 208 "longDescription": "This property shall contain the estimated total time required to generate the data with the `CollectDiagnosticData` action. This value shall not include the duration that it takes the data to transfer to a remote server.", 209 "pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(.\\d+)?S)?)?$", 210 "readonly": true, 211 "type": [ 212 "string", 213 "null" 214 ], 215 "versionAdded": "v1_7_0" 216 }, 217 "EstimatedSizeBytes": { 218 "description": "The estimated size of the data collected by `CollectDiagnosticData` action.", 219 "longDescription": "This property shall contain the estimated size of the data collected by `CollectDiagnosticData` action.", 220 "readonly": true, 221 "type": [ 222 "integer", 223 "null" 224 ], 225 "versionAdded": "v1_7_0" 226 }, 227 "OEMDiagnosticDataType": { 228 "description": "The OEM-defined type of diagnostic data to collect with the `CollectDiagnosticData` action.", 229 "longDescription": "This property shall contain the OEM-defined type of diagnostic data to collect with the `CollectDiagnosticData` action. This property is required if `DiagnosticDataType` is `OEM`.", 230 "readonly": true, 231 "type": [ 232 "string", 233 "null" 234 ], 235 "versionAdded": "v1_7_0" 236 } 237 }, 238 "type": "object" 239 }, 240 "LogDiagnosticDataTypes": { 241 "enum": [ 242 "Manager", 243 "PreOS", 244 "OS", 245 "OEM" 246 ], 247 "enumDescriptions": { 248 "Manager": "Manager diagnostic data.", 249 "OEM": "OEM diagnostic data.", 250 "OS": "Operating system (OS) diagnostic data.", 251 "PreOS": "Pre-OS diagnostic data." 252 }, 253 "type": "string" 254 }, 255 "LogEntryTypes": { 256 "enum": [ 257 "Event", 258 "SEL", 259 "Multiple", 260 "OEM", 261 "CXL" 262 ], 263 "enumDescriptions": { 264 "CXL": "The log contains CXL log entries.", 265 "Event": "The log contains Redfish-defined messages.", 266 "Multiple": "The log contains multiple log entry types and, therefore, the log service cannot guarantee a single entry type.", 267 "OEM": "The log contains entries in an OEM-defined format.", 268 "SEL": "The log contains legacy IPMI System Event Log (SEL) entries." 269 }, 270 "enumVersionAdded": { 271 "CXL": "v1_5_0" 272 }, 273 "type": "string" 274 }, 275 "LogPurpose": { 276 "enum": [ 277 "Diagnostic", 278 "Operations", 279 "Security", 280 "Telemetry", 281 "ExternalEntity", 282 "OEM" 283 ], 284 "enumDescriptions": { 285 "Diagnostic": "The log provides information for diagnosing hardware or software issues, such as error conditions, sensor threshold trips, or exception cases.", 286 "ExternalEntity": "The log exposes log entries provided by external entities, such as external users, system firmware, operating systems, or management applications.", 287 "OEM": "The log is used for an OEM-defined purpose.", 288 "Operations": "The log provides information about management operations that have a significant impact on the system, such as firmware updates, system resets, and storage volume creation.", 289 "Security": "The log provides security-related information such as authentication, authorization, and data access logging required for security audits.", 290 "Telemetry": "The log provides telemetry history, typically collected on a regular basis." 291 }, 292 "type": "string" 293 }, 294 "LogService": { 295 "additionalProperties": false, 296 "description": "The `LogService` schema contains properties for monitoring and configuring a log service. When the `Id` property contains `DeviceLog`, the log contains device-resident log entries that follow the physical device when moved from system-to-system, and not a replication or subset of a system event log.", 297 "longDescription": "This resource shall represent a log service for a Redfish implementation. When the `Id` property contains `DeviceLog`, the log shall contain log entries that migrate with the device.", 298 "patternProperties": { 299 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 300 "description": "This property shall specify a valid odata or Redfish property.", 301 "type": [ 302 "array", 303 "boolean", 304 "integer", 305 "number", 306 "null", 307 "object", 308 "string" 309 ] 310 } 311 }, 312 "properties": { 313 "@odata.context": { 314 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context" 315 }, 316 "@odata.etag": { 317 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag" 318 }, 319 "@odata.id": { 320 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id" 321 }, 322 "@odata.type": { 323 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type" 324 }, 325 "Actions": { 326 "$ref": "#/definitions/Actions", 327 "description": "The available actions for this resource.", 328 "longDescription": "This property shall contain the available actions for this resource." 329 }, 330 "AutoClearResolvedEntries": { 331 "anyOf": [ 332 { 333 "$ref": "#/definitions/AutoClearResolvedEntries" 334 }, 335 { 336 "type": "null" 337 } 338 ], 339 "description": "Indicates if this log service automatically clears the resolved log entries.", 340 "longDescription": "This property shall indicate if this log service automatically clears the resolved log entries found in the `LogEntryCollection` resource. If this property is not present, the value shall be assumed to be `None`.", 341 "readonly": false, 342 "versionAdded": "v1_7_0" 343 }, 344 "AutoDSTEnabled": { 345 "description": "An indication of whether the log service is configured for automatic Daylight Saving Time (DST) adjustment.", 346 "longDescription": "This property shall indicate whether the log service is configured for automatic Daylight Saving Time (DST) adjustment. DST adjustment shall not modify the timestamp of existing log entries.", 347 "readonly": false, 348 "type": "boolean", 349 "versionAdded": "v1_3_0" 350 }, 351 "DateTime": { 352 "description": "The current date and time with UTC offset of the log service.", 353 "format": "date-time", 354 "longDescription": "This property shall contain the current date and time with UTC offset of the log service.", 355 "readonly": false, 356 "type": [ 357 "string", 358 "null" 359 ] 360 }, 361 "DateTimeLocalOffset": { 362 "description": "The time offset from UTC that the `DateTime` property is in `+HH:MM` format.", 363 "longDescription": "This property shall contain the offset from UTC time that the `DateTime` property contains. If both `DateTime` and `DateTimeLocalOffset` are provided in modification requests, services shall apply DateTimeLocalOffset after DateTime is applied.", 364 "pattern": "^([-+][0-1][0-9]:[0-5][0-9])$", 365 "readonly": false, 366 "type": [ 367 "string", 368 "null" 369 ] 370 }, 371 "Description": { 372 "anyOf": [ 373 { 374 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description" 375 }, 376 { 377 "type": "null" 378 } 379 ], 380 "readonly": true 381 }, 382 "DiagnosticDataDetails": { 383 "description": "The detailed information for the data collected with the `CollectDiagnosticData` action.", 384 "items": { 385 "anyOf": [ 386 { 387 "$ref": "#/definitions/DiagnosticDataDetails" 388 }, 389 { 390 "type": "null" 391 } 392 ] 393 }, 394 "longDescription": "This property shall contain the detailed information for the data collected with the `CollectDiagnosticData` action.", 395 "type": "array", 396 "versionAdded": "v1_7_0" 397 }, 398 "Entries": { 399 "$ref": "http://redfish.dmtf.org/schemas/v1/LogEntryCollection.json#/definitions/LogEntryCollection", 400 "description": "The link to the log entry collection.", 401 "longDescription": "This property shall contain a link to a resource collection of type `LogEntryCollection`.", 402 "readonly": true 403 }, 404 "Id": { 405 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id", 406 "readonly": true 407 }, 408 "LogEntryType": { 409 "anyOf": [ 410 { 411 "$ref": "#/definitions/LogEntryTypes" 412 }, 413 { 414 "type": "null" 415 } 416 ], 417 "description": "The format of the log entries.", 418 "longDescription": "This property shall contain the value for the `EntryType` property of all `LogEntry` resources contained in the `LogEntryCollection` resource for this log service. If the service cannot determine or guarantee a single EntryType value for all `LogEntry` resources, this property shall contain the value `Multiple`.", 419 "readonly": true, 420 "versionAdded": "v1_1_0" 421 }, 422 "LogPurposes": { 423 "description": "The purposes of the log.", 424 "items": { 425 "anyOf": [ 426 { 427 "$ref": "#/definitions/LogPurpose" 428 }, 429 { 430 "type": "null" 431 } 432 ] 433 }, 434 "longDescription": "This property shall contain the purposes of the log.", 435 "readonly": true, 436 "type": "array", 437 "versionAdded": "v1_4_0" 438 }, 439 "MaxNumberOfRecords": { 440 "description": "The maximum number of log entries that this service can have.", 441 "longDescription": "This property shall contain the maximum number of `LogEntry` resources in the `LogEntryCollection` resource for this service.", 442 "minimum": 0, 443 "readonly": true, 444 "type": "integer" 445 }, 446 "Name": { 447 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name", 448 "readonly": true 449 }, 450 "OEMLogPurpose": { 451 "description": "The OEM-specified purpose of the log if `LogPurposes` contains `OEM`.", 452 "longDescription": "This property shall contain the OEM-specified purpose of the log if `LogPurposes` contains `OEM`.", 453 "readonly": true, 454 "type": [ 455 "string", 456 "null" 457 ], 458 "versionAdded": "v1_4_0" 459 }, 460 "Oem": { 461 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 462 "description": "The OEM extension property.", 463 "longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements." 464 }, 465 "OverWritePolicy": { 466 "$ref": "#/definitions/OverWritePolicy", 467 "description": "The overwrite policy for this service that takes place when the log is full.", 468 "longDescription": "This property shall indicate the policy of the log service when the `MaxNumberOfRecords` has been reached.", 469 "readonly": true 470 }, 471 "Overflow": { 472 "description": "Indicates whether the log service has overflowed.", 473 "longDescription": "This property shall indicate whether the log service has overflowed and is no longer able to store new logs.", 474 "readonly": true, 475 "type": "boolean", 476 "versionAdded": "v1_4_0" 477 }, 478 "Persistency": { 479 "description": "Indicates whether the log service is persistent across a cold reset.", 480 "longDescription": "This property shall indicate whether the log service is persistent across a cold reset of the device.", 481 "readonly": true, 482 "type": "boolean", 483 "versionAdded": "v1_4_0" 484 }, 485 "ServiceEnabled": { 486 "description": "An indication of whether this service is enabled.", 487 "longDescription": "This property shall indicate whether this service is enabled.", 488 "readonly": false, 489 "type": [ 490 "boolean", 491 "null" 492 ] 493 }, 494 "Status": { 495 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status", 496 "description": "The status and health of the resource and its subordinate or dependent resources.", 497 "longDescription": "This property shall contain any status or health properties of the resource." 498 }, 499 "SyslogFilters": { 500 "description": "A list of syslog message filters to be logged locally.", 501 "items": { 502 "anyOf": [ 503 { 504 "$ref": "#/definitions/SyslogFilter" 505 }, 506 { 507 "type": "null" 508 } 509 ] 510 }, 511 "longDescription": "This property shall describe all desired syslog messages to be logged locally. If this property contains an empty array, all messages shall be logged.", 512 "type": "array", 513 "versionAdded": "v1_2_0" 514 } 515 }, 516 "required": [ 517 "@odata.id", 518 "@odata.type", 519 "Id", 520 "Name" 521 ], 522 "type": "object" 523 }, 524 "OemActions": { 525 "additionalProperties": true, 526 "description": "The available OEM-specific actions for this resource.", 527 "longDescription": "This type shall contain the available OEM-specific actions for this resource.", 528 "patternProperties": { 529 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 530 "description": "This property shall specify a valid odata or Redfish property.", 531 "type": [ 532 "array", 533 "boolean", 534 "integer", 535 "number", 536 "null", 537 "object", 538 "string" 539 ] 540 } 541 }, 542 "properties": {}, 543 "type": "object" 544 }, 545 "OverWritePolicy": { 546 "enum": [ 547 "Unknown", 548 "WrapsWhenFull", 549 "NeverOverWrites" 550 ], 551 "enumDescriptions": { 552 "NeverOverWrites": "When full, new entries to the log are discarded.", 553 "Unknown": "The overwrite policy is not known or is undefined.", 554 "WrapsWhenFull": "When full, new entries to the log overwrite earlier entries." 555 }, 556 "type": "string" 557 }, 558 "PushDiagnosticData": { 559 "additionalProperties": false, 560 "description": "The action to push an existing diagnostic data to a target URI.", 561 "longDescription": "This action shall send an existing diagnostic data to a target URI.", 562 "parameters": { 563 "AdditionalDataURI": { 564 "description": "The URI of the diagnostic data to transfer to the URI specified by the `TargetURI` parameter.", 565 "format": "uri-reference", 566 "longDescription": "This parameter shall contain the URI of the diagnostic data to transfer to the URI specified by the `TargetURI` parameter.", 567 "requiredParameter": true, 568 "type": "string" 569 }, 570 "Password": { 571 "description": "The password to access the URI specified by the `TargetURI` parameter.", 572 "longDescription": "This parameter shall contain the password to access the URI specified by the `TargetURI` parameter.", 573 "type": "string" 574 }, 575 "TargetURI": { 576 "description": "The URI to access when sending the diagnostic data.", 577 "format": "uri-reference", 578 "longDescription": "This parameter shall contain the URI to access when sending the diagnostic data.", 579 "requiredParameter": true, 580 "type": "string" 581 }, 582 "TransferProtocol": { 583 "$ref": "#/definitions/TransferProtocolType", 584 "description": "The network protocol that the service uses to send the diagnostic data.", 585 "longDescription": "This parameter shall contain the network protocol that the service uses to send the diagnostic data." 586 }, 587 "UserName": { 588 "description": "The username to access the URI specified by the `TargetURI` parameter.", 589 "longDescription": "This parameter shall contain the username to access the URI specified by the `TargetURI` parameter.", 590 "type": "string" 591 } 592 }, 593 "patternProperties": { 594 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 595 "description": "This property shall specify a valid odata or Redfish property.", 596 "type": [ 597 "array", 598 "boolean", 599 "integer", 600 "number", 601 "null", 602 "object", 603 "string" 604 ] 605 } 606 }, 607 "properties": { 608 "target": { 609 "description": "Link to invoke action", 610 "format": "uri-reference", 611 "type": "string" 612 }, 613 "title": { 614 "description": "Friendly action name", 615 "type": "string" 616 } 617 }, 618 "type": "object", 619 "versionAdded": "v1_6_0" 620 }, 621 "SyslogFacility": { 622 "description": "The syslog facility code is an enumeration of program types.", 623 "enum": [ 624 "Kern", 625 "User", 626 "Mail", 627 "Daemon", 628 "Auth", 629 "Syslog", 630 "LPR", 631 "News", 632 "UUCP", 633 "Cron", 634 "Authpriv", 635 "FTP", 636 "NTP", 637 "Security", 638 "Console", 639 "SolarisCron", 640 "Local0", 641 "Local1", 642 "Local2", 643 "Local3", 644 "Local4", 645 "Local5", 646 "Local6", 647 "Local7" 648 ], 649 "enumDescriptions": { 650 "Auth": "Security/authentication messages.", 651 "Authpriv": "Security/authentication messages.", 652 "Console": "Log alert.", 653 "Cron": "Clock daemon.", 654 "Daemon": "System daemons.", 655 "FTP": "FTP daemon.", 656 "Kern": "Kernel messages.", 657 "LPR": "Line printer subsystem.", 658 "Local0": "Locally used facility 0.", 659 "Local1": "Locally used facility 1.", 660 "Local2": "Locally used facility 2.", 661 "Local3": "Locally used facility 3.", 662 "Local4": "Locally used facility 4.", 663 "Local5": "Locally used facility 5.", 664 "Local6": "Locally used facility 6.", 665 "Local7": "Locally used facility 7.", 666 "Mail": "Mail system.", 667 "NTP": "NTP subsystem.", 668 "News": "Network news subsystem.", 669 "Security": "Log audit.", 670 "SolarisCron": "Scheduling daemon.", 671 "Syslog": "Messages generated internally by syslogd.", 672 "UUCP": "UUCP subsystem.", 673 "User": "User-level messages." 674 }, 675 "longDescription": "This type shall specify the syslog facility codes as program types. Facility values are described in the RFC5424.", 676 "type": "string" 677 }, 678 "SyslogFilter": { 679 "additionalProperties": false, 680 "description": "A syslog filter.", 681 "longDescription": "This type shall contain the filter for a syslog message. The filter shall describe the desired syslog message to be enabled locally.", 682 "patternProperties": { 683 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 684 "description": "This property shall specify a valid odata or Redfish property.", 685 "type": [ 686 "array", 687 "boolean", 688 "integer", 689 "number", 690 "null", 691 "object", 692 "string" 693 ] 694 } 695 }, 696 "properties": { 697 "LogFacilities": { 698 "description": "The types of programs that can log messages.", 699 "items": { 700 "anyOf": [ 701 { 702 "$ref": "#/definitions/SyslogFacility" 703 }, 704 { 705 "type": "null" 706 } 707 ] 708 }, 709 "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.", 710 "readonly": false, 711 "type": "array", 712 "versionAdded": "v1_2_0" 713 }, 714 "LowestSeverity": { 715 "anyOf": [ 716 { 717 "$ref": "#/definitions/SyslogSeverity" 718 }, 719 { 720 "type": "null" 721 } 722 ], 723 "description": "The lowest severity level message that will be logged.", 724 "longDescription": "This property shall contain the lowest syslog severity level that will be logged. The service shall log all messages equal to or greater than the value in this property. The value `All` shall indicate all severities.", 725 "readonly": false, 726 "versionAdded": "v1_2_0" 727 } 728 }, 729 "type": "object" 730 }, 731 "SyslogSeverity": { 732 "description": "The syslog severity is an application-specific rating used to describe the urgency of the message.", 733 "enum": [ 734 "Emergency", 735 "Alert", 736 "Critical", 737 "Error", 738 "Warning", 739 "Notice", 740 "Informational", 741 "Debug", 742 "All" 743 ], 744 "enumDescriptions": { 745 "Alert": "A condition that should be corrected immediately, such as a corrupted system database.", 746 "All": "A message of any severity.", 747 "Critical": "Hard device errors.", 748 "Debug": "Messages that contain information normally of use only when debugging a program.", 749 "Emergency": "A panic condition.", 750 "Error": "An Error.", 751 "Informational": "Informational only.", 752 "Notice": "Conditions that are not error conditions, but that might require special handling.", 753 "Warning": "A Warning." 754 }, 755 "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.", 756 "type": "string" 757 }, 758 "TransferProtocolType": { 759 "enum": [ 760 "CIFS", 761 "FTP", 762 "SFTP", 763 "HTTP", 764 "HTTPS", 765 "NFS", 766 "SCP", 767 "TFTP", 768 "OEM" 769 ], 770 "enumDescriptions": { 771 "CIFS": "Common Internet File System (CIFS).", 772 "FTP": "File Transfer Protocol (FTP).", 773 "HTTP": "Hypertext Transfer Protocol (HTTP).", 774 "HTTPS": "Hypertext Transfer Protocol Secure (HTTPS).", 775 "NFS": "Network File System (NFS).", 776 "OEM": "A manufacturer-defined protocol.", 777 "SCP": "Secure Copy Protocol (SCP).", 778 "SFTP": "SSH File Transfer Protocol (SFTP).", 779 "TFTP": "Trivial File Transfer Protocol (TFTP)." 780 }, 781 "type": "string" 782 } 783 }, 784 "language": "en", 785 "owningEntity": "DMTF", 786 "release": "2024.1", 787 "title": "#LogService.v1_7_0.LogService" 788}