Table of Contents
Region Management
Create Region
API | Status Code | Response Body | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/regions Method: POST Headers: Authorization Permission Required: DATA:MANAGE
Types supported by this Rest API is defined in RegionType:
| 201 |
| |||||||||||||||||||||
409 |
| ||||||||||||||||||||||
400 |
Given an unknown input attribute, for example: foobar in: curl -d '{"name":"replicate2","type":"REPLICATE","foobar":"value"}' -H 'Content-Type: application/json' http://localhost:7070/management/experimental/regions the output is: { "statusCode" : "ILLEGAL_ARGUMENT", "statusMessage" : "JSON parse error: Unrecognized field \"foobar\" (class org.apache.geode.cache.configuration.Region), not marked as ignorable; nested exception is com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field \"foobar\" (class org.apache.geode.cache.configuration.Region), not marked as ignorable (9 known properties: \"indexes\", \"groups\", \"type\", \"regionAttributes\", \"customRegionElements\", \"regions\", \"entries\", \"name\", \"group\"])\n at [Source: (PushbackInputStream); line: 1, column: 59] (through reference chain: org.apache.geode.cache.configuration.Region[\"foobar\"])" } | ||||||||||||||||||||||
401 |
| ||||||||||||||||||||||
403 |
| ||||||||||||||||||||||
500 |
|
Notes:
- the CREATE[POST] endpoint is not idempotent, you will receive a 409 when creating the a region with the same name the 2nd time.
- if group name is "cluster" or omitted, the region will be created on all the data members in this cluster.
401 and 403 responses are omitted for the rest of the end points.
List Regions
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
200 |
| ||||||||
401 |
| ||||||||
403 |
|
Get Region
API | Status Code | Response Body | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
200 |
| ||||||||||
401 |
| ||||||||||
403 |
| ||||||||||
404 |
|
Delete Region
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/regions/Foo Method: DELETE Headers: Authorization | 200 |
| |||||||
404 |
| ||||||||
401 |
| ||||||||
403 |
| ||||||||
500 |
|
Note that the DELETE endpoint is idempotent – i.e. it should be a NOOP if the region does not exist.
Member Management
List Members
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Permission Required: CLUSTER:READ | 200 |
| |||||||
Endpoint: http://locator:7070/management/experimental/members?id=server-1 Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
| |||||||
Endpoint: http://locator:7070/management/experimental/members?id=Non-Existent Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
|
Get Member
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/members/server-1 Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
| |||||||
Endpoint: http://locator:7070/management/experimental/members/Non-Existent Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 404 |
|
Index Management
List Indexes
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/regions/{regionName}/indexes Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
|
Get Index
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/regions/{regionName}/indexes/{indexName} Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
| |||||||
Endpoint: http://locator:7070/management/experimental/regions/{regionName}/indexes/{indexName} Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 404 |
|
PDX Management
Configure PDX
API | Status Code | Response Body | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Endpoint:http://locator:7070/management/experimental/configurations/pdx Method: POST Headers: Authorization Permission Required: CLUSTER:MANAGE
| 201 |
|
Gateway Management
Create Gateway Receiver
API | Status Code | Response Body | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/gateways/receivers Method: POST Headers: Authorization Permission Required: CLUSTER:MANAGE
| 201 |
|
List Gateway Receivers
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/gateways/receivers Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
|
Get Gateway Receiver
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/gateways/receivers/{receiverGroup} Method: GET Headers: Authorization Permission Required: CLUSTER:READ | 200 |
|
Rebalance Operation
Start Rebalance
API | Status Code | Response Body | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/operations/rebalances Method: POST Headers: Authorization Permission Required: DATA:MANAGE
| 202 |
|
List Rebalance History
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/operations/rebalances Method: GET Headers: Authorization Permission Required: DATA:MANAGE | 200 |
|
Get Rebalance Status
API | Status Code | Response Body | |||||||
---|---|---|---|---|---|---|---|---|---|
Endpoint: http://locator:7070/management/experimental/operations/rebalances/{id} Method: GET Headers: Authorization Permission Required: DATA:MANAGE | 200 |
| |||||||
200 |
| ||||||||
200 |
| ||||||||
404 |
|
First header>
First div with some textSecond header
...