GET /metrics_service/subscriptions/<id>

Use this method to retrieve information about a specific metrics forwarder.

Note: This API requires Lenovo XClarity Administrator v2.8.0 or later.


Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/metrics_service/subscriptions/<id>

where <id> is the ID of the metrics forwarder (subscription). To obtain the forwarder IDs, use GET /metrics_service/subscriptions.

Query parameters


Request body


Response codes

Code Description
200 OK
404 Not Found
500 Internal server error

Response body

Parameters Type Description
authUser String Authentication user ID if authentication is used
description String Description for the metrics forwarder
id String ID of the metrics forwarder
ipAddress String IPv4 or IPv6 address or hostname of the remote system that is the target to receive the metrics. For email, this is the SMTP server.
name String User-defined name for the metrics forwarder. This name must be unique for all metrics forwarders.
port String TCP/UDP port used for the connection
restPath String Resource path on which the forwarder is to post the metrics

The default path is /api/v1/inbound/metrics.

Response example

   "authUser": "ADMIN",
   "description": "Metrics subscription",
   "id": "1520009679583",
   "ipAddress": "",
   "name": "Metrics_subscription",
   "port": "443",
   "restPath": "/api/v1/metrics"