You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

sla.create

説明

object sla.create(object/array SLAs)

このメソッドは新しいSLAオブジェクトを作成します。

このメソッドは管理者およびスーパ管理者ユーザータイプでのみ利用可能です。 このメソッドを呼び出す権限はユーザーロールの設定で取り消すことができます。 詳細はユーザーロールを参照してください。

パラメータ

作成する(object/array) SLAオブジェクト

標準SLAプロパティに加えて、このメソッドは以下のパラメータを受け入れます。

パラメータ タイプ 説明
service_tags array SLA用に作成されるSLAサービスタグ

パラメータの動作:
- 必須
schedule array SLA に対して作成される SLA スケジュール
空のパラメータを指定すると、24 時間 365 日のスケジュールとして解釈されます。
デフォルト: 24 時間 365 日のスケジュール
excluded_downtimes array SLA に対して作成される SLA 除外ダウンタイム

戻り値

(object) 作成されたSLAのIDをslaidsプロパティに含むオブジェクトを返します。返されるIDの順序は、渡されたSLAの順序と一致します。

SLAの作成

以下のためにSLAエントリを作成するよう指示します: * SQLエンジン関連サービスの稼働時間の追跡; * 土曜日の最終時間を除くすべての平日のカスタムスケジュール; * 2022年の最終日を有効日とする; * 7月4日午前0時から1時間15分の計画停止; * SLAの週次レポート計算を有効にする; * 最小許容SLOは99.9995%とする。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "sla.create",
           "params": [
               {
                   "name": "Database Uptime",
                   "slo": "99.9995",
                   "period": "1",
                   "timezone": "America/Toronto",
                   "description": "Provide excellent uptime for main database engines.",
                   "effective_date": 1672444800,
                   "status": 1,
                   "schedule": [
                       {
                           "period_from": 0,
                           "period_to": 601200
                       }
                   ],
                   "service_tags": [
                       {
                           "tag": "database",
                           "operator": "0",
                           "value": "mysql"
                       },
                       {
                           "tag": "database",
                           "operator": "0",
                           "value": "postgresql"
                       }
                   ],
                   "excluded_downtimes": [
                       {
                           "name": "Software version upgrade rollout",
                           "period_from": "1648760400",
                           "period_to": "1648764900"
                       }
                   ]
               }
           ],
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

ソース

ui/include/classes/api/services/CSla.php の CSla::create()。