Struct NotificationChannel

#[non_exhaustive]
pub struct NotificationChannel {
    pub type: String,
    pub name: String,
    pub display_name: String,
    pub description: String,
    pub labels: HashMap<String, String>,
    pub user_labels: HashMap<String, String>,
    pub verification_status: VerificationStatus,
    pub enabled: Option<BoolValue>,
    pub creation_record: Option<MutationRecord>,
    pub mutation_records: Vec<MutationRecord>,
}

A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval.

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.

type: String

The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field.

name: String

Identifier. The full REST resource name for this channel. The format is:

projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

The [CHANNEL_ID] is automatically assigned by the server on creation.

display_name: String

An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters.

description: String

An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters.

labels: HashMap<String, String>

Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field.

user_labels: HashMap<String, String>

User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor’s schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

verification_status: VerificationStatus

Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.

If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.

If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.

This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel.

enabled: Option<BoolValue>

Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future.

creation_record: Option<MutationRecord>

Record of the creation of this channel.

mutation_records: Vec<MutationRecord>

Records of the modification of this channel.

Implementations

impl NotificationChannel

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

Sets the value of r#type.

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

Sets the value of name.

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

Sets the value of display_name.

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

Sets the value of description.

pub fn set_verification_status<T: Into<VerificationStatus>>(self, v: T) -> Self

Sets the value of verification_status.

pub fn set_enabled<T: Into<Option<BoolValue>>>(self, v: T) -> Self

Sets the value of enabled.

pub fn set_creation_record<T: Into<Option<MutationRecord>>>(self, v: T) -> Self

Sets the value of creation_record.

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

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

Sets the value of mutation_records.

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.

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

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

Sets the value of user_labels.

Trait Implementations

impl Clone for NotificationChannel

fn clone(&self) -> NotificationChannel

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NotificationChannel

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

Formats the value using the given formatter.

impl Default for NotificationChannel

fn default() -> NotificationChannel

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NotificationChannel

where NotificationChannel: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Message for NotificationChannel

fn typename() -> &'static str

The typename of this message.

impl PartialEq for NotificationChannel

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

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 NotificationChannel