carto-manage-platform

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

carto-manage-platform

carto-manage-platform

Org-level operations: managing users and invitations, monitoring quotas, auditing activity, and superadmin bulk ops on resources. Most of these commands require Admin or Superadmin role; non-admin users will see permission errors.
组织级操作:管理用户与邀请、监控配额、审计活动,以及超级管理员对资源的批量操作。这些命令大多需要管理员或超级管理员角色;非管理员用户会看到权限错误。

When to use this skill

何时使用此技能

  • Provisioning or removing team members.
  • Auditing who did what (security review, debugging unexpected changes).
  • Monitoring API and LDS quota consumption.
  • Rotating ownership of orphaned resources after a user leaves.
  • Bulk-deleting test resources.
For querying activity data interactively (the exploratory side), use
carto-query-datawarehouse/references/activity-queries.md
. This skill is for the operational/admin surface around activity data.
  • 配置或移除团队成员。
  • 审计操作记录(安全审查、调试意外变更)。
  • 监控API和LDS配额消耗。
  • 用户离职后转移孤立资源的所有权。
  • 批量删除测试资源。
如需交互式查询活动数据(探索性场景),请使用
carto-query-datawarehouse/references/activity-queries.md
。本技能针对活动数据相关的运维/管理操作场景。

Quick reference

快速参考

bash
undefined
bash
undefined

Org overview (users, resources, quotas, AI limits)

组织概览(用户、资源、配额、AI限制)

carto org stats
carto org stats

User management

用户管理

carto users list --all --json carto users invite alice@example.com --role Builder carto users get alice@example.com
carto users list --all --json carto users invite alice@example.com --role Builder carto users get alice@example.com

Activity audit (Enterprise Large+)

活动审计(仅限Enterprise Large+版本)

carto activity export
--start-date 2026-04-01 --end-date 2026-04-28
--output-dir ./apr-2026
carto activity export
--start-date 2026-04-01 --end-date 2026-04-28
--output-dir ./apr-2026

Superadmin bulk

超级管理员批量操作

carto admin list maps --all carto admin batch-delete carto admin transfer
undefined
carto admin list maps --all carto admin batch-delete carto admin transfer
undefined

What's in this skill

本技能包含内容

TopicReference
org stats
and quota monitoring
references/org-and-quotas.md
users
lifecycle: list, invite, role changes, deletion with handoff
references/users-and-invites.md
admin
superadmin ops: bulk list, batch delete, resource transfer
references/admin-bulk-ops.md
Activity event-type catalog (150+ events; full reference)references/activity-event-reference.md
Advanced activity analyses (success rates, trends, by-category)references/advanced-analyses.md
Activity-data troubleshooting (DuckDB install, plan gates, TLS)references/activity-troubleshooting.md
主题参考文档
org stats
与配额监控
references/org-and-quotas.md
users
生命周期:列表、邀请、角色变更、带交接的删除
references/users-and-invites.md
admin
超级管理员操作:批量列表、批量删除、资源转移
references/admin-bulk-ops.md
活动事件类型目录(150+种事件;完整参考)references/activity-event-reference.md
高级活动分析(成功率、趋势、按分类)references/advanced-analyses.md
活动数据故障排除(DuckDB安装、版本限制、TLS)references/activity-troubleshooting.md

Always-on guidance

通用指导

  • Admin permission gates are warehouse-style, not CARTO-style. Even a CARTO Admin will get "permission denied" from
    users delete
    if the receiver-id isn't valid. Pass valid emails or user IDs; check via
    users get
    first.
  • users delete
    requires a receiver
    to inherit the deleted user's resources. Without a receiver argument, the command fails. Plan handoff before deletion:
    carto users delete <departing-user> <receiving-user>
    .
  • Activity export is plan-gated. Enterprise Large+ only. Lower plans get a 403; surface that politely if the user is on the wrong tier.
  • org stats
    shows what you can see
    . Some fields (AI limits, billing) only render for Admin/Superadmin. Don't assume the absence of a field means the resource doesn't exist.
  • Bulk operations are irreversible.
    admin batch-delete
    deletes the listed resource IDs without further confirmation per item. Double-check the input list, or do a dry-run with
    admin list
    first.
  • Audit trail comes from
    activity
    events
    , not the CLI return values. To answer "who deleted map X", query the
    MapDeleted
    events — see the activity-queries reference.
  • 管理员权限限制遵循数据仓库规则,而非CARTO规则。 即使是CARTO管理员,如果接收者ID无效,执行
    users delete
    也会收到“权限拒绝”提示。请传入有效的邮箱或用户ID;可先通过
    users get
    检查。
  • users delete
    需要指定接收者
    以继承被删除用户的资源。如果没有接收者参数,命令会执行失败。删除前请规划好交接:
    carto users delete <离职用户> <接收用户>
  • 活动导出受版本限制。 仅限Enterprise Large+版本。低版本用户会收到403错误;如果用户使用的是错误版本,请友好提示。
  • org stats
    显示的是您有权查看的内容
    。部分字段(AI限制、账单)仅对管理员/超级管理员可见。不要假设某个字段不存在就意味着对应资源不存在。
  • 批量操作不可撤销。
    admin batch-delete
    会直接删除列出的资源ID,不会逐个确认。请仔细检查输入列表,或先通过
    admin list
    进行试运行。
  • 审计追踪来自
    activity
    事件
    ,而非CLI返回值。要查询“谁删除了地图X”,请查看
    MapDeleted
    事件——参考活动查询文档。