管理用 REST API を使用した統合サーバーの表示

IBM® App Connect Enterprise の管理用REST APIを使用すると、管理対象の統合サーバーのプロパティを表示できます。

始める前に

以下のトピックをお読みください。

手順

  • 統合サーバーのプロパティーを表示します。
    GET http://hostname:port/apiv2/servers/integrationServerName

    例えば、統合サーバー ACESERV1 のプロパティーを表示するには、以下の curl コマンドを実行します。

    curl -X GET http://hostname:port/apiv2/servers/ACESERV1
    コマンドが正常に実行されると、HTTP 状況コード 200 と、以下のような応答が返されます。
    {
        "hasChildren": true,
        "name": "ACESERV1",
        "type": "integrationServer",
        "uri": "/apiv2/servers/ACESERV1",
        "properties": {
            "brokerDefaultCCSID": "5348",
            "dataSourceName": "",
            "dataSourcePassword": "********",
            "dataSourceUserId": "LocalSystem",
            "defaultConfigurationTimeout": 300,
            "defaultQueueManager": "",
            "forceServerHTTPS": false,
            "jvmDebugPort": 0,
            "jvmMaxHeapSize": 268435456,
            "jvmMinHeapSize": 33554432,
            "lilPath": "",
            "mqTrustedQueueManager": "no",
            "name": "ACESERV1",
            "stopIfDefaultQMUnavailable": false,
            "trace": "none",
            "traceNodeLevel": true,
            "traceSize": "1G",
            "type": "IntegrationServer"
        },
        "descriptiveProperties": {
            "buildLevel": "ib000-L200318.17215 (S000-L200318.16524)",
            "platformArchitecture": "AMD64",
            "platformName": "Windows 10 Enterprise",
            "platformVersion": "6.3 build 19041 ",
            "productName": "IBM App Connect Enterprise",
            "version": "11.0.0.8"
        },
        "active": {
            "defaultApplicationName": "ACESERV1_DefaultApplication",
            "exceptionLoggingOn": false,
            "isRunning": true,
            "lastMessageEpoch": 0,
            "lastMessageTime": "1970-01-01T00:00:00Z",
            "monitoring": "inactive",
            "monitoringProfile": "",
            "processId": 24096,
            "serviceTraceOn": false,
            "startupEpoch": 1604864621,
            "startupTime": "2020-11-08T19:43:41Z",
            "state": "started",
            "userTraceOn": false
        },
        
        "links": []
    }
    
    さらに、API 呼び出しで depth 照会パラメーターを使用して、統合サーバーの他のプロパティーに関する詳細情報を取得できます。 例えば、次の curl コマンドを使用します。
    curl -X GET http://hostname:port/apiv2/servers/ACESERV1?depth=2
  • 管理対象統合サーバーのプロパティーを表示します。
    GET http://hostname:port/apiv2/servers

    例えば、次の curl コマンドを実行します。

    curl -X GET http://hostname:port/apiv2/servers
    コマンドが正常に実行されると、HTTP 状況コード 200 と、以下のような応答が返されます。
    {
        "type": "integrationServers",
        "children": [
            {
                "name": "ACESERV1",
                "hasChildren": true,
                "uri": "/apiv2/servers/ACESERV1",
                "type": "integrationServer",
                "active": {
                    "processId": 22920,
                    "isRunning": true,
                    "state": "started"
                }
            },
            {
                "name": "ACESERV2",
                "hasChildren": true,
                "uri": "/apiv2/servers/ACESERV2",
                "type": "integrationServer",
                "active": {
                    "processId": 24536,
                    "isRunning": true,
                    "state": "started"
                }
            }
        ]
    }
    
    さらに、API 呼び出しで depth 照会パラメーターを使用して、統合サーバーの他のプロパティーに関する詳細情報を取得できます。 例えば、次の curl コマンドを使用します。
    curl -X GET http://hostname:port/apiv2/servers?depth=2