UiPath Documentation
ixp
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

Communications Mining 用户指南

上次更新日期 2026年4月23日

审核事件

查询审核事件​

docs image/api/v1/audit_events/query

所需权限：读取审核日志。

  • 重击 
    curl -X POST 'https://<my_api_endpoint>/api/v1/audit_events/query' \
    -H "Authorization: Bearer $REINFER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
  "filter": {
    "timestamp": {
      "maximum": "2021-07-10T00:00:00Z",
      "minimum": "2021-06-10T00:00:00Z"
    }
  }
}'
curl -X POST 'https://<my_api_endpoint>/api/v1/audit_events/query' \
    -H "Authorization: Bearer $REINFER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
  "filter": {
    "timestamp": {
      "maximum": "2021-07-10T00:00:00Z",
      "minimum": "2021-06-10T00:00:00Z"
    }
  }
}'
  • 节点 
    const request = require("request");

request.post(
  {
    url: "https://<my_api_endpoint>/api/v1/audit_events/query",
    headers: {
      Authorization: "Bearer " + process.env.REINFER_TOKEN,
    },
    json: true,
    body: {
      filter: {
        timestamp: {
          maximum: "2021-07-10T00:00:00Z",
          minimum: "2021-06-10T00:00:00Z",
        },
      },
    },
  },
  function (error, response, json) {
    // digest response
    console.log(JSON.stringify(json, null, 2));
  }
);
const request = require("request");

request.post(
  {
    url: "https://<my_api_endpoint>/api/v1/audit_events/query",
    headers: {
      Authorization: "Bearer " + process.env.REINFER_TOKEN,
    },
    json: true,
    body: {
      filter: {
        timestamp: {
          maximum: "2021-07-10T00:00:00Z",
          minimum: "2021-06-10T00:00:00Z",
        },
      },
    },
  },
  function (error, response, json) {
    // digest response
    console.log(JSON.stringify(json, null, 2));
  }
);
  • Python 
    import json
import os

import requests

response = requests.post(
    "https://<my_api_endpoint>/api/v1/audit_events/query",
    headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
    json={
        "filter": {
            "timestamp": {
                "minimum": "2021-06-10T00:00:00Z",
                "maximum": "2021-07-10T00:00:00Z",
            }
        }
    },
)

print(json.dumps(response.json(), indent=2, sort_keys=True))
import json
import os

import requests

response = requests.post(
    "https://<my_api_endpoint>/api/v1/audit_events/query",
    headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
    json={
        "filter": {
            "timestamp": {
                "minimum": "2021-06-10T00:00:00Z",
                "maximum": "2021-07-10T00:00:00Z",
            }
        }
    },
)

print(json.dumps(response.json(), indent=2, sort_keys=True))
  • 响应 
    {
  "audit_events": [
    {
      "actor_user_id": "e2148a6625225593",
      "dataset_ids": ["1fe230edc85ffc1a"],
      "event_id": "2555880060c23eb5",
      "event_type": "get_datasets",
      "project_ids": ["ce3c61dcf210f425", "274400867ab17af9"],
      "tenant_ids": ["c59b6e209da438a8"],
      "timestamp": "2021-06-10T16:32:53Z"
    }
  ],
  "continuation": "2555880060c23eb5",
  "datasets": [
    {
      "id": "1fe230edc85ffc1a",
      "name": "collateral-sharing",
      "project_id": "ce3c61dcf210f425",
      "title": "Collateral Sharing"
    },
    {
      "id": "274400867ab17af9",
      "name": "Customer-Feedback",
      "project_id": "ce3c61dcf210f425",
      "title": "Customer Feedback"
    }
  ],
  "projects": [
    {
      "id": "ce3c61dcf210f425",
      "name": "bank-collateral",
      "tenant_id": "c59b6e209da438a8"
    }
  ],
  "status": "ok",
  "tenants": [
    {
      "id": "c59b6e209da438a8",
      "name": "acme"
    }
  ],
  "users": [
    {
      "display_name": "Alice",
      "email": "[email protected]",
      "id": "e2148a6625225593",
      "tenant_id": "c59b6e209da438a8",
      "username": "alice"
    }
  ]
}
{
  "audit_events": [
    {
      "actor_user_id": "e2148a6625225593",
      "dataset_ids": ["1fe230edc85ffc1a"],
      "event_id": "2555880060c23eb5",
      "event_type": "get_datasets",
      "project_ids": ["ce3c61dcf210f425", "274400867ab17af9"],
      "tenant_ids": ["c59b6e209da438a8"],
      "timestamp": "2021-06-10T16:32:53Z"
    }
  ],
  "continuation": "2555880060c23eb5",
  "datasets": [
    {
      "id": "1fe230edc85ffc1a",
      "name": "collateral-sharing",
      "project_id": "ce3c61dcf210f425",
      "title": "Collateral Sharing"
    },
    {
      "id": "274400867ab17af9",
      "name": "Customer-Feedback",
      "project_id": "ce3c61dcf210f425",
      "title": "Customer Feedback"
    }
  ],
  "projects": [
    {
      "id": "ce3c61dcf210f425",
      "name": "bank-collateral",
      "tenant_id": "c59b6e209da438a8"
    }
  ],
  "status": "ok",
  "tenants": [
    {
      "id": "c59b6e209da438a8",
      "name": "acme"
    }
  ],
  "users": [
    {
      "display_name": "Alice",
      "email": "[email protected]",
      "id": "e2148a6625225593",
      "tenant_id": "c59b6e209da438a8",
      "username": "alice"
    }
  ]
}

