【HULFT10 API Gatewayの歩き方】③ホスト（HULFT）の登録、接続方法

この【HULFT10 API Gatewayの歩き方】シリーズは、
「HULFTは知っているけど、HULFT10 API Gatewayって何？どう操作するの？」
といった方に向けた実践ガイドブックです。

ぜひご自身でも実際にHULFT10 API Gatewayを操作してみてください！
他のシリーズはこちら👉[【HULFT10 API Gatewayの歩き方】シリーズまとめ](https://qiita.com/shiori_n/items/13040029fe8af44c2659)

## 紹介で使用している製品
HULFT10 API Gateway v10.2.1

## 今回のテーマ：ホスト設定（接続HULFTの設定）
この章を読み進めることで、ホストの登録の流れや、接続方法についてマスターできます。
<sub>※少し記事が長いためインデックスの活用を推奨いたします。</sub>
1. ホスト一覧画面
1. ホスト登録・接続
1. フォルダー・ラベルの定義
1. 接続テスト・状態ステータス
1. ホスト削除

:::note warn
以下の操作は、<b>「member」権限では操作できません。</b>
* ホストの登録・編集・削除
* 「ホストの登録」 画面、「ホスト情報」画面にある「接続テスト」
* フォルダー・ラベルの作成・編集・削除
:::


##  1. ホスト一覧画面
ログインして最初のページが「すべてのホスト」画面です。
![画像2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/1c050072-5760-4497-b4c7-2a4cb74d0a62.png)


❶ホスト一覧：登録したHULFTの接続先ホストの一覧が表示されます。
❷ホストの管理：「すべてのホスト」をクリックするとホストの一覧画面が表示されます。
　　　　　　　　「ホストを登録」をクリックするとホストの新規登録ができます。
❸フォルダー管理：分類するときに使用できます。
❹ラベル管理：色別に分類することができます。
❺検索：ホスト名で検索ができます。
❻更新：一覧の情報を最新状態に更新できます。

✅ **ホストの一覧画面の見方についてわかりました！**

## 2. ホスト登録・接続
さっそく「登録」ボタンから、HULFTを登録してみましょう！
![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/a45b74a7-1bd9-4a04-b6e5-93d3da6ffcef.png)


<br>

「必須」と書かれている入力欄を埋めていきます。
![画像2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/837a7d4b-eba7-4563-96f7-39266614f1db.png)



:::note info
**接続テスト**
上部の項目を埋めると押下できるようになり、
登録前に正しい情報か、もしくはHULFT API Gatewayから接続できる環境か
テストを行うことができます。

![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/967abb79-8dd4-42aa-9bef-dcd2c7c1c273.png)

:::

<br>

✅ **画面下部にある「保存」をクリックすると、ホストの登録が完了します！**
![画像6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/9b022e33-a269-4041-9961-37503e63f48d.png)

<br>

登録したホスト名をクリックすると、HULFTへ接続でき、HULFT管理画面が開きます。
![画像1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/87025bc5-c834-44a6-891b-9b0a54c39801.png)

↓

![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/fcbc4b3a-e8c7-46d1-ae29-a18e489246e5.png)
✅ **HULFTに接続できました！**

:::note info
**ホストの編集・詳細**の確認は右部にある「編集」ボタンから行ってください！

![画像9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/1a86b098-9193-4936-ad74-e85141dcd495.png)

:::


:::note warn
必須項目を埋めるだけだとホスト名が簡素的で、少々わかりづらいかもしれません。
特に同じホスト名でポート番号が違う場合などは「表示名」を設定することをおすすめします！
:::


### 💡Point
**どんなホスト名か一目でわかるように「表示名」をつける！**
![画像8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/24748e94-9223-4b08-a10e-d300c4c98f57.png)

こちらは開発メンバーがテスト・検証で使用しているHULFTを管理している一例です。
ホストの数が少ないのでわかりづらいですが、
名前がわかりやすいと**一目でどのホストか認識しやすい**です！

上記のような設定を行うには、「ホストの登録」画面または「ホスト情報」画面の<b>「表示設定」</b>から行うことができます。

#### ▼ 表示設定
**❶表示名**：ホスト一覧で表示される名前です。
![画像9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/871351f7-9e06-4444-94fa-02c1f13df736.png)

***

**❷フォルダー**：初回は未設定のため、フォルダーを新規作成します。
![画像10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/30dd2f0a-cf40-4a40-9c54-cacfd8e83e64.png)

<br>

フォルダー名を入力し、保存をクリックします。
![画像11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/eb85878e-c84d-40fe-b55d-87868535240a.png)

***

**❸ラベル**：デフォルトで3色選択することができます。
![画像1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/d0b9ca23-0aa9-418f-8e81-98a9c41877e5.png)

※ラベルの色や名前の変更など設定方法については[付録]()でご確認ください。


***

※**コメント**：ホストの詳細などを残しておくことができます。（一覧には表示されません。）
![画像5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/180e3085-ddb8-4519-b671-5b47e8d49611.png)





## 3. フォルダー・ラベルの定義
これまでの説明でも何度か出てきましたが、「分類・区別」のために使用することができます。
この二つにはそれぞれ特徴があります。

✅ **以下がフォルダー・ラベルの違いです！**
<table>
  <tr>
    <th>  </th> <th style="text-align: center"> 特徴 </th>
  </tr>
  <tr>
    <th> フォルダー </th> <td>フォルダーの名前で識別</td>
  </tr>
    <tr>
    <th> ラベル </th> <td> 7色から選択でき、色によって識別 </td>
  </tr>
</table>


### 💡Point
✅ **以下がフォルダー・ラベルの定義方法の例です！**

①
フォルダー：管理者の名前
ラベル　　：ホストのOS名

②
フォルダー：部署名
ラベル　　：運用者の名前

③
フォルダー：利用用途名
ラベル　　：メンテナンスの曜日

***

▼①を例に説明いたします。

例えば、以下のようにホストが登録されている場合、
ホスト名が似ているため、少し認識しづらいです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/0e9bbaf2-5489-49db-8c6c-cba99dd2d5e2.png)

