Account
Events List
https://api.linode.com/v4/account/events
Returns a collection of Event objects representing actions taken on your Account from the last 90 days. The Events returned depend on your grants.
Query Parameters
The page of a collection to return.
The number of items to return per page.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/account/events
Response Samples
- 200
- default
{
"data": [
{
"id": "",
"action": "ticket_create",
"created": "2018-01-01T00:01:01",
"duration": 300.56,
"entity": {
"id": 11111,
"label": "Problem booting my Linode",
"type": "ticket",
"url": "/v4/support/tickets/11111"
},
"secondary_entity": {
"id": "linode/debian9",
"label": "linode1234",
"type": "linode",
"url": "/v4/linode/instances/1234"
},
"percent_complete": "",
"rate": "",
"read": true,
"seen": true,
"status": "",
"time_remaining": "",
"username": "exampleUser",
"message": "None"
}
],
"page": 1,
"pages": 1,
"results": 1
}
Responses
200: Returns a paginated lists of Event objects from the last 90 days.
The unique ID of this Event.
The action that caused this Event. New actions may be added in the future.
When this Event was created.
The total duration in seconds that it takes for the Event to complete.
Detailed information about the Event's entity, including ID, type, label, and URL used to access it.
The unique ID for an Event's entity.
Some Event entities do not have IDs associated with them, so they will not be returned when filtering by ID. These Events include:
account
profile
Entities for some Events are assigned the ID of the Linode they correspond to. When filtering by ID for these Events, use the corresponding Linode's ID. These Events include:
disks
backups
Tag Events use a tag's name for the entity ID field. When filtering by ID for tag Events, supply the name of the tag.
The current label of this object. The label may reflect changes that occur with this Event.
The type of entity that is being referenced by the Event.
The URL where you can access the object this Event is for. If a relative URL, it is relative to the domain you retrieved the Event from.
Detailed information about the Event's secondary entity, which provides additional information
for events such as, but not limited to, linode_boot
, linode_reboot
, linode_create
, and linode_clone
Event actions.
The ID of the object that is the secondary entity.
The label of this object.
The type of entity that is being referenced by the Event.
The URL where you can access the object this Event is for. If a relative URL, it is relative to the domain you retrieved the Event from.
A percentage estimating the amount of time remaining for an Event.
Returns null
for notification events.
The rate of completion of the Event. Only some Events will return rate; for example, migration and resize Events.
If this Event has been read.
If this Event has been seen.
The current status of this Event.
The estimated time remaining until the completion of this Event. This value is only returned for some in-progress migration events. For all other in-progress events, the percent_complete
attribute will indicate about how much more work is to be done.
The username of the User who caused the Event.
Provides additional information about the event. Additional information may include, but is not limited to, a more detailed representation of events which can help diagnose non-obvious failures.
The current page.
The total number of pages.
The total number of results.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.