Documentation
Table of Contents
host.massremove
説明
object host.massremove(object parameters)
このメソッドは、複数のホストから関連するオブジェクトを削除することができます。
このメソッドは、Admin および Super admin ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、
ユーザーロール設定で取り消すことができます。詳細については、User roles を参照してください。
パラメータ
(object) 更新するホストと削除するオブジェクトのIDを含むパラメータ
| パラメータ | Type | 説明 |
|---|---|---|
| hostids (required) | string/array | IDs of the hosts to be updated. |
| groupids | string/array | Host groups to remove the given hosts from. |
| interfaces | object/array | Host interfaces to remove from the given hosts. The host interface object must have the ip, dns and port properties defined. |
| macros | string/array | User macros to delete from the given hosts. |
| templateids | string/array | Templates to unlink from the given hosts. |
| templateids_clear | string/array | Templates to unlink and clear from the given hosts. |
戻り値
(object) hostids プロパティの下で更新されたホストの ID を含むオブジェクトを返します。
例
テンプレートのリンク解除
2つのホストからテンプレートのリンクを解除し、テンプレート化されたエンティティをすべて削除します。
Request:
{ "jsonrpc": "2.0", "method": "host.massremove", "params": { "hostids": ["69665", "69666"], "templateids_clear": "325" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Response:
参照
ソース
CHost::massRemove() in ui/include/classes/api/services/CHost.php.