SALES: 1-800-867-1380

Setting the Prefer Header to Manage Response Echo on Insert Operations

Updated: August 13, 2014

By default, the Create Table and Insert Entity operations return a response payload that echoes the data contained in the request body. For version 2013-08-15 and higher of the storage services and OData data service version 3.0, it is possible to omit the response body echo by setting the Prefer header to return-no-content. If the Prefer header is set to return-no-content, the service will respond with status code 204 (No Content) and response header Preference-Applied:return-no-content.

You can also set the Prefer header to return-content, which provides the default behavior of returning the response payload. In this case, the service will respond with status code 201 (Created) and response header Preference-Applied:return-content.

If no Prefer header is specified, the service responds with status code 201 (Created) without the Preference-Applied header in the response.

For more details, see the documentation for the OData Prefer header.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft