付録2. 6.4から7.0での変更点
後方互換性のない変更点
アラート
ZBXNEXT-6974 alert.get: メソッドパラメータの厳密な検証を追加しました。
認証
ZBXNEXT-8880 のプロパティ http_auth_enabled、http_login_form、http_strip_domains、http_case_sensitive は、Webインターフェース設定ファイル(zabbix.conf.php)で $ALLOW_HTTP_AUTH が有効になっている場合にのみ利用できます。
コネクタ
ZBXNEXT-8735 新しいプロパティ item_value_type を追加しました。これは、data_type が "Item values" (0) に設定されている場合にサポートされます。
ZBXNEXT-8735 新しいプロパティ attempt_interval を追加しました。これは、max_attempts が 1 より大きい場合にサポートされます。
ダッシュボード
ZBXNEXT-8316, ZBXNEXT-9193, ZBX-24488, ZBX-24490 dashboard widget のタイプ plaintext を itemhistory に名称変更し、そのダッシュボードウィジェットフィールド itemids.0、style、show_as_html を columns.0.itemid、layout、columns.0.display に置き換え、新しいダッシュボードウィジェットフィールドを追加しました。
ZBXNEXT-8496 tophosts ウィジェットで、ダッシュボードウィジェットフィールド columns.0.timeshift、columns.0.aggregate_interval を columns.0.time_period._reference、columns.0.time_period.from、columns.0.time_period.from に置き換えました。
ZBXNEXT-2299 problems ウィジェットで、ダッシュボードウィジェットフィールド unacknowledged を 2 つの新しいフィールド acknowledgement_status および acknowledged_by_me に置き換えました。
ZBXNEXT-8245 clock および item ウィジェットで、ダッシュボードウィジェットフィールド adv_conf を削除しました。
ZBXNEXT-8145 ダッシュボードウィジェットフィールドの命名を変更しました: 複雑なデータフィールドは str.str.index1.index2 から str.index1.str.index2 に名称変更されました(例: thresholds.0.threshold.1、ds.0.hosts.1)。データベースオブジェクトを参照するフィールドは str から str.index1 に名称変更されました(例: itemid.0、severities.0)。
ZBXNEXT-8145 map ウィジェットで、ダッシュボードウィジェットフィールド filter_widget_reference を sysmapid._reference に置き換え、フィールド source_type を削除しました。
ZBXNEXT-8145 gauge、graph、graphprototype、item、plaintext、および url ウィジェットで、ダッシュボードウィジェットフィールド dynamic を override_hostid._reference に置き換えました。
ZBXNEXT-8145 svggraph ウィジェットで、ダッシュボードウィジェットフィールド graph_time を time_period._reference に、time_from を time_period.from に、time_to を time_period.to に置き換えました。
ZBXNEXT-9044 ダッシュボードウィジェットパラメータ x(0-23 から 0-71 に変更)および y(0-62 から 0-63 に変更)、ならびに width(1-24 から 1-72 に変更)および height(2-32 から 1-64 に変更)の値の範囲を変更しました。
discoveryrule
ZBXNEXT-7578 discoveryrule.get、discoveryrule.create、discoveryrule.update: プロパティ headers および query_fields は、名前をインデックスとするオブジェクトから、name と value の各プロパティを個別に持つオブジェクトの配列に変更されました。
イベント
ZBXNEXT-6974 event.get: メソッドパラメータの厳密なバリデーションを追加しました。
ホスト
ZBXNEXT-8758 monitored_by が "Proxy" に設定されている場合、proxyid プロパティが 必須 になりました。proxyid を使用するAPIリクエストでは、monitored_by も併せて使用する必要があります。
ZBXNEXT-5878 host.create、host.update、host.massAdd、host.massUpdate、host.massRemove: groups、macros、tags、templates パラメータの厳密なバリデーションを追加しました。
ZBXNEXT-8500 host.get: proxy_hosts パラメータのサポートを削除しました。
ZBXNEXT-8500 proxy_hostid プロパティの名前を proxyid に変更しました。
ホストグループ
ZBXNEXT-8702 hostgroup.get: パラメータ selectHostPrototype を selectHostPrototypes に、selectDiscoveryRule を selectDiscoveryRules に、selectGroupDiscovery を selectGroupDiscoveries に名称変更しました。各パラメータは、オブジェクトではなくオブジェクトの配列を返すようになりました。
ZBXNEXT-8702 hostgroup.get: 出力プロパティ hostPrototype を hostPrototypes に、discoveryRule を discoveryRules に、groupDiscovery を groupDiscoveries に名称変更しました。
ZBXNEXT-8702 hostgroup.get: selectGroupDiscoveries パラメータ(以前は selectGroupDiscovery)での groupid プロパティのサポートを削除しました。
アイテム
ZBXNEXT-7726 タイプ「サポートされていない値をチェック」の前処理ステップでは、paramsプロパティが 必須 になりました。
ZBXNEXT-7578 item.get、item.create、item.update: headersプロパティとquery_fieldsプロパティは、名前をインデックスとするオブジェクトから、nameプロパティとvalueプロパティを個別に持つオブジェクトの配列に変更されました。
アイテムのプロトタイプ
ZBXNEXT-7726 タイプが「サポートされていない値をチェック」である前処理ステップでは、params プロパティが必須になりました。
ZBXNEXT-7578 itemprototype.get、itemprototype.create、itemprototype.update: headers および query_fields プロパティは、名前をインデックスとするオブジェクトから、name プロパティと value プロパティを個別に持つオブジェクトの配列に変更されました。
問題
ZBXNEXT-6974 problem.get: メソッドパラメータの厳密なバリデーションを追加しました。
プロキシ
ZBXNEXT-8500 interface および auto_compress オブジェクトプロパティを削除しました。
ZBXNEXT-8500 パッシブZabbixプロキシ用の address および port プロパティを追加しました。
ZBXNEXT-8500 プロパティ名を host から name、status から operating_mode、proxy_address から allowed_addresses に変更しました。
ZBXNEXT-8500 operating_mode(以前の status)プロパティの値を変更しました(0 - アクティブプロキシ、1 - パッシブプロキシ)。
ZBXNEXT-8500 proxy.get: パラメータ selectInterface のサポートを削除しました。
ZBXNEXT-8500 proxy.create および proxy.update: パラメータ interface のサポートを削除しました。
スクリプト
ZBXNEXT-8880 script.create および script.update: パラメータ execute_on の値 "1"(Zabbixサーバー上で実行)は、Zabbixサーバーでグローバルスクリプトの実行が有効になっている場合にのみサポートされます。
ZBXNEXT-8121 script.getscriptsbyhosts: このメソッドはホストIDの配列を受け付けなくなりました。現在は、hostid、scriptid、manualinput の各パラメータを含むオブジェクトを受け付けます。
ZBXNEXT-8121 script.getscriptsbyevents: このメソッドはイベントIDの配列を受け付けなくなりました。現在は、eventid、scriptid、manualinput の各パラメータを含むオブジェクトを受け付けます。
タスク
ZBXNEXT-8500 プロパティ proxy_hostid の名前を proxyid に変更しました。
templatedashboard
ZBXNEXT-9044 ダッシュボードウィジェットのパラメータ x(0-23 から 0-71 へ)および y(0-62 から 0-63 へ)、ならびに width(1-24 から 1-72 へ)および height(2-32 から 1-64 へ)の値の範囲を変更しました。
ユーザー
ZBXNEXT-8760 user.update: ユーザーのプロパティ userdirectoryid は読み取り専用になりました。
ZBXNEXT-8760 user.get: プロビジョニングアクションによって作成されたメディア用の新しい読み取り専用プロパティ userdirectory_mediaid を追加しました。
userdirectory
ZBXNEXT-8760 userdirectory.create、userdirectory.update: メディアマッピングに新しいプロパティ active、severity、period を追加しました。
usergroup
ZBXNEXT-8760 usergroup.update: プロビジョニングされたユーザーについて、グループユーザーの変更に制限を追加しました。
その他の変更点およびバグフィックス
アクション
ZBXNEXT-6524 operations プロパティでのみ利用可能な、2つの eventsource アクションタイプ(1 - ディスカバリ、2 - 自動登録)に対して、operationtype プロパティの2つの新しい値(13 - ホストタグの追加、14 - ホストタグの削除)および新しいプロパティ optag のサポートを追加しました。
ZBX-21850 action.get: フィルター条件は、数式内で配置された順序でソートされます。
auditlog
ZBXNEXT-8541 新しいaudit logのエントリアクション(12 - Push)およびリソースタイプ(53 - History)を追加しました。
認証
ZBXNEXT-6876 新しいプロパティ mfa_status および mfaid を追加しました。
mfa
ZBXNEXT-6876 メソッドmfa.create、mfa.update、mfa.get、mfa.deleteを持つ新しいMFA APIを追加しました。
ダッシュボード
ZBXNEXT-8956 複数のウィジェットに新しいダッシュボードウィジェットフィールド groupids._reference、hostids._reference、itemid._reference、graphid._reference、reference を追加しました。
ZBXNEXT-9057 systeminfo ウィジェットに新しいダッシュボードウィジェットフィールド show_software_update_check_details を追加しました。
ZBXNEXT-8686 新しいダッシュボードウィジェットタイプ itemnavigator を追加しました。
ZBXNEXT-8685 新しいダッシュボードウィジェットタイプ hostnavigator を追加しました。
ZBXNEXT-8683 新しいダッシュボードウィジェットタイプ honeycomb を追加しました。
ZBXNEXT-8907 graph ウィジェットに新しいダッシュボードウィジェットフィールド legend_lines_mode を追加しました。
ZBXNEXT-8496 item ウィジェットに新しいダッシュボードウィジェットフィールド aggregate_function、history、time_period._reference、time_period.from、time_period.from を追加しました。
ZBXNEXT-7736 hostavail ウィジェットに新しいダッシュボードウィジェットフィールド interface_type の値 (5 - Zabbix Agent(active checks)) を追加しました。
ZBXNEXT-7736 hostavail ウィジェットに新しいダッシュボードウィジェットフィールド only_totals を追加しました。
ZBXNEXT-7687 tophosts ウィジェットに新しいダッシュボードウィジェットフィールド maintenance を追加しました。
ZBXNEXT-6974 新しいダッシュボードウィジェットタイプ toptriggers を追加しました。
ZBXNEXT-743 新しいダッシュボードウィジェットタイプ gauge を追加しました。
ZBXNEXT-8331, ZBXNEXT-8145, ZBXNEXT-8908, ZBXNEXT-8907 新しいダッシュボードウィジェットタイプ piechart を追加しました。
ZBXNEXT-8331 graph ウィジェットに新しいダッシュボードウィジェットフィールド legend_aggregation を追加しました。
ZBXNEXT-8145 svggraph、graph、graphprototype ウィジェットに新しいダッシュボードウィジェットフィールド reference を追加しました。
ZBXNEXT-8145 actionlog、graph、graphprototype、toptriggers ウィジェットに新しいダッシュボードウィジェットフィールド time_period._reference、time_period.from、time_period.to を追加しました。
dcheck
ZBXNEXT-8079 新しいプロパティ allow_redirect を追加しました。
discoveryrule
ZBXNEXT-9150 新しいLLDルール type(22 - Browser)を追加しました。
ZBXNEXT-8645 新しいLLDルールの前処理タイプ「SNMP get value」(30)を追加しました。
ZBXNEXT-8645 アイテム type が「SNMP agent」(20)に設定され、snmp_oid が「get[」で始まる場合、プロパティ timeout もサポートされるようになりました。
ZBXNEXT-1096 アイテム type が「Zabbix agent」(0)、「Simple check」(3)で、key_ が「vmware.」および「icmpping」で始まらない場合、「Zabbix agent (active)」(7)、「External check」(10)、「Database monitor」(11)、「SSH agent」(13)、「TELNET agent」(14)、「SNMP agent」(20)で snmp_oid が「walk[」で始まる場合に、プロパティ timeout がサポートされるようになりました。
ZBXNEXT-7726 LLDルールの前処理タイプ「Matches regular expression」(14)のサポートを追加しました。
ZBXNEXT-6986 メソッド discoveryrule.copy は非推奨になりました。
ZBXNEXT-7578 query_fields プロパティにより多くのデータを保存できるようになり、header および query_fields のエントリを繰り返して持てるようになりました。
ZBXNEXT-2020 新しいプロパティ lifetime_type、enabled_lifetime、enabled_lifetime_type を追加しました。
ZBXNEXT-2020 lifetime パラメータのデフォルト値を 30d から 7d に変更しました。
ZBX-21850 discoveryrule.get: フィルター条件は、数式内で配置された順序でソートされるようになります。
drule
ZBXNEXT-2732 新しいプロパティ concurrency_max を追加しました。
ZBXNEXT-8500 proxy_hostid を proxyid に名称変更しました
イベント
ZBXNEXT-6974 event.get: 新しいパラメータ selectAcknowledges、selectAlerts、trigger_severities、groupBy を追加しました。
ZBXNEXT-6974 event.get: パラメータ select_acknowledges および select_alerts は非推奨になりました。
ZBXNEXT-2299, ZBX-23240 event.get: 新しいパラメータ action および action_userids を追加しました。
graph
ZBXNEXT-2020 graph.get: パラメーターselectGraphDiscoveryが使用されている場合、statusプロパティもサポートされるようになりました。
履歴
ZBXNEXT-9193 history.get: パラメータ sortfield が ns をサポートするようになりました。
ZBXNEXT-8541 新しいメソッド history.push を追加しました。
ホスト
ZBXNEXT-8758 新しいプロパティ monitored_by および proxy_groupid を追加しました。
ZBXNEXT-8758 新しい読み取り専用プロパティ assigned_proxyid を追加しました。
ZBXNEXT-8758 host.get: 新しいパラメータ proxy_groupids を追加しました。
ZBXNEXT-2020 host.get: selectHostDiscovery パラメータが使用されている場合、このメソッドは status、ts_disable、disable_source プロパティもサポートするようになりました。
hostgroup
ZBXNEXT-2020 hostgroup.get: パラメーターselectGroupDiscoveriesが使用されている場合、statusプロパティもサポートされるようになりました。
hostprototype
ZBX-23284 hostprototype.get, hostprototype.update: グループプロトタイプオブジェクトのgroup_prototypeidプロパティのサポートが返されました。
アイテム
ZBXNEXT-9150 新しいアイテム type(22 - Browser)を追加しました。
ZBXNEXT-7460 新しい読み取り専用プロパティ name_resolved を追加しました。
ZBXNEXT-8645 新しいアイテムの前処理タイプ「SNMP get value」(30)を追加しました。
ZBXNEXT-8645 アイテム type が「SNMP agent」(20)に設定され、snmp_oid が「get[」で始まる場合、プロパティ timeout もサポートされるようになりました。
ZBXNEXT-1096 アイテム type が「Zabbix agent」(0)、「Simple check」(3)で、key_ が「vmware.」および「icmpping」で始まらない場合、「Zabbix agent (active)」(7)、「External check」(10)、「Database monitor」(11)、「SSH agent」(13)、「TELNET agent」(14)、「SNMP agent」(20)で snmp_oid が「walk[」で始まる場合に、プロパティ timeout がサポートされるようになりました。
ZBXNEXT-7726 「Check for not supported value」タイプのステップのパラメータに、scope および pattern コンポーネントを追加しました。
ZBXNEXT-7578 query_fields プロパティにより多くのデータを保存できるようになり、header および query_fields のエントリを繰り返して指定できるようになりました。
ZBXNEXT-2020 item.get: selectItemDiscovery パラメータが使用されている場合、このメソッドは status、ts_disable、disable_source プロパティもサポートするようになりました。
アイテムのプロトタイプ
ZBXNEXT-9150 新しいアイテムのプロトタイプ type(22 - Browser)が追加されました。
ZBXNEXT-8645 新しいアイテムのプロトタイプの前処理タイプ「SNMP get value」(30)が追加されました。
ZBXNEXT-8645 アイテム type が「SNMP agent」(20)に設定され、snmp_oid が "get[" で始まる場合、プロパティ timeout もサポートされるようになりました。
ZBXNEXT-1096 アイテム type が「Zabbix agent」(0)、「Simple check」(3)で key_ が "vmware." および "icmpping" で始まらない場合、「Zabbix agent (active)」(7)、「External check」(10)、「Database monitor」(11)、「SSH agent」(13)、「TELNET agent」(14)、「SNMP agent」(20)で snmp_oid が "walk[" で始まる場合に、プロパティ timeout がサポートされるようになりました。
ZBXNEXT-7726 「Check for not supported value」タイプのステップのパラメータに、scope および pattern コンポーネントが追加されました。
ZBXNEXT-7578 query_fields プロパティにより多くのデータを保存できるようになり、header および query_fields のエントリを繰り返して指定できるようになりました。
メディアタイプ
ZBXNEXT-4165 mediatype.get: 新しいパラメータ selectActions を追加しました。
ZBXNEXT-9138 mediatype.get, mediatype.create, mediatype.update: 新しいプロパティ message_format を追加しました。
ZBXNEXT-9138 mediatype.get, mediatype.create, mediatype.update: プロパティ content_type は非推奨になりました。
相関関係
ZBX-21850 correlation.get: フィルター条件は、数式内で配置されている順序でソートされます。
障害
ZBXNEXT-2299、ZBX-23240 problem.get: 新しいパラメータ action および action_userids を追加しました。
プロキシ
ZBXNEXT-9150 新しいプロパティ timeout_browser を追加しました。
ZBXNEXT-8758 新しい読み取り専用プロパティ state を追加しました。
ZBXNEXT-8758 proxy.get: 新しいパラメータ proxy_groupids、selectAssignedHosts、selectProxyGroup を追加しました。
ZBXNEXT-8758 proxy.get: パラメータ selectHosts が count をサポートするようになりました。
ZBXNEXT-1096 新しいプロパティ custom_timeouts、timeout_zabbix_agent、timeout_simple_check、timeout_snmp_agent、timeout_external_check、timeout_db_monitor、timeout_http_agent、timeout_ssh_agent、timeout_telnet_agent、timeout_script を追加しました。
ZBXNEXT-8500 パッシブZabbixプロキシ用の address および port プロパティを追加しました。
proxygroup
ZBXNEXT-8758 新しいproxygroup APIを追加しました。
role
ZBXNEXT-8758 新しいUI要素 administration.proxy_groups を追加しました。
スクリプト
ZBXNEXT-8121 新しいプロパティ manualinput、manualinput_prompt、manualinput_validator、manualinput_validator_type、manualinput_default_value を追加しました。
ZBXNEXT-8121 script.execute: 新しいパラメータ manualinput を追加しました。
設定
ZBXNEXT-9150 新しいプロパティ timeout_browser を追加しました。
ZBXNEXT-8837 新しいプロパティ auditlog_mode を追加しました。
ZBXNEXT-1096 新しいプロパティ timeout_zabbix_agent、timeout_simple_check、timeout_snmp_agent、timeout_external_check、timeout_db_monitor、timeout_http_agent、timeout_ssh_agent、timeout_telnet_agent、timeout_script を追加しました。
templatedashboard
ZBXNEXT-8686 新しいテンプレートダッシュボードウィジェットタイプ itemnavigator を追加しました。
ZBXNEXT-8685 新しいテンプレートダッシュボードウィジェットタイプ hostnavigator を追加しました。
ZBXNEXT-8683 新しいテンプレートダッシュボードウィジェットタイプ honeycomb を追加しました。
ZBXNEXT-6974 新しいテンプレートダッシュボードウィジェットタイプ toptriggers を追加しました。
ZBXNEXT-743 新しいテンプレートダッシュボードウィジェットタイプ gauge を追加しました。
ZBXNEXT-8086 新しいテンプレートダッシュボードウィジェットタイプ actionlog、dataover、discovery、favgraphs、favmaps、hostavail、map、navtree、problemhosts、problems、problemsbysv、slareport、svggraph、systeminfo、tophosts、trigover、web を追加しました。
ZBXNEXT-8086 新しいテンプレートダッシュボードウィジェットフィールドタイプ(8 - Map、9 - Service、10 - SLA、11 - User、12 - Action、13 - Media type)を追加しました。
ZBXNEXT-8331 新しいテンプレートダッシュボードウィジェットタイプ piechart を追加しました。
trigger
ZBXNEXT-2020 trigger.get: パラメーターselectTriggerDiscoveryが使用されている場合、メソッドはstatus、ts_disable、disable_sourceプロパティもサポートするようになりました。
ユーザー
ZBXNEXT-6876 新しいメソッド user.resettotp を追加しました。
ZBXNEXT-6876 user.login: userData パラメータを使用した場合、このメソッドは mfaid も返すようになりました。
usergroup
ZBXNEXT-6876 新しいプロパティ mfa_status および mfaid を追加しました。
ZBXNEXT-6876 usergroup.get: 新しいパラメータ mfa_status および mfaids を追加しました。