List audit log archives

Use this endpoint to list all audit log archives. Archives contain historical audit log data that has been compressed and moved to long-term storage. Supports offset-based pagination.

GET /v1/governance/archives

List audit log archives

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/governance/archives \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "hasMore": true,
  "items": [
    {
      "compressedSizeBytes": 10485760,
      "dateRangeEnd": "2024-03-31T23:59:59Z",
      "dateRangeStart": "2024-01-01T00:00:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "partitionName": "audit_logs_2024_q1",
      "rowCount": 150000,
      "status": "COMPLETE",
      "storageClass": "GLACIER",
      "archivedAt": "2024-04-01T02:30:00Z",
      "checksum": "<string>"
    }
  ],
  "limit": 20
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de consulta

from · string

Start date filter (YYYY-MM-DD or RFC 3339 format) Filter archives from this date (YYYY-MM-DD or RFC3339)

to · string

End date filter (YYYY-MM-DD or RFC 3339 format) Filter archives until this date (YYYY-MM-DD or RFC3339)

limit · integer<int64> · predeterminado: 20

The maximum number of items to include in the response. Maximum number of records to return

Rango requerido: 1 <= x <= 200

offset · integer<int64> · predeterminado: 0

The number of items to skip before returning results. Number of records to skip

Rango requerido: x >= 0

Respuesta

200

application/json

List of audit log archives

hasMore · boolean · requerido

True when more archives exist beyond this page

Ejemplo:

true

items · object[] | null · requerido

Completed audit log archives for the current page

Maximum array length: 200

Show child attributes

limit · integer<int64> · requerido

Page size applied to this response (offset-based pagination)

Rango requerido: 1 <= x <= 200

Ejemplo:

20