API

List maintenances

get
https://api.linode.com//account/maintenance

Returns maintenance information for any entity your user has permissions to view. If a maintenance object has been canceled, it's not returned.

📘

Currently, only Linodes are included as entities for viewing.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.
    • Permissions: list_maintenances

CLI

linode-cli account maintenance-list

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Responses

Response body
object
data
array of objects

Maintenance events for Linodes on this account.

data
object
date-time

Filterable The time the maintenance completed. This field is filterable based on these parameters:

  • A single ISO 8601 timestamp (yyyy-mm-ddThh:mm:ss), which returns only matches for that value.

  • Pairs of operator string keys (+or, +gt, +gte, +lt, +lte, or +neq) and single ISO 8601 timestamp. The +or operator accepts an array of values that can consist of single date-time strings or dictionaries of inequality operator pairs.

string
enum

Differentiates between scheduled and emergency maintenance.

Scheduled Maintenance Emergency Maintenance

entity
object

The entity affected by the maintenance.

string

Filterable The maintenance policy configured by the user.

date-time

Filterable The earliest time when the maintenance can start. This field is filterable based on these parameters:

  • A single ISO 8601 timestamp (yyyy-mm-ddThh:mm:ss), which returns only matches for that value.

  • Pairs of operator string keys (+or, +gt, +gte, +lt, +lte, or +neq) and single ISO 8601 timestamp. The +or operator accepts an array of values that can consist of single date-time strings or dictionaries of inequality operator pairs.

string

The reason maintenance is being performed.

string
enum

The origin of the maintenance. A platform source indicates that the maintenance was initiated by Akamai. A user source indicates that the maintenance was initiated by the user.

platform user

date-time

Filterable The time the maintenance started. This field is filterable based on these parameters:

  • A single ISO 8601 timestamp (yyyy-mm-ddThh:mm:ss), which returns only matches for that value.

  • Pairs of operator string keys (+or, +gt, +gte, +lt, +lte, or +neq) and single ISO 8601 timestamp. The +or operator accepts an array of values that can consist of single date-time strings or dictionaries of inequality operator pairs.

string
enum

Filterable The maintenance status. Maintenance progress follows the sequence pending, scheduled, started, and completed. A scheduled status is unique to Linodes that require a reboot for QEMU maintenance.

pending scheduled started in-progress completed canceled

string
enum

Filterable The type of maintenance.

reboot cold_migration live_migration migrate power_off_on

date-time

Filterable The start time for the maintenance. This field is filterable based on these parameters:

  • A single ISO 8601 timestamp (yyyy-mm-ddThh:mm:ss), which returns only matches for that value.

  • Pairs of operator string keys (+or, +gt, +gte, +lt, +lte, or +neq) and single ISO 8601 timestamp. The +or operator accepts an array of values that can consist of single date-time strings or dictionaries of inequality operator pairs.

integer

Read-only The current page.

integer

Read-only The total number of pages.

integer

Read-only The total number of results.

Language
Credentials

Updated 27 days ago

Did this page help you?
Original text
Rate this translation
Your feedback will be used to help improve Google Translate