<br>

そこでフォルダーでフィルタリングすると・・・↓
![画像1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/9ea0dbf0-58e8-4b26-aee2-c74c8ea52715.png)
**「管理者A」を設定しているホストのみ表示してくれます！**
また、ラベルの色でOSの違いが識別しやすいです！

***

もしくはラベルでフィルタリングすると・・・↓
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/b136a401-a6d1-42da-85a3-35a7ad706b10.png)
**OSごとの管理が行いやすいです！**

これはあくまでも一例です。
他にも、ラベルは同じ色で異なる名前をつけることもできます。
このような機能を活用した例もありましたら、ぜひコメントで教えてください！



## 4. 接続テスト・状態ステータス
一覧にある「状態」についての説明です。
こちらは一覧を表示したまま選択したホストに対し「接続テスト」を行うと、
ホストとの接続状況を確認できるものです。

**【Before】**
一覧を開いてから一度も「接続テスト」をしていないと「状態」は「-」となっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/6bca1b45-bde9-44d7-b68c-3b53305f265d.png)

↓

❶一番上のチェックボックスでホストを全選択します。
❷「接続テスト」ボタンをクリックします。
![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/c47fd981-f59e-4ea5-915f-24a7138afd58.png)

↓


✅ **ホストの接続状況を確認できました！**
![画像4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/656e9f4a-e40a-4d14-b33e-e24830e43eaf.png)



## 5. ホスト削除
最後にホストの削除方法をご紹介します。

ユーザーの時と同様の方法で削除できます。
![画像5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/64f28494-3792-4d9e-bb0f-0ef6cceb60ae.png)

:::note info
チェックボックスを複数選択することで、選択したホストを一度に削除できます！
:::

✅ **ホスト「テスト」を削除できました！**

## まとめ
今回はホストの登録～削除までの一連の流れを操作しました！
✅ ホストの一覧画面を開く
✅ ホストを登録する
✅ フォルダー・ラベルの違い・定義方法についてを知る
✅ ホスト一覧からホストへの接続状況を知る
✅ ホストを削除する

次回は「～HULFTを操作～ 管理情報作成」などをご説明いたします！

📢「こんなこと知りたい！」などリクエストがあればぜひコメントをお寄せください。


## 付録
### ①フォルダーの編集画面の使い方
「フォルダーの編集」から以下の操作もできます！

* フォルダーの追加
* 既存のフォルダーの名前変更
* フォルダーの削除
* フォルダーの順番入れ替え
![画像12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/6fa54aa2-0572-4583-8c0a-d194639a7965.png)
    * ドラッグ＆ドロップで2つ以上の移動も簡単にできます。
    * 微調整したい場合は矢印をクリックすることで任意の位置にずらせます。



### ②ラベルの設定方法
ラベルの色と名前を設定します
![画像13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/70170078-bffb-4be4-bca4-daabca65e603.png)
<br>
一番上のラベルの**色**と**ラベルの名前**を変更し、その他のラベルは削除します。
![画像14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/1197bd3d-bf65-4626-9a7d-aa91fe63ee82.png)


↓

![画像15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/2bf47ea5-1c5b-4df0-b57e-008ebcdc057e.png)

:::note info
「ラベルを編集」では以下の操作が可能です！

* ラベルの追加
* 既存のラベルの色・名前の変更
* ラベルの削除
:::

<br>

ラベルが設定されると一覧画面、HULFT接続後の管理画面に反映されます。

<sub>HULFT管理画面上部のホスト名が表示されている箇所が、設定したラベルの色になります。</sub>
![画像8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/aaa19663-68c6-440b-9148-8560a42c2589.png)