smplkit 2.0.11 → 2.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11d1397bb7c77eeb63a28eb21bf9aab0688feffe5e8df6339c363511713ac843
-  data.tar.gz: 8efcc6ad6061be18bbf48fb5993dffd693a9f2b1243a0b091fde72fbe46830c5
+  metadata.gz: 9bc05d3192320fd1b2c4abee57b805383aa0dffb8b7d2a0a61c479ac18763d85
+  data.tar.gz: b9d40fb705d46129a8f4cf32350c3d82c2f6fdc430c20d36be1ca030e3130e0f
 SHA512:
-  metadata.gz: 936f0a2efbad65c8a7904b18ed28e0508892bbd4d641e6ed7774eba0df22c1c64aabe7f24780e0f2f31e5303905b58c3464122bff83f7c18863e81a3fcfe3dca
-  data.tar.gz: a0ec336127cd5a0d72bc943d0dda7e5df277cc010d4e6641699136b8d8eaecdad0b3eeab94f6c4ac54f5117109930b90f07e3e5df99f86724385a042b6a4099b
+  metadata.gz: 04d4ca3bd2849d284179c60406c76f725d8056b2434da699c87625d95f9fc80e5b24bf4810a60977a3296b1483e56010851fc3648047ec7ae975536b3eab38a8
+  data.tar.gz: 637480b2da969e94dc1f87260539b546253a908499369b3f1f16685f1adabaa3d22c8d3e95d53d453a0adbb99947d4146e3e2506dda790229b5d3b9f2a5bf3fe

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/log_groups_api.rb

@@ -20,27 +20,27 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # Create Log Group
-    # Create a new log group. The caller provides the key in data.id, or it is auto-generated from name.
-    # @param log_group_response [LogGroupResponse] 
+    # Create a log group.  The caller may supply a key in `data.id`; if omitted, the server generates one from `name`.
+    # @param log_group_request [LogGroupRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LogGroupResponse]
-    def create_log_group(log_group_response, opts = {})
-      data, _status_code, _headers = create_log_group_with_http_info(log_group_response, opts)
+    def create_log_group(log_group_request, opts = {})
+      data, _status_code, _headers = create_log_group_with_http_info(log_group_request, opts)
       data
     end
 
     # Create Log Group
