ruby-jss 3.0.0 → 3.1.0b2

data/lib/jamf/api/connection/default_connection.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/jamf_pro_api.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/jamf_pro_api_error.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/connection/token.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -114,7 +114,7 @@ module Jamf
       alias pw_fallback? pw_fallback
 
       # @return [Faraday::Response] The response object from instantiating
-      #   a new Token object by creating a new token or validating a token 
+      #   a new Token object by creating a new token or validating a token
       #   string. This is not updated when refreshing a token, only when
       #   calling Token.new
       attr_reader :creation_http_response
@@ -170,7 +170,7 @@ module Jamf
       #################################
       def init_from_pw
         resp = token_connection(NEW_TOKEN_RSRC).post
-        
+
         if resp.success?
           parse_token_from_response resp
           @last_refresh = Time.now

data/lib/jamf/api/connection.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/api_objects/computer_prestage.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/device_enrollment.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/inventory_preload_record.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/jp_building.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/mobile_device_prestage.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/base_classes/oapi_object.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -350,8 +350,8 @@ module Jamf
     def initialize(data)
       @init_data = data
 
-      # creating a new one, not fetching from the API
-      creating = data.delete :creating_from_create
+      # creating a new one via ruby-jss, not fetching one from the API
+      creating = data.delete :creating_from_create if data.is_a?(Hash)
 
       if creating
         self.class::OAPI_PROPERTIES.each_key do |attr_name|
@@ -512,19 +512,24 @@ module Jamf
     #
     def parse_init_data(data)
       self.class::OAPI_PROPERTIES.each do |attr_name, attr_def|
-        unless data.key? attr_name
-          raise Jamf::InvalidDataError, "Initialization must include the key '#{attr_name}:'" if attr_def[:required]
+        if data.is_a? Hash
+          unless data.key? attr_name
+            raise Jamf::InvalidDataError, "Initialization must include the key '#{attr_name}:'" if attr_def[:required]
 
-          next
+            next
+          end
+
+          value =
+            if attr_def[:multi]
+              raw_array = data[attr_name] || []
+              raw_array.map { |v| parse_single_init_value v, attr_name, attr_def }
+            else
+              parse_single_init_value data[attr_name], attr_name, attr_def
+            end
+        else # not a Hash, this is a single-value object, so the data is the value
+          value = data
         end
 
-        value =
-          if attr_def[:multi]
-            raw_array = data[attr_name] || []
-            raw_array.map { |v| parse_single_init_value v, attr_name, attr_def }
-          else
-            parse_single_init_value data[attr_name], attr_name, attr_def
-          end
         instance_variable_set "@#{attr_name}", value
       end # OAPI_PROPERTIES.each
     end # parse_init_data(data)
@@ -567,7 +572,7 @@ module Jamf
     # @return (see parse_single_init_value)
     #
     def parse_enum_value(api_value, attr_name, attr_def)
-      Jamf::Validate.in_enum  api_value, enum: attr_def[:enum], 
+      Jamf::Validate.in_enum  api_value, enum: attr_def[:enum],
                                          msg: "#{api_value} is not in the allowed values for attribute #{attr_name}. Must be one of: #{attr_def[:enum].join ', '}"
     end
 

data/lib/jamf/api/jamf_pro/mixins/bulk_deletable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/change_log.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -24,6 +24,7 @@
 #
 
 module Jamf
+
   # a mix-in module for Jamf::Resource subclasses.
   #
   # Many Jamf resources maintain an 'object history', available in the WebUI via
@@ -88,7 +89,6 @@ module Jamf
     HISTORY_ENTRY_OBJECT = Jamf::ChangeLogEntry
     POST_NOTE_OBJECT = Jamf::OAPISchemas::ObjectHistoryNote
 
-
     # when this module is included, also extend our Class Methods
     def self.included(includer)
       Jamf.load_msg "--> #{includer} is including Jamf::ChangeLog"
@@ -142,7 +142,7 @@ module Jamf
       #
       # @return [Array<Jamf::ChangeLogEntry>] The change log entries requested
       #
-      def change_log(id: nil, sort: nil, filter: nil,  cnx: Jamf.cnx)
+      def change_log(id: nil, sort: nil, filter: nil, cnx: Jamf.cnx)
         sort &&= Jamf::Sortable.parse_url_sort_param(sort)
         filter &&= Jamf::Filterable.parse_url_filter_param(filter)
 

data/lib/jamf/api/jamf_pro/mixins/collection_resource.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -288,6 +288,7 @@ module Jamf
       def pager(page_size: Jamf::Pager::DEFAULT_PAGE_SIZE, sort: nil, filter: nil, instantiate: false, cnx: Jamf.cnx)
         sort = Jamf::Sortable.parse_url_sort_param(sort)
         filter = filterable? ? Jamf::Filterable.parse_url_filter_param(filter) : nil
