| 両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン |
| ja:documentation:pandorafms:technical_reference:02_annex_externalapi [2024/04/16 03:10] – [set create_data_module] junichi | ja:documentation:pandorafms:technical_reference:02_annex_externalapi [2024/04/16 08:32] (現在) – [set update_SNMP_module] junichi |
|---|
| - <ff_type> | - <ff_type> |
| - <不明の無視> ''0'' または ''1'' | - <不明の無視> ''0'' または ''1'' |
| - < number_of_intervals_in_warning > Allows state scaling by specifying the maximum number of consecutive intervals in which the module remains in warning state. If this value is exceeded, the module will escalate to critical status. | - < 警告の間隔数 > モジュールが警告状態に留まる連続間隔の最大数を指定することにより、状態のスケーリングを可能にします。 この値を超えると、モジュールは障害状態にエスカレートします。 |
| |
| **例** | Example ([[#pandora_fms_external_api|see call syntax)]]: |
| <code> | |
| |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_data_module&id=pepito&other=prueba|0|1|data%20module%20from%20api|1|10|20|10.50|180|10|15||16|20||0&other_mode=url_encode_separator_| | 例 ([[#pandora_fms_外部_api|書式を参照]]): |
| |
| | <code bash> |
| | …/include/api.php?op=set&op2=create_data_module&id=test&other=test%202|0|1|data%20module%20from%20api|1|10|20|10.50|180|10|15||16|20||0|0|0|0|0|0|0|0|0|0|0|1|1&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| </code> | </code> |
| |
| === set create_SNMP_module === | === set create_SNMP_module === |
| | |
| | It creates an SNMP module. |
| |
| SNMP モジュールを作成します。 | SNMP モジュールを作成します。 |
| |
| 書式: | [[#pandora_fms_external_api|Call syntax]]: |
| |
| * op=set (必須) | [[#pandora_fms_外部_api|書式]]: |
| * op2=create_snmp_module (必須) | |
| * id=<エージェント名> (必須) エージェント名でなければいけません。 | |
| * other=<連続パラメータ> (必須) 次の順番で指定するモジュールの設定とデータです。 | |
| * <モジュール名> | |
| * <無効化> | |
| * <モジュールタイプID> | |
| * <モジュールグループID> | |
| * <警告の最小値> | |
| * <警告の最大値> | |
| * <警告の文字列> | |
| * <障害の最小値> | |
| * <障害の最大値> | |
| * <障害の文字列> | |
| * <連続抑制回数> | |
| * <データの保存> | |
| * <対象IP> | |
| * <モジュールのポート> | |
| * <SNMPバージョン> | |
| * <SNMPコミュニティ> | |
| * <SNMP OID> | |
| * <モジュールの間隔> | |
| * <データ保存倍率> | |
| * <最小値> | |
| * <最大値> | |
| * <カスタムID> | |
| * <説明> | |
| * <SNMPv3 暗号化手法 [AES|DES]> | |
| * <SNMPv3 暗号化パスワード> | |
| * <SNMPv3 セキュリティレベル [authNoPriv|authPriv|noAuthNoPriv]> | |
| * <SNMPv3 認証手法 [MD5|SHA]> | |
| * <SNMPv3 認証ユーザ> | |
| * <SNMPv3 認証パスワード> | |
| * <不明イベントの有効化> (バージョン 5 以降のみ) | |
| * <個別状態変化の利用> (バージョン 5.1 以降のみ) | |
| * <正常移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <警告移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <障害移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <ff_type> (バージョン 733 以降のみ) | |
| * <エージェントの別名の利用> (値は 0 または 1 です) | |
| |
| **例** | * ''op=set'' (required). |
| | * ''op2=create_snmp_module'' (required). |
| | * ''id=''< agent_name > (required). It should be an agent name. |
| | * ''other=''< serialized parameters > (required). They are module configuration and data, serialized in the following order: |
| |
| 例 1 (SNMP v3, 暗号化手法: AES, 暗号化パスワード: example_priv_passw, セキュリティレベル: authNoPriv, 認証手法:MD5, 認証ユーザ: pepito_user, 認証パスワード: example_priv_passw) | * ''op=set'' (必須) |
| <code> | * ''op2=create_snmp_module'' (必須) |
| | * ''id=''<エージェント名> (必須) エージェント名でなければいけません。 |
| | * ''other=''<連続パラメータ> (必須) 次の順番で指定するモジュールの設定とデータです。 |
| |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_snmp_module&id=pepito&other=prueba|0|15|1|10|15||16|18||15|0|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP%20module%20from%20API|AES|example_priv_passw|authNoPriv|MD5|pepito_user|example_auth_passw&other_mode=url_encode_separator_| | - < name_module > |
| | - < disabled > |
| | - < id_module_type > |
| | - < id_module_group > |
| | - < min_warning > |
| | - < max_warning > |
| | - < str_warning > |
| | - < min_critical > |
| | - < max_critical > |
| | - < str_critical > |
| | - < ff_threshold > |
| | - < history_data > |
| | - < ip_target > |
| | - < module_port > |
| | - < snmp_version > |
| | - < snmp_community > |
| | - < snmp_oid > |
| | - < module_interval > |
| | - < post_process > |
| | - < min_value > |
| | - < max_value > |
| | - < custom_id > |
| | - < description > |
| | - < snmp3_priv_method [AES|DES] > |
| | - < snmp3_priv_pass > |
| | - < snmp3_sec_level [authNoPriv|authPriv|noAuthNoPriv] > |
| | - < snmp3_auth_method [MD5|SHA] > |
| | - < snmp3_auth_user > |
| | - < snmp3_auth_pass > |
| | - < enable_unknown_events > |
| | - < each_ff > |
| | - < ff_threshold_normal > |
| | - < ff_threshold_warning > |
| | - < ff_threshold_critical > |
| | - < ff_type > |
| | - < ignore_unknown > Accepts values ''0'' and ''1''. |
| | - < number_of_intervals_in_warning > Allows state scaling by specifying the maximum number of consecutive intervals in which the module remains in warning state. If this value is exceeded, the module will escalate to critical status. |
| |
| | - <モジュール名> |
| | - <無効化> |
| | - <モジュールタイプID> |
| | - <モジュールグループID> |
| | - <警告の最小値> |
| | - <警告の最大値> |
| | - <警告の文字列> |
| | - <障害の最小値> |
| | - <障害の最大値> |
| | - <障害の文字列> |
| | - <連続抑制回数> |
| | - <データの保存> |
| | - <対象IP> |
| | - <モジュールのポート> |
| | - <SNMPバージョン> |
| | - <SNMPコミュニティ> |
| | - <SNMP OID> |
| | - <モジュールの間隔> |
| | - <データ保存倍率> |
| | - <最小値> |
| | - <最大値> |
| | - <カスタムID> |
| | - <説明> |
| | - <SNMPv3 暗号化手法 [AES|DES]> |
| | - <SNMPv3 暗号化パスワード> |
| | - <SNMPv3 セキュリティレベル [authNoPriv|authPriv|noAuthNoPriv]> |
| | - <SNMPv3 認証手法 [MD5|SHA]> |
| | - <SNMPv3 認証ユーザ> |
| | - <SNMPv3 認証パスワード> |
| | - <不明イベントの有効化> |
| | - <個別状態変化の利用> |
| | - <正常移行時連続抑制回数> |
| | - <警告移行時連続抑制回数> |
| | - <障害移行時連続抑制回数> |
| | - <ff_type> |
| | - <不明の無視> ''0'' または ''1'' |
| | - < 警告の間隔数 > モジュールが警告状態に留まる連続間隔の最大数を指定することにより、状態のスケーリングを可能にします。 この値を超えると、モジュールは障害状態にエスカレートします。 |
| | |
| | Example ([[#pandora_fms_external_api|see call syntax)]]: |
| | |
| | 例 ([[#pandora_fms_外部_api|書式を参照]]): |
| | |
| | Example 1 (snmp v: 3, snmp3_priv_method: AES, snmp3_priv_pass: example_priv_passw, snmp3_sec_level: authNoPriv, snmp3_auth_method:MD5, snmp3_auth_user: pepito_user, snmp3_auth_pass: example_priv_passw): |
| | |
| | 例 1 (SNMP v3, 暗号化手法: AES, 暗号化パスワード: example_priv_passw, セキュリティレベル: authNoPriv, 認証手法:MD5, 認証ユーザ: pepito_user, 認証パスワード: example_priv_passw) |
| | |
| | <code bash> |
| | …/include/api.php?op=set&op2=create_snmp_module&id=example&other=prueba|0|15|1|10|15||16|18||15|0|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP%20module%20from%20API|AES|example_priv_passw|authNoPriv|MD5|pepito_user|example_auth_passw&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| </code> | </code> |
| | |
| | Example 2 (snmp v: 1): |
| |
| 例 2 (SNMP v1) | 例 2 (SNMP v1) |
| <code> | |
| |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_snmp_module&id=pepito1&other=prueba2|0|15|1|10|15||16|18||15|0|127.0.0.1|60|1|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP module from API&other_mode=url_encode_separator_| | |
| |
| | <code bash> |
| | …/include/api.php?op=set&op2=create_snmp_module&id=example&other=prueba2|0|15|1|10|15||16|18||15|0|127.0.0.1|60|1|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP&20module&20from&20API&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| </code> | </code> |
| |
| === set update_network_module === | === set update_network_module === |
| | |
| | It updates the network module. |
| |
| ネットワークモジュールを更新します。 | ネットワークモジュールを更新します。 |
| |
| 書式: | [[#pandora_fms_external_api|Call syntax]]: |
| |
| * op=set (必須) | [[#pandora_fms_外部_api|書式]]: |
| * op2=update_network_module (必須) | |
| * id=<モジュールID> (必須) モジュールIDでなければいけません。 | |
| * other=<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 | |
| * <エージェントID> | |
| * <無効化> | |
| * <モジュールグループID> | |
| * <警告の最小値> | |
| * <警告の最大値> | |
| * <警告文字列> | |
| * <障害の最小値> | |
| * <障害の最大値> | |
| * <障害文字列> | |
| * <連続抑制回数> | |
| * <データの保存> | |
| * <対象のIPO> | |
| * <モジュールのポート> | |
| * <SNMPコミュニティ> | |
| * <SNMP OID> | |
| * <モジュールの間隔> | |
| * <データ保存倍率> | |
| * <最小値> | |
| * <最大値> | |
| * <カスタムID> | |
| * <説明> | |
| * <イベントタイプの無効化> (バージョン 5 以降のみ) | |
| * <モジュールマクロ> (バージョン 5 以降のみ) それぞれのマクロのプロパティを一つのオブジェクトにまとめて base 64 エンコードした JSON 文字列でなければいけません。JSON プロパティの書式は、"<macro name>": "<macro value>" でなければいけません。 | |
| * <個別状態変化の利用> (バージョン 5.1 以降のみ) | |
| * <正常移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <警告移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <障害移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <障害条件の反転> (バージョン 6.0SP1 以降のみ) | |
| * <警告条件の反転> (バージョン 6.0SP1 以降のみ) | |
| * <ff_type> (バージョン 733 以降のみ) | |
| |
| **例** | * ''op=get'' (required). |
| <code> | * ''op2=update_network_module'' (required). |
| | * ''id=''< id_modulo > (required) It should be a module id (''tagente_modulo''). |
| | * ''other=''< serialized parameters > (required) They are module configuration and data, serialized in the following order: |
| |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_network_module&id=3431&other=44|0|2|10|15||16|18||7|0|127.0.0.1|0||0|300|30.00|0|0|0|latency%20ping%20modified%20by%20the%20Api&other_mode=url_encode_separator_| | * ''op=set'' (必須) |
| | * ''op2=update_network_module'' (必須) |
| | * ''id=''<モジュールID> (必須) モジュールIDでなければいけません。 |
| | * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 |
| | |
| | - < id_agent > |
| | - < disabled > |
| | - < id_module_group > |
| | - < min_warning > |
| | - < max_warning > |
| | - < str_warning > |
| | - < min_critical > |
| | - < max_critical > |
| | - < str_critical > |
| | - < min_ff_even > |
| | - < ff_threshold > |
| | - < history_data > |
| | - < ip_target > |
| | - < tcp_port > |
| | - < snmp_community > |
| | - < snmp_oid > |
| | - < module_interval > |
| | - < post_process > |
| | - < min_value > |
| | - < max_value > |
| | - < custom_id > |
| | - < description > |
| | - < disabled_types_event > |
| | - < module_macros > It should be a base64 encoded JSON document made up by an object with one property for each macro. The format of the JSON properties should be "<macro name>": "<macro value>". |
| | - < each_ff > |
| | - < ff_threshold_normal > |
| | - < ff_threshold_warning > |
| | - < ff_threshold_critical > |
| | - < critical_inverse > |
| | - < warning_inverse > |
| | - < ff_type > |
| | - < number_of_intervals_in_warning > Allows state scaling by specifying the maximum number of consecutive intervals in which the module remains in warning state. If this value is exceeded, the module will escalate to critical status. |
| | |
| | - <エージェントID> |
| | - <無効化> |
| | - <モジュールグループID> |
| | - <警告の最小値> |
| | - <警告の最大値> |
| | - <警告文字列> |
| | - <障害の最小値> |
| | - <障害の最大値> |
| | - <障害文字列> |
| | - < min_ff_even > |
| | - <連続抑制回数> |
| | - <データの保存> |
| | - <対象のIPO> |
| | - <モジュールのポート> |
| | - <SNMPコミュニティ> |
| | - <SNMP OID> |
| | - <モジュールの間隔> |
| | - <データ保存倍率> |
| | - <最小値> |
| | - <最大値> |
| | - <カスタムID> |
| | - <説明> |
| | - <イベントタイプの無効化> |
| | - <モジュールマクロ> それぞれのマクロのプロパティを一つのオブジェクトにまとめて base 64 エンコードした JSON 文字列でなければいけません。JSON プロパティの書式は、"<macro name>": "<macro value>" でなければいけません。 |
| | - <個別状態変化の利用> |
| | - <正常移行時連続抑制回数> |
| | - <警告移行時連続抑制回数> |
| | - <障害移行時連続抑制回数> |
| | - <障害条件の反転> |
| | - <警告条件の反転> |
| | - <ff_type> |
| | - < 警告の間隔数 > モジュールが警告状態に留まる連続間隔の最大数を指定することにより、状態のスケーリングを可能にします。 この値を超えると、モジュールは障害状態にエスカレートします。 |
| | |
| | **Example (see [[#pandora_fms_external_api|call syntax]])**: |
| | |
| | **例 ([[#pandora_fms_外部_api|書式]]を参照)**: |
| | |
| | <code bash> |
| | …/include/api.php?op=set&op2=update_network_module&id=132&other=|0|6|2|10|15||16|18||7|0|127.0.0.1|0||0|300|30.00|0|0|0|latency%20ping%20modified%20by%20the%20Api|||||||||||2020&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| |
| </code> | </code> |
| |
| === set update_plugin_module === | === set update_plugin_module === |
| | |
| | It updates the plugin module. |
| |
| プラグインモジュールを更新します。 | プラグインモジュールを更新します。 |
| |
| 書式: | [[#pandora_fms_external_api|Call syntax]]: |
| |
| * op=set (必須) | [[#pandora_fms_外部_api|書式]]: |
| * op2=update_plugin_module (必須) | |
| * id=<モジュールID> (必須) モジュールIDでなければいけません。 | * ''op=set'' (required). |
| * other=<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 | * ''op2=update_plugin_module'' (required). |
| * <エージェントID> | * ''id=''< module_id > (required). It should be a module id. |
| * <無効化> | * ''other=''< serialized parameters > (required). They are module configuration and data, serialized in the following order: |
| * <モジュールグループID> | |
| * <警告の最小値> | * ''op=set'' (必須) |
| * <警告の最大値> | * ''op2=update_plugin_module'' (必須) |
| * <警告文字列> | * ''id=''<モジュールID> (必須) モジュールIDでなければいけません。 |
| * <障害の最小値> | * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 |
| * <障害の最大値> | |
| * <障害文字列> | - < id_agent > |
| * <連続抑制回数> | - < disabled > |
| * <データの保存> | - < id_module_group > |
| * <対象IP> | - < min_warning > |
| * <モジュールのポート> | - < max_warning > |
| * <SNMPコミュニティ> | - < str_warning > |
| * <SNMP OID> | - < min_critical > |
| * <モジュールの間隔> | - < max_critical > |
| * <データ保存倍率> | - < str_critical > |
| * <最小値> | - < ff_threshold > |
| * <最大値> | - < history_data > |
| * <カスタムID> | - < ip_target > |
| * <説明> | - < tcp_port > |
| * <プラグインID> | - < snmp_community > |
| * <プラグインユーザ> | - < snmp_oid > |
| * <プラグインパスワード> | - < module_interval > |
| * <プラグインパラメータ> | - < post_process > |
| * <イベントタイプの無効化> (バージョン 5 以降のみ) | - < min_value > |
| * <マクロ> (バージョン 5 以降のみ) base 64 でエンコードされた文字列でなければいけません。内容は、次のプロパティで表すオブジェクトを一つにまとめたものでなければいけません。 | - < max_value > |
| * //"macro"//: マクロ名。//_field1_//, //_field2_//, …, //_fieldN_// でなければいけません。 | - < custom_id > |
| * //"desc"//: マクロを表す名前。 | - < description > |
| * //"help"//: マクロの説明。 | - < id_plugin > |
| * //"value"//:マクロの値。 | - < plugin_user > |
| | - < plugin_pass > |
| | - < plugin_parameter > |
| | - < disabled_types_event > |
| | - < macros > Values must be in base 64 encoded JSON format. |
| | - < module_macros > The format of the JSON properties should be “<macro name>”: “<macro value>”. See example at the end of this section. |
| | - < each_ff > |
| | - < ff_threshold_normal > |
| | - < ff_threshold_warning > |
| | - < ff_threshold_critical > |
| | - < critical_inverse> |
| | - < warning_inverse> |
| | - < policy_linked > |
| | - < ff_type > |
| | - < ignore_unknown > Accepts values ''0'' and ''1''. |
| | - < number_of_intervals_in_warning > Allows state scaling by specifying the maximum number of consecutive intervals in which the module remains in warning state. If this value is exceeded, the module will escalate to critical status. |
| | |
| | - <エージェントID> |
| | - <無効化> |
| | - <モジュールグループID> |
| | - <警告の最小値> |
| | - <警告の最大値> |
| | - <警告文字列> |
| | - <障害の最小値> |
| | - <障害の最大値> |
| | - <障害文字列> |
| | - <連続抑制回数> |
| | - <データの保存> |
| | - <対象IP> |
| | - <モジュールのポート> |
| | - <SNMPコミュニティ> |
| | - <SNMP OID> |
| | - <モジュールの間隔> |
| | - <データ保存倍率> |
| | - <最小値> |
| | - <最大値> |
| | - <カスタムID> |
| | - <説明> |
| | - <プラグインID> |
| | - <プラグインユーザ> |
| | - <プラグインパスワード> |
| | - <プラグインパラメータ> |
| | - <イベントタイプの無効化> |
| | - <マクロ> base 64 でエンコードされた文字列でなければいけません。 |
| | - <モジュールマクロ> それぞれのマクロのプロパティを一つのオブジェクトにまとめ base 64 でエンコードした JSON 文字列でなければいけません。JSON プロパティの書式は、"<macro name>": "<macro value>" でなければいけません。 |
| | - <個別状態変化の利用> |
| | - <正常移行時連続抑制回数> |
| | - <警告移行時連続抑制回数> |
| | - <障害移行時連続抑制回数> |
| | - <障害条件の反転> |
| | - <警告条件の反転> |
| | - <リンクポリシー> |
| | - <ff_type> |
| | - <不明の無視> ''0'' または ''1'' |
| | - < 警告の間隔数 > モジュールが警告状態に留まる連続間隔の最大数を指定することにより、状態のスケーリングを可能にします。 この値を超えると、モジュールは障害状態にエスカレートします。 |
| | |
| | Example ([[#pandora_fms_external_api|see call syntax)]]: |
| | |
| | 例 ([[#pandora_fms_外部_api|書式を参照]]): |
| |
| **例** | |
| <code> | <code> |
| | …/include/api.php?op=set&op2=update_plugin_module&id=2343&other=44|0|2|0|0||0|0||0|0|127.0.0.1|0||0|300|0|0|0|0|pluginmodule%20from%20api|2|admin|pass|-p%20max&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| | </code> |
| | |
| | The content should be an object made up by objects with the following properties: |
| | * //"macro"//: Macro name. Should be //_field1_//, //_field2_//, …, //_fieldN_//. |
| | * //"desc"//: Descriptive name of the macro. |
| | * //"help"//: Macro description. |
| | * //"value"//:Macro value. |
| | |
| | 内容は、次のプロパティで表すオブジェクトを一つにまとめたものでなければいけません。 |
| | * //"macro"//: マクロ名。//_field1_//, //_field2_//, …, //_fieldN_// でなければいけません。 |
| | * //"desc"//: マクロを表す名前。 |
| | * //"help"//: マクロの説明。 |
| | * //"value"//:マクロの値。 |
| | |
| | **JSON macro format example**: |
| | |
| | **JSON マクロフォーマットの例**: |
| | |
| | <file> |
| | |
| { | { |
| "1": { | "1": { |
| } | } |
| } | } |
| </code> | |
| |
| * <モジュールマクロ> (バージョン 5 以降のみ) それぞれのマクロのプロパティを一つのオブジェクトにまとめ base 64 でエンコードした JSON 文字列でなければいけません。JSON プロパティの書式は、"<macro name>": "<macro value>" でなければいけません。 | </file> |
| * <個別状態変化の利用> (バージョン 5.1 以降のみ) | |
| * <正常移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <警告移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <障害移行時連続抑制回数> (バージョン 5.1 以降のみ) | |
| * <障害条件の反転> (バージョン 6.0SP1 以降のみ) | |
| * <警告条件の反転> (バージョン 6.0SP1 以降のみ) | |
| * <ff_type> (バージョン 733 以降のみ) | |
| |
| **例** | Another example with state scaling: |
| <code> | |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_plugin_module&id=2343&other=44|http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_plugin_module&id=2343&other=44]]|0|2|0|0||0|0||0|0|127.0.0.1|0||0|300|0|0|0|0|plugin%20module%20from%20api|2|admin|pass|-p%20max&other_mode=url_encode_separator_| | 状態スケーリングを使用した別の例: |
| | |
| | <code bash> |
| | …/include/api.php?op=set&op2=update_plugin_module&id=135&other=|0|2|0|0||0|0||0|0|127.0.0.1|0||0|300|0|0|0|0|plugin%20module%20from%20api|2|admin|pass|-p%20max|||||||||||||2020&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora" |
| </code> | </code> |
| |
| |
| <WRAP center round important 60%> | <WRAP center round important 60%> |
| | |
| これによりデータベースにモジュールデータを追加することはできますが、該当モジュールに関するエージェントの設定ファイルを変更することはできません。 | これによりデータベースにモジュールデータを追加することはできますが、該当モジュールに関するエージェントの設定ファイルを変更することはできません。 |
| | |
| </WRAP> | </WRAP> |
| | |
| | It updates the local module. |
| |
| ローカルモジュールを更新します。 | ローカルモジュールを更新します。 |
| |
| [[:en:documentation:08_technical_reference:02_annex_externalapi#external_api|Call syntax]]: | [[#external_api|Call syntax]]: |
| |
| [[:ja:documentation:08_technical_reference:02_annex_externalapi#外部_api|書式]]: | [[#pandora_fms_外部_api|書式]]: |
| |
| * ''op=set'' (required). | * ''op=set'' (required). |
| * ''id=''< id_module_agent > (required) module's numeric ID to update. | * ''id=''< id_module_agent > (required) module's numeric ID to update. |
| * ''other=''< serialized parameters > (required) module data and module configuration in serialized order: | * ''other=''< serialized parameters > (required) module data and module configuration in serialized order: |
| * < id_agent > | - < id_agent > |
| * < disabled > use ''1'' for disable, ''0'' //for no changes//. | - < disabled > use ''1'' for disable, ''0'' //for no changes//. |
| * < description > | - < description > |
| * < id_module_group > see [[:en:documentation:08_technical_reference:02_annex_externalapi#get_module_groups|get_module_groups]]. | - < id_module_group > see [[#get_module_groups|get_module_groups]]. |
| * < min > | - < min > |
| * < max > | - < max > |
| * < post_process > ( {{:wiki:icono-modulo-enterprise.png?23x23|Enterprise version}}only for [[:en:documentation:02_installation:05_configuration_agents#module_postprocess|Software Agents]] with remote configuration enabled). | - < post_process > ( {{:wiki:icono-modulo-enterprise.png?23x23|Enterprise version}}only for [[:en:documentation:pandorafms:installation:05_configuration_agents#module_postprocess|Software Agents]] with remote configuration enabled). |
| * < [[:en:documentation:02_installation:05_configuration_agents#module_interval|module_interval]] > | - < [[:en:documentation:pandorafms:installation:05_configuration_agents#module_interval|module_interval]] > |
| * < min_warning > | - < min_warning > |
| * < max_warning > | - < max_warning > |
| * < str_warning > | - < str_warning > |
| * < min_critical > | - < min_critical > |
| * < max_critical > | - < max_critical > |
| * < str_critical > | - < str_critical > |
| * < [[:en:documentation:05_big_environments:09_pandorafms_engineering#database_main_tables|history_data]] > If it is set at ''0'', module data will not be saved at ''tagente_datos'', only ''tagent_estado'' will be updated. | - < [[:en:documentation:pandorafms:complex_environments_and_optimization:09_pandorafms_engineering#database_main_tables|history_data]] > If it is set at ''0'', module data will not be saved at ''tagente_datos'', only ''tagent_estado'' will be updated. |
| * < disabled_types_event > JSON forma, example: ''{"going_unknown":1}'' . | - < disabled_types_event > JSON forma, example: ''{"going_unknown":1}'' . |
| * < module_macros > It should be a base64 encoded JSON document made up by an object with one property for each macro. The format of the JSON properties should be //"<macro name>": "<macro value>"//. | - < module_macros > It should be a base64 encoded JSON document made up by an object with one property for each macro. The format of the JSON properties should be //"<macro name>": "<macro value>"//. |
| * < min_ff_event > Number of times a change of state condition has to occur before the change of state can take place (//[[:en:documentation:01_understanding:03_glossary#flip-flop_protection|flipflop]]// ). | - < min_ff_event > Number of times a change of state condition has to occur before the change of state can take place (//[[:en:documentation:pandorafms:introduction:03_glossary#flip-flop_protection|flipflop]]// ). |
| * < each_ff > | - < each_ff > |
| * < min_ff_event_normal > | - < min_ff_event_normal > |
| * < min_ff_event_warning > | - < min_ff_event_warning > |
| * < min_ff_event_critical > | - < min_ff_event_critical > |
| * < ff_timeout > | - < ff_timeout > |
| * < critical_inverse > | - < critical_inverse > |
| * < warning_inverse > | - < warning_inverse > |
| * < policy_linked > | - < policy_linked > |
| * < ff_type > | - < ff_type > |
| | - < ignore_unknown > Accepts values ''0'' and ''1''. |
| |
| * ''op=set'' (必須) | * ''op=set'' (必須) |
| * ''id=''<モジュールID> (必須) 更新するモジュールの数値 ID。 | * ''id=''<モジュールID> (必須) 更新するモジュールの数値 ID。 |
| * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 | * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 |
| * < エージェントID > | - < エージェントID > |
| * < 無効化 > 無効化の場合は ''1''、//変更なし// は ''0''。 | - < 無効化 > 無効化の場合は ''1''、//変更なし// は ''0''。 |
| * < 説明 > | - < 説明 > |
| * < モジュールグループID > [[:ja:documentation:08_technical_reference:02_annex_externalapi#get_module_groups|get_module_groups]] を参照。 | - < モジュールグループID > [[#get_module_groups|get_module_groups]] を参照。 |
| * < 最小 > | - < 最小 > |
| * < 最大 > | - < 最大 > |
| * < 保存倍率 > ( {{:wiki:icono-modulo-enterprise.png?23x23|Enterprise 版}}([[:ja:documentation:02_installation:05_configuration_agents#module_postprocess|ソフトウエアエージェント]] でリモート設定が有効な場合のみ) | - < 保存倍率 > ( {{:wiki:icono-modulo-enterprise.png?23x23|Enterprise 版}}([[:ja:documentation:pandorafms:installation:05_configuration_agents#module_postprocess|ソフトウエアエージェント]] でリモート設定が有効な場合のみ) |
| * < [[:ja:documentation:02_installation:05_configuration_agents#module_interval|モジュールの間隔]] > | - < [[:ja:documentation:pandorafms:installation:05_configuration_agents#module_interval|モジュールの間隔]] > |
| * < 警告の最小値 > | - < 警告の最小値 > |
| * < 警告の最大値 > | - < 警告の最大値 > |
| * < 警告文字列 > | - < 警告文字列 > |
| * < 障害の最小値 > | - < 障害の最小値 > |
| * < 障害の最大値 > | - < 障害の最大値 > |
| * < 障害文字列 > | - < 障害文字列 > |
| * < [[:ja:documentation:05_big_environments:09_pandorafms_engineering#database_main_tables|データの保存]] > ''0'' に設定するとモジュールのデータは、''tagente_datos'' に保存されません。''tagent_estado'' のみ更新されます。 | - < [[:ja:documentation:pandorafms:complex_environments_and_optimization:09_pandorafms_engineering#database_main_tables|データの保存]] > ''0'' に設定するとモジュールのデータは、''tagente_datos'' に保存されません。''tagent_estado'' のみ更新されます。 |
| * < 無効化イベント > JSON フォーマット。例: ''{"going_unknown":1}'' | - < 無効化イベント > JSON フォーマット。例: ''{"going_unknown":1}'' |
| * < モジュールマクロ > これは、マクロごとに 1 つのプロパティを持つオブジェクトで構成された、base64 でエンコードされた JSON ドキュメントである必要があります。JSON プロパティのフォーマット: //"<macro name>": "<macro value>"// | - < モジュールマクロ > これは、マクロごとに 1 つのプロパティを持つオブジェクトで構成された、base64 でエンコードされた JSON ドキュメントである必要があります。JSON プロパティのフォーマット: //"<macro name>": "<macro value>"// |
| * < 連続抑制回数 > モジュールの監視結果が何回連続で変化したらモジュールの状態を変更するかの値。(//[[:ja:documentation:01_understanding:03_glossary#連続抑制回数|連続抑制回数]]// ) | - < 連続抑制回数 > モジュールの監視結果が何回連続で変化したらモジュールの状態を変更するかの値。(//[[:ja:documentation:pandorafms:introduction:03_glossary#連続抑制回数|連続抑制回数]]// ) |
| * < 個別状態変化の利用 > | - < 個別状態変化の利用 > |
| * < 正常移行時連続抑制回数 > | - < 正常移行時連続抑制回数 > |
| * < 警告移行時連続抑制回数 > | - < 警告移行時連続抑制回数 > |
| * < 障害移行時連続抑制回数 > | - < 障害移行時連続抑制回数 > |
| * < 連続抑制タイムアウト > | - < 連続抑制タイムアウト > |
| * < 障害条件の反転 > | - < 障害条件の反転 > |
| * < 警告条件の反転 > | - < 警告条件の反転 > |
| * < 関連ポリシー > | - < 関連ポリシー > |
| * < 連続抑制カウンタの維持 > | - < 連続抑制カウンタの維持 > |
| | - < 不明の無視 > ''0'' または ''1'' |
| |
| **Example (see ** **[[:en:documentation:08_technical_reference:02_annex_externalapi#external_api|call syntax]]****):** | **Example (see ** **[[#external_api|call syntax]]****):** |
| |
| **例 ([[:ja:documentation:08_technical_reference:02_annex_externalapi#外部_api|書式]]を参照):** | **例 ([[#pandora_fms_外部_api|書式]]を参照):** |
| |
| <code bash> | <code bash> |
| |
| === set update_data_module_policy === | === set update_data_module_policy === |
| | |
| | It updates a data module in a policy and returns an id from the new module. |
| |
| ポリシーのデータモジュールを更新し、新たなモジュールの ID を返します。 | ポリシーのデータモジュールを更新し、新たなモジュールの ID を返します。 |
| |
| 書式: | **[[#pandora_fms_external_api|Call syntax]]**: |
| * ''op=set'' (required). | |
| * ''op2=update_data_module_policy'' (required). | |
| * ''id=''<id_policy> (required). Numeric identificator of the **target policy**. | |
| * ''other=''<serialized parameters> (required). They are module configuration and data, serialized in the following order: | |
| * <id_policy_module> | |
| * <description> | |
| * <id_module_group> | |
| * <min> | |
| * <max> | |
| * <post_process> | |
| * <module_interval> | |
| * <min_warning> | |
| * <max_warning> | |
| * <min_critical> | |
| * <max_critical> | |
| * <str_critical> | |
| * <history_data> | |
| * <configuration_data> | |
| * <disabled_types_event> | |
| * <module_macros> It should be a base64 encoded JSON document made up by an object with one property for each macro. The format of the JSON properties should be: | |
| * ''< macro name >:< macro value >''. | |
| |
| * op=set (必須) | **[[#pandora_fms_外部_api|書式]]**: |
| * op2=update_data_module_policy (必須) | |
| * id=<id_policy> (必須) 対象のポリシーモジュールID。 | |
| * other=<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。: | |
| * <ポリシーモジュールID> | |
| * <説明> | |
| * <モジュールグループID> | |
| * <最小> | |
| * <最大> | |
| * <事前処理> | |
| * <モジュールの間隔> | |
| * <警告の最小値> | |
| * <警告の最大値> | |
| * <障害の最小値> | |
| * <障害の最大値> | |
| * <障害の文字列> | |
| * <データの保存> | |
| * <設定データ> | |
| * <disabled_types_event> | |
| * <モジュールマクロ> (バージョン 5以降) 各マクロに対して 1つのプロパティを持つオブジェクトによって形成された、base64 でエンコードされた JSON ドキュメントである必要があります。JSON フォーマットは、次のようになっている必要があります。 | |
| * ''<マクロ名>:<マクロ値>'' | |
| |
| **例** ([[:ja:documentation:08_technical_reference:02_annex_externalapi#pandora_fms_外部_api|呼び出し書式]]を参照): | * ''op=set'' (required). |
| | * ''op2=update_data_module_policy'' (required). |
| | * ''id=''< id_policy > (required). Numeric identification of the **target policy**. |
| | * ''other=''< serialized parameters > (required). They are module configuration and data, serialized in the following order: |
| | |
| | * ''op=set'' (必須) |
| | * ''op2=update_data_module_policy'' (必須) |
| | * ''id=''<id_policy> (必須) 対象のポリシーモジュールID。 |
| | * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。: |
| | |
| | - < id_policy_module > |
| | - < description > |
| | - < id_module_group > |
| | - < min > |
| | - < max > |
| | - < post_process > |
| | - < module_interval > |
| | - < min_warning > |
| | - < max_warning > |
| | - < min_critical > |
| | - < max_critical > |
| | - < str_critical > |
| | - < history_data > |
| | - < configuration_data > |
| | - < disabled_types_event > |
| | - < module_macros > It should be a base64 encoded JSON document made up by an object with one property for each macro. The format of the JSON properties should be: ''< macro name >:< macro value >''. |
| | - < ignore_unknown > Accepts values ''0'' and ''1''. |
| | |
| | - <ポリシーモジュールID> |
| | - <説明> |
| | - <モジュールグループID> |
| | - <最小> |
| | - <最大> |
| | - <事前処理> |
| | - <モジュールの間隔> |
| | - <警告の最小値> |
| | - <警告の最大値> |
| | - <障害の最小値> |
| | - <障害の最大値> |
| | - <障害の文字列> |
| | - <データの保存> |
| | - <設定データ> |
| | - <disabled_types_event> |
| | - <モジュールマクロ> (バージョン 5以降) 各マクロに対して 1つのプロパティを持つオブジェクトによって形成された、base64 でエンコードされた JSON ドキュメントである必要があります。JSON フォーマットは、''<マクロ名>:<マクロ値>'' のようになっている必要があります。 |
| | - <不明の無視> ''0'' または ''1'' |
| | |
| | **Example (see [[#pandora_fms_external_api|call syntax]]):** |
| | |
| | **例 ([[#pandora_fms_外部_api|書式]]を参照):** |
| |
| <code bash> | <code bash> |
| |
| </code> | </code> |
| |
| |
| === set update_SNMP_module === | === set update_SNMP_module === |
| | |
| | It updates an SNMP module. |
| |
| SNMP モジュールを更新します。 | SNMP モジュールを更新します。 |
| |
| 書式: | [[#pandora_fms_external_api|Call syntax]]: |
| * op=set (必須) | |
| * op2=update_snmp_module (必須) | [[#pandora_fms_外部_api|書式]]: |
| * id=<モジュールID> (必須) モジュールIDでなければいけません。 | |
| * other=<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 | * ''op=set'' (required). |
| * <エージェントID> | * ''op2=update_snmp_module'' (required). |
| * <無効化> | * ''id=''< module_id > (required). It should be a module id. |
| * <モジュールグループID> | * ''other=''< serialized parameters > (required). They are module configuration and data, serialized in the following order: |
| * <警告の最小値> | |
| * <警告の最大値> | * ''op=set'' (必須) |
| * <警告文字列> | * ''op2=update_snmp_module'' (必須) |
| * <障害の最小値> | * ''id=''<モジュールID> (必須) モジュールIDでなければいけません。 |
| * <障害の最大値> | * ''other=''<連続パラメータ> (必須) 次の順番でモジュールの設定とデータを指定します。 |
| * <障害文字列> | |
| * <連続抑制回数> | - < id_agent > |
| * <データの保存> | - < disabled > |
| * <対象のIP> | - < id_module_group > |
| * <モジュールのポート> | - < min_warning > |
| * <SNMPバージョン> | - < max_warning > |
| * <SNMPコミュニティ> | - < str_warning > |
| * <SNMP OID> | - < min_critical > |
| * <モジュールの間隔> | - < max_critical > |
| * <データ保存倍率> | - < str_critical > |
| * <最小値> | - < ff_threshold > |
| * <最大値> | - < history_data > |
| * <カスタムID> | - < ip_target > |
| * <説明> | - < module_port > |
| * <snmp3 暗号化方式 [AES|DES]> | - < snmp_version > |
| * <snmp3 暗号化パスワード> | - < snmp_community > |
| * <snmp3 セキュリティレベル [authNoPriv|authPriv|noAuthNoPriv]> | - < snmp_oid > |
| * <snmp3 認証方式 [MD5|SHA]> | - < module_interval > |
| * <snmp3 認証ユーザ> | - < post_process > |
| * <snmp3 認証パスワード> | - < min_value > |
| * <イベントタイプの無効化> (バージョン 5 以降のみ) | - < max_value > |
| * <個別状態変化の利用> (バージョン 5.1 以降のみ) | - < custom_id > |
| * <正常移行時連続抑制回数> (バージョン 5.1 以降のみ) | - < description > |
| * <警告移行時連続抑制回数> (バージョン 5.1 以降のみ) | - < snmp3_priv_method [AES|DES] > |
| * <障害移行時連続抑制回数> (バージョン 5.1 以降のみ) | - < snmp3_priv_pass > |
| * <ff_type> (バージョン 733 以降のみ) | - < snmp3_sec_level [authNoPriv|authPriv|noAuthNoPriv] > |
| | - < snmp3_auth_method [MD5|SHA] > |
| | - < snmp3_auth_user > |
| | - < snmp3_auth_pass > |
| | - < disabled_types_event > |
| | - < each_ff > |
| | - < ff_threshold_normal > |
| | - < ff_threshold_warning > |
| | - < ff_threshold_critical> |
| | - < policy_linked > |
| | - < ff_type > |
| | - < ignore_unknown > Accepts values ''0'' and ''1''. |
| | - < number_of_intervals_in_warning > Allows state scaling by specifying the maximum number of consecutive intervals in which the module remains in warning state. If this value is exceeded, the module will escalate to critical status. |
| | |
| | - <エージェントID> |
| | - <無効化> |
| | - <モジュールグループID> |
| | - <警告の最小値> |
| | - <警告の最大値> |
| | - <警告文字列> |
| | - <障害の最小値> |
| | - <障害の最大値> |
| | - <障害文字列> |
| | - <連続抑制回数> |
| | - <データの保存> |
| | - <対象のIP> |
| | - <モジュールのポート> |
| | - <SNMPバージョン> |
| | - <SNMPコミュニティ> |
| | - <SNMP OID> |
| | - <モジュールの間隔> |
| | - <データ保存倍率> |
| | - <最小値> |
| | - <最大値> |
| | - <カスタムID> |
| | - <説明> |
| | - <snmp3 暗号化方式 [AES|DES]> |
| | - <snmp3 暗号化パスワード> |
| | - <snmp3 セキュリティレベル [authNoPriv|authPriv|noAuthNoPriv]> |
| | - <snmp3 認証方式 [MD5|SHA]> |
| | - <snmp3 認証ユーザ> |
| | - <snmp3 認証パスワード> |
| | - <イベントタイプの無効化> |
| | - <個別状態変化の利用> |
| | - <正常移行時連続抑制回数> |
| | - <警告移行時連続抑制回数> |
| | - <障害移行時連続抑制回数> |
| | - <リンクポリシー> |
| | - <ff_type> |
| | - <不明の無視> ''0'' または ''1'' |
| | - < 警告の間隔数 > モジュールが警告状態に留まる連続間隔の最大数を指定することにより、状態のスケーリングを可能にします。 この値を超えると、モジュールは障害状態にエスカレートします。 |
| | |
| | Example ([[#pandora_fms_external_api|see call syntax)]]: |
| | |
| | 例 ([[#pandora_fms_外部_api|書式を参照]]): |
| | |
| | (SNMP v: 3, snmp3_priv_method: AES, snmp3_priv_pass: example_priv_passw, snmp3_sec_level: authNoPriv, snmp3_auth_method:MD5, snmp3_auth_user: pepito_user, snmp3_auth_pass: example_priv_passw): |
| |
| **例** | |
| 例 (SNMPバージョン: 3、snmp3暗号化方式: AES、snmp3暗号化パスワード: example_priv_passw、snmp3セキュリティレベル: authNoPriv、snmp3認証方式:MD5、snmp3認証ユーザ: pepito_user、snmp3認証パスワード: example_priv_passw) | 例 (SNMPバージョン: 3、snmp3暗号化方式: AES、snmp3暗号化パスワード: example_priv_passw、snmp3セキュリティレベル: authNoPriv、snmp3認証方式:MD5、snmp3認証ユーザ: pepito_user、snmp3認証パスワード: example_priv_passw) |
| |
| <code> | <code bash> |
| http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_snmp_module&id=33432&other=44 |0|6|20|25||26|30||15|1|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|0|SNMP%20module%20modified%20by%20API|AES|example_priv_passw|authNoPriv|MD5|pepito_user|example_auth_passw&other_mode=url_encode_separator_| | …/include/api.php?op=set&op2=update_snmp_module&id=33432&other=44|0|6|20|25||26|30||15|1|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|0|SNMP%20module&20modified%20by%20API|AES|example_priv_passw|authNoPriv|MD5|example_user|example_auth_passw&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora |
| | |
| | </code> |
| | |
| | Another example with state scaling and SNMP v1: |
| | |
| | 状態スケーリングと SNMP v1 を使用した別の例: |
| | |
| | <code bash> |
| | …/include/api.php?op=set&op2=update_snmp_module&id=137&other=|0|6|20|25||26|30||15|1|127.0.0.1|60|1|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|||||||||||2020&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora" |
| | |
| | </code> |
| | |
| | Another example with state scaling and SNMP v3: |
| | |
| | 状態スケーリングと SNMP v3 を使用した別の例: |
| | |
| | <code bash> |
| | …/include/api.php?op=set&op2=update_snmp_module&id=138&other=|0|6|20|25||26|30||15|1|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|0|SNMP%20module%20modified%20by%20API|AES|example_priv_passw|authNoPriv|MD5|example_user|example_auth_passw|||||||||2020&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora" |
| </code> | </code> |
| |