[comment]: # translation:outdated
[comment]: # ({b1a89f1b-b1a89f1b})
# > Serviceオブジェクト
次のオブジェクトは、`service`APIに直接関連しています。
[comment]: # ({/b1a89f1b-b1a89f1b})
[comment]: # ({94e43d5d-4a7e98f0})
### Service
service オブジェクトには次のプロパティがあります。
|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|-----------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------|
|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 - 読取専用|
[comment]: # ({/94e43d5d-4a7e98f0})
[comment]: # ({6bfdbc42-6bfdbc42})
### Status rule
status ruleオブジェクトには次のプロパティがあります。
|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|------------------------|-------------------|--------------------------------------------------------------------------|
|**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 - 致命的な障害|
[comment]: # ({/6bfdbc42-6bfdbc42})
[comment]: # ({9903142f-9903142f})
### Service tag
service tag オブジェクトには次のプロパティがあります。
|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|-----------------------|-----------------------------------------------------|--------------------|
|**tag**
(必須)|string|サービスタグ名|
|value|string|サービスタグ値|
[comment]: # ({/9903142f-9903142f})
[comment]: # ({fe2d8044-fe2d8044})
### Service alarm
::: noteclassic
Zabbix APIを介してService alarmを直接作成、更新、削除することはできません。
:::
service alarm オブジェクトは、サービスの状態変化を表します。 以下の特性があります。
|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|----------|-----------------|---------------------------------------------------------------------------------------------------------------------|
|clock|timestamp|サービス状態の変更が発生した時刻|
|value|integer|サービスのステータス
使用可能な値のリストについては[サービスステータスプロパティ](object#service)を参照してください。|
[comment]: # ({/fe2d8044-fe2d8044})
[comment]: # ({1c3ecb40-1c3ecb40})
### Problem tag
Problem tagを使用すると、サービスを障害イベントにリンクできます。 Problem tagオブジェクトには、次のプロパティがあります。
|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|-----------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------|
|**tag**
(必須)|string|障害タグ名|
|operator|integer|マッピング条件演算子
使用可能な値：
0 - *(デフォルト)*等しい
2 - like|
|value|string|障害タグ値|
[comment]: # ({/1c3ecb40-1c3ecb40})