Struct Binding 

#[non_exhaustive]
pub struct Binding {
    pub role: String,
    pub members: Vec<String>,
    pub condition: Option<Expr>,
    /* private fields */
}

Associates members, or principals, with a role.

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.

role: String

Role that is assigned to the list of members, or principals. For example, roles/viewer, roles/editor, or roles/owner.

members: Vec<String>

Specifies the principals requesting access for a Google Cloud resource. members can have the following values:

• allUsers: A special identifier that represents anyone who is on the internet; with or without a Google account.

• allAuthenticatedUsers: A special identifier that represents anyone who is authenticated with a Google account or a service account.

• user:{emailid}: An email address that represents a specific Google account. For example, alice@example.com .

• serviceAccount:{emailid}: An email address that represents a service account. For example, my-other-app@appspot.gserviceaccount.com.

• group:{emailid}: An email address that represents a Google group. For example, admins@example.com.

• deleted:user:{emailid}?uid={uniqueid}: An email address (plus unique identifier) representing a user that has been recently deleted. For example, alice@example.com?uid=123456789012345678901. If the user is recovered, this value reverts to user:{emailid} and the recovered user retains the role in the binding.

• deleted:serviceAccount:{emailid}?uid={uniqueid}: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901. If the service account is undeleted, this value reverts to serviceAccount:{emailid} and the undeleted service account retains the role in the binding.

• deleted:group:{emailid}?uid={uniqueid}: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, admins@example.com?uid=123456789012345678901. If the group is recovered, this value reverts to group:{emailid} and the recovered group retains the role in the binding.

• domain:{domain}: The G Suite domain (primary) that represents all the users of that domain. For example, google.com or example.com.

condition: Option<Expr>

The condition that is associated with this binding.

If the condition evaluates to true, then this binding applies to the current request.

If the condition evaluates to false, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding.

To learn which resources support conditions in their IAM policies, see the IAM documentation.

Implementations

impl Binding

pub fn new() -> Self

Creates a new default instance.

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

Sets the value of role.

Example

let x = Binding::new().set_role("example");

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

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

Sets the value of members.

Example

let x = Binding::new().set_members(["a", "b", "c"]);

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

where T: Into<Expr>,

Sets the value of condition.

Example

use google_cloud_type::model::Expr;
let x = Binding::new().set_condition(Expr::default()/* use setters */);

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

where T: Into<Expr>,

Sets or clears the value of condition.

Example

use google_cloud_type::model::Expr;
let x = Binding::new().set_or_clear_condition(Some(Expr::default()/* use setters */));
let x = Binding::new().set_or_clear_condition(None::<Expr>);

Trait Implementations

impl Clone for Binding

fn clone(&self) -> Binding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Binding

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

Formats the value using the given formatter.

impl Default for Binding

fn default() -> Binding

Returns the “default value” for a type.

impl Message for Binding

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Binding

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Binding