report.update

説明

object report.update(object/array reports)

このメソッドでは、既存の定期レポートを更新できます。

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

パラメータ

(object/array) 更新する定期レポートのプロパティ。

各定期レポートでは reportid プロパティを定義する必要があり、その他の プロパティはすべて任意です。渡されたプロパティのみが 更新され、それ以外はすべて変更されません。

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

Parameter Type Description
users object/array 定期レポートに現在割り当てられているユーザーを置き換えるためのユーザー

パラメータの動作:
- user_groups が設定されていない場合は 必須
user_groups object/array 定期レポートに現在割り当てられているユーザーグループを置き換えるためのユーザーグループ

パラメータの動作:
- users が設定されていない場合は 必須

戻り値

(object) reportidsプロパティの下で更新されたスケジュールされたレポートのIDを含むオブジェクトを返します。

スケジュールレポートの無効化

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "report.update",
    "params": {
        "reportid": "1",
        "status": "0"
    },
    "id": 1
}

レスポンス:

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

関連項目

ソース

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