ruby-jss 2.0.0a10 → 2.0.0b3

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

@@ -138,10 +138,23 @@ module Jamf
       #   token this many seconds before it expires.
       #   Must be >= Jamf::Connection::Token::MIN_REFRESH_BUFFER, which is the default
       #
-      # @option params :pw_fallback  [Boolean] If keep_alive, should the passwd be
+      # @option params :pw_fallback [Boolean] If keep_alive, should the passwd be
       #   cached in memory and used to create a new token, if there are problems
       #   with the normal token refresh process?
       #
+      # @option params :sticky_session [Boolean] Use a 'sticky session'? Default is false.
+      #   The hostname of Jamf Cloud urls does not point to a single https server,
+      #   but any node of a cluster. Those nodes often take time to see changes
+      #   made in other node. Sometimes, its important to perform a series of API 
+      #   actions to the same node, to avoid sync-timing problems between node. Setting
+      #   sticky_session to true will cause all communication for this Connection to go
+      #   through the one specific node it first connected ith.
+      #   This is only relevant to Jamf Cloud connections, and will raise an exception
+      #   is used with on-prem Jamf Pro servers.
+      #   NOTE: It is not always appropriate to use this feature, and inapproriate use
+      #   may negatively impact server performance. For more info, see
+      #   https://developer.jamf.com/developer-guide/docs/sticky-sessions-for-jamf-cloud
+      #
       # @return [String] connection description, the output of #to_s
       #
       #######################################################
@@ -185,12 +198,44 @@ module Jamf
         @c_cnx = create_classic_connection
         @jp_cnx = create_jp_connection
 
+        # set the connection objects to sticky if desired. enforce booleans
+        self.sticky_session = params[:sticky_session] ? true : false
+
         @connected = true
 
         to_s
       end # connect
       alias login connect
 
+      # If a sticky_session was requested when the connection was made, and
+      # we are connected to a jamf cloud server, the token's http response 
+      # contains the cookie we need to send with every request to ensure a 
+      # stickey session.
+      #################################
+      def enable_sticky_session(headers) 
+        # commas separate the cookies
+        raw_cookies = headers[Jamf::Connection::SET_COOKIE_HEADER].split(/\s*,\s*/)
+
+        raw_cookies.each do |rc|
+          # semicolons separate the attributes of the cookie,
+          # with its name and value being the first pair.
+          cookie_data = rc.split(/\s*;\s*/).first
+
+          # attribute name and value are separated by '='
+          cookie_name, cookie_value = cookie_data.split('=')
+          next unless cookie_name == Jamf::Connection::STICKY_SESSION_COOKIE_NAME
+
+          @sticky_session_cookie = "#{Jamf::Connection::STICKY_SESSION_COOKIE_NAME}=#{cookie_value}"
+          jp_cnx.headers[Jamf::Connection::COOKIE_HEADER] = @sticky_session_cookie
+          c_cnx.headers[Jamf::Connection::COOKIE_HEADER] = @sticky_session_cookie 
+          return @sticky_session_cookie
+        end
+        # be sure to return nil if there was no appropriate cookie,
+        # which means we aren't using Jamf Cloud
+
+        nil
+      end
+
       # raise exception if not connected, and make sure we're using
       # the current token
       def validate_connected(subcnx)
@@ -224,6 +269,8 @@ module Jamf
         @jp_base_url = nil
         @server_path = nil
         @token = nil
+        @sticky_session_cookie = nil
+        @sticky_session = nil
         @connected = false
         :disconnected
       end # disconnect
@@ -429,7 +476,7 @@ module Jamf
         token_params[:token_string] = params[:token] if type == :token_string
         token_params[:pw] = params[:pw] unless params[:pw].is_a? Symbol
 
-        self.class::Token.new **token_params
+        self.class::Token.new(**token_params)
       end
 
       # Build the base URL for the API connection

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

@@ -99,6 +99,12 @@ module Jamf
         @connect_time
       ].freeze
 
+      SET_COOKIE_HEADER = 'set-cookie'.freeze
+
+      COOKIE_HEADER = 'Cookie'.freeze
+
+      STICKY_SESSION_COOKIE_NAME = 'APBALANCEID'.freeze
+
     end # module
 
   end # class

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

