API ReferenceAdministratorprotokolle

Auditprotokolleinträge für ein Konto abrufen

Auditprotokolle mit einigen Möglichkeiten zur Filterung über Abfrageparameter abrufen

Authentifizierung

AuthorizationBearer

Bearer-Authentifizierung der Form Bearer <token>, wobei token Ihr Auth-Token ist.

Pfadparameter

account_idstringErforderlichFormat: "uuid"
Account ID

Abfrageparameter

filters[start_date]stringOptionalFormat: "date"

Start-ISO-Datum

filters[end_date]stringOptionalFormat: "date"

Ende-ISO-Datum

filters[resource_type]enumOptional
Nach Ressourcentyp filtern
filters[event_type]enumOptional

Nach Aktivitätstyp filtern

filters[team_id]stringOptionalFormat: "uuid"

Nach Team-ID filtern

filters[project_id]stringOptionalFormat: "uuid"

Nach Projekt-ID filtern

filters[resource_id]stringOptionalFormat: "uuid"

Nach Ressourcen-ID filtern (Asset-ID, Projekt-ID, Anwender-ID)

filters[user_id]stringOptionalFormat: "uuid"

Nach Anwender-ID filtern

filters[ip_address]stringOptional

Nach IP-Adresse filtern

Dies unterstützt sowohl IPv4 (‘1.1.1.1’) als auch IPv6 (‘2001:db8:3333:4444:5555:6666:7777:8888’)

pageintegerOptionalStandardwert ist 1
Seitenzahl
page_sizeintegerOptional<=200Standardwert ist 50

Datensätze pro Seite

Antwort-Header

page-numberinteger
Current page of results
per-pageinteger
Number of entries per page
totalinteger
Total entries across all pagess
total-pagesinteger
Number of pages

Antwort

Succesful Event logs response
account_idstring or nullOptionalFormat: "uuid"
anonymous_user_idstring or nullOptionalFormat: "uuid"
clientstring or nullOptional

Der API-Client, durch den das Auditereignis ausgelöst wurde. Dieses Feld ist nicht immer befüllt.

Wenn der API-Aufruf, der ein Ereignis erzeugt hat, über eine OAuth-App erfolgt ist, sieht er so aus: ‘oauth_app/:uuid’. Wenn er über ein Entwickler-Token erfolgt ist, sieht er so aus: ‘user_token/:uuid’. Dabei ist die UUID die User-ID, zu der das Token gehört.

Hier sind einige Beispiele:

  • ‘user_token/57823879-e541-49b0-b902-c43794c4400c’
  • ‘oauth_app/80ccf0bb-ae91-49c4-8aec-8f6238c14947’
  • ‘web/2024-06-10-18-15’
  • ‘pipeline-media-warden/cbd0061f6f190489e8af3137b8707b33f498f53f’
  • ‘null’
event_typeenumOptional
event_detailsobjectOptional
Die Details zum Ereignis. Das variiert je nach Ereignistyp stark. Es gibt einige Beispiele in den Beispielantworten.
iddoubleOptional
Eindeutige Kennung
inserted_atstringOptionalFormat: "date-time"
ip_addressstring or nullOptional

Die IP-Adresse, die diesem Ereignis zugeordnet ist

project_idstring or nullOptionalFormat: "uuid"

Die Projekt-ID, in der diese Aktion stattgefunden hat

resource_idstringOptionalFormat: "uuid"
Die ID der referenzierten Ressource
resource_typeenumOptional
Der Typ der referenzierten Ressource
team_idstring or nullOptionalFormat: "uuid"

Team-ID

sourceenumOptional
Die Quelle der Aktion, die einen bestimmten Eintrag im Auditprotokoll erzeugt hat
user_idstring or nullOptionalFormat: "uuid"

Benutzenden-ID

updated_atstringOptionalFormat: "date-time"

Fehler

401
Unauthorized Error
404
Not Found Error