ionoscloud 6.1.1 → 6.1.2

data/docs/api/ServersApi.md

@@ -4,37 +4,37 @@ All URIs are relative to *https://api.ionos.com/cloudapi/v6*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**datacenters_servers_cdroms_delete**](ServersApi.md#datacenters_servers_cdroms_delete) | **DELETE** /datacenters/{datacenterId}/servers/{serverId}/cdroms/{cdromId} | Detach CD-ROMs |
-| [**datacenters_servers_cdroms_find_by_id**](ServersApi.md#datacenters_servers_cdroms_find_by_id) | **GET** /datacenters/{datacenterId}/servers/{serverId}/cdroms/{cdromId} | Retrieve attached CD-ROMs |
-| [**datacenters_servers_cdroms_get**](ServersApi.md#datacenters_servers_cdroms_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/cdroms | List attached CD-ROMs  |
-| [**datacenters_servers_cdroms_post**](ServersApi.md#datacenters_servers_cdroms_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/cdroms | Attach CD-ROMs |
+| [**datacenters_servers_cdroms_delete**](ServersApi.md#datacenters_servers_cdroms_delete) | **DELETE** /datacenters/{datacenterId}/servers/{serverId}/cdroms/{cdromId} | Detach a CD-ROM by ID |
+| [**datacenters_servers_cdroms_find_by_id**](ServersApi.md#datacenters_servers_cdroms_find_by_id) | **GET** /datacenters/{datacenterId}/servers/{serverId}/cdroms/{cdromId} | Get Attached CD-ROM by ID |
+| [**datacenters_servers_cdroms_get**](ServersApi.md#datacenters_servers_cdroms_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/cdroms | Get Attached CD-ROMs  |
+| [**datacenters_servers_cdroms_post**](ServersApi.md#datacenters_servers_cdroms_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/cdroms | Attach a CD-ROM |
 | [**datacenters_servers_delete**](ServersApi.md#datacenters_servers_delete) | **DELETE** /datacenters/{datacenterId}/servers/{serverId} | Delete servers |
 | [**datacenters_servers_find_by_id**](ServersApi.md#datacenters_servers_find_by_id) | **GET** /datacenters/{datacenterId}/servers/{serverId} | Retrieve servers by ID |
 | [**datacenters_servers_get**](ServersApi.md#datacenters_servers_get) | **GET** /datacenters/{datacenterId}/servers | List servers  |
 | [**datacenters_servers_patch**](ServersApi.md#datacenters_servers_patch) | **PATCH** /datacenters/{datacenterId}/servers/{serverId} | Partially modify servers |
-| [**datacenters_servers_post**](ServersApi.md#datacenters_servers_post) | **POST** /datacenters/{datacenterId}/servers | Create servers |
-| [**datacenters_servers_put**](ServersApi.md#datacenters_servers_put) | **PUT** /datacenters/{datacenterId}/servers/{serverId} | Modify servers |
+| [**datacenters_servers_post**](ServersApi.md#datacenters_servers_post) | **POST** /datacenters/{datacenterId}/servers | Create a Server |
+| [**datacenters_servers_put**](ServersApi.md#datacenters_servers_put) | **PUT** /datacenters/{datacenterId}/servers/{serverId} | Modify a Server by ID |
 | [**datacenters_servers_reboot_post**](ServersApi.md#datacenters_servers_reboot_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/reboot | Reboot servers |
 | [**datacenters_servers_remote_console_get**](ServersApi.md#datacenters_servers_remote_console_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/remoteconsole | Get Remote Console link |
-| [**datacenters_servers_resume_post**](ServersApi.md#datacenters_servers_resume_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/resume | Resume Cubes instances |
-| [**datacenters_servers_start_post**](ServersApi.md#datacenters_servers_start_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/start | Start servers |
-| [**datacenters_servers_stop_post**](ServersApi.md#datacenters_servers_stop_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/stop | Stop VMs |
-| [**datacenters_servers_suspend_post**](ServersApi.md#datacenters_servers_suspend_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/suspend | Suspend Cubes instances |
+| [**datacenters_servers_resume_post**](ServersApi.md#datacenters_servers_resume_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/resume | Resume a Cube Server by ID |
+| [**datacenters_servers_start_post**](ServersApi.md#datacenters_servers_start_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/start | Start an Enterprise Server by ID |
+| [**datacenters_servers_stop_post**](ServersApi.md#datacenters_servers_stop_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/stop | Stop an Enterprise Server by ID |
+| [**datacenters_servers_suspend_post**](ServersApi.md#datacenters_servers_suspend_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/suspend | Suspend a Cube Server by ID |
 | [**datacenters_servers_token_get**](ServersApi.md#datacenters_servers_token_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/token | Get JASON Web Token |
-| [**datacenters_servers_upgrade_post**](ServersApi.md#datacenters_servers_upgrade_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/upgrade | Upgrade servers |
-| [**datacenters_servers_volumes_delete**](ServersApi.md#datacenters_servers_volumes_delete) | **DELETE** /datacenters/{datacenterId}/servers/{serverId}/volumes/{volumeId} | Detach volumes |
-| [**datacenters_servers_volumes_find_by_id**](ServersApi.md#datacenters_servers_volumes_find_by_id) | **GET** /datacenters/{datacenterId}/servers/{serverId}/volumes/{volumeId} | Retrieve attached volumes |
-| [**datacenters_servers_volumes_get**](ServersApi.md#datacenters_servers_volumes_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/volumes | List attached volumes |
-| [**datacenters_servers_volumes_post**](ServersApi.md#datacenters_servers_volumes_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/volumes | Attach volumes |
+| [**datacenters_servers_upgrade_post**](ServersApi.md#datacenters_servers_upgrade_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/upgrade | Upgrade a Server by ID |
+| [**datacenters_servers_volumes_delete**](ServersApi.md#datacenters_servers_volumes_delete) | **DELETE** /datacenters/{datacenterId}/servers/{serverId}/volumes/{volumeId} | Detach a Volume by ID |
+| [**datacenters_servers_volumes_find_by_id**](ServersApi.md#datacenters_servers_volumes_find_by_id) | **GET** /datacenters/{datacenterId}/servers/{serverId}/volumes/{volumeId} | Get Attached Volume by ID |
+| [**datacenters_servers_volumes_get**](ServersApi.md#datacenters_servers_volumes_get) | **GET** /datacenters/{datacenterId}/servers/{serverId}/volumes | Get Attached Volumes |
+| [**datacenters_servers_volumes_post**](ServersApi.md#datacenters_servers_volumes_post) | **POST** /datacenters/{datacenterId}/servers/{serverId}/volumes | Attach a Volume to a Server |
 
 
 ## datacenters_servers_cdroms_delete
 
 > datacenters_servers_cdroms_delete(datacenter_id, server_id, cdrom_id, opts)
 
-Detach CD-ROMs
+Detach a CD-ROM by ID
 
-Detach the specified CD-ROM from the server.
+Detachs the specified CD-ROM from the server.  Detaching a CD-ROM deletes the CD-ROM. The image will not be deleted.  Note that detaching a CD-ROM leads to a reset of the server.
 
 ### Examples
 
@@ -64,7 +64,7 @@ opts = {
 }
 
 begin
-  # Detach CD-ROMs
+  # Detach a CD-ROM by ID
   api_instance.datacenters_servers_cdroms_delete(datacenter_id, server_id, cdrom_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_cdroms_delete: #{e}"
@@ -79,7 +79,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Detach CD-ROMs
+  # Detach a CD-ROM by ID
   data, status_code, headers = api_instance.datacenters_servers_cdroms_delete_with_http_info(datacenter_id, server_id, cdrom_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -118,9 +118,9 @@ Basic Authentication, Token Authentication
 
 > <Image> datacenters_servers_cdroms_find_by_id(datacenter_id, server_id, cdrom_id, opts)
 
-Retrieve attached CD-ROMs
+Get Attached CD-ROM by ID
 
-Retrieve the properties of the CD-ROM, attached to the specified server.
+Retrieves the properties of the CD-ROM attached to the specified server.
 
 ### Examples
 
@@ -150,7 +150,7 @@ opts = {
 }
 
 begin
-  # Retrieve attached CD-ROMs
+  # Get Attached CD-ROM by ID
   result = api_instance.datacenters_servers_cdroms_find_by_id(datacenter_id, server_id, cdrom_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -166,7 +166,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve attached CD-ROMs
+  # Get Attached CD-ROM by ID
   data, status_code, headers = api_instance.datacenters_servers_cdroms_find_by_id_with_http_info(datacenter_id, server_id, cdrom_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -205,9 +205,9 @@ Basic Authentication, Token Authentication
 
 > <Cdroms> datacenters_servers_cdroms_get(datacenter_id, server_id, opts)
 
-List attached CD-ROMs 
+Get Attached CD-ROMs 
 
-List all CD-ROMs, attached to the specified server.
+Lists all CD-ROMs attached to the specified server.
 
 ### Examples
 
@@ -238,7 +238,7 @@ opts = {
 }
 
 begin
-  # List attached CD-ROMs 
+  # Get Attached CD-ROMs 
   result = api_instance.datacenters_servers_cdroms_get(datacenter_id, server_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -254,7 +254,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List attached CD-ROMs 
+  # Get Attached CD-ROMs 
   data, status_code, headers = api_instance.datacenters_servers_cdroms_get_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -294,9 +294,9 @@ Basic Authentication, Token Authentication
 
 > <Image> datacenters_servers_cdroms_post(datacenter_id, server_id, cdrom, opts)
 
-Attach CD-ROMs
+Attach a CD-ROM
 
-Attach a CD-ROM to an existing server. Up to two CD-ROMs can be attached to the same server. 
+Attachs a CD-ROM to an existing server specified by its ID.   CD-ROMs cannot be created stand-alone like volumes. They are either attached to a server or do not exist. They always have an ISO-Image associated; empty CD-ROMs can not be provisioned. It is possible to attach up to two CD-ROMs to the same server.   Note that attaching a CD-ROM leads to a reset of the server.
 
 ### Examples
 
@@ -326,7 +326,7 @@ opts = {
 }
 
 begin
-  # Attach CD-ROMs
+  # Attach a CD-ROM
   result = api_instance.datacenters_servers_cdroms_post(datacenter_id, server_id, cdrom, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -342,7 +342,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Attach CD-ROMs
+  # Attach a CD-ROM
   data, status_code, headers = api_instance.datacenters_servers_cdroms_post_with_http_info(datacenter_id, server_id, cdrom, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -358,7 +358,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **datacenter_id** | **String** | The unique ID of the data center. |  |
 | **server_id** | **String** | The unique ID of the server. |  |
-| **cdrom** | [**Image**](Image.md) | The CD-ROM to be attached. |  |
+| **cdrom** | [**Image**](../models/Image.md) | The CD-ROM to be attached. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |
@@ -383,7 +383,7 @@ Basic Authentication, Token Authentication
 
 Delete servers
 
-Delete the specified server in your data center. The attached storage volumes will not be removed — a separate API call must be made for these actions.
+Delete the specified server in your data center. The attached storage volumes will also be removed if the query parameter is set to true otherwise a separate API call must be made for these actions.
 
 ### Examples
 
@@ -665,7 +665,7 @@ end
 api_instance = Ionoscloud::ServersApi.new
 datacenter_id = 'datacenter_id_example' # String | The unique ID of the data center.
 server_id = 'server_id_example' # String | The unique ID of the server.
-server = Ionoscloud::ServerProperties.new({cores: 4, ram: 4096}) # ServerProperties | The properties of the server to be updated.
+server = Ionoscloud::ServerProperties.new # ServerProperties | The properties of the server to be updated.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -705,7 +705,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **datacenter_id** | **String** | The unique ID of the data center. |  |
 | **server_id** | **String** | The unique ID of the server. |  |
-| **server** | [**ServerProperties**](ServerProperties.md) | The properties of the server to be updated. |  |
+| **server** | [**ServerProperties**](../models/ServerProperties.md) | The properties of the server to be updated. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |
@@ -728,9 +728,9 @@ Basic Authentication, Token Authentication
 
 > <Server> datacenters_servers_post(datacenter_id, server, opts)
 
-Create servers
+Create a Server
 
-Create a server within the specified data center. You can also use this request to configure the boot volumes and connect to existing LANs at the same time.
+Creates a server within the specified data center. You can also use this request to configure the boot volumes and connect to existing LANs at the same time.
 
 ### Examples
 
@@ -751,7 +751,7 @@ end
 
 api_instance = Ionoscloud::ServersApi.new
 datacenter_id = 'datacenter_id_example' # String | The unique ID of the data center.
-server = Ionoscloud::Server.new({properties: Ionoscloud::ServerProperties.new({cores: 4, ram: 4096})}) # Server | The server to create.
+server = Ionoscloud::Server.new({properties: Ionoscloud::ServerProperties.new}) # Server | The server to create.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -759,7 +759,7 @@ opts = {
 }
 
 begin
-  # Create servers
+  # Create a Server
   result = api_instance.datacenters_servers_post(datacenter_id, server, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -775,7 +775,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Create servers
+  # Create a Server
   data, status_code, headers = api_instance.datacenters_servers_post_with_http_info(datacenter_id, server, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -790,7 +790,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **datacenter_id** | **String** | The unique ID of the data center. |  |
-| **server** | [**Server**](Server.md) | The server to create. |  |
+| **server** | [**Server**](../models/Server.md) | The server to create. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |
@@ -813,9 +813,9 @@ Basic Authentication, Token Authentication
 
 > <Server> datacenters_servers_put(datacenter_id, server_id, server, opts)
 
-Modify servers
+Modify a Server by ID
 
-Modify the properties of the specified server within the data center.  Starting with v5, the 'allowReboot' attribute is retired; while previously required for changing certain server properties, this behavior is now implicit, and the backend will perform this automatically. For example, in earlier versions, when the CPU family is changed, 'allowReboot' had to be set to 'true'; this is no longer required, the reboot will be performed automatically.
+Modifies the properties of the specified server within the data center.  Starting with v5, the 'allowReboot' attribute is retired; while previously required for changing certain server properties, this behavior is now implicit, and the backend will perform this automatically. For example, in earlier versions, when the CPU family is changed, 'allowReboot' had to be set to 'true'; this is no longer required, the reboot will be performed automatically.
 
 ### Examples
 
@@ -837,7 +837,7 @@ end
 api_instance = Ionoscloud::ServersApi.new
 datacenter_id = 'datacenter_id_example' # String | The unique ID of the data center.
 server_id = 'server_id_example' # String | The unique ID of the server.
-server = Ionoscloud::Server.new({properties: Ionoscloud::ServerProperties.new({cores: 4, ram: 4096})}) # Server | The modified server
+server = Ionoscloud::Server.new({properties: Ionoscloud::ServerProperties.new}) # Server | The modified server
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -845,7 +845,7 @@ opts = {
 }
 
 begin
-  # Modify servers
+  # Modify a Server by ID
   result = api_instance.datacenters_servers_put(datacenter_id, server_id, server, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -861,7 +861,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Modify servers
+  # Modify a Server by ID
   data, status_code, headers = api_instance.datacenters_servers_put_with_http_info(datacenter_id, server_id, server, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -877,7 +877,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **datacenter_id** | **String** | The unique ID of the data center. |  |
 | **server_id** | **String** | The unique ID of the server. |  |
-| **server** | [**Server**](Server.md) | The modified server |  |
+| **server** | [**Server**](../models/Server.md) | The modified server |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |
@@ -1069,9 +1069,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_resume_post(datacenter_id, server_id, opts)
 
-Resume Cubes instances
+Resume a Cube Server by ID
 
-Resume a suspended Cube instance; no billing event will be generated.  This operation is only supported for the Cubes.
+Resumes a suspended Cube Server specified by its ID.  Since the suspended instance was not deleted the allocated resources continue to be billed. You can perform this operation only for Cube Servers.  To check the status of the request, you can use the 'Location' HTTP header in the response (see 'Requests' for more information).
 
 ### Examples
 
@@ -1100,7 +1100,7 @@ opts = {
 }
 
 begin
-  # Resume Cubes instances
+  # Resume a Cube Server by ID
   api_instance.datacenters_servers_resume_post(datacenter_id, server_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_resume_post: #{e}"
@@ -1115,7 +1115,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Resume Cubes instances
+  # Resume a Cube Server by ID
   data, status_code, headers = api_instance.datacenters_servers_resume_post_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1153,9 +1153,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_start_post(datacenter_id, server_id, opts)
 
-Start servers
+Start an Enterprise Server by ID
 
-Start the specified server within the data center; if the server's public IP address has been deallocated, a new IP address will be assigned.
+Starts the Enterprise Server specified by its ID.  >Note that you cannot use this method to start a Cube Server.  By starting the Enterprise Server, cores and RAM are provisioned, and the billing continues.  If the server's public IPv4 address has been deallocated, a new IPv4 address will be assigned. IPv6 blocks and addresses will remain unchanged when stopping and starting a server.  To check the status of the request, you can use the 'Location' HTTP header in the response (see 'Requests' for more information).
 
 ### Examples
 
@@ -1184,7 +1184,7 @@ opts = {
 }
 
 begin
-  # Start servers
+  # Start an Enterprise Server by ID
   api_instance.datacenters_servers_start_post(datacenter_id, server_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_start_post: #{e}"
@@ -1199,7 +1199,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Start servers
+  # Start an Enterprise Server by ID
   data, status_code, headers = api_instance.datacenters_servers_start_post_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1237,9 +1237,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_stop_post(datacenter_id, server_id, opts)
 
-Stop VMs
+Stop an Enterprise Server by ID
 
-Stop the specified server within the data center: the VM will be forcefully shut down, the billing will cease, and any allocated public IPs will be deallocated.  This operation is not supported for the Cubes.
+Stops the Enterprise Server specified by its ID.   >Note that you cannot use this method to stop a Cube Server.   By stopping the Enterprise Server, cores and RAM are freed and no longer charged.  Public IPv4 IPs that are not reserved are returned to the IPv4 pool. IPv6 blocks and addresses will remain unchanged when stopping and starting a server.  To check the status of the request, you can use the 'Location' HTTP header in the response (see 'Requests' for more information).
 
 ### Examples
 
@@ -1268,7 +1268,7 @@ opts = {
 }
 
 begin
-  # Stop VMs
+  # Stop an Enterprise Server by ID
   api_instance.datacenters_servers_stop_post(datacenter_id, server_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_stop_post: #{e}"
@@ -1283,7 +1283,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Stop VMs
+  # Stop an Enterprise Server by ID
   data, status_code, headers = api_instance.datacenters_servers_stop_post_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1321,9 +1321,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_suspend_post(datacenter_id, server_id, opts)
 
-Suspend Cubes instances
+Suspend a Cube Server by ID
 
-Suspend the specified Cubes instance within the data center. The instance will not be deleted, and allocated resources will continue to be billed.  This operation is only supported for the Cubes.
+Suspends the specified Cubes instance within the data center.   The instance is not deleted and allocated resources continue to be billed. You can perform this operation only for Cube Servers.  To check the status of the request, you can use the 'Location' HTTP header in the response (see 'Requests' for more information).
 
 ### Examples
 
@@ -1352,7 +1352,7 @@ opts = {
 }
 
 begin
-  # Suspend Cubes instances
+  # Suspend a Cube Server by ID
   api_instance.datacenters_servers_suspend_post(datacenter_id, server_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_suspend_post: #{e}"
@@ -1367,7 +1367,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Suspend Cubes instances
+  # Suspend a Cube Server by ID
   data, status_code, headers = api_instance.datacenters_servers_suspend_post_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1490,9 +1490,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_upgrade_post(datacenter_id, server_id, opts)
 
-Upgrade servers
+Upgrade a Server by ID
 
-Upgrade the server version, if needed. To determine if an upgrade is available, execute  the following call:  '/datacenters/{datacenterId}/servers?upgradeNeeded=true'
+Upgrades the server version.
 
 ### Examples
 
@@ -1521,7 +1521,7 @@ opts = {
 }
 
 begin
-  # Upgrade servers
+  # Upgrade a Server by ID
   api_instance.datacenters_servers_upgrade_post(datacenter_id, server_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_upgrade_post: #{e}"
@@ -1536,7 +1536,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Upgrade servers
+  # Upgrade a Server by ID
   data, status_code, headers = api_instance.datacenters_servers_upgrade_post_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1574,9 +1574,9 @@ Basic Authentication, Token Authentication
 
 > datacenters_servers_volumes_delete(datacenter_id, server_id, volume_id, opts)
 
-Detach volumes
+Detach a Volume by ID
 
-Detach the specified volume from the server without deleting it from the data center. A separate request must be made to perform the deletion.
+Detachs the specified volume from the server.  Note that only the volume's connection to the specified server is disconnected. If you want to delete the volume, you must submit a separate request to perform the deletion.
 
 ### Examples
 
@@ -1606,7 +1606,7 @@ opts = {
 }
 
 begin
-  # Detach volumes
+  # Detach a Volume by ID
   api_instance.datacenters_servers_volumes_delete(datacenter_id, server_id, volume_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling ServersApi->datacenters_servers_volumes_delete: #{e}"
@@ -1621,7 +1621,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Detach volumes
+  # Detach a Volume by ID
   data, status_code, headers = api_instance.datacenters_servers_volumes_delete_with_http_info(datacenter_id, server_id, volume_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1660,9 +1660,9 @@ Basic Authentication, Token Authentication
 
 > <Volume> datacenters_servers_volumes_find_by_id(datacenter_id, server_id, volume_id, opts)
 
-Retrieve attached volumes
+Get Attached Volume by ID
 
-Retrieve the properties of the volume, attached to the specified server.
+Retrieves the properties of the volume attached to the specified server.
 
 ### Examples
 
@@ -1692,7 +1692,7 @@ opts = {
 }
 
 begin
-  # Retrieve attached volumes
+  # Get Attached Volume by ID
   result = api_instance.datacenters_servers_volumes_find_by_id(datacenter_id, server_id, volume_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1708,7 +1708,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve attached volumes
+  # Get Attached Volume by ID
   data, status_code, headers = api_instance.datacenters_servers_volumes_find_by_id_with_http_info(datacenter_id, server_id, volume_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1747,9 +1747,9 @@ Basic Authentication, Token Authentication
 
 > <AttachedVolumes> datacenters_servers_volumes_get(datacenter_id, server_id, opts)
 
-List attached volumes
+Get Attached Volumes
 
-List all volumes, attached to the specified server.
+Lists all volumes attached to the specified server.
 
 ### Examples
 
@@ -1780,7 +1780,7 @@ opts = {
 }
 
 begin
-  # List attached volumes
+  # Get Attached Volumes
   result = api_instance.datacenters_servers_volumes_get(datacenter_id, server_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1796,7 +1796,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List attached volumes
+  # Get Attached Volumes
   data, status_code, headers = api_instance.datacenters_servers_volumes_get_with_http_info(datacenter_id, server_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1836,9 +1836,9 @@ Basic Authentication, Token Authentication
 
 > <Volume> datacenters_servers_volumes_post(datacenter_id, server_id, volume, opts)
 
-Attach volumes
+Attach a Volume to a Server
 
-Attach an existing storage volume to the specified server.  A volume scan also be created and attached in one step by providing the new volume description as payload.  The combined total of attached volumes and NICs cannot exceed 24 per server.
+Attachs an existing storage volume to the specified server.  You can attach an existing volume in the VDC to a server. To move a volume from one server to another, you must first detach the volume from the first server and attach it to the second server.  It is also possible to create and attach a volume in one step by simply providing a new volume description as a payload. The only difference is the URL; see 'Creating a Volume' for details about volumes.  Note that the combined total of attached volumes and NICs cannot exceed 24 per server.
 
 ### Examples
 
@@ -1868,7 +1868,7 @@ opts = {
 }
 
 begin
-  # Attach volumes
+  # Attach a Volume to a Server
   result = api_instance.datacenters_servers_volumes_post(datacenter_id, server_id, volume, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1884,7 +1884,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Attach volumes
+  # Attach a Volume to a Server
   data, status_code, headers = api_instance.datacenters_servers_volumes_post_with_http_info(datacenter_id, server_id, volume, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1900,7 +1900,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **datacenter_id** | **String** | The unique ID of the data center. |  |
 | **server_id** | **String** | The unique ID of the server. |  |
-| **volume** | [**Volume**](Volume.md) | The volume to be attached (or created and attached). |  |
+| **volume** | [**Volume**](../models/Volume.md) | The volume to be attached (or created and attached). |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |

data/docs/api/SnapshotsApi.md

@@ -8,7 +8,7 @@ All URIs are relative to *https://api.ionos.com/cloudapi/v6*
 | [**snapshots_find_by_id**](SnapshotsApi.md#snapshots_find_by_id) | **GET** /snapshots/{snapshotId} | Retrieve snapshots by ID |
 | [**snapshots_get**](SnapshotsApi.md#snapshots_get) | **GET** /snapshots | List snapshots |
 | [**snapshots_patch**](SnapshotsApi.md#snapshots_patch) | **PATCH** /snapshots/{snapshotId} | Partially modify snapshots |
-| [**snapshots_put**](SnapshotsApi.md#snapshots_put) | **PUT** /snapshots/{snapshotId} | Modify snapshots |
+| [**snapshots_put**](SnapshotsApi.md#snapshots_put) | **PUT** /snapshots/{snapshotId} | Modify a Snapshot by ID |
 
 
 ## snapshots_delete
@@ -323,7 +323,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **snapshot_id** | **String** | The unique ID of the snapshot. |  |
-| **snapshot** | [**SnapshotProperties**](SnapshotProperties.md) | The properties of the snapshot to be updated. |  |
+| **snapshot** | [**SnapshotProperties**](../models/SnapshotProperties.md) | The properties of the snapshot to be updated. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |
@@ -346,9 +346,9 @@ Basic Authentication, Token Authentication
 
 > <Snapshot> snapshots_put(snapshot_id, snapshot, opts)
 
-Modify snapshots
+Modify a Snapshot by ID
 
-Modify the properties of the specified snapshot.
+Modifies the properties of the specified snapshot.
 
 ### Examples
 
@@ -377,7 +377,7 @@ opts = {
 }
 
 begin
-  # Modify snapshots
+  # Modify a Snapshot by ID
   result = api_instance.snapshots_put(snapshot_id, snapshot, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -393,7 +393,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Modify snapshots
+  # Modify a Snapshot by ID
   data, status_code, headers = api_instance.snapshots_put_with_http_info(snapshot_id, snapshot, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -408,7 +408,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **snapshot_id** | **String** | The unique ID of the snapshot. |  |
-| **snapshot** | [**Snapshot**](Snapshot.md) | The modified snapshot |  |
+| **snapshot** | [**Snapshot**](../models/Snapshot.md) | The modified snapshot |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, for which all API requests are to be executed. | [optional] |