Slutpunkt för granskningshändelser

Granskningsloggar används för att ge information om användaraktivitet för olika tjänster och funktioner. Varje åtgärd som registreras i en logg innehåller metadata som anger åtgärdstyp, datum och tid, e-post-ID för användaren som utförde åtgärden samt ytterligare attribut som är relevanta för åtgärdstypen. The /audit/events slutpunkt i Audit Query Med API kan du programmässigt hämta händelsedata för din organisations aktivitet i Platform.

Komma igång

API-slutpunkten som används i den här guiden är en del av Audit Query API. Läs igenom komma igång-guide för länkar till relaterad dokumentation, en guide till hur du läser exempel-API-anrop i det här dokumentet och viktig information om vilka huvuden som behövs för att kunna ringa anrop till Experience Platform API.

Visa granskningshändelser

Du kan hämta händelsedata genom att göra en GET-förfrågan till /audit/events slutpunkt, ange de händelser som du vill hämta i nyttolasten.

API-format

GET /audit/events

The Audit Query API har stöd för användning av frågeparametrar för att sidgranska och filtrera resultat när händelser listas.

Parameter
Beskrivning
limit
Det maximala antalet poster som ska returneras i svaret. Standardvärdet limit är 50.
start
En pekare till det första objektet för de returnerade sökresultaten. Om du vill komma åt nästa resultatsida ska den här parametern ökas med samma mängd som anges i begränsningen. Exempel: Om du vill få åtkomst till nästa resultatsida för en begäran med limit=50 använder du parametern start=50, sedan start=100 för sidan därefter och så vidare.
queryId
När du gör en fråga till slutpunkten /audit/events innehåller svaret en queryId-strängegenskap. Om du vill göra samma fråga i ett separat anrop kan du inkludera ID-värdet som en enda frågeparameter i stället för att konfigurera sökparametrarna manuellt igen.

Begäran

curl -X POST \
  https://platform.adobe.io/data/foundation/audit/events?limit=10
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'x-request-id: {TRACING_ID}' \

Svar

Ett lyckat svar returnerar de resulterande datapunkterna för de mätvärden och filter som anges i begäran.

{
   "_embedded": {
     "customerAuditLogList": [
       {
         "userEmail": "{USER_ID}",
         "userIpAddresses": [ ],
         "eventType": "Core",
         "id": "32b72208-3035-4bc6-b434-39e34401a864",
         "version": "1.0",
         "imsOrgId": "{ORGANIZATION_ID}",
         "sandboxName": "prod",
         "region": "VA7",
         "requestId": "5NphpgUQdQnjTWOcS9DSMs2wD1EUMlYG",
         "authId": "96715f98-d100-4575-8491-ebbcea654eb9",
         "permissionResource": "Sandbox",
         "permissionType": "RESET",
         "assetType": "Sandbox",
         "assetId": "prod",
         "assetName": "prod",
         "action": "Reset",
         "status": "Allow",
         "failureCode": "",
         "timestamp": "2021-08-04T21:58:09.745+0000"
       },
       {
         "userEmail": "{USER_ID}",
         "userIpAddresses": [ ],
         "eventType": "Core",
         "id": "a178736a-8fa1-47da-bac5-b0d9e741e414",
         "version": "1.0",
         "imsOrgId": "{ORGANIZATION_ID}",
         "sandboxName": "prod",
         "region": "VA7",
         "requestId": "7AlGIAhWvaEzYWHLzvuf26AAFAkqSyKg",
         "authId": "60fc1077-4aef-4e1f-a5ff-f64183e060f4",
         "permissionResource": "Sandbox",
         "permissionType": "RESET",
         "assetType": "Sandbox",
         "assetId": "prod",
         "assetName": "prod",
         "action": "Reset",
         "status": "Allow",
         "failureCode": "",
         "timestamp": "2021-08-04T21:28:00.301+0000"
       },
       {
         "userEmail": "{USER_ID}",
         "userIpAddresses": [ ],
         "eventType": "Core",
         "id": "ccfe8c77-9b93-481d-a561-0b2edf3b77dc",
         "version": "1.0",
         "imsOrgId": "{ORGANIZATION_ID}",
         "sandboxName": "prod",
         "region": "VA7",
         "requestId": "hArqS4CAa8wfRPnKuxV4yaA82atxwzYu",
         "authId": "80b7d887-9338-4cd5-9d79-2483b03f0160",
         "permissionResource": "Sandbox",
         "permissionType": "RESET",
         "assetType": "Sandbox",
         "assetId": "prod",
         "assetName": "prod",
         "action": "Reset",
         "status": "Allow",
         "failureCode": "",
         "timestamp": "2021-08-04T20:58:07.750+0000"
       }
     ]
   },
   "_links": {
     "self": {
       "href": "https://platform.adobe.io/data/foundation/audit/events?limit=10&start=0&property=type%253D%253Dcore"
     },
     "next": {
       "href": "https://platform.adobe.io/data/foundation/audit/events?queryId=cXVlcnlJZD0xYjA4MDM4MV81ZWNkXzRjNTZfYTM2N18zYWExOWI5YzNhNTlfMTYyODExNDY5MTg1NSZ0b3RhbEVsZW1lbnRzPTI2&start=10&limit=10"
     },
     "page": {
       "href": "https://platform.adobe.io/data/foundation/audit/events?queryId=cXVlcnlJZD0xYjA4MDM4MV81ZWNkXzRjNTZfYTM2N18zYWExOWI5YzNhNTlfMTYyODExNDY5MTg1NSZ0b3RhbEVsZW1lbnRzPTI2&limit=10{&start}",
       "templated": true
     }
  },
  "page": {
    "size": 10,
    "totalElements": 3,
    "totalPages": 1,
    "number": 1
  },
  "queryId": "cXVlcnlJZD0xYjA4MDM4MV81ZWNkXzRjNTZfYTM2N18zYWExOWI5YzNhNTlfMTYyODExNDY5MTg1NSZ0b3RhbEVsZW1lbnRzPTI2"
}
Egenskap
Beskrivning
customerAuditLogList
En array vars objekt representerar var och en av händelserna som anges i begäran. Varje objekt innehåller information om filterkonfigurationen och returnerade händelsedata.
userEmail
E-postadressen till användaren som utförde händelsen.
eventType
Typ av händelse. Händelsetyperna är Core och Enhanced.
imsOrgId
ID för organisationen som händelsen ägde rum under.
permissionResource

Den produkt eller funktion som gav behörighet att utföra åtgärden. En resurs kan vara något av följande:

  • Activation
  • ActivationAssociation
  • AnalyticSource
  • AudienceManagerSource
  • BizibleSource
  • CustomerAttributeSource
  • Dataset
  • EnterpriseSource
  • LaunchSource
  • MarketoSource
  • ProductProfile
  • ProfileConfig
  • Sandbox
  • Schema
  • Segment
  • StreamingSource
permissionType
Behörighetstypen som används för åtgärden.
assetType
Typen av plattformsresurs som åtgärden utfördes på.
assetId
En unik identifierare för den plattformsresurs som åtgärden utfördes på.
assetName
Namnet på den plattformsresurs som åtgärden utfördes på.
action

Den typ av åtgärd som spelades in för händelsen. En åtgärd kan vara något av följande:

  • Add
  • Create
  • Dataset activate
  • Dataset remove
  • Delete
  • Disable for profile
  • Enable
  • Enable for profile
  • Profile activate
  • Profile remove
  • remove
  • reset
  • segment activate
  • segment remove
  • update
status

Åtgärdens status. En status kan vara något av följande:

  • Allow

  • Deny

  • Failure

  • Success

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5