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()。