sla.update

Description

object sla.update(object/array slaids)

このメソッドで、既存のSLAエントリを更新できます。

このメソッドはAdminおよびSuper adminユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細についてはユーザーの役割を参照してください。

Parameters

更新する(オブジェクト/配列) SLAプロパティ。

slaidプロパティは各SLAごとに定義する必要があり、その他のプロパティはオプションです。指定されたプロパティのみが更新され、その他のプロパティは変更されません。

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

パラメータ タイプ 説明
service_tags 配列 SLAサービスタグを使用して、現在のSLAサービスタグを置き換えます。
schedule array SLAスケジュール を指定して、現在のスケジュールを置き換えます。
パラメータを空に指定すると、24時間365日のスケジュールとして解釈されます。
excluded_downtimes array SLA除外ダウンタイム を指定して、現在のスケジュールを置き換えます。

戻り値

(object) slaidsプロパティに更新されたSLAのIDを含むオブジェクトを返します。

例

サービスタグの更新

NoSQL 関連サービスの SLA ID "5"を月次で計算するように設定し、スケジュールや除外するダウンタイムは変更せず、SLO を 95% に設定します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": [
        {
            "slaid": "5",
            "name": "NoSQL Database engines",
            "slo": "95",
            "period": 2,
            "service_tags": [
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "redis"
                },
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "mongodb"
                }
            ]
        }
    ],
    "id": 1
}

Response:

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

SLA のスケジュール変更

ID "5" の SLA を 24 時間 365 日のスケジュールに切り替えます。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "id": 1
}

Response:

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

SLA の除外ダウンタイムの変更

2022年4月6日に4時間の RAM アップグレードのためのダウンタイムを計画的に追加します。ただし、ID "5"の SLA については、7月4日に既に計画されているソフトウェア アップグレードは維持します（新たに定義する必要があります）

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "excluded_downtimes": [
            {
                "name": "Software version upgrade rollout",
                "period_from": "1648760400",
                "period_to": "1648764900"
            },
            {
                "name": "RAM upgrade",
                "period_from": "1649192400",
                "period_to": "1649206800"
            }
        ]
    },
    "id": 1
}

Response:

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

ソース

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