apcera 0.1.7.0 → 0.1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 69a59e9b2ab5e6603c1196de06fc345facc8a71f
-  data.tar.gz: 4bd6eb59b4c6c04d4bf0db816576936573c76730
+  metadata.gz: 13a67f4c4da84c0d6e5c5bb595a60d66ba162e54
+  data.tar.gz: a51839479d7b857319575f57125282f129205f42
 SHA512:
-  metadata.gz: 2512f1cb55672d0f533c57dd9f407cb27bc2036e5bf628365e48905feda1c22073ea9925c400d9a45e0770020b6a839b29accbf9b4cf8f8f24137040d7eb3b04
-  data.tar.gz: 0e3819ce69b0c90d41ad5683c885f2fe742e5eb3428511624d4b0c4655877a33051ef84e0b8ea9d3f869f4b334be924ef9b18ef10040629793ed3ec11e6e449f
+  metadata.gz: 5dbaae75ddcbbf39fe89a2e7dad49ee770ee2b1dd9f42c9e394b31c0cc7146d01a516353f11896716210c393696cc68c408ca9bf4ac8fa9b00f0ac1defce0869
+  data.tar.gz: 8f65157ed1e91fd2842e5e4845b2747075a46f5fa333c9c87b06cb60af48fa43fca0c0141f695c084c3a12a47f6718532469ad872dc3522341efe87d79a7d45d

data/lib/apcera.rb

@@ -6,7 +6,7 @@ require 'apcera/configuration'
 
 # Models
 require 'apcera/models/base_object'
-require 'apcera/models/apc_version_object'
+require 'apcera/models/apc_download_url'
 require 'apcera/models/api_error'
 require 'apcera/models/audit_log_item'
 require 'apcera/models/audit_log_item_old'
@@ -26,7 +26,6 @@ require 'apcera/models/instances'
 require 'apcera/models/job'
 require 'apcera/models/job_health'
 require 'apcera/models/job_network_reference'
-require 'apcera/models/job_preferences'
 require 'apcera/models/log'
 require 'apcera/models/metric_series'
 require 'apcera/models/metric_series_hash'
@@ -50,22 +49,25 @@ require 'apcera/models/rule'
 require 'apcera/models/runtime'
 require 'apcera/models/semi_pipe_rule'
 require 'apcera/models/semi_pipe_rule_action'
-require 'apcera/models/stager_job'
 require 'apcera/models/service'
+require 'apcera/models/service_request_object'
+require 'apcera/models/stager_job'
 require 'apcera/models/staging_pipeline'
-require 'apcera/models/subnet_info'
 require 'apcera/models/sub_task'
+require 'apcera/models/subnet_info'
 require 'apcera/models/task'
 require 'apcera/models/task_event'
 require 'apcera/models/task_progress'
 require 'apcera/models/unbind_parameter_object'
 require 'apcera/models/unlink_parameter_object'
+require 'apcera/models/version_info'
 require 'apcera/models/virtual_network'
 require 'apcera/models/virtual_network_endpoint'
 require 'apcera/models/virtual_network_endpoint_interface'
 
 # APIs
 require 'apcera/api/instances_api'
+require 'apcera/api/virtual_networks_api'
 require 'apcera/api/utilities_api'
 require 'apcera/api/metrics_api'
 require 'apcera/api/jobs_api'
@@ -73,7 +75,6 @@ require 'apcera/api/packages_api'
 require 'apcera/api/services_and_bindings_api'
 require 'apcera/api/logs_api'
 require 'apcera/api/providers_api'
-require 'apcera/api/default_api'
 require 'apcera/api/rules_api'
 require 'apcera/api/staging_pipelines_api'
 

data/lib/apcera/api/instances_api.rb

@@ -169,60 +169,6 @@ module Apcera
       return result
     end
 
