管理 REST 代理主機節點

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

如何使用 REST 代理主機？

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

Oracle Blockchain Platform 可以使用 REST 代理主機與 Hyperledger Fabric 網路互動，而不使用原生的 Hyperledger Fabric API。當您使用原生 Hyperledger Fabric 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 代理主機節點屬性。

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

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

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

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

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