class_docstr: Shuffle plugin for the scheduler
  This coordinates the individual worker plugins to ensure correctness
  and collects heartbeat messages for the dashboard.
  See Also
  --------
  ShuffleWorkerPlugin
class_docstr_tok: ["Shuffle","plugin","for","the","scheduler","This","coordinates","the","individual","worker","plugins","to","ensure","correctness","and","collects","heartbeat","messages","for","the","dashboard",".","See","Also","--","--","--","--","ShuffleWorkerPlugin"]
code: def _clean_on_scheduler(
      self, id: ShuffleId, stimulus_id: str
  ) -> None:
      shuffle = self.active_shuffles.pop(id)
      logger.warning(
          "Shuffle %s deactivated due to stimulus '%s'", id, stimulus_id
      )
      if not shuffle._archived_by:
          shuffle._archived_by = stimulus_id
          self._archived_by_stimulus[stimulus_id].add(shuffle)
  
      with contextlib.suppress(KeyError):
          del self.heartbeats[id]
  
      barrier_task = self.scheduler.tasks[barrier_key(id)]
      for dt in barrier_task.dependents:
          self._unset_restriction(dt)
  
imports: from __future__ import annotations
  import contextlib
  import itertools
  import logging
  from collections import defaultdict
  from typing import TYPE_CHECKING, Any
  from dask.typing import Key
  from distributed.diagnostics.plugin import SchedulerPlugin
  from distributed.metrics import time
  from distributed.protocol.pickle import dumps
  from distributed.protocol.serialize import ToPickle
  from distributed.shuffle._core import SchedulerShuffleState, ShuffleId, ShuffleRunSpec, ShuffleSpec, barrier_key, id_from_key
  from distributed.shuffle._worker_plugin import ShuffleWorkerPlugin
  from distributed.utils import log_errors
label_desc: Use image node_id 18 for calling the ShuffleSchedulerPlugin obj's underlying member method code with example usage: obj._clean_on_scheduler(id, stimulus_id) without return types