zabbix_manager 5.1.3 → 5.1.5

data/lib/zabbix_manager/classes/scripts.rb

@@ -2,24 +2,20 @@
 
 class ZabbixManager
   class Scripts < Basic
+    # 与 Zabbix API 交互的方法名称
     def method_name
       "script"
     end
 
-    # The id field name used for identifying specific Screen objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定脚本对象的 ID 字段名称
     def identify
       "name"
     end
 
-    # Submits a request to the zabbix api
-    # data - A Hash containing the scriptid and hostid
-    #
-    # Example:
-    #   execute({ scriptid: '12', hostid: '32 })
+    # 执行 Zabbix API 中特定主机上的脚本
     #
-    # Returns nothing
+    # 示例:
+    #   execute({ scriptid: '12', hostid: '32' })
     def execute(data)
       @client.api_request(
         method: "script.execute",
@@ -30,7 +26,8 @@ class ZabbixManager
       )
     end
 
-    def getscriptsbyhost(data)
+    # 使用 Zabbix API 通过主机获取脚本
+    def get_scripts_by_host(data)
       @client.api_request(method: "script.getscriptsbyhosts", params: data)
     end
   end

data/lib/zabbix_manager/classes/server.rb

@@ -2,14 +2,9 @@
 
 class ZabbixManager
   class Server
-    # @return [String]
     attr_reader :version
 
-    # Initializes a new Server object with ZabbixManager Client and fetches Zabbix Server API version
-    #
-    # @param client [ZabbixManager::Client]
-    # @return [ZabbixManager::Client]
-    # @return [String] Zabbix API version number
+    # 初始化一个新的 Server 对象，使用 ZabbixManager 客户端，并获取 Zabbix 服务器 API 版本
     def initialize(client)
       @client = client
       @version = @client.api_version

data/lib/zabbix_manager/classes/templates.rb

@@ -2,63 +2,39 @@
 
 class ZabbixManager
   class Templates < Basic
-    # The method name used for interacting with Templates via Zabbix API
-    #
-    # @return [String]
+    # Zabbix API 中与模板交互的方法名称
     def method_name
       "template"
     end
 
-    # The id field name used for identifying specific Template objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定模板对象的 id 字段名称
     def identify
       "host"
     end
 
-    # Delete Template object using Zabbix API
-    #
-    # @param data [Array] Should include array of templateid's
-    # @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, NilClass] The Template object id that was deleted
+    # 通过 Zabbix API 删除模板对象
     def delete(data)
       result = @client.api_request(method: "template.delete", params: [data])
       result.empty? ? nil : result["templateids"][0].to_i
     end
 
-    # Get Template ids for Host from Zabbix API
-    #
-    # @param data [Hash] Should include host value to query for matching templates
-    # @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] Returns array of Template ids
+    # 从 Zabbix API 获取主机的模板 id
     def get_ids_by_host(data)
       @client.api_request(method: "template.get", params: data).map do |tmpl|
         tmpl["templateid"]
       end
     end
 
-    # Get or Create Template object using Zabbix API
-    #
-    # @param data [Hash] Needs to include host to properly identify Templates 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
-    def get_or_create(data)
-      if (templateid = get_id(host: data[:host]))
-        templateid
-      else
-        create(data)
-      end
-    end
+    # 通过 Zabbix API 获取或创建模板对象
+    # def get_or_create(data)
+    #   if (templateid = get_id(host: data[:host]))
+    #     templateid
+    #   else
+    #     create(data)
+    #   end
+    # end
 
