sla.update

説明

object sla.update(object/array slaids)

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

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

パラメータ

(object/array) 更新されるSLAプロパティ

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

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

パラメータ タイプ 説明
service_tags array SLA service tagsを使用して、現在のSLAサービスタグを置き換えます。

少なくとも1つのサービスタグを指定する必要があります。
schedule array SLA scheduleを使用して、現在のパラメーターを置き換えます。

パラメーターを空にすると、24時間年中無休のスケジュールとして設定されます
excluded_downtimes array SLA excluded downtimesを使用して、現在のダウンタイムを置き換えます。

戻り値

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

例

サービスタグの更新

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

Request:

{
    "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"
                }
            ]
        }
    ],
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

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

SLAのスケジュールの変更

ID"5"のSLAを24時間年中無休のスケジュールに切り替えます。

Request:

{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

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

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

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

Request:

{
    "jsonrpc": "2.0",
    "method": "service.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"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

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

ソース

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