zabbix_manager 5.1.3 → 5.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96bd31db6f13198d30bc1de2ac7168b7e535b17e3b1d80d97a30d852dc509c55
-  data.tar.gz: 9022b530a873d1750502c288201583707303a6128eff5c10f82f125f1538a515
+  metadata.gz: cebae410e9abb93e18e28e5184aca238514910332b5769d132fc282d163d218c
+  data.tar.gz: f02f9e2cbe167a4358dd89da12f7d04f27d84a2e9869bc9d652ef8526671c514
 SHA512:
-  metadata.gz: 8b4e51fc29613d082df8de77f4eab1b9eb12b30acf5d4d36f751bbaf8c657577f21d1faf8e715c4694f78b832b8c02696e5aeb468d1ffbfc9a2b7ecbbd7d1722
-  data.tar.gz: 5e56fdd12fc7afddc2df2f5899fa390f97ba0e7eacafa3141fcfc2dad37ab9aa85f7e8a4553797d6dfbe8aaa286d0ad5932ee2dadb231d4a3b2e2c4a01986c9c
+  metadata.gz: c73a3e5b13a7f514508ed7998bf4df6ffc6a5c778e9a8b5eac620842a3df4555fc4c4fca41d76ad8740665c4d5583ceea2440439113ebd7dd3aeeeb40eab32b4
+  data.tar.gz: d3f0d4c6d9e627f36ba0f1ca87098c6060e20f22218586368139e14d0446dcddef640a998dcd711b4c848ef60e9e9f99b10204a5fe0f69fe28dc6c438f256cf1

data/lib/zabbix_manager/basic/basic_alias.rb

@@ -2,34 +2,17 @@
 
 class ZabbixManager
   class Basic
-    # Get Zabbix object data from API by id
-    # @note 通用的查询方法
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 获取 Zabbix 对象数据
     def get(data)
       get_full_data(data)
     end
 
-    # Add new Zabbix object using API create
-    # @note 通用的新增方法
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 新增 Zabbix 对象
     def add(data)
       create(data)
     end
 
-    # Destroy Zabbix object using API delete
-    # @note 通用的删除方法
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is deleted
-    # @return [Boolean] True/False if multiple objects are deleted
+    # 删除 Zabbix 对象
     def destroy(data)
       delete(data)
     end

data/lib/zabbix_manager/basic/basic_func.rb

@@ -2,31 +2,24 @@
 
 class ZabbixManager
   class Basic
-    # Log messages to stdout when debugging
-    # @note 开启debug模式，打印日志
-    # @param message [String]
+    # 在调试模式下将日志消息记录到 stdout
     def log(message)
       puts message if @client.options[:debug]
     end
 
-    # Compare two hashes for equality
-    # @note 比较两个哈希是否相等
-    # @param first_hash [Hash]
-    # @param second_hash [Hash]
-    # @return [Boolean]
-    def hash_equals?(first_hash, second_hash)
-      normalized_first_hash  = normalize_hash(first_hash)
-      normalized_second_hash = normalize_hash(second_hash)
+    # 比较两个哈希是否相等
+    def hash_equals?(hash1, hash2)
+      normalized_hash1 = normalize_hash(hash1)
+      normalized_hash2 = normalize_hash(hash2)
 
-      hash1 = normalized_first_hash.merge(normalized_second_hash)
-      hash2 = normalized_second_hash.merge(normalized_first_hash)
-      hash1 == hash2
+      merged_hash1 = normalized_hash1.merge(normalized_hash2)
+      merged_hash2 = normalized_hash2.merge(normalized_hash1)
+
+      merged_hash1 == merged_hash2
     end
 
-    # Convert all hash/array keys to symbols
-    # @@note 将数组或哈希序列化
-    # @param object [Array, Hash]
-    # @return [Array, Hash]
+    # 将所有哈希/数组键转换为符号
+    # &method(:symbolize_keys) 是 Ruby 中一种将方法转换为可传递给块或其他方法的 Proc 的方式
     def symbolize_keys(object)
       case object
       when Array
@@ -38,34 +31,27 @@ class ZabbixManager
       end
     end
 
