管理 REST 代理节点

本主题包含的信息可帮助您了解如何使用 REST 代理，将注册添加到 REST 代理，以及查看和编辑 REST 代理节点。

如何使用 REST 代理？

REST 代理将应用身份映射到区块链成员，允许用户和应用调用 Oracle Blockchain Platform REST API。

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

将注册添加到 REST 代理

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

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

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

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

1. 转到控制台并选择节点选项卡。
2. 在节点选项卡中，查找要向其添加注册的 REST 代理节点，然后单击此节点的操作菜单。
3. 单击查看或管理注册可查看节点的当前注册的列表。
   此时将显示当前注册的列表。您可以删除现有注册以及从此页面添加新注册。
4. 展开创建新注册。
5. 在注册 ID 字段中，输入要添加的注册的名称。
   注册 ID 只能包含字母数字字符、连字符 (-) 和下划线 (_)。
6. （可选）在用户 ID 字段中，输入具有 REST_USER 角色的用户的 ID 以与注册关联。单击注册。
   单击注册后：

   • 注册将创建并显示在“注册”表中。
   • 新注册将复制到网络中的每个 REST 代理节点。
   • 如果指定了用户 ID，则该 ID 与注册关联，并且无法从关联的 REST 用户列表中删除。如果用户 ID 不是有效的 REST 用户，将返回错误。
   • 如果指定了用户 ID，则生成的注册证书会将该 ID 包括为 username 属性。
   • 使用基本验证的 REST API 调用不支持包含冒号 (：) 的用户 ID。
7. 在关联的 REST 客户端用户窗格中，可以查看和管理与当前注册关联的任何用户，包括从注册中删除用户。
8. 通过展开关联新用户，将另一个用户添加到注册。输入已分配有 REST_USER 角色的用户的电子邮件或 ID。单击关联。

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

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

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

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

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

查看 REST 代理节点的运行状况信息

您可以查看 REST 代理节点的度量来了解节点在区块链网络上的表现。此信息可帮助您发现和诊断性能问题。

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

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