pulpcore_client 3.16.24 → 3.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +70 -22
  3. data/docs/AccessPoliciesApi.md +53 -0
  4. data/docs/AccessPolicy.md +3 -1
  5. data/docs/AccessPolicyResponse.md +3 -1
  6. data/docs/ContentguardsRbacApi.md +138 -22
  7. data/docs/GroupRole.md +19 -0
  8. data/docs/GroupRoleResponse.md +23 -0
  9. data/docs/GroupsApi.md +248 -20
  10. data/docs/GroupsModelPermissionsApi.md +20 -20
  11. data/docs/GroupsObjectPermissionsApi.md +20 -20
  12. data/docs/GroupsRolesApi.md +255 -0
  13. data/docs/GroupsUsersApi.md +15 -15
  14. data/docs/MyPermissionsResponse.md +17 -0
  15. data/docs/NestedRole.md +21 -0
  16. data/docs/NestedRoleResponse.md +21 -0
  17. data/docs/ObjectRolesResponse.md +17 -0
  18. data/docs/PaginatedGroupRoleResponseList.md +23 -0
  19. data/docs/PaginatedRoleResponseList.md +23 -0
  20. data/docs/PaginatedUserRoleResponseList.md +23 -0
  21. data/docs/PatchedAccessPolicy.md +3 -1
  22. data/docs/PatchedRole.md +21 -0
  23. data/docs/PatchedUser.md +29 -0
  24. data/docs/PermissionResponse.md +1 -1
  25. data/docs/Purge.md +19 -0
  26. data/docs/Role.md +21 -0
  27. data/docs/RoleResponse.md +27 -0
  28. data/docs/RolesApi.md +363 -0
  29. data/docs/StatesEnum.md +16 -0
  30. data/docs/TasksApi.md +282 -0
  31. data/docs/User.md +29 -0
  32. data/docs/UserGroup.md +17 -0
  33. data/docs/UserResponse.md +3 -3
  34. data/docs/UserRole.md +19 -0
  35. data/docs/UserRoleResponse.md +23 -0
  36. data/docs/UsersApi.md +219 -0
  37. data/docs/UsersRolesApi.md +255 -0
  38. data/docs/WorkerResponse.md +3 -3
  39. data/git_push.sh +58 -0
  40. data/lib/pulpcore_client/api/access_policies_api.rb +60 -0
  41. data/lib/pulpcore_client/api/artifacts_api.rb +24 -0
  42. data/lib/pulpcore_client/api/contentguards_rbac_api.rb +168 -40
  43. data/lib/pulpcore_client/api/groups_api.rb +304 -36
  44. data/lib/pulpcore_client/api/groups_model_permissions_api.rb +36 -36
  45. data/lib/pulpcore_client/api/groups_object_permissions_api.rb +36 -36
  46. data/lib/pulpcore_client/api/groups_roles_api.rb +315 -0
  47. data/lib/pulpcore_client/api/groups_users_api.rb +27 -27
  48. data/lib/pulpcore_client/api/roles_api.rb +443 -0
  49. data/lib/pulpcore_client/api/tasks_api.rb +332 -0
  50. data/lib/pulpcore_client/api/uploads_api.rb +4 -0
  51. data/lib/pulpcore_client/api/users_api.rb +264 -0
  52. data/lib/pulpcore_client/api/users_roles_api.rb +315 -0
  53. data/lib/pulpcore_client/api_client.rb +5 -2
  54. data/lib/pulpcore_client/configuration.rb +0 -1
  55. data/lib/pulpcore_client/models/access_policy.rb +19 -2
  56. data/lib/pulpcore_client/models/access_policy_response.rb +19 -2
  57. data/lib/pulpcore_client/models/artifact.rb +90 -0
  58. data/lib/pulpcore_client/models/filesystem_exporter.rb +38 -0
  59. data/lib/pulpcore_client/models/group.rb +9 -0
  60. data/lib/pulpcore_client/models/group_role.rb +238 -0
  61. data/lib/pulpcore_client/models/group_role_response.rb +242 -0
  62. data/lib/pulpcore_client/models/group_user.rb +9 -0
  63. data/lib/pulpcore_client/models/{rbac_content_guard_permission.rb → my_permissions_response.rb} +16 -22
  64. data/lib/pulpcore_client/models/nested_role.rb +234 -0
  65. data/lib/pulpcore_client/models/nested_role_response.rb +234 -0
  66. data/lib/pulpcore_client/models/object_roles_response.rb +213 -0
  67. data/lib/pulpcore_client/models/paginated_group_role_response_list.rb +237 -0
  68. data/lib/pulpcore_client/models/paginated_role_response_list.rb +237 -0
  69. data/lib/pulpcore_client/models/paginated_user_role_response_list.rb +237 -0
  70. data/lib/pulpcore_client/models/patched_access_policy.rb +14 -2
  71. data/lib/pulpcore_client/models/patched_filesystem_exporter.rb +30 -0
  72. data/lib/pulpcore_client/models/patched_group.rb +9 -0
  73. data/lib/pulpcore_client/models/patched_pulp_exporter.rb +30 -0
  74. data/lib/pulpcore_client/models/patched_pulp_importer.rb +15 -0
  75. data/lib/pulpcore_client/models/patched_rbac_content_guard.rb +30 -0
  76. data/lib/pulpcore_client/models/patched_role.rb +261 -0
  77. data/lib/pulpcore_client/models/patched_task_cancel.rb +15 -0
  78. data/lib/pulpcore_client/models/patched_user.rb +342 -0
  79. data/lib/pulpcore_client/models/permission_response.rb +1 -1
  80. data/lib/pulpcore_client/models/pulp_export.rb +15 -0
  81. data/lib/pulpcore_client/models/pulp_exporter.rb +38 -0
  82. data/lib/pulpcore_client/models/pulp_import.rb +30 -0
  83. data/lib/pulpcore_client/models/pulp_import_check.rb +45 -0
  84. data/lib/pulpcore_client/models/pulp_importer.rb +19 -0
  85. data/lib/pulpcore_client/models/purge.rb +219 -0
  86. data/lib/pulpcore_client/models/rbac_content_guard.rb +34 -0
  87. data/lib/pulpcore_client/models/role.rb +275 -0
  88. data/lib/pulpcore_client/models/role_response.rb +270 -0
  89. data/lib/pulpcore_client/models/states_enum.rb +38 -0
  90. data/lib/pulpcore_client/models/upload_chunk.rb +15 -0
  91. data/lib/pulpcore_client/models/upload_commit.rb +19 -0
  92. data/lib/pulpcore_client/models/user.rb +351 -0
  93. data/lib/pulpcore_client/models/user_group.rb +241 -0
  94. data/lib/pulpcore_client/models/user_response.rb +6 -29
  95. data/lib/pulpcore_client/models/user_role.rb +238 -0
  96. data/lib/pulpcore_client/models/user_role_response.rb +242 -0
  97. data/lib/pulpcore_client/models/worker_response.rb +10 -10
  98. data/lib/pulpcore_client/version.rb +1 -1
  99. data/lib/pulpcore_client.rb +22 -1
  100. data/pulpcore_client.gemspec +3 -3
  101. data/spec/api/access_policies_api_spec.rb +11 -0
  102. data/spec/api/contentguards_rbac_api_spec.rb +36 -12
  103. data/spec/api/groups_api_spec.rb +54 -4
  104. data/spec/api/groups_model_permissions_api_spec.rb +4 -4
  105. data/spec/api/groups_object_permissions_api_spec.rb +4 -4
  106. data/spec/api/groups_roles_api_spec.rb +97 -0
  107. data/spec/api/groups_users_api_spec.rb +3 -3
  108. data/spec/api/roles_api_spec.rb +121 -0
  109. data/spec/api/tasks_api_spec.rb +62 -0
  110. data/spec/api/users_api_spec.rb +50 -0
  111. data/spec/api/users_roles_api_spec.rb +97 -0
  112. data/spec/models/access_policy_response_spec.rb +6 -0
  113. data/spec/models/access_policy_spec.rb +6 -0
  114. data/spec/models/group_role_response_spec.rb +59 -0
  115. data/spec/models/{rbac_content_guard_permission_spec.rb → group_role_spec.rb} +8 -8
  116. data/spec/models/my_permissions_response_spec.rb +41 -0
  117. data/spec/models/nested_role_response_spec.rb +53 -0
  118. data/spec/models/nested_role_spec.rb +53 -0
  119. data/spec/models/object_roles_response_spec.rb +41 -0
  120. data/spec/models/paginated_group_role_response_list_spec.rb +59 -0
  121. data/spec/models/paginated_role_response_list_spec.rb +59 -0
  122. data/spec/models/paginated_user_role_response_list_spec.rb +59 -0
  123. data/spec/models/patched_access_policy_spec.rb +6 -0
  124. data/spec/models/patched_role_spec.rb +53 -0
  125. data/spec/models/patched_user_spec.rb +77 -0
  126. data/spec/models/purge_spec.rb +47 -0
  127. data/spec/models/role_response_spec.rb +71 -0
  128. data/spec/models/role_spec.rb +53 -0
  129. data/spec/models/states_enum_spec.rb +35 -0
  130. data/spec/models/user_group_spec.rb +41 -0
  131. data/spec/models/user_role_response_spec.rb +59 -0
  132. data/spec/models/user_role_spec.rb +47 -0
  133. data/spec/models/user_spec.rb +77 -0
  134. data/spec/models/worker_response_spec.rb +2 -2
  135. metadata +190 -111
  136. data/docs/RBACContentGuardPermission.md +0 -19
