knife-ionoscloud 6.0.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e01979765cd8e47bdb767d5526e440eee9237c3a61060f0f5baf451e5dbcb9fa
-  data.tar.gz: def67d397e54a9dfe79fdbf4e1a5537022ba82108c119d6f922b0fe184d722b4
+  metadata.gz: 844d50cdb67740c66e4509ae0d8ad0a95b486c3e31558c30d54f8f96a019f4a2
+  data.tar.gz: b8fdedf4d8c42e69c33306b67580c13c6522d0c2fc5927b5430909fbd6c62d30
 SHA512:
-  metadata.gz: 37512cd2d43d178c00d561bd5195401e2f9f36bb6949a4f6e0c755c7212415b3ce3318a479e095834310b17b8fb7a0441e891fbfc7d7c6e9ff42a3f9f50e4443
-  data.tar.gz: 8cab82713670696934ecc997d72e134ca2f85692b35e25a0f60c9bab2020db5fa3d7a4e075ed6b53828fed8d194c7d84efcd38ce0b234ddfd934a98fd5738125
+  metadata.gz: af364bfbcaa19a9471d22f48e4261a71f941ff2584618587161da76ae4691c0830e20357354a99628661f69bd013f9f6b57f5373d8ffb4ff029ffc270caafb35
+  data.tar.gz: 4a77204a6becf7a87452921a9379a394dbf788e9ad4c3fca24ed349a03d347b7dc1ee6e8495e8c0f27c07084f5f5d1bb1bb4aaf0d9708199076a1ccfdda7b978

