morpheus-cli 5.3.3 → 5.4.2

data/lib/morpheus/cli/{health_command.rb → commands/health_command.rb}

@@ -1,16 +1,10 @@
-require 'io/console'
-require 'rest_client'
-require 'optparse'
 require 'morpheus/cli/cli_command'
-require 'morpheus/cli/mixins/logs_helper'
-require 'morpheus/cli/option_types'
-require 'json'
 
 class Morpheus::Cli::HealthCommand
   include Morpheus::Cli::CliCommand
   include Morpheus::Cli::LogsHelper
   set_command_name :health
-  register_subcommands :get, :alarms, :'get-alarm', :'acknowledge-alarms', :'unacknowledge-alarms', :logs
+  register_subcommands :get, :alarms, :'get-alarm', :'acknowledge-alarms', :'unacknowledge-alarms', :logs, :'export-logs'
 
   def connect(opts)
     @api_client = establish_remote_appliance_connection(opts)
@@ -510,17 +504,16 @@ class Morpheus::Cli::HealthCommand
   def logs(args)
     options = {}
     params = {}
-    start_date, end_date = nil, nil
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage()
       opts.on('--level VALUE', String, "Log Level. DEBUG,INFO,WARN,ERROR") do |val|
         params['level'] = params['level'] ? [params['level'], val].flatten : [val]
       end
-      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start timestamp. Default is 30 days ago.") do |val|
-        start_date = parse_time(val) #.utc.iso8601
+      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start date timestamp in standard iso8601 format. Default is 24 hours ago.") do |val|
+        params['startDate'] = val # parse_time(val).utc.iso8601
       end
-      opts.on('--end TIMESTAMP','--end TIMESTAMP', "End timestamp. Default is now.") do |val|
-        end_date = parse_time(val) #.utc.iso8601
+      opts.on('--end TIMESTAMP','--end TIMESTAMP', "End date timestamp in standard iso8601 format. Default is now.") do |val|
+        params['endDate'] = val # parse_time(val).utc.iso8601
       end
       opts.on('-t', '--table', "Format output as a table.") do
         options[:table] = true
@@ -539,8 +532,8 @@ class Morpheus::Cli::HealthCommand
     begin
       # params['startDate'] = start_date.utc.iso8601 if start_date
       # params['endDate'] = end_date.utc.iso8601 if end_date
-      params['startMs'] = (start_date.to_i * 1000) if start_date
-      params['endMs'] = (end_date.to_i * 1000) if end_date
+      # params['startMs'] = (start_date.to_i * 1000) if start_date
+      # params['endMs'] = (end_date.to_i * 1000) if end_date
       params['level'] = params['level'].collect {|it| it.to_s.upcase }.join('|') if params['level'] # api works with INFO|WARN
       params.merge!(parse_list_options(options))
       @health_interface.setopts(options)
@@ -557,11 +550,11 @@ class Morpheus::Cli::HealthCommand
       if params['level']
         subtitles << "Level: #{[params['level']].flatten.join(',')}"
       end
-      if start_date
-        subtitles << "Start: #{start_date}"
+      if params['startDate']
+        subtitles << "Start: #{params['startDate']}"
       end
-      if end_date
-        subtitles << "End: #{end_date}"
+      if params['endDate']
+        subtitles << "End: #{params['endDate']}"
       end
       subtitles += parse_list_subtitles(options)
       print_h1 title, subtitles
@@ -580,6 +573,98 @@ class Morpheus::Cli::HealthCommand
     end
   end
 