-    # Normalize all hash values to strings
-    # @note 将哈希元素序列化成字符串
-    # @param hash [Hash]
-    # @return [Hash]
+    # 将所有哈希值规范化为字符串
     def normalize_hash(hash)
       result = hash.dup
 
-      result.delete(:hostid) # TODO: remove to logig. TemplateID and HostID has different id
+      # 移除用于日志记录的 TODO 注释。TemplateID 和 HostID 具有不同的 ID
+      result.delete(:hostid)
 
-      result.each do |key, value|
-        result[key.to_sym] = value.is_a?(Array) ? normalize_array(value) : value.to_s
-      end
+      result.transform_keys!(&:to_sym)
+      result.transform_values! { |value| value.is_a?(Array) ? normalize_array(value) : value.to_s }
 
       result
     end
 
-    # Normalize all array values to strings
-    # @note 将数组元素序列化成字符串
-    # @param array [Array]
-    # @return [Array]
+    # 将所有数组值规范化为字符串
     def normalize_array(array)
       result = []
 
       array.each do |e|
-        case e
-        when Array
+        if e.is_a?(Array)
           result.push(normalize_array(e))
-        when Hash
+        elsif e.is_a?(Hash)
           result.push(normalize_hash(e))
         else
           result.push(e.to_s)
@@ -75,11 +61,7 @@ class ZabbixManager
       result
     end
 
-    # Parse a data hash for id key or boolean to return
-    # @note 提取 zabbix 监控对象 CRUD key 或者 keys
-    # @param data
-    # @return [Integer] The object id if a single object hash is provided with key
-    # @return [Boolean] True/False if multiple class object hash is provided
+    # 解析包含 ID 键或布尔值的数据哈希
     def parse_keys(data)
       case data
       when Hash
@@ -93,14 +75,10 @@ class ZabbixManager
       end
     end
 
-    # Merge two hashes into a single new hash
-    #
-    # @param first_hash [Hash]
-    # @param second_hash [Hash]
-    # @return [Hash]
-    def merge_params(first_hash, second_hash)
-      new = first_hash.dup
-      new.merge(second_hash)
+    # 合并两个哈希为一个新的哈希
+    def merge_hashes(hash1, hash2)
+      new_hash = hash1.dup
+      new_hash.merge(hash2)
     end
   end
 end

data/lib/zabbix_manager/basic/basic_init.rb

@@ -1,49 +1,33 @@
 # frozen_string_literal: true
 
 class ZabbixManager
-  # @author: WENWU YAN
-  # @email: 968828@gmail.com
-  # @date: 2023/3/25下午4:47
   class Basic
-    # Initializes a new Basic object with ZabbixManager Client
-    # @note zabbix api 基类
-    # @param client [ZabbixManager::Client]
-    # @return [ZabbixManager::Client]
+    # 使用 ZabbixManager 客户端初始化一个新的 Basic 对象
     def initialize(client)
       @client = client
     end
 
-    # Placeholder for inherited objects to provide object-specific method name
-    # @note 子类必须实现的方法 method_name
-    # @raise [ZbxError] Basic object does not directly support method_name
+    # 在派生类中应该重写此方法以提供特定的方法名
     def method_name
-      raise ZbxError, "Can't call method_name here"
+      raise ZbxError, "子类需要自行实现 method_name"
     end
 
-    # Placeholder for inherited objects to provide object-specific id field name
-    # @note 子类必须实现的方法
-    # @raise [ZbxError] Basic object does not directly support identify
+    # 在派生类中应该重写此方法以提供特定的 ID 字段名
     def identify
-      raise ZbxError, "Can't call identify here"
+      raise ZbxError, "子类需要自行实现 identify"
     end
 
-    # Placeholder for inherited objects to provide default options
-    # @note 子类缺省的 options
-    # @return [Hash]
+    # 派生类可以重写此方法以提供特定的默认选项
     def default_options
       {}
     end
 
-    # Returns the object's id field name (identify) based on method_name + id
-    # @note 默认 key 为 "#{method_name}id"
-    # @return [String]
+    # 根据 method_name + id 返回对象的 ID 字段名（identify）
     def key
       "#{method_name}id"
     end
 
-    # Returns the object's plural id field name (identify) based on key
-    # @note 默认 key 为 "#{method_name}ids"
-    # @return [String]
+    # 根据 key 返回对象的复数 ID 字段名（identify）
     def keys
       "#{key}s"
     end

