3.1.4.8 Request to Invoke an Action

Applies to the OData 3.0 protocol

When the higher layer needs to invoke an action in a data service, it MUST cause the client to send the appropriate Invoke Action request (section 2.2.7.5.1) type, as specified in the remainder of this section.

The higher layer MUST provide the request URI, which the higher layer obtained from a prior data service response or other means. As defined in Invoke Action Request (section 2.2.7.5.1), the URI MUST identify the Action to be invoked.

Requests to invoke an action MUST adhere to the syntax rules specified in Invoke Action Request (section 2.2.7.5.1).

Request headers MAY be provided with Invoke Action request types. However, this document defines no additional meaning or semantics to such request headers.

If the data service identified by the request URI supports tunneled requests and the action requires no parameter to be passed in the POST body, then an Invoke Action Request (section 2.2.7.5.1) MAY be sent as a tunneled request (section 2.2.7.7).

Rules for processing the response to an Invoke Action request are specified in Common Rules for Receiving Responses from Data Service Requests (section 3.1.5.1) and Executing a Received Invoke Action Request (section 3.2.5.9).