ionoscloud 6.0.0.beta.4 → 6.0.0

data/lib/ionoscloud/api/user_management_api.rb

@@ -3,7 +3,7 @@
 
 #IONOS Enterprise-grade Infrastructure as a Service (IaaS) solutions can be managed through the Cloud API, in addition or as an alternative to the \"Data Center Designer\" (DCD) browser-based tool.    Both methods employ consistent concepts and features, deliver similar power and flexibility, and can be used to perform a multitude of management tasks, including adding servers, volumes, configuring networks, and so on.
 
-The version of the OpenAPI document: 6.0-SDK.3
+The version of the OpenAPI document: 6.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.2.1-SNAPSHOT
@@ -19,9 +19,9 @@ module Ionoscloud
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Delete a Group
-    # Delete a group
-    # @param group_id [String] The unique ID of the group
+    # Delete groups
+    # Remove the specified group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -32,9 +32,9 @@ module Ionoscloud
       nil
     end
 
-    # Delete a Group
-    # Delete a group
-    # @param group_id [String] The unique ID of the group
+    # Delete groups
+    # Remove the specified group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -99,9 +99,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a Group
-    # You can retrieve a group by using the group ID. This value can be found in the response body when a group is created or when you GET a list of groups.
-    # @param group_id [String] The unique ID of the group
+    # Retrieve groups
+    # Retrieve a group by the group ID. This value is in the response body when the group is created, and in the list of the groups, returned by GET.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -112,9 +112,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a Group
-    # You can retrieve a group by using the group ID. This value can be found in the response body when a group is created or when you GET a list of groups.
-    # @param group_id [String] The unique ID of the group
+    # Retrieve groups
+    # Retrieve a group by the group ID. This value is in the response body when the group is created, and in the list of the groups, returned by GET.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -179,8 +179,8 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # List All Groups.
-    # You can retrieve a complete list of all groups that you have access to
+    # List all groups
+    # List all the available user groups.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -191,8 +191,8 @@ module Ionoscloud
       data
     end
 
-    # List All Groups.
-    # You can retrieve a complete list of all groups that you have access to
+    # List all groups
+    # List all the available user groups.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -253,9 +253,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Create a Group
-    # You can use this POST method to create a group
-    # @param group [Group] Group to be created
+    # Create groups
+    # Create a group.
+    # @param group [Group] The group to create.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -266,9 +266,9 @@ module Ionoscloud
       data
     end
 
-    # Create a Group
-    # You can use this POST method to create a group
-    # @param group [Group] Group to be created
+    # Create groups
+    # Create a group.
+    # @param group [Group] The group to create.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -335,10 +335,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Modify a group
-    # You can use this method to update properties of the group.
-    # @param group_id [String] The unique ID of the group
-    # @param group [Group] Modified properties of the Group
+    # Modify groups
+    # Modify the properties of the specified group.
+    # @param group_id [String] The unique ID of the group.
+    # @param group [Group] The modified group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -349,10 +349,10 @@ module Ionoscloud
       data
     end
 
-    # Modify a group
-    # You can use this method to update properties of the group.
-    # @param group_id [String] The unique ID of the group
-    # @param group [Group] Modified properties of the Group
+    # Modify groups
+    # Modify the properties of the specified group.
+    # @param group_id [String] The unique ID of the group.
+    # @param group [Group] The modified group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -423,8 +423,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve resources assigned to a group
-    # @param group_id [String] The unique ID of the group
+    # Retrieve group resources
+    # List the resources assigned to the group, by group ID.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -435,8 +436,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve resources assigned to a group
-    # @param group_id [String] The unique ID of the group
+    # Retrieve group resources
+    # List the resources assigned to the group, by group ID.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -501,10 +503,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Remove a resource from a group
-    # This will remove a resource from a group
-    # @param group_id [String] 
-    # @param resource_id [String] 
+    # Remove group shares
+    # Remove the specified share from the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -515,10 +517,10 @@ module Ionoscloud
       nil
     end
 
-    # Remove a resource from a group
-    # This will remove a resource from a group
-    # @param group_id [String] 
-    # @param resource_id [String] 
+    # Remove group shares
+    # Remove the specified share from the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -587,10 +589,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a group share
-    # This will retrieve the properties of a group share.
-    # @param group_id [String] 
-    # @param resource_id [String] 
+    # Retrieve group shares
+    # Retrieve the properties of the specified group share.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -601,10 +603,10 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a group share
-    # This will retrieve the properties of a group share.
-    # @param group_id [String] 
-    # @param resource_id [String] 
+    # Retrieve group shares
+    # Retrieve the properties of the specified group share.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -673,9 +675,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # List Group Shares 
-    # You can retrieve a list of all resources along with their permissions of the group
-    # @param group_id [String] 
+    # List group shares 
+    # List all shares and share privileges for the specified group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -686,9 +688,9 @@ module Ionoscloud
       data
     end
 
