ray.util.tpu.SlicePlacementGroup.release_head_pgs

SlicePlacementGroup.release_head_pgs() → None

Remove all internal head placement groups.

The head PGs exist only to atomically claim a TPU slice’s label during the race window between slice selection and worker-PG construction. Once the worker PG’s bundles are scheduled, the worker PG holds the TPU resources on every host in the slice and the head PGs are redundant.

Callers should invoke this idempotent call after self.placement_group.ready() resolves successfully.

DeveloperAPI: This API may change across minor Ray releases.