Enum AllocationStrategy

#[non_exhaustive]
pub enum AllocationStrategy {
    Unspecified,
    Random,
    FirstAvailable,
    RandomFirstNAvailable,
    FirstSmallestFitting,
    UnknownValue(UnknownValue),
}

Enumeration of range auto-allocation strategies

Working with unknown values

This enum is defined as #[non_exhaustive] because Google Cloud may add additional enum variants at any time. Adding new variants is not considered a breaking change. Applications should write their code in anticipation of:

• New values appearing in future releases of the client library, and
• New values received dynamically, without application changes.

Please consult the Working with enums section in the user guide for some guidelines.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Unspecified

Unspecified is the only valid option when the range is specified explicitly by ip_cidr_range field. Otherwise unspefified means using the default strategy.

Random

Random strategy, the legacy algorithm, used for backwards compatibility. This allocation strategy remains efficient in the case of concurrent allocation requests in the same peered network space and doesn’t require providing the level of concurrency in an explicit parameter, but it is prone to fragmenting available address space.

FirstAvailable

Pick the first available address range. This strategy is deterministic and the result is easy to predict.

RandomFirstNAvailable

Pick an arbitrary range out of the first N available ones. The N will be set in the first_available_ranges_lookup_size field. This strategy should be used when concurrent allocation requests are made in the same space of peered networks while the fragmentation of the addrress space is reduced.

FirstSmallestFitting

Pick the smallest but fitting available range. This deterministic strategy minimizes fragmentation of the address space.

UnknownValue(UnknownValue)

If set, the enum was initialized with an unknown value.

Applications can examine the value using AllocationStrategy::value or AllocationStrategy::name.

Implementations

impl AllocationStrategy

pub fn value(&self) -> Option<i32>

Gets the enum value.

Returns None if the enum contains an unknown value deserialized from the string representation of enums.

pub fn name(&self) -> Option<&str>

Gets the enum value as a string.

Returns None if the enum contains an unknown value deserialized from the integer representation of enums.

Trait Implementations

impl Clone for AllocationStrategy

fn clone(&self) -> AllocationStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AllocationStrategy

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

Formats the value using the given formatter.

impl Default for AllocationStrategy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AllocationStrategy

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AllocationStrategy

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

Formats the value using the given formatter.

impl From<&str> for AllocationStrategy

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<i32> for AllocationStrategy

fn from(value: i32) -> Self

Converts to this type from the input type.

impl PartialEq for AllocationStrategy

fn eq(&self, other: &AllocationStrategy) -> 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 Serialize for AllocationStrategy

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AllocationStrategy