|
Post by abiramisekar on Mar 4, 2021 18:27:57 GMT
As per the specification DSP0266 (https://www.dmtf.org/sites/default/files/standards/documents/DSP0266_1.12.0.pdf) under section 9.6 - Error Response: it is mentioned like below, Below lines are defined in specification, The @message.ExtendedInfo property should be present in all error responses. If the @message.ExtendedInfo property
is present, all information necessary to process the error should be provided in the @message.ExtendedInfo property.
Clients should look for the @message.ExtendedInfo property for error processing first, and fallback on the code and
message properties if @message.ExtendedInfo is not present.
there is contraversy in the above statement, which is mentioned in first line like - @message.ExtendedInfo property should be present in all error responses
but in the last line of the same paragraph it is mentioned like - fallback on the code and message properties if @message.ExtendedInfo is not present
which is not clear. Can you clarify under which all scenario "@message.ExtendedInfo", "code" and "message" property should be shown in response.
|
|
|
Post by mraineri on Mar 5, 2021 14:05:56 GMT
"Should" is a term meaning that it's recommended, but not mandatory. Because we don't require the property to be present, we've been asked to provide guidance for clients for what to do when the property is not present.
If the property were mandatory, you would see "shall" instead of "should".
|
|
|
Post by jautor on Mar 5, 2021 15:36:49 GMT
As Mike points out, the words "should" and "shall" have specific meanings in the specification, as explained in the "Terms, definitions, symbols and abbreviated terms" clause near the front of the document:
As the DMTF contributes the Redfish Specification to ISO, we follow their formal language throughout the specification and the "long description" text in the schema files. And yes, you can read any sentence that contains the word "shall" to mean "this is required functionality", and anything else is optional, but recommended - otherwise we wouldn't have put it in the specification.
Jeff
|
|
|
Post by abiramisekar on Mar 9, 2021 10:33:43 GMT
Thanks a lot for your reply and confirmation.
|
|