+  def export_logs(args)
+    params = {}
+    options = {}
+    outfile = nil
+    do_overwrite = false
+    do_mkdir = false
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[file]")
+      opts.on('--level VALUE', String, "Log Level. DEBUG,INFO,WARN,ERROR") do |val|
+        params['level'] = params['level'] ? [params['level'], val].flatten : [val]
+      end
+      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start date timestamp in standard iso8601 format. Default is 24 hours ago.") do |val|
+        params['startDate'] = val # parse_time(val).utc.iso8601
+      end
+      opts.on('--end TIMESTAMP','--end TIMESTAMP', "End date timestamp in standard iso8601 format. Default is now.") do |val|
+        params['endDate'] = val # parse_time(val).utc.iso8601
+      end
+      opts.on( '-f', '--force', "Overwrite existing [file] if it exists." ) do
+        do_overwrite = true
+        # do_mkdir = true
+      end
+      opts.on( '-p', '--mkdir', "Create missing directories for [file] if they do not exist." ) do
+        do_mkdir = true
+      end
+      build_common_options(opts, options, [:list, :query, :dry_run, :remote])
+      opts.footer = "Export morpheus appliance log." + "\n" +
+                    "[file] is required. This is local destination for the downloaded file. Example: morpheus.log"
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count: 1)
+    connect(options)
+    params['level'] = params['level'].collect {|it| it.to_s.upcase }.join('|') if params['level'] # api works with INFO|WARN
+    params.merge!(parse_list_options(options))
+
+    outfile = args[0]
+    outfile = File.expand_path(outfile)
+    
+    if Dir.exists?(outfile)
+      raise_command_error("[file] is invalid. It is the name of an existing directory: #{outfile}", args, optparse)
+    end
+    destination_dir = File.dirname(outfile)
+    if !Dir.exists?(destination_dir)
+      if do_mkdir
+        print cyan,"Creating local directory #{destination_dir}",reset,"\n"
+        FileUtils.mkdir_p(destination_dir)
+      else
+        raise_command_error("[file] is invalid. Directory not found: #{destination_dir}", args, optparse)
+      end
+    end
+    if File.exists?(outfile)
+      if do_overwrite
+        # uhh need to be careful wih the passed filepath here..
+        # don't delete, just overwrite.
+        # File.delete(outfile)
+      else
+        raise_command_error("[file] is invalid. File already exists: #{outfile}\nUse -f to overwrite the existing file.", args, optparse)
+      end
+    end
+
+    @health_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @health_interface.dry.export_logs(outfile, params)
+      return 0
+    end
+    if !options[:quiet]
+      print cyan + "Downloading file #{outfile} ... "
+    end
+    http_response, bad_body = @health_interface.export_logs(outfile, params)
+    # FileUtils.chmod(0600, outfile)
+    success = http_response.code.to_i == 200
+    if success
+      if !options[:quiet]
+        print green + "SUCCESS" + reset + " (" + format_bytes(http_response["Content-Length"].to_i).to_s + ")" + "\n"
+      end
+      # todo: parse default outfile from http_response["Content-Type"]
+      return 0
+    else
+      if !options[:quiet]
+        print red + "ERROR" + reset + " HTTP #{http_response.code}" + "\n"
+      end
+      # F it, just remove a bad result
+      if File.exists?(outfile) && File.file?(outfile)
+        Morpheus::Logging::DarkPrinter.puts "Deleting bad file download: #{outfile}" if Morpheus::Logging.debug?
+        File.delete(outfile)
+      end
+      if options[:debug]
+        puts_error http_response.inspect
+      end
+      return 1, "download failed"
+    end
+  end
+
   def alarms(args)
     options = {}
     params = {}
@@ -595,7 +680,7 @@ class Morpheus::Cli::HealthCommand
       opts.on('--acknowledged', '--acknowledged', "Filter by acknowledged. By default only open alarms are returned.") do
         params['alarmStatus'] = 'acknowledged'
       end
-      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start timestamp. Default is 30 days ago.") do |val|
+      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start timestamp. Default is 24 hours ago.") do |val|
         start_date = parse_time(val) #.utc.iso8601
       end
       opts.on('--end TIMESTAMP','--end TIMESTAMP', "End timestamp. Default is now.") do |val|

data/lib/morpheus/cli/commands/{standard/history_command.rb → history_command.rb}

@@ -1,6 +1,3 @@
-require 'optparse'
-require 'json'
-require 'morpheus/logging'
 require 'morpheus/cli/cli_command'
 
 class Morpheus::Cli::HistoryCommand