-    # Create a new log group. The caller provides the key in data.id, or it is auto-generated from name.
-    # @param log_group_response [LogGroupResponse] 
+    # Create a log group.  The caller may supply a key in `data.id`; if omitted, the server generates one from `name`.
+    # @param log_group_request [LogGroupRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LogGroupResponse, Integer, Hash)>] LogGroupResponse data, response status code and response headers
-    def create_log_group_with_http_info(log_group_response, opts = {})
+    def create_log_group_with_http_info(log_group_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: LogGroupsApi.create_log_group ...'
       end
-      # verify the required parameter 'log_group_response' is set
-      if @api_client.config.client_side_validation && log_group_response.nil?
-        fail ArgumentError, "Missing the required parameter 'log_group_response' when calling LogGroupsApi.create_log_group"
+      # verify the required parameter 'log_group_request' is set
+      if @api_client.config.client_side_validation && log_group_request.nil?
+        fail ArgumentError, "Missing the required parameter 'log_group_request' when calling LogGroupsApi.create_log_group"
       end
       # resource path
       local_var_path = '/api/v1/log_groups'
@@ -62,7 +62,7 @@ module SmplkitGeneratedClient::Logging
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(log_group_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(log_group_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'LogGroupResponse'
@@ -88,7 +88,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Log Group
-    # Delete a log group by its key.
+    # Delete a log group.  Loggers that referenced this group are detached; they remain in the account with no group assignment.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -98,7 +98,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Log Group
-    # Delete a log group by its key.
+    # Delete a log group.  Loggers that referenced this group are detached; they remain in the account with no group assignment.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -151,7 +151,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Log Group
-    # Return a log group by its key.
+    # Retrieve a log group by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [LogGroupResponse]
@@ -161,7 +161,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Log Group
-    # Return a log group by its key.
+    # Retrieve a log group by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LogGroupResponse, Integer, Hash)>] LogGroupResponse data, response status code and response headers
@@ -214,7 +214,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Log Groups
-    # List all log groups for the authenticated account.
+    # List log groups for this account.
     # @param [Hash] opts the optional parameters
     # @return [LogGroupListResponse]
     def list_log_groups(opts = {})
@@ -223,7 +223,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Log Groups
-    # List all log groups for the authenticated account.
+    # List log groups for this account.
     # @param [Hash] opts the optional parameters
     # @return [Array<(LogGroupListResponse, Integer, Hash)>] LogGroupListResponse data, response status code and response headers
     def list_log_groups_with_http_info(opts = {})
@@ -271,23 +271,23 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Update Log Group
-    # Replace a log group entirely.
+    # Replace a log group. Every writable field is overwritten.
     # @param id [String] 
-    # @param log_group_response [LogGroupResponse] 
+    # @param log_group_request [LogGroupRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LogGroupResponse]
-    def update_log_group(id, log_group_response, opts = {})
-      data, _status_code, _headers = update_log_group_with_http_info(id, log_group_response, opts)
+    def update_log_group(id, log_group_request, opts = {})
+      data, _status_code, _headers = update_log_group_with_http_info(id, log_group_request, opts)
       data
     end
 
     # Update Log Group
-    # Replace a log group entirely.
+    # Replace a log group. Every writable field is overwritten.
     # @param id [String] 
-    # @param log_group_response [LogGroupResponse] 
+    # @param log_group_request [LogGroupRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LogGroupResponse, Integer, Hash)>] LogGroupResponse data, response status code and response headers
-    def update_log_group_with_http_info(id, log_group_response, opts = {})
+    def update_log_group_with_http_info(id, log_group_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: LogGroupsApi.update_log_group ...'
       end
@@ -295,9 +295,9 @@ module SmplkitGeneratedClient::Logging
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling LogGroupsApi.update_log_group"
       end
-      # verify the required parameter 'log_group_response' is set
-      if @api_client.config.client_side_validation && log_group_response.nil?
-        fail ArgumentError, "Missing the required parameter 'log_group_response' when calling LogGroupsApi.update_log_group"
+      # verify the required parameter 'log_group_request' is set
+      if @api_client.config.client_side_validation && log_group_request.nil?
+        fail ArgumentError, "Missing the required parameter 'log_group_request' when calling LogGroupsApi.update_log_group"
       end
       # resource path
       local_var_path = '/api/v1/log_groups/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -319,7 +319,7 @@ module SmplkitGeneratedClient::Logging
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(log_group_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(log_group_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'LogGroupResponse'

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/logger_sources_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List All Logger Sources
-    # List all logger sources across all loggers. Optionally filter by environment or service.
+    # List every logger source observation for this account.  Supports `filter[environment]` and `filter[service]` to narrow to a specific environment or service.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_environment 
     # @option opts [String] :filter_service 
@@ -31,7 +31,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List All Logger Sources
-    # List all logger sources across all loggers. Optionally filter by environment or service.
+    # List every logger source observation for this account.  Supports `filter[environment]` and `filter[service]` to narrow to a specific environment or service.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_environment 
     # @option opts [String] :filter_service 
@@ -83,7 +83,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logger Sources
-    # List all sources (service/environment observations) for a specific logger.
+    # List the service / environment observations recorded for a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerSourceListResponse]
@@ -93,7 +93,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logger Sources
-    # List all sources (service/environment observations) for a specific logger.
+    # List the service / environment observations recorded for a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerSourceListResponse, Integer, Hash)>] LoggerSourceListResponse data, response status code and response headers

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/loggers_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # Bulk Register Loggers
-    # Register loggers discovered by an SDK. Creates new loggers or updates source observations on existing ones.
+    # Register loggers discovered by an SDK.  Creates new logger entries for previously unseen keys and refreshes the per-(service, environment) observation for keys already known. Returns the number of items processed.
     # @param logger_bulk_request [LoggerBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerBulkResponse]
@@ -30,7 +30,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Bulk Register Loggers
-    # Register loggers discovered by an SDK. Creates new loggers or updates source observations on existing ones.
+    # Register loggers discovered by an SDK.  Creates new logger entries for previously unseen keys and refreshes the per-(service, environment) observation for keys already known. Returns the number of items processed.
     # @param logger_bulk_request [LoggerBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerBulkResponse, Integer, Hash)>] LoggerBulkResponse data, response status code and response headers
@@ -88,7 +88,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Logger
-    # Delete a logger by its key.
+    # Delete a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -98,7 +98,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Logger
-    # Delete a logger by its key.
+    # Delete a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -151,7 +151,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Logger
-    # Return a logger by its key.
+    # Retrieve a logger by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerResponse]
@@ -161,7 +161,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Logger
-    # Return a logger by its key.
+    # Retrieve a logger by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerResponse, Integer, Hash)>] LoggerResponse data, response status code and response headers
@@ -214,7 +214,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Loggers
-    # List all loggers for the authenticated account. Optionally filter by managed status, service, or last-seen time window.
+    # List loggers for this account.  Supports `filter[managed]` to narrow to managed (or unmanaged) loggers, `filter[service]` to keep only loggers observed in a specific service, and `filter[last_seen]` (interval notation `[<from>,*)`) to keep only loggers with a source observation at or after the given timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :filter_managed 
     # @option opts [String] :filter_service 
@@ -226,7 +226,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Loggers
-    # List all loggers for the authenticated account. Optionally filter by managed status, service, or last-seen time window.
+    # List loggers for this account.  Supports &#x60;filter[managed]&#x60; to narrow to managed (or unmanaged) loggers, &#x60;filter[service]&#x60; to keep only loggers observed in a specific service, and &#x60;filter[last_seen]&#x60; (interval notation &#x60;[&lt;from&gt;,*)&#x60;) to keep only loggers with a source observation at or after the given timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :filter_managed 
     # @option opts [String] :filter_service 
@@ -280,23 +280,23 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Update or Create Logger
-    # Create or update a logger (upsert). If the logger does not exist it is created. Fields absent from the body are preserved on update; explicit null clears them.
+    # Create or replace a logger at the given key.  If the logger does not yet exist, it is created. Fields omitted from the request body are preserved; explicit `null` clears them. Setting `level`, `group`, or `environments` on an unmanaged logger promotes it to managed automatically.
     # @param id [String] 
-    # @param logger_response [LoggerResponse] 
+    # @param logger_request [LoggerRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerResponse]
-    def update_logger(id, logger_response, opts = {})
-      data, _status_code, _headers = update_logger_with_http_info(id, logger_response, opts)
+    def update_logger(id, logger_request, opts = {})
+      data, _status_code, _headers = update_logger_with_http_info(id, logger_request, opts)
       data
     end
 
     # Update or Create Logger
-    # Create or update a logger (upsert). If the logger does not exist it is created. Fields absent from the body are preserved on update; explicit null clears them.
+    # Create or replace a logger at the given key.  If the logger does not yet exist, it is created. Fields omitted from the request body are preserved; explicit &#x60;null&#x60; clears them. Setting &#x60;level&#x60;, &#x60;group&#x60;, or &#x60;environments&#x60; on an unmanaged logger promotes it to managed automatically.
     # @param id [String] 
-    # @param logger_response [LoggerResponse] 
+    # @param logger_request [LoggerRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerResponse, Integer, Hash)>] LoggerResponse data, response status code and response headers
-    def update_logger_with_http_info(id, logger_response, opts = {})
+    def update_logger_with_http_info(id, logger_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: LoggersApi.update_logger ...'
       end
@@ -304,9 +304,9 @@ module SmplkitGeneratedClient::Logging
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling LoggersApi.update_logger"
       end
-      # verify the required parameter 'logger_response' is set
-      if @api_client.config.client_side_validation && logger_response.nil?
-        fail ArgumentError, "Missing the required parameter 'logger_response' when calling LoggersApi.update_logger"
+      # verify the required parameter 'logger_request' is set
+      if @api_client.config.client_side_validation && logger_request.nil?
+        fail ArgumentError, "Missing the required parameter 'logger_request' when calling LoggersApi.update_logger"
       end
       # resource path
       local_var_path = '/api/v1/loggers/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -328,7 +328,7 @@ module SmplkitGeneratedClient::Logging
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(logger_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(logger_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'LoggerResponse'

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/services_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List Services
-    # Return the distinct service names observed across all logger sources for the account.
+    # List the services that have reported a logger for this account.
     # @param [Hash] opts the optional parameters
     # @return [ServiceListResponse]
     def list_services(opts = {})
@@ -29,7 +29,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Services
-    # Return the distinct service names observed across all logger sources for the account.
+    # List the services that have reported a logger for this account.
     # @param [Hash] opts the optional parameters
     # @return [Array<(ServiceListResponse, Integer, Hash)>] ServiceListResponse data, response status code and response headers
     def list_services_with_http_info(opts = {})

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/usage_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List Logging Usage
-    # Return current resource usage counts for the authenticated account.
+    # Report the current-period usage counters for this account.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period 
     # @return [UsageListResponse]
@@ -30,7 +30,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logging Usage
-    # Return current resource usage counts for the authenticated account.
+    # Report the current-period usage counters for this account.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period 
     # @return [Array<(UsageListResponse, Integer, Hash)>] UsageListResponse data, response status code and response headers

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group.rb

@@ -14,19 +14,48 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # A named collection of loggers that share a level configuration.  Assigning a logger to a group ties the logger's effective level to the group's level (and per-environment overrides). Loggers can move between groups or be detached from a group entirely.
   class LogGroup < ApiModelBase
+    # Human-readable label for the group.
     attr_accessor :name
 
+    # Default level applied to every logger in the group. `null` leaves member loggers to inherit from elsewhere.
     attr_accessor :level
 
+    # Reserved for nested groups. Must be `null` in this version; nested groups are not yet supported.
     attr_accessor :parent_id
 
+    # Per-environment level overrides keyed by environment name. Each value is an object with an optional `level` field, e.g. `{\"production\": {\"level\": \"ERROR\"}}`. Member loggers inherit the per-environment level unless they set their own override.
     attr_accessor :environments
 
+    # When the group was created.
     attr_accessor :created_at
 
+    # When the group was last modified.
     attr_accessor :updated_at
 
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -130,10 +159,6 @@ module SmplkitGeneratedClient::Logging
         invalid_properties.push('invalid value for "name", the character length must be smaller than or equal to 255.')
       end
 
-      if !@level.nil? && @level.to_s.length > 10
-        invalid_properties.push('invalid value for "level", the character length must be smaller than or equal to 10.')
-      end
-
       invalid_properties
     end
 
@@ -143,7 +168,8 @@ module SmplkitGeneratedClient::Logging
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @name.nil?
       return false if @name.to_s.length > 255
-      return false if !@level.nil? && @level.to_s.length > 10
+      level_validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      return false unless level_validator.valid?(@level)
       true
     end
 
@@ -161,13 +187,13 @@ module SmplkitGeneratedClient::Logging
       @name = name
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] level Value to be assigned
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] level Object to be assigned
     def level=(level)
-      if !level.nil? && level.to_s.length > 10
-        fail ArgumentError, 'invalid value for "level", the character length must be smaller than or equal to 10.'
+      validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      unless validator.valid?(level)
+        fail ArgumentError, "invalid value for \"level\", must be one of #{validator.allowable_values}."
       end
-
       @level = level
     end
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_list_response.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API collection response for log groups.
   class LogGroupListResponse < ApiModelBase
     attr_accessor :data
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_request.rb

@@ -0,0 +1,165 @@
+=begin
+#smplkit Logging API
+
+#API for the smplkit logging service.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module SmplkitGeneratedClient::Logging
+  # JSON:API request envelope for creating or updating a log group.
+  class LogGroupRequest < ApiModelBase
+    attr_accessor :data
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data' => :'data'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'data' => :'LogGroupResource'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `SmplkitGeneratedClient::Logging::LogGroupRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `SmplkitGeneratedClient::Logging::LogGroupRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'data')
+        self.data = attributes[:'data']
+      else
+        self.data = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @data.nil?
+        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @data.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] data Value to be assigned
+    def data=(data)
+      if data.nil?
+        fail ArgumentError, 'data cannot be nil'
+      end
+
+      @data = data
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          data == o.data
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [data].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_resource.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API resource envelope for a log group.  `id` is the group's key (e.g. `database-loggers`). On a create request the id may be supplied; if omitted, the server generates one from `name`.
   class LogGroupResource < ApiModelBase
     attr_accessor :id
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_response.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API single-resource response envelope for a log group.
   class LogGroupResponse < ApiModelBase
     attr_accessor :data