@@ -53,13 +53,17 @@ module Jamf
 
       # @param rsrc[String] the resource to get
       #   (the part of the API url after the '/api/' )
-      #
+  
       # @return [Hash] the result of the get
       #######################################################
       def jp_get(rsrc)
         validate_connected @jp_cnx
-        resp = @jp_cnx.get rsrc
+        resp = @jp_cnx.get(rsrc) do |req|
+          # Modify the request here if needed.
+          # puts "JPAPI Cookie is: #{req.headers['Cookie']}"
+        end
         @last_http_response = resp
+
         return resp.body if resp.success?
 
         raise Jamf::Connection::JamfProAPIError, resp

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

@@ -87,6 +87,7 @@ module Jamf
       # @return [String] The token data
       attr_reader :token
       alias token_string token
+      alias auth_token token
 
       # @return [URI] The base API url, e.g. https://myjamf.jamfcloud.com/
       attr_reader :base_url
@@ -112,6 +113,12 @@ module Jamf
       attr_reader :pw_fallback
       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 
+      #   string. This is not updated when refreshing a token, only when
+      #   calling Token.new
+      attr_reader :creation_http_response
+
       # @param params [Hash] The data for creating and maintaining the token
       #
       # @option params [String] :token_string An existing valid token string.
@@ -139,7 +146,6 @@ module Jamf
       #
       # @option params [Boolean] :verify_cert (see Connection#connect)
       #
-      #
       ###########################################
       def initialize(**params)
         @valid = false
@@ -164,10 +170,11 @@ 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
+          @creation_http_response = resp
         elsif resp.status == 401
           raise Jamf::AuthenticationError, 'Incorrect name or password'
         else
@@ -184,6 +191,7 @@ module Jamf
         resp = token_connection(AUTH_RSRC, token: str).get
         raise Jamf::InvalidDataError, 'Token is not valid' unless resp.success?
 
+        @creation_http_response = resp
         @token = str
         @user = resp.body.dig :account, :username
 
@@ -348,7 +356,6 @@ module Jamf
       end
       alias keep_alive refresh
 
-
       # Make this token invalid
       #################################
       def invalidate

data/lib/jamf/api/connection.rb

@@ -198,7 +198,7 @@ module Jamf
     def to_s
       return 'not connected' unless connected?
 
-      if name.start_with? "#{user}@"
+      if name.to_s.start_with? "#{user}@"
         name
       else
         "#{user}@#{host}:#{port}, name: #{name}"

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

@@ -42,6 +42,7 @@ module Jamf
   #
   #
   class InventoryPreloadRecord < Jamf::OAPISchemas::InventoryPreloadRecordV2
+
     # Mix-Ins
     #####################################
     include Jamf::CollectionResource
@@ -109,6 +110,12 @@ module Jamf
     # Must define this when extending Filterable
     FILTER_KEYS = OAPI_PROPERTIES.keys - [:extensionAttributes]
 
+    DEVICE_TYPE_COMPUTER = 'Computer'.freeze
+
+    DEVICE_TYPE_MOBILE_DEV = 'Mobile Device'.freeze
+
+    DEVICE_TYPE_UNKNOWN = 'Unknown'.freeze
+
     # InvPreload Recs have a non-standard /history path
     def self.history_path(_id)
       'v2/inventory-preload/history'
@@ -128,7 +135,7 @@ module Jamf
       new_val
     end
 
-    # remove an EA value
+    # remove an EA totally (vs setting its value to nil)
     def remove_ext_attr(ea_name)
       idx = extensionAttributes.index { |ea| ea.name == ea_name }
       extensionAttributes_delete_at idx if idx
@@ -158,6 +165,7 @@ module Jamf
     def history_path(_id)
       raise Jamf::UnsupportedError, 'InventoryPreloadRecords do not have individual change logs. Use Jamf::InventoryPreloadRecord.change_log'
     end
+
   end # class
 
 end # module

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

@@ -35,7 +35,6 @@ module Jamf
 
     include Comparable
 
-
     # Public Class Methods
     #####################################
 
@@ -49,7 +48,7 @@ module Jamf
     # and will cause Jamf::Resource.save to raise an error
     #
     def self.mutable?