data/lib/morpheus/cli/{hosts.rb → commands/hosts.rb}

@@ -1,13 +1,4 @@
-# require 'yaml'
-require 'io/console'
-require 'rest_client'
-require 'optparse'
 require 'morpheus/cli/cli_command'
-require 'morpheus/cli/mixins/accounts_helper'
-require 'morpheus/cli/mixins/provisioning_helper'
-require 'morpheus/cli/mixins/logs_helper'
-require 'morpheus/cli/option_types'
-require 'json'
 
 class Morpheus::Cli::Hosts
   include Morpheus::Cli::CliCommand
@@ -31,7 +22,7 @@ class Morpheus::Cli::Hosts
   def connect(opts)
     @api_client = establish_remote_appliance_connection(opts)
     @accounts_interface = @api_client.accounts
-    @users_interface = @api_client.users
+    @account_users_interface = @api_client.account_users
     @clouds_interface = @api_client.clouds
     @options_interface = @api_client.options
     @tasks_interface = @api_client.tasks
@@ -90,25 +81,25 @@ class Morpheus::Cli::Hosts
       opts.on( '--plan-code CODE', String, "Filter by Plan code(s)" ) do |val|
         params['planCode'] = parse_id_list(val)
       end
-      opts.on( '', '--vm', "Show only virtual machines" ) do |val|
+      opts.on('--vm', "Show only virtual machines" ) do
         params[:vm] = true
       end
-      opts.on( '', '--hypervisor', "Show only VM Hypervisors" ) do |val|
+      opts.on('--hypervisor', "Show only VM Hypervisors" ) do
         params[:vmHypervisor] = true
       end
-      opts.on( '', '--container', "Show only Container Hypervisors" ) do |val|
+      opts.on('--container', "Show only Container Hypervisors" ) do
         params[:containerHypervisor] = true
       end
-      opts.on( '', '--baremetal', "Show only Baremetal Servers" ) do |val|
+      opts.on('--baremetal', "Show only Baremetal Servers" ) do
         params[:bareMetalHost] = true
       end
-      opts.on( '', '--status STATUS', "Filter by Status" ) do |val|
+      opts.on('--status STATUS', String, "Filter by Status" ) do |val|
         params[:status] = val
       end
-      opts.on( '', '--agent', "Show only Servers with the agent installed" ) do |val|
+      opts.on('--agent', "Show only Servers with the agent installed" ) do
         params[:agentInstalled] = true
       end
-      opts.on( '', '--noagent', "Show only Servers with No agent" ) do |val|
+      opts.on('--noagent', "Show only Servers with No agent" ) do
         params[:agentInstalled] = false
       end
       opts.on( '--created-by USER', "Created By User Username or ID" ) do |val|
@@ -383,25 +374,25 @@ class Morpheus::Cli::Hosts
       opts.on( '-i', '--ip IPADDRESS', "Filter by IP Address" ) do |val|
         params[:ip] = val
       end
-      opts.on( '', '--vm', "Show only virtual machines" ) do |val|
+      opts.on('--vm', "Show only virtual machines" ) do
         params[:vm] = true
       end
-      opts.on( '', '--hypervisor', "Show only VM Hypervisors" ) do |val|
+      opts.on('--hypervisor', "Show only VM Hypervisors" ) do
         params[:vmHypervisor] = true
       end
-      opts.on( '', '--container', "Show only Container Hypervisors" ) do |val|
+      opts.on('--container', "Show only Container Hypervisors" ) do
         params[:containerHypervisor] = true
       end
-      opts.on( '', '--baremetal', "Show only Baremetal Servers" ) do |val|
+      opts.on('--baremetal', "Show only Baremetal Servers" ) do
         params[:bareMetalHost] = true
       end
-      opts.on( '', '--status STATUS', "Filter by Status" ) do |val|
+      opts.on('--status STATUS', "Filter by Status" ) do |val|
         params[:status] = val
       end
