Neil Conway created MESOS-4421:
----------------------------------
Summary: Document that /reserve, /create-volumes endpoints can
return misleading "success"
Key: MESOS-4421
URL: https://issues.apache.org/jira/browse/MESOS-4421
Project: Mesos
Issue Type: Task
Components: documentation, master
Reporter: Neil Conway
The docs for the {{/reserve}} endpoint say:
{noformat}
200 OK: Success (the requested resources have been reserved).
{noformat}
This is not true: the master returns {{200}} when the request has been
validated and a {{CheckpointResourcesMessage}} has been sent to the agent, but
the master does not attempt to verify that the message has been received or
that the agent successfully checkpointed. Same behavior applies to
{{/unreserve}}, {{/create-volumes}}, and {{/destroy-volumes}}.
We should _either_:
1. Accurately document what {{200}} return code means.
2. Change the implementation to wait for the agent's next checkpoint to succeed
(and to include the effect of the operation) before returning success to the
HTTP client.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
