Skip to main content

InstancePool

Struct InstancePool 

Source
pub struct InstancePool {
Show 24 fields pub subnets: Vec<ResourceRef>, pub vpc: InstancePoolVpc, pub autoscaling: Option<AutoscalingPolicy>, pub autoscaling_status: Option<AutoscalingStatus>, pub rollout_surge: Option<bool>, pub scale_in_protected_instances: Option<Vec<String>>, pub scale_in_blocked_reason: Option<String>, pub retiring_instances: Option<Vec<RetiringPoolMember>>, pub id: Option<String>, pub crn: Option<String>, pub name: Option<String>, pub description: Option<String>, pub desired_count: Option<i64>, pub min_count: Option<i64>, pub max_count: Option<i64>, pub live_count: Option<i64>, pub member_count: Option<i64>, pub refresh_in_progress: Option<bool>, pub stale_instance_count: Option<i64>, pub status: Option<InstancePoolStatus>, pub faults: Vec<Fault>, pub managed_by: Option<String>, pub tags: Option<Tags>, pub template: Option<InstancePoolTemplate>,
}

Fields§

§subnets: Vec<ResourceRef>

Eligible placement subnets in the same account, region and VPC.

§vpc: InstancePoolVpc§autoscaling: Option<AutoscalingPolicy>§autoscaling_status: Option<AutoscalingStatus>§rollout_surge: Option<bool>

Temporary rollout capacity; desired_count remains the steady target.

§scale_in_protected_instances: Option<Vec<String>>

Instance UUIDs protected from manual and automatic scale-in. Protection does not prevent refresh, failed-instance replacement, or explicit deletion.

§scale_in_blocked_reason: Option<String>

Why scale-in protection currently prevents the requested reduction. Omitted when not blocked.

§retiring_instances: Option<Vec<RetiringPoolMember>>§id: Option<String>§crn: Option<String>

Cloud Resource Name. This is the value an IAM policy statement must name to scope a permission to this pool alone; a policy written against anything else will not match.

§name: Option<String>

Resource names must not start with the literal crn: prefix or be UUIDs (canonical, compact, braced, or urn:uuid: forms, in either case).

§description: Option<String>§desired_count: Option<i64>§min_count: Option<i64>§max_count: Option<i64>

A value of 0 means the pool holds no members until max_count is raised.

§live_count: Option<i64>

How many members are UP — bound instances whose current_state is running.

§member_count: Option<i64>

How many instances the pool holds, running or not. This is what the reconciler converges toward desired_count and what status reflects, so member_count == desired_count with live_count below it means the pool has the members it was asked for and some of them are not up.

§refresh_in_progress: Option<bool>

True while a rolling replacement requested through POST /v1/instance-pools/{pool_id}/refresh is still running. It clears itself once every member is on the current template. The pool reads scaling for the duration, since it runs one instance over its target while a replacement comes up.

§stale_instance_count: Option<i64>

How many members were launched from a template other than the pool’s current one — that is, how many a refresh would replace. Non-zero after editing template and before refreshing, which is the signal that a template change has not been rolled out yet.

§status: Option<InstancePoolStatus>

Where the pool is against its target. active means member_count == desired_count — the pool holds the members it was asked for. It is not a claim that all of them are up; read live_count for that. scaling means it does not, and the reconciler is converging it: after a create, after a desired_count change, and for the length of an instance refresh, which runs the pool one instance over its target while a replacement comes up. error means an active error fault exists. Capacity failures remain eligible for reconciliation; failed deletion retains its teardown intent and never recreates members. deleting is teardown without an active error.

§faults: Vec<Fault>

Active faults, newest first. Empty for a healthy pool. Recovery resolves only the successful operation’s codes.

§managed_by: Option<String>§tags: Option<Tags>

Labels on the POOL itself, for IAM conditions (basalt:ResourceTag/<key>) and cost attribution. They are attached to nothing else: no instance the pool launches carries them. The tags a replica is launched with are template.tags. Unlike the other top-level fields beside this one, tags is not a projection of the launch template — it is the pool’s own set, and PATCHable on its own.

§template: Option<InstancePoolTemplate>

The pool’s launch config, in the shape instance create takes. The only place it appears: a flat copy of it beside this was two spellings of one thing, and two spellings drift.

Trait Implementations§

Source§

impl Clone for InstancePool

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for InstancePool

Source§

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

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

impl<'de> Deserialize<'de> for InstancePool

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for InstancePool

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. 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> 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> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

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: Sized + 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: Sized + 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 = !

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

fn try_from(value: U) -> Result<T, !>

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