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.jsonsettings 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.