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.

Documentation

sla.update

説明

パラメータ

戻り値

例

サービスタグの更新

SLAのスケジュールの変更

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

ソース