Skip to main content

Instance

Struct Instance 

Source
#[non_exhaustive]
pub struct Instance {
Show 37 fields pub name: String, pub description: String, pub uid: String, pub generation: i64, pub labels: HashMap<String, String>, pub annotations: HashMap<String, String>, pub create_time: Option<Timestamp>, pub update_time: Option<Timestamp>, pub delete_time: Option<Timestamp>, pub expire_time: Option<Timestamp>, pub creator: String, pub last_modifier: String, pub client: String, pub client_version: String, pub launch_stage: LaunchStage, pub binary_authorization: Option<BinaryAuthorization>, pub vpc_access: Option<VpcAccess>, pub service_account: String, pub containers: Vec<Container>, pub volumes: Vec<Volume>, pub encryption_key: String, pub encryption_key_revocation_action: EncryptionKeyRevocationAction, pub encryption_key_shutdown_duration: Option<Duration>, pub node_selector: Option<NodeSelector>, pub gpu_zonal_redundancy_disabled: Option<bool>, pub ingress: IngressTraffic, pub invoker_iam_disabled: bool, pub iap_enabled: bool, pub observed_generation: i64, pub log_uri: String, pub terminal_condition: Option<Condition>, pub conditions: Vec<Condition>, pub container_statuses: Vec<ContainerStatus>, pub satisfies_pzs: bool, pub urls: Vec<String>, pub reconciling: bool, pub etag: String, /* private fields */
}
Expand description

A Cloud Run Instance represents a single group of containers running in a region.

Fields (Non-exhaustive)§

This struct is marked as 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.
§name: String

The fully qualified name of this Instance. In CreateInstanceRequest, this field is ignored, and instead composed from CreateInstanceRequest.parent and CreateInstanceRequest.instance_id.

Format: projects/{project}/locations/{location}/instances/{instance_id}

§description: String

User-provided description of the Instance. This field currently has a 512-character limit.

§uid: String

Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

§generation: i64

Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a string instead of an integer.

§labels: HashMap<String, String>§annotations: HashMap<String, String>§create_time: Option<Timestamp>

Output only. The creation time.

§update_time: Option<Timestamp>

Output only. The last-modified time.

§delete_time: Option<Timestamp>

Output only. The deletion time.

§expire_time: Option<Timestamp>

Output only. For a deleted resource, the time after which it will be permamently deleted.

§creator: String

Output only. Email address of the authenticated creator.

§last_modifier: String

Output only. Email address of the last authenticated modifier.

§client: String

Arbitrary identifier for the API client.

§client_version: String

Arbitrary version identifier for the API client.

§launch_stage: LaunchStage

The launch stage as defined by Google Cloud Platform Launch Stages. Cloud Run supports ALPHA, BETA, and GA. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features.

§binary_authorization: Option<BinaryAuthorization>

Settings for the Binary Authorization feature.

§vpc_access: Option<VpcAccess>

Optional. VPC Access configuration to use for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc.

§service_account: String§containers: Vec<Container>

Required. Holds the single container that defines the unit of execution for this Instance.

§volumes: Vec<Volume>

A list of Volumes to make available to containers.

§encryption_key: String

A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek

§encryption_key_revocation_action: EncryptionKeyRevocationAction

The action to take if the encryption key is revoked.

§encryption_key_shutdown_duration: Option<Duration>

If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.

§node_selector: Option<NodeSelector>

Optional. The node selector for the instance.

§gpu_zonal_redundancy_disabled: Option<bool>

Optional. True if GPU zonal redundancy is disabled on this instance.

§ingress: IngressTraffic

Optional. Provides the ingress settings for this Instance. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active.

§invoker_iam_disabled: bool

Optional. Disables IAM permission check for run.routes.invoke for callers of this Instance. For more information, visit https://cloud.google.com/run/docs/securing/managing-access#invoker_check.

§iap_enabled: bool

Optional. IAP settings on the Instance.

§observed_generation: i64

Output only. The generation of this Instance currently serving traffic. See comments in reconciling for additional information on reconciliation process in Cloud Run. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a string instead of an integer.

§log_uri: String

Output only. The Google Console URI to obtain logs for the Instance.

§terminal_condition: Option<Condition>

Output only. The Condition of this Instance, containing its readiness status, and detailed error information in case it did not reach a serving state. See comments in reconciling for additional information on reconciliation process in Cloud Run.

