時系列データベース (TSDB) から時系列を削除します。
エンドポイント
| パス | メソッド |
|---|---|
/api/delete_meta | POST |
リクエスト本文
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
metric | 文字列 | はい | 削除対象の時系列のメトリック名です。 |
tags | オブジェクト | いいえ | 削除対象の特定の時系列を識別するタグのキーと値のペアです。省略した場合、指定されたメトリックに属するすべての時系列が削除されます。 |
重要
tags を省略すると、そのメトリックに関連付けられたすべての時系列が削除されます。tags を指定することで、特定の時系列のみを対象として削除できます。
例
特定の時系列を削除
metric が cpu.usage、host が 192.168.0.2、appName が hitsdb である時系列を削除します。
[リクエスト]: POST /api/delete_meta
本文:
{
"metric": "cpu.usage",
"tags": {
"host": "192.168.0.2",
"appName": "hitsdb"
}
}メトリックに関連付けられたすべての時系列を削除
cpu.usage メトリックに関連付けられたすべての時系列を削除します。
リクエスト: POST /api/delete_meta
本文:
{
"metric": "cpu.usage"
}応答
200 状態コードは成功を示します。その他の状態コードとその意味については、「応答コード」をご参照ください。