-        !singleton_class.ancestors.include? Jamf::Immutable
+      !singleton_class.ancestors.include? Jamf::Immutable
     end
 
     # An array of attribute names that are required when
@@ -60,6 +59,12 @@ module Jamf
       self::OAPI_PROPERTIES.select { |_attr, deets| deets[:required] }.keys
     end
 
+    # have we already parsed our OAPI_PROPERTIES? If so,
+    # we shoudn't do it again, an this can be used to check
+    def self.oapi_properties_parsed?
+      @oapi_properties_parsed
+    end
+
     # create getters and setters for subclasses of APIObject
     # based on their OAPI_PROPERTIES Hash.
     #
@@ -105,7 +110,6 @@ module Jamf
     # Private Class Methods
     #####################################
 
-
     # create a getter for an attribute, and any aliases needed
     ##############################
     def self.create_getters(attr_name, attr_def)
@@ -339,7 +343,6 @@ module Jamf
     # Constructor
     #####################################
 
-
     # Make an instance. Data comes from the API
     #
     # @param data[Hash] the data for constructing a new object.
@@ -371,7 +374,7 @@ module Jamf
     # Are objects of this class mutable?
     # @see the class method in OAPIObject
     def mutable?
-        self.class.mutable?
+      self.class.mutable?
     end
 
     # a hash of all unsaved changes
@@ -393,6 +396,7 @@ module Jamf
 
         # skip those that don't have any changes
         next unless value.respond_to? :unsaved_changes?
+
         attr_changes = value.unsaved_changes
         next if attr_changes.empty?
 
@@ -427,7 +431,7 @@ module Jamf
     end
 
     # @return [Hash] The data to be sent to the API, as a Hash
-    #  to be converted to JSON by the Jamf::Connection
+    #  to be converted to JSON before sending to the JPAPI
     #
     def to_jamf
       jamf_data = {}
@@ -438,6 +442,13 @@ module Jamf
       jamf_data
     end
 
+    # @return [String] the JSON to be sent to the API for this
+    #   object
+    #
+    def to_json(*_args)
+      to_jamf.to_json
+    end
+
     # Print the JSON version of the to_jamf outout
     # mostly for debugging/troubleshooting
     def pretty_jamf_json
@@ -537,7 +548,7 @@ module Jamf
         parse_enum_value(api_value, attr_name, attr_def)
 
       # a Class value
-    elsif attr_def[:class].instance_of? Class
+      elsif attr_def[:class].instance_of? Class
         attr_def[:class].new api_value
 
       # a :j_id value. See the docs for OAPI_PROPERTIES in Jamf::OAPIObject
@@ -556,12 +567,13 @@ 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], msg: "#{api_value} is not in the allowed values for attribute #{attr_name}. Must be one of: #{attr_def[:enum].join ', '}"
+      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
 
     # call to_jamf on a single value if it knows that method
     #
-    def single_to_jamf(raw_value, attr_def)
+    def single_to_jamf(raw_value, _attr_def)
       raw_value.respond_to?(:to_jamf) ? raw_value.to_jamf : raw_value
     end
 

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

