差分

このページの2つのバージョン間の差分を表示します。

--- ja:documentation:pandorafms:technical_reference:02_annex_externalapi [2024/04/16 08:25] – [set update_data_module_policy] junichi
+++ ja:documentation:pandorafms:technical_reference:02_annex_externalapi [2024/04/16 08:32] (現在) – [set update_SNMP_module] junichi
@@ 行 3712: / 行 3712: @@
 === set update_SNMP_module ===
+It updates an SNMP module.
 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)
-<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>