google-apis-saasservicemgmt_v1beta1 0.1.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.
@@ -0,0 +1,2034 @@
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 SaasservicemgmtV1beta1
23
+ # SaaS Runtime API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/saasservicemgmt_v1beta1'
29
+ #
30
+ # Saasservicemgmt = Google::Apis::SaasservicemgmtV1beta1 # Alias the module
31
+ # service = Saasservicemgmt::SaaSServiceManagementService.new
32
+ #
33
+ # @see https://cloud.google.com/saas-runtime/docs
34
+ class SaaSServiceManagementService < Google::Apis::Core::BaseService
35
+ DEFAULT_ENDPOINT_TEMPLATE = "https://saasservicemgmt.$UNIVERSE_DOMAIN$/"
36
+
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
49
+ client_name: 'google-apis-saasservicemgmt_v1beta1',
50
+ client_version: Google::Apis::SaasservicemgmtV1beta1::GEM_VERSION)
51
+ @batch_path = 'batch'
52
+ end
53
+
54
+ # Gets information about a location.
55
+ # @param [String] name
56
+ # Resource name for the location.
57
+ # @param [String] fields
58
+ # Selector specifying which fields to include in a partial response.
59
+ # @param [String] quota_user
60
+ # Available to use for quota purposes for server-side applications. Can be any
61
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
62
+ # @param [Google::Apis::RequestOptions] options
63
+ # Request-specific options
64
+ #
65
+ # @yield [result, err] Result & error if block supplied
66
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::GoogleCloudLocationLocation] parsed result object
67
+ # @yieldparam err [StandardError] error object if request failed
68
+ #
69
+ # @return [Google::Apis::SaasservicemgmtV1beta1::GoogleCloudLocationLocation]
70
+ #
71
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
72
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
73
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
74
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
75
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
76
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::GoogleCloudLocationLocation::Representation
77
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::GoogleCloudLocationLocation
78
+ command.params['name'] = name unless name.nil?
79
+ command.query['fields'] = fields unless fields.nil?
80
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
81
+ execute_or_queue_command(command, &block)
82
+ end
83
+
84
+ # Lists information about the supported locations for this service.
85
+ # @param [String] name
86
+ # The resource that owns the locations collection, if applicable.
87
+ # @param [Array<String>, String] extra_location_types
88
+ # Optional. A list of extra location types that should be used as conditions for
89
+ # controlling the visibility of the locations.
90
+ # @param [String] filter
91
+ # A filter to narrow down results to a preferred subset. The filtering language
92
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
93
+ # in [AIP-160](https://google.aip.dev/160).
94
+ # @param [Fixnum] page_size
95
+ # The maximum number of results to return. If not set, the service selects a
96
+ # default.
97
+ # @param [String] page_token
98
+ # A page token received from the `next_page_token` field in the response. Send
99
+ # that page token to receive the subsequent page.
100
+ # @param [String] fields
101
+ # Selector specifying which fields to include in a partial response.
102
+ # @param [String] quota_user
103
+ # Available to use for quota purposes for server-side applications. Can be any
104
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
105
+ # @param [Google::Apis::RequestOptions] options
106
+ # Request-specific options
107
+ #
108
+ # @yield [result, err] Result & error if block supplied
109
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListLocationsResponse] parsed result object
110
+ # @yieldparam err [StandardError] error object if request failed
111
+ #
112
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListLocationsResponse]
113
+ #
114
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
115
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
116
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
117
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
118
+ command = make_simple_command(:get, 'v1beta1/{+name}/locations', options)
119
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListLocationsResponse::Representation
120
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListLocationsResponse
121
+ command.params['name'] = name unless name.nil?
122
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
123
+ command.query['filter'] = filter unless filter.nil?
124
+ command.query['pageSize'] = page_size unless page_size.nil?
125
+ command.query['pageToken'] = page_token unless page_token.nil?
126
+ command.query['fields'] = fields unless fields.nil?
127
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
128
+ execute_or_queue_command(command, &block)
129
+ end
130
+
131
+ # Create a new release.
132
+ # @param [String] parent
133
+ # Required. The parent of the release.
134
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Release] release_object
135
+ # @param [String] release_id
136
+ # Required. The ID value for the new release.
137
+ # @param [String] request_id
138
+ # An optional request ID to identify requests. Specify a unique request ID so
139
+ # that if you must retry your request, the server will know to ignore the
140
+ # request if it has already been completed. The server will guarantee that for
141
+ # at least 60 minutes since the first request. For example, consider a situation
142
+ # where you make an initial request and the request times out. If you make the
143
+ # request again with the same request ID, the server can check if original
144
+ # operation with the same request ID was received, and if so, will ignore the
145
+ # second request. This prevents clients from accidentally creating duplicate
146
+ # commitments. The request ID must be a valid UUID with the exception that zero
147
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
148
+ # @param [Boolean] validate_only
149
+ # If "validate_only" is set to true, the service will try to validate that this
150
+ # request would succeed, but will not actually make changes.
151
+ # @param [String] fields
152
+ # Selector specifying which fields to include in a partial response.
153
+ # @param [String] quota_user
154
+ # Available to use for quota purposes for server-side applications. Can be any
155
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
156
+ # @param [Google::Apis::RequestOptions] options
157
+ # Request-specific options
158
+ #
159
+ # @yield [result, err] Result & error if block supplied
160
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Release] parsed result object
161
+ # @yieldparam err [StandardError] error object if request failed
162
+ #
163
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Release]
164
+ #
165
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
166
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
167
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
168
+ def create_project_location_release(parent, release_object = nil, release_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
169
+ command = make_simple_command(:post, 'v1beta1/{+parent}/releases', options)
170
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Release::Representation
171
+ command.request_object = release_object
172
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Release::Representation
173
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Release
174
+ command.params['parent'] = parent unless parent.nil?
175
+ command.query['releaseId'] = release_id unless release_id.nil?
176
+ command.query['requestId'] = request_id unless request_id.nil?
177
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
178
+ command.query['fields'] = fields unless fields.nil?
179
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
180
+ execute_or_queue_command(command, &block)
181
+ end
182
+
183
+ # Delete a single release.
184
+ # @param [String] name
185
+ # Required. The resource name of the resource within a service.
186
+ # @param [String] etag
187
+ # The etag known to the client for the expected state of the release. This is
188
+ # used with state-changing methods to prevent accidental overwrites when
189
+ # multiple user agents might be acting in parallel on the same resource. An etag
190
+ # wildcard provide optimistic concurrency based on the expected existence of the
191
+ # release. The Any wildcard (`*`) requires that the resource must already exists,
192
+ # and the Not Any wildcard (`!*`) requires that it must not.
193
+ # @param [String] request_id
194
+ # An optional request ID to identify requests. Specify a unique request ID so
195
+ # that if you must retry your request, the server will know to ignore the
196
+ # request if it has already been completed. The server will guarantee that for
197
+ # at least 60 minutes since the first request. For example, consider a situation
198
+ # where you make an initial request and the request times out. If you make the
199
+ # request again with the same request ID, the server can check if original
200
+ # operation with the same request ID was received, and if so, will ignore the
201
+ # second request. This prevents clients from accidentally creating duplicate
202
+ # commitments. The request ID must be a valid UUID with the exception that zero
203
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
204
+ # @param [Boolean] validate_only
205
+ # If "validate_only" is set to true, the service will try to validate that this
206
+ # request would succeed, but will not actually make changes.
207
+ # @param [String] fields
208
+ # Selector specifying which fields to include in a partial response.
209
+ # @param [String] quota_user
210
+ # Available to use for quota purposes for server-side applications. Can be any
211
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
212
+ # @param [Google::Apis::RequestOptions] options
213
+ # Request-specific options
214
+ #
215
+ # @yield [result, err] Result & error if block supplied
216
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
217
+ # @yieldparam err [StandardError] error object if request failed
218
+ #
219
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
220
+ #
221
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
222
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
223
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
224
+ def delete_project_location_release(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
225
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
226
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
227
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
228
+ command.params['name'] = name unless name.nil?
229
+ command.query['etag'] = etag unless etag.nil?
230
+ command.query['requestId'] = request_id unless request_id.nil?
231
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
232
+ command.query['fields'] = fields unless fields.nil?
233
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
234
+ execute_or_queue_command(command, &block)
235
+ end
236
+
237
+ # Retrieve a single release.
238
+ # @param [String] name
239
+ # Required. The resource name of the resource within a service.
240
+ # @param [String] fields
241
+ # Selector specifying which fields to include in a partial response.
242
+ # @param [String] quota_user
243
+ # Available to use for quota purposes for server-side applications. Can be any
244
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
245
+ # @param [Google::Apis::RequestOptions] options
246
+ # Request-specific options
247
+ #
248
+ # @yield [result, err] Result & error if block supplied
249
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Release] parsed result object
250
+ # @yieldparam err [StandardError] error object if request failed
251
+ #
252
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Release]
253
+ #
254
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
255
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
256
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
257
+ def get_project_location_release(name, fields: nil, quota_user: nil, options: nil, &block)
258
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
259
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Release::Representation
260
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Release
261
+ command.params['name'] = name unless name.nil?
262
+ command.query['fields'] = fields unless fields.nil?
263
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
264
+ execute_or_queue_command(command, &block)
265
+ end
266
+
267
+ # Retrieve a collection of releases.
268
+ # @param [String] parent
269
+ # Required. The parent of the release.
270
+ # @param [String] filter
271
+ # Filter the list as specified in https://google.aip.dev/160.
272
+ # @param [String] order_by
273
+ # Order results as specified in https://google.aip.dev/132.
274
+ # @param [Fixnum] page_size
275
+ # The maximum number of releases to send per page.
276
+ # @param [String] page_token
277
+ # The page token: If the next_page_token from a previous response is provided,
278
+ # this request will send the subsequent page.
279
+ # @param [String] fields
280
+ # Selector specifying which fields to include in a partial response.
281
+ # @param [String] quota_user
282
+ # Available to use for quota purposes for server-side applications. Can be any
283
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
284
+ # @param [Google::Apis::RequestOptions] options
285
+ # Request-specific options
286
+ #
287
+ # @yield [result, err] Result & error if block supplied
288
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListReleasesResponse] parsed result object
289
+ # @yieldparam err [StandardError] error object if request failed
290
+ #
291
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListReleasesResponse]
292
+ #
293
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
294
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
295
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
296
+ def list_project_location_releases(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
297
+ command = make_simple_command(:get, 'v1beta1/{+parent}/releases', options)
298
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListReleasesResponse::Representation
299
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListReleasesResponse
300
+ command.params['parent'] = parent unless parent.nil?
301
+ command.query['filter'] = filter unless filter.nil?
302
+ command.query['orderBy'] = order_by unless order_by.nil?
303
+ command.query['pageSize'] = page_size unless page_size.nil?
304
+ command.query['pageToken'] = page_token unless page_token.nil?
305
+ command.query['fields'] = fields unless fields.nil?
306
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
307
+ execute_or_queue_command(command, &block)
308
+ end
309
+
310
+ # Update a single release.
311
+ # @param [String] name
312
+ # Identifier. The resource name (full URI of the resource) following the
313
+ # standard naming scheme: "projects/`project`/locations/`location`/releases/`
314
+ # release`"
315
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Release] release_object
316
+ # @param [String] request_id
317
+ # An optional request ID to identify requests. Specify a unique request ID so
318
+ # that if you must retry your request, the server will know to ignore the
319
+ # request if it has already been completed. The server will guarantee that for
320
+ # at least 60 minutes since the first request. For example, consider a situation
321
+ # where you make an initial request and the request times out. If you make the
322
+ # request again with the same request ID, the server can check if original
323
+ # operation with the same request ID was received, and if so, will ignore the
324
+ # second request. This prevents clients from accidentally creating duplicate
325
+ # commitments. The request ID must be a valid UUID with the exception that zero
326
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
327
+ # @param [String] update_mask
328
+ # Field mask is used to specify the fields to be overwritten in the Release
329
+ # resource by the update. The fields specified in the update_mask are relative
330
+ # to the resource, not the full request. A field will be overwritten if it is in
331
+ # the mask. If the user does not provide a mask then all fields in the Release
332
+ # will be overwritten.
333
+ # @param [Boolean] validate_only
334
+ # If "validate_only" is set to true, the service will try to validate that this
335
+ # request would succeed, but will not actually make changes.
336
+ # @param [String] fields
337
+ # Selector specifying which fields to include in a partial response.
338
+ # @param [String] quota_user
339
+ # Available to use for quota purposes for server-side applications. Can be any
340
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
341
+ # @param [Google::Apis::RequestOptions] options
342
+ # Request-specific options
343
+ #
344
+ # @yield [result, err] Result & error if block supplied
345
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Release] parsed result object
346
+ # @yieldparam err [StandardError] error object if request failed
347
+ #
348
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Release]
349
+ #
350
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
351
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
352
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
353
+ def patch_project_location_release(name, release_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
354
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
355
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Release::Representation
356
+ command.request_object = release_object
357
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Release::Representation
358
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Release
359
+ command.params['name'] = name unless name.nil?
360
+ command.query['requestId'] = request_id unless request_id.nil?
361
+ command.query['updateMask'] = update_mask unless update_mask.nil?
362
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
363
+ command.query['fields'] = fields unless fields.nil?
364
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
365
+ execute_or_queue_command(command, &block)
366
+ end
367
+
368
+ # Create a new rollout kind.
369
+ # @param [String] parent
370
+ # Required. The parent of the rollout kind.
371
+ # @param [Google::Apis::SaasservicemgmtV1beta1::RolloutKind] rollout_kind_object
372
+ # @param [String] request_id
373
+ # An optional request ID to identify requests. Specify a unique request ID so
374
+ # that if you must retry your request, the server will know to ignore the
375
+ # request if it has already been completed. The server will guarantee that for
376
+ # at least 60 minutes since the first request. For example, consider a situation
377
+ # where you make an initial request and the request times out. If you make the
378
+ # request again with the same request ID, the server can check if original
379
+ # operation with the same request ID was received, and if so, will ignore the
380
+ # second request. This prevents clients from accidentally creating duplicate
381
+ # commitments. The request ID must be a valid UUID with the exception that zero
382
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
383
+ # @param [String] rollout_kind_id
384
+ # Required. The ID value for the new rollout kind.
385
+ # @param [Boolean] validate_only
386
+ # If "validate_only" is set to true, the service will try to validate that this
387
+ # request would succeed, but will not actually make changes.
388
+ # @param [String] fields
389
+ # Selector specifying which fields to include in a partial response.
390
+ # @param [String] quota_user
391
+ # Available to use for quota purposes for server-side applications. Can be any
392
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
393
+ # @param [Google::Apis::RequestOptions] options
394
+ # Request-specific options
395
+ #
396
+ # @yield [result, err] Result & error if block supplied
397
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::RolloutKind] parsed result object
398
+ # @yieldparam err [StandardError] error object if request failed
399
+ #
400
+ # @return [Google::Apis::SaasservicemgmtV1beta1::RolloutKind]
401
+ #
402
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
403
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
404
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
405
+ def create_project_location_rollout_kind(parent, rollout_kind_object = nil, request_id: nil, rollout_kind_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
406
+ command = make_simple_command(:post, 'v1beta1/{+parent}/rolloutKinds', options)
407
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::RolloutKind::Representation
408
+ command.request_object = rollout_kind_object
409
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::RolloutKind::Representation
410
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::RolloutKind
411
+ command.params['parent'] = parent unless parent.nil?
412
+ command.query['requestId'] = request_id unless request_id.nil?
413
+ command.query['rolloutKindId'] = rollout_kind_id unless rollout_kind_id.nil?
414
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
415
+ command.query['fields'] = fields unless fields.nil?
416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
417
+ execute_or_queue_command(command, &block)
418
+ end
419
+
420
+ # Delete a single rollout kind.
421
+ # @param [String] name
422
+ # Required. The resource name of the resource within a service.
423
+ # @param [String] etag
424
+ # The etag known to the client for the expected state of the rollout kind. This
425
+ # is used with state-changing methods to prevent accidental overwrites when
426
+ # multiple user agents might be acting in parallel on the same resource. An etag
427
+ # wildcard provide optimistic concurrency based on the expected existence of the
428
+ # rollout kind. The Any wildcard (`*`) requires that the resource must already
429
+ # exists, and the Not Any wildcard (`!*`) requires that it must not.
430
+ # @param [String] request_id
431
+ # An optional request ID to identify requests. Specify a unique request ID so
432
+ # that if you must retry your request, the server will know to ignore the
433
+ # request if it has already been completed. The server will guarantee that for
434
+ # at least 60 minutes since the first request. For example, consider a situation
435
+ # where you make an initial request and the request times out. If you make the
436
+ # request again with the same request ID, the server can check if original
437
+ # operation with the same request ID was received, and if so, will ignore the
438
+ # second request. This prevents clients from accidentally creating duplicate
439
+ # commitments. The request ID must be a valid UUID with the exception that zero
440
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
441
+ # @param [Boolean] validate_only
442
+ # If "validate_only" is set to true, the service will try to validate that this
443
+ # request would succeed, but will not actually make changes.
444
+ # @param [String] fields
445
+ # Selector specifying which fields to include in a partial response.
446
+ # @param [String] quota_user
447
+ # Available to use for quota purposes for server-side applications. Can be any
448
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
449
+ # @param [Google::Apis::RequestOptions] options
450
+ # Request-specific options
451
+ #
452
+ # @yield [result, err] Result & error if block supplied
453
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
454
+ # @yieldparam err [StandardError] error object if request failed
455
+ #
456
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
457
+ #
458
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
459
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
460
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
461
+ def delete_project_location_rollout_kind(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
462
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
463
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
464
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
465
+ command.params['name'] = name unless name.nil?
466
+ command.query['etag'] = etag unless etag.nil?
467
+ command.query['requestId'] = request_id unless request_id.nil?
468
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
469
+ command.query['fields'] = fields unless fields.nil?
470
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
471
+ execute_or_queue_command(command, &block)
472
+ end
473
+
474
+ # Retrieve a single rollout kind.
475
+ # @param [String] name
476
+ # Required. The resource name of the resource within a service.
477
+ # @param [String] fields
478
+ # Selector specifying which fields to include in a partial response.
479
+ # @param [String] quota_user
480
+ # Available to use for quota purposes for server-side applications. Can be any
481
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
482
+ # @param [Google::Apis::RequestOptions] options
483
+ # Request-specific options
484
+ #
485
+ # @yield [result, err] Result & error if block supplied
486
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::RolloutKind] parsed result object
487
+ # @yieldparam err [StandardError] error object if request failed
488
+ #
489
+ # @return [Google::Apis::SaasservicemgmtV1beta1::RolloutKind]
490
+ #
491
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
492
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
493
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
494
+ def get_project_location_rollout_kind(name, fields: nil, quota_user: nil, options: nil, &block)
495
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
496
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::RolloutKind::Representation
497
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::RolloutKind
498
+ command.params['name'] = name unless name.nil?
499
+ command.query['fields'] = fields unless fields.nil?
500
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
501
+ execute_or_queue_command(command, &block)
502
+ end
503
+
504
+ # Retrieve a collection of rollout kinds.
505
+ # @param [String] parent
506
+ # Required. The parent of the rollout kind.
507
+ # @param [String] filter
508
+ # Filter the list as specified in https://google.aip.dev/160.
509
+ # @param [String] order_by
510
+ # Order results as specified in https://google.aip.dev/132.
511
+ # @param [Fixnum] page_size
512
+ # The maximum number of rollout kinds to send per page.
513
+ # @param [String] page_token
514
+ # The page token: If the next_page_token from a previous response is provided,
515
+ # this request will send the subsequent page.
516
+ # @param [String] fields
517
+ # Selector specifying which fields to include in a partial response.
518
+ # @param [String] quota_user
519
+ # Available to use for quota purposes for server-side applications. Can be any
520
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
521
+ # @param [Google::Apis::RequestOptions] options
522
+ # Request-specific options
523
+ #
524
+ # @yield [result, err] Result & error if block supplied
525
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListRolloutKindsResponse] parsed result object
526
+ # @yieldparam err [StandardError] error object if request failed
527
+ #
528
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListRolloutKindsResponse]
529
+ #
530
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
531
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
532
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
533
+ def list_project_location_rollout_kinds(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
534
+ command = make_simple_command(:get, 'v1beta1/{+parent}/rolloutKinds', options)
535
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListRolloutKindsResponse::Representation
536
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListRolloutKindsResponse
537
+ command.params['parent'] = parent unless parent.nil?
538
+ command.query['filter'] = filter unless filter.nil?
539
+ command.query['orderBy'] = order_by unless order_by.nil?
540
+ command.query['pageSize'] = page_size unless page_size.nil?
541
+ command.query['pageToken'] = page_token unless page_token.nil?
542
+ command.query['fields'] = fields unless fields.nil?
543
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
544
+ execute_or_queue_command(command, &block)
545
+ end
546
+
547
+ # Update a single rollout kind.
548
+ # @param [String] name
549
+ # Identifier. The resource name (full URI of the resource) following the
550
+ # standard naming scheme: "projects/`project`/locations/`location`/rolloutKinds/`
551
+ # rollout_kind_id`"
552
+ # @param [Google::Apis::SaasservicemgmtV1beta1::RolloutKind] rollout_kind_object
553
+ # @param [String] request_id
554
+ # An optional request ID to identify requests. Specify a unique request ID so
555
+ # that if you must retry your request, the server will know to ignore the
556
+ # request if it has already been completed. The server will guarantee that for
557
+ # at least 60 minutes since the first request. For example, consider a situation
558
+ # where you make an initial request and the request times out. If you make the
559
+ # request again with the same request ID, the server can check if original
560
+ # operation with the same request ID was received, and if so, will ignore the
561
+ # second request. This prevents clients from accidentally creating duplicate
562
+ # commitments. The request ID must be a valid UUID with the exception that zero
563
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
564
+ # @param [String] update_mask
565
+ # Field mask is used to specify the fields to be overwritten in the RolloutKind
566
+ # resource by the update. The fields specified in the update_mask are relative
567
+ # to the resource, not the full request. A field will be overwritten if it is in
568
+ # the mask. If the user does not provide a mask then all fields in the
569
+ # RolloutKind will be overwritten.
570
+ # @param [Boolean] validate_only
571
+ # If "validate_only" is set to true, the service will try to validate that this
572
+ # request would succeed, but will not actually make changes.
573
+ # @param [String] fields
574
+ # Selector specifying which fields to include in a partial response.
575
+ # @param [String] quota_user
576
+ # Available to use for quota purposes for server-side applications. Can be any
577
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
578
+ # @param [Google::Apis::RequestOptions] options
579
+ # Request-specific options
580
+ #
581
+ # @yield [result, err] Result & error if block supplied
582
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::RolloutKind] parsed result object
583
+ # @yieldparam err [StandardError] error object if request failed
584
+ #
585
+ # @return [Google::Apis::SaasservicemgmtV1beta1::RolloutKind]
586
+ #
587
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
588
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
589
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
590
+ def patch_project_location_rollout_kind(name, rollout_kind_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
591
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
592
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::RolloutKind::Representation
593
+ command.request_object = rollout_kind_object
594
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::RolloutKind::Representation
595
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::RolloutKind
596
+ command.params['name'] = name unless name.nil?
597
+ command.query['requestId'] = request_id unless request_id.nil?
598
+ command.query['updateMask'] = update_mask unless update_mask.nil?
599
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
600
+ command.query['fields'] = fields unless fields.nil?
601
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
602
+ execute_or_queue_command(command, &block)
603
+ end
604
+
605
+ # Create a new rollout.
606
+ # @param [String] parent
607
+ # Required. The parent of the rollout.
608
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Rollout] rollout_object
609
+ # @param [String] request_id
610
+ # An optional request ID to identify requests. Specify a unique request ID so
611
+ # that if you must retry your request, the server will know to ignore the
612
+ # request if it has already been completed. The server will guarantee that for
613
+ # at least 60 minutes since the first request. For example, consider a situation
614
+ # where you make an initial request and the request times out. If you make the
615
+ # request again with the same request ID, the server can check if original
616
+ # operation with the same request ID was received, and if so, will ignore the
617
+ # second request. This prevents clients from accidentally creating duplicate
618
+ # commitments. The request ID must be a valid UUID with the exception that zero
619
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
620
+ # @param [String] rollout_id
621
+ # Required. The ID value for the new rollout.
622
+ # @param [Boolean] validate_only
623
+ # If "validate_only" is set to true, the service will try to validate that this
624
+ # request would succeed, but will not actually make changes.
625
+ # @param [String] fields
626
+ # Selector specifying which fields to include in a partial response.
627
+ # @param [String] quota_user
628
+ # Available to use for quota purposes for server-side applications. Can be any
629
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
630
+ # @param [Google::Apis::RequestOptions] options
631
+ # Request-specific options
632
+ #
633
+ # @yield [result, err] Result & error if block supplied
634
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Rollout] parsed result object
635
+ # @yieldparam err [StandardError] error object if request failed
636
+ #
637
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Rollout]
638
+ #
639
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
640
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
641
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
642
+ def create_project_location_rollout(parent, rollout_object = nil, request_id: nil, rollout_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
643
+ command = make_simple_command(:post, 'v1beta1/{+parent}/rollouts', options)
644
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Rollout::Representation
645
+ command.request_object = rollout_object
646
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Rollout::Representation
647
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Rollout
648
+ command.params['parent'] = parent unless parent.nil?
649
+ command.query['requestId'] = request_id unless request_id.nil?
650
+ command.query['rolloutId'] = rollout_id unless rollout_id.nil?
651
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
652
+ command.query['fields'] = fields unless fields.nil?
653
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
654
+ execute_or_queue_command(command, &block)
655
+ end
656
+
657
+ # Delete a single rollout.
658
+ # @param [String] name
659
+ # Required. The resource name of the resource within a service.
660
+ # @param [String] etag
661
+ # The etag known to the client for the expected state of the rollout. This is
662
+ # used with state-changing methods to prevent accidental overwrites when
663
+ # multiple user agents might be acting in parallel on the same resource. An etag
664
+ # wildcard provide optimistic concurrency based on the expected existence of the
665
+ # rollout. The Any wildcard (`*`) requires that the resource must already exists,
666
+ # and the Not Any wildcard (`!*`) requires that it must not.
667
+ # @param [String] request_id
668
+ # An optional request ID to identify requests. Specify a unique request ID so
669
+ # that if you must retry your request, the server will know to ignore the
670
+ # request if it has already been completed. The server will guarantee that for
671
+ # at least 60 minutes since the first request. For example, consider a situation
672
+ # where you make an initial request and the request times out. If you make the
673
+ # request again with the same request ID, the server can check if original
674
+ # operation with the same request ID was received, and if so, will ignore the
675
+ # second request. This prevents clients from accidentally creating duplicate
676
+ # commitments. The request ID must be a valid UUID with the exception that zero
677
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
678
+ # @param [Boolean] validate_only
679
+ # If "validate_only" is set to true, the service will try to validate that this
680
+ # request would succeed, but will not actually make changes.
681
+ # @param [String] fields
682
+ # Selector specifying which fields to include in a partial response.
683
+ # @param [String] quota_user
684
+ # Available to use for quota purposes for server-side applications. Can be any
685
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
686
+ # @param [Google::Apis::RequestOptions] options
687
+ # Request-specific options
688
+ #
689
+ # @yield [result, err] Result & error if block supplied
690
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
691
+ # @yieldparam err [StandardError] error object if request failed
692
+ #
693
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
694
+ #
695
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
696
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
697
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
698
+ def delete_project_location_rollout(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
699
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
700
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
701
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
702
+ command.params['name'] = name unless name.nil?
703
+ command.query['etag'] = etag unless etag.nil?
704
+ command.query['requestId'] = request_id unless request_id.nil?
705
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
706
+ command.query['fields'] = fields unless fields.nil?
707
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
708
+ execute_or_queue_command(command, &block)
709
+ end
710
+
711
+ # Retrieve a single rollout.
712
+ # @param [String] name
713
+ # Required. The resource name of the resource within a service.
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::SaasservicemgmtV1beta1::Rollout] parsed result object
724
+ # @yieldparam err [StandardError] error object if request failed
725
+ #
726
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Rollout]
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_rollout(name, fields: nil, quota_user: nil, options: nil, &block)
732
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
733
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Rollout::Representation
734
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Rollout
735
+ command.params['name'] = name unless name.nil?
736
+ command.query['fields'] = fields unless fields.nil?
737
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
738
+ execute_or_queue_command(command, &block)
739
+ end
740
+
741
+ # Retrieve a collection of rollouts.
742
+ # @param [String] parent
743
+ # Required. The parent of the rollout.
744
+ # @param [String] filter
745
+ # Filter the list as specified in https://google.aip.dev/160.
746
+ # @param [String] order_by
747
+ # Order results as specified in https://google.aip.dev/132.
748
+ # @param [Fixnum] page_size
749
+ # The maximum number of rollouts to send per page.
750
+ # @param [String] page_token
751
+ # The page token: If the next_page_token from a previous response is provided,
752
+ # this request will send the subsequent page.
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::SaasservicemgmtV1beta1::ListRolloutsResponse] parsed result object
763
+ # @yieldparam err [StandardError] error object if request failed
764
+ #
765
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListRolloutsResponse]
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_rollouts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
771
+ command = make_simple_command(:get, 'v1beta1/{+parent}/rollouts', options)
772
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListRolloutsResponse::Representation
773
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListRolloutsResponse
774
+ command.params['parent'] = parent unless parent.nil?
775
+ command.query['filter'] = filter unless filter.nil?
776
+ command.query['orderBy'] = order_by unless order_by.nil?
777
+ command.query['pageSize'] = page_size unless page_size.nil?
778
+ command.query['pageToken'] = page_token unless page_token.nil?
779
+ command.query['fields'] = fields unless fields.nil?
780
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
781
+ execute_or_queue_command(command, &block)
782
+ end
783
+
784
+ # Update a single rollout.
785
+ # @param [String] name
786
+ # Identifier. The resource name (full URI of the resource) following the
787
+ # standard naming scheme: "projects/`project`/locations/`location`/rollout/`
788
+ # rollout_id`"
789
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Rollout] rollout_object
790
+ # @param [String] request_id
791
+ # An optional request ID to identify requests. Specify a unique request ID so
792
+ # that if you must retry your request, the server will know to ignore the
793
+ # request if it has already been completed. The server will guarantee that for
794
+ # at least 60 minutes since the first request. For example, consider a situation
795
+ # where you make an initial request and the request times out. If you make the
796
+ # request again with the same request ID, the server can check if original
797
+ # operation with the same request ID was received, and if so, will ignore the
798
+ # second request. This prevents clients from accidentally creating duplicate
799
+ # commitments. The request ID must be a valid UUID with the exception that zero
800
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
801
+ # @param [String] update_mask
802
+ # Field mask is used to specify the fields to be overwritten in the Rollout
803
+ # resource by the update. The fields specified in the update_mask are relative
804
+ # to the resource, not the full request. A field will be overwritten if it is in
805
+ # the mask. If the user does not provide a mask then all fields in the Rollout
806
+ # will be overwritten.
807
+ # @param [Boolean] validate_only
808
+ # If "validate_only" is set to true, the service will try to validate that this
809
+ # request would succeed, but will not actually make changes.
810
+ # @param [String] fields
811
+ # Selector specifying which fields to include in a partial response.
812
+ # @param [String] quota_user
813
+ # Available to use for quota purposes for server-side applications. Can be any
814
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
815
+ # @param [Google::Apis::RequestOptions] options
816
+ # Request-specific options
817
+ #
818
+ # @yield [result, err] Result & error if block supplied
819
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Rollout] parsed result object
820
+ # @yieldparam err [StandardError] error object if request failed
821
+ #
822
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Rollout]
823
+ #
824
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
825
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
826
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
827
+ def patch_project_location_rollout(name, rollout_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
828
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
829
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Rollout::Representation
830
+ command.request_object = rollout_object
831
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Rollout::Representation
832
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Rollout
833
+ command.params['name'] = name unless name.nil?
834
+ command.query['requestId'] = request_id unless request_id.nil?
835
+ command.query['updateMask'] = update_mask unless update_mask.nil?
836
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
837
+ command.query['fields'] = fields unless fields.nil?
838
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
839
+ execute_or_queue_command(command, &block)
840
+ end
841
+
842
+ # Create a new saas.
843
+ # @param [String] parent
844
+ # Required. The parent of the saas.
845
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Saas] saas_object
846
+ # @param [String] request_id
847
+ # An optional request ID to identify requests. Specify a unique request ID so
848
+ # that if you must retry your request, the server will know to ignore the
849
+ # request if it has already been completed. The server will guarantee that for
850
+ # at least 60 minutes since the first request. For example, consider a situation
851
+ # where you make an initial request and the request times out. If you make the
852
+ # request again with the same request ID, the server can check if original
853
+ # operation with the same request ID was received, and if so, will ignore the
854
+ # second request. This prevents clients from accidentally creating duplicate
855
+ # commitments. The request ID must be a valid UUID with the exception that zero
856
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
857
+ # @param [String] saas_id
858
+ # Required. The ID value for the new saas.
859
+ # @param [Boolean] validate_only
860
+ # If "validate_only" is set to true, the service will try to validate that this
861
+ # request would succeed, but will not actually make changes.
862
+ # @param [String] fields
863
+ # Selector specifying which fields to include in a partial response.
864
+ # @param [String] quota_user
865
+ # Available to use for quota purposes for server-side applications. Can be any
866
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
867
+ # @param [Google::Apis::RequestOptions] options
868
+ # Request-specific options
869
+ #
870
+ # @yield [result, err] Result & error if block supplied
871
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Saas] parsed result object
872
+ # @yieldparam err [StandardError] error object if request failed
873
+ #
874
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Saas]
875
+ #
876
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
877
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
878
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
879
+ def create_project_location_saa(parent, saas_object = nil, request_id: nil, saas_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
880
+ command = make_simple_command(:post, 'v1beta1/{+parent}/saas', options)
881
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Saas::Representation
882
+ command.request_object = saas_object
883
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Saas::Representation
884
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Saas
885
+ command.params['parent'] = parent unless parent.nil?
886
+ command.query['requestId'] = request_id unless request_id.nil?
887
+ command.query['saasId'] = saas_id unless saas_id.nil?
888
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
889
+ command.query['fields'] = fields unless fields.nil?
890
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
891
+ execute_or_queue_command(command, &block)
892
+ end
893
+
894
+ # Delete a single saas.
895
+ # @param [String] name
896
+ # Required. The resource name of the resource within a service.
897
+ # @param [String] etag
898
+ # The etag known to the client for the expected state of the saas. This is used
899
+ # with state-changing methods to prevent accidental overwrites when multiple
900
+ # user agents might be acting in parallel on the same resource. An etag wildcard
901
+ # provide optimistic concurrency based on the expected existence of the saas.
902
+ # The Any wildcard (`*`) requires that the resource must already exists, and the
903
+ # Not Any wildcard (`!*`) requires that it must not.
904
+ # @param [String] request_id
905
+ # An optional request ID to identify requests. Specify a unique request ID so
906
+ # that if you must retry your request, the server will know to ignore the
907
+ # request if it has already been completed. The server will guarantee that for
908
+ # at least 60 minutes since the first request. For example, consider a situation
909
+ # where you make an initial request and the request times out. If you make the
910
+ # request again with the same request ID, the server can check if original
911
+ # operation with the same request ID was received, and if so, will ignore the
912
+ # second request. This prevents clients from accidentally creating duplicate
913
+ # commitments. The request ID must be a valid UUID with the exception that zero
914
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
915
+ # @param [Boolean] validate_only
916
+ # If "validate_only" is set to true, the service will try to validate that this
917
+ # request would succeed, but will not actually make changes.
918
+ # @param [String] fields
919
+ # Selector specifying which fields to include in a partial response.
920
+ # @param [String] quota_user
921
+ # Available to use for quota purposes for server-side applications. Can be any
922
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
923
+ # @param [Google::Apis::RequestOptions] options
924
+ # Request-specific options
925
+ #
926
+ # @yield [result, err] Result & error if block supplied
927
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
928
+ # @yieldparam err [StandardError] error object if request failed
929
+ #
930
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
931
+ #
932
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
933
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
934
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
935
+ def delete_project_location_saa(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
936
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
937
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
938
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
939
+ command.params['name'] = name unless name.nil?
940
+ command.query['etag'] = etag unless etag.nil?
941
+ command.query['requestId'] = request_id unless request_id.nil?
942
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
943
+ command.query['fields'] = fields unless fields.nil?
944
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
945
+ execute_or_queue_command(command, &block)
946
+ end
947
+
948
+ # Retrieve a single saas.
949
+ # @param [String] name
950
+ # Required. The resource name of the resource within a service.
951
+ # @param [String] fields
952
+ # Selector specifying which fields to include in a partial response.
953
+ # @param [String] quota_user
954
+ # Available to use for quota purposes for server-side applications. Can be any
955
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
956
+ # @param [Google::Apis::RequestOptions] options
957
+ # Request-specific options
958
+ #
959
+ # @yield [result, err] Result & error if block supplied
960
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Saas] parsed result object
961
+ # @yieldparam err [StandardError] error object if request failed
962
+ #
963
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Saas]
964
+ #
965
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
966
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
967
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
968
+ def get_project_location_saa(name, fields: nil, quota_user: nil, options: nil, &block)
969
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
970
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Saas::Representation
971
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Saas
972
+ command.params['name'] = name unless name.nil?
973
+ command.query['fields'] = fields unless fields.nil?
974
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
975
+ execute_or_queue_command(command, &block)
976
+ end
977
+
978
+ # Retrieve a collection of saas.
979
+ # @param [String] parent
980
+ # Required. The parent of the saas.
981
+ # @param [String] filter
982
+ # Filter the list as specified in https://google.aip.dev/160.
983
+ # @param [String] order_by
984
+ # Order results as specified in https://google.aip.dev/132.
985
+ # @param [Fixnum] page_size
986
+ # The maximum number of saas to send per page.
987
+ # @param [String] page_token
988
+ # The page token: If the next_page_token from a previous response is provided,
989
+ # this request will send the subsequent page.
990
+ # @param [String] fields
991
+ # Selector specifying which fields to include in a partial response.
992
+ # @param [String] quota_user
993
+ # Available to use for quota purposes for server-side applications. Can be any
994
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
995
+ # @param [Google::Apis::RequestOptions] options
996
+ # Request-specific options
997
+ #
998
+ # @yield [result, err] Result & error if block supplied
999
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListSaasResponse] parsed result object
1000
+ # @yieldparam err [StandardError] error object if request failed
1001
+ #
1002
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListSaasResponse]
1003
+ #
1004
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1005
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1006
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1007
+ def list_project_location_saas(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1008
+ command = make_simple_command(:get, 'v1beta1/{+parent}/saas', options)
1009
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListSaasResponse::Representation
1010
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListSaasResponse
1011
+ command.params['parent'] = parent unless parent.nil?
1012
+ command.query['filter'] = filter unless filter.nil?
1013
+ command.query['orderBy'] = order_by unless order_by.nil?
1014
+ command.query['pageSize'] = page_size unless page_size.nil?
1015
+ command.query['pageToken'] = page_token unless page_token.nil?
1016
+ command.query['fields'] = fields unless fields.nil?
1017
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1018
+ execute_or_queue_command(command, &block)
1019
+ end
1020
+
1021
+ # Update a single saas.
1022
+ # @param [String] name
1023
+ # Identifier. The resource name (full URI of the resource) following the
1024
+ # standard naming scheme: "projects/`project`/locations/`location`/saas/`saas`"
1025
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Saas] saas_object
1026
+ # @param [String] request_id
1027
+ # An optional request ID to identify requests. Specify a unique request ID so
1028
+ # that if you must retry your request, the server will know to ignore the
1029
+ # request if it has already been completed. The server will guarantee that for
1030
+ # at least 60 minutes since the first request. For example, consider a situation
1031
+ # where you make an initial request and the request times out. If you make the
1032
+ # request again with the same request ID, the server can check if original
1033
+ # operation with the same request ID was received, and if so, will ignore the
1034
+ # second request. This prevents clients from accidentally creating duplicate
1035
+ # commitments. The request ID must be a valid UUID with the exception that zero
1036
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1037
+ # @param [String] update_mask
1038
+ # Field mask is used to specify the fields to be overwritten in the Saas
1039
+ # resource by the update. The fields specified in the update_mask are relative
1040
+ # to the resource, not the full request. A field will be overwritten if it is in
1041
+ # the mask. If the user does not provide a mask then all fields in the Saas will
1042
+ # be overwritten.
1043
+ # @param [Boolean] validate_only
1044
+ # If "validate_only" is set to true, the service will try to validate that this
1045
+ # request would succeed, but will not actually make changes.
1046
+ # @param [String] fields
1047
+ # Selector specifying which fields to include in a partial response.
1048
+ # @param [String] quota_user
1049
+ # Available to use for quota purposes for server-side applications. Can be any
1050
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1051
+ # @param [Google::Apis::RequestOptions] options
1052
+ # Request-specific options
1053
+ #
1054
+ # @yield [result, err] Result & error if block supplied
1055
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Saas] parsed result object
1056
+ # @yieldparam err [StandardError] error object if request failed
1057
+ #
1058
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Saas]
1059
+ #
1060
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1061
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1062
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1063
+ def patch_project_location_saa(name, saas_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1064
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1065
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Saas::Representation
1066
+ command.request_object = saas_object
1067
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Saas::Representation
1068
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Saas
1069
+ command.params['name'] = name unless name.nil?
1070
+ command.query['requestId'] = request_id unless request_id.nil?
1071
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1072
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1073
+ command.query['fields'] = fields unless fields.nil?
1074
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1075
+ execute_or_queue_command(command, &block)
1076
+ end
1077
+
1078
+ # Create a new tenant.
1079
+ # @param [String] parent
1080
+ # Required. The parent of the tenant.
1081
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Tenant] tenant_object
1082
+ # @param [String] request_id
1083
+ # An optional request ID to identify requests. Specify a unique request ID so
1084
+ # that if you must retry your request, the server will know to ignore the
1085
+ # request if it has already been completed. The server will guarantee that for
1086
+ # at least 60 minutes since the first request. For example, consider a situation
1087
+ # where you make an initial request and the request times out. If you make the
1088
+ # request again with the same request ID, the server can check if original
1089
+ # operation with the same request ID was received, and if so, will ignore the
1090
+ # second request. This prevents clients from accidentally creating duplicate
1091
+ # commitments. The request ID must be a valid UUID with the exception that zero
1092
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1093
+ # @param [String] tenant_id
1094
+ # Required. The ID value for the new tenant.
1095
+ # @param [Boolean] validate_only
1096
+ # If "validate_only" is set to true, the service will try to validate that this
1097
+ # request would succeed, but will not actually make changes.
1098
+ # @param [String] fields
1099
+ # Selector specifying which fields to include in a partial response.
1100
+ # @param [String] quota_user
1101
+ # Available to use for quota purposes for server-side applications. Can be any
1102
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1103
+ # @param [Google::Apis::RequestOptions] options
1104
+ # Request-specific options
1105
+ #
1106
+ # @yield [result, err] Result & error if block supplied
1107
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Tenant] parsed result object
1108
+ # @yieldparam err [StandardError] error object if request failed
1109
+ #
1110
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Tenant]
1111
+ #
1112
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1113
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1114
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1115
+ def create_project_location_tenant(parent, tenant_object = nil, request_id: nil, tenant_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1116
+ command = make_simple_command(:post, 'v1beta1/{+parent}/tenants', options)
1117
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Tenant::Representation
1118
+ command.request_object = tenant_object
1119
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Tenant::Representation
1120
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Tenant
1121
+ command.params['parent'] = parent unless parent.nil?
1122
+ command.query['requestId'] = request_id unless request_id.nil?
1123
+ command.query['tenantId'] = tenant_id unless tenant_id.nil?
1124
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1125
+ command.query['fields'] = fields unless fields.nil?
1126
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1127
+ execute_or_queue_command(command, &block)
1128
+ end
1129
+
1130
+ # Delete a single tenant.
1131
+ # @param [String] name
1132
+ # Required. The resource name of the resource within a service.
1133
+ # @param [String] etag
1134
+ # The etag known to the client for the expected state of the tenant. This is
1135
+ # used with state-changing methods to prevent accidental overwrites when
1136
+ # multiple user agents might be acting in parallel on the same resource. An etag
1137
+ # wildcard provide optimistic concurrency based on the expected existence of the
1138
+ # tenant. The Any wildcard (`*`) requires that the resource must already exists,
1139
+ # and the Not Any wildcard (`!*`) requires that it must not.
1140
+ # @param [String] request_id
1141
+ # An optional request ID to identify requests. Specify a unique request ID so
1142
+ # that if you must retry your request, the server will know to ignore the
1143
+ # request if it has already been completed. The server will guarantee that for
1144
+ # at least 60 minutes since the first request. For example, consider a situation
1145
+ # where you make an initial request and the request times out. If you make the
1146
+ # request again with the same request ID, the server can check if original
1147
+ # operation with the same request ID was received, and if so, will ignore the
1148
+ # second request. This prevents clients from accidentally creating duplicate
1149
+ # commitments. The request ID must be a valid UUID with the exception that zero
1150
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1151
+ # @param [Boolean] validate_only
1152
+ # If "validate_only" is set to true, the service will try to validate that this
1153
+ # request would succeed, but will not actually make changes.
1154
+ # @param [String] fields
1155
+ # Selector specifying which fields to include in a partial response.
1156
+ # @param [String] quota_user
1157
+ # Available to use for quota purposes for server-side applications. Can be any
1158
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1159
+ # @param [Google::Apis::RequestOptions] options
1160
+ # Request-specific options
1161
+ #
1162
+ # @yield [result, err] Result & error if block supplied
1163
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
1164
+ # @yieldparam err [StandardError] error object if request failed
1165
+ #
1166
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
1167
+ #
1168
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1169
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1170
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1171
+ def delete_project_location_tenant(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1172
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1173
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
1174
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
1175
+ command.params['name'] = name unless name.nil?
1176
+ command.query['etag'] = etag unless etag.nil?
1177
+ command.query['requestId'] = request_id unless request_id.nil?
1178
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1179
+ command.query['fields'] = fields unless fields.nil?
1180
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1181
+ execute_or_queue_command(command, &block)
1182
+ end
1183
+
1184
+ # Retrieve a single tenant.
1185
+ # @param [String] name
1186
+ # Required. The resource name of the resource within a service.
1187
+ # @param [String] fields
1188
+ # Selector specifying which fields to include in a partial response.
1189
+ # @param [String] quota_user
1190
+ # Available to use for quota purposes for server-side applications. Can be any
1191
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1192
+ # @param [Google::Apis::RequestOptions] options
1193
+ # Request-specific options
1194
+ #
1195
+ # @yield [result, err] Result & error if block supplied
1196
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Tenant] parsed result object
1197
+ # @yieldparam err [StandardError] error object if request failed
1198
+ #
1199
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Tenant]
1200
+ #
1201
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1202
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1203
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1204
+ def get_project_location_tenant(name, fields: nil, quota_user: nil, options: nil, &block)
1205
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1206
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Tenant::Representation
1207
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Tenant
1208
+ command.params['name'] = name unless name.nil?
1209
+ command.query['fields'] = fields unless fields.nil?
1210
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1211
+ execute_or_queue_command(command, &block)
1212
+ end
1213
+
1214
+ # Retrieve a collection of tenants.
1215
+ # @param [String] parent
1216
+ # Required. The parent of the tenant.
1217
+ # @param [String] filter
1218
+ # Filter the list as specified in https://google.aip.dev/160.
1219
+ # @param [String] order_by
1220
+ # Order results as specified in https://google.aip.dev/132.
1221
+ # @param [Fixnum] page_size
1222
+ # The maximum number of tenants to send per page.
1223
+ # @param [String] page_token
1224
+ # The page token: If the next_page_token from a previous response is provided,
1225
+ # this request will send the subsequent page.
1226
+ # @param [String] fields
1227
+ # Selector specifying which fields to include in a partial response.
1228
+ # @param [String] quota_user
1229
+ # Available to use for quota purposes for server-side applications. Can be any
1230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1231
+ # @param [Google::Apis::RequestOptions] options
1232
+ # Request-specific options
1233
+ #
1234
+ # @yield [result, err] Result & error if block supplied
1235
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListTenantsResponse] parsed result object
1236
+ # @yieldparam err [StandardError] error object if request failed
1237
+ #
1238
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListTenantsResponse]
1239
+ #
1240
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1241
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1242
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1243
+ def list_project_location_tenants(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1244
+ command = make_simple_command(:get, 'v1beta1/{+parent}/tenants', options)
1245
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListTenantsResponse::Representation
1246
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListTenantsResponse
1247
+ command.params['parent'] = parent unless parent.nil?
1248
+ command.query['filter'] = filter unless filter.nil?
1249
+ command.query['orderBy'] = order_by unless order_by.nil?
1250
+ command.query['pageSize'] = page_size unless page_size.nil?
1251
+ command.query['pageToken'] = page_token unless page_token.nil?
1252
+ command.query['fields'] = fields unless fields.nil?
1253
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1254
+ execute_or_queue_command(command, &block)
1255
+ end
1256
+
1257
+ # Update a single tenant.
1258
+ # @param [String] name
1259
+ # Identifier. The resource name (full URI of the resource) following the
1260
+ # standard naming scheme: "projects/`project`/locations/`location`/tenants/`
1261
+ # tenant`"
1262
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Tenant] tenant_object
1263
+ # @param [String] request_id
1264
+ # An optional request ID to identify requests. Specify a unique request ID so
1265
+ # that if you must retry your request, the server will know to ignore the
1266
+ # request if it has already been completed. The server will guarantee that for
1267
+ # at least 60 minutes since the first request. For example, consider a situation
1268
+ # where you make an initial request and the request times out. If you make the
1269
+ # request again with the same request ID, the server can check if original
1270
+ # operation with the same request ID was received, and if so, will ignore the
1271
+ # second request. This prevents clients from accidentally creating duplicate
1272
+ # commitments. The request ID must be a valid UUID with the exception that zero
1273
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1274
+ # @param [String] update_mask
1275
+ # Field mask is used to specify the fields to be overwritten in the Tenant
1276
+ # resource by the update. The fields specified in the update_mask are relative
1277
+ # to the resource, not the full request. A field will be overwritten if it is in
1278
+ # the mask. If the user does not provide a mask then all fields in the Tenant
1279
+ # will be overwritten.
1280
+ # @param [Boolean] validate_only
1281
+ # If "validate_only" is set to true, the service will try to validate that this
1282
+ # request would succeed, but will not actually make changes.
1283
+ # @param [String] fields
1284
+ # Selector specifying which fields to include in a partial response.
1285
+ # @param [String] quota_user
1286
+ # Available to use for quota purposes for server-side applications. Can be any
1287
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1288
+ # @param [Google::Apis::RequestOptions] options
1289
+ # Request-specific options
1290
+ #
1291
+ # @yield [result, err] Result & error if block supplied
1292
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Tenant] parsed result object
1293
+ # @yieldparam err [StandardError] error object if request failed
1294
+ #
1295
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Tenant]
1296
+ #
1297
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1298
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1299
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1300
+ def patch_project_location_tenant(name, tenant_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1301
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1302
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Tenant::Representation
1303
+ command.request_object = tenant_object
1304
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Tenant::Representation
1305
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Tenant
1306
+ command.params['name'] = name unless name.nil?
1307
+ command.query['requestId'] = request_id unless request_id.nil?
1308
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1309
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1310
+ command.query['fields'] = fields unless fields.nil?
1311
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1312
+ execute_or_queue_command(command, &block)
1313
+ end
1314
+
1315
+ # Create a new unit kind.
1316
+ # @param [String] parent
1317
+ # Required. The parent of the unit kind.
1318
+ # @param [Google::Apis::SaasservicemgmtV1beta1::UnitKind] unit_kind_object
1319
+ # @param [String] request_id
1320
+ # An optional request ID to identify requests. Specify a unique request ID so
1321
+ # that if you must retry your request, the server will know to ignore the
1322
+ # request if it has already been completed. The server will guarantee that for
1323
+ # at least 60 minutes since the first request. For example, consider a situation
1324
+ # where you make an initial request and the request times out. If you make the
1325
+ # request again with the same request ID, the server can check if original
1326
+ # operation with the same request ID was received, and if so, will ignore the
1327
+ # second request. This prevents clients from accidentally creating duplicate
1328
+ # commitments. The request ID must be a valid UUID with the exception that zero
1329
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1330
+ # @param [String] unit_kind_id
1331
+ # Required. The ID value for the new unit kind.
1332
+ # @param [Boolean] validate_only
1333
+ # If "validate_only" is set to true, the service will try to validate that this
1334
+ # request would succeed, but will not actually make changes.
1335
+ # @param [String] fields
1336
+ # Selector specifying which fields to include in a partial response.
1337
+ # @param [String] quota_user
1338
+ # Available to use for quota purposes for server-side applications. Can be any
1339
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1340
+ # @param [Google::Apis::RequestOptions] options
1341
+ # Request-specific options
1342
+ #
1343
+ # @yield [result, err] Result & error if block supplied
1344
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitKind] parsed result object
1345
+ # @yieldparam err [StandardError] error object if request failed
1346
+ #
1347
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitKind]
1348
+ #
1349
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1350
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1351
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1352
+ def create_project_location_unit_kind(parent, unit_kind_object = nil, request_id: nil, unit_kind_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1353
+ command = make_simple_command(:post, 'v1beta1/{+parent}/unitKinds', options)
1354
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::UnitKind::Representation
1355
+ command.request_object = unit_kind_object
1356
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitKind::Representation
1357
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitKind
1358
+ command.params['parent'] = parent unless parent.nil?
1359
+ command.query['requestId'] = request_id unless request_id.nil?
1360
+ command.query['unitKindId'] = unit_kind_id unless unit_kind_id.nil?
1361
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1362
+ command.query['fields'] = fields unless fields.nil?
1363
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1364
+ execute_or_queue_command(command, &block)
1365
+ end
1366
+
1367
+ # Delete a single unit kind.
1368
+ # @param [String] name
1369
+ # Required. The resource name of the resource within a service.
1370
+ # @param [String] etag
1371
+ # The etag known to the client for the expected state of the unit kind. This is
1372
+ # used with state-changing methods to prevent accidental overwrites when
1373
+ # multiple user agents might be acting in parallel on the same resource. An etag
1374
+ # wildcard provide optimistic concurrency based on the expected existence of the
1375
+ # unit kind. The Any wildcard (`*`) requires that the resource must already
1376
+ # exists, and the Not Any wildcard (`!*`) requires that it must not.
1377
+ # @param [String] request_id
1378
+ # An optional request ID to identify requests. Specify a unique request ID so
1379
+ # that if you must retry your request, the server will know to ignore the
1380
+ # request if it has already been completed. The server will guarantee that for
1381
+ # at least 60 minutes since the first request. For example, consider a situation
1382
+ # where you make an initial request and the request times out. If you make the
1383
+ # request again with the same request ID, the server can check if original
1384
+ # operation with the same request ID was received, and if so, will ignore the
1385
+ # second request. This prevents clients from accidentally creating duplicate
1386
+ # commitments. The request ID must be a valid UUID with the exception that zero
1387
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1388
+ # @param [Boolean] validate_only
1389
+ # If "validate_only" is set to true, the service will try to validate that this
1390
+ # request would succeed, but will not actually make changes.
1391
+ # @param [String] fields
1392
+ # Selector specifying which fields to include in a partial response.
1393
+ # @param [String] quota_user
1394
+ # Available to use for quota purposes for server-side applications. Can be any
1395
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1396
+ # @param [Google::Apis::RequestOptions] options
1397
+ # Request-specific options
1398
+ #
1399
+ # @yield [result, err] Result & error if block supplied
1400
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
1401
+ # @yieldparam err [StandardError] error object if request failed
1402
+ #
1403
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
1404
+ #
1405
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1406
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1407
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1408
+ def delete_project_location_unit_kind(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1409
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1410
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
1411
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
1412
+ command.params['name'] = name unless name.nil?
1413
+ command.query['etag'] = etag unless etag.nil?
1414
+ command.query['requestId'] = request_id unless request_id.nil?
1415
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1416
+ command.query['fields'] = fields unless fields.nil?
1417
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1418
+ execute_or_queue_command(command, &block)
1419
+ end
1420
+
1421
+ # Retrieve a single unit kind.
1422
+ # @param [String] name
1423
+ # Required. The resource name of the resource within a service.
1424
+ # @param [String] fields
1425
+ # Selector specifying which fields to include in a partial response.
1426
+ # @param [String] quota_user
1427
+ # Available to use for quota purposes for server-side applications. Can be any
1428
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1429
+ # @param [Google::Apis::RequestOptions] options
1430
+ # Request-specific options
1431
+ #
1432
+ # @yield [result, err] Result & error if block supplied
1433
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitKind] parsed result object
1434
+ # @yieldparam err [StandardError] error object if request failed
1435
+ #
1436
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitKind]
1437
+ #
1438
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1439
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1440
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1441
+ def get_project_location_unit_kind(name, fields: nil, quota_user: nil, options: nil, &block)
1442
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1443
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitKind::Representation
1444
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitKind
1445
+ command.params['name'] = name unless name.nil?
1446
+ command.query['fields'] = fields unless fields.nil?
1447
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1448
+ execute_or_queue_command(command, &block)
1449
+ end
1450
+
1451
+ # Retrieve a collection of unit kinds.
1452
+ # @param [String] parent
1453
+ # Required. The parent of the unit kind.
1454
+ # @param [String] filter
1455
+ # Filter the list as specified in https://google.aip.dev/160.
1456
+ # @param [String] order_by
1457
+ # Order results as specified in https://google.aip.dev/132.
1458
+ # @param [Fixnum] page_size
1459
+ # The maximum number of unit kinds to send per page.
1460
+ # @param [String] page_token
1461
+ # The page token: If the next_page_token from a previous response is provided,
1462
+ # this request will send the subsequent page.
1463
+ # @param [String] fields
1464
+ # Selector specifying which fields to include in a partial response.
1465
+ # @param [String] quota_user
1466
+ # Available to use for quota purposes for server-side applications. Can be any
1467
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1468
+ # @param [Google::Apis::RequestOptions] options
1469
+ # Request-specific options
1470
+ #
1471
+ # @yield [result, err] Result & error if block supplied
1472
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListUnitKindsResponse] parsed result object
1473
+ # @yieldparam err [StandardError] error object if request failed
1474
+ #
1475
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListUnitKindsResponse]
1476
+ #
1477
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1478
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1479
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1480
+ def list_project_location_unit_kinds(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1481
+ command = make_simple_command(:get, 'v1beta1/{+parent}/unitKinds', options)
1482
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListUnitKindsResponse::Representation
1483
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListUnitKindsResponse
1484
+ command.params['parent'] = parent unless parent.nil?
1485
+ command.query['filter'] = filter unless filter.nil?
1486
+ command.query['orderBy'] = order_by unless order_by.nil?
1487
+ command.query['pageSize'] = page_size unless page_size.nil?
1488
+ command.query['pageToken'] = page_token unless page_token.nil?
1489
+ command.query['fields'] = fields unless fields.nil?
1490
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1491
+ execute_or_queue_command(command, &block)
1492
+ end
1493
+
1494
+ # Update a single unit kind.
1495
+ # @param [String] name
1496
+ # Identifier. The resource name (full URI of the resource) following the
1497
+ # standard naming scheme: "projects/`project`/locations/`location`/unitKinds/`
1498
+ # unitKind`"
1499
+ # @param [Google::Apis::SaasservicemgmtV1beta1::UnitKind] unit_kind_object
1500
+ # @param [String] request_id
1501
+ # An optional request ID to identify requests. Specify a unique request ID so
1502
+ # that if you must retry your request, the server will know to ignore the
1503
+ # request if it has already been completed. The server will guarantee that for
1504
+ # at least 60 minutes since the first request. For example, consider a situation
1505
+ # where you make an initial request and the request times out. If you make the
1506
+ # request again with the same request ID, the server can check if original
1507
+ # operation with the same request ID was received, and if so, will ignore the
1508
+ # second request. This prevents clients from accidentally creating duplicate
1509
+ # commitments. The request ID must be a valid UUID with the exception that zero
1510
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1511
+ # @param [String] update_mask
1512
+ # Field mask is used to specify the fields to be overwritten in the UnitKind
1513
+ # resource by the update. The fields specified in the update_mask are relative
1514
+ # to the resource, not the full request. A field will be overwritten if it is in
1515
+ # the mask. If the user does not provide a mask then all fields in the UnitKind
1516
+ # will be overwritten.
1517
+ # @param [Boolean] validate_only
1518
+ # If "validate_only" is set to true, the service will try to validate that this
1519
+ # request would succeed, but will not actually make changes.
1520
+ # @param [String] fields
1521
+ # Selector specifying which fields to include in a partial response.
1522
+ # @param [String] quota_user
1523
+ # Available to use for quota purposes for server-side applications. Can be any
1524
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1525
+ # @param [Google::Apis::RequestOptions] options
1526
+ # Request-specific options
1527
+ #
1528
+ # @yield [result, err] Result & error if block supplied
1529
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitKind] parsed result object
1530
+ # @yieldparam err [StandardError] error object if request failed
1531
+ #
1532
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitKind]
1533
+ #
1534
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1535
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1536
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1537
+ def patch_project_location_unit_kind(name, unit_kind_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1538
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1539
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::UnitKind::Representation
1540
+ command.request_object = unit_kind_object
1541
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitKind::Representation
1542
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitKind
1543
+ command.params['name'] = name unless name.nil?
1544
+ command.query['requestId'] = request_id unless request_id.nil?
1545
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1546
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1547
+ command.query['fields'] = fields unless fields.nil?
1548
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1549
+ execute_or_queue_command(command, &block)
1550
+ end
1551
+
1552
+ # Create a new unit operation.
1553
+ # @param [String] parent
1554
+ # Required. The parent of the unit operation.
1555
+ # @param [Google::Apis::SaasservicemgmtV1beta1::UnitOperation] unit_operation_object
1556
+ # @param [String] request_id
1557
+ # An optional request ID to identify requests. Specify a unique request ID so
1558
+ # that if you must retry your request, the server will know to ignore the
1559
+ # request if it has already been completed. The server will guarantee that for
1560
+ # at least 60 minutes since the first request. For example, consider a situation
1561
+ # where you make an initial request and the request times out. If you make the
1562
+ # request again with the same request ID, the server can check if original
1563
+ # operation with the same request ID was received, and if so, will ignore the
1564
+ # second request. This prevents clients from accidentally creating duplicate
1565
+ # commitments. The request ID must be a valid UUID with the exception that zero
1566
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1567
+ # @param [String] unit_operation_id
1568
+ # Required. The ID value for the new unit operation.
1569
+ # @param [Boolean] validate_only
1570
+ # If "validate_only" is set to true, the service will try to validate that this
1571
+ # request would succeed, but will not actually make changes.
1572
+ # @param [String] fields
1573
+ # Selector specifying which fields to include in a partial response.
1574
+ # @param [String] quota_user
1575
+ # Available to use for quota purposes for server-side applications. Can be any
1576
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1577
+ # @param [Google::Apis::RequestOptions] options
1578
+ # Request-specific options
1579
+ #
1580
+ # @yield [result, err] Result & error if block supplied
1581
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitOperation] parsed result object
1582
+ # @yieldparam err [StandardError] error object if request failed
1583
+ #
1584
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitOperation]
1585
+ #
1586
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1587
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1588
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1589
+ def create_project_location_unit_operation(parent, unit_operation_object = nil, request_id: nil, unit_operation_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1590
+ command = make_simple_command(:post, 'v1beta1/{+parent}/unitOperations', options)
1591
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::UnitOperation::Representation
1592
+ command.request_object = unit_operation_object
1593
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitOperation::Representation
1594
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitOperation
1595
+ command.params['parent'] = parent unless parent.nil?
1596
+ command.query['requestId'] = request_id unless request_id.nil?
1597
+ command.query['unitOperationId'] = unit_operation_id unless unit_operation_id.nil?
1598
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1599
+ command.query['fields'] = fields unless fields.nil?
1600
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1601
+ execute_or_queue_command(command, &block)
1602
+ end
1603
+
1604
+ # Delete a single unit operation.
1605
+ # @param [String] name
1606
+ # Required. The resource name of the resource within a service.
1607
+ # @param [String] etag
1608
+ # The etag known to the client for the expected state of the unit operation.
1609
+ # This is used with state-changing methods to prevent accidental overwrites when
1610
+ # multiple user agents might be acting in parallel on the same resource. An etag
1611
+ # wildcard provide optimistic concurrency based on the expected existence of the
1612
+ # unit operation. The Any wildcard (`*`) requires that the resource must already
1613
+ # exists, and the Not Any wildcard (`!*`) requires that it must not.
1614
+ # @param [String] request_id
1615
+ # An optional request ID to identify requests. Specify a unique request ID so
1616
+ # that if you must retry your request, the server will know to ignore the
1617
+ # request if it has already been completed. The server will guarantee that for
1618
+ # at least 60 minutes since the first request. For example, consider a situation
1619
+ # where you make an initial request and the request times out. If you make the
1620
+ # request again with the same request ID, the server can check if original
1621
+ # operation with the same request ID was received, and if so, will ignore the
1622
+ # second request. This prevents clients from accidentally creating duplicate
1623
+ # commitments. The request ID must be a valid UUID with the exception that zero
1624
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1625
+ # @param [Boolean] validate_only
1626
+ # If "validate_only" is set to true, the service will try to validate that this
1627
+ # request would succeed, but will not actually make changes.
1628
+ # @param [String] fields
1629
+ # Selector specifying which fields to include in a partial response.
1630
+ # @param [String] quota_user
1631
+ # Available to use for quota purposes for server-side applications. Can be any
1632
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1633
+ # @param [Google::Apis::RequestOptions] options
1634
+ # Request-specific options
1635
+ #
1636
+ # @yield [result, err] Result & error if block supplied
1637
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
1638
+ # @yieldparam err [StandardError] error object if request failed
1639
+ #
1640
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
1641
+ #
1642
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1643
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1644
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1645
+ def delete_project_location_unit_operation(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1646
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1647
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
1648
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
1649
+ command.params['name'] = name unless name.nil?
1650
+ command.query['etag'] = etag unless etag.nil?
1651
+ command.query['requestId'] = request_id unless request_id.nil?
1652
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1653
+ command.query['fields'] = fields unless fields.nil?
1654
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1655
+ execute_or_queue_command(command, &block)
1656
+ end
1657
+
1658
+ # Retrieve a single unit operation.
1659
+ # @param [String] name
1660
+ # Required. The resource name of the resource within a service.
1661
+ # @param [String] fields
1662
+ # Selector specifying which fields to include in a partial response.
1663
+ # @param [String] quota_user
1664
+ # Available to use for quota purposes for server-side applications. Can be any
1665
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1666
+ # @param [Google::Apis::RequestOptions] options
1667
+ # Request-specific options
1668
+ #
1669
+ # @yield [result, err] Result & error if block supplied
1670
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitOperation] parsed result object
1671
+ # @yieldparam err [StandardError] error object if request failed
1672
+ #
1673
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitOperation]
1674
+ #
1675
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1676
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1677
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1678
+ def get_project_location_unit_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1679
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1680
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitOperation::Representation
1681
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitOperation
1682
+ command.params['name'] = name unless name.nil?
1683
+ command.query['fields'] = fields unless fields.nil?
1684
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1685
+ execute_or_queue_command(command, &block)
1686
+ end
1687
+
1688
+ # Retrieve a collection of unit operations.
1689
+ # @param [String] parent
1690
+ # Required. The parent of the unit operation.
1691
+ # @param [String] filter
1692
+ # Filter the list as specified in https://google.aip.dev/160.
1693
+ # @param [String] order_by
1694
+ # Order results as specified in https://google.aip.dev/132.
1695
+ # @param [Fixnum] page_size
1696
+ # The maximum number of unit operations to send per page.
1697
+ # @param [String] page_token
1698
+ # The page token: If the next_page_token from a previous response is provided,
1699
+ # this request will send the subsequent page.
1700
+ # @param [String] fields
1701
+ # Selector specifying which fields to include in a partial response.
1702
+ # @param [String] quota_user
1703
+ # Available to use for quota purposes for server-side applications. Can be any
1704
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1705
+ # @param [Google::Apis::RequestOptions] options
1706
+ # Request-specific options
1707
+ #
1708
+ # @yield [result, err] Result & error if block supplied
1709
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListUnitOperationsResponse] parsed result object
1710
+ # @yieldparam err [StandardError] error object if request failed
1711
+ #
1712
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListUnitOperationsResponse]
1713
+ #
1714
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1715
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1716
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1717
+ def list_project_location_unit_operations(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1718
+ command = make_simple_command(:get, 'v1beta1/{+parent}/unitOperations', options)
1719
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListUnitOperationsResponse::Representation
1720
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListUnitOperationsResponse
1721
+ command.params['parent'] = parent unless parent.nil?
1722
+ command.query['filter'] = filter unless filter.nil?
1723
+ command.query['orderBy'] = order_by unless order_by.nil?
1724
+ command.query['pageSize'] = page_size unless page_size.nil?
1725
+ command.query['pageToken'] = page_token unless page_token.nil?
1726
+ command.query['fields'] = fields unless fields.nil?
1727
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1728
+ execute_or_queue_command(command, &block)
1729
+ end
1730
+
1731
+ # Update a single unit operation.
1732
+ # @param [String] name
1733
+ # Identifier. The resource name (full URI of the resource) following the
1734
+ # standard naming scheme: "projects/`project`/locations/`location`/
1735
+ # unitOperations/`unitOperation`"
1736
+ # @param [Google::Apis::SaasservicemgmtV1beta1::UnitOperation] unit_operation_object
1737
+ # @param [String] request_id
1738
+ # An optional request ID to identify requests. Specify a unique request ID so
1739
+ # that if you must retry your request, the server will know to ignore the
1740
+ # request if it has already been completed. The server will guarantee that for
1741
+ # at least 60 minutes since the first request. For example, consider a situation
1742
+ # where you make an initial request and the request times out. If you make the
1743
+ # request again with the same request ID, the server can check if original
1744
+ # operation with the same request ID was received, and if so, will ignore the
1745
+ # second request. This prevents clients from accidentally creating duplicate
1746
+ # commitments. The request ID must be a valid UUID with the exception that zero
1747
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1748
+ # @param [String] update_mask
1749
+ # Field mask is used to specify the fields to be overwritten in the
1750
+ # UnitOperation resource by the update. The fields specified in the update_mask
1751
+ # are relative to the resource, not the full request. A field will be
1752
+ # overwritten if it is in the mask. If the user does not provide a mask then all
1753
+ # fields in the UnitOperation will be overwritten.
1754
+ # @param [Boolean] validate_only
1755
+ # If "validate_only" is set to true, the service will try to validate that this
1756
+ # request would succeed, but will not actually make changes.
1757
+ # @param [String] fields
1758
+ # Selector specifying which fields to include in a partial response.
1759
+ # @param [String] quota_user
1760
+ # Available to use for quota purposes for server-side applications. Can be any
1761
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1762
+ # @param [Google::Apis::RequestOptions] options
1763
+ # Request-specific options
1764
+ #
1765
+ # @yield [result, err] Result & error if block supplied
1766
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::UnitOperation] parsed result object
1767
+ # @yieldparam err [StandardError] error object if request failed
1768
+ #
1769
+ # @return [Google::Apis::SaasservicemgmtV1beta1::UnitOperation]
1770
+ #
1771
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1772
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1773
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1774
+ def patch_project_location_unit_operation(name, unit_operation_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1775
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1776
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::UnitOperation::Representation
1777
+ command.request_object = unit_operation_object
1778
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::UnitOperation::Representation
1779
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::UnitOperation
1780
+ command.params['name'] = name unless name.nil?
1781
+ command.query['requestId'] = request_id unless request_id.nil?
1782
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1783
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1784
+ command.query['fields'] = fields unless fields.nil?
1785
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1786
+ execute_or_queue_command(command, &block)
1787
+ end
1788
+
1789
+ # Create a new unit.
1790
+ # @param [String] parent
1791
+ # Required. The parent of the unit.
1792
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Unit] unit_object
1793
+ # @param [String] request_id
1794
+ # An optional request ID to identify requests. Specify a unique request ID so
1795
+ # that if you must retry your request, the server will know to ignore the
1796
+ # request if it has already been completed. The server will guarantee that for
1797
+ # at least 60 minutes since the first request. For example, consider a situation
1798
+ # where you make an initial request and the request times out. If you make the
1799
+ # request again with the same request ID, the server can check if original
1800
+ # operation with the same request ID was received, and if so, will ignore the
1801
+ # second request. This prevents clients from accidentally creating duplicate
1802
+ # commitments. The request ID must be a valid UUID with the exception that zero
1803
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1804
+ # @param [String] unit_id
1805
+ # Required. The ID value for the new unit.
1806
+ # @param [Boolean] validate_only
1807
+ # If "validate_only" is set to true, the service will try to validate that this
1808
+ # request would succeed, but will not actually make changes.
1809
+ # @param [String] fields
1810
+ # Selector specifying which fields to include in a partial response.
1811
+ # @param [String] quota_user
1812
+ # Available to use for quota purposes for server-side applications. Can be any
1813
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1814
+ # @param [Google::Apis::RequestOptions] options
1815
+ # Request-specific options
1816
+ #
1817
+ # @yield [result, err] Result & error if block supplied
1818
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Unit] parsed result object
1819
+ # @yieldparam err [StandardError] error object if request failed
1820
+ #
1821
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Unit]
1822
+ #
1823
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1824
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1825
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1826
+ def create_project_location_unit(parent, unit_object = nil, request_id: nil, unit_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1827
+ command = make_simple_command(:post, 'v1beta1/{+parent}/units', options)
1828
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Unit::Representation
1829
+ command.request_object = unit_object
1830
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Unit::Representation
1831
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Unit
1832
+ command.params['parent'] = parent unless parent.nil?
1833
+ command.query['requestId'] = request_id unless request_id.nil?
1834
+ command.query['unitId'] = unit_id unless unit_id.nil?
1835
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1836
+ command.query['fields'] = fields unless fields.nil?
1837
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1838
+ execute_or_queue_command(command, &block)
1839
+ end
1840
+
1841
+ # Delete a single unit.
1842
+ # @param [String] name
1843
+ # Required. The resource name of the resource within a service.
1844
+ # @param [String] etag
1845
+ # The etag known to the client for the expected state of the unit. This is used
1846
+ # with state-changing methods to prevent accidental overwrites when multiple
1847
+ # user agents might be acting in parallel on the same resource. An etag wildcard
1848
+ # provide optimistic concurrency based on the expected existence of the unit.
1849
+ # The Any wildcard (`*`) requires that the resource must already exists, and the
1850
+ # Not Any wildcard (`!*`) requires that it must not.
1851
+ # @param [String] request_id
1852
+ # An optional request ID to identify requests. Specify a unique request ID so
1853
+ # that if you must retry your request, the server will know to ignore the
1854
+ # request if it has already been completed. The server will guarantee that for
1855
+ # at least 60 minutes since the first request. For example, consider a situation
1856
+ # where you make an initial request and the request times out. If you make the
1857
+ # request again with the same request ID, the server can check if original
1858
+ # operation with the same request ID was received, and if so, will ignore the
1859
+ # second request. This prevents clients from accidentally creating duplicate
1860
+ # commitments. The request ID must be a valid UUID with the exception that zero
1861
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1862
+ # @param [Boolean] validate_only
1863
+ # If "validate_only" is set to true, the service will try to validate that this
1864
+ # request would succeed, but will not actually make changes.
1865
+ # @param [String] fields
1866
+ # Selector specifying which fields to include in a partial response.
1867
+ # @param [String] quota_user
1868
+ # Available to use for quota purposes for server-side applications. Can be any
1869
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1870
+ # @param [Google::Apis::RequestOptions] options
1871
+ # Request-specific options
1872
+ #
1873
+ # @yield [result, err] Result & error if block supplied
1874
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Empty] parsed result object
1875
+ # @yieldparam err [StandardError] error object if request failed
1876
+ #
1877
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Empty]
1878
+ #
1879
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1880
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1881
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1882
+ def delete_project_location_unit(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1883
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1884
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Empty::Representation
1885
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Empty
1886
+ command.params['name'] = name unless name.nil?
1887
+ command.query['etag'] = etag unless etag.nil?
1888
+ command.query['requestId'] = request_id unless request_id.nil?
1889
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1890
+ command.query['fields'] = fields unless fields.nil?
1891
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1892
+ execute_or_queue_command(command, &block)
1893
+ end
1894
+
1895
+ # Retrieve a single unit.
1896
+ # @param [String] name
1897
+ # Required. The resource name of the resource within a service.
1898
+ # @param [String] fields
1899
+ # Selector specifying which fields to include in a partial response.
1900
+ # @param [String] quota_user
1901
+ # Available to use for quota purposes for server-side applications. Can be any
1902
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1903
+ # @param [Google::Apis::RequestOptions] options
1904
+ # Request-specific options
1905
+ #
1906
+ # @yield [result, err] Result & error if block supplied
1907
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Unit] parsed result object
1908
+ # @yieldparam err [StandardError] error object if request failed
1909
+ #
1910
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Unit]
1911
+ #
1912
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1913
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1914
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1915
+ def get_project_location_unit(name, fields: nil, quota_user: nil, options: nil, &block)
1916
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1917
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Unit::Representation
1918
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Unit
1919
+ command.params['name'] = name unless name.nil?
1920
+ command.query['fields'] = fields unless fields.nil?
1921
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1922
+ execute_or_queue_command(command, &block)
1923
+ end
1924
+
1925
+ # Retrieve a collection of units.
1926
+ # @param [String] parent
1927
+ # Required. The parent of the unit.
1928
+ # @param [String] filter
1929
+ # Filter the list as specified in https://google.aip.dev/160.
1930
+ # @param [String] order_by
1931
+ # Order results as specified in https://google.aip.dev/132.
1932
+ # @param [Fixnum] page_size
1933
+ # The maximum number of units to send per page.
1934
+ # @param [String] page_token
1935
+ # The page token: If the next_page_token from a previous response is provided,
1936
+ # this request will send the subsequent page.
1937
+ # @param [String] fields
1938
+ # Selector specifying which fields to include in a partial response.
1939
+ # @param [String] quota_user
1940
+ # Available to use for quota purposes for server-side applications. Can be any
1941
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1942
+ # @param [Google::Apis::RequestOptions] options
1943
+ # Request-specific options
1944
+ #
1945
+ # @yield [result, err] Result & error if block supplied
1946
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::ListUnitsResponse] parsed result object
1947
+ # @yieldparam err [StandardError] error object if request failed
1948
+ #
1949
+ # @return [Google::Apis::SaasservicemgmtV1beta1::ListUnitsResponse]
1950
+ #
1951
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1952
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1953
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1954
+ def list_project_location_units(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1955
+ command = make_simple_command(:get, 'v1beta1/{+parent}/units', options)
1956
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::ListUnitsResponse::Representation
1957
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::ListUnitsResponse
1958
+ command.params['parent'] = parent unless parent.nil?
1959
+ command.query['filter'] = filter unless filter.nil?
1960
+ command.query['orderBy'] = order_by unless order_by.nil?
1961
+ command.query['pageSize'] = page_size unless page_size.nil?
1962
+ command.query['pageToken'] = page_token unless page_token.nil?
1963
+ command.query['fields'] = fields unless fields.nil?
1964
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1965
+ execute_or_queue_command(command, &block)
1966
+ end
1967
+
1968
+ # Update a single unit.
1969
+ # @param [String] name
1970
+ # Identifier. The resource name (full URI of the resource) following the
1971
+ # standard naming scheme: "projects/`project`/locations/`location`/units/`unit`"
1972
+ # @param [Google::Apis::SaasservicemgmtV1beta1::Unit] unit_object
1973
+ # @param [String] request_id
1974
+ # An optional request ID to identify requests. Specify a unique request ID so
1975
+ # that if you must retry your request, the server will know to ignore the
1976
+ # request if it has already been completed. The server will guarantee that for
1977
+ # at least 60 minutes since the first request. For example, consider a situation
1978
+ # where you make an initial request and the request times out. If you make the
1979
+ # request again with the same request ID, the server can check if original
1980
+ # operation with the same request ID was received, and if so, will ignore the
1981
+ # second request. This prevents clients from accidentally creating duplicate
1982
+ # commitments. The request ID must be a valid UUID with the exception that zero
1983
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1984
+ # @param [String] update_mask
1985
+ # Field mask is used to specify the fields to be overwritten in the Unit
1986
+ # resource by the update. The fields specified in the update_mask are relative
1987
+ # to the resource, not the full request. A field will be overwritten if it is in
1988
+ # the mask. If the user does not provide a mask then all fields in the Unit will
1989
+ # be overwritten.
1990
+ # @param [Boolean] validate_only
1991
+ # If "validate_only" is set to true, the service will try to validate that this
1992
+ # request would succeed, but will not actually make changes.
1993
+ # @param [String] fields
1994
+ # Selector specifying which fields to include in a partial response.
1995
+ # @param [String] quota_user
1996
+ # Available to use for quota purposes for server-side applications. Can be any
1997
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1998
+ # @param [Google::Apis::RequestOptions] options
1999
+ # Request-specific options
2000
+ #
2001
+ # @yield [result, err] Result & error if block supplied
2002
+ # @yieldparam result [Google::Apis::SaasservicemgmtV1beta1::Unit] parsed result object
2003
+ # @yieldparam err [StandardError] error object if request failed
2004
+ #
2005
+ # @return [Google::Apis::SaasservicemgmtV1beta1::Unit]
2006
+ #
2007
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2008
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2009
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2010
+ def patch_project_location_unit(name, unit_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2011
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
2012
+ command.request_representation = Google::Apis::SaasservicemgmtV1beta1::Unit::Representation
2013
+ command.request_object = unit_object
2014
+ command.response_representation = Google::Apis::SaasservicemgmtV1beta1::Unit::Representation
2015
+ command.response_class = Google::Apis::SaasservicemgmtV1beta1::Unit
2016
+ command.params['name'] = name unless name.nil?
2017
+ command.query['requestId'] = request_id unless request_id.nil?
2018
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2019
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2020
+ command.query['fields'] = fields unless fields.nil?
2021
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2022
+ execute_or_queue_command(command, &block)
2023
+ end
2024
+
2025
+ protected
2026
+
2027
+ def apply_command_defaults(command)
2028
+ command.query['key'] = key unless key.nil?
2029
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2030
+ end
2031
+ end
2032
+ end
2033
+ end
2034
+ end