morpheus-cli 4.2.20 → 5.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53993967f9a5131702de6bd1d35c1f4f476b87cc56bff1a130737aacca8001a9
-  data.tar.gz: 7a86d5a5a788d57aa6f09d5f567f056d96f530e7d2eb2201b943c9115fa4701b
+  metadata.gz: 25ca8fc7cabb51b4042eb212172b60191d6863cf9310ffce4e386d016692f7f1
+  data.tar.gz: d1183424bef986bb22123d60b45e97ed077c8ea30c5bfd249f8bf503c0a22d13
 SHA512:
-  metadata.gz: 2c2ec20a5cd5f47cb1ca3c05867e7063cf5d78fba739467bbc3a8e6e82da0b4a59993a76668ab2e29b518d3aee85a4af3c6859adb150d8eaa643abbb54472214
-  data.tar.gz: 651c4897a8a28d8d476f0c80e73137c9530dc1cfabcc2b59898ee32cbccc27c321676d285825e61c1085630c0cb2abf8be72cb1ddfc86b33764472b3486f759c
+  metadata.gz: d006acc9447822675c3593de443679ac2eee514bf1ffe041ddfa5ddc44223e8edfbbeee9393056c59fb98c14d4beb240b0ce9725a3bcc56eb5e1095066d15d1c
+  data.tar.gz: ca41986fc3561f562b799971514b92dfe08027e06ad5443b0e116713fee9132d62b84905c929209be03a7dc0f3855e97adf7fe053e64832067addca692ef4268

data/Dockerfile

@@ -1,5 +1,5 @@
 FROM ruby:2.5.1
 
-RUN gem install morpheus-cli -v 4.2.20
+RUN gem install morpheus-cli -v 5.0.2
 
 ENTRYPOINT ["morpheus"]

data/lib/morpheus/api/api_client.rb

@@ -342,10 +342,18 @@ class Morpheus::APIClient
     Morpheus::AuthInterface.new({url: @base_url, client_id: @client_id}).setopts(@options)
   end
 
+  def forgot
+    Morpheus::ForgotPasswordInterface.new(common_interface_options).setopts(@options)
+  end
+
   def whoami
     Morpheus::WhoamiInterface.new(common_interface_options).setopts(@options)
   end
 
+  def search
+    Morpheus::SearchInterface.new(common_interface_options).setopts(@options)
+  end
+
   def user_settings
     Morpheus::UserSettingsInterface.new(common_interface_options).setopts(@options)
   end
@@ -764,6 +772,24 @@ class Morpheus::APIClient
     Morpheus::BackupJobsInterface.new(common_interface_options).setopts(@options)
   end
 
+  def catalog_item_types
+    Morpheus::CatalogItemTypesInterface.new(common_interface_options).setopts(@options)
+  end
+
+  def usage
+    Morpheus::UsageInterface.new(common_interface_options).setopts(@options)
+  end
+
+  def billing
+    Morpheus::BillingInterface.new(common_interface_options).setopts(@options)
+  end
+  
   # add new interfaces here
 
+  protected
+
+  def validate_id!(id)
+    raise "#{self.class} passed a blank id!" if id.to_s.strip.empty?
+  end
+
 end

data/lib/morpheus/api/billing_interface.rb

@@ -0,0 +1,34 @@
+require 'morpheus/api/api_client'
+
+class Morpheus::BillingInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/billing"
+  end
+
+  # this is an alias for /usage
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+  def list_account(params={})
+    execute(method: :get, url: "#{base_path}/account", params: params)
+  end
+
+  def list_zones(params={})
+    execute(method: :get, url: "#{base_path}/zones", params: params)
+  end
+
+  def list_instances(params={})
+    execute(method: :get, url: "#{base_path}/instances", params: params)
+  end
+
+  def list_servers(params={})
+    execute(method: :get, url: "#{base_path}/servers", params: params)
+  end
+
+  def list_discovered_servers(params={})
+    execute(method: :get, url: "#{base_path}/discoveredServers", params: params)
+  end
+
+end

data/lib/morpheus/api/catalog_item_types_interface.rb

@@ -0,0 +1,9 @@
+require 'morpheus/api/rest_interface'
+
+class Morpheus::CatalogItemTypesInterface < Morpheus::RestInterface
+
+  def base_path
+    "/api/catalog-item-types"
+  end
+
+end

