Get a stream's history

get

https://api.linode.com/{apiVersion}/monitor/streams/{streamId}/history

Limited availability Returns all versions of a specific logs stream. Include the appropriate streamId as a path parameter. This operation can only be accessed by account users with unrestricted access. Talk to your local account administrator about access management.

Permissions and scopes

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

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: monitor:read_only

CLI

linode-cli streams history-view 456

Learn more

Responses

Response body

object

page

integer

Read-only The current page.

pages

integer

Read-only The total number of pages.

results

integer

Read-only The total number of results.

data

array of objects

data

object

created

date-time

Read-only When the stream was created.

created_by

string

Read-only The name of the user on your account that created the stream.

destinations

array of objects

required

The sync points that will receive logs data.

destinations*

object

details

object

Settings used for an Object Storage-based destination for a stream. You need an existing Object Storage bucket, configured to use Object Lock. See Configure audit log delivery for complete details.

integer

The unique identifier for the destination.

label

string

The name of the destination object. Used for display purposes.

type

string

enum

The type of destination for logs data sync. Currently, only akamai_object_storage is supported for use. This lets you use Akamai Object Storage as your destination.

akamai_object_storage

integer

Read-only The unique identifier assigned to the stream.

label

string

required

The name of the stream. This is used for display purposes in Akamai Cloud Manager.

status

string

enum

Defaults to active

The availability status of the stream.

active inactive

type

string

enum

required

The type of stream. Set this to audit_logs for logs consisting of all of the control plane operations for the services in your Linodes.

audit_logs

updated

date-time

Read-only When the stream was last updated. This is the same as created if the stream hasn't been updated.

updated_by

string

Read-only The name of the user on your account that last updated the stream. If it hasn't been updated, this value is the same as created_by.

version

integer

Read-only Identifies the version of the stream.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/monitor/streams/streamId/history \
3
     --header 'accept: application/json'


xxxxxxxxxx
31
 
1
{
2
  "data": [
3
    {
4
      "created": "2025-03-20 01:41:09",
5
      "created_by": "John Q. Linode",
6
      "destinations": [
7
        {
8
          "details": {
9
            "access_key_id": 123,
10
            "bucket_name": "primary-bucket",
11
            "host": "primary-bucket-1.us-iad-12.linodeobjects.com",
12
            "path": "audit-logs"
13
          },
14
          "id": 12345,
15
          "label": "OBJ_logs_destination",
16
          "type": "akamai_object_storage"
17
        }
18
      ],
19
      "id": 12345,
20
      "label": "AuditLog-config",
21
      "status": "active",
22
      "type": "audit_logs",
23
      "updated": "2025-03-20 01:41:09",
24
      "updated_by": "Jane Q. Linode",
25
      "version": 1
26
    }
27
  ],
28
  "page": 1,
29
  "pages": 1,
30
  "results": 1
31
}

200Returns all versions of the requested logs stream.

defaultSee Errors for the range of possible error response codes.