# Metric: create or replace

# Description

Creates a metric with specified fields and tags or replaces the fields and tags of an existing metric.

If the metric exists, the current metric tags are replaced with metric tags specified in the request.

If the replace request for an existing metric does not contain any tags, current metric tags are deleted.

Fields that are set to null are ignored by the server and are set to their default value.

The replace request for an existing metric does not affect any series data since the internal identifier of the metric remains the same.

# Request

Method	Path	Content-Type Header
PUT	/api/v1/metrics/{metric}	application/json

# Path Parameters

Name	Type	Description
metric	string	Metric name.

# Fields

Refer to Fields specified in the Metrics List method.

The name field specified in the payload is ignored by the server since the metric name is already specified in path.

# Response

# Fields

None.

# Example

# Request

# URI

PUT /api/v1/metrics/my-metric

# Payload

{
  "enabled": true,
  "persistent": true,
  "dataType": "DOUBLE",
  "interpolate": "PREVIOUS",
  "retentionDays": 0
}

# curl

curl https://atsd_hostname:8443/api/v1/metrics/my-metric \
  -k --user {username}:{password} \
  --header "Content-Type: application/json" \
  --request PUT \
  --data '{"enabled":true,"persistent":true,"dataType":"DOUBLE","interpolate": "PREVIOUS","retentionDays":0}'

# Response

None.

# Additional Examples