This pageapplies toApigee andApigee hybrid.

View Apigee Edge documentation.

What you'll learn in this topic

After reading this topic you will know the following:

• What request and response streaming on Apigee is
• When to use request and response streaming
• How to enable request and response streaming

What is request and response streaming?

By default, HTTP streaming is disabled and HTTP request and response payloads are written to a buffer in memory before they are processed by the API proxy pipeline. You can change this behavior by enabling streaming. With streaming enabled, request and response payloads are streamed without modification to the client app (for responses) and the target endpoint (for requests).

When should I enable streaming?

If your API proxy handles very large requests and/or responses (for size limits, seeWhat else should I know about streaming), you may want to enable streaming.

{"fault":"{\"detail\":{\"errorcode\":\"protocol.http.TooBigBody\"},\"faultstring\":\"Body buffer overflow\"}"}

If you see this error, we recommend that you enable streaming. If you continue to see the error after you enable streaming, consider removing any policies that require access to the request or response payload. For more information, see Message payload size.

What else should I know about streaming?

Message payload size is restricted to 30 MB. In non-streamed requests and responses, exceeding that size results in aprotocol.http.TooBigBody error.

For payloads larger than 30 MB, Apigee recommends using a signed URLs pattern within an Apigee JavaCallout, illustrated by the Edge Callout: Signed URL Generator example on GitHub.

When streaming is enabled, Apigee doesnot encode or decode request or response payloads before sending them to the client connecting to Apigee or a backend target server. See the rows forrequest.streaming.enabled andresponse.streaming.enabled in the TargetEndpoint Transport Property Specification table for more information.

How to enable request and response streaming

To enable request streaming you need to add therequest.streaming.enabled property to the ProxyEndpoint and TargetEndpoint definitions in the proxy bundle and set it totrue. Similarly, set theresponse.streaming.enabled property to enable response streaming.

You can locate these configuration files in the Apigee UI in the Develop view for your proxy. If you are developing locally, these definition files are inapiproxy/proxies andapiproxy/targets.

This sample shows how to enable both request and response streaming in the TargetEndpoint definition.

<TargetEndpoint name="default">  <HTTPTargetConnection>    <URL>http://mocktarget.apigee.net</URL>    <Properties>      <Property name="response.streaming.enabled">true</Property>      <Property name="request.streaming.enabled">true</Property>      <Property name="supports.http10">true</Property>      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>      <Property name="retain.queryparams">apikey</Property>    </Properties>  </HTTPTargetConnection></TargetEndpoint>

This example shows how to enable response and request streaming in the ProxyEndpoint definition:

<ProxyEndpoint name="default">  <HTTPProxyConnection>    <BasePath>/v1/weather</BasePath>    <Properties>      <Property name="allow.http10">true</Property>      <Property name="response.streaming.enabled">true</Property>      <Property name="request.streaming.enabled">true</Property>    </Properties>  </HTTPProxyConnection></ProxyEndpoint>

For more information about configuring endpoint definitions, seeEndpoint properties reference.

Related code samples

API proxy samples on GitHub are easy to download and use.

Sample proxies that feature streaming include:

• streaming - Demonstrates an API proxy configured for HTTP streaming.
• Edge Callout: Signed URL Generator - Illustrates the best practice of generating a signed URL to access large files instead of trying to stream them in a request/response.