ドキュメントExperience PlatformExperience Platform の概要

監査イベントエンドポイント

最終更新日： 2025年8月20日

作成対象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

監査ログは、様々なサービスや機能に対するユーザーアクティビティの詳細を提供するために使用されます。 ログに記録される各アクションには、アクションのタイプ、日時、アクションを実行したユーザーの電子メール ID、アクションのタイプに関連する追加の属性を示すメタデータが含まれます。 Audit Query APIの/audit/events エンドポイントを使用すると、組織のExperience Platformでのアクティビティのイベントデータをプログラムで取得できます。

はじめに

このガイドで使用する API エンドポイントは、Audit Query API の一部です。 先に進む前に、はじめる前にのガイドを参照し、関連ドキュメントへのリンク、このドキュメントのサンプル API 呼び出しを読み取るためのガイドおよび任意の Experience Platform API の呼び出しを成功させるのに必要なヘッダーに関する重要な情報を確認してください。

監査イベントのリスト

取得するイベントをペイロードで指定して、/audit/events エンドポイントにGET リクエストを行うことで、イベントデータを取得できます。

API 形式

GET /audit/events

Audit Query APIは、クエリパラメーターを使用してイベントを一覧表示する際に結果をページ化およびフィルタリングすることをサポートしています。

パラメーター
説明
limit
応答で返されるレコードの最大数。 既定のlimitは50です。
start
返される検索結果の最初の項目へのポインター。 結果の次のページにアクセスするには、このパラメーターに制限で示すのと同じ量を増分する必要があります。 例：limit=50のリクエストの結果の次のページにアクセスするには、その後のページに対してパラメーターstart=50、start=100などを使用します。
queryId
/audit/events エンドポイントにクエリを実行する場合、応答にはqueryId文字列プロパティが含まれます。 別の呼び出しで同じクエリを実行するには、検索パラメーターを手動で再設定する代わりに、Id値を単一のクエリパラメーターとして含めることができます。

リクエスト

curl -X POST \
  https://platform.adobe.io/data/foundation/audit/events?limit=10
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'x-request-id: {TRACING_ID}' \

応答

応答が成功すると、リクエストで指定された指標とフィルターの結果のデータポイントが返されます。

{
  "_embedded": {
    "events": [
      {
        "id": "6ecc125d-da03-4882-a944-88c707ddc3f7",
        "requestId": "5YGdpTX5PvRrdqCfrCT8p8lWphZPzxl8",
        "permissionResource": "Dataset",
        "permissionType": "WRITE",
        "assetType": "Dataset",
        "action": "Create",
        "status": "Allow",
        "failureCode": "",
        "timestamp": "2025-06-24T16:50:28.318+0000",
        "version": "1.0",
        "imsOrgId": "{ORGANIZATION_ID}",
        "region": "VA7",
        "authId": "e6b46821-e2b4-4729-952f-2e4afd713b31",
        "assetId": "685ad754fb1abe2b263df4b3",
        "assetName": "my-dataset",
        "sandboxName": "prod",
        "sandboxId": "{SANDBOX_ID}",
        "userEmail": "{USER_EMAIL}",
        "userIpAddresses": [
          "130.*.*.*",
          "10.*.*.*"
        ],
        "enhancedEvents": [
          {
            "id": "0ee91e42-ac46-4f35-a01a-f74a1569c404",
            "requestId": "5YGdpTX5PvRrdqCfrCT8p8lWphZPzxl8",
            "permissionResource": "Dataset",
            "permissionType": "Write",
            "assetType": "Dataset",
            "action": "Create",
            "status": "Success",
            "failureCode": "",
            "timestamp": "2025-06-24T16:50:28.883+0000",
            "assetId": "685ad754fb1abe2b263df4b3",
            "assetName": "my-dataset"
          }
        ]
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://platform.adobe.io/data/foundation/audit/events?property=user%253D%253Ddraghici%2540adobe.com"
    },
    "page": {
      "href": "https://platform.adobe.io/data/foundation/audit/events?queryId=b3JkZXJCeVJ1bGVzPSZwcm9wZXJ0eT11c2VyPT1kcmFnaGljaUBhZG9iZS5jb20mdGltZXN0YW1wSW5kZXg9MTc1MDc4MzgyODMxOCZ0b3RhbEVsZW1lbnRzPTE3&limit=50{&start}",
      "templated": true
    }
  },
  "page": {
    "size": 1,
    "totalElements": 1,
    "totalPages": 1,
    "number": 1
  },
  "queryId": "b3JkZXJCeVJ1bGVzPSZwcm9wZXJ0eT11c2VyPT1kcmFnaGljaUBhZG9iZS5jb20mdGltZXN0YW1wSW5kZXg9MTc1MDc4MzgyODMxOCZ0b3RhbEVsZW1lbnRzPTE3"
}
プロパティ
説明
events
リクエストで指定された各イベントをオブジェクトが表す配列。 各オブジェクトには、フィルター設定と返されるイベントデータに関する情報が含まれます。
userEmail
イベントを実行したユーザーの電子メール。
eventType
イベントのタイプ。 イベントの種類はCoreとEnhancedです。
imsOrgId
イベントが発生した組織のID。
permissionResource

権限を提供した製品または機能がアクションを実行します。 リソースには、次のいずれかを指定できます。

  • Activation
  • ActivationAssociation
  • AnalyticSource
  • AudienceManagerSource
  • BizibleSource
  • CustomerAttributeSource
  • Dataset
  • EnterpriseSource
  • LaunchSource
  • MarketoSource
  • ProductProfile
  • ProfileConfig
  • Sandbox
  • Schema
  • Segment
  • StreamingSource
permissionType
アクションに関連する権限タイプ。
assetType
アクションが実行されたExperience Platform リソースのタイプ。
assetId
アクションが実行されたExperience Platform リソースの一意のID。
assetName
アクションが実行されたExperience Platform リソースの名前。
action

イベントに対して記録されたアクションのタイプ。 アクションには、次のいずれかを指定できます。

  • Add
  • Create
  • Dataset activate
  • Dataset remove
  • Delete
  • Disable for profile
  • Enable
  • Enable for profile
  • Profile activate
  • Profile remove
  • remove
  • reset
  • segment activate
  • segment remove
  • update
status

アクションのステータス。 ステータスは次のいずれかになります。

  • Allow

  • Deny

  • Failure

  • Success

recommendation-more-help
experience-platform-help-landing