5.19.2 下位マネージャー情報登録
- 機能
-
統合マネージャー配下の下位マネージャーの情報を登録します。
登録済みの下位マネージャーの情報が指定された場合は,その情報で更新します。
IM構成管理で統合マネージャーの下位ホストとして登録されたホストだけが指定できます。
- 実行権限
-
次の権限が必要です。
-
JP1資源グループ:*
-
JP1権限レベル:JP1_Console_Admin
-
- APIのバージョン
-
v1
- 形式
-
- リクエスト行
POST /application/component/apiVersion/subManagers/createInfo httpVersion
- リクエストのヘッダー
-
「5.2.3 リクエスト形式」のリクエストヘッダーに従います。
- リクエストのメッセージボディー
-
リクエストのメッセージボディーは,JSONフォーマットで送信できます。
{ "hostname": ホスト名, "initialsecret": 初期シークレット }
- レスポンスのメッセージボディー
なし
- パラメーター
-
リクエストのメッセージボディーに指定するパラメーターを次に示します。
パラメーター
データ型
省略可否
説明
hostname
string
不可
下位マネージャーのホスト名を1〜255バイトで指定します。
initialsecret
string
不可
初期シークレットを指定します。
指定できる文字数は1〜1024文字で,指定できる文字はASCIIコード(0x20〜0x7e)です。
- ステータスコード
-
リクエストに対するレスポンスとして返却されるステータスコードを,次の表に示します。
ステータスコード
出力されるメッセージ
説明
200
−
APIの処理が成功しました。
400
KAJY68012-E
APIのリクエストが不正です。
リクエスト不正が1個所見つかった時点で処理を中断します。
403
KAJY01000-E
認証に使用したユーザーの権限が不足しています。
500
KAJY68501-E
統合マネージャーの統合エージェントホスト管理DBに接続できません。
500
KAJY68203-E
下位マネージャーのインテリジェント統合管理基盤に接続できません。
500
KAJY68017-E
下位マネージャー情報の登録に失敗しました。
- 戻り値
-
レスポンスボディーはありません。
- 使用例
-
- リクエスト:
POST http://immhost01:20703/im/api/v1/subManagers/createInfo { "hostname":"hostA", "initialsecret": "XXXXXXXXXXX" }
マネージャーホスト名:immhost01
- レスポンス:
< HTTP/1.1 200 OK < Content-Type: application/json