削除¶
GET /api/v1/slo/{slo_uuid}/delete
概要¶
指定した SLO とその検出コンポーネントを削除します。
呼び出し前の確認と使用手順¶
現在の API Key には monitor.sloCfgManage が必要です。メトリクス型の保存には、対象メトリクスの namespace に対するクエリ権限も必要であり、SLO 管理権限だけではこの事前チェックを通過できません。操作対象は API Key が属するワークスペースのみです。パスの SLO UUID はSLO リストを取得の content.data[].uuid(通常は monitor_ プレフィックス)から取得し、関連するモニターの Rule UUID や metricQueryInfo.sloId ではありません。
これは書き込み副作用を伴う GET 削除インターフェースです。呼び出す前に SLO と関連付けをバックアップし、ステータスページなどの参照を調整する必要があるか確認してください。SLO 自体、その検出/計算コンポーネント、および SLI/アラートポリシー/タグの関連付けを削除します。参照されている元の SLI モニターやアラートポリシーは削除されず、履歴時系列データのクリーンアップも保証されません。最初にリモートスケジューリングを削除し、その後ローカル削除をコミットします。コミット後、ポリシーキャッシュは非同期でクリーンアップされます。各段階はサービスをまたぐトランザクションではなく、失敗時にはスケジューリングが停止済み、またはローカル削除済みである可能性があります。
削除された名前の配列を返します(通常は 1 件)。対象が存在しない/削除済み/別ワークスペースの場合は NotFoundSLO を返します。再試行で返された 404 を、初回削除が失敗したとみなさないでください。ネットワーク障害または 500 の後は、まず SLO リストとスケジューリングの現在の状態を確認し、無闇に繰り返さないでください。
パスパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| slo_uuid | string | Y | 対象 SLO の UUID。SLI モニターの UUID や metricQueryInfo.sloId ではありません。 例: monitor_example取得または入力方法: SLO リストを取得から content.data[].uuid を読み取ります。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報。 例: <DF-API-KEY>取得または入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
リクエスト例¶
curl --get 'https://openapi.guance.com/api/v1/slo/monitor_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
レスポンス¶
HTTP 200、application/json。以下の例は、直接読み取れる主要フィールドを示しています。
| フィールド | 型 | 説明 |
|---|---|---|
| content | array<string> |
実際に削除された SLO の名前の配列。 |
| content[] | string | 削除された SLO 名。単一削除では通常 1 件です。 |
{
"code": 200,
"content": [
"支付服务可用性"
],
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラー応答¶
認証、レート制限、および共通リクエストエラーについては、共通エラー定義を参照してください。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたは応答の説明 | 対処方法 |
|---|---|---|---|---|
| 404 | ft.NotFoundSLO | 対象が現在のワークスペースに存在しない、削除済み、または SLO ではない場合。変更時には必要な検出/計算コンポーネントの欠落も含みます | 指定された SLO が見つかりません | 現在のワークスペースの SLO リストから uuid を取得します。対象がまだ存在することを確認し、コンポーネントが欠落している場合は管理者に修復を依頼してください。 |
| 400 | ft.OuterFuncFailed | リモートスケジューリングサービスが失敗を返しました | 外部関数の呼び出しに失敗しました(一部の分岐では下流の message を使用) | message と traceId を確認し、管理者にスケジューリングの可用性と設定の現在の状態を確認してもらったうえで再試行してください。 |
| 400 | ft.SameSetTraggerExists | リモートスケジューリングサービスが同一のトリガー設定が既に存在すると報告しました | 同一設定のトリガーが既に存在します | まずこの SLO とリモートスケジューリングを確認し、残存/重複設定を処理してから再度リクエストしてください。 |
| 500 | ft.InternalServerError | データベース/キャッシュ、タスクキュー、不正な配列メンバー、または未処理の下流例外。失敗時には既にリモート変更が行われている可能性もあります | 内部エラー | まず対象 SLO の設定とスケジューリングの現在の状態を確認します。削除失敗の場合は削除済み状態も確認し、無闇に重複作成や一括上書きを行わないでください。 |