Get Pricing Metric

client.pricingMetrics.retrieve(, ?): PricingMetricResource { id, aggregation, event_name, 3 more }

get/pricing-metrics/{pricing_metric_id}

Get Pricing Metric

ParametersExpand Collapse

pricingMetricID: string

ReturnsExpand Collapse

PricingMetricResource { id, aggregation, event_name, 3 more }

id: string

The ID of the pricing metric.

aggregation: SumAggregationPricingMetricResource { aggregation_type, value_field } | CountAggregationPricingMetricResource { aggregation_type } | MaxAggregationPricingMetricResource { aggregation_type, value_field } | LastAggregationPricingMetricResource { aggregation_type, value_field }

The aggregation function used to compute the value of the pricing metric.

Accepts one of the following:

SumAggregationPricingMetricResource { aggregation_type, value_field }

aggregation_type: "sum"

Accepts one of the following:

"sum"

value_field: string

The field to sum over.

CountAggregationPricingMetricResource { aggregation_type }

aggregation_type: "count"

Accepts one of the following:

"count"

MaxAggregationPricingMetricResource { aggregation_type, value_field }

aggregation_type: "max"

Accepts one of the following:

"max"

value_field: string

The field to get the max value of.

LastAggregationPricingMetricResource { aggregation_type, value_field }

aggregation_type: "last"

Accepts one of the following:

"last"

value_field: string

The field to get the last value of.

event_name: string

The event name that the pricing metric is computed on.

name: string

The name of the pricing metric.

unit: string

The unit of the value computed by the pricing metric.

dimensions?: Array<string> | null

The dimensions by which the events are grouped to compute the pricing metric.

Get Pricing Metric

import Lark from 'lark-billing';

const client = new Lark({
  apiKey: 'My API Key',
});

const pricingMetricResource = await client.pricingMetrics.retrieve('pricing_metric_id');

console.log(pricingMetricResource.id);

{
  "id": "pmtr_GlX5Tcm2HOn00CoRTFxw2Amw",
  "aggregation": {
    "aggregation_type": "sum",
    "value_field": "compute_hours"
  },
  "event_name": "job_completed",
  "name": "Compute Hours",
  "unit": "hours",
  "dimensions": [
    "string"
  ]
}

Returns Examples

{
  "id": "pmtr_GlX5Tcm2HOn00CoRTFxw2Amw",
  "aggregation": {
    "aggregation_type": "sum",
    "value_field": "compute_hours"
  },
  "event_name": "job_completed",
  "name": "Compute Hours",
  "unit": "hours",
  "dimensions": [
    "string"
  ]
}