管理 REST 代理主機節點

本主題包含的資訊可協助您瞭解 REST 代理主機的使用方式、新增註冊至 REST 代理主機，以及檢視和編輯 REST 代理主機節點。

如何使用 REST 代理主機？

REST 代理將應用程式識別對應至區塊鏈成員，可讓使用者和應用程式呼叫 Oracle Blockchain Platform REST API。

Oracle Blockchain Platform 不使用原生 Hyperledger Fabric API，而是可以使用 REST 代理主機與 Hyperledger Fabric 網路互動。當您使用原生 Hyperledger Fabric API 時，會直接連線至對等體和排序器。不過，REST 代理主機可讓您透過 RESTful 協定查詢或呼叫 Fabric 鏈碼。

新增登記至 REST 代理

您可以將 Hyperledger Fabric 註冊新增至 REST 代理主機。註冊可讓使用者在沒有註冊憑證的情況下呼叫 REST 代理主機。

如果您要新增使用者至註冊，他們必須已存在於 IDCS 中，並指派給 REST_USER 角色。

使用區塊鏈平台主控台新增登記，並將 IDCS 使用者與這些登記建立關聯。登記完全在區塊鏈平台內管理，而不是在 IDCS 內管理。

如需使用者如何存取 REST 資源的相關資訊，請參閱 Oracle Blockchain Platform 的 REST API 。

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 代理主機節點屬性。

1. 移至主控台並選取節點頁籤。
2. 在節點頁籤中，移至「節點」表格，找出您要設定資訊的 REST 代理主機節點，然後按一下節點的其他動作按鈕。
3. 組態選項由您的權限決定。如果您是管理員，請找出並按一下編輯組態。如果您是使用者，請找出並按一下檢視。
   此時會顯示設定對話方塊。
4. 如果您是管理員，請視需要修改節點的提案等待時間 (毫秒) 、交易等待時間 (毫秒) 、日誌層級及交易事件記錄日誌屬性。
5. 按一下「送出」以儲存組態變更，或按一下 X 以關閉「設定」對話方塊。

檢視 REST 代理主機節點的狀況資訊

您可以檢查 REST 代理主機節點的度量，以瞭解節點在區塊鏈網路上的執行情況。此資訊可協助您尋找及診斷效能問題。

狀況窗格會顯示下列效能測量結果：CPU 使用量和記憶體使用量。

1. 移至主控台並選取節點頁籤。
2. 在節點頁籤中，按一下您要查看其狀況資訊的 REST 代理主機節點。
   隨即顯示節點資訊頁面。
3. 按一下狀況窗格，檢視節點的效能測量結果。
   如果使用率百分比一致高，請聯絡 Oracle Support。