Skip to main content

GET /metrics_service/subscriptions

Use this method to return information about all metrics forwarders.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/metrics_service/subscriptions

Query parameters

None

Request body

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

ParametersTypeDescription
descriptionStringDescription for the metrics forwarder
enableBooleanIndicates whether the metrics forwarder is enabled. This can be one of the following values.
  • true. (default) The metrics forwarder is enabled.
  • false. The metrics forwarder is disabled.
idStringID of the metrics forwarder
ipAddressStringIPv4 or IPv6 address or hostname of the remote system that is the target to receive the metrics. For email, this is the SMTP server.
nameStringUser-defined name for the metrics forwarder. This name must be unique for all metrics forwarders.
restPathStringResource path on which the forwarder is to post the metrics

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

The following example is returned if the request is successful.

[{
"description": "Metrics subscription",
"enable": "true",
"id": "1520009679583",
"ipAddress": "192.0.2.40",
"name": "Metrics_subscription",
"restPath": "/api/v1/metrics"
}]