Endpoint del registro di controllo

Per ogni risorsa Experience Data Model (XDM), la variabile Schema Registry mantiene un registro di tutte le modifiche che si sono verificate tra diversi aggiornamenti. La /auditlog punto finale Schema Registry L’API ti consente di recuperare un registro di controllo per qualsiasi classe, gruppo di campi dello schema, tipo di dati o schema specificato dall’ID.

Introduzione

L’endpoint utilizzato in questa guida fa parte dell’Schema Registry API di . Prima di continuare, controlla la guida introduttiva per i collegamenti alla documentazione correlata, una guida alla lettura delle chiamate API di esempio in questo documento e importanti informazioni sulle intestazioni richieste necessarie per effettuare correttamente le chiamate a qualsiasi API di Experience Platform.

La /auditlog l'endpoint fa parte delle chiamate di routine remote (RPC) supportate dal Schema Registry. A differenza di altri endpoint nel Schema Registry API, gli endpoint RPC non richiedono intestazioni aggiuntive come Accept o Content-Typee non utilizzano un CONTAINER_ID. Invece, devono utilizzare il /rpc namespace, come illustrato nella chiamata API riportata di seguito.

Recuperare un registro di controllo per una risorsa

È possibile recuperare un registro di controllo per qualsiasi classe, gruppo di campi, tipo di dati o schema all’interno della Libreria schema specificando l’ID della risorsa nel percorso di una richiesta di GET al /auditlog punto finale.

Formato API

GET /rpc/auditlog/{RESOURCE_ID}
Parametro Descrizione
{RESOURCE_ID} La meta:altId o con codifica URL $id della risorsa di cui si desidera recuperare il registro di controllo.

Richiesta

La richiesta seguente recupera il registro di controllo per uno schema.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/rpc/auditlog/_{TENANT_ID}.schemas.50649eb1b040bf042d6400a0335901cd2a97d31a4eac4330 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

Una risposta corretta restituisce un elenco cronologico delle modifiche apportate alla risorsa, dalla più recente alla meno recente.

[
  {
    "id": "https://ns.adobe.com/{TENANT_ID}/schemas/50649eb1b040bf042d6400a0335901cd2a97d31a4eac4330",
    "updatedUser": "{USER_ID}",
    "imsOrg": "{IMS_ORG}",
    "updatedTime": "02-19-2021 05:43:56",
    "requestId": "a14NMF0jd6BIfyXaHdTDl4bC4R0r9rht",
    "clientId": "{CLIENT_ID}",
    "sandBoxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
    "updates": [
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/50649eb1b040bf042d6400a0335901cd2a97d31a4eac4330",
        "xdmType": "schemas",
        "action": "remove",
        "path": "/meta:usageCount",
        "value": 0
      }
    ]
  },
  {
    "id": "https://ns.adobe.com/{TENANT_ID}/schemas/50649eb1b040bf042d6400a0335901cd2a97d31a4eac4330",
    "updatedUser": "{USER_ID}",
    "imsOrg": "{IMS_ORG}",
    "updatedTime": "02-19-2021 05:43:56",
    "requestId": "pFQbgmWrdbJrNB9GdxTSGECpXYWspu68",
    "clientId": "{CLIENT_ID}",
    "sandBoxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
    "updates": [
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/classes/11052164b588f0c29584bf6ae1a6663a59aa65426c82389f",
        "xdmType": "classes",
        "action": "remove",
        "path": "/definitions/customFields/properties/_{TENANT_ID}/properties/loyaltySunday_ABC",
        "value": {
          "title": "LoyaltySundayABC",
          "description": "",
          "type": "string",
          "isRequired": false,
          "required": [],
          "meta:xdmType": "string"
        }
      },
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/classes/11052164b588f0c29584bf6ae1a6663a59aa65426c82389f",
        "xdmType": "classes",
        "action": "remove",
        "path": "/definitions/customFields/properties/_{TENANT_ID}/properties/loyaltyMoxee_XYZ",
        "value": {
          "title": "LoyaltyMoxeeXYZ",
          "description": "",
          "type": "string",
          "isRequired": false,
          "required": [],
          "meta:xdmType": "string"
        }
      }
    ]
  }
]
Proprietà Descrizione
updates Matrice di oggetti, con ogni oggetto che rappresenta una modifica apportata alla risorsa specificata o a una delle relative risorse dipendenti.
id La $id della risorsa modificata. Questo valore rappresenta in genere la risorsa specificata nel percorso della richiesta, ma può rappresentare una risorsa dipendente se questa è l’origine della modifica.
xdmType Tipo di risorsa modificata.
action Tipo di modifica apportata.
path A Puntatore JSON stringa che indica il percorso del campo specifico modificato o aggiunto.
value Valore assegnato al campo nuovo o aggiornato.

In questa pagina