ray.put

ray.put(value: R, *, _owner: ActorHandle | None = None, _tensor_transport: str | None = None) → ray._raylet.ObjectRef.~R

Store an object in the object store.

The object may not be evicted while a reference to the returned ID exists.

Related patterns and anti-patterns:

• Anti-pattern: Returning ray.put() ObjectRefs from a task harms performance and fault tolerance

• Anti-pattern: Passing the same large argument by value repeatedly harms performance

• Anti-pattern: Closure capturing large objects harms performance

Parameters:

• value – The Python object to be stored.

• _owner – This experimental argument has been removed in Ray 2.56.

• _tensor_transport – [Alpha] The tensor transport to use for the GPU object. Currently, this only supports one-sided tensor transports such as “nixl”. When this is None (default), Ray will use the object store.

Returns:

The object ref assigned to this value.