User Manual

4-8
Chapter 4: Redfish Technology Pack
• HEAD
The HEAD method differs from the GET method in that it MUST NOT return message
body information. However, all of the same meta information and status codes in the
HTTP headers will be returned as though a GET method were processed, including
authorization checks. Services may support the HEAD method in order to return meta
information in the form of HTTP response headers. Services may support the HEAD
method in order to verify link validity. Services may support the HEAD method in order
to verify resource accessibility. Services shall not support any other use of the HEAD
method. The HEAD method shall be idempotent in the absence of outside changes to
the resource.
B. Data Modification Requests
Clients create, modify, and delete resources by issuing the appropriate Create, Update,
Replace or Delete operation, or by invoking an Action on the resource.
The maximum request size set for request body in Redfish is 256KB.
• Update (PATCH)
The PATCH method is the preferred method used to perform updates on pre-existing
resources. Changes to the resource are sent in the request body. Properties not
specified in the request body are not directly changed by the PATCH request. The
response is either empty or a representation of the resource after the update was done.
The implementation may reject the update operation on certain fields based on its own
policies and, if so, shall not apply any of the update requested.
• Replace (PUT)
The PUT method is used to completely replace a resource. Properties omitted from the
request body are reset to their default value.
• Create (POST)
The POST method is used to create a new resource. The POST request is submitted
to the resource collection in which the new resource is to belong. Submitting a POST
request to a resource representing a collection is equivalent to submitting the same
request to the Members property of that resource.
• Delete (DELETE)
The DELETE method is used to remove a resource. Services shall support the
DELETE method for resources that can be deleted.
• Actions (POST)
The POST method is used to initiate operations on the object (such as Actions).
Services shall support the POST method for sending actions. The POST operation may
not be idempotent.
E16160_ASMB9-iKVM_UM_V3.indb 8E16160_ASMB9-iKVM_UM_V3.indb 8 1/17/2020 2:29:24 PM1/17/2020 2:29:24 PM