hostinterface.create
説明
object hostinterface.create(object/array hostInterfaces)
このメソッドでは、新しいホストインターフェースを作成できます。
このメソッドは、Admin および Super admin の ユーザータイプでのみ利用できます。メソッドを呼び出す権限は、ユーザーロールの 設定で取り消すことができます。詳細は、ユーザーロール を参照してください。
パラメータ
(object/array) 作成するホストインターフェース。
このメソッドは、標準のホストインターフェースプロパティを持つホストインターフェースを受け付けます。
戻り値
(object) interfaceidsプロパティの下で作成されたホストインターフェイスのIDを含むオブジェクトを返します。 返されるIDの順序は、渡されたホストインターフェイスの順序と一致します。
例
新しいインターフェースを作成する
ホスト「30052」にセカンダリIPエージェントインターフェースを作成します。
{
"jsonrpc": "2.0",
"method": "hostinterface.create",
"params": {
"hostid": "30052",
"main": "0",
"type": "1",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"port": "10050"
},
"id": 1
}
レスポンス:
{
"jsonrpc": "2.0",
"result": {
"interfaceids": [
"30062"
]
},
"id": 1
}
SNMPの詳細を指定してインターフェースを作成する
{
"jsonrpc": "2.0",
"method": "hostinterface.create",
"params": {
"hostid": "10456",
"main": "0",
"type": "2",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"port": "1601",
"details": {
"version": "2",
"bulk": "1",
"community": "{$SNMP_COMMUNITY}"
}
},
"id": 1
}
レスポンス:
{
"jsonrpc": "2.0",
"result": {
"interfaceids": [
"30063"
]
},
"id": 1
}
参照
ソース
CHostInterface::create() in ui/include/classes/api/services/CHostInterface.php.