Get Metric Entities

Get Metric Entities

Provides details of the metric type model belonging to one/more domain.

Request
URI
GET
https://{api_host}/tcsa.host.com/v2/catalog/metric-entities
COPY
Query Parameters
integer
offset
Optional

Offset from first result to fetch.

integer
limit
Optional

Maximum number of results per page.

string
sort_by
Optional

Sorting is allowed only on metric_type, domain and sub_domain fields, eg sort_by=metricType desc

string of array
metric_type
Optional

Metric type to be fetched.

metric_type example
RRU
string of array
domain
Optional

Domain the metric type belongs to.

domain example
5G
string of array
sub_domains
Optional

Sub-Domain the metric type belongs to.

sub_domains example
3GPP

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns MetricEntitiesResponse of type(s) application/json
{
    "total": 1,
    "page_count": 1,
    "entity": [
        {
            "domain": "5G",
            "sub_domains": [
                "3GPP",
                "vRAN"
            ],
            "description": "Metric model for RRU Radio Resource Utilization",
            "metricType": "RRU",
            "metrics": [
                {
                    "name": "Active_Time_Dl",
                    "datatype": null,
                    "description": "the time duration that gNb used to transmit bits to it's serving UEs",
                    "range": null,
                    "unit": "ms",
                    "max": null,
                    "min": null
                },
                {
                    "name": "Active_Time_Ul",
                    "datatype": null,
                    "description": "the time duration that gNb used to receive bits from it's serving UEs",
                    "range": null,
                    "unit": "ms",
                    "max": null,
                    "min": null
                }
            ],
            "properties": [
                {
                    "name": "entityName",
                    "description": "Name of the entity"
                },
                {
                    "name": "dataSource",
                    "description": "Collector Source for metrics"
                },
                {
                    "name": "deviceName",
                    "description": "Name of the device"
                },
                {
                    "name": "entityType",
                    "description": "Entity Type"
                },
                {
                    "name": "deviceType",
                    "description": "Device Type"
                }
            ],
            "tags": [
                {
                    "name": "CUCPID",
                    "description": "CUCP ID"
                },
                {
                    "name": "RUID",
                    "description": "RU ID"
                },
                {
                    "name": "DUID",
                    "description": "DU ID"
                },
                {
                    "name": "CellClusterId",
                    "description": "Cell Cluster Id"
                },
                {
                    "name": "kubernetes_namespace",
                    "description": "kubernetes namespace"
                },
                {
                    "name": "address",
                    "description": "Address"
                },
                {
                    "name": "zip",
                    "description": "Zip code"
                },
                {
                    "name": "model",
                    "description": "Model of the device"
                },
                {
                    "name": "city",
                    "description": "City"
                },
                {
                    "name": "customer",
                    "description": "Customer entity belongs to"
                },
                {
                    "name": "address",
                    "description": "Address"
                },
                {
                    "name": "region",
                    "description": "Region"
                },
                {
                    "name": "deviceCoordinates",
                    "description": "Device coordinates (Lat,Long)"
                },
                {
                    "name": "version",
                    "description": "Version"
                },
                {
                    "name": "location",
                    "description": "Location of the entity"
                },
                {
                    "name": "hostname",
                    "description": "Host name"
                },
                {
                    "name": "hypervsr",
                    "description": "Hypervisor"
                }
            ],
            "tco_internal": [
                "type",
                "colltimestamp",
                "instance",
                "processedTimestamp"
            ]
        }
    ]
}
integer As int64 As int64
total
Required

Total number of metric entities

integer As int64 As int64
page_count
Required

Total number of pages in response

entity
Optional

Describes the metricType , metics, tco internal


400

Invalid Request sent by the user

Returns ErrorDetails of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "detailedMessage": "string"
}
string
errorCode
Required

Error code for the failed request

string
message
Required

Short summary of the error occurred

string
detailedMessage
Optional

Detailed message with probable solution


401

User authentication failed

Returns ErrorDetails of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "detailedMessage": "string"
}
string
errorCode
Required

Error code for the failed request

string
message
Required

Short summary of the error occurred

string
detailedMessage
Optional

Detailed message with probable solution


403

Access to the requested resource/operation is forbidden

Returns ErrorDetails of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "detailedMessage": "string"
}
string
errorCode
Required

Error code for the failed request

string
message
Required

Short summary of the error occurred

string
detailedMessage
Optional

Detailed message with probable solution


404

Cannot find requested resource

Returns ErrorDetails of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "detailedMessage": "string"
}
string
errorCode
Required

Error code for the failed request

string
message
Required

Short summary of the error occurred

string
detailedMessage
Optional

Detailed message with probable solution


500

Internal server error

Returns ErrorDetails of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "detailedMessage": "string"
}
string
errorCode
Required

Error code for the failed request

string
message
Required

Short summary of the error occurred

string
detailedMessage
Optional

Detailed message with probable solution