§conditions: Vec<Condition>

Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics information in case the Instance does not reach its Serving state. See comments in reconciling for additional information on reconciliation process in Cloud Run.

§container_statuses: Vec<ContainerStatus>

Output only. Status information for each of the specified containers. The status includes the resolved digest for specified images.

§satisfies_pzs: bool

Output only. Reserved for future use.

§urls: Vec<String>

Output only. All URLs serving traffic for this Instance.

§reconciling: bool

Output only. Returns true if the Instance is currently being acted upon by the system to bring it into the desired state.

When a new Instance is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Instance to the desired serving state. This process is called reconciliation. While reconciliation is in process, observed_generation will have a transient value that might mismatch the intended state. Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the Instance, or there was an error, and reconciliation failed. This state can be found in terminal_condition.state.

§etag: String

Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.

Implementations§

Source§

impl Instance

Source

pub fn new() -> Self

Source

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

Sets the value of name.

§Example
let x = Instance::new().set_name("example");
Source

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

Sets the value of description.

§Example
let x = Instance::new().set_description("example");
Source

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

Sets the value of uid.

§Example
let x = Instance::new().set_uid("example");
Source

pub fn set_generation<T: Into<i64>>(self, v: T) -> Self

Sets the value of generation.

§Example
let x = Instance::new().set_generation(42);
Source

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.

§Example
let x = Instance::new().set_labels([
    ("key0", "abc"),
    ("key1", "xyz"),
]);
Source

pub fn set_annotations<T, K, V>(self, v: T) -> Self
where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Sets the value of annotations.

§Example
let x = Instance::new().set_annotations([
    ("key0", "abc"),
    ("key1", "xyz"),
]);
Source

pub fn set_create_time<T>(self, v: T) -> Self
where T: Into<Timestamp>,

Sets the value of create_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_create_time(Timestamp::default()/* use setters */);
Source

pub fn set_or_clear_create_time<T>(self, v: Option<T>) -> Self
where T: Into<Timestamp>,

Sets or clears the value of create_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
let x = Instance::new().set_or_clear_create_time(None::<Timestamp>);
Source

pub fn set_update_time<T>(self, v: T) -> Self
where T: Into<Timestamp>,

Sets the value of update_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_update_time(Timestamp::default()/* use setters */);
Source

pub fn set_or_clear_update_time<T>(self, v: Option<T>) -> Self
where T: Into<Timestamp>,

Sets or clears the value of update_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
let x = Instance::new().set_or_clear_update_time(None::<Timestamp>);
Source

pub fn set_delete_time<T>(self, v: T) -> Self
where T: Into<Timestamp>,

Sets the value of delete_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_delete_time(Timestamp::default()/* use setters */);
Source

pub fn set_or_clear_delete_time<T>(self, v: Option<T>) -> Self
where T: Into<Timestamp>,

Sets or clears the value of delete_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_or_clear_delete_time(Some(Timestamp::default()/* use setters */));
let x = Instance::new().set_or_clear_delete_time(None::<Timestamp>);
Source

pub fn set_expire_time<T>(self, v: T) -> Self
where T: Into<Timestamp>,

Sets the value of expire_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_expire_time(Timestamp::default()/* use setters */);
Source

pub fn set_or_clear_expire_time<T>(self, v: Option<T>) -> Self
where T: Into<Timestamp>,

Sets or clears the value of expire_time.

§Example
use wkt::Timestamp;
let x = Instance::new().set_or_clear_expire_time(Some(Timestamp::default()/* use setters */));
let x = Instance::new().set_or_clear_expire_time(None::<Timestamp>);
Source

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

Sets the value of creator.

§Example
let x = Instance::new().set_creator("example");
Source

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

Sets the value of last_modifier.

§Example
let x = Instance::new().set_last_modifier("example");
Source

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

Sets the value of client.

§Example
let x = Instance::new().set_client("example");
Source

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

Sets the value of client_version.

§Example
let x = Instance::new().set_client_version("example");
Source

pub fn set_launch_stage<T: Into<LaunchStage>>(self, v: T) -> Self

Sets the value of launch_stage.

§Example
use api::model::LaunchStage;
let x0 = Instance::new().set_launch_stage(LaunchStage::Unimplemented);
let x1 = Instance::new().set_launch_stage(LaunchStage::Prelaunch);
let x2 = Instance::new().set_launch_stage(LaunchStage::EarlyAccess);
Source

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