-      opts.on( '', '--agent', "Show only Servers with the agent installed" ) do |val|
+      opts.on('--agent', "Show only Servers with the agent installed" ) do
         params[:agentInstalled] = true
       end
-      opts.on( '', '--noagent', "Show only Servers with No agent" ) do |val|
+      opts.on('--noagent', "Show only Servers with No agent" ) do
         params[:agentInstalled] = false
       end
       opts.on( '--created-by USER', "Created By User Username or ID" ) do |val|
@@ -553,7 +544,6 @@ class Morpheus::Cli::Hosts
       server_columns.delete("Cost") if server['hourlyCost'].to_f == 0
       server_columns.delete("Price") if server['hourlyPrice'].to_f == 0 || server['hourlyPrice'] == server['hourlyCost']
       server_columns.delete("Labels") if server['labels'].nil? || server['labels'].empty?
-      server_columns.delete("Tags") if tags.nil? || tags.empty?
 
       print_description_list(server_columns, server)
 

data/lib/morpheus/cli/{image_builder_command.rb → commands/image_builder_command.rb}

@@ -1,12 +1,6 @@
-require 'json'
-require 'yaml'
-require 'rest_client'
-require 'optparse'
-require 'filesize'
 require 'morpheus/cli/cli_command'
-require 'morpheus/cli/mixins/provisioning_helper'
-require 'morpheus/cli/boot_scripts_command'
-require 'morpheus/cli/preseed_scripts_command'
+# require 'morpheus/cli/commands/boot_scripts_command'
+# require 'morpheus/cli/commands/preseed_scripts_command'
 
 class Morpheus::Cli::ImageBuilderCommand
   include Morpheus::Cli::CliCommand
@@ -1071,20 +1065,16 @@ class Morpheus::Cli::ImageBuilderCommand
     preseed_script_id = nil
     if options['preseedScript']
       preseed_script = find_preseed_script(options['preseedScript'])
-      if !preseed_script
-        print_red_alert "Preseed Script not found: #{options['preseedScript']}"
-        return false
+      if preseed_script
+        preseed_script_id = preseed_script['id']
       end
-      preseed_script_id = preseed_script['id']
     else
       preseed_script_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'preseedScript', 'type' => 'select', 'fieldLabel' => 'Preseed Script', 'selectOptions' => get_available_preseed_scripts(), 'required' => false, 'description' => 'Select Preseed Script.', 'defaultValue' => default_values['preseedScript'], :fmt=>:natural}],options,api_client,{})
       # preseed_script_id = preseed_script_prompt['preseedScript']
       preseed_script = find_preseed_script(preseed_script_prompt['preseedScript'])
-      if !preseed_script
-        print_red_alert "Preseed Script not found: '#{preseed_script_prompt['preseedScript']}'"
-        return false
+      if preseed_script
+        preseed_script_id = preseed_script['id']
       end
-      preseed_script_id = preseed_script['id']
     end
     if preseed_script_id
       # payload['preseedScript'] = preseed_script_id

data/lib/morpheus/cli/{instance_types.rb → commands/instance_types.rb}

@@ -1,7 +1,4 @@
-require 'io/console'
-require 'optparse'
 require 'morpheus/cli/cli_command'
-require 'morpheus/cli/mixins/provisioning_helper'
 
 class Morpheus::Cli::InstanceTypes
   include Morpheus::Cli::CliCommand

data/lib/morpheus/cli/{instances.rb → commands/instances.rb}

@@ -1,7 +1,3 @@
-require 'io/console'
-require 'rest_client'
-require 'optparse'
-require 'filesize'
 require 'morpheus/cli/cli_command'
 
 class Morpheus::Cli::Instances
@@ -26,7 +22,8 @@ class Morpheus::Cli::Instances
                        :scaling, {:'scaling-update' => :scaling_update},
                        :wiki, :update_wiki,
                        {:exec => :execution_request},
-                       :deploys
+                       :deploys,
+                       :refresh, :apply
   #register_subcommands :firewall_disable, :firewall_enable
   # register_subcommands {:'lb-update' => :load_balancer_update}
   alias_subcommand :details, :get