data/lib/zabbix_manager/basic/basic_logic.rb

@@ -2,38 +2,25 @@
 
 class ZabbixManager
   class Basic
-    # Create new Zabbix object using API (with defaults)
-    # @note 新增 zabbix 监控对象，返回监控对象 id
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 使用 API 新增 Zabbix 监控对象（使用默认值）
     def create(data)
-      log "[DEBUG] Call #{method_name}.create with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.create，参数: #{data.inspect}"
 
       params = default_options.merge(data)
       result = @client.api_request(method: "#{method_name}.create", params: params)
       parse_keys result
     end
 
-    # Update Zabbix object using API
-    # @note 更新 zabbix 监控对象，返回监控对象 id
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @param force [Boolean] Whether to force an object update even if provided data matches Zabbix
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 使用 API 更新 Zabbix 监控对象
     def update(data, force = false)
-      log "[DEBUG] Call #{method_name}.update with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.update，参数: #{data.inspect}"
 
       dump = {}
       dump_by_id(key.to_sym => data[key.to_sym]).each do |item|
         dump = symbolize_keys(item) if item[key].to_i == data[key.to_sym].to_i
       end
       if hash_equals?(dump, data) && !force
-        log "[DEBUG] Equal keys #{dump} and #{data}, skip update"
+        log "[DEBUG] 系统以有数据 #{dump} 和 待更新的数据 #{data} 相同，跳过本次更新"
         data[key.to_sym].to_i
       else
         result = @client.api_request(method: "#{method_name}.update", params: data)
@@ -41,30 +28,18 @@ class ZabbixManager
       end
     end
 
-    # Delete Zabbix object using API
-    # @note 删除 zabbix 监控对象，返回监控对象 id
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is deleted
-    # @return [Boolean] True/False if multiple objects are deleted
+    # 使用 API 删除 Zabbix 监控对象
     def delete(data)
-      log "[DEBUG] Call #{method_name}.delete with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.delete，参数: #{data.inspect}"
 
       result = @client.api_request(method: "#{method_name}.delete", params: [data].flatten)
       parse_keys result
     end
 
-    # Get or Create Zabbix object using API
-    # @note 创建或更新 zabbix 监控对象，返回监控对象 id
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, Array, TrueClass, FalseClass] Zabbix object id
+    # 使用 API 获取或创建 Zabbix 监控对象
     def get_or_create(data)
-      log "[DEBUG] Call #{method_name}.get_or_create with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_or_create，参数: #{data.inspect}"
 
-      # Call get_id return object id if exists
       if (id = get_id(identify.to_sym => data[identify.to_sym]))
         id
       else
@@ -72,46 +47,30 @@ class ZabbixManager
       end
     end
 
-    # Get or Create Zabbix object [{ key: id }] using API
-    # @note 批量创建或更新监控对象并返回 [ { "#{key}": id } ]
-    # @param data [Hash, Array] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Array] Zabbix object [{keys: id}]
+    # 使用 API 批量获取或创建 Zabbix 监控对象
     def get_or_create_keys(data)
-      log "[DEBUG] Call #{method_name}.get_or_create_keys with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_or_create_keys，参数: #{data.inspect}"
 
       ids = []
       [data].flatten.each do |item|
         if (id = get_or_create(item))
-          ids << { "#{key}": id }
+          ids << { key.to_sym => id }
         end
       end
       ids
     end
 
-    # Create or update Zabbix object using API
-    # @note 创建或更新 zabbix 监控对象，入参为基于符号的哈希对象，返回监控对象 id
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 使用 API 创建或更新 Zabbix 监控对象
     def create_or_update(data)
-      log "[DEBUG] Call #{method_name}.create_or_update with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.create_or_update，参数: #{data.inspect}"
 
       id = get_id(identify.to_sym => data[identify.to_sym])
       id ? update(data.merge(key.to_sym => id.to_s)) : create(data)
     end
 
-    # Dump Zabbix object data by key from API
-    # @note 基于 "#{key}" 打印 zabbix 监控对象详情
-    # @param data [Hash] Should include desired object's key and value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 使用 API 基于 key 打印 Zabbix 监控对象详情
     def dump_by_id(data)