审核事件是 Communications Mining™ 平台用户所执行操作的记录。可审核事件示例包括：

  • 用户登录
  • 用户更改其密码
  • 一个用户更改另一个用户的权限。
名称类型必填说明
continuation字符串否如果上一个查询在响应中返回了continuation ，则可以使用另一页事件。 在此处设置返回的延续值以获取下一页。
limit数字否每页返回的审核事件数。 默认为 128。
filter筛选否指定要返回的审核事件的筛选器。

其中Filter具有以下格式：

名称类型必填说明
timestamp时间戳筛选器否指定要返回事件的时间范围的筛选器。

其中TimestampFilter具有以下格式：

名称类型必填说明
minimum字符串否ISO-8601 时间戳。 如果提供，则仅返回此时间戳之后 (含) 的审核事件。
maximum字符串否ISO-8601 时间戳。 如果提供，则仅返回此时间戳之前的审核事件。

响应格式​

审核事件列表可以在响应顶层的audit_events键下找到。 每个AuditEvent都可以按 ID 引用其他资源（例如来源、数据集、用户等）。 对于每个引用的资源，可以在响应顶层的相应键（ sources 、 datasets 、 users等）下找到其他信息。

AuditEvent表示用户在平台中执行的操作，并具有以下基本格式。 可能存在其他键，具体取决于event_type的值。 例如， get_datasets审核事件将包含用户已阅读的dataset_ids列表。

名称类型说明
event_id字符串此事件的唯一 ID。
event_type字符串事件的类型。请参阅下一部分中的事件类型列表。
timestamp字符串此事件的 ISO-8601 时间戳，精确到秒。
actor_user_id字符串执行此操作的用户的 ID。
actor_tenant_id字符串执行此操作的用户的租户 ID。

最后，如果响应包含continuation键，则应通过将请求中的continuation字段设置为此值来获取下一页事件。

审核事件类型​

警示审核事件

事件类型说明
alert_create系统将创建警示。
alert_get可查看警示。
alert_get_all可以查看警示列表。
alert_update已编辑警示配置。
alert_delete警示已删除。
alert_subscriptions_get系统将查看警示订阅列表。
alert_subscriptions_delete已删除警示订阅。

配额审核事件

事件类型说明
quotas_get可查看配额。
quotas_set配额已更新。
quotas_reset配额已重置。

流审核事件

备注：

流以前称为触发器。

事件类型说明
trigger_create系统即会创建流。
trigger_get查看流。
trigger_get_all系统将查看流列表。
trigger_update已编辑流的配置。
trigger_delete已删除一个流。
trigger_fetch查询流（旧版操作）。
trigger_advance流已推进。
trigger_reset流已重置。
trigger_fetch_gx查询生成提取流（旧版操作）。
trigger_get_results已查询一个流。

模型管理审核事件

事件类型说明
model_version_published发布 (ucd)/固定模型 (CM) 时。
model_version_unpublished删除已发布的模型时。
model_tag_updated更新模型标签时。
model_tag_deleted删除模型标签时。

数据集管理审核事件

事件类型说明
get_datasets检索数据集时。
get_datasets_by_owner所有者检索数据集时。
get_dataset检索到特定的数据集时。
export_dataset导出数据集时。

用户管理审核事件

事件类型说明
create_user新建用户时。
delete_user删除用户时。
get_users检索用户信息时。
update_user修改用户信息时。

身份验证和安全审核事件

事件类型说明
login_success用户登录成功。
authentication_failed_password由于密码错误，登录失败。
authentication_failed_totp由于 TOTP 代码错误，登录失败。
login_failed_ip_address由于 IP 地址限制，登录失败。
revoke_api_tokens撤销 API 令牌时。
revoke_login_tokens撤销登录令牌时。
revoke_current_login_token撤销当前会话令牌时。
replace_api_token替换 API 令牌时。
authentication_failed_totp_lockout由于 TOTP 锁定，登录失败。

密码重置审核事件

事件类型说明
send_password_reset_success已成功发送密码重置电子邮件。
send_password_reset_failed_ip_address密码重置被 IP 阻止。
verify_password_reset_success密码重置验证成功。
verify_password_reset_failed_ip_address密码重置验证被 IP 阻止。
change_password_success密码更改成功。
change_password_failed_totp由于 TOTP，密码更改失败。
change_password_failed_ip_addressIP 阻止了密码更改。
verify_password_reset_failed_signature密码重置签名无效。
verify_password_reset_failed_timestamp密码重置链接已过期。
change_password_failed_current_password提供的当前密码错误。

注释查询审核事件

事件类型说明
comment_query_text基于文本的评论查询。
comment_query_sample注释查询示例。
comment_query_learning与学习相关的注释查询。
comment_query_any_label_asc基于标签的查询（升序）。
comment_query_recent最近的评论查询。
comment_query_by_label按特定标签筛选的查询。
comment_query_diagnostic诊断注释查询。
comment_query_label_property标签属性查询。
comment_query_attachment_text附件文本查询。
comment_query_check选中型注释查询。
comment_query_missed缺少注释查询。

注释审核事件

事件类型说明
get_annotations检索注释时。
update_annotation修改注释时。

系统和管理员审核事件

事件类型说明
get_deprecated_user_models访问已弃用的用户模型时。
audit_event_query查询审核事件本身时。
email_get检索电子邮件时。
  • 查询审核事件​
  • 响应格式​
  • 审核事件类型​

此页面有帮助吗？

连接

需要帮助? 支持

想要了解详细内容？ UiPath Academy

有问题? UiPath 论坛

保持更新