data/lib/morpheus/api/deploy_interface.rb

@@ -18,7 +18,7 @@ class Morpheus::DeployInterface < Morpheus::APIClient
     execute(method: :get, url: "#{base_path}", params: params)
   end
 
-  def get(instance_id, id, params={})
+  def get(id, params={})
     validate_id!(id)
     execute(method: :get, url: "#{base_path}/#{id}", params: params)
   end

data/lib/morpheus/api/deployments_interface.rb

@@ -40,7 +40,8 @@ class Morpheus::DeploymentsInterface < Morpheus::RestInterface
     if destination.empty? || destination == "/" || destination == "." || destination.include?("../")
       raise "#{self.class}.upload_file() passed a bad destination: '#{destination}'"
     end
-    url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    # url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    url = "#{base_path}/#{deployment_id}/versions/#{id}/files"
     if !destination.to_s.empty?
       url += "/#{destination}"
     end
@@ -57,4 +58,22 @@ class Morpheus::DeploymentsInterface < Morpheus::RestInterface
     execute(method: :post, url: url, headers: headers, payload: payload, params: params, timeout: 172800)
   end
 
+  # upload a file without multipart
+  # local_file is the full absolute local filename
+  # destination should be the full remote file path, including the file name.
+  def destroy_file(deployment_id, id, destination, params={})
+    if destination.empty? || destination == "/" || destination == "." || destination.include?("../")
+      raise "#{self.class}.upload_file() passed a bad destination: '#{destination}'"
+    end
+    # url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    url = "#{base_path}/#{deployment_id}/versions/#{id}/files"
+    if !destination.to_s.empty?
+      url += "/#{destination}"
+    end
+    # use URI to escape path
+    uri = URI.parse(url)
+    url = uri.path
+    execute(method: :delete, url: url, params: params)
+  end
+
 end

data/lib/morpheus/api/forgot_password_interface.rb

@@ -0,0 +1,17 @@
+require 'morpheus/api/api_client'
+# There is no Authorization required for this API.
+class Morpheus::ForgotPasswordInterface < Morpheus::APIClient
+
+  def authorization_required?
+    false
+  end
+
+  def send_email(payload, params={})
+    execute(method: :post, url: "/api/forgot/send-email", params: params, payload: payload.to_json)
+  end
+
+  def reset_password(payload, params={})
+    execute(method: :post, url: "/api/forgot/reset-password", params: params, payload: payload.to_json)
+  end
+
+end

data/lib/morpheus/api/instances_interface.rb

@@ -218,6 +218,13 @@ class Morpheus::InstancesInterface < Morpheus::APIClient
     execute(opts)
   end
   
+  def snapshots(instance_id, params={})
+    url = "#{@base_url}/api/instances/#{instance_id}/snapshots"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
   def import_snapshot(id, params={}, payload={})
     url = "#{@base_url}/api/instances/#{id}/import-snapshot"
     headers = {:authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }

data/lib/morpheus/api/rest_interface.rb

@@ -31,10 +31,4 @@ class Morpheus::RestInterface < Morpheus::APIClient
     execute(method: :delete, url: "#{base_path}/#{id}", params: params)
   end
 
-  protected
-
-  def validate_id!(id)
-    raise "#{self.class} passed a blank id!" if id.to_s.strip.empty?
-  end
-
 end

data/lib/morpheus/api/roles_interface.rb

@@ -77,6 +77,20 @@ class Morpheus::RolesInterface < Morpheus::APIClient
     execute(method: :put, url: url, headers: headers, payload: payload.to_json)
   end
 
+  def update_catalog_item_type(account_id, id, options)
+    url = build_url(account_id, id) + "/update-catalog-item-type"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def update_persona(account_id, id, options)
+    url = build_url(account_id, id) + "/update-persona"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
   private
 
   def build_url(account_id=nil, role_id=nil)

data/lib/morpheus/api/search_interface.rb

@@ -0,0 +1,13 @@
+require 'morpheus/api/rest_interface'
+
+class Morpheus::SearchInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/search"
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+end

data/lib/morpheus/api/servers_interface.rb

@@ -169,4 +169,11 @@ class Morpheus::ServersInterface < Morpheus::APIClient
     execute(opts)
   end
   
+  def snapshots(id, params={})
+    url = "#{@base_url}/api/servers/#{id}/snapshots"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
 end

