Struct googapis::google::devtools::resultstore::v2::CreateInvocationRequest [−][src]
pub struct CreateInvocationRequest {
pub request_id: String,
pub invocation_id: String,
pub invocation: Option<Invocation>,
pub authorization_token: String,
pub auto_finalize_time: Option<Timestamp>,
pub initial_resume_token: String,
pub uploader_state: Vec<u8>,
}
Expand description
Request passed into CreateInvocation
Fields
request_id: String
A unique identifier for this request. Must be set to a different value for each request that affects a given resource (eg. a random UUID). Required for the operation to be idempotent. This is achieved by ignoring this request if the last successful operation on the resource had the same request ID. If set, invocation_id must also be provided. Restricted to 36 Unicode characters.
invocation_id: String
The invocation ID. It is optional, but strongly recommended.
If left empty then a new unique ID will be assigned by the server. If populated, a RFC 4122-compliant v4 UUID is preferred, but v3 or v5 UUIDs are allowed too.
invocation: Option<Invocation>
Required. The invocation to create. Its name field will be ignored, since the name will be derived from the id field above and assigned by the server.
This is a token to authorize upload access to this invocation. It must be set to a RFC 4122-compliant v3, v4, or v5 UUID. Once this is set in CreateInvocation, all other upload RPCs for that Invocation and any of its child resources must also include the exact same token, or they will be rejected. The generated token should be unique to this invocation, and it should be kept secret.
The purpose of this field is to prevent other users and tools from clobbering your upload intentionally or accidentally. The standard way of using this token is to create a second v4 UUID when the invocation_id is created, and storing them together during the upload. Essentially, this is a “password” to the invocation.
auto_finalize_time: Option<Timestamp>
By default, Invocations are auto-finalized if they are not modified for 24 hours. If you need auto-finalize to happen sooner, set this field to the time you’d like auto-finalize to occur.
initial_resume_token: String
Client provided unique token for batch upload to ensure data integrity and to provide a way to resume batch upload in case of a distributed failure on the client side. The standard uploading client is presumed to have many machines uploading to ResultStore, and that any given machine could process any given Invocation at any time. This field is used to coordinate between the client’s machines, resolve concurrency issues, and enforce “exactly once” semantics on each batch within the upload.
The typical usage of the resume_token is that it should contain a “key” indicating to the client where it is in the upload process, so that the client can use it to resume the upload by reconstructing the state of upload from the point where it was interrupted.
If this matches the previously uploaded resume_token, then this request will silently do nothing, making CreateInvocation idempotent. If this token is provided, all further upload RPCs must be done through UploadBatch. This token must not be combined with request_id. Must be web safe Base64 encoded bytes.
uploader_state: Vec<u8>
Client-specific data used to resume batch upload if an error occurs and retry is needed. This serves a role closely related to resume_token, as both fields may be used to provide state required to restore a Batch Upload, but they differ in two important aspects:
- it is not compared to previous values, and as such does not provide concurrency control;
- it allows for a larger payload, since the contents are never inspected/compared; The size of the message must be within 1 MiB. Too large requests will be rejected.
Trait Implementations
fn merge_field<B>(
&mut self,
tag: u32,
wire_type: WireType,
buf: &mut B,
ctx: DecodeContext
) -> Result<(), DecodeError> where
B: Buf,
Returns the encoded length of the message without a length delimiter.
Encodes the message to a buffer. Read more
Encodes the message to a newly allocated buffer.
Encodes the message with a length-delimiter to a buffer. Read more
Encodes the message with a length-delimiter to a newly allocated buffer.
Decodes an instance of the message from a buffer. Read more
fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
Self: Default,
B: Buf,
fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
Self: Default,
B: Buf,
Decodes a length-delimited instance of the message from the buffer.
Decodes an instance of the message from a buffer, and merges it into self
. Read more
Decodes a length-delimited instance of the message from buffer, and
merges it into self
. Read more
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
Auto Trait Implementations
impl RefUnwindSafe for CreateInvocationRequest
impl Send for CreateInvocationRequest
impl Sync for CreateInvocationRequest
impl Unpin for CreateInvocationRequest
impl UnwindSafe for CreateInvocationRequest
Blanket Implementations
Mutably borrows from an owned value. Read more
Wrap the input message T
in a tonic::Request
pub fn vzip(self) -> V
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more