@@ -0,0 +1,443 @@
1
+ =begin
2
+ #Pulp 3 API
3
+
4
+ #Fetch, Upload, Organize, and Distribute Software Packages
5
+
6
+ The version of the OpenAPI document: v3
7
+ Contact: pulp-list@redhat.com
8
+ Generated by: https://openapi-generator.tech
9
+ OpenAPI Generator version: 4.3.1
10
+
11
+ =end
12
+
13
+ require 'cgi'
14
+
15
+ module PulpcoreClient
16
+ class RolesApi
17
+ attr_accessor :api_client
18
+
19
+ def initialize(api_client = ApiClient.default)
20
+ @api_client = api_client
21
+ end
22
+ # Create a role
23
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
24
+ # @param role [Role]
25
+ # @param [Hash] opts the optional parameters
26
+ # @return [RoleResponse]
27
+ def create(role, opts = {})
28
+ data, _status_code, _headers = create_with_http_info(role, opts)
29
+ data
30
+ end
31
+
32
+ # Create a role
33
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
34
+ # @param role [Role]
35
+ # @param [Hash] opts the optional parameters
36
+ # @return [Array<(RoleResponse, Integer, Hash)>] RoleResponse data, response status code and response headers
37
+ def create_with_http_info(role, opts = {})
38
+ if @api_client.config.debugging
39
+ @api_client.config.logger.debug 'Calling API: RolesApi.create ...'
40
+ end
41
+ # verify the required parameter 'role' is set
42
+ if @api_client.config.client_side_validation && role.nil?
43
+ fail ArgumentError, "Missing the required parameter 'role' when calling RolesApi.create"
44
+ end
45
+ # resource path
46
+ local_var_path = '/pulp/api/v3/roles/'
47
+
48
+ # query parameters
49
+ query_params = opts[:query_params] || {}
50
+
51
+ # header parameters
52
+ header_params = opts[:header_params] || {}
53
+ # HTTP header 'Accept' (if needed)
54
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
55
+ # HTTP header 'Content-Type'
56
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'])
57
+
58
+ # form parameters
59
+ form_params = opts[:form_params] || {}
60
+
61
+ # http body (model)
62
+ post_body = opts[:body] || @api_client.object_to_http_body(role)
63
+
64
+ # return_type
65
+ return_type = opts[:return_type] || 'RoleResponse'
66
+
67
+ # auth_names
68
+ auth_names = opts[:auth_names] || ['basicAuth']
69
+
70
+ new_options = opts.merge(
71
+ :header_params => header_params,
72
+ :query_params => query_params,
73
+ :form_params => form_params,
74
+ :body => post_body,
75
+ :auth_names => auth_names,
76
+ :return_type => return_type
77
+ )
78
+
79
+ data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
80
+ if @api_client.config.debugging
81
+ @api_client.config.logger.debug "API called: RolesApi#create\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
82
+ end
83
+ return data, status_code, headers
84
+ end
85
+
86
+ # Delete a role
87
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
88
+ # @param role_href [String]
89
+ # @param [Hash] opts the optional parameters
90
+ # @return [nil]
91
+ def delete(role_href, opts = {})
92
+ delete_with_http_info(role_href, opts)
93
+ nil
94
+ end
95
+
96
+ # Delete a role
97
+ # ViewSet for Role. NOTE: This API endpoint is in \&quot;tech preview\&quot; and subject to change
98
+ # @param role_href [String]
99
+ # @param [Hash] opts the optional parameters
100
+ # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
101
+ def delete_with_http_info(role_href, opts = {})
102
+ if @api_client.config.debugging
103
+ @api_client.config.logger.debug 'Calling API: RolesApi.delete ...'
104
+ end
105
+ # verify the required parameter 'role_href' is set
106
+ if @api_client.config.client_side_validation && role_href.nil?
107
+ fail ArgumentError, "Missing the required parameter 'role_href' when calling RolesApi.delete"
108
+ end
109
+ # resource path
110
+ local_var_path = '{role_href}'.sub('{' + 'role_href' + '}', CGI.escape(role_href.to_s).gsub('%2F', '/'))
111
+
112
+ # query parameters
113
+ query_params = opts[:query_params] || {}
114
+
115
+ # header parameters
116
+ header_params = opts[:header_params] || {}
117
+
118
+ # form parameters
119
+ form_params = opts[:form_params] || {}
120
+
121
+ # http body (model)
122
+ post_body = opts[:body]
123
+
124
+ # return_type
125
+ return_type = opts[:return_type]
126
+
127
+ # auth_names
128
+ auth_names = opts[:auth_names] || ['basicAuth']
129
+
130
+ new_options = opts.merge(
131
+ :header_params => header_params,
132
+ :query_params => query_params,
133
+ :form_params => form_params,
134
+ :body => post_body,
135
+ :auth_names => auth_names,
136
+ :return_type => return_type
137
+ )
138
+
139
+ data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
140
+ if @api_client.config.debugging
141
+ @api_client.config.logger.debug "API called: RolesApi#delete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
142
+ end
143
+ return data, status_code, headers
144
+ end
145
+
146
+ # List roles
147
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
148
+ # @param [Hash] opts the optional parameters
149
+ # @option opts [Integer] :limit Number of results to return per page.
150
+ # @option opts [Boolean] :locked Filter results where locked matches value
151
+ # @option opts [String] :name Filter results where name matches value
152
+ # @option opts [String] :name__contains Filter results where name contains value
153
+ # @option opts [String] :name__icontains Filter results where name contains value
154
+ # @option opts [Array<String>] :name__in Filter results where name is in a comma-separated list of values
155
+ # @option opts [String] :name__startswith Filter results where name starts with value
156
+ # @option opts [Integer] :offset The initial index from which to return the results.
157
+ # @option opts [String] :ordering Which field to use when ordering the results.
158
+ # @option opts [String] :fields A list of fields to include in the response.
159
+ # @option opts [String] :exclude_fields A list of fields to exclude from the response.
160
+ # @return [PaginatedRoleResponseList]
161
+ def list(opts = {})
162
+ data, _status_code, _headers = list_with_http_info(opts)
163
+ data
164
+ end
165
+
166
+ # List roles
167
+ # ViewSet for Role. NOTE: This API endpoint is in \&quot;tech preview\&quot; and subject to change
168
+ # @param [Hash] opts the optional parameters
169
+ # @option opts [Integer] :limit Number of results to return per page.
170
+ # @option opts [Boolean] :locked Filter results where locked matches value
171
+ # @option opts [String] :name Filter results where name matches value
172
+ # @option opts [String] :name__contains Filter results where name contains value
173
+ # @option opts [String] :name__icontains Filter results where name contains value
174
+ # @option opts [Array<String>] :name__in Filter results where name is in a comma-separated list of values
175
+ # @option opts [String] :name__startswith Filter results where name starts with value
176
+ # @option opts [Integer] :offset The initial index from which to return the results.
177
+ # @option opts [String] :ordering Which field to use when ordering the results.
178
+ # @option opts [String] :fields A list of fields to include in the response.
179
+ # @option opts [String] :exclude_fields A list of fields to exclude from the response.
180
+ # @return [Array<(PaginatedRoleResponseList, Integer, Hash)>] PaginatedRoleResponseList data, response status code and response headers
181
+ def list_with_http_info(opts = {})
182
+ if @api_client.config.debugging
183
+ @api_client.config.logger.debug 'Calling API: RolesApi.list ...'
184
+ end
185
+ # resource path
186
+ local_var_path = '/pulp/api/v3/roles/'
187
+
188
+ # query parameters
189
+ query_params = opts[:query_params] || {}
190
+ query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
191
+ query_params[:'locked'] = opts[:'locked'] if !opts[:'locked'].nil?
192
+ query_params[:'name'] = opts[:'name'] if !opts[:'name'].nil?
193
+ query_params[:'name__contains'] = opts[:'name__contains'] if !opts[:'name__contains'].nil?
194
+ query_params[:'name__icontains'] = opts[:'name__icontains'] if !opts[:'name__icontains'].nil?
195
+ query_params[:'name__in'] = @api_client.build_collection_param(opts[:'name__in'], :csv) if !opts[:'name__in'].nil?
196
+ query_params[:'name__startswith'] = opts[:'name__startswith'] if !opts[:'name__startswith'].nil?
197
+ query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
198
+ query_params[:'ordering'] = opts[:'ordering'] if !opts[:'ordering'].nil?
199
+ query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
200
+ query_params[:'exclude_fields'] = opts[:'exclude_fields'] if !opts[:'exclude_fields'].nil?
201
+
202
+ # header parameters
203
+ header_params = opts[:header_params] || {}
204
+ # HTTP header 'Accept' (if needed)
205
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
206
+
207
+ # form parameters
208
+ form_params = opts[:form_params] || {}
209
+
210
+ # http body (model)
211
+ post_body = opts[:body]
212
+
213
+ # return_type
214
+ return_type = opts[:return_type] || 'PaginatedRoleResponseList'
215
+
216
+ # auth_names
217
+ auth_names = opts[:auth_names] || ['basicAuth']
218
+
219
+ new_options = opts.merge(
220
+ :header_params => header_params,
221
+ :query_params => query_params,
222
+ :form_params => form_params,
223
+ :body => post_body,
224
+ :auth_names => auth_names,
225
+ :return_type => return_type
226
+ )
227
+
228
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
229
+ if @api_client.config.debugging
230
+ @api_client.config.logger.debug "API called: RolesApi#list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
231
+ end
232
+ return data, status_code, headers
233
+ end
234
+
235
+ # Update a role
236
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
237
+ # @param role_href [String]
238
+ # @param patched_role [PatchedRole]
239
+ # @param [Hash] opts the optional parameters
240
+ # @return [RoleResponse]
241
+ def partial_update(role_href, patched_role, opts = {})
242
+ data, _status_code, _headers = partial_update_with_http_info(role_href, patched_role, opts)
243
+ data
244
+ end
245
+
246
+ # Update a role
247
+ # ViewSet for Role. NOTE: This API endpoint is in \&quot;tech preview\&quot; and subject to change
248
+ # @param role_href [String]
249
+ # @param patched_role [PatchedRole]
250
+ # @param [Hash] opts the optional parameters
251
+ # @return [Array<(RoleResponse, Integer, Hash)>] RoleResponse data, response status code and response headers
252
+ def partial_update_with_http_info(role_href, patched_role, opts = {})
253
+ if @api_client.config.debugging
254
+ @api_client.config.logger.debug 'Calling API: RolesApi.partial_update ...'
255
+ end
256
+ # verify the required parameter 'role_href' is set
257
+ if @api_client.config.client_side_validation && role_href.nil?
258
+ fail ArgumentError, "Missing the required parameter 'role_href' when calling RolesApi.partial_update"
259
+ end
260
+ # verify the required parameter 'patched_role' is set
261
+ if @api_client.config.client_side_validation && patched_role.nil?
262
+ fail ArgumentError, "Missing the required parameter 'patched_role' when calling RolesApi.partial_update"
263
+ end
264
+ # resource path
265
+ local_var_path = '{role_href}'.sub('{' + 'role_href' + '}', CGI.escape(role_href.to_s).gsub('%2F', '/'))
266
+
267
+ # query parameters
268
+ query_params = opts[:query_params] || {}
269
+
270
+ # header parameters
271
+ header_params = opts[:header_params] || {}
272
+ # HTTP header 'Accept' (if needed)
273
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
274
+ # HTTP header 'Content-Type'
275
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'])
276
+
277
+ # form parameters
278
+ form_params = opts[:form_params] || {}
279
+
280
+ # http body (model)
281
+ post_body = opts[:body] || @api_client.object_to_http_body(patched_role)
282
+
283
+ # return_type
284
+ return_type = opts[:return_type] || 'RoleResponse'
285
+
286
+ # auth_names
287
+ auth_names = opts[:auth_names] || ['basicAuth']
288
+
289
+ new_options = opts.merge(
290
+ :header_params => header_params,
291
+ :query_params => query_params,
292
+ :form_params => form_params,
293
+ :body => post_body,
294
+ :auth_names => auth_names,
295
+ :return_type => return_type
296
+ )
297
+
298
+ data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
299
+ if @api_client.config.debugging
300
+ @api_client.config.logger.debug "API called: RolesApi#partial_update\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
301
+ end
302
+ return data, status_code, headers
303
+ end
304
+
305
+ # Inspect a role
306
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
307
+ # @param role_href [String]
308
+ # @param [Hash] opts the optional parameters
309
+ # @option opts [String] :fields A list of fields to include in the response.
310
+ # @option opts [String] :exclude_fields A list of fields to exclude from the response.
311
+ # @return [RoleResponse]
312
+ def read(role_href, opts = {})
313
+ data, _status_code, _headers = read_with_http_info(role_href, opts)
314
+ data
315
+ end
316
+
317
+ # Inspect a role
318
+ # ViewSet for Role. NOTE: This API endpoint is in \&quot;tech preview\&quot; and subject to change
319
+ # @param role_href [String]
320
+ # @param [Hash] opts the optional parameters
321
+ # @option opts [String] :fields A list of fields to include in the response.
322
+ # @option opts [String] :exclude_fields A list of fields to exclude from the response.
323
+ # @return [Array<(RoleResponse, Integer, Hash)>] RoleResponse data, response status code and response headers
324
+ def read_with_http_info(role_href, opts = {})
325
+ if @api_client.config.debugging
326
+ @api_client.config.logger.debug 'Calling API: RolesApi.read ...'
327
+ end
328
+ # verify the required parameter 'role_href' is set
329
+ if @api_client.config.client_side_validation && role_href.nil?
330
+ fail ArgumentError, "Missing the required parameter 'role_href' when calling RolesApi.read"
331
+ end
332
+ # resource path
333
+ local_var_path = '{role_href}'.sub('{' + 'role_href' + '}', CGI.escape(role_href.to_s).gsub('%2F', '/'))
334
+
335
+ # query parameters
336
+ query_params = opts[:query_params] || {}
337
+ query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
338
+ query_params[:'exclude_fields'] = opts[:'exclude_fields'] if !opts[:'exclude_fields'].nil?
339
+
340
+ # header parameters
341
+ header_params = opts[:header_params] || {}
342
+ # HTTP header 'Accept' (if needed)
343
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
344
+
345
+ # form parameters
346
+ form_params = opts[:form_params] || {}
347
+
348
+ # http body (model)
349
+ post_body = opts[:body]
350
+
351
+ # return_type
352
+ return_type = opts[:return_type] || 'RoleResponse'
353
+
354
+ # auth_names
355
+ auth_names = opts[:auth_names] || ['basicAuth']
356
+
357
+ new_options = opts.merge(
358
+ :header_params => header_params,
359
+ :query_params => query_params,
360
+ :form_params => form_params,
361
+ :body => post_body,
362
+ :auth_names => auth_names,
363
+ :return_type => return_type
364
+ )
365
+
366
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
367
+ if @api_client.config.debugging
368
+ @api_client.config.logger.debug "API called: RolesApi#read\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
369
+ end
370
+ return data, status_code, headers
371
+ end
372
+
373
+ # Update a role
374
+ # ViewSet for Role. NOTE: This API endpoint is in \"tech preview\" and subject to change
375
+ # @param role_href [String]
376
+ # @param role [Role]
377
+ # @param [Hash] opts the optional parameters
378
+ # @return [RoleResponse]
379
+ def update(role_href, role, opts = {})
380
+ data, _status_code, _headers = update_with_http_info(role_href, role, opts)
381
+ data
382
+ end
383
+
384
+ # Update a role
385
+ # ViewSet for Role. NOTE: This API endpoint is in \&quot;tech preview\&quot; and subject to change
386
+ # @param role_href [String]
387
+ # @param role [Role]
388
+ # @param [Hash] opts the optional parameters
389
+ # @return [Array<(RoleResponse, Integer, Hash)>] RoleResponse data, response status code and response headers
390
+ def update_with_http_info(role_href, role, opts = {})
391
+ if @api_client.config.debugging
392
+ @api_client.config.logger.debug 'Calling API: RolesApi.update ...'
393
+ end
394
+ # verify the required parameter 'role_href' is set
395
+ if @api_client.config.client_side_validation && role_href.nil?
396
+ fail ArgumentError, "Missing the required parameter 'role_href' when calling RolesApi.update"
397
+ end
398
+ # verify the required parameter 'role' is set
399
+ if @api_client.config.client_side_validation && role.nil?
400
+ fail ArgumentError, "Missing the required parameter 'role' when calling RolesApi.update"
401
+ end
402
+ # resource path
403
+ local_var_path = '{role_href}'.sub('{' + 'role_href' + '}', CGI.escape(role_href.to_s).gsub('%2F', '/'))
404
+
405
+ # query parameters
406
+ query_params = opts[:query_params] || {}
407
+
408
+ # header parameters
409
+ header_params = opts[:header_params] || {}
410
+ # HTTP header 'Accept' (if needed)
411
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
412
+ # HTTP header 'Content-Type'
413
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'])
414
+
415
+ # form parameters
416
+ form_params = opts[:form_params] || {}
417
+
418
+ # http body (model)
419
+ post_body = opts[:body] || @api_client.object_to_http_body(role)
420
+
421
+ # return_type
422
+ return_type = opts[:return_type] || 'RoleResponse'
423
+
424
+ # auth_names
425
+ auth_names = opts[:auth_names] || ['basicAuth']
426
+
427
+ new_options = opts.merge(
428
+ :header_params => header_params,
429
+ :query_params => query_params,
430
+ :form_params => form_params,
431
+ :body => post_body,
432
+ :auth_names => auth_names,
433
+ :return_type => return_type
434
+ )
435
+
436
+ data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
437
+ if @api_client.config.debugging
438
+ @api_client.config.logger.debug "API called: RolesApi#update\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
439
+ end
440
+ return data, status_code, headers
441
+ end
442
+ end
443
+ end