THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
| Error Code | Error Definition | Error Description |
|---|---|---|
| LOW_MEMORY | Server does not have enough free memory to complete the operation | |
| 1000 | UNCLASSIFIED_FAILURE | This error will be thrown as a last resort if an exception cannot be classified. This error will then have to be investigated and correctly classified |
| 1100 | VALUE_ENCODING_ERROR | There was an error whilst encoding a data entry (key / value) |
| 1102 | DECODINGUNSUPPORTED_ERRORThere was an error whilst decoding a data entry (key / value)OPERATION | The request isn't a valid server operation |
| 1201 | AUTHORIZATION_FAILED | The client doesn't have sufficient access rights to perform this operation |
| 1300 | LOW_MEMORY | Server does not have enough free memory to complete the operation |
...
Get
Description
Gets the value associated with a particular key in a particular region.
...
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 | REGION_NOT_FOUND | No Region exists for the name provided |
| 2000 | CONSTRAINT_VIOLATION | The key-constraint on the region has been violated and incompatible |
...
Put
Description
Adds a (key, value) pair to a region, replacing any existing entry for the key.
...
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 | REGION_NOT_FOUND | No Region exists for the name provided |
| 2000 | CONSTRAINT_VIOLATION | The key-constraint on the region has been violated and incompatible |
...
Query
Description
Pass an OQL query to the server, which will execute it and return the result.
Request fields
query
Type: string
Description: OQL describing the query to run
timeoutInMillis
Type: int
Optional (defaults to 0).
Description: a timeout in milliseconds after which the query will terminate. If less than or equal to 0, no user-defined timeout is imposed.
parameters
Type: repeated EncodedValue
Must match the number of parameters expected for the query. Can be absent if no parameters are needed.
Description: must match any parameters specified in OQL
Response fields
queryResults
Type: repeated string
Description: One JSON formatted string per response (see AbstractBaseController.processQueryResponse)
Behavior notes
The query will timeout on the shorter of the provided timeout or the cache’s timeout (configured in gemfire.Cache.MAX_QUERY_EXECUTION_TIME).
Errors
...
CONSTRAINT_VIOLATION - Bind parameter is not of the expected type
...
BAD_QUERY - Name in the query cannot be resolved!
...
BAD_QUERY - Query cannot be parsed.
...
...
OPERATION_NOT_PERMITTED - Query is not permitted on this type of region!
...
OPERATION_TIMEOUT - Query execution time has exceeded max query execution time (gemfire.Cache.MAX_QUERY_EXECUTION_TIME) configured!
...
OPERATION_TIMEOUT - Query execution time has exceeded provided timeout
...
GetRegion
Description
Get a structure containing information about a region.
...
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 | REGION_NOT_FOUND | No Region exists for the name provided |
...
Returns a list of servers, in the cluster, visible to the client.
Request
| GetAvailableServersRequest | |||
| Field Name | Data type | Description | Mandatory? |
|---|---|---|---|
Response
| GetAvailableServersResponse | ||||
| Field Name | Data type | Description | Mandatory? | Repeated |
|---|---|---|---|---|
| servers | Server | A list of servers that are available in the cluster to connect to. | Y | Y |
Expected Behavior
- Return a list of all available servers in the cluster that are visible to the client
Errors
| Error Code | Error Definition | Error Description |
|---|---|---|
...
GetRegionNames
Description
Returns a list of regions available through this server.
Request
A GetRegionNamesRequest contains no extra data fields.
| GetRegionNamesRequest | |||
| Field Name | Data type | Description | Mandatory? |
|---|---|---|---|
Response
| GetRegionNamesResponse | ||||
| Field Name | Data type | Description | Mandatory? | Repeated |
|---|---|---|---|---|
| regions | String | A list of the names of the regions that are available on the server. | Y | Y |
...
This only gets the regions present on the target server. This may not be the set of all regions in the cluster, depending on how the servers are configured.
Errors
There are no errors particular to this operation.
| Error Code | Error Definition | Error Description |
|---|---|---|
...
Remove
Description
Remove an entry from a region.
Request
| RemoveRequest | |||
| Field Name | Data type | Description | Mandatory? |
|---|---|---|---|
| regionName | String | The name of the region to remove an entry from. | Y |
| key | EncodedValue | The key of the entry to be removed. | Y |
Response
The presence of a remove response indicates the entry is not longer present in the region. The response contains no additional data fields.
...
If the key is not present in the region, this operation will make no changes to the region. It will still return a RemoveResponse in this case.
Errors
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 | REGION_NOT_FOUND | No region with the provided regionName exists. |
| 2000 | CONSTRAINT_VIOLATION | The type of value provided for the key doesn’t match the region’s constraints. |
...
RemoveAll
...
Description
Removes all of a list of entries from a region.
...
Request
...
| RemoveAllRequest | ||||
| Field Name | Data type | Description | Mandatory? | Repeated? |
|---|---|---|---|---|
| regionName | String | The name of the region to remove entries from. | Y | N |
| key | EncodedValue | A list of keys who's entries should be removed. | Y | Y |
...
| Y |
Response
...
...
| RemoveAllResponse | ||||
| Field Name | Data type | Description | Mandatory? | Repeated |
|---|---|---|---|---|
| failedKeys | KeyedErrorResponse | A list of keys that were not removed. | N | Y |
...
Expected behavior
...
If a key is not present in the region, this operation will ignore it and continue with the others.
If a RemoveAllResponse is returned with a list of failedKeys, any keys from the request not present in the response have been removed. If an empty list is returned, all keys were removed.
Any keys present in failedKeys will have their entry remain in the same state they were in prior to this operation.
If an error response is returned by this operation (instead of a RemoveAllResponse), all entries remain in the same state as prior to this operation.
...
Errors
...
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 | REGION_NOT_FOUND | No region with the provided regionName exists. |
...
PutAll
Description
Put a collection of Entries into a region.
Request
...
| PutAllRequest | ||||
| Field Name | Data type | Description | Mandatory? | Repeated? |
|---|---|---|---|---|
| regionName | ||||
...
| String |
...
| The name of the region to put entries into. | Y | N |
| entries |
...
| Entry |
...
| A list of entries to add to the region. | Y | Y |
Response
...
| PutAllResponse | ||||
| Field Name | Data type | Description | Mandatory? | Repeated |
|---|---|---|---|---|
| failedKeys | ||||
...
| KeyedErrorResponse |
...
| A list of keys |
...
| that were not added. | N | Y |
Expected behavior
...
Behavior notes
...
If a PutAllResponse is returned with a list of failedKeys, any keys from the request not present in the
...
response were successfully
...
added/updated.
...
If two Entries share equal keys, a successful operation will result in one of the Entries being present in the region. Which one is undefined.
Any keys present in failedKeys will have their entry remain in the same state they were in prior to this operation.
If an error response is returned by this operation (instead of a RemoveAllResponse), all entries remain in the same state as prior to this operation.
Errors
Errors
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 |
| REGION_NOT_FOUND |
...
| No region with the provided regionName exists. |
...
CONSTRAINT_VIOLATION - the type of value provided for a key or value doesn’t match the region’s constraints.
...
GetAll
Description
Get a series of values from a region.
Request
...
| GetAllRequest | ||||
| Field Name | Data type | Description | Mandatory? | Repeated? |
|---|---|---|---|---|
| regionName | ||||
...
| String |
...
| The name of the region to get entries from. | Y | N |
| keys |
...
| EncodedValue |
...
Description: the keys to look up in the region.
| A list of keys to fetch values for. | Y | Y |
Response
| GetAllResponse | ||||
| Field Name | Data type | Description | Mandatory? | Repeated |
|---|---|---|---|---|
| entries | Entry | A list of looked up entries. | Y | Y |
| failedKeys | KeyedErrorResponse | A list of keys which generated errors on lookup. | N | Y |
Expected behavior
If a GetAllResponse is returned and no entry is returned for a particular key, and that key is not present in the failedKeys, then no entry exists for that key in the region.
Errors
| Error Code | Error Definition | Error Description |
|---|---|---|
| 2100 |
Response fields
entries
Type: repeated Entry
Description: the entries corresponding to keys that were present.
errors
Type: repeated ErrorEntry
Description: any keys that encountered an error will be returned here instead of in entries.
Behavior notes
An error for any key will return an error.
Any key not found in the region will return an Entry with that key and a null value.
...
| REGION_NOT_FOUND |
...
| No region with the provided regionName exists. |
...
CONSTRAINT_VIOLATION - the type of value provided for a key doesn’t match the region’s constraints.
...