def update_quantum_job(
        self,
        request: engine.UpdateQuantumJobRequest | dict | None = None,
        *,
        retry: OptionalRetry = gapic_v1.method.DEFAULT,
        timeout: float | None = None,
        metadata: Sequence[tuple[str, str]] = (),
    ) -> quantum.QuantumJob:
        r"""-

        .. code-block:: python

            from google.cloud import quantum_v1alpha1

            def sample_update_quantum_job():
                # Create a client
                client = quantum_v1alpha1.QuantumEngineServiceClient()

                # Initialize request argument(s)
                request = quantum_v1alpha1.UpdateQuantumJobRequest(
                )

                # Make the request
                response = client.update_quantum_job(request=request)

                # Handle the response
                print(response)

        Args:
            request (google.cloud.quantum_v1alpha1.types.UpdateQuantumJobRequest | dict):
                The request object. -
            retry (google.api_core.retry.Retry): Designation of what errors, if any,
                should be retried.
            timeout (float): The timeout for this request.
            metadata (Sequence[tuple[str, str]]): Strings which should be
                sent along with the request as metadata.

        Returns:
            google.cloud.quantum_v1alpha1.types.QuantumJob:
                -
        """
        # Create or coerce a protobuf request object.
        # Minor optimization to avoid making a copy if the user passes
        # in a engine.UpdateQuantumJobRequest.
        # There's no risk of modifying the input as we've already verified
        # there are no flattened fields.
        if not isinstance(request, engine.UpdateQuantumJobRequest):
            request = engine.UpdateQuantumJobRequest(request)

        # Wrap the RPC method; this adds retry and timeout information,
        # and friendly error handling.
        rpc = self._transport._wrapped_methods[self._transport.update_quantum_job]

        # Certain fields should be provided within the metadata header;
        # add these here.
        metadata = tuple(metadata) + (
            gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
        )

        # Send the request.
        response = rpc(request, retry=retry, timeout=timeout, metadata=metadata)

        # Done; return the response.
        return response
-

        .. code-block:: python

            from google.cloud import quantum_v1alpha1

            def sample_update_quantum_job():
                # Create a client
                client = quantum_v1alpha1.QuantumEngineServiceClient()

                # Initialize request argument(s)
                request = quantum_v1alpha1.UpdateQuantumJobRequest(
                )

                # Make the request
                response = client.update_quantum_job(request=request)

                # Handle the response
                print(response)

        Args:
            request (google.cloud.quantum_v1alpha1.types.UpdateQuantumJobRequest | dict):
                The request object. -
            retry (google.api_core.retry.Retry): Designation of what errors, if any,
                should be retried.
            timeout (float): The timeout for this request.
            metadata (Sequence[tuple[str, str]]): Strings which should be
                sent along with the request as metadata.

        Returns:
            google.cloud.quantum_v1alpha1.types.QuantumJob:
                -
        
cirq-google/cirq_google/cloud/quantum_v1alpha1/services/quantum_engine_service/client.py