data/lib/morpheus/api/usage_interface.rb

@@ -0,0 +1,18 @@
+require 'morpheus/api/api_client'
+
+class Morpheus::UsageInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/usage" # not /usages ?
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+  def get(id, params={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}", params: params)
+  end
+
+end

data/lib/morpheus/cli.rb

@@ -67,8 +67,6 @@ module Morpheus
       # all standard commands
       Dir[File.dirname(__FILE__)  + "/cli/commands/standard/**/*.rb"].each {|file| load file }
 
-      # shell scripting commands
-
       # all the known commands
       load 'morpheus/cli/remote.rb'
       load 'morpheus/cli/doc.rb'
@@ -76,9 +74,11 @@ module Morpheus
       load 'morpheus/cli/setup.rb'
       load 'morpheus/cli/login.rb'
       load 'morpheus/cli/logout.rb'
+      load 'morpheus/cli/forgot_password.rb'
       load 'morpheus/cli/whoami.rb'
       load 'morpheus/cli/access_token_command.rb'
       load 'morpheus/cli/user_settings_command.rb'
+      load 'morpheus/cli/search_command.rb'
       load 'morpheus/cli/dashboard_command.rb'
       load 'morpheus/cli/recent_activity_command.rb' # deprecated, removing soon
       load 'morpheus/cli/activity_command.rb'
@@ -96,11 +96,12 @@ module Morpheus
       load 'morpheus/cli/tasks.rb'
       load 'morpheus/cli/workflows.rb'
       load 'morpheus/cli/deployments.rb'
+      load 'morpheus/cli/deploy.rb'
+      load 'morpheus/cli/deploys.rb'
       load 'morpheus/cli/instances.rb'
       load 'morpheus/cli/containers_command.rb'
       load 'morpheus/cli/apps.rb'
       load 'morpheus/cli/blueprints_command.rb'
-      load 'morpheus/cli/deploys.rb'
       load 'morpheus/cli/license.rb'
       load 'morpheus/cli/instance_types.rb'
       load 'morpheus/cli/jobs_command.rb'
@@ -174,6 +175,8 @@ module Morpheus
       load 'morpheus/cli/projects_command.rb'
       load 'morpheus/cli/backups_command.rb'
       load 'morpheus/cli/backup_jobs_command.rb'
+      load 'morpheus/cli/catalog_command.rb'
+      load 'morpheus/cli/usage_command.rb'
       # add new commands here...
 
     end

data/lib/morpheus/cli/apps.rb

@@ -92,10 +92,9 @@ class Morpheus::Cli::Apps
       opts.footer = "List apps."
     end
     optparse.parse!(args)
-    if args.count != 0
-      print_error Morpheus::Terminal.angry_prompt
-      puts_error  "#{command_name} list expects 0 arguments and received #{args.count}: #{args}\n#{optparse}"
-      return 1
+    # verify_args!(args:args, optparse:optparse, count:0)
+    if args.count > 0
+      options[:phrase] = args.join(" ")
     end
     connect(options)
     begin

data/lib/morpheus/cli/backup_jobs_command.rb

@@ -225,6 +225,9 @@ EOT
       print_dry_run @backup_jobs_interface.dry.destroy(backup_job['id'], params)
       return
     end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the backup #{backup['name']}?")
+      return 9, "aborted command"
+    end
     json_response = @backup_jobs_interface.destroy(backup_job['id'], params)
     render_response(json_response, options) do
       print_green_success "Removed backup job #{backup_job['name']}"

data/lib/morpheus/cli/backups_command.rb

@@ -215,6 +215,9 @@ EOT
       print_dry_run @backups_interface.dry.destroy(backup['id'], params)
       return
     end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the backup #{backup['name']}?")
+      return 9, "aborted command"
+    end
     json_response = @backups_interface.destroy(backup['id'], params)
     render_response(json_response, options) do
       print_green_success "Removed backup #{backup['name']}"

data/lib/morpheus/cli/budgets_command.rb

@@ -570,16 +570,16 @@ class Morpheus::Cli::BudgetsCommand
       {'fieldName' => 'description', 'fieldLabel' => 'Description', 'type' => 'text', 'displayOrder' => 1},
       # {'fieldName' => 'enabled', 'fieldLabel' => 'Enabled', 'type' => 'checkbox', 'defaultValue' => true},
       {'fieldName' => 'scope', 'fieldLabel' => 'Scope', 'code' => 'budget.scope', 'type' => 'select', 'selectOptions' => [{'name'=>'Account','value'=>'account'},{'name'=>'Tenant','value'=>'tenant'},{'name'=>'Cloud','value'=>'cloud'},{'name'=>'Group','value'=>'group'},{'name'=>'User','value'=>'user'}], 'defaultValue' => 'account', 'required' => true, 'displayOrder' => 3},
-      {'fieldName' => 'tenant', 'fieldLabel' => 'Tenant', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'tenant', 'fieldLabel' => 'Tenant', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("tenants", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:tenant', 'displayOrder' => 4},
-      {'fieldName' => 'user', 'fieldLabel' => 'User', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'user', 'fieldLabel' => 'User', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params|
         @options_interface.options_for_source("users", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:user', 'displayOrder' => 5},
-      {'fieldName' => 'group', 'fieldLabel' => 'Group', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'group', 'fieldLabel' => 'Group', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("groups", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:group', 'displayOrder' => 6},
-      {'fieldName' => 'cloud', 'fieldLabel' => 'Cloud', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'cloud', 'fieldLabel' => 'Cloud', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("clouds", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:cloud', 'displayOrder' => 7},
       {'fieldName' => 'year', 'fieldLabel' => 'Period', 'type' => 'text', 'required' => true, 'defaultValue' => Time.now.year, 'description' => "The period (year) the budget applies to. Default is the current year.", 'displayOrder' => 8},

data/lib/morpheus/cli/catalog_command.rb

@@ -0,0 +1,507 @@
+require 'morpheus/cli/cli_command'
+
+# CLI command self service
+# UI is Tools: Self Service - Catalog Items
+# API is /catalog-item-types and returns catalogItemTypes
+class Morpheus::Cli::CatalogCommand
+  include Morpheus::Cli::CliCommand
+  include Morpheus::Cli::CatalogHelper
+  include Morpheus::Cli::LibraryHelper
+  include Morpheus::Cli::OptionSourceHelper
+
+  # hide until 5.1 when update api is fixed and service-catalog endpoints are available
+  set_command_hidden  
+  set_command_name :'catalog'
+
+  register_subcommands :list, :get, :add, :update, :remove
+  
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @catalog_item_types_interface = @api_client.catalog_item_types
+    @option_types_interface = @api_client.option_types
+  end
+
+  def handle(args)
+    handle_subcommand(args)
+  end
+
+  def list(args)
+    options = {}
+    params = {}
+    ref_ids = []
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[search]")
+      opts.on( '--enabled [on|off]', String, "Filter by enabled" ) do |val|
+        params['enabled'] = (val.to_s != 'false' && val.to_s != 'off')
+      end
+      opts.on( '--featured [on|off]', String, "Filter by featured" ) do |val|
+        params['featured'] = (val.to_s != 'false' && val.to_s != 'off')
+      end
+      build_standard_list_options(opts, options)
+      opts.footer = "List catalog items."
+    end
+    optparse.parse!(args)
+    connect(options)
+    # verify_args!(args:args, optparse:optparse, count:0)
+    if args.count > 0
+      options[:phrase] = args.join(" ")
+    end
+    params.merge!(parse_list_options(options))
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.list(params)
+      return
+    end
+    json_response = @catalog_item_types_interface.list(params)
+    catalog_item_types = json_response[catalog_item_type_list_key]
+    render_response(json_response, options, catalog_item_type_list_key) do
+      print_h1 "Morpheus Catalog Items", parse_list_subtitles(options), options
+      if catalog_item_types.empty?
+        print cyan,"No catalog items found.",reset,"\n"
+      else
+        list_columns = catalog_item_type_column_definitions.upcase_keys!
+        #list_columns["Config"] = lambda {|it| truncate_string(it['config'], 100) }
+        print as_pretty_table(catalog_item_types, list_columns.upcase_keys!, options)
+        print_results_pagination(json_response)
+      end
+      print reset,"\n"
+    end
+    if catalog_item_types.empty?
+      return 1, "no catalog items found"
+    else
+      return 0, nil
+    end
+  end
+  
+  def get(args)
+    params = {}
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type]")
+      opts.on( '-c', '--config', "Display raw config only. Default is YAML. Combine with -j for JSON instead." ) do
+        options[:show_config] = true
+      end
+      # opts.on('--no-config', "Do not display config content." ) do
+      #   options[:no_config] = true
+      # end
+      build_standard_get_options(opts, options)
+      opts.footer = <<-EOT
+Get details about a specific catalog item type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:1)
+    connect(options)
+    id_list = parse_id_list(args)
+    return run_command_for_each_arg(id_list) do |arg|
+      _get(arg, params, options)
+    end
+  end
+
+  def _get(id, params, options)
+    catalog_item_type = nil
+    if id.to_s !~ /\A\d{1,}\Z/
+      catalog_item_type = find_catalog_item_type_by_name(id)
+      return 1, "catalog item type not found for #{id}" if catalog_item_type.nil?
+      id = catalog_item_type['id']
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.get(id, params)
+      return
+    end
+    # skip extra query, list has same data as show right now
+    if catalog_item_type
+      json_response = {catalog_item_type_object_key => catalog_item_type}
+    else
+      json_response = @catalog_item_types_interface.get(id, params)
+    end
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    config = catalog_item_type['config'] || {}
+    # export just the config as json or yaml (default)
+    if options[:show_config]
+      unless options[:json] || options[:yaml] || options[:csv]
+        options[:yaml] = true
+      end
+      return render_with_format(config, options)
+    end
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_h1 "Catalog Item Type Details", [], options
+      print cyan
+      show_columns = catalog_item_type_column_definitions
+      show_columns.delete("Blueprint") unless catalog_item_type['blueprint']
+      print_description_list(show_columns, catalog_item_type)
+
+      if catalog_item_type['optionTypes'] && catalog_item_type['optionTypes'].size > 0
+        print_h2 "Option Types"
+        opt_columns = [
+          {"ID" => lambda {|it| it['id'] } },
+          {"NAME" => lambda {|it| it['name'] } },
+          {"TYPE" => lambda {|it| it['type'] } },
+          {"FIELD NAME" => lambda {|it| it['fieldName'] } },
+          {"FIELD LABEL" => lambda {|it| it['fieldLabel'] } },
+          {"DEFAULT" => lambda {|it| it['defaultValue'] } },
+          {"REQUIRED" => lambda {|it| format_boolean it['required'] } },
+        ]
+        print as_pretty_table(catalog_item_type['optionTypes'], opt_columns)
+      else
+        # print cyan,"No option types found for this catalog item.","\n",reset
+      end
+
+      if config && options[:no_config] != true
+        print_h2 "Config YAML"
+        #print reset,(JSON.pretty_generate(config) rescue config),"\n",reset
+        #print reset,(as_yaml(config, options) rescue config),"\n",reset
+        config_string = as_yaml(config, options) rescue config
+        config_lines = config_string.split("\n")
+        config_line_count = config_lines.size
+        max_lines = 10
+        if config_lines.size > max_lines
+          config_string = config_lines.first(max_lines).join("\n")
+          config_string << "\n\n"
+          config_string << "(#{(config_line_count - max_lines)} more lines were not shown, use -c to show the config)"
+          #config_string << "\n"
+        end
+        # strip --- yaml header
+        if config_string[0..3] == "---\n"
+          config_string = config_string[4..-1]
+        end
+        print reset,config_string.chomp("\n"),"\n",reset
+      end
+
+      print reset,"\n"
+    end
+    return 0, nil
+  end
+
+  def add(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name] [options]")
+      build_option_type_options(opts, options, add_catalog_item_type_option_types)
+      opts.on('--config-file FILE', String, "Config from a local JSON or YAML file") do |val|
+        options[:config_file] = val.to_s
+        file_content = nil
+        full_filename = File.expand_path(options[:config_file])
+        if File.exists?(full_filename)
+          file_content = File.read(full_filename)
+        else
+          print_red_alert "File not found: #{full_filename}"
+          return 1
+        end
+        parse_result = parse_json_or_yaml(file_content)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+          options[:options]['config'] = params['config'] # or file_content
+        end
+      end
+      opts.on('--option-types [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.on('--optionTypes [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.add_hidden_option('--optionTypes')
+      build_option_type_options(opts, options, add_catalog_item_type_advanced_option_types)
+      build_standard_add_options(opts, options)
+      opts.footer = <<-EOT
+Create a new catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:0, max:1)
+    options[:options]['name'] = args[0] if args[0]
+    connect(options)
+    payload = {}
+    if options[:payload]
+      payload = options[:payload]
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+    else
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+      v_prompt = Morpheus::Cli::OptionTypes.prompt(add_catalog_item_type_option_types(), options[:options], @api_client, options[:params])
+      params.deep_merge!(v_prompt)
+      advanced_config = Morpheus::Cli::OptionTypes.no_prompt(add_catalog_item_type_advanced_option_types, options[:options], @api_client, options[:params])
+      advanced_config.deep_compact!
+      params.deep_merge!(advanced_config)
+      # convert checkbox "on" and "off" to true and false
+      params.booleanize!
+      # convert type to refType until api accepts type
+      if params['type'] && !params['refType']
+        if params['type'].to_s.downcase == 'blueprint'
+          params['refType'] = 'AppTemplate'
+        else
+          params['refType'] = 'InstanceType'
+        end
+      end
+      # convert config string to a map
+      config = params['config']
+      if config && config.is_a?(String)
+        parse_result = parse_json_or_yaml(config)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+        end
+      end
+      if params['optionTypes']
+        # todo: move to optionSource, so it will be /api/options/optionTypes  lol
+        prompt_results = prompt_for_option_types(params, options, @api_client)
+        if prompt_results[:success]
+          params['optionTypes'] = prompt_results[:data] unless prompt_results[:data].nil?
+        else
+          return 1
+        end
+      end
+      payload[catalog_item_type_object_key].deep_merge!(params)
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.create(payload)
+      return 0, nil
+    end
+    json_response = @catalog_item_types_interface.create(payload)
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_green_success "Added catalog item #{catalog_item_type['name']}"
+      return _get(catalog_item_type["id"], {}, options)
+    end
+    return 0, nil
+  end
+
+  def update(args)
+    options = {}
+    params = {}
+    payload = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type] [options]")
+      build_option_type_options(opts, options, update_catalog_item_type_option_types)
+      opts.on('--config-file FILE', String, "Config from a local JSON or YAML file") do |val|
+        options[:config_file] = val.to_s
+        file_content = nil
+        full_filename = File.expand_path(options[:config_file])
+        if File.exists?(full_filename)
+          file_content = File.read(full_filename)
+        else
+          print_red_alert "File not found: #{full_filename}"
+          return 1
+        end
+        parse_result = parse_json_or_yaml(file_content)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+          options[:options]['config'] = params['config'] # or file_content
+        end
+      end
+      opts.on('--option-types [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.on('--optionTypes [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.add_hidden_option('--optionTypes')
+      build_option_type_options(opts, options, update_catalog_item_type_advanced_option_types)
+      build_standard_update_options(opts, options)
+      opts.footer = <<-EOT
+Update a catalog item type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+    catalog_item_type = find_catalog_item_type_by_name_or_id(args[0])
+    return 1 if catalog_item_type.nil?
+    payload = {}
+    if options[:payload]
+      payload = options[:payload]
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+    else
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+      # do not prompt on update
+      v_prompt = Morpheus::Cli::OptionTypes.no_prompt(update_catalog_item_type_option_types, options[:options], @api_client, options[:params])
+      v_prompt.deep_compact!
+      params.deep_merge!(v_prompt)
+      advanced_config = Morpheus::Cli::OptionTypes.no_prompt(update_catalog_item_type_advanced_option_types, options[:options], @api_client, options[:params])
+      advanced_config.deep_compact!
+      params.deep_merge!(advanced_config)
+      # convert checkbox "on" and "off" to true and false
+      params.booleanize!
+      # convert type to refType until api accepts type
+      if params['type'] && !params['refType']
+        if params['type'].to_s.downcase == 'blueprint'
+          params['refType'] = 'AppTemplate'
+        else
+          params['refType'] = 'InstanceType'
+        end
+      end
+      # convert config string to a map
+      config = params['config']
+      if config && config.is_a?(String)
+        parse_result = parse_json_or_yaml(config)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+        end
+      end
+      payload.deep_merge!({catalog_item_type_object_key => params})
+      if payload[catalog_item_type_object_key].empty? # || options[:no_prompt]
+        raise_command_error "Specify at least one option to update.\n#{optparse}"
+      end
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.update(catalog_item_type['id'], payload)
+      return
+    end
+    json_response = @catalog_item_types_interface.update(catalog_item_type['id'], payload)
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_green_success "Updated catalog item #{catalog_item_type['name']}"
+      return _get(catalog_item_type["id"], {}, options)
+    end
+    return 0, nil
+  end
+
+  def remove(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type] [options]")
+      build_standard_remove_options(opts, options)
+      opts.footer = <<-EOT
+Delete a catalog_item_type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+    catalog_item_type = find_catalog_item_type_by_name_or_id(args[0])
+    return 1 if catalog_item_type.nil?
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.destroy(catalog_item_type['id'], params)
+      return
+    end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the catalog item #{catalog_item_type['name']}?")
+      return 9, "aborted command"
+    end
+    json_response = @catalog_item_types_interface.destroy(catalog_item_type['id'], params)
+    render_response(json_response, options) do
+      print_green_success "Removed catalog item #{catalog_item_type['name']}"
+    end
+    return 0, nil
+  end
+
+  private
+
+  def catalog_item_type_column_definitions()
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Description" => 'description',
+      "Type" => lambda {|it| format_catalog_type(it) },
+      "Blueprint" => lambda {|it| it['blueprint'] ? it['blueprint']['name'] : nil },
+      "Enabled" => lambda {|it| format_boolean(it['enabled']) },
+      "Featured" => lambda {|it| format_boolean(it['featured']) },
+      #"Config" => lambda {|it| it['config'] },
+      "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+      "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+    }
+  end
+
+  def format_catalog_type(catalog_item_type)
+    out = ""
+    # api "blueprint": {"name":my blueprint"} }
+    # instead of cryptic refType
+    if catalog_item_type['type']
+      if catalog_item_type['type'].is_a?(String)
+        out << catalog_item_type['type'].to_s.capitalize
+      else
+        out << (catalog_item_type['type']['name'] || catalog_item_type['type']['code']) rescue catalog_item_type['type'].to_s
+      end
+    else
+      ref_type = catalog_item_type['refType']
+      if ref_type == 'InstanceType'
+        out << "Instance"
+      elsif ref_type == 'AppTemplate'
+        out << "Blueprint"
+      elsif ref_type
+        out << ref_type
+      else
+        "(none)"
+      end
+    end
+    out
+  end
+
+  # this is not so simple, need to first choose select instance, host or provider
+  def add_catalog_item_type_option_types
+    [
+      {'fieldName' => 'name', 'fieldLabel' => 'Name', 'type' => 'text', 'required' => true},
+      {'fieldName' => 'description', 'fieldLabel' => 'Description', 'type' => 'text'},
+      {'fieldName' => 'type', 'fieldLabel' => 'Type', 'type' => 'select', 'selectOptions' => [{'name' => 'Instance', 'value' => 'instance'}, {'name' => 'Blueprint', 'value' => 'blueprint'}], 'defaultValue' => 'instance'},
+      {'fieldName' => 'enabled', 'fieldLabel' => 'Enabled', 'type' => 'checkbox', 'defaultValue' => true},
+      {'fieldName' => 'featured', 'fieldLabel' => 'Featured', 'type' => 'checkbox', 'defaultValue' => false},
+      {'fieldName' => 'visibility', 'fieldLabel' => 'Visibility', 'type' => 'select', 'selectOptions' => [{'name' => 'Private', 'value' => 'private'}, {'name' => 'Public', 'value' => 'public'}], 'defaultValue' => 'private', 'required' => true},
+      {'fieldName' => 'iconPath', 'fieldLabel' => 'Logo', 'type' => 'select', 'optionSource' => 'iconList'},
+      #{'fieldName' => 'optionTypes', 'fieldLabel' => 'Option Types', 'type' => 'text', 'description' => 'Option Types to include, comma separated list of names or IDs.'},
+      {'fieldName' => 'config', 'fieldLabel' => 'Config', 'type' => 'code-editor', 'required' => true, 'description' => 'JSON or YAML'}
+    ]
+  end
+
+  def add_catalog_item_type_advanced_option_types
+    []
+  end
+
+  def update_catalog_item_type_option_types
+    add_catalog_item_type_option_types.collect {|it|
+      it.delete('required')
+      it.delete('defaultValue')
+      it
+    }
+  end
+
+  def update_catalog_item_type_advanced_option_types
+    add_catalog_item_type_advanced_option_types.collect {|it|
+      it.delete('required')
+      it.delete('defaultValue')
+      it
+    }
+  end
+
+end