aboutsummaryrefslogtreecommitdiffstats
path: root/orchestrator-restapi/src/main/java/com/yahoo/vespa
diff options
context:
space:
mode:
Diffstat (limited to 'orchestrator-restapi/src/main/java/com/yahoo/vespa')
-rw-r--r--orchestrator-restapi/src/main/java/com/yahoo/vespa/orchestrator/restapi/HostSuspensionApi.java8
1 files changed, 6 insertions, 2 deletions
diff --git a/orchestrator-restapi/src/main/java/com/yahoo/vespa/orchestrator/restapi/HostSuspensionApi.java b/orchestrator-restapi/src/main/java/com/yahoo/vespa/orchestrator/restapi/HostSuspensionApi.java
index 9535096af4f..603d6a1adac 100644
--- a/orchestrator-restapi/src/main/java/com/yahoo/vespa/orchestrator/restapi/HostSuspensionApi.java
+++ b/orchestrator-restapi/src/main/java/com/yahoo/vespa/orchestrator/restapi/HostSuspensionApi.java
@@ -22,9 +22,13 @@ public interface HostSuspensionApi {
String PATH_PREFIX = "/v1/suspensions/hosts";
/**
- * Ask for permission to temporarily suspend all services on a set of hosts (nodes).
+ * Ask for permission to temporarily suspend all services on a set of hosts.
*
- * See HostApi::suspend for semantics of suspending a node.
+ * See HostApi::suspend for semantics of suspending a host.
+ *
+ * On failure, it tries to resume ALL hosts. It needs to try to resume all hosts because any or all hosts
+ * may have been suspended in an earlier attempt. Ending with resumption of all hosts makes sure other
+ * batch-requests for suspension of hosts succeed.
*/
@PUT
@Path("/{hostname}")