5.19.2 Add lower manager info

Description

Register the information of the base manager or relay subordinate manager under the integration manager.

If information for registered subordinate managers, if specified, is updated with that information.

Only hosts registered as subordinate hosts of Integration Manager in IM Configuration Management can be specified.

Execution permissions

Following permissions are required:

• JP1 resource group: *

• JP1 permission level: JP1_Console_Admin

API version

v1

Format

Request line

POST /application/component/apiVersion/subManagers/createInfo httpVersion

Request header

Follow the request header in 5.2.3 Request format.

Request message body

Message body of the request can be sent in JSON formats.

{
    "hostname": Host-name,
    "initialsecret": Initial-secret
}

Response message body

None

Parameters

Here are the parameters that you specify for message body:

Parameter name	Data type	Optional	Description
hostname	string	No	Specify host name of lower manager in the range of 1 to 255.
initialsecret	string	No	Specify initial secret. The number of characters that can be specified is 1 to 1024, and the number of characters that can be specified is ASCII (0x20 to 0x7e).

Status codes

The following table describes the status codes that are returned as a response to the request:

Status code	Message	Description
200	--	API operation was successful.
400	KAJY68012-E	API request is invalid. The process is turned stopped when one bad request is found.
403	KAJY01000-E	The privilege of the user used for authentication is insufficient.
500	KAJY68501-E	Unable to connect to Unified Agent Host Management DB in Unified Agent Manager.
500	KAJY68203-E	Cannot connect to Intelligent Integrated Management Base on lower manager.
500	KAJY68017-E	Add of lower manager data has failed.

Return values

There is no response body.

Examples

Request:

POST http://immhost01:20703/im/api/v1/subManagers/createInfo
{
    "hostname":"hostA",
    "initialsecret": "XXXXXXXXXXX"
}

Manager host name: immhost01

Response:

< HTTP/1.1 200 OK
< Content-Type: application/json

To Page Top