class_docstr: A handle used to make requests to a deployment at runtime.
  
  This is primarily used to compose multiple deployments within a single application.
  It can also be used to make calls to the ingress deployment of an application (e.g.,
  for programmatic testing).
  
  Example:
  
  
  .. code-block:: python
  
      import ray
      from ray import serve
      from ray.serve.handle import DeploymentHandle, DeploymentResponse
  
      @serve.deployment
      class Downstream:
          def say_hi(self, message: str):
              return f"Hello {message}!"
              self._message = message
  
      @serve.deployment
      class Ingress:
          def __init__(self, handle: DeploymentHandle):
              self._downstream_handle = handle
  
          async def __call__(self, name: str) -> str:
              response = self._handle.say_hi.remote(name)
              return await response
  
      app = Ingress.bind(Downstream.bind())
      handle: DeploymentHandle = serve.run(app)
      response = handle.remote("world")
      assert response.result() == "Hello world!"
class_docstr_tok: ["A","handle","used","to","make","requests","to","a","deployment","at","runtime",".","This","is","primarily","used","to","compose","multiple","deployments","within","a","single","application",".","It","can","also","be","used","to","make","calls","to","the","ingress","deployment","of","an","application","(","e.g.",",","for","programmatic","testing",")",".","Example",":","..","code-block",":",":","python","import","ray","from","ray","import","serve","from","ray.serve.handle","import","DeploymentHandle",",","DeploymentResponse","@","serve.deployment","class","Downstream",":","def","say_hi","(","self",",","message",":","str",")",":","return","f","''","Hello","{","message","}","!","''","self._message","=","message","@","serve.deployment","class","Ingress",":","def","__init__","(","self",",","handle",":","DeploymentHandle",")",":","self._downstream_handle","=","handle","async","def","__call__","(","self",",","name",":","str",")","-",">","str",":","response","=","self._handle.say_hi.remote","(","name",")","return","await","response","app","=","Ingress.bind","(","Downstream.bind","(",")",")","handle",":","DeploymentHandle","=","serve.run","(","app",")","response","=","handle.remote","(","``","world","''",")","assert","response.result","(",")","==","``","Hello","world","!","''"]
docstr: Set options for this handle and return an updated copy of it.
  
  Example:
  
  .. code-block:: python
  
      response: DeploymentResponse = handle.options(
          method_name="other_method",
          multiplexed_model_id="model:v1",
      ).remote()
docstr_tok: ["Set","options","for","this","handle","and","return","an","updated","copy","of","it",".","Example",":","..","code-block",":",":","python","response",":","DeploymentResponse","=","handle.options","(","method_name=","''","other_method","''",",","multiplexed_model_id=","''","model",":","v1","''",",",")",".remote","(",")"]
code: def options(
      self,
      *,
      method_name: Union[str, DEFAULT] = DEFAULT.VALUE,
      multiplexed_model_id: Union[str, DEFAULT] = DEFAULT.VALUE,
      stream: Union[bool, DEFAULT] = DEFAULT.VALUE,
      use_new_handle_api: Union[bool, DEFAULT] = DEFAULT.VALUE,
      _prefer_local_routing: Union[bool, DEFAULT] = DEFAULT.VALUE,
      _router_cls: Union[str, DEFAULT] = DEFAULT.VALUE,
  ) -> "DeploymentHandle":
      """Set options for this handle and return an updated copy of it.
  
      Example:
  
      .. code-block:: python
  
          response: DeploymentResponse = handle.options(
              method_name="other_method",
              multiplexed_model_id="model:v1",
          ).remote()
      """
      return self._options(
          method_name=method_name,
          multiplexed_model_id=multiplexed_model_id,
          stream=stream,
          use_new_handle_api=use_new_handle_api,
          _prefer_local_routing=_prefer_local_routing,
          _router_cls=_router_cls,
      )
  
imports: import asyncio
  import concurrent.futures
  import threading
  import warnings
  from dataclasses import dataclass
  from typing import Any, AsyncIterator, Dict, Iterator, Optional, Tuple, Union
  import ray
  from ray import serve
  from ray._raylet import GcsClient, ObjectRefGenerator
  from ray.serve._private.common import DeploymentID, RequestProtocol
  from ray.serve._private.default_impl import create_cluster_node_info_cache
  from ray.serve._private.router import RequestMetadata, Router
  from ray.serve._private.usage import ServeUsageTag
  from ray.serve._private.utils import DEFAULT, get_current_actor_id, get_random_string, is_running_in_asyncio_loop
  from ray.util import metrics
  from ray.util.annotations import Deprecated, DeveloperAPI, PublicAPI
label_desc: Use image node_id 1 for calling the DeploymentHandle obj's underlying member method code with example usage: obj.options() and returns: self