ray.get_actor

ray.get_actor(name: str, namespace: Optional[str] = None) → ray.actor.ActorHandle

Get a handle to a named actor.

Gets a handle to an actor with the given name. The actor must have been created with Actor.options(name=”name”).remote(). This works for both detached & non-detached actors.

This method is a sync call and it’ll timeout after 60s. This can be modified by setting OS env RAY_gcs_server_request_timeout_seconds before starting the cluster.

Parameters

• name – The name of the actor.

• namespace – The namespace of the actor, or None to specify the current namespace.

Returns

ActorHandle to the actor.

Raises

ValueError if the named actor does not exist. –

PublicAPI: This API is stable across Ray releases.