2.3.2　コレクターの情報取得

指定したコレクターの情報を取得します。

権限

Admin, Modify

APIのバージョン

リクエスト形式

GET http[s]://host:port/Analytics/version/objects/Collectors/{id}

リクエストボディー

リクエストボディーには何も設定しません。

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。

Collector

{
        "instanceID":"...",
        "name":"...",
        "collectorType":"...",
        "osType":"...",
        "autoCollectionType":"...",
        "connectResult":"...",
        "refreshStatus":"...",
        "message":"...",
        "lastRefreshed":"...",
        "refreshDateForInventory":"...",
        "refreshDateForPerformance":"...",
        "numOfHypervisors":"...",
        "numOfVms":"...",
        "numOfApplications":"...",
        "collectorCredentials":[{
            "ipAddress":"...",
            "userId":"...",
            "portNumber":"...",
            "hypertextTransferProtocolType":"...",
            "domainName":"...",
            "useAdministrativeShares":"...",
            "shareName":"...",
            "sharedFolder":"...",
            "logicalHostName":"...",
            "useLogicalHostName":"..."
        },
        :
        ],
        "productName":"...",
        "providerName":"...",
        "refreshDateForApp":"..."
}

Collector (Type: Collector)

属性	データ型	説明
instanceID	long	インスタンスを特定するID
name	string	コレクターの名称
collectorType	enum	コレクターの種別 (指定可能な値は「列挙型一覧」のProtocolTypeの表を参照してください。) 以下に示す値のみ指定可能です。 VCENTER AJS PFM IM
osType	enum	コレクターのOS種別。コレクターの種別(collectorType)が「AJS」，「PFM」，「IM」の場合のみ指定します (指定可能な値は「列挙型一覧」のCollectorOsTypeの表を参照してください。)
autoCollectionType	enum	コレクターの定期実行の設定 (指定可能な値は「列挙型一覧」のConnectTypeの表を参照してください。) 以下に示す値のみ指定可能です。 AutoConnect NotAutoConnect
connectResult	enum	コレクターの最新の実行結果 (指定可能な値は「列挙型一覧」のConnectStatusTypeの表を参照してください。) 以下に示す値のみ指定可能です。 NoConnect Succeeded Failed
refreshStatus	enum	コレクターの実行状態 (指定可能な値は「列挙型一覧」のConnectStatusTypeの表を参照してください。) 以下に示す値のみ指定可能です。 NoConnect InProgress
message	string	コレクターの実行結果のメッセージ
lastRefreshed	dateTime	最終リフレッシュ日時
refreshDateForInventory	dateTime	構成情報のリフレッシュ日時
refreshDateForPerformance	dateTime	性能情報のリフレッシュ日時
numOfHypervisors	int	コレクターにより発見されたハイパーバイザーの数
numOfVms	int	コレクターにより発見された仮想マシンの数
numOfApplications	int	コレクターにより発見されたアプリケーションの数
collectorCredentials	CollectorCredential[]	監視対象の接続に使用する認証情報
productName	string	収集対象製品名
providerName	string	コレクター作成者
refreshDateForApp	dateTime	定義反映日時

collectorCredentials (Type: CollectorCredential)

属性	データ型	説明
ipAddress	string	管理ソフトウェアへの接続に使用するIPアドレスまたはホスト名
userId	string	管理ソフトウェアへの接続に使用するユーザーID。255byte以下の文字列を指定します。
portNumber	int	管理ソフトウェアへの接続に使用するポート番号。
hypertextTransferProtocolType	enum	管理ソフトウェアへの接続時にSSL(https)を使用するかどうか。 (指定可能な値は「列挙型一覧」のHypertextTransferProtocolTypeの表を参照してください。) 以下に示す値のみ指定可能です。 HTTP HTTPS
domainName	string	ドメイン名。アプリケーション連携でWindows選択時に使用。
useAdministrativeShares	boolean	管理共有を行う場合にtrueを設定する
shareName	string	共有名
sharedFolder	string	共有フォルダのパス
logicalHostName	string	論理ホスト名
useLogicalHostName	boolean	論理ホスト名を使用する場合にtrueに設定する

ステータスコード

HTTPステータスコード	Reason phrase	説明
200	OK	正常終了
401	Unauthorized	ログイン権限がない
403	Forbidden	参照権限がない
404	Not Found	リソースが存在しない
412	Precondition Failed	サーバーが起動していない
500	Internal Server Error	サーバーサイドエラー

使用例

[Request Header]
GET /Analytics/v1/objects/Collectors/0 HTTP/1.1
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: curl/7.33.0
Host: localhost:22015
Accept: application/json
Accept-Language: ja


[Response Header]
HTTP/1.1 200 OK
Date: Fri, 27 Nov 2015 07:19:44 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
WWW-Authenticate: HSSO d81476c07bc464b6d3c785f80b0b87eb0549f62_WVlGcHsLfg5ffg0I_V0810
X-Frame-Options: SAMEORIGIN
Transfer-Encoding: chunked
Content-Type: application/json


[Response Body]
{
  "instanceID" : 0,
  "name" : "172.17.17.115",
  "collectorType" : "VCENTER",
  "autoCollectionType" : "AutoConnect",
  "connectResult" : "Succeeded",
  "refreshStatus" : "NoConnect",
  "lastRefreshed" : "2015-11-27T16:18:41.710+09:00",
  "refreshDateForInventory" : "2015-11-27T15:25:04.098+09:00",
  "refreshDateForPerformance" : "2015-11-27T16:18:41.710+09:00",
  "numOfHypervisors" : 2,
  "numOfVms" : 27,
  "numOfStorages" : 0,
  "collectorCredentials" : [ {
    "ipAddress" : "172.17.17.115",
    "userId" : "Administrator",
    "portNumber" : 443,
    "hypertextTransferProtocolType" : "HTTPS"
  } ]
}

2.3.2 コレクターの情報取得

2.3.2　コレクターの情報取得