管理 REST 代理节点

如何使用 REST 代理？

REST 代理将应用身份映射到区块链成员，这样用户和应用就可以调用 Oracle Blockchain Platform REST API。

Oracle Blockchain Platform 可以使用 REST 代理与 Hyperledger Fabric 网络进行交互，而不必使用原生的 Hyperledger Fabric API。使用本机超级账本架构 API 时，您可以直接连接到对等节点和排序节点。但是，REST 代理允许您通过 RESTful 协议查询或调用 Fabric 链代码。

向 REST 代理添加登记

您可以将超级账本架构注册添加到 REST 代理。注册允许用户在没有注册证书的情况下调用 REST 代理。

如果要将用户添加到注册，则 IDCS 中必须已存在该用户，并且该用户将被分配到 REST_USER 角色。

使用区块链平台控制台添加新注册并将 IDCS 用户与这些注册关联。注册完全在区块链平台内进行管理，而不是在 IDCS 内进行管理。

有关用户如何访问 REST 资源的信息，请参阅 REST API for Oracle Blockchain Platform 。

转到控制台并选择节点选项卡。
在节点选项卡中，找到要向其中添加注册的 REST 代理节点，然后单击此节点的操作菜单。
单击查看或管理注册可查看节点的当前注册列表。
此时将显示当前登记的列表。可以删除现有注册以及从此页面添加新注册。
展开创建新登记。
在注册 ID 字段中，输入要添加的注册的名称。
注册 ID 只能包含字母数字字符、连字符 (-) 和下划线 (_)。
（可选）在用户 ID 字段中，输入具有要与注册关联的 REST_USER 角色的用户的 ID。单击注册。
单击注册后：
- 将创建登记并在“登记”表中显示登记。
- 新注册将复制到网络中的每个 REST 代理节点。
- 如果指定了用户 ID，则该 ID 与注册关联，并且无法从关联的 REST 用户列表中删除。如果用户 ID 不是有效的 REST 用户，将返回错误。
- 如果指定了用户 ID，则生成的注册证书将 ID 包含为 username 属性。
- 使用基本验证的 REST API 调用不支持包含冒号 (：) 的用户 ID。您可以使用基本验证进行测试和内部开发。请勿在生产环境中使用基本验证。
在关联的 REST 客户端用户窗格中，可以查看和管理与当前注册关联的任何用户，包括从注册中删除用户。
通过展开关联新用户，将其他用户添加到注册。输入已分配有 REST_USER 角色的用户的电子邮件或 ID。单击关联。

创建注册并将其与用户关联后，使用 REST 在区块链上运行事务处理时，块详细信息中列出的启动器将作为新注册列出，而不是原始默认用户列出。

查看和编辑 REST 代理节点配置

REST 代理节点的配置确定节点在网络上的执行和行为方式。

只有管理员可以更改节点的配置。如果您具有用户权限，则可以查看节点的配置设置。请参见REST Proxy Node Attributes 。

转到控制台并选择节点选项卡。
在节点选项卡中，转到“节点”表，找到所需的配置信息的 REST 代理节点，然后单击节点的更多操作按钮。
配置选项由您的权限确定。如果您是管理员，请找到并单击编辑配置。如果您是用户，请找到并单击查看。
此时将显示配置对话框。
如果您是管理员，请根据需要修改节点的建议等待时间（毫秒）、事务处理等待时间（毫秒）、日志级别和事务处理事件日志记录属性。
单击提交以保存配置更改，或单击 X 以关闭配置对话框。

查看 REST 代理节点的健康状况信息

您可以检查 REST 代理节点的度量以查看节点在区块链网络上的执行方式。此信息可帮助您发现和诊断性能问题。

Health 窗格显示以下性能度量：CPU 占用率和内存使用率。

转到控制台并选择节点选项卡。
在节点选项卡中，单击要查看其运行状况信息的 REST 代理节点。
此时将显示 Node Information（节点信息）页面。
单击运行状况窗格以查看节点的性能度量。
如果利用率百分比一直很高，请与 Oracle 技术支持联系。