Current version of the spec defines epoch as:
Epoch: Description: The Discovery Endpoint's epoch value for this Service Entry. This specification does not mandate any particular semantic meaning to the value used. For example, implementations are free to use a value that represents a timestamp or could choose to simply use a monotonically increasing number. The only requirement is that the value MUST always increase each time the Service Entry is updated. This allows for a quick integer comparision to determine which version of this Service Entry is the latest - meaning, the one with the larger integer value.
For the purposes of this example, epoch starts at 1 and increases by one each time.
Proposal #1: POST=import, PUT=update/create
| Action | Incoming Epoch | DE's Epoch | Result / Today | Proposal #1 | Proposal #2 |
|---|---|---|---|---|---|
POST /services/ (ID in Body) |
missing | no resource | . | 1 (generated) | |
POST /services/ (ID in Body) |
2 | no resource | . | 2 (from incoming) | |
POST /services/ (ID in Body) |
missing | 1 | . | 1 (from incoming/create) | |
POST /services/ (no ID) |
missing | no resource | , | 1 (generated) | |
POST /services/ (no ID) |
2 | no resource | . | 2 (from incoming) | |
POST /services/ (ID in Body) |
2 | 2 | . | 2 (from incoming) | |
POST /services/ (ID in Body) |
3 | 1 | . | 3 (from incoming) | |
POST /services/ (ID in Body) |
1 | 2 | . | 1 (from incoming) | |
POST /services/ID (ID in Body) |
. | Error - ID not allowed in URL | |||
| - | |||||
PUT /services/ |
. | Error - missing ID in URL | |||
PUT /services/ID |
missing | no resource | . | 1 (generated) | |
PUT /services/ID |
2 | no resource | . | Error - epoch didn't match | |
PUT /services/ID |
missing | 1 | . | 2 (generated) | |
PUT /services/ID |
1 | 1 | . | 2 (generated) | |
PUT /services/ID |
3 | 1 | . | Error - epoch didn't match | |
PUT /services/ID |
1 | 2 | . | Error - epoch is old | |
| - | |||||
DELETE /services/ID |
missing | no resource | 200 - already gone | 200 | 200 |
DELETE /services/ID?epoch=1 |
1 | no resource | 200 - already gone | 200 | 200 |
DELETE /services/ID |
missing | 1 | delete | delete | delete |
DELETE /services/ID?epoch=1 |
1 | 1 | delete | delete | delete |
DELETE /services/ID?epoch=2 |
2 | 1 | Error - epoch didn't match | error | error |
DELETE /services |
. | . | Mixture of above based on epoch values |