Serviceオブジェクト

次のオブジェクトは、serviceAPIに直接関連しています。

サービス

サービスオブジェクトには以下のプロパティがあります。

プロパティ タイプ 説明
serviceid ID サービスのID。

プロパティの動作:
- 読み取り専用
- 更新操作では必須
algorithm integer ステータス計算ルール。子サービスが存在する場合のみ適用されます。

可能な値:
0 - ステータスをOKに設定;
1 - すべての子サービスに問題がある場合、最も深刻なもの;
2 - 子サービスの中で最も深刻なもの。

プロパティの動作:
- 作成操作では必須
name string サービス名。

プロパティの動作:
- 作成操作では必須
sortorder integer ソートに使用されるサービスの位置。

可能な値: 0-999。

プロパティの動作:
- 作成操作では必須
weight integer サービスの重み。

可能な値: 0-1000000。

デフォルト: 0。
propagation_rule integer ステータス伝播ルール。

可能な値:
0 - (デフォルト) サービスステータスをそのまま伝播 - 変更なし;
1 - 指定したpropagation_value(1~5段階の深刻度)で伝播ステータスを増加;
2 - 指定したpropagation_value(1~5段階の深刻度)で伝播ステータスを減少;
3 - このサービスを無視 - ステータスは親サービスに全く伝播されない;
4 - 指定したpropagation_valueで固定サービスステータスを設定。

プロパティの動作:
- propagation_valueが設定されている場合は必須
propagation_value integer ステータス伝播値。

propagation_ruleが"0"または"3"の場合の可能な値:
0 - 未分類。

propagation_ruleが"1"または"2"の場合の可能な値:
1 - 情報;
2 - 警告;
3 - 軽度;
4 - 高度;
5 - 障害。

propagation_ruleが"4"の場合の可能な値:
-1 - OK;
0 - 未分類;
1 - 情報;
2 - 警告;
3 - 軽度;
4 - 高度;
5 - 障害。

プロパティの動作:
- propagation_ruleが設定されている場合は必須
status integer サービスがOKまたは問題状態かどうか。

サービスが問題状態の場合、statusは以下のいずれかと等しくなります:
- 最も深刻な問題の深刻度;
- 問題状態の子サービスの中で最も高いステータス。

サービスがOK状態の場合、statusは-1となります。

プロパティの動作:
- 読み取り専用
description string サービスの説明。
uuid string インポートされたサービスを既存のサービスにリンクするために使用されるユニバーサル一意識別子。指定されていない場合は自動生成されます。
created_at integer サービスが作成されたUnixタイムスタンプ。
readonly integer サービスへのアクセス。

可能な値:
0 - 読み書き;
1 - 読み取り専用。

プロパティの動作:
- 読み取り専用

ステータスルール

ステータスルールオブジェクトには以下のプロパティがあります。

プロパティ タイプ 説明
type integer (新しいステータス)ステータスを設定するための条件

可能な値:
0 - 少なくとも(N)個の子サービスが(ステータス)ステータス以上である場合
1 - 少なくとも(N%)個の子サービスが(ステータス)ステータス以上である場合
2 - (N)個未満の子サービスが(ステータス)ステータス以下である場合
3 - (N%)個未満の子サービスが(ステータス)ステータス以下である場合
4 - (ステータス)ステータス以上の子サービスの重みが少なくとも(W)である場合
5 - (ステータス)ステータス以上の子サービスの重みが少なくとも(N%)である場合
6 - (ステータス)ステータス以下の子サービスの重みが(W)未満である場合
7 - (ステータス)ステータス以下の子サービスの重みが(N%)未満である場合。

ここで:
- N (W)はlimit_value;
- (ステータス) は limit_status です。
- (新しいステータス) は new_status です。

プロパティの動作:
- 必須
limit_value 整数 制限値

可能な値:
- N および W の場合: 1~100000;
- N% の場合: 1~100

プロパティの動作:
- 必須
limit_status 整数 制限ステータス

可能な値:
-1 - OK;
0 - 分類なし;
1 - 情報;
2 - 警告;
3 - 平均;
4 - 高;
5 - 災害

プロパティの動作:
- 必須
new_status 整数 新しいステータス値

可能な値:
0 - 分類なし;
1 - 情報;
2 - 警告;
3 - 平均;
4 - 高;
5 - 災害

プロパティの動作:
- 必須

サービスタグ

サービスタグオブジェクトには以下のプロパティがあります。

プロパティ タイプ 説明
タグ 文字列 サービスタグ名

プロパティの動作:
- 必須
文字列 サービスタグの値

サービスアラーム

サービスアラームは、Zabbix API 経由で直接作成、更新、または削除することはできません。

サービスアラームオブジェクトは、サービスの状態変化を表します。以下のプロパティがあります。

プロパティ タイプ 説明
clock timestamp サービスの状態変化が発生した時刻
整数 サービスのステータス

使用可能な値の一覧については、サービスの status プロパティ を参照してください。

問題タグ

問題タグを使用すると、サービスと問題イベントを関連付けることができます。問題タグオブジェクトには、以下のプロパティがあります。

プロパティ タイプ 説明
tag string 問題タグ名。

プロパティの動作:
- 必須
operator integer マッピング条件の演算子

可能な値:
0 - (デフォルト) 等しい;
2 - 含む。
value string 問題タグの値。