notifications
Creates, updates, deletes, gets or lists a notifications resource.
Overview
| Name | notifications |
| Type | Resource |
| Id | linode.account.notifications |
Fields
The following fields are returned by SELECT queries:
- list
Returns a paginated list of notification objects.
| Name | Datatype | Description |
|---|---|---|
body | string | A full description of this notification, in markdown format. Not all notifications include a body. Returned as null for an event type of security_reboot_maintenance_scheduled. |
entity | object | Detailed information about the notification. Returned as null for an event type of security_reboot_maintenance_scheduled. |
label | string | A short description of this notification. (example: You have an important ticket open!) |
message | string | A human-readable description of the notification. (example: You have an important ticket open!) |
severity | string | The severity of this notification. This field determines how prominently the notification is displayed and the color of the display text. (minor, major, critical) (example: major) |
type | string | Filterable The type of notification. > 📘 > > A security_reboot_maintenance_scheduled event is a global notice that a Linode needs to be rebooted for QEMU upgrade maintenance. Have a look at this workflow for guidance on reboooting your Linodes for this maintenance. (migration_scheduled, migration_imminent, migration_pending, reboot_scheduled, outage, payment_due, ticket_important, ticket_abuse, notice, maintenance, maintenance_scheduled, promotion, security_reboot_maintenance_scheduled, tax_id_verifying) (example: ticket_important) |
until | string (date-time) | If this notification has a duration, this is when the event or action will complete. For example, if there's scheduled maintenance for one of our systems, until represents the end of the maintenance window. Returned as null for an event type of security_reboot_maintenance_scheduled. |
when | string (date-time) | If this notification is for an event in the future, this specifies when the action occurs. For example, if a compute instance needs to migrate in response to a security advisory, this field sets the approximate time the compute instance will be taken offline for migration. Returned as null for an event type of security_reboot_maintenance_scheduled. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | Returns notifications that represent important, often time-sensitive details about your account. You can't interact directly with notifications, and a notification disappears when you've resolved its cause. For example, if you have an important ticket open, you can respond to that ticket to dismiss its notification. Learn more... Learn more... |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|
SELECT examples
- list
Returns notifications that represent important, often time-sensitive details about your account. You can't interact directly with notifications, and a notification disappears when you've resolved its cause. For example, if you have an important ticket open, you can respond to that ticket to dismiss its notification.
Learn more...
Learn more...
SELECT
body,
entity,
label,
message,
severity,
type,
until,
when
FROM linode.account.notifications
;