google-apis-connectors_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1057 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module ConnectorsV1
23
+ # Connectors API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/connectors_v1'
29
+ #
30
+ # Connectors = Google::Apis::ConnectorsV1 # Alias the module
31
+ # service = Connectors::ConnectorsService.new
32
+ #
33
+ # @see https://cloud.google.com/apigee/docs/api-platform/connectors/about-connectors
34
+ class ConnectorsService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://connectors.googleapis.com/', '',
47
+ client_name: 'google-apis-connectors_v1',
48
+ client_version: Google::Apis::ConnectorsV1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
51
+
52
+ # Gets information about a location.
53
+ # @param [String] name
54
+ # Resource name for the location.
55
+ # @param [String] fields
56
+ # Selector specifying which fields to include in a partial response.
57
+ # @param [String] quota_user
58
+ # Available to use for quota purposes for server-side applications. Can be any
59
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
60
+ # @param [Google::Apis::RequestOptions] options
61
+ # Request-specific options
62
+ #
63
+ # @yield [result, err] Result & error if block supplied
64
+ # @yieldparam result [Google::Apis::ConnectorsV1::Location] parsed result object
65
+ # @yieldparam err [StandardError] error object if request failed
66
+ #
67
+ # @return [Google::Apis::ConnectorsV1::Location]
68
+ #
69
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
70
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
71
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
72
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
73
+ command = make_simple_command(:get, 'v1/{+name}', options)
74
+ command.response_representation = Google::Apis::ConnectorsV1::Location::Representation
75
+ command.response_class = Google::Apis::ConnectorsV1::Location
76
+ command.params['name'] = name unless name.nil?
77
+ command.query['fields'] = fields unless fields.nil?
78
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
79
+ execute_or_queue_command(command, &block)
80
+ end
81
+
82
+ # Gets the runtimeConfig of a location. RuntimeConfig is a singleton resource
83
+ # for each location.
84
+ # @param [String] name
85
+ # Required. Resource name of the form: `projects/*/locations/*/runtimeConfig`
86
+ # @param [String] fields
87
+ # Selector specifying which fields to include in a partial response.
88
+ # @param [String] quota_user
89
+ # Available to use for quota purposes for server-side applications. Can be any
90
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
91
+ # @param [Google::Apis::RequestOptions] options
92
+ # Request-specific options
93
+ #
94
+ # @yield [result, err] Result & error if block supplied
95
+ # @yieldparam result [Google::Apis::ConnectorsV1::RuntimeConfig] parsed result object
96
+ # @yieldparam err [StandardError] error object if request failed
97
+ #
98
+ # @return [Google::Apis::ConnectorsV1::RuntimeConfig]
99
+ #
100
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
101
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
102
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
103
+ def get_project_location_runtime_config(name, fields: nil, quota_user: nil, options: nil, &block)
104
+ command = make_simple_command(:get, 'v1/{+name}', options)
105
+ command.response_representation = Google::Apis::ConnectorsV1::RuntimeConfig::Representation
106
+ command.response_class = Google::Apis::ConnectorsV1::RuntimeConfig
107
+ command.params['name'] = name unless name.nil?
108
+ command.query['fields'] = fields unless fields.nil?
109
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
110
+ execute_or_queue_command(command, &block)
111
+ end
112
+
113
+ # Lists information about the supported locations for this service.
114
+ # @param [String] name
115
+ # The resource that owns the locations collection, if applicable.
116
+ # @param [String] filter
117
+ # A filter to narrow down results to a preferred subset. The filtering language
118
+ # accepts strings like "displayName=tokyo", and is documented in more detail in [
119
+ # AIP-160](https://google.aip.dev/160).
120
+ # @param [Fixnum] page_size
121
+ # The maximum number of results to return. If not set, the service selects a
122
+ # default.
123
+ # @param [String] page_token
124
+ # A page token received from the `next_page_token` field in the response. Send
125
+ # that page token to receive the subsequent page.
126
+ # @param [String] fields
127
+ # Selector specifying which fields to include in a partial response.
128
+ # @param [String] quota_user
129
+ # Available to use for quota purposes for server-side applications. Can be any
130
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
131
+ # @param [Google::Apis::RequestOptions] options
132
+ # Request-specific options
133
+ #
134
+ # @yield [result, err] Result & error if block supplied
135
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListLocationsResponse] parsed result object
136
+ # @yieldparam err [StandardError] error object if request failed
137
+ #
138
+ # @return [Google::Apis::ConnectorsV1::ListLocationsResponse]
139
+ #
140
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
141
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
142
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
143
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
144
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
145
+ command.response_representation = Google::Apis::ConnectorsV1::ListLocationsResponse::Representation
146
+ command.response_class = Google::Apis::ConnectorsV1::ListLocationsResponse
147
+ command.params['name'] = name unless name.nil?
148
+ command.query['filter'] = filter unless filter.nil?
149
+ command.query['pageSize'] = page_size unless page_size.nil?
150
+ command.query['pageToken'] = page_token unless page_token.nil?
151
+ command.query['fields'] = fields unless fields.nil?
152
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
153
+ execute_or_queue_command(command, &block)
154
+ end
155
+
156
+ # Creates a new Connection in a given project and location.
157
+ # @param [String] parent
158
+ # Required. Parent resource of the Connection, of the form: `projects/*/
159
+ # locations/*`
160
+ # @param [Google::Apis::ConnectorsV1::Connection] connection_object
161
+ # @param [String] connection_id
162
+ # Required. Identifier to assign to the Connection. Must be unique within scope
163
+ # of the parent resource.
164
+ # @param [String] fields
165
+ # Selector specifying which fields to include in a partial response.
166
+ # @param [String] quota_user
167
+ # Available to use for quota purposes for server-side applications. Can be any
168
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
169
+ # @param [Google::Apis::RequestOptions] options
170
+ # Request-specific options
171
+ #
172
+ # @yield [result, err] Result & error if block supplied
173
+ # @yieldparam result [Google::Apis::ConnectorsV1::Operation] parsed result object
174
+ # @yieldparam err [StandardError] error object if request failed
175
+ #
176
+ # @return [Google::Apis::ConnectorsV1::Operation]
177
+ #
178
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
179
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
180
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
181
+ def create_project_location_connection(parent, connection_object = nil, connection_id: nil, fields: nil, quota_user: nil, options: nil, &block)
182
+ command = make_simple_command(:post, 'v1/{+parent}/connections', options)
183
+ command.request_representation = Google::Apis::ConnectorsV1::Connection::Representation
184
+ command.request_object = connection_object
185
+ command.response_representation = Google::Apis::ConnectorsV1::Operation::Representation
186
+ command.response_class = Google::Apis::ConnectorsV1::Operation
187
+ command.params['parent'] = parent unless parent.nil?
188
+ command.query['connectionId'] = connection_id unless connection_id.nil?
189
+ command.query['fields'] = fields unless fields.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ execute_or_queue_command(command, &block)
192
+ end
193
+
194
+ # Deletes a single Connection.
195
+ # @param [String] name
196
+ # Required. Resource name of the form: `projects/*/locations/*/connections/*`
197
+ # @param [String] fields
198
+ # Selector specifying which fields to include in a partial response.
199
+ # @param [String] quota_user
200
+ # Available to use for quota purposes for server-side applications. Can be any
201
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
202
+ # @param [Google::Apis::RequestOptions] options
203
+ # Request-specific options
204
+ #
205
+ # @yield [result, err] Result & error if block supplied
206
+ # @yieldparam result [Google::Apis::ConnectorsV1::Operation] parsed result object
207
+ # @yieldparam err [StandardError] error object if request failed
208
+ #
209
+ # @return [Google::Apis::ConnectorsV1::Operation]
210
+ #
211
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
212
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
213
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
214
+ def delete_project_location_connection(name, fields: nil, quota_user: nil, options: nil, &block)
215
+ command = make_simple_command(:delete, 'v1/{+name}', options)
216
+ command.response_representation = Google::Apis::ConnectorsV1::Operation::Representation
217
+ command.response_class = Google::Apis::ConnectorsV1::Operation
218
+ command.params['name'] = name unless name.nil?
219
+ command.query['fields'] = fields unless fields.nil?
220
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
221
+ execute_or_queue_command(command, &block)
222
+ end
223
+
224
+ # Gets details of a single Connection.
225
+ # @param [String] name
226
+ # Required. Resource name of the form: `projects/*/locations/*/connections/*`
227
+ # @param [String] view
228
+ # Specifies which fields of the Connection are returned in the response.
229
+ # Defaults to `BASIC` view.
230
+ # @param [String] fields
231
+ # Selector specifying which fields to include in a partial response.
232
+ # @param [String] quota_user
233
+ # Available to use for quota purposes for server-side applications. Can be any
234
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
235
+ # @param [Google::Apis::RequestOptions] options
236
+ # Request-specific options
237
+ #
238
+ # @yield [result, err] Result & error if block supplied
239
+ # @yieldparam result [Google::Apis::ConnectorsV1::Connection] parsed result object
240
+ # @yieldparam err [StandardError] error object if request failed
241
+ #
242
+ # @return [Google::Apis::ConnectorsV1::Connection]
243
+ #
244
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
245
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
246
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
247
+ def get_project_location_connection(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
248
+ command = make_simple_command(:get, 'v1/{+name}', options)
249
+ command.response_representation = Google::Apis::ConnectorsV1::Connection::Representation
250
+ command.response_class = Google::Apis::ConnectorsV1::Connection
251
+ command.params['name'] = name unless name.nil?
252
+ command.query['view'] = view unless view.nil?
253
+ command.query['fields'] = fields unless fields.nil?
254
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
255
+ execute_or_queue_command(command, &block)
256
+ end
257
+
258
+ # Gets schema metadata of a connection. SchemaMetadata is a singleton resource
259
+ # for each connection.
260
+ # @param [String] name
261
+ # Required. Connection name Format: projects/`project`/locations/`location`/
262
+ # connections/`connection`/connectionSchemaMetadata
263
+ # @param [String] fields
264
+ # Selector specifying which fields to include in a partial response.
265
+ # @param [String] quota_user
266
+ # Available to use for quota purposes for server-side applications. Can be any
267
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
268
+ # @param [Google::Apis::RequestOptions] options
269
+ # Request-specific options
270
+ #
271
+ # @yield [result, err] Result & error if block supplied
272
+ # @yieldparam result [Google::Apis::ConnectorsV1::ConnectionSchemaMetadata] parsed result object
273
+ # @yieldparam err [StandardError] error object if request failed
274
+ #
275
+ # @return [Google::Apis::ConnectorsV1::ConnectionSchemaMetadata]
276
+ #
277
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
278
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
279
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
280
+ def get_project_location_connection_connection_schema_metadata(name, fields: nil, quota_user: nil, options: nil, &block)
281
+ command = make_simple_command(:get, 'v1/{+name}', options)
282
+ command.response_representation = Google::Apis::ConnectorsV1::ConnectionSchemaMetadata::Representation
283
+ command.response_class = Google::Apis::ConnectorsV1::ConnectionSchemaMetadata
284
+ command.params['name'] = name unless name.nil?
285
+ command.query['fields'] = fields unless fields.nil?
286
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
287
+ execute_or_queue_command(command, &block)
288
+ end
289
+
290
+ # Gets the access control policy for a resource. Returns an empty policy if the
291
+ # resource exists and does not have a policy set.
292
+ # @param [String] resource
293
+ # REQUIRED: The resource for which the policy is being requested. See the
294
+ # operation documentation for the appropriate value for this field.
295
+ # @param [Fixnum] options_requested_policy_version
296
+ # Optional. The policy format version to be returned. Valid values are 0, 1, and
297
+ # 3. Requests specifying an invalid value will be rejected. Requests for
298
+ # policies with any conditional bindings must specify version 3. Policies
299
+ # without any conditional bindings may specify any valid value or leave the
300
+ # field unset. To learn which resources support conditions in their IAM policies,
301
+ # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
302
+ # resource-policies).
303
+ # @param [String] fields
304
+ # Selector specifying which fields to include in a partial response.
305
+ # @param [String] quota_user
306
+ # Available to use for quota purposes for server-side applications. Can be any
307
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
308
+ # @param [Google::Apis::RequestOptions] options
309
+ # Request-specific options
310
+ #
311
+ # @yield [result, err] Result & error if block supplied
312
+ # @yieldparam result [Google::Apis::ConnectorsV1::Policy] parsed result object
313
+ # @yieldparam err [StandardError] error object if request failed
314
+ #
315
+ # @return [Google::Apis::ConnectorsV1::Policy]
316
+ #
317
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
318
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
319
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
320
+ def get_project_location_connection_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
321
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
322
+ command.response_representation = Google::Apis::ConnectorsV1::Policy::Representation
323
+ command.response_class = Google::Apis::ConnectorsV1::Policy
324
+ command.params['resource'] = resource unless resource.nil?
325
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
326
+ command.query['fields'] = fields unless fields.nil?
327
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
328
+ execute_or_queue_command(command, &block)
329
+ end
330
+
331
+ # Lists Connections in a given project and location.
332
+ # @param [String] parent
333
+ # Required. Parent resource of the Connection, of the form: `projects/*/
334
+ # locations/*`
335
+ # @param [String] filter
336
+ # Filter.
337
+ # @param [String] order_by
338
+ # Order by parameters.
339
+ # @param [Fixnum] page_size
340
+ # Page size.
341
+ # @param [String] page_token
342
+ # Page token.
343
+ # @param [String] view
344
+ # Specifies which fields of the Connection are returned in the response.
345
+ # Defaults to `BASIC` view.
346
+ # @param [String] fields
347
+ # Selector specifying which fields to include in a partial response.
348
+ # @param [String] quota_user
349
+ # Available to use for quota purposes for server-side applications. Can be any
350
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
351
+ # @param [Google::Apis::RequestOptions] options
352
+ # Request-specific options
353
+ #
354
+ # @yield [result, err] Result & error if block supplied
355
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListConnectionsResponse] parsed result object
356
+ # @yieldparam err [StandardError] error object if request failed
357
+ #
358
+ # @return [Google::Apis::ConnectorsV1::ListConnectionsResponse]
359
+ #
360
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
361
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
362
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
363
+ def list_project_location_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
364
+ command = make_simple_command(:get, 'v1/{+parent}/connections', options)
365
+ command.response_representation = Google::Apis::ConnectorsV1::ListConnectionsResponse::Representation
366
+ command.response_class = Google::Apis::ConnectorsV1::ListConnectionsResponse
367
+ command.params['parent'] = parent unless parent.nil?
368
+ command.query['filter'] = filter unless filter.nil?
369
+ command.query['orderBy'] = order_by unless order_by.nil?
370
+ command.query['pageSize'] = page_size unless page_size.nil?
371
+ command.query['pageToken'] = page_token unless page_token.nil?
372
+ command.query['view'] = view unless view.nil?
373
+ command.query['fields'] = fields unless fields.nil?
374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
375
+ execute_or_queue_command(command, &block)
376
+ end
377
+
378
+ # Updates the parameters of a single Connection.
379
+ # @param [String] name
380
+ # Output only. Resource name of the Connection. Format: projects/`project`/
381
+ # locations/`location`/connections/`connection`
382
+ # @param [Google::Apis::ConnectorsV1::Connection] connection_object
383
+ # @param [String] update_mask
384
+ # Field mask is used to specify the fields to be overwritten in the Connection
385
+ # resource by the update. The fields specified in the update_mask are relative
386
+ # to the resource, not the full request. A field will be overwritten if it is in
387
+ # the mask. If the user does not provide a mask then all fields will be
388
+ # overwritten.
389
+ # @param [String] fields
390
+ # Selector specifying which fields to include in a partial response.
391
+ # @param [String] quota_user
392
+ # Available to use for quota purposes for server-side applications. Can be any
393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
394
+ # @param [Google::Apis::RequestOptions] options
395
+ # Request-specific options
396
+ #
397
+ # @yield [result, err] Result & error if block supplied
398
+ # @yieldparam result [Google::Apis::ConnectorsV1::Operation] parsed result object
399
+ # @yieldparam err [StandardError] error object if request failed
400
+ #
401
+ # @return [Google::Apis::ConnectorsV1::Operation]
402
+ #
403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
406
+ def patch_project_location_connection(name, connection_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
407
+ command = make_simple_command(:patch, 'v1/{+name}', options)
408
+ command.request_representation = Google::Apis::ConnectorsV1::Connection::Representation
409
+ command.request_object = connection_object
410
+ command.response_representation = Google::Apis::ConnectorsV1::Operation::Representation
411
+ command.response_class = Google::Apis::ConnectorsV1::Operation
412
+ command.params['name'] = name unless name.nil?
413
+ command.query['updateMask'] = update_mask unless update_mask.nil?
414
+ command.query['fields'] = fields unless fields.nil?
415
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
416
+ execute_or_queue_command(command, &block)
417
+ end
418
+
419
+ # Sets the access control policy on the specified resource. Replaces any
420
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
421
+ # PERMISSION_DENIED` errors.
422
+ # @param [String] resource
423
+ # REQUIRED: The resource for which the policy is being specified. See the
424
+ # operation documentation for the appropriate value for this field.
425
+ # @param [Google::Apis::ConnectorsV1::SetIamPolicyRequest] set_iam_policy_request_object
426
+ # @param [String] fields
427
+ # Selector specifying which fields to include in a partial response.
428
+ # @param [String] quota_user
429
+ # Available to use for quota purposes for server-side applications. Can be any
430
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
431
+ # @param [Google::Apis::RequestOptions] options
432
+ # Request-specific options
433
+ #
434
+ # @yield [result, err] Result & error if block supplied
435
+ # @yieldparam result [Google::Apis::ConnectorsV1::Policy] parsed result object
436
+ # @yieldparam err [StandardError] error object if request failed
437
+ #
438
+ # @return [Google::Apis::ConnectorsV1::Policy]
439
+ #
440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
443
+ def set_connection_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
444
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
445
+ command.request_representation = Google::Apis::ConnectorsV1::SetIamPolicyRequest::Representation
446
+ command.request_object = set_iam_policy_request_object
447
+ command.response_representation = Google::Apis::ConnectorsV1::Policy::Representation
448
+ command.response_class = Google::Apis::ConnectorsV1::Policy
449
+ command.params['resource'] = resource unless resource.nil?
450
+ command.query['fields'] = fields unless fields.nil?
451
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
452
+ execute_or_queue_command(command, &block)
453
+ end
454
+
455
+ # Returns permissions that a caller has on the specified resource. If the
456
+ # resource does not exist, this will return an empty set of permissions, not a `
457
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
458
+ # permission-aware UIs and command-line tools, not for authorization checking.
459
+ # This operation may "fail open" without warning.
460
+ # @param [String] resource
461
+ # REQUIRED: The resource for which the policy detail is being requested. See the
462
+ # operation documentation for the appropriate value for this field.
463
+ # @param [Google::Apis::ConnectorsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
464
+ # @param [String] fields
465
+ # Selector specifying which fields to include in a partial response.
466
+ # @param [String] quota_user
467
+ # Available to use for quota purposes for server-side applications. Can be any
468
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
469
+ # @param [Google::Apis::RequestOptions] options
470
+ # Request-specific options
471
+ #
472
+ # @yield [result, err] Result & error if block supplied
473
+ # @yieldparam result [Google::Apis::ConnectorsV1::TestIamPermissionsResponse] parsed result object
474
+ # @yieldparam err [StandardError] error object if request failed
475
+ #
476
+ # @return [Google::Apis::ConnectorsV1::TestIamPermissionsResponse]
477
+ #
478
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
479
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
480
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
481
+ def test_connection_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
482
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
483
+ command.request_representation = Google::Apis::ConnectorsV1::TestIamPermissionsRequest::Representation
484
+ command.request_object = test_iam_permissions_request_object
485
+ command.response_representation = Google::Apis::ConnectorsV1::TestIamPermissionsResponse::Representation
486
+ command.response_class = Google::Apis::ConnectorsV1::TestIamPermissionsResponse
487
+ command.params['resource'] = resource unless resource.nil?
488
+ command.query['fields'] = fields unless fields.nil?
489
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
490
+ execute_or_queue_command(command, &block)
491
+ end
492
+
493
+ # List schema of a runtime actions filtered by action name.
494
+ # @param [String] parent
495
+ # Required. Parent resource of RuntimeActionSchema Format: projects/`project`/
496
+ # locations/`location`/connections/`connection`
497
+ # @param [String] filter
498
+ # Filter
499
+ # @param [Fixnum] page_size
500
+ # Page size.
501
+ # @param [String] page_token
502
+ # Page token.
503
+ # @param [String] fields
504
+ # Selector specifying which fields to include in a partial response.
505
+ # @param [String] quota_user
506
+ # Available to use for quota purposes for server-side applications. Can be any
507
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
508
+ # @param [Google::Apis::RequestOptions] options
509
+ # Request-specific options
510
+ #
511
+ # @yield [result, err] Result & error if block supplied
512
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListRuntimeActionSchemasResponse] parsed result object
513
+ # @yieldparam err [StandardError] error object if request failed
514
+ #
515
+ # @return [Google::Apis::ConnectorsV1::ListRuntimeActionSchemasResponse]
516
+ #
517
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
518
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
519
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
520
+ def list_project_location_connection_runtime_action_schemas(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
521
+ command = make_simple_command(:get, 'v1/{+parent}/runtimeActionSchemas', options)
522
+ command.response_representation = Google::Apis::ConnectorsV1::ListRuntimeActionSchemasResponse::Representation
523
+ command.response_class = Google::Apis::ConnectorsV1::ListRuntimeActionSchemasResponse
524
+ command.params['parent'] = parent unless parent.nil?
525
+ command.query['filter'] = filter unless filter.nil?
526
+ command.query['pageSize'] = page_size unless page_size.nil?
527
+ command.query['pageToken'] = page_token unless page_token.nil?
528
+ command.query['fields'] = fields unless fields.nil?
529
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
530
+ execute_or_queue_command(command, &block)
531
+ end
532
+
533
+ # List schema of a runtime entities filtered by entity name.
534
+ # @param [String] parent
535
+ # Required. Parent resource of RuntimeEntitySchema Format: projects/`project`/
536
+ # locations/`location`/connections/`connection`
537
+ # @param [String] filter
538
+ # Filter
539
+ # @param [Fixnum] page_size
540
+ # Page size.
541
+ # @param [String] page_token
542
+ # Page token.
543
+ # @param [String] fields
544
+ # Selector specifying which fields to include in a partial response.
545
+ # @param [String] quota_user
546
+ # Available to use for quota purposes for server-side applications. Can be any
547
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
548
+ # @param [Google::Apis::RequestOptions] options
549
+ # Request-specific options
550
+ #
551
+ # @yield [result, err] Result & error if block supplied
552
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListRuntimeEntitySchemasResponse] parsed result object
553
+ # @yieldparam err [StandardError] error object if request failed
554
+ #
555
+ # @return [Google::Apis::ConnectorsV1::ListRuntimeEntitySchemasResponse]
556
+ #
557
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
558
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
559
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
560
+ def list_project_location_connection_runtime_entity_schemas(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
561
+ command = make_simple_command(:get, 'v1/{+parent}/runtimeEntitySchemas', options)
562
+ command.response_representation = Google::Apis::ConnectorsV1::ListRuntimeEntitySchemasResponse::Representation
563
+ command.response_class = Google::Apis::ConnectorsV1::ListRuntimeEntitySchemasResponse
564
+ command.params['parent'] = parent unless parent.nil?
565
+ command.query['filter'] = filter unless filter.nil?
566
+ command.query['pageSize'] = page_size unless page_size.nil?
567
+ command.query['pageToken'] = page_token unless page_token.nil?
568
+ command.query['fields'] = fields unless fields.nil?
569
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
570
+ execute_or_queue_command(command, &block)
571
+ end
572
+
573
+ # Gets details of a single Provider.
574
+ # @param [String] name
575
+ # Required. Resource name of the form: `projects/*/locations/*/providers/*`
576
+ # @param [String] fields
577
+ # Selector specifying which fields to include in a partial response.
578
+ # @param [String] quota_user
579
+ # Available to use for quota purposes for server-side applications. Can be any
580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
581
+ # @param [Google::Apis::RequestOptions] options
582
+ # Request-specific options
583
+ #
584
+ # @yield [result, err] Result & error if block supplied
585
+ # @yieldparam result [Google::Apis::ConnectorsV1::Provider] parsed result object
586
+ # @yieldparam err [StandardError] error object if request failed
587
+ #
588
+ # @return [Google::Apis::ConnectorsV1::Provider]
589
+ #
590
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
591
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
592
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
593
+ def get_project_location_global_provider(name, fields: nil, quota_user: nil, options: nil, &block)
594
+ command = make_simple_command(:get, 'v1/{+name}', options)
595
+ command.response_representation = Google::Apis::ConnectorsV1::Provider::Representation
596
+ command.response_class = Google::Apis::ConnectorsV1::Provider
597
+ command.params['name'] = name unless name.nil?
598
+ command.query['fields'] = fields unless fields.nil?
599
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
600
+ execute_or_queue_command(command, &block)
601
+ end
602
+
603
+ # Lists Providers in a given project and location.
604
+ # @param [String] parent
605
+ # Required. Parent resource of the API, of the form: `projects/*/locations/*`
606
+ # @param [Fixnum] page_size
607
+ # Page size.
608
+ # @param [String] page_token
609
+ # Page token.
610
+ # @param [String] fields
611
+ # Selector specifying which fields to include in a partial response.
612
+ # @param [String] quota_user
613
+ # Available to use for quota purposes for server-side applications. Can be any
614
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
615
+ # @param [Google::Apis::RequestOptions] options
616
+ # Request-specific options
617
+ #
618
+ # @yield [result, err] Result & error if block supplied
619
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListProvidersResponse] parsed result object
620
+ # @yieldparam err [StandardError] error object if request failed
621
+ #
622
+ # @return [Google::Apis::ConnectorsV1::ListProvidersResponse]
623
+ #
624
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
625
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
626
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
627
+ def list_project_location_global_providers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
628
+ command = make_simple_command(:get, 'v1/{+parent}/providers', options)
629
+ command.response_representation = Google::Apis::ConnectorsV1::ListProvidersResponse::Representation
630
+ command.response_class = Google::Apis::ConnectorsV1::ListProvidersResponse
631
+ command.params['parent'] = parent unless parent.nil?
632
+ command.query['pageSize'] = page_size unless page_size.nil?
633
+ command.query['pageToken'] = page_token unless page_token.nil?
634
+ command.query['fields'] = fields unless fields.nil?
635
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
636
+ execute_or_queue_command(command, &block)
637
+ end
638
+
639
+ # Gets details of a single Connector.
640
+ # @param [String] name
641
+ # Required. Resource name of the form: `projects/*/locations/*/providers/*/
642
+ # connectors/*`
643
+ # @param [String] fields
644
+ # Selector specifying which fields to include in a partial response.
645
+ # @param [String] quota_user
646
+ # Available to use for quota purposes for server-side applications. Can be any
647
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
648
+ # @param [Google::Apis::RequestOptions] options
649
+ # Request-specific options
650
+ #
651
+ # @yield [result, err] Result & error if block supplied
652
+ # @yieldparam result [Google::Apis::ConnectorsV1::Connector] parsed result object
653
+ # @yieldparam err [StandardError] error object if request failed
654
+ #
655
+ # @return [Google::Apis::ConnectorsV1::Connector]
656
+ #
657
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
658
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
659
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
660
+ def get_project_location_global_provider_connector(name, fields: nil, quota_user: nil, options: nil, &block)
661
+ command = make_simple_command(:get, 'v1/{+name}', options)
662
+ command.response_representation = Google::Apis::ConnectorsV1::Connector::Representation
663
+ command.response_class = Google::Apis::ConnectorsV1::Connector
664
+ command.params['name'] = name unless name.nil?
665
+ command.query['fields'] = fields unless fields.nil?
666
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
667
+ execute_or_queue_command(command, &block)
668
+ end
669
+
670
+ # Lists Connectors in a given project and location.
671
+ # @param [String] parent
672
+ # Required. Parent resource of the connectors, of the form: `projects/*/
673
+ # locations/*/providers/*`
674
+ # @param [Fixnum] page_size
675
+ # Page size.
676
+ # @param [String] page_token
677
+ # Page token.
678
+ # @param [String] fields
679
+ # Selector specifying which fields to include in a partial response.
680
+ # @param [String] quota_user
681
+ # Available to use for quota purposes for server-side applications. Can be any
682
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
683
+ # @param [Google::Apis::RequestOptions] options
684
+ # Request-specific options
685
+ #
686
+ # @yield [result, err] Result & error if block supplied
687
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListConnectorsResponse] parsed result object
688
+ # @yieldparam err [StandardError] error object if request failed
689
+ #
690
+ # @return [Google::Apis::ConnectorsV1::ListConnectorsResponse]
691
+ #
692
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
693
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
694
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
695
+ def list_project_location_global_provider_connectors(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
696
+ command = make_simple_command(:get, 'v1/{+parent}/connectors', options)
697
+ command.response_representation = Google::Apis::ConnectorsV1::ListConnectorsResponse::Representation
698
+ command.response_class = Google::Apis::ConnectorsV1::ListConnectorsResponse
699
+ command.params['parent'] = parent unless parent.nil?
700
+ command.query['pageSize'] = page_size unless page_size.nil?
701
+ command.query['pageToken'] = page_token unless page_token.nil?
702
+ command.query['fields'] = fields unless fields.nil?
703
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
704
+ execute_or_queue_command(command, &block)
705
+ end
706
+
707
+ # Gets details of a single connector version.
708
+ # @param [String] name
709
+ # Required. Resource name of the form: `projects/*/locations/*/providers/*/
710
+ # connectors/*/versions/*`
711
+ # @param [String] view
712
+ # Specifies which fields of the ConnectorVersion are returned in the response.
713
+ # Defaults to `CUSTOMER` view.
714
+ # @param [String] fields
715
+ # Selector specifying which fields to include in a partial response.
716
+ # @param [String] quota_user
717
+ # Available to use for quota purposes for server-side applications. Can be any
718
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
719
+ # @param [Google::Apis::RequestOptions] options
720
+ # Request-specific options
721
+ #
722
+ # @yield [result, err] Result & error if block supplied
723
+ # @yieldparam result [Google::Apis::ConnectorsV1::ConnectorVersion] parsed result object
724
+ # @yieldparam err [StandardError] error object if request failed
725
+ #
726
+ # @return [Google::Apis::ConnectorsV1::ConnectorVersion]
727
+ #
728
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
729
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
730
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
731
+ def get_project_location_global_provider_connector_version(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
732
+ command = make_simple_command(:get, 'v1/{+name}', options)
733
+ command.response_representation = Google::Apis::ConnectorsV1::ConnectorVersion::Representation
734
+ command.response_class = Google::Apis::ConnectorsV1::ConnectorVersion
735
+ command.params['name'] = name unless name.nil?
736
+ command.query['view'] = view unless view.nil?
737
+ command.query['fields'] = fields unless fields.nil?
738
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
739
+ execute_or_queue_command(command, &block)
740
+ end
741
+
742
+ # Lists Connector Versions in a given project and location.
743
+ # @param [String] parent
744
+ # Required. Parent resource of the connectors, of the form: `projects/*/
745
+ # locations/*/providers/*/connectors/*`
746
+ # @param [Fixnum] page_size
747
+ # Page size.
748
+ # @param [String] page_token
749
+ # Page token.
750
+ # @param [String] view
751
+ # Specifies which fields of the ConnectorVersion are returned in the response.
752
+ # Defaults to `CUSTOMER` view.
753
+ # @param [String] fields
754
+ # Selector specifying which fields to include in a partial response.
755
+ # @param [String] quota_user
756
+ # Available to use for quota purposes for server-side applications. Can be any
757
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
758
+ # @param [Google::Apis::RequestOptions] options
759
+ # Request-specific options
760
+ #
761
+ # @yield [result, err] Result & error if block supplied
762
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListConnectorVersionsResponse] parsed result object
763
+ # @yieldparam err [StandardError] error object if request failed
764
+ #
765
+ # @return [Google::Apis::ConnectorsV1::ListConnectorVersionsResponse]
766
+ #
767
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
768
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
769
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
770
+ def list_project_location_global_provider_connector_versions(parent, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
771
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
772
+ command.response_representation = Google::Apis::ConnectorsV1::ListConnectorVersionsResponse::Representation
773
+ command.response_class = Google::Apis::ConnectorsV1::ListConnectorVersionsResponse
774
+ command.params['parent'] = parent unless parent.nil?
775
+ command.query['pageSize'] = page_size unless page_size.nil?
776
+ command.query['pageToken'] = page_token unless page_token.nil?
777
+ command.query['view'] = view unless view.nil?
778
+ command.query['fields'] = fields unless fields.nil?
779
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
780
+ execute_or_queue_command(command, &block)
781
+ end
782
+
783
+ # Starts asynchronous cancellation on a long-running operation. The server makes
784
+ # a best effort to cancel the operation, but success is not guaranteed. If the
785
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
786
+ # Clients can use Operations.GetOperation or other methods to check whether the
787
+ # cancellation succeeded or whether the operation completed despite cancellation.
788
+ # On successful cancellation, the operation is not deleted; instead, it becomes
789
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
790
+ # corresponding to `Code.CANCELLED`.
791
+ # @param [String] name
792
+ # The name of the operation resource to be cancelled.
793
+ # @param [Google::Apis::ConnectorsV1::CancelOperationRequest] cancel_operation_request_object
794
+ # @param [String] fields
795
+ # Selector specifying which fields to include in a partial response.
796
+ # @param [String] quota_user
797
+ # Available to use for quota purposes for server-side applications. Can be any
798
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
799
+ # @param [Google::Apis::RequestOptions] options
800
+ # Request-specific options
801
+ #
802
+ # @yield [result, err] Result & error if block supplied
803
+ # @yieldparam result [Google::Apis::ConnectorsV1::Empty] parsed result object
804
+ # @yieldparam err [StandardError] error object if request failed
805
+ #
806
+ # @return [Google::Apis::ConnectorsV1::Empty]
807
+ #
808
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
809
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
810
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
811
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
812
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
813
+ command.request_representation = Google::Apis::ConnectorsV1::CancelOperationRequest::Representation
814
+ command.request_object = cancel_operation_request_object
815
+ command.response_representation = Google::Apis::ConnectorsV1::Empty::Representation
816
+ command.response_class = Google::Apis::ConnectorsV1::Empty
817
+ command.params['name'] = name unless name.nil?
818
+ command.query['fields'] = fields unless fields.nil?
819
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
820
+ execute_or_queue_command(command, &block)
821
+ end
822
+
823
+ # Deletes a long-running operation. This method indicates that the client is no
824
+ # longer interested in the operation result. It does not cancel the operation.
825
+ # If the server doesn't support this method, it returns `google.rpc.Code.
826
+ # UNIMPLEMENTED`.
827
+ # @param [String] name
828
+ # The name of the operation resource to be deleted.
829
+ # @param [String] fields
830
+ # Selector specifying which fields to include in a partial response.
831
+ # @param [String] quota_user
832
+ # Available to use for quota purposes for server-side applications. Can be any
833
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
834
+ # @param [Google::Apis::RequestOptions] options
835
+ # Request-specific options
836
+ #
837
+ # @yield [result, err] Result & error if block supplied
838
+ # @yieldparam result [Google::Apis::ConnectorsV1::Empty] parsed result object
839
+ # @yieldparam err [StandardError] error object if request failed
840
+ #
841
+ # @return [Google::Apis::ConnectorsV1::Empty]
842
+ #
843
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
844
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
845
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
846
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
847
+ command = make_simple_command(:delete, 'v1/{+name}', options)
848
+ command.response_representation = Google::Apis::ConnectorsV1::Empty::Representation
849
+ command.response_class = Google::Apis::ConnectorsV1::Empty
850
+ command.params['name'] = name unless name.nil?
851
+ command.query['fields'] = fields unless fields.nil?
852
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
853
+ execute_or_queue_command(command, &block)
854
+ end
855
+
856
+ # Gets the latest state of a long-running operation. Clients can use this method
857
+ # to poll the operation result at intervals as recommended by the API service.
858
+ # @param [String] name
859
+ # The name of the operation resource.
860
+ # @param [String] fields
861
+ # Selector specifying which fields to include in a partial response.
862
+ # @param [String] quota_user
863
+ # Available to use for quota purposes for server-side applications. Can be any
864
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
865
+ # @param [Google::Apis::RequestOptions] options
866
+ # Request-specific options
867
+ #
868
+ # @yield [result, err] Result & error if block supplied
869
+ # @yieldparam result [Google::Apis::ConnectorsV1::Operation] parsed result object
870
+ # @yieldparam err [StandardError] error object if request failed
871
+ #
872
+ # @return [Google::Apis::ConnectorsV1::Operation]
873
+ #
874
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
875
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
876
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
877
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
878
+ command = make_simple_command(:get, 'v1/{+name}', options)
879
+ command.response_representation = Google::Apis::ConnectorsV1::Operation::Representation
880
+ command.response_class = Google::Apis::ConnectorsV1::Operation
881
+ command.params['name'] = name unless name.nil?
882
+ command.query['fields'] = fields unless fields.nil?
883
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
884
+ execute_or_queue_command(command, &block)
885
+ end
886
+
887
+ # Lists operations that match the specified filter in the request. If the server
888
+ # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
889
+ # binding allows API services to override the binding to use different resource
890
+ # name schemes, such as `users/*/operations`. To override the binding, API
891
+ # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
892
+ # service configuration. For backwards compatibility, the default name includes
893
+ # the operations collection id, however overriding users must ensure the name
894
+ # binding is the parent resource, without the operations collection id.
895
+ # @param [String] name
896
+ # The name of the operation's parent resource.
897
+ # @param [String] filter
898
+ # The standard list filter.
899
+ # @param [Fixnum] page_size
900
+ # The standard list page size.
901
+ # @param [String] page_token
902
+ # The standard list page token.
903
+ # @param [String] fields
904
+ # Selector specifying which fields to include in a partial response.
905
+ # @param [String] quota_user
906
+ # Available to use for quota purposes for server-side applications. Can be any
907
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
908
+ # @param [Google::Apis::RequestOptions] options
909
+ # Request-specific options
910
+ #
911
+ # @yield [result, err] Result & error if block supplied
912
+ # @yieldparam result [Google::Apis::ConnectorsV1::ListOperationsResponse] parsed result object
913
+ # @yieldparam err [StandardError] error object if request failed
914
+ #
915
+ # @return [Google::Apis::ConnectorsV1::ListOperationsResponse]
916
+ #
917
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
918
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
919
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
920
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
921
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
922
+ command.response_representation = Google::Apis::ConnectorsV1::ListOperationsResponse::Representation
923
+ command.response_class = Google::Apis::ConnectorsV1::ListOperationsResponse
924
+ command.params['name'] = name unless name.nil?
925
+ command.query['filter'] = filter unless filter.nil?
926
+ command.query['pageSize'] = page_size unless page_size.nil?
927
+ command.query['pageToken'] = page_token unless page_token.nil?
928
+ command.query['fields'] = fields unless fields.nil?
929
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
930
+ execute_or_queue_command(command, &block)
931
+ end
932
+
933
+ # Gets the access control policy for a resource. Returns an empty policy if the
934
+ # resource exists and does not have a policy set.
935
+ # @param [String] resource
936
+ # REQUIRED: The resource for which the policy is being requested. See the
937
+ # operation documentation for the appropriate value for this field.
938
+ # @param [Fixnum] options_requested_policy_version
939
+ # Optional. The policy format version to be returned. Valid values are 0, 1, and
940
+ # 3. Requests specifying an invalid value will be rejected. Requests for
941
+ # policies with any conditional bindings must specify version 3. Policies
942
+ # without any conditional bindings may specify any valid value or leave the
943
+ # field unset. To learn which resources support conditions in their IAM policies,
944
+ # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
945
+ # resource-policies).
946
+ # @param [String] fields
947
+ # Selector specifying which fields to include in a partial response.
948
+ # @param [String] quota_user
949
+ # Available to use for quota purposes for server-side applications. Can be any
950
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
951
+ # @param [Google::Apis::RequestOptions] options
952
+ # Request-specific options
953
+ #
954
+ # @yield [result, err] Result & error if block supplied
955
+ # @yieldparam result [Google::Apis::ConnectorsV1::Policy] parsed result object
956
+ # @yieldparam err [StandardError] error object if request failed
957
+ #
958
+ # @return [Google::Apis::ConnectorsV1::Policy]
959
+ #
960
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
961
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
962
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
963
+ def get_project_location_provider_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
964
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
965
+ command.response_representation = Google::Apis::ConnectorsV1::Policy::Representation
966
+ command.response_class = Google::Apis::ConnectorsV1::Policy
967
+ command.params['resource'] = resource unless resource.nil?
968
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Sets the access control policy on the specified resource. Replaces any
975
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
976
+ # PERMISSION_DENIED` errors.
977
+ # @param [String] resource
978
+ # REQUIRED: The resource for which the policy is being specified. See the
979
+ # operation documentation for the appropriate value for this field.
980
+ # @param [Google::Apis::ConnectorsV1::SetIamPolicyRequest] set_iam_policy_request_object
981
+ # @param [String] fields
982
+ # Selector specifying which fields to include in a partial response.
983
+ # @param [String] quota_user
984
+ # Available to use for quota purposes for server-side applications. Can be any
985
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
986
+ # @param [Google::Apis::RequestOptions] options
987
+ # Request-specific options
988
+ #
989
+ # @yield [result, err] Result & error if block supplied
990
+ # @yieldparam result [Google::Apis::ConnectorsV1::Policy] parsed result object
991
+ # @yieldparam err [StandardError] error object if request failed
992
+ #
993
+ # @return [Google::Apis::ConnectorsV1::Policy]
994
+ #
995
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
996
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
997
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
998
+ def set_provider_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
999
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1000
+ command.request_representation = Google::Apis::ConnectorsV1::SetIamPolicyRequest::Representation
1001
+ command.request_object = set_iam_policy_request_object
1002
+ command.response_representation = Google::Apis::ConnectorsV1::Policy::Representation
1003
+ command.response_class = Google::Apis::ConnectorsV1::Policy
1004
+ command.params['resource'] = resource unless resource.nil?
1005
+ command.query['fields'] = fields unless fields.nil?
1006
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1007
+ execute_or_queue_command(command, &block)
1008
+ end
1009
+
1010
+ # Returns permissions that a caller has on the specified resource. If the
1011
+ # resource does not exist, this will return an empty set of permissions, not a `
1012
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1013
+ # permission-aware UIs and command-line tools, not for authorization checking.
1014
+ # This operation may "fail open" without warning.
1015
+ # @param [String] resource
1016
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1017
+ # operation documentation for the appropriate value for this field.
1018
+ # @param [Google::Apis::ConnectorsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1019
+ # @param [String] fields
1020
+ # Selector specifying which fields to include in a partial response.
1021
+ # @param [String] quota_user
1022
+ # Available to use for quota purposes for server-side applications. Can be any
1023
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1024
+ # @param [Google::Apis::RequestOptions] options
1025
+ # Request-specific options
1026
+ #
1027
+ # @yield [result, err] Result & error if block supplied
1028
+ # @yieldparam result [Google::Apis::ConnectorsV1::TestIamPermissionsResponse] parsed result object
1029
+ # @yieldparam err [StandardError] error object if request failed
1030
+ #
1031
+ # @return [Google::Apis::ConnectorsV1::TestIamPermissionsResponse]
1032
+ #
1033
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1034
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1035
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1036
+ def test_provider_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1037
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1038
+ command.request_representation = Google::Apis::ConnectorsV1::TestIamPermissionsRequest::Representation
1039
+ command.request_object = test_iam_permissions_request_object
1040
+ command.response_representation = Google::Apis::ConnectorsV1::TestIamPermissionsResponse::Representation
1041
+ command.response_class = Google::Apis::ConnectorsV1::TestIamPermissionsResponse
1042
+ command.params['resource'] = resource unless resource.nil?
1043
+ command.query['fields'] = fields unless fields.nil?
1044
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1045
+ execute_or_queue_command(command, &block)
1046
+ end
1047
+
1048
+ protected
1049
+
1050
+ def apply_command_defaults(command)
1051
+ command.query['key'] = key unless key.nil?
1052
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1053
+ end
1054
+ end
1055
+ end
1056
+ end
1057
+ end