sla.create

説明

object sla.create(object/array SLAs)

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

このメソッドは、管理者およびスーパー管理者のユーザータイプでのみ使用できます。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは、ユーザーの役割 をご覧ください。

パラメータ

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

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

パラメータ Type 説明
service_tags array SLA用に作成するSLAサービスタグ。

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

戻り値

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

例

SLAの作成

以下の条件でSLAエントリを作成するよう指示します。

  • SQLエンジン関連サービスの稼働率を追跡すること。
  • 土曜日の最後の1時間を除く、すべての平日のカスタムスケジュールであること。
  • 発効日が2022年の最終日であること。
  • 7月4日の午前0時に開始する、1時間15分の計画停止時間があること。
  • SLAの週次レポート計算を有効にすること。
  • 許容される最小SLOが99.9995%であること。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "sla.create",
    "params": [
        {
            "name": "データベース稼働時間",
            "slo": "99.9995",
            "period": "1",
            "timezone": "America/Toronto",
            "description": "主要なデータベースエンジンに優れた稼働時間を提供します。",
            "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": "ソフトウェアバージョンアップグレードの展開",
                    "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()。