data/.github/IONOS.CLOUD.BLU.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1077.17 255.12"><defs><style>.cls-1{fill:#003d8f;}</style></defs><title>IONOS.CLOUD Blu</title><g id="Ebene_3" data-name="Ebene 3"><path class="cls-1" d="M594.12,211.52a42.56,42.56,0,0,1-8.5-.86,44,44,0,0,1-29-20.73l-.15-.29a13,13,0,0,1,4.8-17.2,12.55,12.55,0,0,1,6.46-1.79,12.77,12.77,0,0,1,11.12,6.54c.13.22.28.47.44.71l1.35,1.84,1.82,1.84a17.69,17.69,0,0,0,8.29,4,18.21,18.21,0,0,0,14.3-3.27,17.27,17.27,0,0,0,7.18-12.93,17.86,17.86,0,0,0-5-13.88s-38.42-39.9-40.14-41.75a47.14,47.14,0,0,1-4.63-5.51c-5.42-7.68-7.12-16.74-6.28-25.7a41.75,41.75,0,0,1,5.41-17.77s1.76-3,2.28-3.73a48.36,48.36,0,0,1,8.78-8.95A45.36,45.36,0,0,1,580,47.67a42,42,0,0,1,54.79,16.91,12.45,12.45,0,0,1,1.33,9.65,12.73,12.73,0,0,1-6.07,7.85,12.21,12.21,0,0,1-6.23,1.69,12.68,12.68,0,0,1-11.05-6.5,16.69,16.69,0,0,0-11.18-7.91,17.35,17.35,0,0,0-13.56,3,16.5,16.5,0,0,0-6.41,12,16.82,16.82,0,0,0,4.57,13l39.28,40.5a43.5,43.5,0,0,1-31.38,73.68"/><path class="cls-1" d="M469.82,211.5a42.29,42.29,0,0,1-42.24-42.24V85.7a42.24,42.24,0,1,1,84.48,0v83.56a42.29,42.29,0,0,1-42.24,42.24m0-142.53A16.76,16.76,0,0,0,453.08,85.7v83.56A16.56,16.56,0,0,0,469.82,186a16.76,16.76,0,0,0,16.74-16.73V85.7A17,17,0,0,0,469.82,69"/><path class="cls-1" d="M305.61,129.64v69.1a12.75,12.75,0,0,1-25.5,0v-122Zm69.18,48.65V56.21a12.75,12.75,0,1,0-25.5,0v69.15ZM304.57,50.69l-.12-.24a13.06,13.06,0,0,0-11.54-6.92,11.84,11.84,0,0,0-2.57.27,12.48,12.48,0,0,0-10.07,12.41v2.91L350.4,204.5a13.14,13.14,0,0,0,11.32,7,11.22,11.22,0,0,0,2.92-.37,12.5,12.5,0,0,0,9.94-12.38V196l-70-145.3"/><path class="cls-1" d="M184.67,211.5a42.29,42.29,0,0,1-42.24-42.24V85.7a42.24,42.24,0,0,1,84.48,0v83.56a42.3,42.3,0,0,1-42.24,42.24m0-142.53A16.76,16.76,0,0,0,167.93,85.7v83.56a16.74,16.74,0,0,0,33.48,0V85.7A17,17,0,0,0,184.67,69"/><path class="cls-1" d="M75.19,211.43a13.8,13.8,0,0,1-13.86-14v-140l0-.27a13.89,13.89,0,0,1,27.29-3.46c.07.24.16.59.24,1l.09.6a14.23,14.23,0,0,1,.18,2.22s0,138.3,0,139.89a13.85,13.85,0,0,1-14,14.05"/><path class="cls-1" d="M709.85,211.61c-7.39,0-14.87-5-14.87-14.64V167.21c0-9.9,7.5-15.08,14.91-15.08s14.92,5.18,14.92,15.08a4.61,4.61,0,1,1-9.22,0,5.7,5.7,0,1,0-11.39,0V197c0,5.16,4.71,5.42,5.65,5.42.59,0,5.74-.15,5.74-5.23a4.61,4.61,0,1,1,9.22,0C724.81,206.54,717.1,211.61,709.85,211.61Z"/><path class="cls-1" d="M929.77,211.73c-7.32,0-14.73-5.2-14.73-15.13V156.45a4.44,4.44,0,1,1,8.88,0V196.6c0,4.61,3.15,6.25,5.85,6.25a6,6,0,0,0,4.05-1.52,6.52,6.52,0,0,0,1.83-5V156.45a4.44,4.44,0,1,1,8.88,0v39.89a15.19,15.19,0,0,1-4.62,11.46A14.74,14.74,0,0,1,929.77,211.73Z"/><path class="cls-1" d="M1005.17,211.83l-10.84-.12a4.43,4.43,0,0,1-4.39-4.43v-50.9a4.43,4.43,0,0,1,4.43-4.43l10.79,0c9.46,0,15.11,5.44,15.11,14.55v30.64C1020.27,206.19,1014.48,211.83,1005.17,211.83Zm-6.36-8.94,6.4.07c4.44,0,6.19-1.64,6.19-5.85V166.47c0-3.51-1-5.68-6.23-5.68h-6.36Z"/><path class="cls-1" d="M773.56,211.65a4.9,4.9,0,0,1-4.92-5V156.94a4.93,4.93,0,0,1,9.68-1.22c0,.08,0,.2.08.34l0,.22a5.38,5.38,0,0,1,.07.78s0,44.16,0,44.72H789a4.93,4.93,0,1,1,0,9.86H773.56Z"/><path class="cls-1" d="M853.28,211.66a15,15,0,0,1-15-15V167.06a14.92,14.92,0,0,1,2.49-8.27l6.55,13.6v24.29a5.88,5.88,0,0,0,5.94,5.94,6,6,0,0,0,5.93-5.64l4.89,10a14.92,14.92,0,0,1-10.82,4.64m0-50.54a6,6,0,0,0-5.93,5.57l-4.84-10a15,15,0,0,1,25.75,10.41v29.62a14.93,14.93,0,0,1-2.45,8.2l-6.6-13.63V167.06a6,6,0,0,0-5.93-5.94"/></g></svg>

data/README.md

