sla.update

説明

object sla.update(object/array slaids)

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

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

パラメータ

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

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

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

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

戻り値

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

サービスタグの更新

NoSQL関連サービスについて、ID "5"のSLAを月次で計算するように設定し、スケジュールや除外するダウンタイムは変更せず、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 を 年中無休のスケジュールに切り替えます。

Request:

{
           "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
       }

ソース

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