[
https://issues.apache.org/jira/browse/MESOS-7211?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16551286#comment-16551286
]
ASF GitHub Bot commented on MESOS-7211:
---------------------------------------
Github user vinodkone commented on a diff in the pull request:
https://github.com/apache/mesos/pull/301#discussion_r204167169
--- Diff: docs/scheduler-http-api.md ---
@@ -479,6 +479,32 @@ HTTP/1.1 202 Accepted
```
+### SUPPRESS
+Sent by the scheduler when it doesn't need offers for a given set of its
roles. When Mesos master receives this request, it will stop sending offers for
the given set of roles to the framework. As a special case, if roles are not
specified, all subscribed roles of this framework are suppressed.
+
+Note that master continues to send offers to other subscribed roles of
this framework that are not suppressed. Also, status updates about tasks,
executors and agents are not affected by this call and tasks will continue
running for `FrameworkInfo.failover_timeout`.
+
+If the scheduler wishes to receive offers for the suppressed roles again
(e.g., it needs to schedule new workloads), it can send `REVIVE` call.
+
+```
+SUPPRESS Request (JSON):
+POST /api/v1/scheduler HTTP/1.1
+
+Host: masterhost:5050
+Content-Type: application/json
+Mesos-Stream-Id: 130ae4e3-6b13-4ef4-baa9-9f2e85c3e9af
+
+{
+ "framework_id" : {"value" : "12220-3440-12532-2345"},
+ "type" : "SUPPRESS",
+ "suppress" : {"role": <one-of-the-subscribed-roles>}
--- End diff --
This should be `roles` and not `role` since Mesos at least 1.3.0! And
`roles` takes an array of strings (i.e., roles) and not a single role.
> Document SUPPRESS HTTP call
> ---------------------------
>
> Key: MESOS-7211
> URL: https://issues.apache.org/jira/browse/MESOS-7211
> Project: Mesos
> Issue Type: Documentation
> Components: documentation
> Affects Versions: 1.1.0
> Reporter: Bruce Merry
> Priority: Minor
> Labels: mesosphere, newbie
>
> The documentation at
> http://mesos.apache.org/documentation/latest/scheduler-http-api/ doesn't list
> the SUPPRESS call as one of the call types, but it does seem to be
> implemented.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