@@ -0,0 +1,178 @@
+# Copyright 2022 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.
+#
+#
+
+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.
+  #
+  module MacOSManagedUpdates
+
+    # when this module is included, also extend our Class Methods
+    def self.included(includer)
+      Jamf.load_msg "--> #{includer} is including Jamf::MacOSManagedUpdates"
+      includer.extend(ClassMethods)
+    end
+
+    # These resources in the Jamf Pro API can be used to send Managed macOS 
+    # updates to clients running Big Sur or higher
+    MANAGED_SW_UPDATES_RSRC = 'v1/macos-managed-software-updates'
+
+    # GETting this resource provides a list of available OS versions
+    MANAGED_SW_UPDATES_AVAILABLE_VERSIONS_RSRC = "#{MANAGED_SW_UPDATES_RSRC}/available-updates"
+
+    # POSTing JSON data to this resource will send the MDM commands to install os updates
+    # For details about the data to send, see 
+    # https://developer.jamf.com/jamf-pro/reference/post_v1-macos-managed-software-updates-send-updates
+    MANAGED_SW_UPDATES_SEND_UPDATES_RSRC = "#{MANAGED_SW_UPDATES_RSRC}/send-updates"
+
+    # These are the options available in Jamf::OAPISchemas::MacOsManagedSoftwareUpdate::UPDATE_ACTION_OPTIONS
+    DOWNLOAD_AND_INSTALL = 'DOWNLOAD_AND_INSTALL'
+    DOWNLOAD_ONLY = 'DOWNLOAD_ONLY'
+
+    # Class Methods
+    #####################################
+    module ClassMethods
+
+      # when this module is included, also extend our Class Methods
+      def self.extended(extender)
+        Jamf.load_msg "--> #{extender} is extending Jamf::MacOSManagedUpdates::ClassMethods"
+      end
+
+      # get the list of available OS versions
+      #
+      # @return [Array<String>]
+      ###################
+      def available_os_updates(cnx: Jamf.cnx)
+        data = cnx.jp_get(MANAGED_SW_UPDATES_AVAILABLE_VERSIONS_RSRC)
+        Jamf::OAPISchemas::AvailableUpdates.new(data).availableUpdates
+      end
+
+      # Send the os update command to target Computers or a ComputerGroup
+      #
+      # @param updateAction [String] Required. 'DOWNLOAD_AND_INSTALL' or 'DOWNLOAD_ONLY'
+      #
+      # @param deviceIds [String, Integer, Array<String, Integer>] Identifiers for the 
+      #   computer targets. Required if no groupId is given.
+      #
+      # @param groupId [String, Integer] Identifier for the computer group target.
+      #   Requied if no deviceIDs are given.
+      #
+      # @param maxDeferrals [Integer] Allow users to defer the update the provided number 
+      #   of times before macOS forces the update. If a value is provided, the Software 
+      #   Update will use the InstallLater install action. MaxDeferral is ignored if using the 
+      #   DOWNLOAD_ONLY updateAction.
+      #
+      # @param version [String] The OS version to install. If no value is provided, the 
+      #   version will default to latest version based on device eligibility.
+      #
+      # @param skipVersionVerification [Boolean] Should the specified version be installed
+      #   even it it isn't applicable to this machine? If no value is provided, will default to false.
+      #   If true, the specified version will be forced to complete DownloadAndInstall
+      #   install action.
+      #
+      # @param applyMajorUpdate [Boolean] Available only when updating to the latest version
+      #   based on device eligibility. Defaults to false. If false the calculated latest version
+      #   will only include minor version updates. If a value is provided, the calculated latest
+      #   version will include minor and major version updates.
+      #
+      # @param forceRestart [Boolean]  Will default to false. Can only be true if updateAction 
+      #   is DOWNLOAD_AND_INSTALLn and the devices the command is sent to are on macOs 11 or higher. 
+      #   If true, the DownloadAndInstall action is performed, a restart will be forced. 
+      #   MaxDeferral will be ignored if true. 
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx 
+      #
+      # @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)
+        if self == Jamf::Computer 
+          raise ArgumentError, 'Must provide one or more deviceIds' unless deviceIds
+        elsif self == Jamf::ComputerGroup
+          raise ArgumentError, 'Must provide a groupId' unless groupId
+        else
+          raise Jamf::UnsupportedError, 'This method is only available for Jamf::Computer and Jamf::ComputerGroup' 
+        end
+
+        if version
+          available_versions = available_os_updates
+          raise ArgumentError, "Invalid version, must be one of: #{available_versions.join ', '}" unless available_versions.include? version
+        end
+
+        if deviceIds
+          deviceIds = [deviceIds] unless deviceIds.is_a?(Array)
+          deviceIds.map! { |id| valid_id id }
+        end
+        groupId = valid_id groupId if groupId
+
+        data = {}
+        # ids in the JPAPI are string containing integers
+        data[:deviceIds] = deviceIds.map(&:to_s) if deviceIds
+        data[:groupId] = groupId.to_s if groupId
+
+        data[:maxDeferrals] = maxDeferrals if maxDeferrals
+        data[:version] = version if version
+        data[:skipVersionVerification] = skipVersionVerification if skipVersionVerification
+        data[:applyMajorUpdate] = applyMajorUpdate if applyMajorUpdate
+        data[:updateAction] = updateAction if updateAction
+        data[:forceRestart] = forceRestart if forceRestart  
+        
+        payload = Jamf::OAPISchemas::MacOsManagedSoftwareUpdate.new(data).to_json
+        
+        result = cnx.jp_post MANAGED_SW_UPDATES_SEND_UPDATES_RSRC, payload
+        Jamf::OAPISchemas::MacOsManagedSoftwareUpdateResponse.new result
+      end
+
+    end # module ClassMethods
+
+    # Instance Methods
+    ######################################
+
+    # Send a managed update command to an instance of Computer or ComputerGroup.
+    # This just calls the class method of the same name.
+    #
+    # @see MacOSManagedUpdates.send_managed_os_update
+    #
+    def send_managed_os_update(updateAction:, maxDeferrals: nil, version: nil, skipVersionVerification: false, applyMajorUpdate: false, forceRestart: false, cnx: Jamf.cnx)
+      deviceIds = is_a?(Jamf::Computer) ? @id : nil
+      groupId = is_a?(Jamf::Computer) ? nil : @id
+
+      self.class.send_managed_os_update(
+        deviceIds: deviceIds, 
+        groupId: groupId, 
+        maxDeferrals: maxDeferrals, 
+        version: version, 
+        skipVersionVerification: skipVersionVerification, 
+        applyMajorUpdate: applyMajorUpdate, 
+        forceRestart: forceRestart, 
+        updateAction: updateAction, 
+        cnx: @cnx
+      )
+    end
+
+  end # module MacOSManagedUpdates
+
+end # module Jamf

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