@@ -39,7 +36,7 @@ class Morpheus::Cli::Instances
   def connect(opts)
     @api_client = establish_remote_appliance_connection(opts)
     @accounts_interface = @api_client.accounts
-    @users_interface = @api_client.users
+    @account_users_interface = @api_client.account_users
     @instances_interface = @api_client.instances
     @task_sets_interface = @api_client.task_sets
     @logs_interface = @api_client.logs
@@ -81,6 +78,12 @@ class Morpheus::Cli::Instances
       opts.on( '--created-by USER', "Alias for --owner" ) do |val|
         options[:owner] = val
       end
+      opts.on('--agent', "Show only Instances with the agent installed" ) do
+        params[:agentInstalled] = true
+      end
+      opts.on('--noagent', "Show only Instances with No agent" ) do
+        params[:agentInstalled] = false
+      end
       opts.add_hidden_option('--created-by')
       opts.on('--status STATUS', "Filter by status i.e. provisioning,running,starting,stopping") do |val|
         params['status'] = (params['status'] || []) + val.to_s.split(',').collect {|s| s.strip }.select {|s| s != "" }
@@ -1365,7 +1368,6 @@ class Morpheus::Cli::Instances
         "Status" => lambda {|it| format_instance_status(it) }
       }
       description_cols.delete("Labels") if labels.nil? || labels.empty?
-      description_cols.delete("Tags") if tags.nil? || tags.empty?
       description_cols.delete("Apps") if instance['apps'].nil? || instance['apps'].empty?
       description_cols.delete("Power Schedule") if instance['powerSchedule'].nil?
       description_cols.delete("Expire Date") if instance['expireDate'].nil?
@@ -1694,19 +1696,77 @@ class Morpheus::Cli::Instances
     options = {:options => {}}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[instance] -g GROUP")
-      opts.on('--name VALUE', String, "Name") do |val|
-        options[:options]['name'] = val
-      end
       opts.on( '-g', '--group GROUP', "Group Name or ID for the new instance" ) do |val|
         options[:group] = val
       end
       opts.on( '-c', '--cloud CLOUD', "Cloud Name or ID for the new instance" ) do |val|
         options[:cloud] = val
       end
+      opts.on('--name VALUE', String, "Name") do |val|
+        options[:options]['name'] = val
+      end
+      opts.on("--description [TEXT]", String, "Description") do |val|
+        options[:description] = val.to_s
+      end
+      opts.on("--environment ENV", String, "Environment code") do |val|
+        options[:environment] = val.to_s
+      end
+      opts.on('--tags LIST', String, "Metadata tags in the format 'ping=pong,flash=bang'") do |val|
+        options[:metadata] = val
+      end
+      opts.on('--metadata LIST', String, "Metadata tags in the format 'ping=pong,flash=bang'") do |val|
+        options[:metadata] = val
+      end
+      opts.add_hidden_option('--metadata')
+      opts.on('--labels LIST', String, "Labels (keywords) in the format 'foo, bar'") do |val|
+        options[:labels] = val.split(',').collect {|it| it.to_s.strip }.compact.uniq.join(',')
+      end
+      # opts.on("--copies NUMBER", Integer, "Number of copies to provision") do |val|
+      #   options[:copies] = val.to_i
+      # end
+      # opts.on("--layout-size NUMBER", Integer, "Apply a multiply factor of containers/vms within the instance") do |val|
+      #   options[:layout_size] = val.to_i
+      # end
+      # opts.on( '-l', '--layout LAYOUT', "Layout ID" ) do |val|
+      #   options[:layout] = val
+      # end
+      opts.on( '-p', '--plan PLAN', "Service plan ID") do |val|
+        options[:service_plan] = val
+      end
+      opts.on( '--resource-pool ID', String, "Resource pool ID" ) do |val|
+        options[:resource_pool] = val
+      end
+      opts.on("--workflow ID", String, "Automation: Workflow ID") do |val|
+        options[:workflow_id] = val
+      end
+      opts.on("--ports ARRAY", String, "Exposed Ports, JSON formatted list of objects containing name and port") do |val|
+        # expects format like --ports '[{"name":"web","port":8080}]'
+        ports_array = JSON.parse(val)
+        options[:ports] = ports_array
+        options[:options]['ports'] = ports_array
+      end
+      # opts.on('-L', "--lb", "Enable Load Balancer") do
+      #   options[:enable_load_balancer] = true
+      # end
       opts.on("--create-user on|off", String, "User Config: Create Your User. Default is on") do |val|
         options[:create_user] = !['false','off','0'].include?(val.to_s)
       end
