Endpoint “audit_events”
/audit_events
è in continua evoluzione, di pari passo con l’aggiunta, la rimozione e la rielaborazione delle varie funzioni.Un evento di audit è un record di una specifica modifica apportata a un’altra risorsa nell’API di Reactor, generato al momento della modifica stessa. Si tratta di eventi di sistema a cui è possibile sottoscrivere tramite una richiamata, o callback. L’endpoint /audit_events
nell’API di Reactor consente di gestire programmaticamente gli eventi di audit all’interno dell’applicazione Experience.
Gli eventi di audit sono strutturati sotto forma di {RESOURCE_TYPE}.{EVENT}
, ad esempio build.created
o rule.updated
.
Sono ammessi i seguenti tipi di risorsa:
property
extension
data_element
rule
rule_component
library
build
environment
host
Per ogni tipo di risorsa sono supportati i seguenti eventi:
created
updated
deleted
Introduzione
L’endpoint utilizzato in questa guida fa parte dell’API di Reactor. Prima di continuare, consulta la guida introduttiva per informazioni importanti su come eseguire l’autenticazione nell’API.
Recuperare un elenco di eventi di audit list
Per recuperare un elenco di eventi di audit per tutte le proprietà appartenenti all’organizzazione, devi eseguire una richiesta GET all’endpoint /audit_events
.
Formato API
GET /audit_events
Richiesta
curl -X GET \
https://reactor.adobe.io/audit_events \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-H 'Accept: application/vnd.api+json;revision=1'
Risposta
In caso di esito positivo, la risposta restituisce un elenco di eventi di audit. La risposta di esempio seguente è stata troncata per motivi di spazio.
{
"data": [
{
"id": "AEa98742de8ef044d8b86767aa6a15a674",
"type": "audit_events",
"attributes": {
"attributed_to_display_name": "John Smith",
"attributed_to_email": "jsmith@example.com",
"created_at": "2020-12-14T17:31:21.836Z",
"display_name": "Kessel Apns App",
"type_of": "app_configuration.updated",
"updated_at": "2020-12-14T17:31:21.836Z",
"entity": "{\"data\":{\"id\":\"AC40c339ab80d24c958b90d67b698602eb\",\"type\":\"app_configurations\",\"links\":{\"self\":\"https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb\",\"company\":\"https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1\"},\"attributes\":{\"name\":\"Kessel Apns App\",\"app_id\":\"com.adobe.test_app_2\",\"key_type\":\"p8_file\",\"platform\":\"mobile\",\"created_at\":\"2020-12-14T17:31:10.626Z\",\"updated_at\":\"2020-12-14T17:31:21.787Z\",\"messaging_service\":\"apns\"},\"relationships\":{\"company\":{\"data\":{\"id\":\"CO2bf094214ffd4785bb4bcf88c952a7c1\",\"type\":\"companies\"},\"links\":{\"related\":\"https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company\"}}}}}"
},
"relationships": {
"property": {
"links": {
"related": null
},
"data": null
},
"entity": {
"links": {
"related": null
},
"data": {
"type": "app_configurations",
"id": "AC40c339ab80d24c958b90d67b698602eb"
}
}
},
"links": {
"entity": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb",
"property": null,
"self": "https://reactor.adobe.io/audit_events/AEa98742de8ef044d8b86767aa6a15a674"
}
},
{
"id": "AE7320b6c1c3f84bb69405fcfe9cb58189",
"type": "audit_events",
"attributes": {
"attributed_to_display_name": "John Smith",
"attributed_to_email": "jsmith@example.com",
"created_at": "2020-12-14T17:31:10.672Z",
"display_name": "Kessel Apns App",
"type_of": "app_configuration.created",
"updated_at": "2020-12-14T17:31:10.672Z",
"entity": "{\"data\":{\"id\":\"AC40c339ab80d24c958b90d67b698602eb\",\"type\":\"app_configurations\",\"links\":{\"self\":\"https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb\",\"company\":\"https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1\"},\"attributes\":{\"name\":\"Kessel Apns App\",\"app_id\":\"com.adobe.test_app\",\"key_type\":\"p8_file\",\"platform\":\"mobile\",\"created_at\":\"2020-12-14T17:31:10.626Z\",\"updated_at\":\"2020-12-14T17:31:10.626Z\",\"messaging_service\":\"apns\"},\"relationships\":{\"company\":{\"data\":{\"id\":\"CO2bf094214ffd4785bb4bcf88c952a7c1\",\"type\":\"companies\"},\"links\":{\"related\":\"https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company\"}}}}}"
},
"relationships": {
"property": {
"links": {
"related": null
},
"data": null
},
"entity": {
"links": {
"related": null
},
"data": {
"type": "app_configurations",
"id": "AC40c339ab80d24c958b90d67b698602eb"
}
}
},
"links": {
"entity": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb",
"property": null,
"self": "https://reactor.adobe.io/audit_events/AE7320b6c1c3f84bb69405fcfe9cb58189"
}
}
],
"links": {
"self": "https://reactor.adobe.io/audit_events?page%5Bnumber%5D=1&page%5Bsize%5D=25",
"next": "https://reactor.adobe.io/audit_events?page%5Bnumber%5D=2&page%5Bsize%5D=25",
"last": "https://reactor.adobe.io/audit_events?page%5Bnumber%5D=129&page%5Bsize%5D=25"
},
"meta": {
"pagination": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}
}
Cercare un evento di audit lookup
Per cercare un evento di audit occorre specificare il relativo ID nel percorso di una richiesta GET.
Formato API
GET /audit_events/{AUDIT_EVENT_ID}
AUDIT_EVENT_ID
id
dell’evento di audit che si desidera cercare.Richiesta
curl -X GET \
https://reactor.adobe.io/audit_events/AEa98742de8ef044d8b86767aa6a15a674 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-H 'Accept: application/vnd.api+json;revision=1'
Risposta
In caso di esito positivo, la risposta restituisce i dettagli dell’evento di audit.
{
"data": {
"id": "AEd6a3b381fb8241818d7520001f8bd459",
"type": "audit_events",
"attributes": {
"attributed_to_display_name": "John Smith",
"attributed_to_email": "jsmith@example.com",
"created_at": "2020-12-14T17:31:46.956Z",
"display_name": "Example Rule",
"type_of": "rule.created",
"updated_at": "2020-12-14T17:31:46.956Z",
"entity": "{\"data\":{\"id\":\"RL52d156a9074844b89ca20c987dbafd3b\",\"meta\":{\"latest_revision_number\":0},\"type\":\"rules\",\"links\":{\"self\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b\",\"origin\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b\",\"property\":\"https://reactor.adobe.io/properties/PR03cc61073ef74fd2af21e4cfb6ed97a7\",\"rule_components\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/rule_components\"},\"attributes\":{\"name\":\"Example Rule\",\"dirty\":true,\"enabled\":true,\"published\":false,\"created_at\":\"2020-12-14T17:31:46.883Z\",\"deleted_at\":null,\"updated_at\":\"2020-12-14T17:31:46.883Z\",\"published_at\":null,\"review_status\":\"unsubmitted\",\"revision_number\":0},\"relationships\":{\"notes\":{\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/notes\"}},\"origin\":{\"data\":{\"id\":\"RL52d156a9074844b89ca20c987dbafd3b\",\"type\":\"rules\"},\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/origin\"}},\"property\":{\"data\":{\"id\":\"PR03cc61073ef74fd2af21e4cfb6ed97a7\",\"type\":\"properties\"},\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/property\"}},\"libraries\":{\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/libraries\"}},\"revisions\":{\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/revisions\"}},\"rule_components\":{\"links\":{\"related\":\"https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b/rule_components\"}}}}}"
},
"relationships": {
"property": {
"links": {
"related": "https://reactor.adobe.io/audit_events/AEd6a3b381fb8241818d7520001f8bd459/property"
},
"data": {
"id": "PR03cc61073ef74fd2af21e4cfb6ed97a7",
"type": "properties"
}
},
"entity": {
"links": {
"related": "https://reactor.adobe.io/audit_events/AEd6a3b381fb8241818d7520001f8bd459/rule"
},
"data": {
"type": "rules",
"id": "RL52d156a9074844b89ca20c987dbafd3b"
}
}
},
"links": {
"entity": "https://reactor.adobe.io/rules/RL52d156a9074844b89ca20c987dbafd3b",
"property": "https://reactor.adobe.io/properties/PR03cc61073ef74fd2af21e4cfb6ed97a7",
"self": "https://reactor.adobe.io/audit_events/AEd6a3b381fb8241818d7520001f8bd459"
},
"meta": {
"property_name": "Kessel Example Property"
}
}
}