5.19.3　下位マネージャー情報削除

機能

統合マネージャー配下の拠点マネージャーまたは中継マネージャーの情報を削除します。

実行権限

次の権限が必要です。

JP1資源グループ：*
JP1権限レベル：JP1_Console_Admin

APIのバージョン

形式

リクエスト行

POST /application/component/apiVersion/subManagers/deleteInfo httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

{
    "subManagers":[
        ホスト名,・・・
    ]
}

レスポンスのメッセージボディー

正常終了の場合，レスポンスはありません。

警告終了の場合，次のレスポンスを返却します。

{
    "errhostlist":[
        ホスト名,・・・
    ],
    "messageList":[
        {
            "messageId": メッセージID,
            "message": メッセージ
        },・・・
    ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター	データ型	省略可否	説明
`subManagers`	string[]	不可	下位マネージャーのホスト名の配列を指定します。ホスト名は1〜255バイトで指定します。空配列は指定できません。

パラメーター

データ型

省略可否

説明

subManagers

string[]

不可

下位マネージャーのホスト名の配列を指定します。ホスト名は1〜255バイトで指定します。

空配列は指定できません。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード	出力されるメッセージ	説明
200	−	APIの処理が成功しました。
400	KAJY68013-E	APIのリクエストが不正です。リクエスト不正が1個所見つかった時点で処理を中断します。
403	KAJY01000-E	認証に使用したユーザーの権限が不足しています。
500	KAJY68501-E	統合マネージャーの統合エージェントホスト管理DBに接続できません。
200	KAJY68500-W	下位マネージャーの統合エージェントホスト管理DBに接続できません。複数の管理マネージャーの統合エージェントホスト管理DBに接続できなかった場合は，ホスト名に各管理マネージャーホスト名を「`,`」で連結した文字列が記載されます。
200	KAJY68204-W	下位マネージャーのインテリジェント統合管理基盤に接続できません。複数のマネージャーのインテリジェント統合管理基盤に接続できなかった場合は，ホスト名に各管理マネージャーホスト名を「`,`」で連結した文字列が記載されます。
200	KAJY68016-W	下位マネージャー情報が存在しません。
200	KAJY68018-W	下位マネージャー情報の削除に失敗しました。

レスポンス

パラメーター名		データ型	省略可否	説明
`errhostlist`		string[]	可	削除に失敗した下位マネージャーのホスト名の配列が設定されます。失敗したホストがない場合は省略されます。
`messageList`		object	可	メッセージオブジェクトの配列が設定されます。メッセージが存在しない場合は省略されます。
	`messageId`	string	不可	メッセージIDが設定されます。
	`message`	string	不可	メッセージの本文が設定されます。使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容によって決まります。

使用例

リクエスト：

POST http://immhost01:20703/im/api/v1/subManagers/deleteInfo
{
    "subManagers":["hostA"]
}

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
    "errhostlist":[
      "hostA"
    ],
    "messageList":[
        {
            "messageId":"KAJY68500-W",
            "message": "インテリジェント統合管理データベースに接続できません。(JP1/IM-Managerホスト名 : hostA)"
        }
    ]
}

ページの先頭へ

5.19.3 下位マネージャー情報削除

5.19.3　下位マネージャー情報削除