Revert "Revert "Revert "Enforce CC timeouts in Orchestrator 2"""

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}")