PUT /gemfire-api/v1/queries/{queryId}

This topic describes the PUT command in VMware Tanzu GemFire to update a named, parameterized query.

Resource URL

http://<hostname_or_http-service-bind-address>:<http-service-port>/gemfire-api/v1/queries/{queryId}

Parameters

Parameter	Description	Example Values
q	OQL String. The OQL query must be a SELECT expression that references at least one region.	"SELECT DISTINCT from /customers WHERE lastName=$1"

Note: You cannot specify the query string inside the request body as JSON. You must specify the query as a URL parameter.

Example Request

PUT /gemfire-api/v1/queries/selectOrders?q="SELECT DISTINCT from /customers where lastName=$1"

Accept: application/json
Content-Length: <#-of-bytes>

Example Success Response

Response Payload:  null

200 OK

Error Codes

Status Code	Description
401 UNAUTHORIZED	Invalid Username or Password
403 FORBIDDEN	Insufficient privileges for operation
404 NOT FOUND	QueryID does not exist
500 INTERNAL SERVER ERROR	Error encountered at Tanzu GemFire server. Check the HTTP response body for a stack trace of the exception.

Implementation Notes

This operation is idempotent, meaning multiple identical requests should have the same effect as the initial request.