監査ログエンドポイント

Schema Registryは、各エクスペリエンスデータモデル(XDM)リソースに対して、異なる更新間で発生したすべての変更のログを保持します。 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を使用しません。 代わりに、以下のAPI呼び出しで示すように、/rpc名前空間を使用する必要があります。

リソースの監査ログの取得

/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 新規または更新されたフィールドに割り当てられた値。

このページ

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