-    # List Group Shares 
-    # You can retrieve a list of all resources along with their permissions of the group
-    # @param group_id [String] 
+    # List group shares 
+    # List all shares and share privileges for the specified group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -753,11 +755,11 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Add a resource to a group
-    # This will add a resource to the group. 
-    # @param group_id [String] 
-    # @param resource_id [String] 
-    # @param resource [GroupShare] Resource to be added
+    # Add group shares
+    # Add the specified share to the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
+    # @param resource [GroupShare] The resource to add.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -768,11 +770,11 @@ module Ionoscloud
       data
     end
 
-    # Add a resource to a group
-    # This will add a resource to the group. 
-    # @param group_id [String] 
-    # @param resource_id [String] 
-    # @param resource [GroupShare] Resource to be added
+    # Add group shares
+    # Add the specified share to the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
+    # @param resource [GroupShare] The resource to add.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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,11 +847,11 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Modify resource permissions of a group
-    # You can use update resource permissions of a group. If empty body will be provided, no updates will happen, instead you will be returned the current permissions of resource in a group. In this case response code will be 200
-    # @param group_id [String] 
-    # @param resource_id [String] 
-    # @param resource [GroupShare] Modified Resource
+    # Modify group share privileges
+    # Modify share permissions for the specified group. With an empty body, no updates are performed, and the current share permissions for the group are returned with response code 200.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
+    # @param resource [GroupShare] The modified resource
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -860,11 +862,11 @@ module Ionoscloud
       data
     end
 
-    # Modify resource permissions of a group
-    # You can use update resource permissions of a group. If empty body will be provided, no updates will happen, instead you will be returned the current permissions of resource in a group. In this case response code will be 200
-    # @param group_id [String] 
-    # @param resource_id [String] 
-    # @param resource [GroupShare] Modified Resource
+    # Modify group share privileges
+    # Modify share permissions for the specified group. With an empty body, no updates are performed, and the current share permissions for the group are returned with response code 200.
+    # @param group_id [String] The unique ID of the group.
+    # @param resource_id [String] The unique ID of the resource.
+    # @param resource [GroupShare] The modified resource
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -939,10 +941,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Remove a user from a group
-    # This will remove a user from a group.
-    # @param group_id [String] 
-    # @param user_id [String] 
+    # Remove users from groups
+    # Remove the specified user from the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -953,10 +955,10 @@ module Ionoscloud
       nil
     end
 
-    # Remove a user from a group
-    # This will remove a user from a group.
-    # @param group_id [String] 
-    # @param user_id [String] 
+    # Remove users from groups
+    # Remove the specified user from the group.
+    # @param group_id [String] The unique ID of the group.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1025,9 +1027,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # List Group Members 
-    # You can retrieve a list of users who are members of the group
-    # @param group_id [String] 
+    # List group members
+    # List all members of the specified user group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1038,9 +1040,9 @@ module Ionoscloud
       data
     end
 
-    # List Group Members 
-    # You can retrieve a list of users who are members of the group
-    # @param group_id [String] 
+    # List group members
+    # List all members of the specified user group.
+    # @param group_id [String] The unique ID of the group.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1105,10 +1107,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Add a user to a group
-    # This will attach a pre-existing user to a group. 
-    # @param group_id [String] 
-    # @param user [User] User to be added
+    # Add group members
+    # Add an existing user to the specified group. 
+    # @param group_id [String] The unique ID of the group.
+    # @param user [User] The user to add.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1119,10 +1121,10 @@ module Ionoscloud
       data
     end
 
-    # Add a user to a group
-    # This will attach a pre-existing user to a group. 
-    # @param group_id [String] 
-    # @param user [User] User to be added
+    # Add group members
+    # Add an existing user to the specified group. 
+    # @param group_id [String] The unique ID of the group.
+    # @param user [User] The user to add.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1193,9 +1195,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a list of Resources by type.
-    # You can retrieve a list of resources by using the type. Allowed values are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. This value of resource type also be found in the response body when you GET a list of all resources.
-    # @param resource_type [String] The resource Type
+    # List resources by type
+    # List all resources of the specified type.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
+    # @param resource_type [String] The resource type
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1206,9 +1208,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a list of Resources by type.
-    # You can retrieve a list of resources by using the type. Allowed values are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. This value of resource type also be found in the response body when you GET a list of all resources.
-    # @param resource_type [String] The resource Type
+    # List resources by type
+    # List all resources of the specified type.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
+    # @param resource_type [String] The resource type
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1273,10 +1275,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a Resource by type.
-    # You can retrieve a resource by using the type and its uuid. Allowed values for types are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. The value of resource type can also be found in the response body when you GET a list of all resources.
-    # @param resource_type [String] The resource Type
-    # @param resource_id [String] The resource Uuid
+    # Retrieve resources by type
+    # Retrieve a resource by the resource type and resource ID.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
+    # @param resource_type [String] The resource type
+    # @param resource_id [String] The resource ID
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1287,10 +1289,10 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a Resource by type.
-    # You can retrieve a resource by using the type and its uuid. Allowed values for types are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. The value of resource type can also be found in the response body when you GET a list of all resources.
-    # @param resource_type [String] The resource Type
-    # @param resource_id [String] The resource Uuid
+    # Retrieve resources by type
+    # Retrieve a resource by the resource type and resource ID.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
+    # @param resource_type [String] The resource type
+    # @param resource_id [String] The resource ID
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1359,8 +1361,8 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # List All Resources.
-    # You can retrieve a complete list of all resources that you have access to.
+    # List all resources
+    # List all the available resources.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1371,8 +1373,8 @@ module Ionoscloud
       data
     end
 
