部署 API

本节介绍 EMQX 部署 API 的功能以及如何创建和管理用于安全访问 API 的部署 API key。

API 功能

部署 API 管理部署层面的功能，例如用于客户端监控、消息发布，认证授权等。

API	适用部署	描述
Serverless 部署 API	Serverless 部署	管理 Serverless 部署中客户端、订阅和发布的相关操作。
专有版 (v5) 部署 API	专有版 (v5) 部署	管理专有版 (v5) 部署中的各项操作。如果需要访问和管理专有版 (v4) 部署 API，请查看 v4 API。
BYOC 部署 API （API 与专有版一致）	BYOC (v5) 部署	管理 BYOC (v5) 部署中的各项操作。

部署 API Key 用于对访问 EMQX 部署 API 的请求进行身份验证与授权。API Key 的创建与管理方式依据部署类型和版本的不同而有所差异。

对于专有版 (v5) 部署，你可以为每个 API Key 添加自定义备注，并分配细粒度的访问权限。

进入目标专有版 (v5) 部署。
在部署 API Key 区域，点击 + 新建 API Key。
在弹出的对话框中填写以下信息：
- 备注（可选）：添加描述信息，用于标识该 API Key 的用途和范围。
- API 权限：
  - 选择所需的 HTTP 方法（如 GET、POST、PUT、DELETE）。
  - 可通过关键字筛选或搜索特定 API 路径。
  - 也可使用分类级复选框，批量选择整个分类或具体 API。
点击确认后，系统将显示生成的 App ID 和 App Secret。
重要提示
App Secret 在 API Key 创建时仅显示一次，请妥善保存，一旦关闭将无法再次查看。
点击关闭退出对话框。

对于 Serverless 和专有版 (v4) 部署，API Key 将自动生成并默认拥有全部访问权限。这些部署类型不支持设置备注或配置权限。

进入目标 Serverless 或专有版 (v4) 部署。
在部署 API Key 区域，点击 + 新建 API Key。
系统将自动生成 App ID 和 App Secret，并在确认对话框中显示。
重要提示
App Secret 在 API Key 创建时仅显示一次，请妥善保存，一旦关闭将无法再次查看。
点击关闭退出对话框。

view_api_key