Sets the value of binary_authorization.

§Example
use google_cloud_run_v2::model::BinaryAuthorization;
let x = Instance::new().set_binary_authorization(BinaryAuthorization::default()/* use setters */);
Source

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

Sets or clears the value of binary_authorization.

§Example
use google_cloud_run_v2::model::BinaryAuthorization;
let x = Instance::new().set_or_clear_binary_authorization(Some(BinaryAuthorization::default()/* use setters */));
let x = Instance::new().set_or_clear_binary_authorization(None::<BinaryAuthorization>);
Source

pub fn set_vpc_access<T>(self, v: T) -> Self
where T: Into<VpcAccess>,

Sets the value of vpc_access.

§Example
use google_cloud_run_v2::model::VpcAccess;
let x = Instance::new().set_vpc_access(VpcAccess::default()/* use setters */);
Source

pub fn set_or_clear_vpc_access<T>(self, v: Option<T>) -> Self
where T: Into<VpcAccess>,

Sets or clears the value of vpc_access.

§Example
use google_cloud_run_v2::model::VpcAccess;
let x = Instance::new().set_or_clear_vpc_access(Some(VpcAccess::default()/* use setters */));
let x = Instance::new().set_or_clear_vpc_access(None::<VpcAccess>);
Source

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

Sets the value of service_account.

§Example
let x = Instance::new().set_service_account("example");
Source

pub fn set_containers<T, V>(self, v: T) -> Self
where T: IntoIterator<Item = V>, V: Into<Container>,

Sets the value of containers.

§Example
use google_cloud_run_v2::model::Container;
let x = Instance::new()
    .set_containers([
        Container::default()/* use setters */,
        Container::default()/* use (different) setters */,
    ]);
Source

pub fn set_volumes<T, V>(self, v: T) -> Self
where T: IntoIterator<Item = V>, V: Into<Volume>,

Sets the value of volumes.

§Example
use google_cloud_run_v2::model::Volume;
let x = Instance::new()
    .set_volumes([
        Volume::default()/* use setters */,
        Volume::default()/* use (different) setters */,
    ]);
Source

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

Sets the value of encryption_key.

§Example
let x = Instance::new().set_encryption_key("example");
Source

pub fn set_encryption_key_revocation_action<T: Into<EncryptionKeyRevocationAction>>( self, v: T, ) -> Self

Sets the value of encryption_key_revocation_action.

§Example
use google_cloud_run_v2::model::EncryptionKeyRevocationAction;
let x0 = Instance::new().set_encryption_key_revocation_action(EncryptionKeyRevocationAction::PreventNew);
let x1 = Instance::new().set_encryption_key_revocation_action(EncryptionKeyRevocationAction::Shutdown);
Source

pub fn set_encryption_key_shutdown_duration<T>(self, v: T) -> Self
where T: Into<Duration>,

Sets the value of encryption_key_shutdown_duration.

§Example
use wkt::Duration;
let x = Instance::new().set_encryption_key_shutdown_duration(Duration::default()/* use setters */);
Source

pub fn set_or_clear_encryption_key_shutdown_duration<T>( self, v: Option<T>, ) -> Self
where T: Into<Duration>,

Sets or clears the value of encryption_key_shutdown_duration.

§Example
use wkt::Duration;
let x = Instance::new().set_or_clear_encryption_key_shutdown_duration(Some(Duration::default()/* use setters */));
let x = Instance::new().set_or_clear_encryption_key_shutdown_duration(None::<Duration>);
Source

pub fn set_node_selector<T>(self, v: T) -> Self
where T: Into<NodeSelector>,

Sets the value of node_selector.

§Example
use google_cloud_run_v2::model::NodeSelector;
let x = Instance::new().set_node_selector(NodeSelector::default()/* use setters */);
Source

pub fn set_or_clear_node_selector<T>(self, v: Option<T>) -> Self
where T: Into<NodeSelector>,

Sets or clears the value of node_selector.

§Example
use google_cloud_run_v2::model::NodeSelector;
let x = Instance::new().set_or_clear_node_selector(Some(NodeSelector::default()/* use setters */));
let x = Instance::new().set_or_clear_node_selector(None::<NodeSelector>);
Source

pub fn set_gpu_zonal_redundancy_disabled<T>(self, v: T) -> Self
where T: Into<bool>,