-    # Creates a snapshot of a capsule.
-    # 
-    # @param uuid UUID of the job from which to create the capsule.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :authorization 
-    # @return [nil]
-    def instances_uuid_snapshot_post(uuid, opts = {})
-    
-      if Configuration.debugging
-        Configuration.logger.debug "Calling API: InstancesApi#instances_uuid_snapshot_post ..."
-      end
-      
-      
-      # verify the required parameter 'uuid' is set
-      fail "Missing the required parameter 'uuid' when calling instances_uuid_snapshot_post" if uuid.nil?
-      
-      # resource path
-      path = "/instances/{uuid}/snapshot".sub('{format}','json').sub('{' + 'uuid' + '}', uuid.to_s)
-
-      # query parameters
-      query_params = {}
-
-      # header parameters
-      header_params = {}
-
-      # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
-      # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
-      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = nil
-      
-
-      auth_names = ['authorization']
-      @api_client.call_api(:POST, path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names)
-      if Configuration.debugging
-        Configuration.logger.debug "API called: InstancesApi#instances_uuid_snapshot_post"
-      end
-      return nil
-    end
-
     # Lists all tags on all instance managers in the cluster.
     # Lists all tags on all instance managers in the cluster. Requires `read` privileges on the `cluster` realm.
     # @param [Hash] opts the optional parameters

data/lib/apcera/api/jobs_api.rb

@@ -63,6 +63,71 @@ module Apcera
       return result
     end
 
