Table of Contents
hostgroup.massupdate
説明
object hostgroup.massupdate(object parameters)
このメソッドは、複数のホストグループ内のホストおよびテンプレートを指定したものに置き換えることができます。
このメソッドは 管理者 および スーパ管理者 ユーザータイプでのみ利用可能です。メソッドの呼び出し権限はユーザーロール設定で取り消すことができます。詳細はユーザーロールを参照してください。
パラメータ
(object) 更新するホストグループのIDと、更新するオブジェクトを含むパラメータ。
| パラメータ | 型 | 説明 |
|---|---|---|
| groups | object/array | 更新するホストグループ。 ホストグループには groupidプロパティのみを定義する必要があります。パラメータの動作: - 必須 |
| hosts | object/array | 指定したホストグループの現在のホストを置き換えるホスト。 指定したホスト以外のすべてのホストはホストグループから除外されます。 検出されたホストには影響しません。 ホストには hostidプロパティのみを定義する必要があります。パラメータの動作: - 必須 |
戻り値
(object) groupids プロパティの下で更新された host group の ID を含むオブジェクトを返します。
例
ホストグループ内のホストの置換
ホストグループ内のすべてのホストを指定したホストに置き換えます。
{
"jsonrpc": "2.0",
"method": "hostgroup.massupdate",
"params": {
"groups": [
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
}
]
},
"id": 1
}レスポンス:
関連項目
ソース
CHostGroup::massUpdate() in ui/include/classes/api/services/CHostGroup.php.