pub struct ResultStoreDownloadClient<T> { /* private fields */ }
Expand description

This is the interface used to download information from the ResultStore database.

Clients are encourage to use ExportInvocation for most traffic.

Most APIs require setting a response FieldMask via the ‘fields’ URL query parameter or the X-Goog-FieldMask HTTP/gRPC header.

Implementations§

source§

impl<T> ResultStoreDownloadClient<T>
where T: GrpcService<BoxBody>, T::Error: Into<StdError>, T::ResponseBody: Body<Data = Bytes> + Send + 'static, <T::ResponseBody as Body>::Error: Into<StdError> + Send,

source

pub fn new(inner: T) -> Self

source

pub fn with_origin(inner: T, origin: Uri) -> Self

source

pub fn with_interceptor<F>( inner: T, interceptor: F ) -> ResultStoreDownloadClient<InterceptedService<T, F>>
where F: Interceptor, T::ResponseBody: Default, T: Service<Request<BoxBody>, Response = Response<<T as GrpcService<BoxBody>>::ResponseBody>>, <T as Service<Request<BoxBody>>>::Error: Into<StdError> + Send + Sync,

source

pub fn send_compressed(self, encoding: CompressionEncoding) -> Self

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

source

pub fn accept_compressed(self, encoding: CompressionEncoding) -> Self

Enable decompressing responses.

source

pub fn max_decoding_message_size(self, limit: usize) -> Self

Limits the maximum size of a decoded message.

Default: 4MB

source

pub fn max_encoding_message_size(self, limit: usize) -> Self

Limits the maximum size of an encoded message.

Default: usize::MAX

source

pub async fn export_invocation( &mut self, request: impl IntoRequest<ExportInvocationRequest> ) -> Result<Response<ExportInvocationResponse>, Status>

Exports the invocation with the given name and its child resources.

The order in which resources are returned is defined as follows, invocation; download_metadata; configurations; targets interleaving configured_targets and actions; file_sets.

  • Invocation
  • DownloadMetadata
  • Configurations
  • Targets └─ ConfiguredTargets └─Actions
  • FileSets

All child resources will be returned before the next parent resource is returned. For example, all actions under a configured_target will be returned before the next configured_target is returned. The order in which results within a given resource type are returned is undefined, but stable.

An error will be reported in the following cases:

  • If the invocation is not found.
  • If the given invocation name is badly formatted.
  • If no field mask was given.
source

pub async fn get_invocation( &mut self, request: impl IntoRequest<GetInvocationRequest> ) -> Result<Response<Invocation>, Status>

Retrieves the invocation with the given name.

An error will be reported in the following cases:

  • If the invocation is not found.
  • If the given invocation name is badly formatted.
  • If no field mask was given.
source

pub async fn search_invocations( &mut self, request: impl IntoRequest<SearchInvocationsRequest> ) -> Result<Response<SearchInvocationsResponse>, Status>

Searches for invocations matching the given query parameters. Results will be ordered by timing.start_time with most recent first, but total ordering of results is not guaranteed when difference in timestamps is very small. Results may be stale. Results may be omitted.

An error will be reported in the following cases:

  • If a query string is not provided
  • If no field mask was given.
source

pub async fn get_invocation_download_metadata( &mut self, request: impl IntoRequest<GetInvocationDownloadMetadataRequest> ) -> Result<Response<DownloadMetadata>, Status>

Retrieves the metadata for an invocation with the given name.

An error will be reported in the following cases:

  • If the invocation is not found.
  • If the given invocation name is badly formatted.
source

pub async fn get_configuration( &mut self, request: impl IntoRequest<GetConfigurationRequest> ) -> Result<Response<Configuration>, Status>

Retrieves the configuration with the given name.

An error will be reported in the following cases:

  • If the configuration or its parent invocation is not found.
  • If the given configuration name is badly formatted.
  • If no field mask was given.
source

pub async fn list_configurations( &mut self, request: impl IntoRequest<ListConfigurationsRequest> ) -> Result<Response<ListConfigurationsResponse>, Status>

Retrieves all configurations for a parent invocation. This might be limited by user or server, in which case a continuation token is provided. The order in which results are returned is undefined, but stable.

An error will be reported in the following cases:

  • If the parent invocation is not found.
  • If the given parent invocation name is badly formatted.
  • If no field mask was given.
source

pub async fn get_target( &mut self, request: impl IntoRequest<GetTargetRequest> ) -> Result<Response<Target>, Status>

Retrieves the target with the given name.

An error will be reported in the following cases:

  • If the target or its parent invocation is not found.
  • If the given target name is badly formatted.
  • If no field mask was given.
source

pub async fn list_targets( &mut self, request: impl IntoRequest<ListTargetsRequest> ) -> Result<Response<ListTargetsResponse>, Status>

