Struct Operation 

#[non_exhaustive]
pub struct Operation {
    pub operation_id: String,
    pub operation_name: String,
    pub consumer_id: String,
    pub start_time: Option<Timestamp>,
    pub end_time: Option<Timestamp>,
    pub labels: HashMap<String, String>,
    pub metric_value_sets: Vec<MetricValueSet>,
    pub log_entries: Vec<LogEntry>,
    pub importance: Importance,
    pub extensions: Vec<Any>,
    /* private fields */
}

Represents information regarding an operation.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

operation_id: String

Identity of the operation. This must be unique within the scope of the service that generated the operation. If the service calls Check() and Report() on the same operation, the two calls should carry the same id.

UUID version 4 is recommended, though not required. In scenarios where an operation is computed from existing information and an idempotent id is desirable for deduplication purpose, UUID version 5 is recommended. See RFC 4122 for details.

operation_name: String

Fully qualified name of the operation. Reserved for future use.

consumer_id: String

Identity of the consumer who is using the service. This field should be filled in for the operations initiated by a consumer, but not for service-initiated operations that are not related to a specific consumer.

• This can be in one of the following formats:
  • project:PROJECT_ID,
  • project_number:PROJECT_NUMBER,
  • projects/PROJECT_ID or PROJECT_NUMBER,
  • folders/FOLDER_NUMBER,
  • organizations/ORGANIZATION_NUMBER,
  • api_key:API_KEY.

start_time: Option<Timestamp>

Required. Start time of the operation.

end_time: Option<Timestamp>

End time of the operation. Required when the operation is used in ServiceController.Report, but optional when the operation is used in ServiceController.Check.

labels: HashMap<String, String>

Labels describing the operation. Only the following labels are allowed:

• Labels describing monitored resources as defined in the service configuration.
• Default labels of metric values. When specified, labels defined in the metric value override these default.
• The following labels defined by Google Cloud Platform:
  • cloud.googleapis.com/location describing the location where the operation happened,
  • servicecontrol.googleapis.com/user_agent describing the user agent of the API request,
  • servicecontrol.googleapis.com/service_agent describing the service used to handle the API request (e.g. ESP),
  • servicecontrol.googleapis.com/platform describing the platform where the API is served, such as App Engine, Compute Engine, or Kubernetes Engine.

metric_value_sets: Vec<MetricValueSet>

Represents information about this operation. Each MetricValueSet corresponds to a metric defined in the service configuration. The data type used in the MetricValueSet must agree with the data type specified in the metric definition.

Within a single operation, it is not allowed to have more than one MetricValue instances that have the same metric names and identical label value combinations. If a request has such duplicated MetricValue instances, the entire request is rejected with an invalid argument error.

log_entries: Vec<LogEntry>

Represents information to be logged.

importance: Importance

DO NOT USE. This is an experimental field.

extensions: Vec<Any>

Unimplemented.

Implementations

impl Operation

pub fn new() -> Self

pub fn set_operation_id<T: Into<String>>(self, v: T) -> Self

Sets the value of operation_id.

pub fn set_operation_name<T: Into<String>>(self, v: T) -> Self

Sets the value of operation_name.

pub fn set_consumer_id<T: Into<String>>(self, v: T) -> Self

Sets the value of consumer_id.

pub fn set_start_time<T>(self, v: T) -> Self

where T: Into<Timestamp>,

Sets the value of start_time.

pub fn set_or_clear_start_time<T>(self, v: Option<T>) -> Self

where T: Into<Timestamp>,

Sets or clears the value of start_time.

pub fn set_end_time<T>(self, v: T) -> Self

where T: Into<Timestamp>,

Sets the value of end_time.

pub fn set_or_clear_end_time<T>(self, v: Option<T>) -> Self

where T: Into<Timestamp>,

Sets or clears the value of end_time.

pub fn set_labels<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Sets the value of labels.

pub fn set_metric_value_sets<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<MetricValueSet>,

Sets the value of metric_value_sets.

pub fn set_log_entries<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<LogEntry>,

Sets the value of log_entries.

pub fn set_importance<T: Into<Importance>>(self, v: T) -> Self

Sets the value of importance.

pub fn set_extensions<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Any>,

Sets the value of extensions.

Trait Implementations

impl Clone for Operation

fn clone(&self) -> Operation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Operation

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

Formats the value using the given formatter.

impl Default for Operation

fn default() -> Operation

Returns the “default value” for a type.

impl Message for Operation

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Operation

fn eq(&self, other: &Operation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Operation