Skip to main content

Constraint

Struct Constraint 

Source
#[non_exhaustive]
pub struct Constraint { pub name: String, pub display_name: String, pub description: String, pub constraint_default: ConstraintDefault, pub supports_dry_run: bool, pub equivalent_constraint: String, pub supports_simulation: bool, pub constraint_type: Option<ConstraintType>, /* private fields */ }
Expand description

A constraint describes a way to restrict resource’s configuration. For example, you could enforce a constraint that controls which Google Cloud services can be activated across an organization, or whether a Compute Engine instance can have serial port connections established. Constraints can be configured by the organization policy administrator to fit the needs of the organization by setting a policy that includes constraints at different locations in the organization’s resource hierarchy. Policies are inherited down the resource hierarchy from higher levels, but can also be overridden. For details about the inheritance rules, see Policy.

Constraints have a default behavior determined by the constraint_default field, which is the enforcement behavior that is used in the absence of a policy being defined or inherited for the resource in question.

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

Immutable. The resource name of the constraint. Must be in one of the following forms:

  • projects/{project_number}/constraints/{constraint_name}
  • folders/{folder_id}/constraints/{constraint_name}
  • organizations/{organization_id}/constraints/{constraint_name}

For example, “/projects/123/constraints/compute.disableSerialPortAccess”.

§display_name: String

The human readable name.

Mutable.

§description: String

Detailed description of what this constraint controls as well as how and where it is enforced.

Mutable.

§constraint_default: ConstraintDefault

The evaluation behavior of this constraint in the absence of a policy.

§supports_dry_run: bool

Shows if dry run is supported for this constraint or not.

§equivalent_constraint: String

Managed constraint and canned constraint sometimes can have equivalents. This field is used to store the equivalent constraint name.

§supports_simulation: bool

Shows if simulation is supported for this constraint or not.

§constraint_type: Option<ConstraintType>

The type of restrictions for this Constraint.

Immutable after creation.

Implementations§

Source§

impl Constraint

Source

pub fn new() -> Self

Creates a new default instance.

Source

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

Sets the value of name.

§Example
let x = Constraint::new().set_name(format!("projects/{project_id}/constraints/{constraint_id}"));
Source

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

Sets the value of display_name.

§Example
let x = Constraint::new().set_display_name("example");
Source

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

Sets the value of description.

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

pub fn set_constraint_default<T: Into<ConstraintDefault>>(self, v: T) -> Self

Sets the value of constraint_default.

§Example
use google_cloud_orgpolicy_v2::model::constraint::ConstraintDefault;
let x0 = Constraint::new().set_constraint_default(ConstraintDefault::Allow);
let x1 = Constraint::new().set_constraint_default(ConstraintDefault::Deny);
Source

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

Sets the value of supports_dry_run.

§Example
let x = Constraint::new().set_supports_dry_run(true);
Source

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

Sets the value of equivalent_constraint.

§Example
let x = Constraint::new().set_equivalent_constraint("example");
Source

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

Sets the value of supports_simulation.

§Example
let x = Constraint::new().set_supports_simulation(true);
Source

pub fn set_constraint_type<T: Into<Option<ConstraintType>>>(self, v: T) -> Self

Sets the value of constraint_type.

Note that all the setters affecting constraint_type are mutually exclusive.

§Example
use google_cloud_orgpolicy_v2::model::constraint::ListConstraint;
let x = Constraint::new().set_constraint_type(Some(
    google_cloud_orgpolicy_v2::model::constraint::ConstraintType::ListConstraint(ListConstraint::default().into())));
Source

pub fn list_constraint(&self) -> Option<&Box<ListConstraint>>

The value of constraint_type if it holds a ListConstraint, None if the field is not set or holds a different branch.

Source

pub fn set_list_constraint<T: Into<Box<ListConstraint>>>(self, v: T) -> Self

Sets the value of constraint_type to hold a ListConstraint.

Note that all the setters affecting constraint_type are mutually exclusive.

§Example
use google_cloud_orgpolicy_v2::model::constraint::ListConstraint;
let x = Constraint::new().set_list_constraint(ListConstraint::default()/* use setters */);
assert!(x.list_constraint().is_some());
assert!(x.boolean_constraint().is_none());
Source

pub fn boolean_constraint(&self) -> Option<&Box<BooleanConstraint>>

The value of constraint_type if it holds a BooleanConstraint, None if the field is not set or holds a different branch.

Source

pub fn set_boolean_constraint<T: Into<Box<BooleanConstraint>>>( self, v: T, ) -> Self

Sets the value of constraint_type to hold a BooleanConstraint.

Note that all the setters affecting constraint_type are mutually exclusive.

§Example
use google_cloud_orgpolicy_v2::model::constraint::BooleanConstraint;
let x = Constraint::new().set_boolean_constraint(BooleanConstraint::default()/* use setters */);
assert!(x.boolean_constraint().is_some());
assert!(x.list_constraint().is_none());

Trait Implementations§

Source§

impl Clone for Constraint

Source§

fn clone(&self) -> Constraint

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 Constraint

Source§

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

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

impl Default for Constraint

Source§

fn default() -> Constraint

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

impl Message for Constraint

Source§

fn typename() -> &'static str

The typename of this message.
Source§

impl PartialEq for Constraint

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · 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 Constraint

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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

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> FutureExt for T

Source§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
Source§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
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> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
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