[−][src]Struct google_remotebuildexecution2::ActionMethods
A builder providing access to all methods supported on action resources.
It is not used directly, but through the RemoteBuildExecution
hub.
Example
Instantiate a resource builder
extern crate hyper; extern crate hyper_rustls; extern crate yup_oauth2 as oauth2; extern crate google_remotebuildexecution2 as remotebuildexecution2; use std::default::Default; use oauth2::{Authenticator, DefaultAuthenticatorDelegate, ApplicationSecret, MemoryStorage}; use remotebuildexecution2::RemoteBuildExecution; let secret: ApplicationSecret = Default::default(); let auth = Authenticator::new(&secret, DefaultAuthenticatorDelegate, hyper::Client::with_connector(hyper::net::HttpsConnector::new(hyper_rustls::TlsClient::new())), <MemoryStorage as Default>::default(), None); let mut hub = RemoteBuildExecution::new(hyper::Client::with_connector(hyper::net::HttpsConnector::new(hyper_rustls::TlsClient::new())), auth); // Usually you wouldn't bind this to a variable, but keep calling *CallBuilders* // like `execute(...)` // to build up your call. let rb = hub.actions();
Methods
impl<'a, C, A> ActionMethods<'a, C, A>
[src]
pub fn execute(
&self,
request: BuildBazelRemoteExecutionV2ExecuteRequest,
instance_name: &str
) -> ActionExecuteCall<'a, C, A>
[src]
&self,
request: BuildBazelRemoteExecutionV2ExecuteRequest,
instance_name: &str
) -> ActionExecuteCall<'a, C, A>
Create a builder to help you perform the following task:
Execute an action remotely.
In order to execute an action, the client must first upload all of the
inputs, the
Command to run, and the
Action into the
ContentAddressableStorage.
It then calls Execute
with an action_digest
referring to them. The
server will run the action and eventually return the result.
The input Action
's fields MUST meet the various canonicalization
requirements specified in the documentation for their types so that it has
the same digest as other logically equivalent Action
s. The server MAY
enforce the requirements and return errors if a non-canonical input is
received. It MAY also proceed without verifying some or all of the
requirements, such as for performance reasons. If the server does not
verify the requirement, then it will treat the Action
as distinct from
another logically equivalent action if they hash differently.
Returns a stream of
google.longrunning.Operation messages
describing the resulting execution, with eventual response
ExecuteResponse. The
metadata
on the operation is of type
ExecuteOperationMetadata.
If the client remains connected after the first response is returned after the server, then updates are streamed as if the client had called WaitExecution until the execution completes or the request reaches an error. The operation can also be queried using Operations API.
The server NEED NOT implement other methods or functionality of the Operations API.
Errors discovered during creation of the Operation
will be reported
as gRPC Status errors, while errors that occurred while running the
action will be reported in the status
field of the ExecuteResponse
. The
server MUST NOT set the error
field of the Operation
proto.
The possible errors include:
INVALID_ARGUMENT
: One or more arguments are invalid.FAILED_PRECONDITION
: One or more errors occurred in setting up the action requested, such as a missing input or command or no worker being available. The client may be able to fix the errors and retry.RESOURCE_EXHAUSTED
: There is insufficient quota of some resource to run the action.UNAVAILABLE
: Due to a transient condition, such as all workers being occupied (and the server does not support a queue), the action could not be started. The client should retry.INTERNAL
: An internal error occurred in the execution engine or the worker.DEADLINE_EXCEEDED
: The execution timed out.CANCELLED
: The operation was cancelled by the client. This status is only possible if the server implements the Operations API CancelOperation method, and it was called for the current execution.
In the case of a missing input or command, the server SHOULD additionally
send a PreconditionFailure error detail
where, for each requested blob not present in the CAS, there is a
Violation
with a type
of MISSING
and a subject
of
"blobs/{hash}/{size}"
indicating the digest of the missing blob.
Arguments
request
- No description provided.instanceName
- The instance of the execution system to operate against. A server may support multiple instances of the execution system (with their own workers, storage, caches, etc.). The server MAY require use of this field to select between them in an implementation-defined fashion, otherwise it can be omitted.
Trait Implementations
impl<'a, C, A> MethodsBuilder for ActionMethods<'a, C, A>
[src]
Auto Trait Implementations
impl<'a, C, A> !Send for ActionMethods<'a, C, A>
impl<'a, C, A> Unpin for ActionMethods<'a, C, A>
impl<'a, C, A> !Sync for ActionMethods<'a, C, A>
impl<'a, C, A> !UnwindSafe for ActionMethods<'a, C, A>
impl<'a, C, A> !RefUnwindSafe for ActionMethods<'a, C, A>
Blanket Implementations
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Typeable for T where
T: Any,
T: Any,