Retrieves all targets for a parent invocation. This might be limited by user or server, in which case a continuation token is provided. The order in which results are returned is undefined, but stable.

An error will be reported in the following cases:

  • If the parent is not found.
  • If the given parent name is badly formatted.
  • If no field mask was given.
source

pub async fn get_configured_target( &mut self, request: impl IntoRequest<GetConfiguredTargetRequest> ) -> Result<Response<ConfiguredTarget>, Status>

Retrieves the configured target with the given name.

An error will be reported in the following cases:

  • If the configured target is not found.
  • If the given name is badly formatted.
  • If no field mask was given.
source

pub async fn list_configured_targets( &mut self, request: impl IntoRequest<ListConfiguredTargetsRequest> ) -> Result<Response<ListConfiguredTargetsResponse>, Status>

Retrieves all configured targets for a parent invocation/target. This might be limited by user or server, in which case a continuation token is provided. Supports ‘-’ for targetId meaning all targets. The order in which results are returned is undefined, but stable and consistent with ListTargets and ListConfigurations.

An error will be reported in the following cases:

  • If the parent is not found.
  • If the given parent name is badly formatted.
  • If no field mask was given.
source

pub async fn search_configured_targets( &mut self, request: impl IntoRequest<SearchConfiguredTargetsRequest> ) -> Result<Response<SearchConfiguredTargetsResponse>, Status>

Searches for ConfiguredTargets matching the given query parameters. Results will be ordered by timing.start_time with most recent first, but total ordering of results is not guaranteed when difference in timestamps is very small. Results may be stale. Results may be omitted.

Field masks are supported for only these fields and their subfields:

  • configured_targets.name
  • configured_targets.id
  • configured_targets.status_attributes
  • configured_targets.timing
  • next_page_token

An error will be reported in the following cases:

  • If a query string is not provided
  • If no field mask was given.
source

pub async fn get_action( &mut self, request: impl IntoRequest<GetActionRequest> ) -> Result<Response<Action>, Status>

Retrieves the action with the given name.

An error will be reported in the following cases:

  • If the action is not found.
  • If the given name is badly formatted.
  • If no field mask was given.
source

pub async fn list_actions( &mut self, request: impl IntoRequest<ListActionsRequest> ) -> Result<Response<ListActionsResponse>, Status>

Retrieves all actions for a parent invocation/target/configuration. This might be limited by user or server, in which case a continuation token is provided. Supports ‘-’ for configurationId to mean all actions for all configurations for a target, or ‘-’ for targetId and configurationId to mean all actions for all configurations and all targets. Does not support targetId ‘-’ with a specified configuration. The order in which results are returned is undefined, but stable and consistent with ListConfiguredTargets.

An error will be reported in the following cases:

  • If the parent is not found.
  • If the given parent name is badly formatted.
  • If no field mask was given.
source

pub async fn batch_list_actions( &mut self, request: impl IntoRequest<BatchListActionsRequest> ) -> Result<Response<BatchListActionsResponse>, Status>

Retrieves a list of actions for a parent invocation or multiple parents target/configuration. This might be limited by user or server, in which case a continuation token is provided. The order in which results are returned is undefined, but stable and consistent with ListConfiguredTargets.

An error will be reported in the following cases:

  • If the given parent name is badly formatted.
  • If no field mask was given.
source

pub async fn get_file_set( &mut self, request: impl IntoRequest<GetFileSetRequest> ) -> Result<Response<FileSet>, Status>

Retrieves the file set with the given name.

An error will be reported in the following cases:

  • If the file set or its parent invocation is not found.
  • If the given file set name is badly formatted.
  • If no field mask was given.
source

pub async fn list_file_sets( &mut self, request: impl IntoRequest<ListFileSetsRequest> ) -> Result<Response<ListFileSetsResponse>, Status>

Retrieves all file sets for a parent invocation. This might be limited by user or server, in which case a continuation token is provided. The order in which results are returned is undefined, but stable.

An error will be reported in the following cases:

  • If the parent invocation is not found.
  • If the given parent invocation name is badly formatted.
  • If no field mask was given.
source

pub async fn traverse_file_sets( &mut self, request: impl IntoRequest<TraverseFileSetsRequest> ) -> Result<Response<TraverseFileSetsResponse>, Status>

Returns the transitive closure of FileSets. This might be limited by user or server, in which case a continuation token is provided. The order in which results are returned is undefined, and unstable.

An error will be reported in the following cases:

  • If page_token is too large to continue the calculation.
  • If the resource is not found.
  • If the given resource name is badly formatted.
  • If no field mask was given.

Trait Implementations§

source§

impl<T: Clone> Clone for ResultStoreDownloadClient<T>

source§

fn clone(&self) -> ResultStoreDownloadClient<T>

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<T: Debug> Debug for ResultStoreDownloadClient<T>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FromRef<T> for T
where T: Clone,

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoRequest<T> for T

source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more