Hub documentation
审计日志
审计日志
此功能属于 Team & Enterprise 计划的一部分。
Audit Logs 允许组织管理员轻松查看成员执行的操作，包括组织成员资格、仓库设置和计费变更。
访问审计日志
审计日志可通过您的组织设置访问。每条日志条目包含：
- 执行该操作的人
- 采取了何种类型的操作
- 更改的描述
- 位置和匿名化 IP 地址
- 操作日期和时间
您还可以将完整的审计日志下载为 JSON 文件，以便进一步分析。
通过 API 导出
编程式导出功能可在以下位置获取：
GET https://huggingface.co/api/organizations/{org}/audit-log/export请使用具有 导出审计日志 权限（org.auditLog.write）的用户访问令牌或服务账号令牌进行身份验证。响应为日志条目的 JSON 数组，与从设置页面下载的文件完全相同。与手动导出一样，该 API 调用会被记录为 org.audit_log.export。
该端点也在 OpenAPI 参考 中有文档说明。
会跟踪哪些事件？
每个操作都有一个 事件名称，格式为 scope.action（例如 repo.create、collection.delete）。这是每条日志条目以及导出的 JSON 中的 type 字段——在搜索或筛选日志时请使用该字段。
组织管理与安全
以下 Settings changes 事件仅适用于 2026 年 6 月 16 日之后执行的操作。该日期之前的事件使用唯一的
org.update_settings事件类型。任何针对 2026 年 6 月 16 日之前创建的组织过滤或解析事件type字段的集成，都应同时处理这两种类型。
- Core organization changes — 创建、删除、恢复和重命名。
- 事件：
org.create、org.delete、org.restore、org.rename
- 事件：
- Settings changes — 对组织设置的更新会记录为细粒度的
org.settings.*事件，因此您可以准确定位具体是哪项设置发生了变更。- 通用设置 — 个人资料、存储区域、资源组和发布者门控。
- 事件：
org.settings.profile、org.settings.regions、org.settings.resource_groups、org.settings.publisher_gating - 推理提供商 — 提供商配置、API 密钥的添加/移除以及使用设置。
- 事件：
org.settings.inference_providers、org.settings.inference_providers.keys.add、org.settings.inference_providers.keys.remove、org.settings.inference_providers.usage - SSO — SSO 配置更新，以及启用或禁用 SSO。
- 事件：
org.settings.sso、org.settings.sso.enable、org.settings.sso.disable - 安全 — 默认仓库可见性，以及启用或禁用 2FA 强制验证、自动加入和成员隐私设置。
- 事件：
org.settings.security.repo_visibility、org.settings.security.2fa.enable、org.settings.security.2fa.disable、org.settings.security.auto_join.enable、org.settings.security.auto_join.disable、org.settings.security.members_privacy.enable、org.settings.security.members_privacy.disable - Network — 网络配置更新，以及启用或禁用 IP 访问限制和身份验证强制。
- 事件：
org.settings.network、org.settings.network.ip_restriction.enable、org.settings.network.ip_restriction.disable、org.settings.network.auth_enforcement.enable、org.settings.network.auth_enforcement.disable
- Security management
- 组织 API 令牌轮换。
- 事件：
org.rotate_token - Token 审批系统 — 启用或禁用策略、授权请求、批准、拒绝以及撤销。
- 事件：
org.token_approval.enabled、org.token_approval.disabled、org.token_approval.authorization_request、org.token_approval.authorization_request.authorized、org.token_approval.authorization_request.revoked、org.token_approval.authorization_request.denied - SSO — 通过 SSO 进行登录和加入。
- 事件：
org.sso_login、org.sso_join
- Join settings — 基于域名的访问和自动加入配置。
- 事件：
org.update_join_settings
- 事件：
成员资格与访问控制
- Member lifecycle — 添加和移除成员、角色变更以及成员离开组织。
- 事件：
org.add_user、org.remove_user、org.change_role、org.leave
- 事件：
- Account type — 将成员转换为 外部协作者, ，或重新转换回成员。
- 事件：
org.change_account_type
- 事件：
- Invitations — 发送邀请、通过电子邮件发送邀请链接，以及用户接受邀请。
- 事件：
org.invite_user、org.invite.accept、org.invite.email
- 事件：
- Automatic joins — 通过已验证的电子邮件域名或“申请访问”加入。
- 事件：
org.join.from_domain、org.join.automatic
- 事件：
服务账号
- Service account lifecycle: 服务账号的创建和删除。
- 事件：
org.service_account.create、org.service_account.delete
- 事件：
- Service account tokens: 令牌的创建、删除、轮换和更新（名称、权限、网络安全豁免），以及与令牌配对的 S3 凭证的生成和撤销。
- 事件：
org.service_account.token.create、org.service_account.token.delete、org.service_account.token.rotate、org.service_account.token.update、org.service_account.token.s3_credential.create、org.service_account.token.s3_credential.delete
- 事件：
OAuth 应用
- OAuth app management — 创建、更新（名称、URL、权限范围或令牌过期时间）以及删除 OAuth 应用 由组织拥有的 令牌交换应用, 以及将成员的个人应用转移到组织。Logo 的更改不会被记录。
- 事件：
oauth.app.create、oauth.app.update、oauth.app.delete、oauth.app.move
- 事件：
- Client secret — 轮换客户端密钥（或为公开应用添加密钥）、删除密钥，以及 Hugging Face 使密钥过期。
- 事件：
oauth.app.secret.rotate、oauth.app.secret.delete、oauth.app.secret.expire
- 事件：
- Token issuance — 通过组织的 Token Exchange 应用向成员签发的令牌。
- 事件：
oauth.token
- 事件：
内容和资源管理
- Repository administration — 创建、删除、移动、禁用/重新启用、复制设置、DOI 移除、资源组分配以及通用仓库设置（可见性、访问控制、讨论等）。还包括 LFS 文件删除。
- 事件：
repo.create、repo.delete、repo.move、repo.disable、repo.removeDisable、repo.duplication、repo.delete_doi、repo.update_resource_group、repo.update_settings、repo.delete_lfs_file
- 事件：
- Collections — 集合的创建和删除。
- 事件：
collection.create、collection.delete
- 事件：
- Repository security — 密钥和变量（单个及批量添加/更新/删除）。
- 事件（密钥）：
repo.add_secret、repo.update_secret、repo.remove_secret、repo.add_secrets、repo.remove_secrets - 事件（变量）：
repo.add_variable、repo.update_variable、repo.remove_variable、repo.add_variables、repo.remove_variables
- 事件（密钥）：
- Spaces configuration — 存储层级变更、硬件（规格）更新以及休眠时间调整。
- 事件：
spaces.add_storage、spaces.remove_storage、spaces.update_hardware、spaces.update_sleep_time
- 事件：
资源组
- Resource group administration — 创建、删除和设置更改。
- 事件：
resource_group.create、resource_group.delete、resource_group.settings
- 事件：
- Resource group members — 添加和移除用户，以及角色变更。
- 事件：
resource_group.add_users、resource_group.remove_users、resource_group.change_role
- 事件：
- Resource group invitations — 将组织外部的用户邀请到资源组，以及撤销这些邀请。
- 事件：
resource_group.invite_user、resource_group.invite.revoke
- 事件：
作业和计划作业
- Jobs — 作业创建（例如在 Space 上）和取消。
- 事件：
jobs.create、jobs.cancel
- 事件：
- Scheduled jobs — 创建、删除、恢复、暂停和触发运行。
- 事件：
scheduled_job.create、scheduled_job.delete、scheduled_job.resume、scheduled_job.suspend、scheduled_job.run
- 事件：
账单与云集成
- Payment and customers — 更新、绑定和移除付款方式；创建客户账户。
- 事件：
billing.update_payment_method、billing.create_customer、billing.remove_payment_method
- 事件：
- Cloud marketplaces — AWS 和 GCP 市场链接/取消链接以及市场审批。
- 事件：
billing.aws_add、billing.aws_remove、billing.gcp_add、billing.gcp_remove、billing.marketplace_approve
- 事件：
- Subscriptions — 订阅的启动、续订、取消、重新激活和更新（包括套餐和合同详情）。
- 事件：
billing.start_subscription、billing.renew_subscription、billing.cancel_subscription、billing.un_cancel_subscription、billing.update_subscription、billing.update_subscription_plan、billing.update_subscription_contract_details
- 事件：
事件参考
上述列表涵盖了审计日志 UI 和导出中显示的所有事件类型。事件名称遵循 scope.action 模式；作用域包括 org、repo、collection、spaces、resource_group、jobs、scheduled_job、oauth 和 billing。导出操作本身被记录为 org.audit_log.export，但该事件不包含在默认审计日志视图中。