Sets the value of gpu_zonal_redundancy_disabled.

§Example
let x = Instance::new().set_gpu_zonal_redundancy_disabled(true);
Source

pub fn set_or_clear_gpu_zonal_redundancy_disabled<T>(self, v: Option<T>) -> Self
where T: Into<bool>,

Sets or clears the value of gpu_zonal_redundancy_disabled.

§Example
let x = Instance::new().set_or_clear_gpu_zonal_redundancy_disabled(Some(false));
let x = Instance::new().set_or_clear_gpu_zonal_redundancy_disabled(None::<bool>);
Source

pub fn set_ingress<T: Into<IngressTraffic>>(self, v: T) -> Self

Sets the value of ingress.

§Example
use google_cloud_run_v2::model::IngressTraffic;
let x0 = Instance::new().set_ingress(IngressTraffic::All);
let x1 = Instance::new().set_ingress(IngressTraffic::InternalOnly);
let x2 = Instance::new().set_ingress(IngressTraffic::InternalLoadBalancer);
Source

pub fn set_invoker_iam_disabled<T: Into<bool>>(self, v: T) -> Self

Sets the value of invoker_iam_disabled.

§Example
let x = Instance::new().set_invoker_iam_disabled(true);
Source

pub fn set_iap_enabled<T: Into<bool>>(self, v: T) -> Self

Sets the value of iap_enabled.

§Example
let x = Instance::new().set_iap_enabled(true);
Source

pub fn set_observed_generation<T: Into<i64>>(self, v: T) -> Self

Sets the value of observed_generation.

§Example
let x = Instance::new().set_observed_generation(42);
Source

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

Sets the value of log_uri.

§Example
let x = Instance::new().set_log_uri("example");
Source

pub fn set_terminal_condition<T>(self, v: T) -> Self
where T: Into<Condition>,

Sets the value of terminal_condition.

§Example
use google_cloud_run_v2::model::Condition;
let x = Instance::new().set_terminal_condition(Condition::default()/* use setters */);
Source

pub fn set_or_clear_terminal_condition<T>(self, v: Option<T>) -> Self
where T: Into<Condition>,

Sets or clears the value of terminal_condition.

§Example
use google_cloud_run_v2::model::Condition;
let x = Instance::new().set_or_clear_terminal_condition(Some(Condition::default()/* use setters */));
let x = Instance::new().set_or_clear_terminal_condition(None::<Condition>);
Source

pub fn set_conditions<T, V>(self, v: T) -> Self
where T: IntoIterator<Item = V>, V: Into<Condition>,

Sets the value of conditions.

§Example
use google_cloud_run_v2::model::Condition;
let x = Instance::new()
    .set_conditions([
        Condition::default()/* use setters */,
        Condition::default()/* use (different) setters */,
    ]);
Source

pub fn set_container_statuses<T, V>(self, v: T) -> Self
where T: IntoIterator<Item = V>, V: Into<ContainerStatus>,

Sets the value of container_statuses.

§Example
use google_cloud_run_v2::model::ContainerStatus;
let x = Instance::new()
    .set_container_statuses([
        ContainerStatus::default()/* use setters */,
        ContainerStatus::default()/* use (different) setters */,
    ]);
Source

pub fn set_satisfies_pzs<T: Into<bool>>(self, v: T) -> Self

Sets the value of satisfies_pzs.

§Example
let x = Instance::new().set_satisfies_pzs(true);
Source

pub fn set_urls<T, V>(self, v: T) -> Self
where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of urls.

§Example
let x = Instance::new().set_urls(["a", "b", "c"]);
Source

pub fn set_reconciling<T: Into<bool>>(self, v: T) -> Self

Sets the value of reconciling.

§Example
let x = Instance::new().set_reconciling(true);
Source

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

Sets the value of etag.

§Example
let x = Instance::new().set_etag("example");

Trait Implementations§

Source§

impl Clone for Instance

Source§

fn clone(&self) -> Instance

Returns a duplicate 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 Debug for Instance

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Instance

Source§

fn default() -> Instance

Returns the “default value” for a type. Read more
Source§

impl Message for Instance

Source§

fn typename() -> &'static str

The typename of this message.
Source§

impl PartialEq for Instance

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl StructuralPartialEq for Instance

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

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> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

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

Source§

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>,

Source§

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>,

Source§

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.
Source§

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

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

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
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

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

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,