@@ -10,6 +10,15 @@
 [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=knife-plugin&metric=security_rating)](https://sonarcloud.io/dashboard?id=knife-plugin)
 [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=knife-plugin&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=knife-plugin)
 
+![Alt text](.github/IONOS.CLOUD.BLU.svg?raw=true "Title")
+
+
+---
+**NOTE:**
+Be aware that the Chef IonosCloud Provider v6 will become main branch and it will be using the latest stable API Version.
+
+---
+
 ## Overview
 
 Chef is a popular configuration management tool that allows simplified configuration and maintenance of both servers and cloud provider environments through the use of common templates called recipes. The Chef `knife` command line tool allows management of various nodes within those environments. The `knife-ionoscloud` plugin utilizes the IONOS Cloud REST API to provision and manage various cloud resources on the IONOS Cloud platform.

data/docs/README.md

@@ -2,6 +2,12 @@
 
 ![CI](https://github.com/ionos-cloud/knife-ionos-cloud/workflows/CI/badge.svg) [![Gem Version](https://badge.fury.io/rb/knife-ionoscloud.svg)](https://badge.fury.io/rb/knife-ionoscloud) [![Gitter](https://badges.gitter.im/ionos-cloud/sdk-general.png)](https://gitter.im/ionos-cloud/sdk-general)
 
+---
+**NOTE:**
+Be aware that the Chef IonosCloud Provider v6 will become main branch and it will be using the latest stable API Version.
+
+---
+
 ## Overview
 
 Chef is a popular configuration management tool that allows simplified configuration and maintenance of both servers and cloud provider environments through the use of common templates called recipes. The Chef `knife` command line tool allows management of various nodes within those environments. The `knife-ionoscloud` plugin utilizes the IONOS Cloud REST API to provision and manage various cloud resources on the IONOS Cloud platform.

data/docs/changelog.md

@@ -1,2 +1,12 @@
 # Changelog
 
+## 6.0.0
+
+* First v6 stable release
+
+## 6.1.0
+
+### Enhancements:
+
+* added support for Dbaas Postgres
+* restructured documentation

data/docs/docs_generator.rb

@@ -3,11 +3,20 @@
 # This must be run from /docs directory
 
 require 'mustache'
+require 'fileutils'
 
 $LOAD_PATH << '.'
 
 Dir["../lib/chef/knife/*.rb"].each { |file| require file }
 
+FOLDER_TO_NAME_MAP = {
+  'backup' => 'Managed Backup',
+  'user' => 'User Management',
+  'compute-engine' => 'Compute Engine',
+  'kubernetes' => 'Managed Kubernetes',
+  'dbaas-postgres' => 'DbaaS Postgres',
+}.freeze
+
 def underscore_string(s)
   s.gsub(/::/, '/').
   gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
@@ -36,10 +45,10 @@ class Summary < Mustache
   self.template_path = './templates'
   self.template_file = './templates/summary.mustache'
 
-  attr_accessor :subcommands
+  attr_accessor :categories
 
-  def initialize(subcommands)
-    @subcommands = subcommands || []
+  def initialize(categories)
+    @categories = categories || []
   end
 end
 
@@ -54,7 +63,13 @@ def generate_subcommand_doc(subcommand)
   subcommand_name = subcommand.class.to_s
   subcommand_name.slice!('Chef::Knife::Ionoscloud')
 
-  filename = "subcommands/#{underscore_string(subcommand_name)}.md"
+  begin
+    filename = "subcommands/#{subcommand.directory}/#{underscore_string(subcommand_name)}.md"
+    category = FOLDER_TO_NAME_MAP[subcommand.directory]
+  rescue NoMethodError
+    filename = "subcommands/#{underscore_string(subcommand_name)}.md"
+    category = ''
+  end
 
   begin
     description = subcommand.description
@@ -62,6 +77,8 @@ def generate_subcommand_doc(subcommand)
     description = ''
   end
 
+  FileUtils.mkdir_p(File.dirname(filename)) unless File.directory?(File.dirname(filename))
+
   File.open(filename, 'w') { |f|
     f.write(
       Subcommand.new(
@@ -75,7 +92,11 @@ def generate_subcommand_doc(subcommand)
   }
 
   puts "Generated documentation for #{subcommand_name}."
-  return subcommand_name, filename
+  {
+    title: subcommand_name,
+    filename: filename,
+    category: category,
+  }
 end
 
 subcommands = []
@@ -85,13 +106,14 @@ begin
     Chef::Knife.const_get(c).is_a?(Class) && c.to_s.start_with?('Ionoscloud')
   }.each {
     |subcommand|
+    # if subcommand.to_s == 'IonoscloudBackupunitCreate'
     begin
-      subcommand_name, filename = generate_subcommand_doc(Chef::Knife.const_get(subcommand).new)
-      subcommands.append({ title: subcommand_name, filename: filename })
+      subcommands.append(generate_subcommand_doc(Chef::Knife.const_get(subcommand).new))
     rescue Exception => exc
       puts "Could not generate doc for #{subcommand}. Error: #{exc}"
       # raise exc
     end
+    # end
   }
 rescue NameError => exc
   if exc.message == 'uninitialized constant Chef'
@@ -100,8 +122,21 @@ rescue NameError => exc
   raise exc
 end
 
-subcommands.sort! { |a, b| a[:title] <=> b[:title] }
+categories = {}
+
+subcommands.map do |subcommand|
+  if categories.key?(subcommand[:category])
+    categories[subcommand[:category]] << subcommand
+  else
+    categories[subcommand[:category]] = [subcommand]
+  end
+end
+
+
+final = []
+
+categories.map { |key, value| final << { category: key, subcommands: value } }
 
 File.open('summary.md', 'w') { |f|
-  f.write(Summary.new(subcommands).render,)
+  f.write(Summary.new(final).render)
 }

data/docs/subcommands/{backupunit_create.md → backup/backupunit_create.md}

@@ -26,7 +26,7 @@ knife ionoscloud backupunit create (options)
     password: --password PASSWORD, -p PASSWORD
         alphanumeric password you want assigned to the backup unit (required)
 
-    email: --email EMAIL
+    email: --email EMAIL, -e EMAIL
         the e-mail address you want assigned to the backup unit. (required)
 
     ionoscloud_username: --username USERNAME, -u USERNAME

data/docs/subcommands/{composite_server_create.md → compute-engine/composite_server_create.md}

@@ -73,6 +73,12 @@ knife ionoscloud composite server create (options)
     ssh_keys: --ssh-keys SSHKEY1,SSHKEY2,..., -K SSHKEY[,SSHKEY,...]
         a list of public SSH keys to include
 
+    backupunit_id: --backupunit BACKUPUNIT_ID, -B BACKUPUNIT_ID
+        the uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
+
+    user_data: --user-data USER_DATA, -u USER_DATA
+        the cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.
+
     nic_name: --nic-name NAME
         name of the NIC
 
@@ -85,8 +91,8 @@ knife ionoscloud composite server create (options)
     lan: --lan ID, -L ID
         the LAN ID the NIC will reside on; if the LAN ID does not exist it will be created (required)
 
-    nat: --nat
-        set to enable NAT on the NIC
+    firewall_type: --firewall-type FIREWALL_TYPE
+        the type of firewall rules that will be allowed on the NIC. If it is not specified it will take the default value INGRESS
 
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
@@ -101,5 +107,5 @@ knife ionoscloud composite server create (options)
 ## Example
 
 ```text
-knife ionoscloud composite server create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --name NAME --cores CORES --cpu-family CPU_FAMILY --ram RAM --availability-zone AVAILABILITY_ZONE --volume-name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --type TYPE --licence-type LICENCE --image-password PASSWORD --volume-availability-zone AVAILABILITY_ZONE --ssh-keys SSHKEY1,SSHKEY2,... --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --nat --username USERNAME --password PASSWORD --url URL
+knife ionoscloud composite server create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --name NAME --cores CORES --cpu-family CPU_FAMILY --ram RAM --availability-zone AVAILABILITY_ZONE --volume-name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --type TYPE --licence-type LICENCE --image-password PASSWORD --volume-availability-zone AVAILABILITY_ZONE --ssh-keys SSHKEY1,SSHKEY2,... --backupunit BACKUPUNIT_ID --user-data USER_DATA --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{firewall_create.md → compute-engine/firewall_create.md}

@@ -30,7 +30,7 @@ knife ionoscloud firewall create (options)
         iD of the NIC (required)
 
     name: --name NAME, -n NAME
-        name of the Firewall Rule
+        name of the NIC
 
     protocol: --protocol PROTOCOL, -P PROTOCOL
         the protocol of the firewall rule (TCP, UDP, ICMP, ANY)
@@ -47,7 +47,7 @@ knife ionoscloud firewall create (options)
     port_range_start: --port-range-start PORT, -p PORT
         defines the start range of the allowed port(s)
 
-    port_range_end: --port-range-end PORT, -t PORT
+    port_range_end: --port-range-end PORT
         defines the end range of the allowed port(s)
 
     icmp_type: --icmp-type INT
@@ -56,6 +56,9 @@ knife ionoscloud firewall create (options)
     icmp_code: --icmp-code INT
         defines the allowed code (from 0 to 254) if the protocol ICMP is chosen; null allows all codes
 
+    type: --type TYPE, --t TYPE
+        the type of firewall rule. If is not specified, it will take the default value INGRESS
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
@@ -69,5 +72,5 @@ knife ionoscloud firewall create (options)
 ## Example
 
 ```text
-knife ionoscloud firewall create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --nic-id NIC_ID --name NAME --protocol PROTOCOL --source-mac MAC --source-ip IP --target-ip IP --port-range-start PORT --port-range-end PORT --icmp-type INT --icmp-code INT --username USERNAME --password PASSWORD --url URL
+knife ionoscloud firewall create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --nic-id NIC_ID --name NAME --protocol PROTOCOL --source-mac MAC --source-ip IP --target-ip IP --port-range-start PORT --port-range-end PORT --icmp-type INT --icmp-code INT --type TYPE --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{lan_update.md → compute-engine/lan_update.md}

@@ -34,9 +34,6 @@ knife ionoscloud lan update (options)
     pcc: --pcc PCC_ID
         iD of the PCC to connect the LAN to
 
-    ip_failover: --ip-failover IPFAILOVER [IPFAILOVER]
-        iP failover configurations for lan
-
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
@@ -50,5 +47,5 @@ knife ionoscloud lan update (options)
 ## Example
 
 ```text
-knife ionoscloud lan update --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --lan-id LAN_ID --name NAME --public PUBLIC --pcc PCC_ID --ip-failover IPFAILOVER [IPFAILOVER] --username USERNAME --password PASSWORD --url URL
+knife ionoscloud lan update --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --lan-id LAN_ID --name NAME --public PUBLIC --pcc PCC_ID --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{loadbalancer_create.md → compute-engine/loadbalancer_create.md}

@@ -28,7 +28,7 @@ knife ionoscloud loadbalancer create (options)
     ip: --ip IP
         iPv4 address of the load balancer. All attached NICs will inherit this IP.
 
-    dhcp: --dhcp DHCP
+    dhcp: --dhcp DHCP, -d DHCP
         indicates if the load balancer will reserve an IP using DHCP.
 
     nics: --nics NIC_ID [NIC_ID]

data/docs/subcommands/{nic_create.md → compute-engine/nic_create.md}

@@ -32,14 +32,14 @@ knife ionoscloud nic create (options)
     ips: --ips IP[,IP,...], -i IP[,IP,...]
         iPs assigned to the NIC
 
-    dhcp: --dhcp DHCP
+    dhcp: --dhcp, -d
         set to false if you wish to disable DHCP
 
     lan: --lan ID, -l ID
         the LAN ID the NIC will reside on; if the LAN ID does not exist it will be created (required)
 
-    nat: --nat NAT
-        set to enable NAT on the NIC
+    firewall_type: --firewall-type FIREWALL_TYPE, -t FIREWALL_TYPE
+        the type of firewall rules that will be allowed on the NIC. If it is not specified it will take the default value INGRESS
 
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
@@ -54,5 +54,5 @@ knife ionoscloud nic create (options)
 ## Example
 
 ```text
-knife ionoscloud nic create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --name NAME --ips IP[,IP,...] --dhcp DHCP --lan ID --nat NAT --username USERNAME --password PASSWORD --url URL
+knife ionoscloud nic create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --name NAME --ips IP[,IP,...] --dhcp --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{nic_delete.md → compute-engine/nic_delete.md}

@@ -23,7 +23,7 @@ knife ionoscloud nic delete NIC_ID [NIC_ID] (options)
         the ID of the data center (required)
 
     server_id: --server-id SERVER_ID, -S SERVER_ID
-        the ID of the server to which the NIC is assigned (required)
+        the ID of the server assigned the NIC (required)
 
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)

data/docs/subcommands/{nic_update.md → compute-engine/nic_update.md}

@@ -41,8 +41,8 @@ knife ionoscloud nic update (options)
     lan: --lan ID, -l ID
         the LAN ID the NIC will reside on; if the LAN ID does not exist it will be created
 
-    nat: --nat NAT
-        set to enable NAT on the NIC
+    firewall_type: --firewall-type FIREWALL_TYPE, -t FIREWALL_TYPE
+        the type of firewall rules that will be allowed on the NIC. If it is not specified it will take the default value INGRESS
 
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
@@ -57,5 +57,5 @@ knife ionoscloud nic update (options)
 ## Example
 
 ```text
-knife ionoscloud nic update --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --nic-id NIC_ID --name NAME --ips IP[,IP,...] --dhcp DHCP --lan ID --nat NAT --username USERNAME --password PASSWORD --url URL
+knife ionoscloud nic update --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --server-id SERVER_ID --nic-id NIC_ID --name NAME --ips IP[,IP,...] --dhcp DHCP --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{server_list.md → compute-engine/server_list.md}

@@ -21,6 +21,9 @@ knife ionoscloud server list (options)
     datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
         the ID of the datacenter containing the server (required)
 
+    upgrade_needed: --upgrade-needed, -u
+        it can be used to filter which servers can be upgraded
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
@@ -34,5 +37,5 @@ knife ionoscloud server list (options)
 ## Example
 
 ```text
-knife ionoscloud server list --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --username USERNAME --password PASSWORD --url URL
+knife ionoscloud server list --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --upgrade-needed --username USERNAME --password PASSWORD --url URL
 ```