-      log "[DEBUG] Call #{method_name}.dump_by_id with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.dump_by_id，参数: #{data.inspect}"
 
       get_raw(
         {
@@ -123,21 +82,15 @@ class ZabbixManager
       )
     end
 
-    # Get Zabbix object id from API based on provided data
-    # @note 基于 zabbix "#{identify}" 查询监控对象的 "#{key}"
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call or missing object's id field name (identify).
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, NilClass] Zabbix object id
+    # 使用 API 基于提供的数据查询 Zabbix 监控对象 id
     def get_id(data)
-      log "[DEBUG] Call #{method_name}.get_id with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_id，参数: #{data.inspect}"
 
-      # symbolize keys if the user used string keys instead of symbols
       data = symbolize_keys(data) if data.key?(identify)
-      # raise an error if identify name was not supplied
       name = data[identify.to_sym]
-      raise ZbxError, "#{identify} not supplied in call to get_id" if name.nil?
+      raise ZbxError, "在调用 get_id 时未提供 identify #{identify}" if name.nil?
 
+      # 输出信息截取 key identify
       result = get_raw(
         {
           filter: data,
@@ -148,47 +101,59 @@ class ZabbixManager
       result.find { |item| item[identify] == data[identify.to_sym] }&.[](key)&.to_i
     end
 
-    # Get Zabbix object [{ key: id }] from API based on provided data
-    # @note 基于监控对象索引建"#{identify}"查询 { "#{key}": id }
-    # @param data [Hash, Array]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call or missing object's id field name (identify).
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Array] Zabbix object id
+    # 使用 API 基于提供的数据查询 Zabbix 监控对象 ids
+    def get_ids(data)
+      log "[DEBUG] 调用 #{method_name}.get_ids，参数: #{data.inspect}"
+
+      ids = []
+      [data].flatten.each do |item|
+        if (id = get_id(item))
+          ids << id
+        end
+      end
+      ids
+    end
+
+    # 使用 API 基于提供的数据查询 Zabbix 监控对象 id
     def get_key_ids(data)
-      log "[DEBUG] Call #{method_name}.get_key_ids with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_key_ids，参数: #{data.inspect}"
 
       ids = []
       [data].flatten.each do |item|
         if (id = get_id(item))
-          ids << { "#{key}": id }
+          ids << { key.to_sym => id }
         end
       end
       ids
     end
 
-    # Get Zabbix object ID by name using Zabbix API
-    # @note 基于监控对象索引键(#{identify})查询 #{key}
-    # @param data [String, Array] Needs to include host to properly identify Zabbix Objects via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Array, NilClass] Zabbix object id
+    # 使用 API 基于 name 查询 Zabbix 监控对象 id
+    def get_ids_by_identify(data)
+      log "[DEBUG] 调用 #{method_name}.get_ids_by_identify，参数: #{data.inspect}"
+
+      result = get_raw(
+        {
+          filter: { identify.to_sym => [data].flatten },
+          output: [key]
+        }
+      )
+      result.empty? ? nil : result.map { |i| i[key] }
+    end
+
+    # 使用 API 基于 name 查询 Zabbix 监控对象 id
     def get_key_ids_by_identify(data)
-      log "[DEBUG] Call #{method_name}.get_ids_by_name with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_key_ids_by_identify，参数: #{data.inspect}"
 
       result = get_raw(
         {
-          filter: { "#{identify}": [data].flatten },
-          output: ["#{key}"]
+          filter: { identify.to_sym => [data].flatten },
+          output: [key]
         }
       )
-      result.empty? ? nil : result.map { |i| { "#{key}": i[key] } }
+      result.empty? ? nil : result.map { |i| { key.to_sym => i[key] } }
     end
 
-    # Get full/extended Zabbix data for all objects of type/class from API
-    # @note 查询 zabbix 监控对象所有的 "#{identify}: #{key}"
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash] Array of matching objects
+    # 使用 API 查询所有 Zabbix 监控对象的详细信息
     def all
       result = {}
       get_raw({ output: "extend" }).each do |item|
@@ -197,14 +162,9 @@ class ZabbixManager
       result
     end
 
