This is a translation of the original English documentation page. Help us make it better.

> Serviceオブジェクト

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

Service

service オブジェクトには次のプロパティがあります。

プロパティ タイプ 説明
serviceid string (読取専用) サービスID
algorithm
(必須)
integer ステータス計算ルール。 子サービスが存在する場合にのみ適用されます。

使用可能な値:
0 - ステータスをOKに設定
1 - すべての子サービスに問題がある場合、最も高い深刻度に設定
2 - 子サービスで最も高い深刻度に設定
name
(必須)
string サービス名
sortorder
(r必須)
integer 並べ替えに使用されるサービスの位置。

使用可能な値:0〜999
weight integer サービスの重み

使用可能な値:0-1000000

デフォルト:0
propagation_rule integer ステータス伝播ルール。propagation_valueと一緒に設定する必要があります。

使用可能な値:
0 - (デフォルト)サービスステータスをそのまま伝播します - 変更なし
1 - 伝播されたステータスを指定された値だけ増やします propagation_value(1から5の深刻度)
2 - 指定されたpropagation_value(1から5の深刻度)だけ伝播ステータスを減らします
3 - このサービスを無視します - ステータスは親サービスに伝播されません
4 - 指定されたpropagation_valueの値でサービスステータスを設定します
propagation_value integer ステータス伝播値。propagation_ruleと一緒に設定する必要があります。

propagation_ruleの値が0および3の時に使用可能な値:0

propagation_ruleの値が1および2の時に使用可能な値:1-5

propagation_ruleの値が4の時に使用可能な値:
-1 - OK
0 - 未分類
1 - 情報
2 - 警告;
3 - 軽度の障害
4 - 重度の障害
5 - 致命的な障害
status integer (読取専用) サービスがOKか障害状態か

サービスが障害状態にある場合statusは次のいずれかに等しくなります。
-最も重大な障害の深刻度
-障害のある状態の子サービスの一番重大なステータス

サービスがOK状態の場合、statusは-1になります。
description string サービスの説明
uuid string ユニバーサル一意識別子。 更新の場合、このフィールドは読み取り専用です。
created_at integer サービスが作成されたときのUnixタイムスタンプ。
readonly boolean (読取専用) サービスへのアクセス。

使用可能な値:
0 - 読取/書込
1 - 読取専用

Status rule

status ruleオブジェクトには次のプロパティがあります。

プロパティ タイプ 説明
type
(必須)
integer (New status)ステータスを設定するための条件

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

読み替え:
- (N)と(W)は limit_valueです
- (Status)はlimit_statusです
- (New status)はnew_statusです
limit_value
(必須)
integer 制限値

使用可能な値:
- N-W: 1-100000;
- N%: 1-100.
limit_status
(必須)
integer 制限ステータス

使用可能な値:
-1 - OK
0 - 未分類
1 - 情報
2 - 警告;
3 - 軽度の障害
4 - 重度の障害
5 - 致命的な障害
new_status
(必須)
integer 新しいステータス値

使用可能な値:
0 - 未分類
1 - 情報
2 - 警告;
3 - 軽度の障害
4 - 重度の障害
5 - 致命的な障害

Service tag

service tag オブジェクトには次のプロパティがあります。

プロパティ タイプ 説明
tag
(必須)
string サービスタグ名
value string サービスタグ値

Service alarm

Zabbix APIを介してService alarmを直接作成、更新、削除することはできません。

service alarm オブジェクトは、サービスの状態変化を表します。 以下の特性があります。

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

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

Problem tag

Problem tagを使用すると、サービスを障害イベントにリンクできます。 Problem tagオブジェクトには、次のプロパティがあります。

プロパティ タイプ 説明
tag
(必須)
string 障害タグ名
operator integer マッピング条件演算子

使用可能な値:
0 - (デフォルト)等しい
2 - like
value string 障害タグ値