+    # Creates a snapshot of a instance of a job.
+    # Issues a snapshot request to the specified job instance.
+    # @param uuid UUID of the job to be snapshotted.
+    # @param instance_uuid UUID of the instance to be snapshotted.
+    # @param pkg_fqn FQN of snapshot package to return.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :directory Directory of a given job/capsule to snapshot.
+    # @option opts [String] :authorization 
+    # @return [nil]
+    def job_uuid_instances_instance_uuid_snapshot_post(uuid, instance_uuid, pkg_fqn, opts = {})
+    
+      if Configuration.debugging
+        Configuration.logger.debug "Calling API: JobsApi#job_uuid_instances_instance_uuid_snapshot_post ..."
+      end
+      
+      
+      # verify the required parameter 'uuid' is set
+      fail "Missing the required parameter 'uuid' when calling job_uuid_instances_instance_uuid_snapshot_post" if uuid.nil?
+      
+      # verify the required parameter 'instance_uuid' is set
+      fail "Missing the required parameter 'instance_uuid' when calling job_uuid_instances_instance_uuid_snapshot_post" if instance_uuid.nil?
+      
+      # verify the required parameter 'pkg_fqn' is set
+      fail "Missing the required parameter 'pkg_fqn' when calling job_uuid_instances_instance_uuid_snapshot_post" if pkg_fqn.nil?
+      
+      # resource path
+      path = "/job/{uuid}/instances/{instance_uuid}/snapshot".sub('{format}','json').sub('{' + 'uuid' + '}', uuid.to_s).sub('{' + 'instance_uuid' + '}', instance_uuid.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'pkgFQN'] = pkg_fqn
+      query_params[:'directory'] = opts[:'directory'] if opts[:'directory']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      _header_accept = []
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+
+      # HTTP header 'Content-Type'
+      _header_content_type = []
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      
+
+      auth_names = ['authorization']
+      @api_client.call_api(:POST, path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if Configuration.debugging
+        Configuration.logger.debug "API called: JobsApi#job_uuid_instances_instance_uuid_snapshot_post"
+      end
+      return nil
+    end
+
     # List jobs.
     # Returns a list of jobs, optionally filtered by one or more query parameters.
     # @param [Hash] opts the optional parameters
@@ -140,7 +205,7 @@ module Apcera
 
     # Creates a new job.
     # Creates a new job from the Job object passed in the POST body. The only required property in the request object is `fqn` ([Fully Qualified Name](http://docs.apcera.com/reference/glossary/#fqn)).
-    # @param job An object that defines the properties of the new job. The only required parameter is `fqn`.
+    # @param job An object that defines the properties of the new job.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :authorization 
     # @return [Job]
@@ -1194,62 +1259,6 @@ module Apcera
       return nil
     end
 
-    # Returns job-specific preferences.
-    # Returns job-specific preferences used to expose claims retrieved from policy that are contextually important to the job.
-    # @param fqn FQN of package whose job whose preferences should be returned.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :authorization 
-    # @return [JobPreferences]
-    def preferences_job_get(fqn, opts = {})
-    
-      if Configuration.debugging
-        Configuration.logger.debug "Calling API: JobsApi#preferences_job_get ..."
-      end
-      
-      
-      # verify the required parameter 'fqn' is set
-      fail "Missing the required parameter 'fqn' when calling preferences_job_get" if fqn.nil?
-      
-      # resource path
-      path = "/preferences/job".sub('{format}','json')
-
-      # query parameters
-      query_params = {}
-      query_params[:'fqn'] = fqn
-
-      # header parameters
-      header_params = {}
-
-      # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
-      # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
-      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = nil
-      
-
-      auth_names = ['authorization']
-      result = @api_client.call_api(:GET, path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => 'JobPreferences')
-      if Configuration.debugging
-        Configuration.logger.debug "API called: JobsApi#preferences_job_get. Result: #{result.inspect}"
-      end
-      return result
-    end
-
     # Returns a list of task events for a given task.
     # Returns the requested Task, which contains a list of task events. A client can poll this endpoint to check the status of a task. Optionally, a client can request a websocket connection over which tasks are streamed in real-time.
     # @param uuid UUID of task.

data/lib/apcera/api/logs_api.rb

@@ -8,6 +8,65 @@ module Apcera
       @api_client = api_client || Configuration.api_client
     end
 
+    # Returns audit log items for the cluster.
+    # Returns a list audit log items. You can optionally filter the list by start time, end time, FQN, or event type.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :start_time UNIX timestamp. If specified, only events that occurred on or after the specified time are returned in the response.
+    # @option opts [Float] :end_time UNIX timestamp. If specified, only events that occurred on or before the specified time are returned in the response.
+    # @option opts [String] :fqn If specified, only events on the resource specified by `fqn` are returned in the response. You can also specify an FQN segment, which may include wildcards for the resource type. For example:\n * `*::/` returns all audit logs for all resource types.\n * `job::/` returns all audit logs for Job resource types. \n * `job::/apcera` returns all audit logs for Job resource types in the `/apcera` namespace and its sub-namespaces. \n * `*::/apcera` returns all audit logs for all resource types in the `/apcera` namespace its sub-namespaces.
+    # @option opts [String] :event_type If specified, only events of the specified type are returned in the response.
+    # @option opts [String] :authorization 
+    # @return [Array<AuditLogItem>]
+    def audit_get(opts = {})
+    
+      if Configuration.debugging
+        Configuration.logger.debug "Calling API: LogsApi#audit_get ..."
+      end
+      
+      
+      # resource path
+      path = "/audit".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'start_time'] = opts[:'start_time'] if opts[:'start_time']
+      query_params[:'end_time'] = opts[:'end_time'] if opts[:'end_time']
+      query_params[:'fqn'] = opts[:'fqn'] if opts[:'fqn']
+      query_params[:'event_type'] = opts[:'event_type'] if opts[:'event_type']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      _header_accept = []
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+
+      # HTTP header 'Content-Type'
+      _header_content_type = []
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      
+
+      auth_names = ['authorization']
+      result = @api_client.call_api(:GET, path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Array<AuditLogItem>')
+      if Configuration.debugging
+        Configuration.logger.debug "API called: LogsApi#audit_get. Result: #{result.inspect}"
+      end
+      return result
+    end
+
     # Returns audit log items for the cluster.
     # Returns a list of audit log items.
     # @param [Hash] opts the optional parameters

data/lib/apcera/api/services_and_bindings_api.rb

@@ -63,7 +63,7 @@ module Apcera
       return result
     end
 
-    # List available services.
+    # Lists available services.
     # 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :authorization 
@@ -120,7 +120,8 @@ module Apcera
     # 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :authorization 
-    # @return [nil]
+    # @option opts [ServiceRequestObject] :service_request Describes the service to create.
+    # @return [Service]
     def services_post(opts = {})
     
       if Configuration.debugging
@@ -150,20 +151,21 @@ module Apcera
       form_params = {}
 
       # http body (model)
-      post_body = nil
+      post_body = @api_client.object_to_http_body(opts[:'service_request'])
       
 
       auth_names = ['authorization']
-      @api_client.call_api(:POST, path,
+      result = @api_client.call_api(:POST, path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
-        :auth_names => auth_names)
+        :auth_names => auth_names,
+        :return_type => 'Service')
       if Configuration.debugging
-        Configuration.logger.debug "API called: ServicesAndBindingsApi#services_post"
+        Configuration.logger.debug "API called: ServicesAndBindingsApi#services_post. Result: #{result.inspect}"
       end
-      return nil
+      return result
     end
 
     # Deletes the specified service.

data/lib/apcera/api/utilities_api.rb

@@ -8,114 +8,6 @@ module Apcera
       @api_client = api_client || Configuration.api_client
     end
 
-    # Downloads the APC utility.
-    # Downloads the APC command-line utility for the specified platform.
-    # @param platform Target platform. Can be one of the following values: \n * `linux` \n * `osx` \n * `linux_amd64` \n * `osx_amd64` \n * `darwin_amd64` \n * `darwin`
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :authorization 
-    # @return [nil]
-    def apc_download_platform_get(platform, opts = {})
-    
-      if Configuration.debugging
-        Configuration.logger.debug "Calling API: UtilitiesApi#apc_download_platform_get ..."
-      end
-      
-      
-      # verify the required parameter 'platform' is set
-      fail "Missing the required parameter 'platform' when calling apc_download_platform_get" if platform.nil?
-      unless ['linux_amd64', 'linux', 'osx_amd64', 'darwin_amd64', 'darwin', 'osx'].include?(platform)
-        fail "invalid value for 'platform', must be one of linux_amd64, linux, osx_amd64, darwin_amd64, darwin, osx"
-      end
-      
-      # resource path
-      path = "/apc/download/{platform}".sub('{format}','json').sub('{' + 'platform' + '}', platform.to_s)
-
-      # query parameters
-      query_params = {}
-
-      # header parameters
-      header_params = {}
-
-      # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
-      # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
-      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = nil
-      
-
-      auth_names = ['authorization']
-      @api_client.call_api(:GET, path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names)
-      if Configuration.debugging
-        Configuration.logger.debug "API called: UtilitiesApi#apc_download_platform_get"
-      end
-      return nil
-    end
-
-    # Returns the version of APC available for download.
-    # Returns the version of APC available for download from the cluster.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :authorization 
-    # @return [APCVersionObject]
-    def apc_version_get(opts = {})
-    
-      if Configuration.debugging
-        Configuration.logger.debug "Calling API: UtilitiesApi#apc_version_get ..."
-      end
-      
-      
-      # resource path
-      path = "/apc/version".sub('{format}','json')
-
-      # query parameters
-      query_params = {}
-
-      # header parameters
-      header_params = {}
-
-      # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
-      # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
-      header_params[:'authorization'] = opts[:'authorization'] if opts[:'authorization']
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = nil
-      
-
-      auth_names = ['authorization']
-      result = @api_client.call_api(:GET, path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => 'APCVersionObject')
-      if Configuration.debugging
-        Configuration.logger.debug "API called: UtilitiesApi#apc_version_get. Result: #{result.inspect}"
-      end
-      return result
-    end
-
     # Returns information about the API server.
     # Returns information about the API server.
     # @param [Hash] opts the optional parameters
@@ -218,8 +110,8 @@ module Apcera
       return result
     end
 
-    # Lists available workload runtimes.
-    # Lists file names and patterns used to determine the appropriate runtime for a given workload.
+    # Lists supported workload runtimes.
+    # Lists file names and patterns used by APC to determine the appropriate staging pipeline to stage a given workload.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :authorization 
     # @return [Array<Runtime>]
@@ -269,11 +161,11 @@ module Apcera
       return result
     end
 
-    # Returns the version number of the API Server.
-    # Returns the version number of the API Server.
+    # Returns Apcera cluster version information and APC download links.
+    # Returns Apcera cluster version information, and links to download compatible versions of APC for supported platforms.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :authorization 
-    # @return [Object]
+    # @return [VersionInfo]
     def version_get(opts = {})
     
       if Configuration.debugging
@@ -313,7 +205,7 @@ module Apcera
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'Object')
+        :return_type => 'VersionInfo')
       if Configuration.debugging
         Configuration.logger.debug "API called: UtilitiesApi#version_get. Result: #{result.inspect}"
       end