審核日誌端點

對於每個Experience Data Model(XDM)資源, Schema Registry會維護在不同更新之間發生的所有變更記錄。 Schema Registry API中的/auditlog端點可讓您擷取ID所指定之任何類別、架構欄位群組、資料類型或架構的稽核記錄。

快速入門

本指南中使用的端點是Schema Registry API的一部分。 繼續之前,請檢閱快速入門手冊,取得相關檔案的連結、閱讀本檔案中範例API呼叫的指南,以及成功呼叫任何Experience PlatformAPI所需的必要標頭的重要資訊。

/auditlog端點是[!DNL Schema Registry]支援的遠程過程調用(RPC)的一部分。 與[!DNL Schema Registry] API中的其他端點不同,RPC端點不需要額外的標題,如AcceptContent-Type,也不使用CONTAINER_ID。 因此,他們必須使用/rpc命名空間,如下方API呼叫所示。

檢索資源的審核日誌

您可以在/auditlog端點的GET請求路徑中指定資源的ID,以檢索架構庫內任何類、欄位組、資料類型或架構的審核日誌。

API格式

GET /rpc/auditlog/{RESOURCE_ID}
參數 說明
{RESOURCE_ID} 您要擷取其稽核記錄的資源的meta:altId或URL編碼的$id

要求

以下請求將檢索Restaurant欄位組的審核日誌。

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

回應

成功的回應會傳回對資源所做變更(從最近到最近)的時間順序清單。

[
  {
    "id": "https://ns.adobe.com/{TENANT_ID}/fieldgroups/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
    "auditTrails": [
      {
        "id": "https://ns.adobe.com/{TENANT_ID}/fieldgroups/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
        "xdmType": "fieldgroups",
        "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}/fieldgroups/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
        "xdmType": "fieldgroups",
        "action": "add",
        "path": "/meta:usageCount",
        "value": 0
      }
    ],
    "updatedUser": "{USER_ID}",
    "imsOrg": "{IMS_ORG}",
    "updated": 1606255582281,
    "clientId": "{CLIENT_ID}",
    "sandBoxId": "{SANDBOX_ID}"
  }
]
屬性 說明
auditTrails 對象的陣列,每個對象表示對指定資源或其一個相關資源所做的更改。
id 已更改的資源的$id。 此值通常會代表請求路徑中指定的資源,但如果是變更的來源,則可能代表相依資源。
action 已進行的變更類型。
path JSON指針字串,用於指示已變更或新增之特定欄位的路徑。
value 指派給新欄位或更新欄位的值。

本頁內容