Quicknode 高级账户和团队管理

概述

随着你的组织规模扩大，你将面临两个截然不同的挑战：人员管理和资源管理。

• 人员管理：你有多个需要特定权限和隔离的内部团队（例如，钱包团队、云团队、开发运维团队）。
• 资源管理：你在不同的网络中有数百个端点，需要对其进行组织、过滤和跟踪以了解使用成本。

如果没有清晰的结构，大型帐户通常会遇到以下问题：

• 团队看到他们不拥有的资源
• 意外更改关键基础设施的风险增加
• 难以快速找到正确的端点
• 团队或项目对使用量的可见性有限

在本指南中，你将学习如何组织大型 Quicknode 帐户，以便团队只看到与他们相关的内容，资源保持易于管理，并且可以清晰地监控和报告使用情况。

你将需要什么

• 一个企业级 Quicknode 帐户 （RBAC 仅适用于 企业计划）
• 熟悉 Quicknode 仪表板 和基本资源管理
• 熟悉 RBAC

你将做什么

• 设计账户组织策略（标签分类法）
• 使用 标签 在网络中逻辑地对端点进行分组
• 配置 团队可见性 以隔离敏感基础设施
• 使用 Console API 以编程方式标记端点
• 监控和导出使用数据以进行内部报告

关键概念

在深入实施之前，让我们先明确你将用来组织帐户的两个主要工具。

团队 是你的 Quicknode 帐户中的用户组。每个团队成员都分配有一个 RBAC 角色（管理员、结算 或 查看者），该角色决定了他们可以执行的操作。 团队还控制端点可见性。

标签 是你附加到端点的元数据标签，用于组织和过滤。与团队分配（控制访问权限）不同，标签纯粹是组织性的。 它们可以帮助你对端点进行分类、搜索和报告。

这些工具用途不同，并且协同工作：标签可帮助你组织和过滤资源，而团队分配控制谁可以查看和交互。 要更深入地了解 RBAC 角色和团队管理基础知识，请参阅 团队管理和 RBAC 指南。

为什么账户组织很重要

如果没有有意的结构，企业Quicknode账户将变得难以管理。 团队成员会看到他们不需要的资源，从而更难找到他们想要的内容。 访问控制要么过于宽松（每个人都可以修改所有内容），要么过于严格（管理员成为日常任务的瓶颈）。 使用数据可用，但无法执行，因为无法将消耗归因于特定团队或项目。

适当的组织可以带来三个关键好处：

1. 安全和访问控制 确保团队只能访问与其工作相关的资源，从而降低意外修改或暴露于敏感配置的风险。

2. 运营效率 意味着团队成员可以快速找到他们的资源，而无需浏览不相关的项目。

3. 成本可见性 使你可以将资源消耗归因于特定团队或项目，以进行内部计费和容量规划。

RBAC 角色、标签和基于团队的可见性的结合使你可以灵活地实现这些优势，而无需管理多个帐户的开销。

使用标签组织资源

第一步是设计一个 分类法。 这是一种命名约定，用于定义如何对资源进行分组。 一致的策略对于以后准确的过滤和报告至关重要。

选择分类策略

大多数企业使用以下模式之一：

标签命名的最佳实践

• Key:Value 格式： 使用冒号创建层次结构（例如，env:prod 比 production 更好）。
• 一致性： 选择一个术语并坚持使用（例如，不要混合使用 stage 和 staging）。
• 小写： 保持标签小写，以避免过滤期间出现区分大小写的问题。
• 文档： 维护一份共享文档，概述你的标签约定，供团队参考。

通过仪表板管理资源

本节介绍如何使用 Quicknode 仪表板界面组织和管理资源。

将标签应用于端点

确定正确的分类法后，你就可以开始通过仪表板将标签应用于端点。

1. 导航到 端点列表 并选择一个端点。
2. 在端点详细信息面板中，找到 标签。
3. 键入你的标签（例如，env:prod）并按 Enter。
4. 对所有相关标签重复执行。

将团队分配给端点

只能通过主端点列表上的“设置”选项将端点分配给团队，而不能从单个端点页面分配。

1. 导航到你的 端点 页面。
2. 单击要分配给团队的端点旁边的三个点 (⋯)。
3. 从下拉菜单中选择 添加到团队。
4. 选择要将端点分配给的团队。
5. 单击 更新。

对要分配给团队的每个端点重复此过程。

通过 Console API 管理资源

对于管理大量端点的组织，Console API 支持以编程方式进行管理。 这种方法非常适合自动化和扩展，超越了手动仪表板操作。

以编程方式标记端点

检索当前标签

要查看端点或所有端点上的现有标签，请使用 获取端点标签 或 获取所有端点 端点：

curl -X GET "https://api.quicknode.com/v0/endpoints/{endpoint_id}/tags" \
  -H 'accept: application/json' \
  -H "x-api-key: YOUR_API_KEY"

## or
curl -X 'GET' \
  'https://api.quicknode.com/v0/endpoints' \
  -H 'accept: application/json' \
  -H 'x-api-key: YOUR_API_KEY'

将标签添加到端点

要以编程方式添加标签，请使用 添加端点标签 端点：

curl -X POST "https://api.quicknode.com/v0/endpoints/{endpoint_id}/tags" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "env:prod"
}'

你可以自动化什么

Console API 支持：

• 创建和更新端点
• 检索端点详细信息和指标
• 管理标签（如上所示）
• 设置端点和方法级别的速率限制
• 配置安全设置
• 监控使用情况并检索发票
• 还有更多...

对于拥有数百个端点的帐户，自动化这些操作可以节省大量时间并确保一致性。

