Struct NotificationChannelService

pub struct NotificationChannelService { /* private fields */ }

Implements a client for the Cloud Monitoring API.

Example

let client = NotificationChannelService::builder().build().await?;
// use `client` to make requests to the Cloud Monitoring API.

Service Description

The Notification Channel API provides access to configuration that controls how messages related to incidents are sent.

Configuration

To configure NotificationChannelService use the with_* methods in the type returned by builder(). The default configuration should work for most applications. Common configuration changes include

• with_endpoint(): by default this client uses the global default endpoint (https://monitoring.googleapis.com). Applications using regional endpoints or running in restricted networks (e.g. a network configured override this default.
• with_credentials(): by default this client uses Application Default Credentials. Applications using custom authentication may need to override this default.

Pooling and Cloning

NotificationChannelService holds a connection pool internally, it is advised to create one and the reuse it. You do not need to wrap NotificationChannelService in an Rc or Arc to reuse it, because it already uses an Arc internally.

Implementations

impl NotificationChannelService

pub fn builder() -> ClientBuilder

Returns a builder for NotificationChannelService.

let client = NotificationChannelService::builder().build().await?;

pub fn from_stub<T>(stub: T) -> Self

where T: NotificationChannelService + 'static,

Creates a new client from the provided stub.

The most common case for calling this function is in tests mocking the client’s behavior.

pub fn list_notification_channel_descriptors( &self, ) -> ListNotificationChannelDescriptors

Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.

pub fn get_notification_channel_descriptor( &self, ) -> GetNotificationChannelDescriptor

Gets a single channel descriptor. The descriptor indicates which fields are expected / permitted for a notification channel of the given type.

pub fn list_notification_channels(&self) -> ListNotificationChannels

Lists the notification channels that have been created for the project. To list the types of notification channels that are supported, use the ListNotificationChannelDescriptors method.

pub fn get_notification_channel(&self) -> GetNotificationChannel

Gets a single notification channel. The channel includes the relevant configuration details with which the channel was created. However, the response may truncate or omit passwords, API keys, or other private key matter and thus the response may not be 100% identical to the information that was supplied in the call to the create method.

pub fn create_notification_channel(&self) -> CreateNotificationChannel

Creates a new notification channel, representing a single notification endpoint such as an email address, SMS number, or PagerDuty service.

Design your application to single-thread API calls that modify the state of notification channels in a single project. This includes calls to CreateNotificationChannel, DeleteNotificationChannel and UpdateNotificationChannel.

pub fn update_notification_channel(&self) -> UpdateNotificationChannel

Updates a notification channel. Fields not specified in the field mask remain unchanged.

Design your application to single-thread API calls that modify the state of notification channels in a single project. This includes calls to CreateNotificationChannel, DeleteNotificationChannel and UpdateNotificationChannel.

pub fn delete_notification_channel(&self) -> DeleteNotificationChannel

Deletes a notification channel.

Design your application to single-thread API calls that modify the state of notification channels in a single project. This includes calls to CreateNotificationChannel, DeleteNotificationChannel and UpdateNotificationChannel.

pub fn send_notification_channel_verification_code( &self, ) -> SendNotificationChannelVerificationCode

Causes a verification code to be delivered to the channel. The code can then be supplied in VerifyNotificationChannel to verify the channel.

pub fn get_notification_channel_verification_code( &self, ) -> GetNotificationChannelVerificationCode

Requests a verification code for an already verified channel that can then be used in a call to VerifyNotificationChannel() on a different channel with an equivalent identity in the same or in a different project. This makes it possible to copy a channel between projects without requiring manual reverification of the channel. If the channel is not in the verified state, this method will fail (in other words, this may only be used if the SendNotificationChannelVerificationCode and VerifyNotificationChannel paths have already been used to put the given channel into the verified state).

There is no guarantee that the verification codes returned by this method will be of a similar structure or form as the ones that are delivered to the channel via SendNotificationChannelVerificationCode; while VerifyNotificationChannel() will recognize both the codes delivered via SendNotificationChannelVerificationCode() and returned from GetNotificationChannelVerificationCode(), it is typically the case that the verification codes delivered via SendNotificationChannelVerificationCode() will be shorter and also have a shorter expiration (e.g. codes such as “G-123456”) whereas GetVerificationCode() will typically return a much longer, websafe base 64 encoded string that has a longer expiration time.

pub fn verify_notification_channel(&self) -> VerifyNotificationChannel

Verifies a NotificationChannel by proving receipt of the code delivered to the channel as a result of calling SendNotificationChannelVerificationCode.

Trait Implementations

impl Clone for NotificationChannelService

fn clone(&self) -> NotificationChannelService

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NotificationChannelService

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

Formats the value using the given formatter.