Ponto de extremidade de log de auditoria

Para cada recurso do Experience Data Model (XDM), o Schema Registry mantém um log de todas as alterações que ocorreram entre diferentes atualizações. O endpoint /auditlog na API Schema Registry permite recuperar um log de auditoria para qualquer classe, mixin, tipo de dados ou schema especificado pela ID.

Introdução

O endpoint usado neste guia faz parte da Schema Registry API. Antes de continuar, consulte o guia de introdução para obter links para a documentação relacionada, um guia para ler as chamadas de API de exemplo neste documento e informações importantes sobre cabeçalhos necessários que são necessários para fazer chamadas com êxito para qualquer API da Experience Platform.

O ponto de extremidade /auditlog faz parte das chamadas de procedimento remoto (RPCs) suportadas pelo Schema Registry. Ao contrário de outros endpoints na API Schema Registry, os endpoints RPC não exigem cabeçalhos adicionais como Accept ou Content-Type e não usam um CONTAINER_ID. Em vez disso, eles devem usar o namespace /rpc, conforme demonstrado na chamada de API abaixo.

Recuperar um log de auditoria de um recurso

Você pode recuperar um log de auditoria para qualquer classe, mixin, tipo de dados ou schema na Biblioteca de Esquemas especificando a ID do recurso no caminho de uma solicitação GET para o endpoint /auditlog.

Formato da API

GET /rpc/auditlog/{RESOURCE_ID}
Parâmetro Descrição
{RESOURCE_ID} O meta:altId ou $id codificado por URL do recurso cujo log de auditoria você deseja recuperar.

Solicitação

A solicitação a seguir recupera o log de auditoria para uma combinação Restaurant.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/rpc/auditlog/_{TENANT_ID}.mixins.922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9 \
  -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}'

Resposta

Uma resposta bem-sucedida retorna uma lista cronológica de alterações feitas no recurso, da mais recente para a menos recente.

[
  {
    "id": "https://ns.adobe.com/{TENANT_ID}/mixins/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
    "auditTrails": [
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/mixins/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
        "xdmType": "mixins",
        "action": "add",
        "path": "/definitions/customFields/properties/_{TENANT_ID}/properties/brand",
        "value": {
          "title": "Brand",
          "description": "",
          "type": "string",
          "isRequired": false,
          "meta:xdmType": "string"
        }
      },
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/mixins/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
        "xdmType": "mixins",
        "action": "add",
        "path": "/meta:usageCount",
        "value": 0
      }
    ],
    "updatedUser": "{USER_ID}",
    "imsOrg": "{IMS_ORG}",
    "updated": 1606255582281,
    "clientId": "{CLIENT_ID}",
    "sandBoxId": "{SANDBOX_ID}"
  }
]
Propriedade Descrição
auditTrails Uma matriz de objetos, com cada objeto representando uma alteração feita no recurso especificado ou um de seus recursos dependentes.
id O $id do recurso que foi alterado. Normalmente, esse valor representa o recurso especificado no caminho da solicitação, mas pode representar um recurso dependente se essa for a fonte da alteração.
action O tipo de mudança que foi feita.
path Uma string JSON Pointer indicando o caminho para o campo específico que foi alterado ou adicionado.
value O valor atribuído ao campo novo ou atualizado.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now