-    # List All Resources.
-    # You can retrieve a complete list of all resources that you have access to.
+    # List all resources
+    # List all the available resources.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1433,9 +1435,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Delete a User
-    # Delete a user
-    # @param user_id [String] The unique ID of the user
+    # Delete users
+    # Delete the specified user.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1446,9 +1448,9 @@ module Ionoscloud
       nil
     end
 
-    # Delete a User
-    # Delete a user
-    # @param user_id [String] The unique ID of the user
+    # Delete users
+    # Delete the specified user.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1513,9 +1515,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a User
-    # You can retrieve user details by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve users
+    # Retrieve user properties by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1526,9 +1528,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a User
-    # You can retrieve user details by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve users
+    # Retrieve user properties by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1593,28 +1595,28 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # List all Users 
-    # You can retrieve a complete list of users under your account
+    # List all users 
+    # List all the users in your account.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
     # @option opts [Integer] :x_contract_number Users with multiple contracts must provide the contract number, against which all API requests are to be executed.
     # @option opts [Integer] :offset The first element (from the complete list of the elements) to include in the response (use together with limit for pagination). (default to 0)
-    # @option opts [Integer] :limit the maximum number of elements to return (use together with <code>offset</code> for pagination) (default to 100)
+    # @option opts [Integer] :limit The maximum number of elements to return (use together with <code>offset</code> for pagination). (default to 100)
     # @return [Users]
     def um_users_get(opts = {})
       data, _status_code, _headers = um_users_get_with_http_info(opts)
       data
     end
 
-    # List all Users 
-    # You can retrieve a complete list of users under your account
+    # List all users 
+    # List all the users in your account.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
     # @option opts [Integer] :x_contract_number Users with multiple contracts must provide the contract number, against which all API requests are to be executed.
     # @option opts [Integer] :offset The first element (from the complete list of the elements) to include in the response (use together with limit for pagination).
-    # @option opts [Integer] :limit the maximum number of elements to return (use together with <code>offset</code> for pagination)
+    # @option opts [Integer] :limit The maximum number of elements to return (use together with <code>offset</code> for pagination).
     # @return [Array<(Users, Integer, Hash)>] Users data, response status code and response headers
     def um_users_get_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -1685,9 +1687,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a User's group resources
-    # You can retrieve group resources of user by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve group resources by user ID
+    # Retrieve group resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1698,9 +1700,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a User&#39;s group resources
-    # You can retrieve group resources of user by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve group resources by user ID
+    # Retrieve group resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1765,9 +1767,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Retrieve a User's own resources
-    # You can retrieve resources owned by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve user resources by user ID
+    # Retrieve own resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1778,9 +1780,9 @@ module Ionoscloud
       data
     end
 
-    # Retrieve a User&#39;s own resources
-    # You can retrieve resources owned by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
-    # @param user_id [String] The unique ID of the user
+    # Retrieve user resources by user ID
+    # Retrieve own resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
+    # @param user_id [String] The unique ID of the user.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1845,9 +1847,9 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Create a user
-    # You can use this POST method to create a user
-    # @param user [UserPost] User to be created
+    # Create users
+    # Create a user.
+    # @param user [UserPost] The user to create.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1858,9 +1860,9 @@ module Ionoscloud
       data
     end
 
-    # Create a user
-    # You can use this POST method to create a user
-    # @param user [UserPost] User to be created
+    # Create users
+    # Create a user.
+    # @param user [UserPost] The user to create.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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
@@ -1927,10 +1929,10 @@ module Ionoscloud
       return data, status_code, headers
     end
 
-    # Modify a user
-    # You can use update attributes of a User
-    # @param user_id [String] 
-    # @param user [UserPut] Modified user
+    # Modify users
+    # Modify the properties of the specified user.
+    # @param user_id [String] The unique ID of the user.
+    # @param user [UserPut] The modified user
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines). (default to true)
     # @option opts [Integer] :depth 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 (default to 0)
@@ -1941,10 +1943,10 @@ module Ionoscloud
       data
     end
 
-    # Modify a user
-    # You can use update attributes of a User
-    # @param user_id [String] 
-    # @param user [UserPut] Modified user
+    # Modify users
+    # Modify the properties of the specified user.
+    # @param user_id [String] The unique ID of the user.
+    # @param user [UserPut] The modified user
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :pretty Controls whether the response is pretty-printed (with indentations and new lines).
     # @option opts [Integer] :depth 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