提示： 对实时端点监控感兴趣？ 查看 使用 Prometheus Exporter 监控 RPC 基础设施 指南。

当前 API 限制

与团队相关的功能当前无法通过 Console API 使用。 将端点分配给团队、管理团队成员资格和配置 RBAC 设置必须通过仪表板界面完成。

这意味着初始团队设置和端点分配需要手动仪表板工作。 但是，一旦建立了团队结构，就可以完全自动化正在进行的端点管理（创建、标记、监控）。

控制团队可见性和访问权限

虽然标签可以帮助你组织和筛选端点，但团队分配可以控制谁可以看到它们。 本节介绍 RBAC 角色和团队可见性如何协同工作以提供访问控制。

在本指南中，我们不会详细介绍 RBAC 角色（管理员、结算或查看者）。 有关更多信息，请参阅 团队管理和 RBAC 指南。

团队分配决定了用户可以看到哪些端点。 默认情况下，未分配团队的端点对你帐户中的所有用户可见。 将端点分配给特定团队后，它将仅对该团队的成员可见。

这两个概念协同工作。 例如，Wallet 团队 上的 查看者 可以看到 Wallet 团队端点，但无法修改它们。 Cloud 团队 上的 管理员 可以完全管理 Cloud 团队端点，但不会看到专门分配给其他团队的端点。

注意： 管理员 用户只能看到分配给他们团队的端点，就像其他角色一样。 要查看帐户中的所有端点，管理员必须是所有团队的成员或查看未分配的端点。

团队分配步骤在上面的 通过仪表板管理资源 部分中介绍。

有效地使用过滤器

即使基于团队的可见性限制了用户看到的内容，过滤器也可以帮助你在可访问的端点内导航。 Quicknode 仪表板提供了几个协同工作的过滤维度。

可用过滤器

• 网络 按区块链和网络类型过滤。 选择 以太坊主网、Solana Devnet 或任何其他受支持的网络以缩小你的视图。
• 状态 仅显示特定状态下的端点，例如 活动 端点。
• 标签 按你的自定义标签过滤。 选择特定标签或多个标签以查找具有这些标签的端点。
• 标签 如果你将端点标签与标签一起使用，则按端点标签过滤。

过滤器与 AND 逻辑结合使用。 选择 以太坊主网 和标签 env:prod 仅显示也被标记为生产环境的以太坊主网端点。

监控使用情况和报告

对于企业帐户，对使用情况的可见性与对基础设施的可见性同样重要。 使用情况 选项卡允许你使用之前定义的标签执行成本归属。

1. 导航到 使用情况 & 结算 选项卡。
2. 应用标签过滤器（例如，project:dex）。
3. 使用情况图表现在仅反映具有该标签的端点消耗的 API 积分。

提示：你还可以将使用情况数据导出到 CSV 文件以进行进一步分析。

实际例子

让我们演练一下如何建立一个拥有三个团队的组织：Wallet、Cloud 和 基础设施。 每个团队都需要对其端点的隔离访问，并共享对某些通用基础设施的可见性。

步骤 1：定义你的标签分类法

在创建任何分配之前，先建立标签：

• 团队所有权：owner:wallet、owner:cloud、owner:infra
• 环境：env:prod、env:staging、env:dev
• 项目：project:dex、project:indexer、project:mobile-wallet

步骤 2：创建团队

如果尚未创建，请在仪表板中设置你的团队：

• Wallet 团队
• Cloud 团队
• 基础设施团队

然后，邀请用户加入他们各自的团队，并分配适当的 RBAC 角色。

步骤 3：标记所有端点

将标签一致地应用于所有端点。 例如，Wallet 团队用于 DEX 项目的生产环境以太坊主网端点将收到：env:prod、owner:wallet 和 project:dex。

步骤 4：将端点分配给团队

从“端点”列表中，使用“设置”将每个端点分配给其拥有团队：

• Wallet 团队端点 → 分配给 Wallet 团队
• Cloud 团队端点 → 分配给 Cloud 团队
• 基础设施团队端点 → 分配给基础设施团队
• 共享基础设施端点 → 保持未分配状态（对所有用户可见）

步骤 5：验证配置

要求每个团队成员登录并验证他们是否只看到他们分配的端点。 检查过滤器在每个团队视图中是否正常工作。

步骤 6：设置使用情况监控

设置标签后，导航到“使用情况”标签，并按团队标签（例如，owner:wallet）过滤，以验证你是否可以生成每个团队的消耗报告。 导出示例 CSV 以确认数据格式满足你的报告需求。

结论

管理大型 Quicknode 帐户不需要为每个团队单独设置帐户。 通过结合使用 RBAC 角色、基于团队的端点可见性和周密的标签策略，你可以为每个团队提供对其资源的隔离访问，同时保持集中管理和结算。

本指南介绍了设计组织策略、实施标签和团队分配、有效地使用过滤器以及监控使用情况以进行成本分配。 借助这些工具，你的企业帐户可以随着组织的增长而干净地扩展。

有关基本概念，请查看 团队管理和 RBAC 指南。 要大规模自动化端点管理，请探索 Console API 指南。 有关实时监控仪表板，请参阅 如何构建 Grafana 仪表板。

如果你有任何疑问或需要帮助实施这些模式，请通过我们的 Discord 服务器联系我们。 请通过关注我们的 X 和我们的 Telegram 公告频道 了解最新信息。

我们 ❤️ 反馈！

如果你对新主题有任何反馈或要求，请 告诉我们。 我们很乐意听到你的声音。

• 原文链接： quicknode.com/guides/qui...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～