-    # Mass update Templates for Hosts using Zabbix API
-    #
-    # @param data [Hash] Should include hosts_id array and templates_id array
-    # @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 [Boolean]
+    # 通过 Zabbix API 批量更新主机的模板
     def mass_update(data)
       result = @client.api_request(
         method: "template.massUpdate",
@@ -70,12 +46,7 @@ class ZabbixManager
       result.empty? ? false : true
     end
 
-    # Mass add Templates to Hosts using Zabbix API
-    #
-    # @param data [Hash] Should include hosts_id array and templates_id array
-    # @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 [Boolean]
+    # 通过 Zabbix API 批量添加模板到主机
     def mass_add(data)
       result = @client.api_request(
         method: "template.massAdd",
@@ -87,12 +58,7 @@ class ZabbixManager
       result.empty? ? false : true
     end
 
-    # Mass remove Templates to Hosts using Zabbix API
-    #
-    # @param data [Hash] Should include hosts_id array and templates_id array
-    # @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 [Boolean]
+    # 通过 Zabbix API 批量从主机移除模板
     def mass_remove(data)
       result = @client.api_request(
         method: "template.massRemove",

data/lib/zabbix_manager/classes/triggers.rb

@@ -2,24 +2,17 @@
 
 class ZabbixManager
   class Triggers < Basic
-    # The method name used for interacting with Triggers via Zabbix API
-    #
-    # @return [String]
+    # 与 Zabbix API 交互的触发器方法名称
     def method_name
       "trigger"
     end
 
-    # The id field name used for identifying specific Trigger objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定触发器对象的 id 字段名称
     def identify
       "description"
     end
 
-    # The default options used when creating zabbix triggers
-    # @note 缺省的 trigger 参数
-    # @see https://www.zabbix.com/documentation/current/en/manual/api/reference/trigger/get
-    # @return [Hash]
+    # 创建 Zabbix 触发器的默认选项
     def default_options
       {
         recovery_mode: 1,
@@ -28,18 +21,12 @@ class ZabbixManager
       }
     end
 
-    # Dump Trigger object data by key from Zabbix API
-    #
-    # @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]
+    # 通过键值对从 Zabbix API 转储触发器对象数据
     def dump_by_id(data)
-      log "[DEBUG] Call dump_by_id with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 dump_by_id 方法，参数: #{data.inspect}"
 
-      @client.api_request(
-        method: "trigger.get",
-        params: {
+      get_raw(
+        {
           triggerids:       data[keys.to_sym],
           output:           "extend",
           select_items:     "extend",
@@ -48,14 +35,9 @@ class ZabbixManager
       )
     end
 
-    # Safely update Trigger object using Zabbix API by deleting and replacing trigger
-    #
-    # @param data [Hash] Needs to include description and hostid to properly identify Triggers 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, NilClass] Zabbix object id
+    # 安全地使用 Zabbix API 更新触发器对象，通过删除和替换触发器
     def safe_update(data)
-      log "[DEBUG] Call safe_update with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 safe_update 方法，参数: #{data.inspect}"
 
       dump    = {}
       item_id = data[key.to_sym].to_i
@@ -75,7 +57,7 @@ class ZabbixManager
       log "[DEBUG] expression: #{dump[:expression]}\n data: #{data[:expression]}"
 
       if hash_equals?(dump, data)
-        log "[DEBUG] Equal keys #{dump} and #{data}, skip safe_update"
+        log "[DEBUG] 键 #{dump} 和 #{data} 相等，跳过 safe_update"
         item_id
       else
         data[:expression] = old_expression
@@ -90,14 +72,9 @@ class ZabbixManager
       end
     end
 
-    # Get or Create Trigger object using Zabbix API
-    #
-    # @param data [Hash] Needs to include description and hostid to properly identify Triggers 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, NilClass] Zabbix object id
+    # 通过 Zabbix API 获取或创建触发器对象
     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}"
 
       if (id = get_id(description: data[:description], hostid: data[:hostid]))
         id
@@ -106,26 +83,15 @@ class ZabbixManager
       end
     end
 
-    # Create or update Trigger object using Zabbix API
-    #
-    # @param data [Hash] Needs to include description and hostid to properly identify Triggers 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, NilClass, TrueClass, FalseClass] Zabbix object id
+    # 使用 Zabbix API 创建或更新触发器对象
     def create_or_update(data)
       triggerid = get_id(description: data[:description], hostid: data[:hostid])
       triggerid ? update(data.merge(triggerid: triggerid)) : create(data)
     end
 
-    # Add dependsOnTrigger using Zabbix API
-    #
-    # @param triggerid [Integer] identify for trigger via Zabbix API
-    # @param depend_on_trigger_id [Integer] identify for dependsOnTrigger 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, NilClass] Zabbix object id
+    # 使用 Zabbix API 添加触发器依赖关系
     def add_trigger_dependency(triggerid, depend_on_trigger_id)
-      log "[DEBUG] Call add_trigger_dependency with parameters: #{triggerid} #{depend_on_trigger_id}"
+      log "[DEBUG] 调用 add_trigger_dependency 方法，参数: #{triggerid} #{depend_on_trigger_id}"
 
       result = @client.api_request(
         method: "trigger.adddependencies",

data/lib/zabbix_manager/classes/unusable.rb

@@ -2,8 +2,9 @@
 
 class ZabbixManager
   class Triggers < Basic
+    # 使用 Zabbix API 创建或更新触发器对象
     def create_or_update(data)
-      log "[DEBUG] Call create_or_update with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 create_or_update 方法，参数: #{data.inspect}"
       get_or_create(data)
     end
   end

data/lib/zabbix_manager/classes/usergroups.rb

@@ -2,33 +2,22 @@
 
 class ZabbixManager
   class Usergroups < Basic
-    # The method name used for interacting with Usergroups via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Usergroups 交互的方法名称
     def method_name
       "usergroup"
     end
 
-    # The key field name used for Usergroup objects via Zabbix API
-    #
-    # @return [String]
+    # 用于 Usergroup 对象通过 Zabbix API 的键字段名称
     def key
       "usrgrpid"
     end
 
-    # The id field name used for identifying specific Usergroup objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 识别特定 Usergroup 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # Set permissions for usergroup using Zabbix API
-    #
-    # @param data [Hash] Needs to include usrgrpids and hostgroupids along with permissions to set
-    # @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, NilClass] Zabbix object id (usergroup)
+    # 使用 Zabbix API 设置用户组的权限
     def permissions(data)
       permission = data[:permission] || 2
       result = @client.api_request(
@@ -41,23 +30,12 @@ class ZabbixManager
       result ? result["usrgrpids"][0].to_i : nil
     end
 
-    # Add users to usergroup using Zabbix API
-    #
-    # @deprecated Zabbix has removed massAdd in favor of update.
-    # @param data [Hash] Needs to include userids and usrgrpids to mass add users to groups
-    # @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, NilClass] Zabbix object id (usergroup)
+    # 使用 Zabbix API 将用户添加到用户组
     def add_user(data)
       update_users(data)
     end
 
-    # Update users in usergroups using Zabbix API
-    #
-    # @param data [Hash] Needs to include userids and usrgrpids to mass update users in groups
-    # @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, NilClass] Zabbix object id (usergroup)
+    # 使用 Zabbix API 更新用户组中的用户
     def update_users(data)
       user_groups = data[:usrgrpids].map do |t|
         {

data/lib/zabbix_manager/classes/usermacros.rb

@@ -2,160 +2,89 @@
 
 class ZabbixManager
   class Usermacros < Basic
-    # The id field name used for identifying specific User macro objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 识别特定 User 宏对象的 id 字段名称
     def identify
       "macro"
     end
 
-    # The method name used for interacting with User macros via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 User 宏交互的方法名称
     def method_name
       "usermacro"
     end
 
-    # Get User macro object id from Zabbix API based on provided data
-    #
-    # @param data [Hash] Needs to include macro to properly identify user macros via Zabbix API
-    # @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] Zabbix object id
+    # 通过 Zabbix API 根据提供的数据获取 User 宏对象的 id
     def get_id(data)
       log "[DEBUG] Call get_id with parameters: #{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?
 
       result = request(data, "usermacro.get", "hostmacroid")
 
-      !result.empty? && result[0].key?("hostmacroid") ? result[0]["hostmacroid"].to_i : nil
+      !result&.empty? && result[0].key?("hostmacroid") ? result[0]["hostmacroid"].to_i : nil
     end
 
-    # Get Global macro object id from Zabbix API based on provided data
-    #
-    # @param data [Hash] Needs to include macro to properly identify global macros via Zabbix API
-    # @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] Zabbix object id
+    # 通过 Zabbix API 根据提供的数据获取 Global 宏对象的 id
     def get_id_global(data)
       log "[DEBUG] Call get_id_global with parameters: #{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_global" if name.nil?
 
       result = request(data, "usermacro.get", "globalmacroid")
 
-      !result.empty? && result[0].key?("globalmacroid") ? result[0]["globalmacroid"].to_i : nil
+      !result&.empty? && result[0].key?("globalmacroid") ? result[0]["globalmacroid"].to_i : nil
     end
 
-    # Get full/extended User macro data from Zabbix 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]
+    # 通过 Zabbix API 获取完整/扩展的 User 宏数据
     def get_full_data(data)
       log "[DEBUG] Call get_full_data with parameters: #{data.inspect}"
 
       request(data, "usermacro.get", "hostmacroid")
     end
 
-    # Get full/extended Global macro data from Zabbix 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]
+    # 通过 Zabbix API 获取完整/扩展的 Global 宏数据
     def get_full_data_global(data)
       log "[DEBUG] Call get_full_data_global with parameters: #{data.inspect}"
 
       request(data, "usermacro.get", "globalmacroid")
     end
 
-    # Create new User macro object using Zabbix API (with defaults)
-    #
-    # @param data [Hash] Needs to include hostid, macro, and value to create User macro 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] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 通过 Zabbix API 创建新的 User 宏对象（使用默认值）
     def create(data)
       request(data, "usermacro.create", "hostmacroids")
     end
 
-    # Create new Global macro object using Zabbix API (with defaults)
-    #
-    # @param data [Hash] Needs to include hostid, macro, and value to create Global macro 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] The object id if a single object is created
-    # @return [Boolean] True/False if multiple objects are created
+    # 通过 Zabbix API 创建新的 Global 宏对象（使用默认值）
     def create_global(data)
       request(data, "usermacro.createglobal", "globalmacroids")
     end
 
-    # Delete User macro object using Zabbix API
-    #
-    # @param data [Hash] Should include hostmacroid's of User macros to delete
-    # @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 API 删除 User 宏对象
     def delete(data)
       data_delete = [data]
       request(data_delete, "usermacro.delete", "hostmacroids")
     end
 
-    # Delete Global macro object using Zabbix API
-    #
-    # @param data [Hash] Should include hostmacroid's of Global macros to delete
-    # @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 API 删除 Global 宏对象
     def delete_global(data)
       data_delete = [data]
       request(data_delete, "usermacro.deleteglobal", "globalmacroids")
     end
 
-    # Update User macro object using Zabbix API
-    #
-    # @param data [Hash] Should include object's id field name (identify), id value, and fields to update
-    # @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
+    # 通过 Zabbix API 更新 User 宏对象
     def update(data)
       request(data, "usermacro.update", "hostmacroids")
     end
 
-    # Update Global macro object using Zabbix API
-    #
-    # @param data [Hash] Should include object's id field name (identify), id value, and fields to update
-    # @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
+    # 通过 Zabbix API 更新 Global 宏对象
     def update_global(data)
       request(data, "usermacro.updateglobal", "globalmacroids")
     end
 
-    # Get or Create User macro object using Zabbix API
-    #
-    # @param data [Hash] Needs to include macro and hostid to properly identify User macros 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] Zabbix object id
+    # 通过 Zabbix API 获取或创建 User 宏对象
     def get_or_create(data)
       log "[DEBUG] Call get_or_create with parameters: #{data.inspect}"
 
@@ -165,12 +94,7 @@ class ZabbixManager
       id
     end
 
-    # Get or Create Global macro object using Zabbix API
-    #
-    # @param data [Hash] Needs to include macro and hostid to properly identify Global macros 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] Zabbix object id
+    # 通过 Zabbix API 获取或创建 Global 宏对象
     def get_or_create_global(data)
       log "[DEBUG] Call get_or_create_global with parameters: #{data.inspect}"
 
@@ -180,23 +104,13 @@ class ZabbixManager
       id
     end
 
-    # Create or update User macro object using Zabbix API
-    #
-    # @param data [Hash] Needs to include macro and hostid to properly identify User macros 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, NilClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 User 宏对象
     def create_or_update(data)
       hostmacroid = get_id(macro: data[:macro], hostid: data[:hostid])
       hostmacroid ? update(data.merge(hostmacroid: hostmacroid)) : create(data)
     end
 
-    # Create or update Global macro object using Zabbix API
-    #
-    # @param data [Hash] Needs to include macro and hostid to properly identify Global macros 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, NilClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 Global 宏对象
     def create_or_update_global(data)
       globalmacroid = get_id_global(macro: data[:macro], hostid: data[:hostid])
       globalmacroid ? update_global(data.merge(globalmacroid: globalmacroid)) : create_global(data)
@@ -204,16 +118,8 @@ class ZabbixManager
 
     private
 
-    # Custom request method to handle both User and Global macros in one
-    #
-    # @param data [Hash] Needs to include macro and hostid to properly identify Global macros via Zabbix API
-    # @param method [String] Zabbix API method to use for the request
-    # @param result_key [String] Which key to use for parsing results based on User vs Global macros
-    # @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, NilClass] Zabbix object id
+    # 自定义请求方法，以处理 User 和 Global 宏
     def request(data, method, result_key)
-      # Zabbix has different result formats for gets vs updates
       if method.include?(".get")
         if result_key.include?("global")
           @client.api_request(method: method, params: { globalmacro: true, filter: data })

data/lib/zabbix_manager/classes/users.rb

@@ -2,40 +2,23 @@
 
 class ZabbixManager
   class Users < Basic
-    # The method name used for interacting with Users via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Users 交互的方法名称
     def method_name
       "user"
     end
 
-    # The keys field name used for User objects via Zabbix API
-    #
-    # @return [String]
-    def keys
-      "userids"
-    end
-
-    # The key field name used for User objects via Zabbix API
-    #
-    # @return [String]
-    def key
-      "userid"
-    end
-
-    # The id field name used for identifying specific User objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 识别特定 User 对象的 id 字段名称
     def identify
       "alias"
     end
 
+    # 用于辅助处理添加或更新用户媒体信息的方法
     def medias_helper(data, action)
       result = @client.api_request(
         method: "user.#{action}",
-        params: data[:userids].map do |t|
+        params: data[:userids].map do |i|
           {
-            userid: t,
+            userid: i,
             user_medias: data[:media]
           }
         end
@@ -43,22 +26,12 @@ class ZabbixManager
       result ? result["userids"][0].to_i : nil
     end
 
-    # Add media to users using Zabbix API
-    #
-    # @param data [Hash] Needs to include userids and media to mass add media to users
-    # @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, NilClass] Zabbix object id (media)
+    # 通过 Zabbix API 为用户添加媒体信息
     def add_medias(data)
       medias_helper(data, "update")
     end
 
-    # Update media for users using Zabbix API
-    #
-    # @param data [Hash] Needs to include userids and media to mass update media for users
-    # @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, NilClass] Zabbix object id (user)
+    # 通过 Zabbix API 更新用户媒体信息
     def update_medias(data)
       medias_helper(data, "update")
     end