- Property Manager name: GraphQL Caching
- Behavior version: The
latest
rule format supports thegraphqlCaching
behavior v1.1. - Rule format status: Beta, possible breaking changes
- Access: Read/Write
- Allowed in includes: Not available for
latest
rule format
This behavior configures how to cache GraphQL-based API traffic. Enable caching
for your GraphQL API traffic, along with allowPost
to cache POST responses. To configure REST API traffic, use the rapid
behavior.
Option | Type | Description | Requires | |
---|---|---|---|---|
enabled | boolean | Enables GraphQL caching. | {"displayType":"boolean","tag":"input","type":"checkbox"} | |
cacheResponsesWithErrors | boolean | When enabled, caches responses that include an | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
postRequestProcessingErrorHandling | enum | Specify what happens if GraphQL query processing fails on POST requests. | {"displayType":"enum","options":["APPLY_CACHING_BEHAVIOR","NO_STORE"],"tag":"select"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
APPLY_CACHING_BEHAVIOR | If your GraphQL server does not allow mutations and subscriptions, this offloads requests. | |||
NO_STORE | Pass requests to the origin. | |||
operationsUrlQueryParameterName | string | Specifies the name of a query parameter that identifies requests as GraphQL queries. | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
operationsJsonBodyParameterName | string | The name of the JSON body parameter that identifies GraphQL POST requests. | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enabled","op":"eq","value":true}} |