POST /geode/v1/{region}?key=<key>
Create (put-if-absent) data in region.
Resource URL
http://<hostname_or_http-service-bind-address>:<http-service-port>/geode/v1/{region}?key=<key>
Parameters
Parameter | Description | Example Values |
---|---|---|
key | Optional. If you do not specify a key in the URL, a key will automatically be generated for you. | 123
myOrder |
Example Request
Request Payload: application/json
POST /geode/v1/orders?key=2
Accept: application/json
Content-Type: application/json
{
"@type": "org.apache.geode.web.rest.domain.Order",
"purchaseOrderNo": 112,
"customerId": 1012,
"description": "Purchase Order for myCompany",
"orderDate": "02/10/2014",
"deliveryDate": "02/20/2014",
"contact": "John Doe",
"email": "John.Doe@example.com",
"phone": "01-2048096",
"totalPrice": 225,
"items": [
{
"itemNo": 1,
"description": "Product2, PartA",
"quantity": 10,
"unitPrice": 5,
"totalPrice": 50
},
{
"itemNo": 2,
"description": "Product2, PartB",
"quantity": 20,
"unitPrice": 20,
"totalPrice": 400
}
]
}
Example Success Response
Response Payload: null
201 CREATED
Location: http://localhost:8080/geode/v1/orders/2
Error Codes
Status Code | Description |
---|---|
400 BAD REQUEST | Returned if JSON content is malformed. |
404 NOT FOUND | Returned if the specified region does not exist. |
409 CONFLICT | Returned if the provided key already exists in the region. |
500 INTERNAL SERVER ERROR | Error encountered at Geode server. Check the HTTP response body for a stack trace of the exception. |
Example Error Response
409 Conflict
Location:http://localhost:8080/geode/v1/orders/2
Content-Type: application/json
{
"purchaseOrderNo": 112,
"customerId": 1012,
"description": "Purchase Order for myCompany",
"orderDate": "02/10/2014",
"deliveryDate": "02/20/2014",
"contact": "John Doe",
"email": "John.Doe@example.com",
"phone": "01-2048096",
"totalPrice": 225,
"items": [
{
"itemNo": 1,
"description": "Product2, PartA",
"quantity": 10,
"unitPrice": 5,
"totalPrice": 50
},
{
"itemNo": 2,
"description": "Product2, PartB",
"quantity": 20,
"unitPrice": 20,
"totalPrice": 400
}
]
}