-    # Get full/extended Zabbix object data from API
-    # @note 基于 "#{identify}" 过滤 zabbix 监控对象，输出详情
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 使用 API 查询 Zabbix 监控对象的详细信息
     def get_full_data(data)
-      log "[DEBUG] Call #{method_name}.get_full_data with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 #{method_name}.get_full_data，参数: #{data.inspect}"
 
       get_raw(
         {
@@ -216,18 +176,20 @@ class ZabbixManager
       )
     end
 
-    # Get raw Zabbix object data from API
-    # @note zabbix 监控对象低阶查询方法，静默方法 debug 打印信息
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 使用 API 查询 Zabbix 监控对象的原始数据
     def get_raw(data)
-      # log "[DEBUG] Call #{method_name}.get_raw with parameters: #{data.inspect}"
       @client.api_request(
         method: "#{method_name}.get",
         params: data
       )
     end
+
+    # 使用 API 查询 Zabbix 监控对象的原始数据
+    def request_raw(method, data)
+      @client.api_request(
+        method: method,
+        params: data
+      )
+    end
   end
 end

data/lib/zabbix_manager/classes/actions.rb

@@ -2,40 +2,30 @@
 
 class ZabbixManager
   class Actions < Basic
-    # The method name used for interacting with Actions via Zabbix API
-    #
-    # @return [String]
+    # 用于与 Zabbix API 交互的方法名称
     def method_name
       "action"
     end
 
-    # The id field name used for identifying specific Action objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Action 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # Get full/extended Action object data from API
-    #
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 从 API 获取完整/扩展的 Action 对象数据
     def get_full_data(data)
-      log "[DEBUG] Call get_full_data with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 get_full_data，参数为：#{data.inspect}"
 
-      @client.api_request(
-        method: "#{method_name}.get",
-        params: {
-          filter: {
+      get_raw(
+        {
+          filter:                      {
             identify.to_sym => data[identify.to_sym]
           },
-          output: "extend",
-          selectOperations: "extend",
-          selectRecoveryOperations: "extend",
+          output:                      "extend",
+          selectOperations:            "extend",
+          selectRecoveryOperations:    "extend",
           selectAcknowledgeOperations: "extend",
-          selectFilter: "extend"
+          selectFilter:                "extend"
         }
       )
     end

data/lib/zabbix_manager/classes/applications.rb

@@ -2,28 +2,19 @@
 
 class ZabbixManager
   class Applications < Basic
-    # The method name used for interacting with Applications via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Applications 交互的方法名称
     def method_name
       "application"
     end
 
-    # The id field name used for identifying specific Application objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Application 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # Get or Create Application object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify Applications via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass] Zabbix object id
+    # 通过 Zabbix API 获取或创建 Application 对象
     def get_or_create(data)
-      log "[DEBUG] Call get_or_create with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 get_or_create，参数为：#{data.inspect}"
 
       if (id = get_id(name: data[:name], hostid: data[:hostid]))
         id
@@ -32,12 +23,7 @@ class ZabbixManager
       end
     end
 
-    # Create or update Application object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify Applications via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer,TrueClass, FalseClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 Application 对象
     def create_or_update(data)
       applicationid = get_id(name: data[:name], hostid: data[:hostid])
       applicationid ? update(data.merge(applicationid: applicationid)) : create(data)

data/lib/zabbix_manager/classes/configurations.rb

@@ -2,41 +2,27 @@
 
 class ZabbixManager
   class Configurations < Basic
-    # @return [Boolean]
+    # 用于标识返回结果是否为数组
     def array_flag
       true
     end
 
-    # The method name used for interacting with Configurations via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Configurations 交互的方法名称
     def method_name
       "configuration"
     end
 
-    # The id field name used for identifying specific Configuration objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Configuration 对象的 id 字段名称
     def identify
       "host"
     end
 
-    # Export configuration data using Zabbix API
-    #
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 使用 Zabbix API 导出配置数据
     def export(data)
       @client.api_request(method: "configuration.export", params: data)
     end
 
-    # Import configuration data using Zabbix API
-    #
-    # @param data [Hash]
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 使用 Zabbix API 导入配置数据
     def import(data)
       @client.api_request(method: "configuration.import", params: data)
     end