-      build_common_options(opts, options, [:options, :payload, :auto_confirm, :json, :dry_run, :remote])
+      opts.on("--user-group USERGROUP", String, "User Config: User Group") do |val|
+        options[:user_group_id] = val
+      end
+      opts.on("--shutdown-days DAYS", Integer, "Automation: Shutdown Days") do |val|
+        options[:shutdown_days] = val.to_i
+      end
+      opts.on("--expire-days DAYS", Integer, "Automation: Expiration Days") do |val|
+        options[:expire_days] = val.to_i
+      end
+      opts.on("--create-backup [on|off]", String, "Automation: Create Backups.") do |val|
+        options[:create_backup] = ['on','true','1',''].include?(val.to_s.downcase) ? 'on' : 'off'
+      end
+      opts.on("--security-groups LIST", String, "Security Groups, comma separated list of security group IDs") do |val|
+        options[:security_groups] = val.split(",").collect {|s| s.strip }.select {|s| !s.to_s.empty? }
+      end
+      build_standard_post_options(opts, options, [:auto_confirm])
     end
     optparse.parse!(args)
     if args.count < 1 || args.count > 2
@@ -1724,12 +1784,20 @@ class Morpheus::Cli::Instances
 
       # defaults derived from clone
       options[:default_name] = instance['name'] + '-clone' if instance['name']
+      options[:default_description] = instance['description'] if !instance['description'].to_s.empty?
+      options[:default_environment] = instance['environment'] if instance['environment']
       options[:default_group] = instance['group']['id'] if instance['group']
       options[:default_cloud] = instance['cloud']['name'] if instance['cloud']
       options[:default_plan] = instance['plan']['name'] if instance['plan']
       options[:default_resource_pool] = instance['config']['resourcePoolId'] if instance['config']
       options[:default_config] = instance['config']
       options[:default_security_group] = instance['config']['securityGroups'][0]['id'] if instance['config'] && (instance['config']['securityGroups'] || []).count > 0
+      if instance['labels'] && !instance['labels'].empty?
+        options[:default_labels] = (instance['labels'] || []).join(',')
+      end
+      if instance['tags'] && !instance['tags'].empty?
+        options[:current_tags] = instance['tags']
+      end
 
       # immutable derived from clone
       options[:instance_type_code] = instance['instanceType']['code'] if instance['instanceType']
@@ -1767,13 +1835,52 @@ class Morpheus::Cli::Instances
         payload.deep_merge!(passed_options)
       end
       
+      #payload['instance'] ||= {}
+      # if options[:instance_name]
+      #   payload['instance']['name'] = options[:instance_name]
+      # end
+      # if options[:description] && !payload['instance']['description']
+      #   payload['instance']['description'] = options[:description]
+      # end
+      # if options[:environment] && !payload['instance']['instanceContext']
+      #   payload['instance']['instanceContext'] = options[:environment]
+      # end
+    
+      #payload[:copies] = options[:copies] if options[:copies] && options[:copies] > 0
+      if options[:layout_size] && options[:layout_size] > 0 # aka Scale Factor
+        payload[:layoutSize] = options[:layout_size]
+      end
+      if !options[:create_backup].nil?
+        payload[:createBackup] = options[:create_backup]
+      end
+      if options[:expire_days]
+        payload['instance'] ||= {}
+        payload['instance']['expireDays'] = options[:expire_days]
+      end
+      if options[:shutdown_days]
+        payload['instance'] ||= {}
+        payload['shutdownDays'] = options[:shutdown_days]
+      end
       # JD: this actually fixed a customer problem
       # It appears to be important to pass this... not sure if config.createUser is necessary...
       if options[:create_user].nil?
         options[:create_user] = true
       end
