Table of Contents
Maintenanceオブジェクト
次のオブジェクトは、maintenanceAPIに直接関連しています。
メンテナンス
メンテナンスオブジェクトには以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| maintenanceid | ID | メンテナンスのID。 プロパティの動作: - 読み取り専用 - 更新操作には必須 |
| name | string | メンテナンスの名前。 プロパティの動作: - 作成操作には必須 |
| active_since | timestamp | メンテナンスが有効になる時刻（含む）。 指定された値は分単位に切り捨てられます。 プロパティの動作: - 作成操作には必須 |
| active_till | timestamp | メンテナンスが無効になる時刻（含まない）。 指定された値は分単位に切り捨てられます。 プロパティの動作: - 作成操作には必須 |
| description | string | メンテナンスの説明。 |
| maintenance_type | integer | メンテナンスタイプ。 指定可能な値: 0 - (デフォルト) データ収集あり; 1 - データ収集なし。 |
| tags_evaltype | integer | 障害タグの評価方法。 指定可能な値: 0 - (デフォルト) And/Or; 2 - Or. |
時間期間
時間期間オブジェクトは、メンテナンスが有効になる期間を定義するために使用されます。 以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| period | integer | メンテナンス期間の秒数。 指定された値は分単位に切り捨てられます。 デフォルト: 3600。 |
| timeperiod_type | integer | 時間期間のタイプ。 指定可能な値: 0 - (デフォルト) 1回のみ; 2 - 毎日; 3 - 毎週; 4 - 毎月。 |
| start_date | timestamp | メンテナンス期間が有効になる日付。 指定された値は分単位に切り捨てられます。 デフォルト: 現在の日付。 プロパティの動作: - timeperiod_typeが「1回のみ」に設定されている場合にサポート |
| start_time | integer | メンテナンスが開始される時刻（秒単位）。 指定された値は分単位に切り捨てられます。 デフォルト: 0。 プロパティの動作: - timeperiod_typeが「毎日」、「毎週」または「毎月」に設定されている場合にサポート |
| every | integer | 毎日および毎週の期間の場合、everyはメンテナンスが有効になる日または週の間隔を定義します。timeperiod_typeが「毎日」または「毎週」に設定されている場合のデフォルト値: 1。毎月の期間で dayが設定されている場合、everyプロパティはメンテナンスが有効になる月の日を定義します。timeperiod_typeが「毎月」に設定され、dayが設定されている場合のデフォルト値: 1。毎月の期間で dayofweekが設定されている場合、everyプロパティはメンテナンスが有効になる月の週を定義します。timeperiod_typeが「毎月」に設定され、dayofweekが設定されている場合の指定可能な値:1 - (デフォルト) 最初の週; 2 - 2週目; 3 - 3週目; 4 - 4週目; 5 - 最終週。 プロパティの動作: - timeperiod_typeが「毎日」、「毎週」または「毎月」に設定されている場合にサポート |
| dayofweek | integer | メンテナンスが有効になる曜日。 指定可能なビットマップ値: 1 - 月曜日; 2 - 火曜日; 4 - 水曜日; 8 - 木曜日; 16 - 金曜日; 32 - 土曜日; 64 - 日曜日。 これはビットマスクフィールドであり、指定可能なビットマップ値の任意の合計が許容されます（例: 月・水・金の場合は21）。 プロパティの動作: - timeperiod_typeが「毎週」に設定されている場合、またはtimeperiod_typeが「毎月」に設定されていてdayが設定されていない場合に必須 |
| day | integer | メンテナンスが有効になる月の日。 プロパティの動作: - timeperiod_typeが「毎月」に設定されていてdayofweekが設定されていない場合に必須 |
| month | integer | メンテナンスが有効になる月。 指定可能なビットマップ値: 1 - 1月; 2 - 2月; 4 - 3月; 8 - 4月; 16 - 5月; 32 - 6月; 64 - 7月; 128 - 8月; 256 - 9月; 512 - 10月; 1024 - 11月; 2048 - 12月。 これはビットマスクフィールドであり、指定可能なビットマップ値の任意の合計が許容されます（例: 1月・4月・7月・10月の場合は585）。 プロパティの動作: - timeperiod_typeが「毎月」に設定されている場合に必須 |
問題タグ
問題タグオブジェクトは、メンテナンスが有効になったときに抑制する問題を定義するために使用されます。 タグは、Maintenanceオブジェクトのmaintenance_typeが「データ収集あり」に設定されている場合にのみ指定できます。 以下のプロパティがあります。