Skip to content

Notifications

Notices EZGH Cloud sends about your organization's resources, and who gets them by email.

Updated View as Markdown

A notice is a message from EZGH Cloud about one of your organization’s resources: a Kubernetes version reaching end of support, a domain renewal that failed. Each notice is emailed to the organization’s contacts for its category and kept in the console’s inbox.

In the console, open Notifications. The Inbox tab lists notices, newest first; a notice’s page shows what it says, the resource it’s about and each email sent for it. The Settings tab holds the contacts and muted notice types. Notices and settings belong to the organization, not to a project.

Categories

Every notice type has one category:

Category For
Operations End of support, maintenance and other changes to your resources
Billing Payments and renewals
Security Abuse and security issues involving your resources

Contacts

Each category has up to 10 contact email addresses. Add them on the Settings tab, or with ezgh notifications settings set.

A new address is sent an email with a link to confirm it. The link works once, for 7 days. Until the address confirms, it gets no notices; the console shows it as Unconfirmed. Saving the settings again sends a new link to an unconfirmed address whose link expired. An address is sent at most one confirmation email per category a day.

Emails come from notifications@mail.ezghcloud.com.

When a category has no contacts

A category with no confirmed contacts sends its notices to the organization’s root user. Billing notices go to the billing contact in Billing > Billing details first, then to the root user.

When every contact’s email fails, the notice is sent to the root user once.

Notice types

Type Category Required Sent when
kubernetes.endOfSupport Operations Yes A cluster’s Kubernetes version reaches end of support
domains.renewalFailed Billing Yes A domain’s renewal failed

Muting notice types

Notice types are required or informational. Required types are always emailed and can’t be muted. You can mute an informational type on the Settings tab: its notices still appear in the inbox, and nobody is emailed.

Unsubscribing

Every email to a contact has an Unsubscribe link, which removes that address from that category’s contacts. Emails to the root user don’t.

Deliveries

A notice’s page lists each email:

Status Meaning
Pending Not sent yet, or being retried
Sent Accepted for delivery
Failed Not delivered after 24 hours of retries, or refused
Undeliverable The organization had nobody to send it to

Retention

Notices are kept for 13 months. Deleting a project deletes its notices; deleting the organization deletes all of them and the settings.

Permissions

Action Allows
notifications.notices.list Listing notices and notice types
notifications.notices.get Reading a notice and its deliveries
notifications.settings.get Reading contacts and muted types
notifications.settings.update Changing them

NotificationsFullAccess grants all four; NotificationsReadOnlyAccess grants the reads.

CLI

ezgh notifications list --category billing
ezgh notifications get ntc_3h5j7k9m1n2p
ezgh notifications settings get -o json > settings.json
ezgh notifications settings set -f settings.json

settings set replaces the whole document. If the settings changed after ezgh read them, nothing is saved. See ezgh notifications for every command.

API

Notifications is at https://notifications.ezghcloud.com. See the Notifications API reference.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close