-      if options[:create_user] != nil
-        payload.deep_merge!({'createUser' => options[:create_user], 'config' =>{'createUser' => options[:create_user]}})
+      if options.key?(:create_user)
+        payload['config'] ||= {}
+        payload['config']['createUser'] = options[:create_user]
+        payload['createUser'] = options[:create_user]
+      end
+      if options[:user_group_id]
+        payload['instance'] ||= {}
+        payload['instance']['userGroup'] = {'id' => options[:user_group_id] }
+      end
+      if options[:workflow_id]
+        if options[:workflow_id].to_s =~ /\A\d{1,}\Z/
+          payload['taskSetId'] = options[:workflow_id].to_i
+        else
+          payload['taskSetName'] = options[:workflow_id]
+        end
       end
       unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to clone the instance #{instance['name']} as '#{payload['name']}'?", options)
         return 9, "aborted command"
@@ -4130,6 +4237,106 @@ EOT
     return 0, nil
   end
 
+  def refresh(args)
+    params, payload, options = {}, {}, {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[instance] [options]")
+      build_standard_update_options(opts, options, [:auto_confirm])
+      opts.footer = <<-EOT
+Refresh an instance.
+[instance] is required. This is the name or id of an instance.
+This is only supported by certain types of instances such as terraform.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+
+    begin
+      instance = find_instance_by_name_or_id(args[0])
+      return 1 if instance.nil?
+      # construct request
+      params.merge!(parse_query_options(options))
+      payload = {}
+      if options[:payload]
+        payload = options[:payload]
+        payload.deep_merge!(parse_passed_options(options))
+      else
+        payload.deep_merge!(parse_passed_options(options))
+        # raise_command_error "Specify at least one option to update.\n#{optparse}" if payload.empty?
+      end
+      unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to refresh this instance: #{instance['name']}?")
+        return 9, "aborted command"
+      end
+      @instances_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @instances_interface.dry.refresh(instance["id"], params, payload)
+        return
+      end
+      json_response = @instances_interface.refresh(instance["id"], params, payload)
+      render_response(json_response, options) do
+        print_green_success "Refreshing instance #{instance['name']}"
+        # return _get(instance['id'], options)
+      end
+      return 0, nil
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def apply(args)
+    params, payload, options = {}, {}, {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[instance] [options]")
+      build_standard_update_options(opts, options, [:auto_confirm])
+      opts.footer = <<-EOT
+Apply an instance.
+[instance] is required. This is the name or id of an instance.
+This is only supported by certain types of instances such as terraform.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+
+    begin
+      instance = find_instance_by_name_or_id(args[0])
+      return 1 if instance.nil?
+      # construct request
+      params.merge!(parse_query_options(options))
+      payload = {}
+      if options[:payload]
+        payload = options[:payload]
+        payload.deep_merge!(parse_passed_options(options))
+      else
+        payload.deep_merge!(parse_passed_options(options))
+        # raise_command_error "Specify at least one option to update.\n#{optparse}" if payload.empty?
+      end
+      unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to apply this instance: #{instance['name']}?")
+        return 9, "aborted command"
+      end
+      @instances_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @instances_interface.dry.apply(instance["id"], params, payload)
+        return
+      end
+      json_response = @instances_interface.apply(instance["id"], params, payload)
+      render_response(json_response, options) do
+        print_green_success "Applying instance #{instance['name']}"
+        # return _get(instance['id'], options)
+      end
+      return 0, nil
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  # todo: print state summary
+  def state_summary(args)
+  end
+
 private
 
   def find_zone_by_name_or_id(group_id, val)