@@ -139,6 +139,11 @@ module Jamf
       # Is the given serialNumber assigned to any prestage, or to the
       # given prestage if a prestage is specified?
       #
+      # This uses .serials_by_prestage_id, the class-level scope path which
+      # gets a hash of all assigned SNS => the id of the prestage they are
+      # assigned to. The instance#assigned? method uses a different path
+      # which returnds more data in an OAPI object.
+      #
       # NOTE: If a serial number isn't assigned to any prestage, it may really be
       # unassigned or it may not exist in your ADE. To see if a SN exists in one
       # of your Device Enrollment instances, use Jamf::DeviceEnrollment.include?
@@ -269,6 +274,8 @@ module Jamf
 
     # The scope data for this prestage
     #
+    # TODO: retain this caching?
+    #
     # @param refresh[Boolean] reload fromthe API?
     #
     # @return [PrestageScope]
@@ -278,6 +285,8 @@ module Jamf
       return @scope if @scope
 
       @scope = INSTANCE_SCOPE_OBJECT.new @cnx.get(scope_path)
+      # TODO: is this the best way to deal with fetching a scope that
+      # is more updated than the rest of the object?
       unless @scope.versionLock == @versionLock
         raise Jamf::VersionLockError, "The #{self.class} '#{name}' has been modified since it was fetched. Please refetch and try again"
       end
@@ -286,12 +295,18 @@ module Jamf
     end
 
     # @return [Array<String>] the serialnumbers assigned to this prestage
-    def assigned_sns
-      scope.assignments.map(&:serialNumber)
+    def assigned_sns(refresh: false)
+      return @assigned_sns if @assigned_sns
+
+      @assigned_sns = nil if refresh
+      @assigned_sns = scope.assignments.map(&:serialNumber)
     end
 
     # Is this SN assigned to this prestage?
     #
+    # This method uses the instance's scope object, from a different API
+    # path than the class-level .assigned? method.
+    #
     # @param sn[String] the sn to look for
     #
     # @return [Boolean]
@@ -336,11 +351,6 @@ module Jamf
       @scope_path ||= "#{get_path}/#{SCOPE_PATH}"
     end
 
-    def scope
-      data = @cnx.jp_get(scope_path)
-      INSTANCE_SCOPE_OBJECT.new **data
-    end
-
   end # class
 
 end # module

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

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # 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.
@@ -58,7 +57,7 @@ module Jamf
     # Endpoints and Privileges:
     # API endpoints and HTTP operations that use this object
     # model, and the Jamf Pro privileges needed to access them.
-    #  - '/preview/enrollment/access-groups:GET' needs permissions:
+    #  - '/v3/enrollment/access-groups:GET' needs permissions:
     #    - Read User-Initiated Enrollment
     #
     #

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

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # 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.

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

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # 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.