术语表
了解红帽 3scale API 管理中使用的术语。
摘要
让开源更具包容性
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看我们的 CTO Chris Wright 信息。
第 1 章 3scale 术语表
本节充当 3scale 平台中使用的常用术语表。以下是术语表条目的结构:
- 术语
以下一个或多个项目:
- 术语的定义,后跟一个简要的说明,另请参见指向相关术语的参考。例如:
hit:所有方法都报告到的内置指标。可以在此处添加其他顶级指标来跟踪不应增加点击数的其他使用量。另请参阅 第 1.14.4 节 “指标”。
在这种情况下,hit 与 metric 相关,因为 hit 是一个内置指标。
- 请参阅 指向该术语的首选同义词或简称术语的拼写输出版本的参考。例如:
account:请参阅 第 1.21.1 节 “租户帐户”、第 1.5.2 节 “开发人员帐户”。
在这种情况下,读取器会从 account 重定向到包含限定符的相关术语。
- 如果术语中有多个定义,每个项目都会编号。
1.1. 特殊字符
1.1.1. [Your_admin_domain]
用户创建的 admin 域.
1.1.2. [Your_API_name]
用户创建的 API。另请参阅 第 1.2.22 节 “应用程序编程接口”。
1.1.3. [Your_API_service]
1.1.4. [Your_product_name]
用户创建的产品。另请参阅 第 1.17.3 节 “产品”。
1.1.5. 3scale API 文档
基于 Open API 规范(OAS),这是记录来自红帽 3scale API 管理的 REST API 的 3scale 规范。另请参阅 第 1.2.2 节 “ActiveDocs”、第 1.16.2 节 “OpenAPI 规格”。
1.1.6. 3scale 后端
3scale API Manager 以及系统的一部分。
1.2. 一个
1.2.1. 帐户
1.2.2. ActiveDocs
基于 Open API 规范(OAS),这是一种 3scale 规范,用于记录用户创建的 REST API。API 获取交互式文档,使开发人员能够更加轻松地了解 API 并无需安装即可对其进行测试。另请参阅 第 1.1.5 节 “3scale API 文档”、第 1.16.2 节 “OpenAPI 规格”。
1.2.3. 访问令牌
允许用户通过 HTTP Basic Auth 对帐户管理 API、分析 API 和计费 API 进行身份验证的个人令牌。用户可以创建具有自定义范围和权限的多个访问令牌。另请参阅 第 1.1.5 节 “3scale API 文档”、第 1.20.2 节 “服务令牌”。
1.2.4. 管理员门户
API 提供商管理其产品并确保对其产品的访问权限的核心门户。通过此门户,API 提供程序可以通过 3scale 来配置产品集成,管理其应用计划,允许内部成员和外部客户访问,根据应用密钥限制流量,并自定义其开发人员门户。另请参阅 第 1.5.3 节 “开发人员门户”、第 1.17.3 节 “产品”。
1.2.5. 管理门户
请参阅 第 1.2.4 节 “管理员门户”。
1.2.6. API
1.2.7. APIsonator
1.2.8. API 后端
实施主机上部署的 API。另请参阅 第 1.2.22 节 “应用程序编程接口”、第 1.3.1 节 “后端”。
1.2.9. API 使用者
访问由 API 提供商管理的 API 或产品的个人、组或公司。该术语可以指组织为使用 API 而编写的软件应用。给定的组织可能具有一个或多个访问 API 的应用。另请参阅 第 1.2.12 节 “API 供应商”。
1.2.10. API 凭证
1.2.11. API 端点
1.2.12. API 供应商
拥有 API 和产品,并使用红帽 3scale API 管理提供访问它们的实体。API 提供程序可能会使其 API 可供其组织内部的其他团队访问,也可能被第三方开发人员、合作伙伴或公众访问。它可能包含一个或多个租户。另请参阅 第 1.2.9 节 “API 使用者”、第 1.21.1 节 “租户帐户”。
1.2.13. API 密钥
应用的凭证类型,允许对特定的 API 或产品发出调用。API 键是特定类型的身份验证模式。另请参阅 第 1.2.22 节 “应用程序编程接口”。
1.2.14. API Manager
请参阅 第 1.2.4 节 “管理员门户”。
1.2.15. API 方法
请参阅 第 1.14.3 节 “方法”。
1.2.16. API 产品
请参阅 第 1.17.3 节 “产品”。
1.2.17. APIcast
基于 NGINX 的 API 网关,用于将内部和外部 API 与红帽 3scale API 管理集成。APIcast 是处理 API 请求的接口,可以根据其配置来处理访问控制、速率限制、安全过滤、日志记录、路由、缓存等。另请参阅 第 1.2.22 节 “应用程序编程接口”、第 1.17.3 节 “产品”。
1.2.18. APIcast 网关
请参阅 第 1.2.17 节 “APIcast”。
1.2.19. 应用程序标识符
使用应用标识符的身份验证方法.另请参阅 第 1.2.20 节 “应用程序密钥”。
1.2.20. 应用程序密钥
使用应用密钥进行身份验证方法.另请参阅 第 1.2.19 节 “应用程序标识符”。
1.2.21. 应用
一个软件代码,用于执行某些逻辑。该应用通常会在 3scale 系统中关联有 API 的唯一凭据集合,即发送到 API 的调用的流量历史记录,以及在创建应用时捕获的元数据。应用链接到开发人员帐户。请参阅 第 1.2.9 节 “API 使用者”。另请参阅 第 1.5.2 节 “开发人员帐户”。
1.2.22. 应用程序编程接口
- 一个软件组件的接口,可以使用基于标准的技术在通信网络上快速调用。
- 编程库提供的逻辑流程、功能和方法捆绑包,作为抽象层,供其他计算机程序使用。
另请参阅 第 1.1.2 节 “[Your_API_name]”、第 1.2.17 节 “APIcast”、第 1.2.13 节 “API 密钥”、第 1.3.1 节 “后端”、第 1.6.1 节 “端点”、第 1.6.2 节 “最终用户”、第 1.14.3 节 “方法”、第 1.17.3 节 “产品”、第 1.20.1 节 “service”。
1.2.23. 身份验证
验证请求访问 API 或产品的用户或服务器的身份的过程。
1.3. B
1.3.1. 后端
- 在 API 作为产品的情况下,将一个或多个 API 捆绑在产品中。另请参阅 第 1.3.2 节 “基本 URL”、第 1.17.3 节 “产品”。
- 作为 API,请参阅 第 1.2.8 节 “API 后端”。
- 作为 3scale 组件,请参阅 第 1.1.6 节 “3scale 后端”。
1.3.2. 基本 URL
- 在 API 作为产品上下文中,后端中定义的专用端点。另请参阅 第 1.3.1 节 “后端”、第 1.6.1 节 “端点”。
- API 网关的 Integration Settings 中定义的 URL 地址。这些地址是暂存公共基础 URL 和生产公共基础 URL。
1.4. C
1.4.1. 客户端
请参阅 第 1.2.9 节 “API 使用者”。
1.4.2. CMS
请参阅 第 1.5.3 节 “开发人员门户”。
1.5. D
1.5.1. 已弃用
与某一实体(如功能或受支持的配置)相关,该配置受到支持,但不再推荐,并且可能变得过时。另请参阅 第 1.19.1 节 “删除”。
1.5.2. 开发人员帐户
- 在 3scale Hosted 中,API 提供程序认为的所有帐户都是 developer 帐户。
- 在 3scale 内部部署中,租户管理门户中的帐户被视为开发人员帐户。另请参阅 第 1.2.21 节 “应用”、第 1.21.1 节 “租户帐户”。
1.5.3. 开发人员门户
开发人员可订阅 API 的网站。在此网站上,开发人员可以管理其订阅、访问其 API、创建应用程序、访问交互式 API 文档、3scale API 文档、查看其 API 使用情况等。另请参阅 第 1.2.4 节 “管理员门户”。
1.5.4. 已停用
请参阅 第 1.19.1 节 “删除”。
1.6. E
1.6.1. 端点
通信渠道的一端。当 API 与其他系统交互时,此通信的触点被视为端点。另请参阅 第 1.2.22 节 “应用程序编程接口”、第 1.3.2 节 “基本 URL”、第 1.14.2 节 “映射规则”、第 1.14.3 节 “方法”。
1.6.2. 最终用户
调用一个或多个产品和 API 的应用用户。另请参阅 第 1.2.22 节 “应用程序编程接口”、第 1.17.3 节 “产品”。
1.7. F
1.7.1. 字段定义
创建新用户、应用程序或帐户时显示的字段。
1.8. G
1.9. H
1.9.1. hit
所有方法都报告到的内置指标。可以在此处添加其他顶级指标来跟踪不应增加点击数的其他使用量。另请参阅 第 1.14.4 节 “指标”。
1.9.2. 主机 URL
请参阅 第 1.3.2 节 “基本 URL”。
1.10. I
1.10.1. 集成错误
当使用不正确的凭据集、不正确的 ID、URL 地址等执行调用时,3scale 生成的错误消息。这些消息可能是来自调用 API 的应用的错误,也可以是与 API 集成 3scale 的配置错误。
1.11. J
1.12. K
1.13. L
1.14. M
1.14.1. 管理门户
请参阅 第 1.2.4 节 “管理员门户”。
1.14.2. 映射规则
将来自特定端点的传入调用关联到 3scale 中创建的对应方法和指标的规则。使用跟踪、端点访问和限值均基于配置了映射规则的方法和指标。另请参阅 第 1.6.1 节 “端点”、第 1.14.3 节 “方法”、第 1.14.4 节 “指标”。
1.14.3. 方法
允许的交互 - 如 GET、POST 或 DELETE- 和 API 或产品.方法用于在 3scale 中跟踪产品和 API 的使用情况。可以为 API 的 API 端点上可用的各个 HTTP 方法添加一个方法。默认情况下,在 3scale 上,方法调用会触发内置的 hits 指标。另请参阅 第 1.2.22 节 “应用程序编程接口”、第 1.6.1 节 “端点”、第 1.14.2 节 “映射规则”、第 1.14.4 节 “指标”。
1.14.4. 指标
跟踪对 API 的特定调用。此跟踪通过将调用映射到集成页面的映射规则部分中的一个或多个 URL 模式来完成。指标是累计的,不是离散的。3scale 上的内置顶级指标是 Hits。如果需要,可以添加额外的顶级指标,并对它们单独考虑。另请参阅 第 1.9.1 节 “hit”、第 1.14.2 节 “映射规则”、第 1.14.3 节 “方法”。
1.15. N
1.16. O
1.16.1. OAS
1.16.2. OpenAPI 规格
一个标准的 RESTful API 语言中立接口,允许用户和计算机发现和了解服务的功能,而无需访问源代码、文档或通过网络流量检查。另请参阅 第 1.1.5 节 “3scale API 文档”、第 1.2.2 节 “ActiveDocs”。
1.17. P
1.17.1. 计划
授予对特定 API 和端点访问权限、限制流量和货币化 API 使用的方法。3scale 有不同类型的计划,可以独立或结合使用,如应用程序计划和帐户计划。
1.17.2. 潜在的升级
触发流量限制警报的开发人员帐户。这些开发人员帐户可能会升级为满足其流量卷需求的计划。
1.17.3. 产品
一个或多个 API 后端的捆绑包。另请参阅 第 1.1.4 节 “[Your_product_name]”、第 1.2.4 节 “管理员门户”、第 1.2.17 节 “APIcast”、第 1.2.22 节 “应用程序编程接口”、第 1.3.1 节 “后端”、第 1.6.2 节 “最终用户”。
1.18. Q
1.19. R
1.19.1. 删除
与产品中不可用且不再受支持的实体相关联,如功能或受支持的配置。另请参阅 第 1.5.1 节 “已弃用”。
1.20. S
1.20.1. service
1.20.2. 服务令牌
用于通过服务管理 API 进行身份验证的密钥。这些密钥是自动生成的,每个服务都是唯一的,并在帐户的用户之间共享。使用 3scale API 文档中的服务令牌。另请参阅 第 1.2.3 节 “访问令牌”。
1.21. T
1.21.1. 租户帐户
在 3scale 内部,主管理门户将帐户视为租户帐户。另请参阅 第 1.2.12 节 “API 供应商”、第 1.5.2 节 “开发人员帐户”。
1.22. U
1.22.1. 用户密钥
请参阅 第 1.2.20 节 “应用程序密钥”。