+        instantiate &&= self
 
         Jamf::Pager.new(
           page_size: page_size,

data/lib/jamf/api/jamf_pro/mixins/computer_recovery_lock.rb

@@ -0,0 +1,165 @@
+# Copyright 2023 Pixar
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+
+# frozen_string_literal: true
+
+module Jamf
+
+  # This module should be mixed in to Jamf::Computer and Jamf::ComputerGroup
+  #
+  # It provides access to the macos-managed-software-updates JPAPI resource for
+  # managed OS update commands to managed macs running Big Sur or higher.
+  #
+  # TODO: When POSTing to api/preview/mdm/commands is no longer in Preview,
+  # implement that endpoint and then add the setting of the recovery lock
+  # to this module.
+  #
+  # See https://learn.jamf.com/bundle/technical-articles/page/Recovery_Lock_Enablement_in_macOS_Using_the_Jamf_Pro_API.html
+  #
+  module ComputerRecoveryLock
+
+    # when this module is included, also extend our Class Methods
+    def self.included(includer)
+      Jamf.load_msg "--> #{includer} is including #{self}"
+      includer.extend(ClassMethods)
+    end
+
+    # The JPAPI resource for a single computer's RecoveryLock password is
+    # Jamf::Computer::JPAPI_INVENTORY_RSRC then the computer's ID then this
+    RECOVERY_LOCK_PW_RSRC_SUFFIX = 'view-recovery-lock-password'
+
+    # Class Methods
+    #####################################
+    module ClassMethods
+
+      # when this module is included, also extend our Class Methods
+      def self.extended(extender)
+        Jamf.load_msg "--> #{extender} is extending #{self}"
+      end
+
+      # Retrieve the recovery lock password for a given computer, if one has been set.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [String, nil] The recovery lock password, or nil if none has been set.
+      #######################
+      def recovery_lock_password(computer, cnx: Jamf.cnx)
+        id = Jamf::Computer.valid_id computer
+        raise Jamf::NoSuchItemError, "No computer matches identifier '#{computer}'" unless id
+
+        cnx.jp_get("#{Jamf::Computer::JPAPI_INVENTORY_RSRC}/#{id}/#{RECOVERY_LOCK_PW_RSRC_SUFFIX}").dig :recoveryLockPassword
+
+      # if we get a 404 NOT FOUND error, this given computer has no passwd set, so just return nil
+      rescue Jamf::Connection::JamfProAPIError => e
+        raise unless e.http_status == 404
+
+        nil
+      end # def
+
+      # TODO: When Jamf::Computer is based on the JPAPI, these methods
+      # and the matching instance methods, will be moved into
+      # a more appropriate file - probably another mixin for
+      # the Computer class.
+      #############################################
+      #############################################
+
+      # Get the JPAPI inventory data for a single computer, either by section or all sections.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param section [String] One of the data sections listed in Jamf::OAPISchemas::ComputerSection::VALUE_OPTIONS
+      #   or 'all'. Default is 'GENERAL'
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [Jamf::OAPISchemas::ComputerInventory] The inventory data, with the requested sections populated
+      #########
+      def inventory_data(computer, section: 'GENERAL', cnx: Jamf.cnx)
+        # TODO: get this into a constant
+        all = 'ALL'
+
+        section = section.to_s.upcase
+        id = Jamf::Computer.valid_id computer
+        raise Jamf::NoSuchItemError, "No computer matches identifier '#{computer}'" unless id
+
+        data =
+          if section == all
+            cnx.jp_get "#{Jamf::Computer::JPAPI_INVENTORY_DETAIL_RSRC}/#{id}"
+          else
+            raise ArgumentError, "Unknown inventory data section '#{section}'" unless Jamf::OAPISchemas::ComputerSection::VALUE_OPTIONS.include?(section)
+
+            cnx.jp_get("#{Jamf::Computer::JPAPI_INVENTORY_RSRC}?section=#{section}&page=0&page-size=1&filter=id%3D%3D#{id}")[:results].first
+          end
+
+        Jamf::OAPISchemas::ComputerInventory.new data
+      end
+
+      # Get the MDM 'managementID' of a given computer.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [String, nil] The managementID or nil if not available
+      #########
+      def management_id(computer, cnx: Jamf.cnx)
+        inventory_data(computer, cnx: cnx).general.managementId
+      end
+
+    end # module ClassMethods
+
+    # Instance Methods
+    ######################################
+
+    # Get the recovery lock password for this Computer instance
+    #
+    # @see ComputerRecoveryLock::ClassMethods.recovery_lock_password
+    #########
+    def recovery_lock_password
+      self.class.recovery_lock_password @id, cnx: @cnx
+    end
+
+    # Get the JPAPI inventory data for this computer, either by section or all sections.
+    #
+    # @see ComputerRecoveryLock::ClassMethods.inventory_data
+    #########
+    def inventory_data(section: 'GENERAL')
+      self.class.inventory_data @id, section: section, cnx: @cnx
+    end
+
+    # Get the MDM 'managementID' of this computer.
+    #
+    # @see ComputerRecoveryLock::ClassMethods.management_id
+    #########
+    def management_id
+      inventory_data.general.managementId
+    end
+
+  end # module MacOSRedeployMgmtFramework
+
+end # module Jamf

data/lib/jamf/api/jamf_pro/mixins/filevault.rb

@@ -0,0 +1,125 @@
+# Copyright 2023 Pixar
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+
+# frozen_string_literal: true
+
+module Jamf
+
+  # This module should be mixed in to Jamf::Computer
+  #
+  # It provides access to the /v1/computers-inventory/filevault and
+  # /v1/computers-inventory/{id}/filevault JPAPI resources
+  #
+  module FileVault
+
+    # when this module is included, also extend our Class Methods
+    def self.included(includer)
+      Jamf.load_msg "--> #{includer} is including #{self}"
+      includer.extend(ClassMethods)
+    end
+
+    # The JPAPI resource for a single computer's FV info is
+    # Jamf::Computer::JPAPI_INVENTORY_RSRC then the computer's ID then this
+    FILEVAULT_RSRC_SUFFIX = 'filevault'
+
+    # Class Methods
+    #####################################
+    module ClassMethods
+
+      # when this module is included, also extend our Class Methods
+      def self.extended(extender)
+        Jamf.load_msg "--> #{extender} is extending #{self}"
+      end
+
+      # Get the filevault info for one or all computers, or Jamf::Pager for getting all of them
+      # paged in groups.
+      #
+      # WARNING: This data will include the plaintext FileVault personal recovery keys. The
+      #   'View Disk Encryption Recovery Key' privilege is required.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer, or :all to get data for all computers, as an Array or via a Jamf::Pager
+      #
+      # @param paged [Boolean] when computer is :all, should we return a Jamf::Pager to get paged results?
+      #
+      # @param page_size [Integer] when computer is :all and paged: is true, how many results to return in each page.
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [Jamf::OAPISchemas::ComputerInventoryFileVault, Array<Jamf::OAPISchemas::ComputerInventoryFileVault>, Jamf::Pager]
+      #   The filevault info for a computer, all computers, or a Jamf::Pager to get all computers in pages.
+      ########################
+      def filevault_info(computer, paged: false, page_size: Jamf::Pager::DEFAULT_PAGE_SIZE, cnx: Jamf.cnx)
+        return all_computers(paged: paged, page_size: page_size, cnx: cnx) if computer == :all
+
+        id = Jamf::Computer.valid_id computer
+        raise Jamf::NoSuchItemError, "No computer matches identifier '#{computer}'" unless id
+
+        data = cnx.jp_get "#{Jamf::Computer::JPAPI_INVENTORY_RSRC}/#{id}/#{FILEVAULT_RSRC_SUFFIX}"
+        Jamf::OAPISchemas::ComputerInventoryFileVault.new data
+
+      # if we get a 404 NOT FOUND error, this given computer has no FV data, so just return nil
+      rescue Jamf::Connection::JamfProAPIError => e
+        raise unless e.http_status == 404
+
+        nil
+      end # def
+
+      # return info for all computers, possibly as a Pager
+      # @see .filevault_info
+      ########################
+      def all_computers(paged: false, page_size: nil, cnx: Jamf.cnx)
+        list_path = "#{Jamf::Computer::JPAPI_INVENTORY_RSRC}/#{FILEVAULT_RSRC_SUFFIX}"
+        if paged
+          Jamf::Pager.new(
+            page_size: page_size,
+            list_path: list_path,
+            instantiate: Jamf::OAPISchemas::ComputerInventoryFileVault,
+            cnx: cnx
+          )
+        else
+          Jamf::Pager.all_pages(
+            list_path: list_path,
+            instantiate: Jamf::OAPISchemas::ComputerInventoryFileVault,
+            cnx: cnx
+          )
+        end
+      end
+      private :all_computers
+
+    end # module ClassMethods
+
+    # Instance Methods
+    ######################################
+
+    # Get the filevault info for this Computer instance
+    #
+    # @see FileVault::ClassMethods.filevault_info
+    #
+    def filevault_info
+      self.class.filevault_info @id, cnx: @cnx
+    end
+
+  end # module MacOSRedeployMgmtFramework
+
+end # module Jamf

data/lib/jamf/api/jamf_pro/mixins/filterable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/immutable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/jpapi_resource.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/mixins/lockable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/macos_managed_updates.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -33,7 +33,7 @@ module Jamf
 
     # when this module is included, also extend our Class Methods
     def self.included(includer)
-      Jamf.load_msg "--> #{includer} is including Jamf::MacOSManagedUpdates"
+      Jamf.load_msg "--> #{includer} is including #{self}"
       includer.extend(ClassMethods)
     end
 
@@ -65,7 +65,7 @@ module Jamf
 
       # when this module is included, also extend our Class Methods
       def self.extended(extender)
-        Jamf.load_msg "--> #{extender} is extending Jamf::MacOSManagedUpdates::ClassMethods"
+        Jamf.load_msg "--> #{extender} is extending #{self}"
       end
 
       # get the list of available OS versions
@@ -113,7 +113,8 @@ module Jamf
       #
       # @return [Jamf::OAPISchemas::MacOsManagedSoftwareUpdateResponse]
       ########################
-      def send_managed_os_update(updateAction:, deviceIds: nil, groupId: nil, maxDeferrals: nil, version: nil, skipVersionVerification: false, applyMajorUpdate: false, forceRestart: false, cnx: Jamf.cnx)
+      def send_managed_os_update(updateAction:, deviceIds: nil, groupId: nil, maxDeferrals: nil, version: nil, skipVersionVerification: false,
+                                 applyMajorUpdate: false, forceRestart: false, cnx: Jamf.cnx)
         action_to_send = UPDATE_ACTIONS.value?(updateAction) ? updateAction : UPDATE_ACTIONS[updateAction]
 
         raise ArgumentError, "Unknown updateAction, must be one of: #{UPDATE_ACTIONS.keys.join ', '}" unless action_to_send

data/lib/jamf/api/jamf_pro/mixins/macos_redeploy_mgmt_framework.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -26,7 +26,7 @@ module Jamf
 
   # This module should be mixed in to Jamf::Computer and Jamf::ComputerGroup
   #
-  # It provides access to the macos-managed-software-updates JPAPI resource for 
+  # It provides access to the macos-managed-software-updates JPAPI resource for
   # managed OS update commands to managed macs running Big Sur or higher.
   #
   module MacOSRedeployMgmtFramework
@@ -56,20 +56,20 @@ module Jamf
       # must be functioning. The target computer(s) will not re-install the framework if they
       # never recieve the MDM command.
       #
-      # @param target_ids [String, Integer, Array<String, Integer>] Jamf IDs for the 
+      # @param target_ids [String, Integer, Array<String, Integer>] Jamf IDs for the
       #   Computer or ComputerGroup targets.
       #
-      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx 
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
       #
-      # @return [Hash{Integer => String}] The result for each computer, either the 
+      # @return [Hash{Integer => String}] The result for each computer, either the
       #   uuid of the sent MDM command, or an error message.
       ########################
       def redeploy_mgmt_framework(target_ids, cnx: Jamf.cnx)
         target_ids = target_ids.is_a?(Array) ? target_ids : [target_ids]
-        target_comp_ids = 
-          if self == Jamf::Computer 
+        target_comp_ids =
+          if self == Jamf::Computer
             target_ids
-            
+
           elsif self == Jamf::ComputerGroup
             group_ids = target_ids.is_a?(Array) ? target_ids : [target_ids]
             comp_ids = []
@@ -77,7 +77,7 @@ module Jamf
             comp_ids
 
           else
-            raise Jamf::UnsupportedError, 'This method is only available for Jamf::Computer and Jamf::ComputerGroup' 
+            raise Jamf::UnsupportedError, 'This method is only available for Jamf::Computer and Jamf::ComputerGroup'
           end
 
         results = {}
@@ -88,7 +88,7 @@ module Jamf
           result = Jamf::OAPISchemas::RedeployJamfManagementFrameworkResponse.new result
           results[comp_id] = result.commandUuid
         rescue Jamf::Connection::JamfProAPIError => e
-          results[comp_id] = "ERROR: #{e}"          
+          results[comp_id] = "ERROR: #{e}"
         end
 
         results

data/lib/jamf/api/jamf_pro/mixins/prestage.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/mixins/sortable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/uncreatable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/undeletable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/oapi_schemas/access_groups_preview_search_results.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -35,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.40.0-t1657115323
+    # URL path on a Jamf Pro server version 10.46.0-t1681398190
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.
@@ -70,7 +70,8 @@ module Jamf
         # @!attribute totalCount
         #   @return [Integer]
         totalCount: {
-          class: :integer
+          class: :integer,
+          minimum: 0
         },
 
         # @!attribute results