google-apis-vmwareengine_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,2487 @@
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 VmwareengineV1
23
+ # VMware Engine API
24
+ #
25
+ # The Google VMware Engine API lets you programmatically manage VMware
26
+ # environments.
27
+ #
28
+ # @example
29
+ # require 'google/apis/vmwareengine_v1'
30
+ #
31
+ # Vmwareengine = Google::Apis::VmwareengineV1 # Alias the module
32
+ # service = Vmwareengine::VMwareEngineService.new
33
+ #
34
+ # @see https://cloud.google.com/solutions/vmware-as-a-service
35
+ class VMwareEngineService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ attr_accessor :quota_user
45
+
46
+ def initialize
47
+ super('https://vmwareengine.googleapis.com/', '',
48
+ client_name: 'google-apis-vmwareengine_v1',
49
+ client_version: Google::Apis::VmwareengineV1::GEM_VERSION)
50
+ @batch_path = 'batch'
51
+ end
52
+
53
+ # Gets information about a location.
54
+ # @param [String] name
55
+ # Resource name for the location.
56
+ # @param [String] fields
57
+ # Selector specifying which fields to include in a partial response.
58
+ # @param [String] quota_user
59
+ # Available to use for quota purposes for server-side applications. Can be any
60
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
61
+ # @param [Google::Apis::RequestOptions] options
62
+ # Request-specific options
63
+ #
64
+ # @yield [result, err] Result & error if block supplied
65
+ # @yieldparam result [Google::Apis::VmwareengineV1::Location] parsed result object
66
+ # @yieldparam err [StandardError] error object if request failed
67
+ #
68
+ # @return [Google::Apis::VmwareengineV1::Location]
69
+ #
70
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
71
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
72
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
73
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
74
+ command = make_simple_command(:get, 'v1/{+name}', options)
75
+ command.response_representation = Google::Apis::VmwareengineV1::Location::Representation
76
+ command.response_class = Google::Apis::VmwareengineV1::Location
77
+ command.params['name'] = name unless name.nil?
78
+ command.query['fields'] = fields unless fields.nil?
79
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
80
+ execute_or_queue_command(command, &block)
81
+ end
82
+
83
+ # Lists information about the supported locations for this service.
84
+ # @param [String] name
85
+ # The resource that owns the locations collection, if applicable.
86
+ # @param [String] filter
87
+ # A filter to narrow down results to a preferred subset. The filtering language
88
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
89
+ # in [AIP-160](https://google.aip.dev/160).
90
+ # @param [Fixnum] page_size
91
+ # The maximum number of results to return. If not set, the service selects a
92
+ # default.
93
+ # @param [String] page_token
94
+ # A page token received from the `next_page_token` field in the response. Send
95
+ # that page token to receive the subsequent page.
96
+ # @param [String] fields
97
+ # Selector specifying which fields to include in a partial response.
98
+ # @param [String] quota_user
99
+ # Available to use for quota purposes for server-side applications. Can be any
100
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
101
+ # @param [Google::Apis::RequestOptions] options
102
+ # Request-specific options
103
+ #
104
+ # @yield [result, err] Result & error if block supplied
105
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListLocationsResponse] parsed result object
106
+ # @yieldparam err [StandardError] error object if request failed
107
+ #
108
+ # @return [Google::Apis::VmwareengineV1::ListLocationsResponse]
109
+ #
110
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
111
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
112
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
113
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
114
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
115
+ command.response_representation = Google::Apis::VmwareengineV1::ListLocationsResponse::Representation
116
+ command.response_class = Google::Apis::VmwareengineV1::ListLocationsResponse
117
+ command.params['name'] = name unless name.nil?
118
+ command.query['filter'] = filter unless filter.nil?
119
+ command.query['pageSize'] = page_size unless page_size.nil?
120
+ command.query['pageToken'] = page_token unless page_token.nil?
121
+ command.query['fields'] = fields unless fields.nil?
122
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
123
+ execute_or_queue_command(command, &block)
124
+ end
125
+
126
+ # Creates a new network policy in a given VMware Engine network of a project and
127
+ # location (region). A new network policy cannot be created if another network
128
+ # policy already exists in the same scope.
129
+ # @param [String] parent
130
+ # Required. The resource name of the location (region) to create the new network
131
+ # policy in. Resource names are schemeless URIs that follow the conventions in
132
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
133
+ # project/locations/us-central1`
134
+ # @param [Google::Apis::VmwareengineV1::NetworkPolicy] network_policy_object
135
+ # @param [String] network_policy_id
136
+ # Required. The user-provided identifier of the network policy to be created.
137
+ # This identifier must be unique within parent `projects/`my-project`/locations/`
138
+ # us-central1`/networkPolicies` and becomes the final token in the name URI. The
139
+ # identifier must meet the following requirements: * Only contains 1-63
140
+ # alphanumeric characters and hyphens * Begins with an alphabetical character *
141
+ # Ends with a non-hyphen character * Not formatted as a UUID * Complies with [
142
+ # RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
143
+ # @param [String] request_id
144
+ # Optional. A request ID to identify requests. Specify a unique request ID so
145
+ # that if you must retry your request, the server will know to ignore the
146
+ # request if it has already been completed. The server guarantees that a request
147
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
148
+ # For example, consider a situation where you make an initial request and the
149
+ # request times out. If you make the request again with the same request ID, the
150
+ # server can check if original operation with the same request ID was received,
151
+ # and if so, will ignore the second request. This prevents clients from
152
+ # accidentally creating duplicate commitments. The request ID must be a valid
153
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
154
+ # 0000-000000000000).
155
+ # @param [String] fields
156
+ # Selector specifying which fields to include in a partial response.
157
+ # @param [String] quota_user
158
+ # Available to use for quota purposes for server-side applications. Can be any
159
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
160
+ # @param [Google::Apis::RequestOptions] options
161
+ # Request-specific options
162
+ #
163
+ # @yield [result, err] Result & error if block supplied
164
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
165
+ # @yieldparam err [StandardError] error object if request failed
166
+ #
167
+ # @return [Google::Apis::VmwareengineV1::Operation]
168
+ #
169
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
170
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
171
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
172
+ def create_project_location_network_policy(parent, network_policy_object = nil, network_policy_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
173
+ command = make_simple_command(:post, 'v1/{+parent}/networkPolicies', options)
174
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
175
+ command.request_object = network_policy_object
176
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
177
+ command.response_class = Google::Apis::VmwareengineV1::Operation
178
+ command.params['parent'] = parent unless parent.nil?
179
+ command.query['networkPolicyId'] = network_policy_id unless network_policy_id.nil?
180
+ command.query['requestId'] = request_id unless request_id.nil?
181
+ command.query['fields'] = fields unless fields.nil?
182
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
183
+ execute_or_queue_command(command, &block)
184
+ end
185
+
186
+ # Deletes a `NetworkPolicy` resource. A network policy cannot be deleted when `
187
+ # NetworkService.state` is set to `RECONCILING` for either its external IP or
188
+ # internet access service.
189
+ # @param [String] name
190
+ # Required. The resource name of the network policy to delete. Resource names
191
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
192
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
193
+ # central1/networkPolicies/my-network-policy`
194
+ # @param [String] request_id
195
+ # Optional. A request ID to identify requests. Specify a unique request ID so
196
+ # that if you must retry your request, the server will know to ignore the
197
+ # request if it has already been completed. The server guarantees that a request
198
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
199
+ # For example, consider a situation where you make an initial request and the
200
+ # request times out. If you make the request again with the same request ID, the
201
+ # server can check if original operation with the same request ID was received,
202
+ # and if so, will ignore the second request. This prevents clients from
203
+ # accidentally creating duplicate commitments. The request ID must be a valid
204
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
205
+ # 0000-000000000000).
206
+ # @param [String] fields
207
+ # Selector specifying which fields to include in a partial response.
208
+ # @param [String] quota_user
209
+ # Available to use for quota purposes for server-side applications. Can be any
210
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
211
+ # @param [Google::Apis::RequestOptions] options
212
+ # Request-specific options
213
+ #
214
+ # @yield [result, err] Result & error if block supplied
215
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
216
+ # @yieldparam err [StandardError] error object if request failed
217
+ #
218
+ # @return [Google::Apis::VmwareengineV1::Operation]
219
+ #
220
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
221
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
222
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
223
+ def delete_project_location_network_policy(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
224
+ command = make_simple_command(:delete, 'v1/{+name}', options)
225
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
226
+ command.response_class = Google::Apis::VmwareengineV1::Operation
227
+ command.params['name'] = name unless name.nil?
228
+ command.query['requestId'] = request_id unless request_id.nil?
229
+ command.query['fields'] = fields unless fields.nil?
230
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
231
+ execute_or_queue_command(command, &block)
232
+ end
233
+
234
+ # Retrieves a `NetworkPolicy` resource by its resource name.
235
+ # @param [String] name
236
+ # Required. The resource name of the network policy to retrieve. Resource names
237
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
238
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
239
+ # central1/networkPolicies/my-network-policy`
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::VmwareengineV1::NetworkPolicy] parsed result object
250
+ # @yieldparam err [StandardError] error object if request failed
251
+ #
252
+ # @return [Google::Apis::VmwareengineV1::NetworkPolicy]
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_network_policy(name, fields: nil, quota_user: nil, options: nil, &block)
258
+ command = make_simple_command(:get, 'v1/{+name}', options)
259
+ command.response_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
260
+ command.response_class = Google::Apis::VmwareengineV1::NetworkPolicy
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
+ # Lists `NetworkPolicy` resources in a specified project and location.
268
+ # @param [String] parent
269
+ # Required. The resource name of the location (region) to query for network
270
+ # policies. Resource names are schemeless URIs that follow the conventions in
271
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
272
+ # project/locations/us-central1`
273
+ # @param [String] filter
274
+ # A filter expression that matches resources returned in the response. The
275
+ # expression must specify the field name, a comparison operator, and the value
276
+ # that you want to use for filtering. The value must be a string, a number, or a
277
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
278
+ # if you are filtering a list of network policies, you can exclude the ones
279
+ # named `example-policy` by specifying `name != "example-policy"`. To filter on
280
+ # multiple expressions, provide each separate expression within parentheses. For
281
+ # example: ``` (name = "example-policy") (createTime > "2021-04-12T08:15:10.40Z")
282
+ # ``` By default, each expression is an `AND` expression. However, you can
283
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
284
+ # example-policy-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
285
+ # example-policy-2") ```
286
+ # @param [String] order_by
287
+ # Sorts list results by a certain order. By default, returned results are
288
+ # ordered by `name` in ascending order. You can also sort results in descending
289
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
290
+ # ordering by `name` is supported.
291
+ # @param [Fixnum] page_size
292
+ # The maximum number of network policies to return in one page. The service may
293
+ # return fewer than this value. The maximum value is coerced to 1000. The
294
+ # default value of this field is 500.
295
+ # @param [String] page_token
296
+ # A page token, received from a previous `ListNetworkPolicies` call. Provide
297
+ # this to retrieve the subsequent page. When paginating, all other parameters
298
+ # provided to `ListNetworkPolicies` must match the call that provided the page
299
+ # token.
300
+ # @param [String] fields
301
+ # Selector specifying which fields to include in a partial response.
302
+ # @param [String] quota_user
303
+ # Available to use for quota purposes for server-side applications. Can be any
304
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
305
+ # @param [Google::Apis::RequestOptions] options
306
+ # Request-specific options
307
+ #
308
+ # @yield [result, err] Result & error if block supplied
309
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse] parsed result object
310
+ # @yieldparam err [StandardError] error object if request failed
311
+ #
312
+ # @return [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse]
313
+ #
314
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
315
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
316
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
317
+ def list_project_location_network_policies(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
318
+ command = make_simple_command(:get, 'v1/{+parent}/networkPolicies', options)
319
+ command.response_representation = Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse::Representation
320
+ command.response_class = Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse
321
+ command.params['parent'] = parent unless parent.nil?
322
+ command.query['filter'] = filter unless filter.nil?
323
+ command.query['orderBy'] = order_by unless order_by.nil?
324
+ command.query['pageSize'] = page_size unless page_size.nil?
325
+ command.query['pageToken'] = page_token unless page_token.nil?
326
+ command.query['fields'] = fields unless fields.nil?
327
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
328
+ execute_or_queue_command(command, &block)
329
+ end
330
+
331
+ # Modifies a `NetworkPolicy` resource. Only the following fields can be updated:
332
+ # `internet_access`, `external_ip`, `edge_services_cidr`. Only fields specified
333
+ # in `updateMask` are applied. When updating a network policy, the external IP
334
+ # network service can only be disabled if there are no external IP addresses
335
+ # present in the scope of the policy. Also, a `NetworkService` cannot be updated
336
+ # when `NetworkService.state` is set to `RECONCILING`. During operation
337
+ # processing, the resource is temporarily in the `ACTIVE` state before the
338
+ # operation fully completes. For that period of time, you can't update the
339
+ # resource. Use the operation status to determine when the processing fully
340
+ # completes.
341
+ # @param [String] name
342
+ # Output only. The resource name of this network policy. Resource names are
343
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
344
+ # design/resource_names. For example: `projects/my-project/locations/us-central1/
345
+ # networkPolicies/my-network-policy`
346
+ # @param [Google::Apis::VmwareengineV1::NetworkPolicy] network_policy_object
347
+ # @param [String] request_id
348
+ # Optional. A request ID to identify requests. Specify a unique request ID so
349
+ # that if you must retry your request, the server will know to ignore the
350
+ # request if it has already been completed. The server guarantees that a request
351
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
352
+ # For example, consider a situation where you make an initial request and the
353
+ # request times out. If you make the request again with the same request ID, the
354
+ # server can check if original operation with the same request ID was received,
355
+ # and if so, will ignore the second request. This prevents clients from
356
+ # accidentally creating duplicate commitments. The request ID must be a valid
357
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
358
+ # 0000-000000000000).
359
+ # @param [String] update_mask
360
+ # Required. Field mask is used to specify the fields to be overwritten in the `
361
+ # NetworkPolicy` resource by the update. The fields specified in the `
362
+ # update_mask` are relative to the resource, not the full request. A field will
363
+ # be overwritten if it is in the mask. If the user does not provide a mask then
364
+ # all fields will be overwritten.
365
+ # @param [String] fields
366
+ # Selector specifying which fields to include in a partial response.
367
+ # @param [String] quota_user
368
+ # Available to use for quota purposes for server-side applications. Can be any
369
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
370
+ # @param [Google::Apis::RequestOptions] options
371
+ # Request-specific options
372
+ #
373
+ # @yield [result, err] Result & error if block supplied
374
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
375
+ # @yieldparam err [StandardError] error object if request failed
376
+ #
377
+ # @return [Google::Apis::VmwareengineV1::Operation]
378
+ #
379
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
380
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
381
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
382
+ def patch_project_location_network_policy(name, network_policy_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
383
+ command = make_simple_command(:patch, 'v1/{+name}', options)
384
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
385
+ command.request_object = network_policy_object
386
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
387
+ command.response_class = Google::Apis::VmwareengineV1::Operation
388
+ command.params['name'] = name unless name.nil?
389
+ command.query['requestId'] = request_id unless request_id.nil?
390
+ command.query['updateMask'] = update_mask unless update_mask.nil?
391
+ command.query['fields'] = fields unless fields.nil?
392
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
393
+ execute_or_queue_command(command, &block)
394
+ end
395
+
396
+ # Gets details of a single `NodeType`.
397
+ # @param [String] name
398
+ # Required. The resource name of the node type to retrieve. Resource names are
399
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
400
+ # design/resource_names. For example: `projects/my-proj/locations/us-central1-a/
401
+ # nodeTypes/standard-72`
402
+ # @param [String] fields
403
+ # Selector specifying which fields to include in a partial response.
404
+ # @param [String] quota_user
405
+ # Available to use for quota purposes for server-side applications. Can be any
406
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
407
+ # @param [Google::Apis::RequestOptions] options
408
+ # Request-specific options
409
+ #
410
+ # @yield [result, err] Result & error if block supplied
411
+ # @yieldparam result [Google::Apis::VmwareengineV1::NodeType] parsed result object
412
+ # @yieldparam err [StandardError] error object if request failed
413
+ #
414
+ # @return [Google::Apis::VmwareengineV1::NodeType]
415
+ #
416
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
417
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
418
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
419
+ def get_project_location_node_type(name, fields: nil, quota_user: nil, options: nil, &block)
420
+ command = make_simple_command(:get, 'v1/{+name}', options)
421
+ command.response_representation = Google::Apis::VmwareengineV1::NodeType::Representation
422
+ command.response_class = Google::Apis::VmwareengineV1::NodeType
423
+ command.params['name'] = name unless name.nil?
424
+ command.query['fields'] = fields unless fields.nil?
425
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
426
+ execute_or_queue_command(command, &block)
427
+ end
428
+
429
+ # Lists node types
430
+ # @param [String] parent
431
+ # Required. The resource name of the location to be queried for node types.
432
+ # Resource names are schemeless URIs that follow the conventions in https://
433
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
434
+ # locations/us-central1-a`
435
+ # @param [String] filter
436
+ # A filter expression that matches resources returned in the response. The
437
+ # expression must specify the field name, a comparison operator, and the value
438
+ # that you want to use for filtering. The value must be a string, a number, or a
439
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
440
+ # if you are filtering a list of node types, you can exclude the ones named `
441
+ # standard-72` by specifying `name != "standard-72"`. To filter on multiple
442
+ # expressions, provide each separate expression within parentheses. For example:
443
+ # ``` (name = "standard-72") (virtual_cpu_count > 2) ``` By default, each
444
+ # expression is an `AND` expression. However, you can include `AND` and `OR`
445
+ # expressions explicitly. For example: ``` (name = "standard-96") AND (
446
+ # virtual_cpu_count > 2) OR (name = "standard-72") ```
447
+ # @param [Fixnum] page_size
448
+ # The maximum number of node types to return in one page. The service may return
449
+ # fewer than this value. The maximum value is coerced to 1000. The default value
450
+ # of this field is 500.
451
+ # @param [String] page_token
452
+ # A page token, received from a previous `ListNodeTypes` call. Provide this to
453
+ # retrieve the subsequent page. When paginating, all other parameters provided
454
+ # to `ListNodeTypes` must match the call that provided the page token.
455
+ # @param [String] fields
456
+ # Selector specifying which fields to include in a partial response.
457
+ # @param [String] quota_user
458
+ # Available to use for quota purposes for server-side applications. Can be any
459
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
460
+ # @param [Google::Apis::RequestOptions] options
461
+ # Request-specific options
462
+ #
463
+ # @yield [result, err] Result & error if block supplied
464
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNodeTypesResponse] parsed result object
465
+ # @yieldparam err [StandardError] error object if request failed
466
+ #
467
+ # @return [Google::Apis::VmwareengineV1::ListNodeTypesResponse]
468
+ #
469
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
470
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
471
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
472
+ def list_project_location_node_types(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
473
+ command = make_simple_command(:get, 'v1/{+parent}/nodeTypes', options)
474
+ command.response_representation = Google::Apis::VmwareengineV1::ListNodeTypesResponse::Representation
475
+ command.response_class = Google::Apis::VmwareengineV1::ListNodeTypesResponse
476
+ command.params['parent'] = parent unless parent.nil?
477
+ command.query['filter'] = filter unless filter.nil?
478
+ command.query['pageSize'] = page_size unless page_size.nil?
479
+ command.query['pageToken'] = page_token unless page_token.nil?
480
+ command.query['fields'] = fields unless fields.nil?
481
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
482
+ execute_or_queue_command(command, &block)
483
+ end
484
+
485
+ # Deletes a long-running operation. This method indicates that the client is no
486
+ # longer interested in the operation result. It does not cancel the operation.
487
+ # If the server doesn't support this method, it returns `google.rpc.Code.
488
+ # UNIMPLEMENTED`.
489
+ # @param [String] name
490
+ # The name of the operation resource to be deleted.
491
+ # @param [String] fields
492
+ # Selector specifying which fields to include in a partial response.
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # @param [Google::Apis::RequestOptions] options
497
+ # Request-specific options
498
+ #
499
+ # @yield [result, err] Result & error if block supplied
500
+ # @yieldparam result [Google::Apis::VmwareengineV1::Empty] parsed result object
501
+ # @yieldparam err [StandardError] error object if request failed
502
+ #
503
+ # @return [Google::Apis::VmwareengineV1::Empty]
504
+ #
505
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
506
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
507
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
508
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
509
+ command = make_simple_command(:delete, 'v1/{+name}', options)
510
+ command.response_representation = Google::Apis::VmwareengineV1::Empty::Representation
511
+ command.response_class = Google::Apis::VmwareengineV1::Empty
512
+ command.params['name'] = name unless name.nil?
513
+ command.query['fields'] = fields unless fields.nil?
514
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
515
+ execute_or_queue_command(command, &block)
516
+ end
517
+
518
+ # Gets the latest state of a long-running operation. Clients can use this method
519
+ # to poll the operation result at intervals as recommended by the API service.
520
+ # @param [String] name
521
+ # The name of the operation resource.
522
+ # @param [String] fields
523
+ # Selector specifying which fields to include in a partial response.
524
+ # @param [String] quota_user
525
+ # Available to use for quota purposes for server-side applications. Can be any
526
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
527
+ # @param [Google::Apis::RequestOptions] options
528
+ # Request-specific options
529
+ #
530
+ # @yield [result, err] Result & error if block supplied
531
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
532
+ # @yieldparam err [StandardError] error object if request failed
533
+ #
534
+ # @return [Google::Apis::VmwareengineV1::Operation]
535
+ #
536
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
537
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
538
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
539
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
540
+ command = make_simple_command(:get, 'v1/{+name}', options)
541
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
542
+ command.response_class = Google::Apis::VmwareengineV1::Operation
543
+ command.params['name'] = name unless name.nil?
544
+ command.query['fields'] = fields unless fields.nil?
545
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
546
+ execute_or_queue_command(command, &block)
547
+ end
548
+
549
+ # Lists operations that match the specified filter in the request. If the server
550
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
551
+ # @param [String] name
552
+ # The name of the operation's parent resource.
553
+ # @param [String] filter
554
+ # The standard list filter.
555
+ # @param [Fixnum] page_size
556
+ # The standard list page size.
557
+ # @param [String] page_token
558
+ # The standard list page token.
559
+ # @param [String] fields
560
+ # Selector specifying which fields to include in a partial response.
561
+ # @param [String] quota_user
562
+ # Available to use for quota purposes for server-side applications. Can be any
563
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
564
+ # @param [Google::Apis::RequestOptions] options
565
+ # Request-specific options
566
+ #
567
+ # @yield [result, err] Result & error if block supplied
568
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListOperationsResponse] parsed result object
569
+ # @yieldparam err [StandardError] error object if request failed
570
+ #
571
+ # @return [Google::Apis::VmwareengineV1::ListOperationsResponse]
572
+ #
573
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
574
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
575
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
576
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
577
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
578
+ command.response_representation = Google::Apis::VmwareengineV1::ListOperationsResponse::Representation
579
+ command.response_class = Google::Apis::VmwareengineV1::ListOperationsResponse
580
+ command.params['name'] = name unless name.nil?
581
+ command.query['filter'] = filter unless filter.nil?
582
+ command.query['pageSize'] = page_size unless page_size.nil?
583
+ command.query['pageToken'] = page_token unless page_token.nil?
584
+ command.query['fields'] = fields unless fields.nil?
585
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
586
+ execute_or_queue_command(command, &block)
587
+ end
588
+
589
+ # Creates a new `PrivateCloud` resource in a given project and location. Private
590
+ # clouds of type `STANDARD` and `TIME_LIMITED` are zonal resources, `STRETCHED`
591
+ # private clouds are regional. Creating a private cloud also creates a [
592
+ # management cluster](https://cloud.google.com/vmware-engine/docs/concepts-
593
+ # vmware-components) for that private cloud.
594
+ # @param [String] parent
595
+ # Required. The resource name of the location to create the new private cloud in.
596
+ # Resource names are schemeless URIs that follow the conventions in https://
597
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
598
+ # locations/us-central1-a`
599
+ # @param [Google::Apis::VmwareengineV1::PrivateCloud] private_cloud_object
600
+ # @param [String] private_cloud_id
601
+ # Required. The user-provided identifier of the private cloud to be created.
602
+ # This identifier must be unique among each `PrivateCloud` within the parent and
603
+ # becomes the final token in the name URI. The identifier must meet the
604
+ # following requirements: * Only contains 1-63 alphanumeric characters and
605
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
606
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
607
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
608
+ # @param [String] request_id
609
+ # Optional. The request ID must be a valid UUID with the exception that zero
610
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
611
+ # @param [Boolean] validate_only
612
+ # Optional. True if you want the request to be validated and not executed; false
613
+ # otherwise.
614
+ # @param [String] fields
615
+ # Selector specifying which fields to include in a partial response.
616
+ # @param [String] quota_user
617
+ # Available to use for quota purposes for server-side applications. Can be any
618
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
619
+ # @param [Google::Apis::RequestOptions] options
620
+ # Request-specific options
621
+ #
622
+ # @yield [result, err] Result & error if block supplied
623
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
624
+ # @yieldparam err [StandardError] error object if request failed
625
+ #
626
+ # @return [Google::Apis::VmwareengineV1::Operation]
627
+ #
628
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
629
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
630
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
631
+ def create_project_location_private_cloud(parent, private_cloud_object = nil, private_cloud_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
632
+ command = make_simple_command(:post, 'v1/{+parent}/privateClouds', options)
633
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
634
+ command.request_object = private_cloud_object
635
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
636
+ command.response_class = Google::Apis::VmwareengineV1::Operation
637
+ command.params['parent'] = parent unless parent.nil?
638
+ command.query['privateCloudId'] = private_cloud_id unless private_cloud_id.nil?
639
+ command.query['requestId'] = request_id unless request_id.nil?
640
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
641
+ command.query['fields'] = fields unless fields.nil?
642
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
643
+ execute_or_queue_command(command, &block)
644
+ end
645
+
646
+ # Schedules a `PrivateCloud` resource for deletion. A `PrivateCloud` resource
647
+ # scheduled for deletion has `PrivateCloud.state` set to `DELETED` and `
648
+ # expireTime` set to the time when deletion is final and can no longer be
649
+ # reversed. The delete operation is marked as done as soon as the `PrivateCloud`
650
+ # is successfully scheduled for deletion (this also applies when `delayHours` is
651
+ # set to zero), and the operation is not kept in pending state until `
652
+ # PrivateCloud` is purged. `PrivateCloud` can be restored using `
653
+ # UndeletePrivateCloud` method before the `expireTime` elapses. When `expireTime`
654
+ # is reached, deletion is final and all private cloud resources are
655
+ # irreversibly removed and billing stops. During the final removal process, `
656
+ # PrivateCloud.state` is set to `PURGING`. `PrivateCloud` can be polled using
657
+ # standard `GET` method for the whole period of deletion and purging. It will
658
+ # not be returned only when it is completely purged.
659
+ # @param [String] name
660
+ # Required. The resource name of the private cloud to delete. Resource names are
661
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
662
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
663
+ # a/privateClouds/my-cloud`
664
+ # @param [Fixnum] delay_hours
665
+ # Optional. Time delay of the deletion specified in hours. The default value is `
666
+ # 3`. Specifying a non-zero value for this field changes the value of `
667
+ # PrivateCloud.state` to `DELETED` and sets `expire_time` to the planned
668
+ # deletion time. Deletion can be cancelled before `expire_time` elapses using
669
+ # VmwareEngine.UndeletePrivateCloud. Specifying a value of `0` for this field
670
+ # instead begins the deletion process and ceases billing immediately. During the
671
+ # final deletion process, the value of `PrivateCloud.state` becomes `PURGING`.
672
+ # @param [Boolean] force
673
+ # Optional. If set to true, cascade delete is enabled and all children of this
674
+ # private cloud resource are also deleted. When this flag is set to false, the
675
+ # private cloud will not be deleted if there are any children other than the
676
+ # management cluster. The management cluster is always deleted.
677
+ # @param [String] request_id
678
+ # Optional. The request ID must be a valid UUID with the exception that zero
679
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
680
+ # @param [String] fields
681
+ # Selector specifying which fields to include in a partial response.
682
+ # @param [String] quota_user
683
+ # Available to use for quota purposes for server-side applications. Can be any
684
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
685
+ # @param [Google::Apis::RequestOptions] options
686
+ # Request-specific options
687
+ #
688
+ # @yield [result, err] Result & error if block supplied
689
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
690
+ # @yieldparam err [StandardError] error object if request failed
691
+ #
692
+ # @return [Google::Apis::VmwareengineV1::Operation]
693
+ #
694
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
695
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
696
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
697
+ def delete_project_location_private_cloud(name, delay_hours: nil, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
698
+ command = make_simple_command(:delete, 'v1/{+name}', options)
699
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
700
+ command.response_class = Google::Apis::VmwareengineV1::Operation
701
+ command.params['name'] = name unless name.nil?
702
+ command.query['delayHours'] = delay_hours unless delay_hours.nil?
703
+ command.query['force'] = force unless force.nil?
704
+ command.query['requestId'] = request_id unless request_id.nil?
705
+ command.query['fields'] = fields unless fields.nil?
706
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
707
+ execute_or_queue_command(command, &block)
708
+ end
709
+
710
+ # Retrieves a `PrivateCloud` resource by its resource name.
711
+ # @param [String] name
712
+ # Required. The resource name of the private cloud to retrieve. Resource names
713
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
714
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
715
+ # central1-a/privateClouds/my-cloud`
716
+ # @param [String] fields
717
+ # Selector specifying which fields to include in a partial response.
718
+ # @param [String] quota_user
719
+ # Available to use for quota purposes for server-side applications. Can be any
720
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
721
+ # @param [Google::Apis::RequestOptions] options
722
+ # Request-specific options
723
+ #
724
+ # @yield [result, err] Result & error if block supplied
725
+ # @yieldparam result [Google::Apis::VmwareengineV1::PrivateCloud] parsed result object
726
+ # @yieldparam err [StandardError] error object if request failed
727
+ #
728
+ # @return [Google::Apis::VmwareengineV1::PrivateCloud]
729
+ #
730
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
731
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
732
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
733
+ def get_project_location_private_cloud(name, fields: nil, quota_user: nil, options: nil, &block)
734
+ command = make_simple_command(:get, 'v1/{+name}', options)
735
+ command.response_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
736
+ command.response_class = Google::Apis::VmwareengineV1::PrivateCloud
737
+ command.params['name'] = name unless name.nil?
738
+ command.query['fields'] = fields unless fields.nil?
739
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
740
+ execute_or_queue_command(command, &block)
741
+ end
742
+
743
+ # Gets the access control policy for a resource. Returns an empty policy if the
744
+ # resource exists and does not have a policy set.
745
+ # @param [String] resource
746
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
747
+ # names](https://cloud.google.com/apis/design/resource_names) for the
748
+ # appropriate value for this field.
749
+ # @param [Fixnum] options_requested_policy_version
750
+ # Optional. The maximum policy version that will be used to format the policy.
751
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
752
+ # rejected. Requests for policies with any conditional role bindings must
753
+ # specify version 3. Policies with no conditional role bindings may specify any
754
+ # valid value or leave the field unset. The policy in the response might use the
755
+ # policy version that you specified, or it might use a lower policy version. For
756
+ # example, if you specify version 3, but the policy has no conditional role
757
+ # bindings, the response uses version 1. To learn which resources support
758
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
759
+ # google.com/iam/help/conditions/resource-policies).
760
+ # @param [String] fields
761
+ # Selector specifying which fields to include in a partial response.
762
+ # @param [String] quota_user
763
+ # Available to use for quota purposes for server-side applications. Can be any
764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
765
+ # @param [Google::Apis::RequestOptions] options
766
+ # Request-specific options
767
+ #
768
+ # @yield [result, err] Result & error if block supplied
769
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
770
+ # @yieldparam err [StandardError] error object if request failed
771
+ #
772
+ # @return [Google::Apis::VmwareengineV1::Policy]
773
+ #
774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
777
+ def get_project_location_private_cloud_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
778
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
779
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
780
+ command.response_class = Google::Apis::VmwareengineV1::Policy
781
+ command.params['resource'] = resource unless resource.nil?
782
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
783
+ command.query['fields'] = fields unless fields.nil?
784
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
785
+ execute_or_queue_command(command, &block)
786
+ end
787
+
788
+ # Lists `PrivateCloud` resources in a given project and location.
789
+ # @param [String] parent
790
+ # Required. The resource name of the private cloud to be queried for clusters.
791
+ # Resource names are schemeless URIs that follow the conventions in https://
792
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
793
+ # locations/us-central1-a`
794
+ # @param [String] filter
795
+ # A filter expression that matches resources returned in the response. The
796
+ # expression must specify the field name, a comparison operator, and the value
797
+ # that you want to use for filtering. The value must be a string, a number, or a
798
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
799
+ # if you are filtering a list of private clouds, you can exclude the ones named `
800
+ # example-pc` by specifying `name != "example-pc"`. You can also filter nested
801
+ # fields. For example, you could specify `networkConfig.managementCidr = "192.
802
+ # 168.0.0/24"` to include private clouds only if they have a matching address in
803
+ # their network configuration. To filter on multiple expressions, provide each
804
+ # separate expression within parentheses. For example: ``` (name = "example-pc")
805
+ # (createTime > "2021-04-12T08:15:10.40Z") ``` By default, each expression is an
806
+ # `AND` expression. However, you can include `AND` and `OR` expressions
807
+ # explicitly. For example: ``` (name = "private-cloud-1") AND (createTime > "
808
+ # 2021-04-12T08:15:10.40Z") OR (name = "private-cloud-2") ```
809
+ # @param [String] order_by
810
+ # Sorts list results by a certain order. By default, returned results are
811
+ # ordered by `name` in ascending order. You can also sort results in descending
812
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
813
+ # ordering by `name` is supported.
814
+ # @param [Fixnum] page_size
815
+ # The maximum number of private clouds to return in one page. The service may
816
+ # return fewer than this value. The maximum value is coerced to 1000. The
817
+ # default value of this field is 500.
818
+ # @param [String] page_token
819
+ # A page token, received from a previous `ListPrivateClouds` call. Provide this
820
+ # to retrieve the subsequent page. When paginating, all other parameters
821
+ # provided to `ListPrivateClouds` must match the call that provided the page
822
+ # token.
823
+ # @param [String] fields
824
+ # Selector specifying which fields to include in a partial response.
825
+ # @param [String] quota_user
826
+ # Available to use for quota purposes for server-side applications. Can be any
827
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
828
+ # @param [Google::Apis::RequestOptions] options
829
+ # Request-specific options
830
+ #
831
+ # @yield [result, err] Result & error if block supplied
832
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse] parsed result object
833
+ # @yieldparam err [StandardError] error object if request failed
834
+ #
835
+ # @return [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse]
836
+ #
837
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
838
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
839
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
840
+ def list_project_location_private_clouds(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
841
+ command = make_simple_command(:get, 'v1/{+parent}/privateClouds', options)
842
+ command.response_representation = Google::Apis::VmwareengineV1::ListPrivateCloudsResponse::Representation
843
+ command.response_class = Google::Apis::VmwareengineV1::ListPrivateCloudsResponse
844
+ command.params['parent'] = parent unless parent.nil?
845
+ command.query['filter'] = filter unless filter.nil?
846
+ command.query['orderBy'] = order_by unless order_by.nil?
847
+ command.query['pageSize'] = page_size unless page_size.nil?
848
+ command.query['pageToken'] = page_token unless page_token.nil?
849
+ command.query['fields'] = fields unless fields.nil?
850
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
851
+ execute_or_queue_command(command, &block)
852
+ end
853
+
854
+ # Modifies a `PrivateCloud` resource. Only the following fields can be updated: `
855
+ # description`. Only fields specified in `updateMask` are applied. During
856
+ # operation processing, the resource is temporarily in the `ACTIVE` state before
857
+ # the operation fully completes. For that period of time, you can't update the
858
+ # resource. Use the operation status to determine when the processing fully
859
+ # completes.
860
+ # @param [String] name
861
+ # Output only. The resource name of this private cloud. Resource names are
862
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
863
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
864
+ # a/privateClouds/my-cloud`
865
+ # @param [Google::Apis::VmwareengineV1::PrivateCloud] private_cloud_object
866
+ # @param [String] request_id
867
+ # Optional. The request ID must be a valid UUID with the exception that zero
868
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
869
+ # @param [String] update_mask
870
+ # Required. Field mask is used to specify the fields to be overwritten in the `
871
+ # PrivateCloud` resource by the update. The fields specified in `updateMask` are
872
+ # relative to the resource, not the full request. A field will be overwritten if
873
+ # it is in the mask. If the user does not provide a mask then all fields will be
874
+ # overwritten.
875
+ # @param [String] fields
876
+ # Selector specifying which fields to include in a partial response.
877
+ # @param [String] quota_user
878
+ # Available to use for quota purposes for server-side applications. Can be any
879
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
880
+ # @param [Google::Apis::RequestOptions] options
881
+ # Request-specific options
882
+ #
883
+ # @yield [result, err] Result & error if block supplied
884
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
885
+ # @yieldparam err [StandardError] error object if request failed
886
+ #
887
+ # @return [Google::Apis::VmwareengineV1::Operation]
888
+ #
889
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
890
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
891
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
892
+ def patch_project_location_private_cloud(name, private_cloud_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
893
+ command = make_simple_command(:patch, 'v1/{+name}', options)
894
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
895
+ command.request_object = private_cloud_object
896
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
897
+ command.response_class = Google::Apis::VmwareengineV1::Operation
898
+ command.params['name'] = name unless name.nil?
899
+ command.query['requestId'] = request_id unless request_id.nil?
900
+ command.query['updateMask'] = update_mask unless update_mask.nil?
901
+ command.query['fields'] = fields unless fields.nil?
902
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
903
+ execute_or_queue_command(command, &block)
904
+ end
905
+
906
+ # Resets credentials of the NSX appliance.
907
+ # @param [String] private_cloud
908
+ # Required. The resource name of the private cloud to reset credentials for.
909
+ # Resource names are schemeless URIs that follow the conventions in https://
910
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
911
+ # locations/us-central1-a/privateClouds/my-cloud`
912
+ # @param [Google::Apis::VmwareengineV1::ResetNsxCredentialsRequest] reset_nsx_credentials_request_object
913
+ # @param [String] fields
914
+ # Selector specifying which fields to include in a partial response.
915
+ # @param [String] quota_user
916
+ # Available to use for quota purposes for server-side applications. Can be any
917
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
918
+ # @param [Google::Apis::RequestOptions] options
919
+ # Request-specific options
920
+ #
921
+ # @yield [result, err] Result & error if block supplied
922
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
923
+ # @yieldparam err [StandardError] error object if request failed
924
+ #
925
+ # @return [Google::Apis::VmwareengineV1::Operation]
926
+ #
927
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
928
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
929
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
930
+ def reset_private_cloud_nsx_credentials(private_cloud, reset_nsx_credentials_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
931
+ command = make_simple_command(:post, 'v1/{+privateCloud}:resetNsxCredentials', options)
932
+ command.request_representation = Google::Apis::VmwareengineV1::ResetNsxCredentialsRequest::Representation
933
+ command.request_object = reset_nsx_credentials_request_object
934
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
935
+ command.response_class = Google::Apis::VmwareengineV1::Operation
936
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
937
+ command.query['fields'] = fields unless fields.nil?
938
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
939
+ execute_or_queue_command(command, &block)
940
+ end
941
+
942
+ # Resets credentials of the Vcenter appliance.
943
+ # @param [String] private_cloud
944
+ # Required. The resource name of the private cloud to reset credentials for.
945
+ # Resource names are schemeless URIs that follow the conventions in https://
946
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
947
+ # locations/us-central1-a/privateClouds/my-cloud`
948
+ # @param [Google::Apis::VmwareengineV1::ResetVcenterCredentialsRequest] reset_vcenter_credentials_request_object
949
+ # @param [String] fields
950
+ # Selector specifying which fields to include in a partial response.
951
+ # @param [String] quota_user
952
+ # Available to use for quota purposes for server-side applications. Can be any
953
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
954
+ # @param [Google::Apis::RequestOptions] options
955
+ # Request-specific options
956
+ #
957
+ # @yield [result, err] Result & error if block supplied
958
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
959
+ # @yieldparam err [StandardError] error object if request failed
960
+ #
961
+ # @return [Google::Apis::VmwareengineV1::Operation]
962
+ #
963
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
964
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
965
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
966
+ def reset_private_cloud_vcenter_credentials(private_cloud, reset_vcenter_credentials_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
967
+ command = make_simple_command(:post, 'v1/{+privateCloud}:resetVcenterCredentials', options)
968
+ command.request_representation = Google::Apis::VmwareengineV1::ResetVcenterCredentialsRequest::Representation
969
+ command.request_object = reset_vcenter_credentials_request_object
970
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
971
+ command.response_class = Google::Apis::VmwareengineV1::Operation
972
+ command.params['privateCloud'] = private_cloud unless private_cloud.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
+ # Sets the access control policy on the specified resource. Replaces any
979
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
980
+ # PERMISSION_DENIED` errors.
981
+ # @param [String] resource
982
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
983
+ # names](https://cloud.google.com/apis/design/resource_names) for the
984
+ # appropriate value for this field.
985
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
986
+ # @param [String] fields
987
+ # Selector specifying which fields to include in a partial response.
988
+ # @param [String] quota_user
989
+ # Available to use for quota purposes for server-side applications. Can be any
990
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
991
+ # @param [Google::Apis::RequestOptions] options
992
+ # Request-specific options
993
+ #
994
+ # @yield [result, err] Result & error if block supplied
995
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
996
+ # @yieldparam err [StandardError] error object if request failed
997
+ #
998
+ # @return [Google::Apis::VmwareengineV1::Policy]
999
+ #
1000
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1001
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1002
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1003
+ def set_private_cloud_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1004
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1005
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
1006
+ command.request_object = set_iam_policy_request_object
1007
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1008
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1009
+ command.params['resource'] = resource unless resource.nil?
1010
+ command.query['fields'] = fields unless fields.nil?
1011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1012
+ execute_or_queue_command(command, &block)
1013
+ end
1014
+
1015
+ # Gets details of credentials for NSX appliance.
1016
+ # @param [String] private_cloud
1017
+ # Required. The resource name of the private cloud to be queried for credentials.
1018
+ # Resource names are schemeless URIs that follow the conventions in https://
1019
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1020
+ # locations/us-central1-a/privateClouds/my-cloud`
1021
+ # @param [String] fields
1022
+ # Selector specifying which fields to include in a partial response.
1023
+ # @param [String] quota_user
1024
+ # Available to use for quota purposes for server-side applications. Can be any
1025
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1026
+ # @param [Google::Apis::RequestOptions] options
1027
+ # Request-specific options
1028
+ #
1029
+ # @yield [result, err] Result & error if block supplied
1030
+ # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
1031
+ # @yieldparam err [StandardError] error object if request failed
1032
+ #
1033
+ # @return [Google::Apis::VmwareengineV1::Credentials]
1034
+ #
1035
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1036
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1037
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1038
+ def show_project_location_private_cloud_nsx_credentials(private_cloud, fields: nil, quota_user: nil, options: nil, &block)
1039
+ command = make_simple_command(:get, 'v1/{+privateCloud}:showNsxCredentials', options)
1040
+ command.response_representation = Google::Apis::VmwareengineV1::Credentials::Representation
1041
+ command.response_class = Google::Apis::VmwareengineV1::Credentials
1042
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1043
+ command.query['fields'] = fields unless fields.nil?
1044
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1045
+ execute_or_queue_command(command, &block)
1046
+ end
1047
+
1048
+ # Gets details of credentials for Vcenter appliance.
1049
+ # @param [String] private_cloud
1050
+ # Required. The resource name of the private cloud to be queried for credentials.
1051
+ # Resource names are schemeless URIs that follow the conventions in https://
1052
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1053
+ # locations/us-central1-a/privateClouds/my-cloud`
1054
+ # @param [String] fields
1055
+ # Selector specifying which fields to include in a partial response.
1056
+ # @param [String] quota_user
1057
+ # Available to use for quota purposes for server-side applications. Can be any
1058
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1059
+ # @param [Google::Apis::RequestOptions] options
1060
+ # Request-specific options
1061
+ #
1062
+ # @yield [result, err] Result & error if block supplied
1063
+ # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
1064
+ # @yieldparam err [StandardError] error object if request failed
1065
+ #
1066
+ # @return [Google::Apis::VmwareengineV1::Credentials]
1067
+ #
1068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1071
+ def show_project_location_private_cloud_vcenter_credentials(private_cloud, fields: nil, quota_user: nil, options: nil, &block)
1072
+ command = make_simple_command(:get, 'v1/{+privateCloud}:showVcenterCredentials', options)
1073
+ command.response_representation = Google::Apis::VmwareengineV1::Credentials::Representation
1074
+ command.response_class = Google::Apis::VmwareengineV1::Credentials
1075
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1076
+ command.query['fields'] = fields unless fields.nil?
1077
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1078
+ execute_or_queue_command(command, &block)
1079
+ end
1080
+
1081
+ # Returns permissions that a caller has on the specified resource. If the
1082
+ # resource does not exist, this will return an empty set of permissions, not a `
1083
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1084
+ # permission-aware UIs and command-line tools, not for authorization checking.
1085
+ # This operation may "fail open" without warning.
1086
+ # @param [String] resource
1087
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1088
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1089
+ # appropriate value for this field.
1090
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1091
+ # @param [String] fields
1092
+ # Selector specifying which fields to include in a partial response.
1093
+ # @param [String] quota_user
1094
+ # Available to use for quota purposes for server-side applications. Can be any
1095
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1096
+ # @param [Google::Apis::RequestOptions] options
1097
+ # Request-specific options
1098
+ #
1099
+ # @yield [result, err] Result & error if block supplied
1100
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
1101
+ # @yieldparam err [StandardError] error object if request failed
1102
+ #
1103
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
1104
+ #
1105
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1106
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1107
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1108
+ def test_private_cloud_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1109
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1110
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
1111
+ command.request_object = test_iam_permissions_request_object
1112
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
1113
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
1114
+ command.params['resource'] = resource unless resource.nil?
1115
+ command.query['fields'] = fields unless fields.nil?
1116
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1117
+ execute_or_queue_command(command, &block)
1118
+ end
1119
+
1120
+ # Restores a private cloud that was previously scheduled for deletion by `
1121
+ # DeletePrivateCloud`. A `PrivateCloud` resource scheduled for deletion has `
1122
+ # PrivateCloud.state` set to `DELETED` and `PrivateCloud.expireTime` set to the
1123
+ # time when deletion can no longer be reversed.
1124
+ # @param [String] name
1125
+ # Required. The resource name of the private cloud scheduled for deletion.
1126
+ # Resource names are schemeless URIs that follow the conventions in https://
1127
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1128
+ # locations/us-central1-a/privateClouds/my-cloud`
1129
+ # @param [Google::Apis::VmwareengineV1::UndeletePrivateCloudRequest] undelete_private_cloud_request_object
1130
+ # @param [String] fields
1131
+ # Selector specifying which fields to include in a partial response.
1132
+ # @param [String] quota_user
1133
+ # Available to use for quota purposes for server-side applications. Can be any
1134
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1135
+ # @param [Google::Apis::RequestOptions] options
1136
+ # Request-specific options
1137
+ #
1138
+ # @yield [result, err] Result & error if block supplied
1139
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1140
+ # @yieldparam err [StandardError] error object if request failed
1141
+ #
1142
+ # @return [Google::Apis::VmwareengineV1::Operation]
1143
+ #
1144
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1145
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1146
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1147
+ def undelete_private_cloud(name, undelete_private_cloud_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1148
+ command = make_simple_command(:post, 'v1/{+name}:undelete', options)
1149
+ command.request_representation = Google::Apis::VmwareengineV1::UndeletePrivateCloudRequest::Representation
1150
+ command.request_object = undelete_private_cloud_request_object
1151
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1152
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1153
+ command.params['name'] = name unless name.nil?
1154
+ command.query['fields'] = fields unless fields.nil?
1155
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1156
+ execute_or_queue_command(command, &block)
1157
+ end
1158
+
1159
+ # Creates a new cluster in a given private cloud. Creating a new cluster
1160
+ # provides additional nodes for use in the parent private cloud and requires
1161
+ # sufficient [node quota](https://cloud.google.com/vmware-engine/quotas).
1162
+ # @param [String] parent
1163
+ # Required. The resource name of the private cloud to create a new cluster in.
1164
+ # Resource names are schemeless URIs that follow the conventions in https://
1165
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1166
+ # locations/us-central1-a/privateClouds/my-cloud`
1167
+ # @param [Google::Apis::VmwareengineV1::Cluster] cluster_object
1168
+ # @param [String] cluster_id
1169
+ # Required. The user-provided identifier of the new `Cluster`. This identifier
1170
+ # must be unique among clusters within the parent and becomes the final token in
1171
+ # the name URI. The identifier must meet the following requirements: * Only
1172
+ # contains 1-63 alphanumeric characters and hyphens * Begins with an
1173
+ # alphabetical character * Ends with a non-hyphen character * Not formatted as a
1174
+ # UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034)
1175
+ # (section 3.5)
1176
+ # @param [String] request_id
1177
+ # Optional. The request ID must be a valid UUID with the exception that zero
1178
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1179
+ # @param [Boolean] validate_only
1180
+ # Optional. True if you want the request to be validated and not executed; false
1181
+ # otherwise.
1182
+ # @param [String] fields
1183
+ # Selector specifying which fields to include in a partial response.
1184
+ # @param [String] quota_user
1185
+ # Available to use for quota purposes for server-side applications. Can be any
1186
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1187
+ # @param [Google::Apis::RequestOptions] options
1188
+ # Request-specific options
1189
+ #
1190
+ # @yield [result, err] Result & error if block supplied
1191
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1192
+ # @yieldparam err [StandardError] error object if request failed
1193
+ #
1194
+ # @return [Google::Apis::VmwareengineV1::Operation]
1195
+ #
1196
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1197
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1198
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1199
+ def create_project_location_private_cloud_cluster(parent, cluster_object = nil, cluster_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1200
+ command = make_simple_command(:post, 'v1/{+parent}/clusters', options)
1201
+ command.request_representation = Google::Apis::VmwareengineV1::Cluster::Representation
1202
+ command.request_object = cluster_object
1203
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1204
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1205
+ command.params['parent'] = parent unless parent.nil?
1206
+ command.query['clusterId'] = cluster_id unless cluster_id.nil?
1207
+ command.query['requestId'] = request_id unless request_id.nil?
1208
+ command.query['validateOnly'] = validate_only unless validate_only.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
+ # Deletes a `Cluster` resource. To avoid unintended data loss, migrate or
1215
+ # gracefully shut down any workloads running on the cluster before deletion. You
1216
+ # cannot delete the management cluster of a private cloud using this method.
1217
+ # @param [String] name
1218
+ # Required. The resource name of the cluster to delete. Resource names are
1219
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1220
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
1221
+ # a/privateClouds/my-cloud/clusters/my-cluster`
1222
+ # @param [String] request_id
1223
+ # Optional. The request ID must be a valid UUID with the exception that zero
1224
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1225
+ # @param [String] fields
1226
+ # Selector specifying which fields to include in a partial response.
1227
+ # @param [String] quota_user
1228
+ # Available to use for quota purposes for server-side applications. Can be any
1229
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1230
+ # @param [Google::Apis::RequestOptions] options
1231
+ # Request-specific options
1232
+ #
1233
+ # @yield [result, err] Result & error if block supplied
1234
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1235
+ # @yieldparam err [StandardError] error object if request failed
1236
+ #
1237
+ # @return [Google::Apis::VmwareengineV1::Operation]
1238
+ #
1239
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1240
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1241
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1242
+ def delete_project_location_private_cloud_cluster(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1243
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1244
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1245
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1246
+ command.params['name'] = name unless name.nil?
1247
+ command.query['requestId'] = request_id unless request_id.nil?
1248
+ command.query['fields'] = fields unless fields.nil?
1249
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1250
+ execute_or_queue_command(command, &block)
1251
+ end
1252
+
1253
+ # Retrieves a `Cluster` resource by its resource name.
1254
+ # @param [String] name
1255
+ # Required. The cluster resource name to retrieve. Resource names are schemeless
1256
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
1257
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
1258
+ # privateClouds/my-cloud/clusters/my-cluster`
1259
+ # @param [String] fields
1260
+ # Selector specifying which fields to include in a partial response.
1261
+ # @param [String] quota_user
1262
+ # Available to use for quota purposes for server-side applications. Can be any
1263
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1264
+ # @param [Google::Apis::RequestOptions] options
1265
+ # Request-specific options
1266
+ #
1267
+ # @yield [result, err] Result & error if block supplied
1268
+ # @yieldparam result [Google::Apis::VmwareengineV1::Cluster] parsed result object
1269
+ # @yieldparam err [StandardError] error object if request failed
1270
+ #
1271
+ # @return [Google::Apis::VmwareengineV1::Cluster]
1272
+ #
1273
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1274
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1275
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1276
+ def get_project_location_private_cloud_cluster(name, fields: nil, quota_user: nil, options: nil, &block)
1277
+ command = make_simple_command(:get, 'v1/{+name}', options)
1278
+ command.response_representation = Google::Apis::VmwareengineV1::Cluster::Representation
1279
+ command.response_class = Google::Apis::VmwareengineV1::Cluster
1280
+ command.params['name'] = name unless name.nil?
1281
+ command.query['fields'] = fields unless fields.nil?
1282
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1283
+ execute_or_queue_command(command, &block)
1284
+ end
1285
+
1286
+ # Gets the access control policy for a resource. Returns an empty policy if the
1287
+ # resource exists and does not have a policy set.
1288
+ # @param [String] resource
1289
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1290
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1291
+ # appropriate value for this field.
1292
+ # @param [Fixnum] options_requested_policy_version
1293
+ # Optional. The maximum policy version that will be used to format the policy.
1294
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1295
+ # rejected. Requests for policies with any conditional role bindings must
1296
+ # specify version 3. Policies with no conditional role bindings may specify any
1297
+ # valid value or leave the field unset. The policy in the response might use the
1298
+ # policy version that you specified, or it might use a lower policy version. For
1299
+ # example, if you specify version 3, but the policy has no conditional role
1300
+ # bindings, the response uses version 1. To learn which resources support
1301
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1302
+ # google.com/iam/help/conditions/resource-policies).
1303
+ # @param [String] fields
1304
+ # Selector specifying which fields to include in a partial response.
1305
+ # @param [String] quota_user
1306
+ # Available to use for quota purposes for server-side applications. Can be any
1307
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1308
+ # @param [Google::Apis::RequestOptions] options
1309
+ # Request-specific options
1310
+ #
1311
+ # @yield [result, err] Result & error if block supplied
1312
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1313
+ # @yieldparam err [StandardError] error object if request failed
1314
+ #
1315
+ # @return [Google::Apis::VmwareengineV1::Policy]
1316
+ #
1317
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1318
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1319
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1320
+ def get_project_location_private_cloud_cluster_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1321
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1322
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1323
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1324
+ command.params['resource'] = resource unless resource.nil?
1325
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1326
+ command.query['fields'] = fields unless fields.nil?
1327
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1328
+ execute_or_queue_command(command, &block)
1329
+ end
1330
+
1331
+ # Lists `Cluster` resources in a given private cloud.
1332
+ # @param [String] parent
1333
+ # Required. The resource name of the private cloud to query for clusters.
1334
+ # Resource names are schemeless URIs that follow the conventions in https://
1335
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1336
+ # locations/us-central1-a/privateClouds/my-cloud`
1337
+ # @param [String] filter
1338
+ # To filter on multiple expressions, provide each separate expression within
1339
+ # parentheses. For example: ``` (name = "example-cluster") (nodeCount = "3") ```
1340
+ # By default, each expression is an `AND` expression. However, you can include `
1341
+ # AND` and `OR` expressions explicitly. For example: ``` (name = "example-
1342
+ # cluster-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "example-
1343
+ # cluster-2") ```
1344
+ # @param [String] order_by
1345
+ # Sorts list results by a certain order. By default, returned results are
1346
+ # ordered by `name` in ascending order. You can also sort results in descending
1347
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
1348
+ # ordering by `name` is supported.
1349
+ # @param [Fixnum] page_size
1350
+ # The maximum number of clusters to return in one page. The service may return
1351
+ # fewer than this value. The maximum value is coerced to 1000. The default value
1352
+ # of this field is 500.
1353
+ # @param [String] page_token
1354
+ # A page token, received from a previous `ListClusters` call. Provide this to
1355
+ # retrieve the subsequent page. When paginating, all other parameters provided
1356
+ # to `ListClusters` must match the call that provided the page token.
1357
+ # @param [String] fields
1358
+ # Selector specifying which fields to include in a partial response.
1359
+ # @param [String] quota_user
1360
+ # Available to use for quota purposes for server-side applications. Can be any
1361
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1362
+ # @param [Google::Apis::RequestOptions] options
1363
+ # Request-specific options
1364
+ #
1365
+ # @yield [result, err] Result & error if block supplied
1366
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListClustersResponse] parsed result object
1367
+ # @yieldparam err [StandardError] error object if request failed
1368
+ #
1369
+ # @return [Google::Apis::VmwareengineV1::ListClustersResponse]
1370
+ #
1371
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1372
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1373
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1374
+ def list_project_location_private_cloud_clusters(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1375
+ command = make_simple_command(:get, 'v1/{+parent}/clusters', options)
1376
+ command.response_representation = Google::Apis::VmwareengineV1::ListClustersResponse::Representation
1377
+ command.response_class = Google::Apis::VmwareengineV1::ListClustersResponse
1378
+ command.params['parent'] = parent unless parent.nil?
1379
+ command.query['filter'] = filter unless filter.nil?
1380
+ command.query['orderBy'] = order_by unless order_by.nil?
1381
+ command.query['pageSize'] = page_size unless page_size.nil?
1382
+ command.query['pageToken'] = page_token unless page_token.nil?
1383
+ command.query['fields'] = fields unless fields.nil?
1384
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1385
+ execute_or_queue_command(command, &block)
1386
+ end
1387
+
1388
+ # Modifies a `Cluster` resource. Only fields specified in `updateMask` are
1389
+ # applied. During operation processing, the resource is temporarily in the `
1390
+ # ACTIVE` state before the operation fully completes. For that period of time,
1391
+ # you can't update the resource. Use the operation status to determine when the
1392
+ # processing fully completes.
1393
+ # @param [String] name
1394
+ # Output only. The resource name of this cluster. Resource names are schemeless
1395
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
1396
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
1397
+ # privateClouds/my-cloud/clusters/my-cluster`
1398
+ # @param [Google::Apis::VmwareengineV1::Cluster] cluster_object
1399
+ # @param [String] request_id
1400
+ # Optional. The request ID must be a valid UUID with the exception that zero
1401
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1402
+ # @param [String] update_mask
1403
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1404
+ # Cluster` resource by the update. The fields specified in the `updateMask` are
1405
+ # relative to the resource, not the full request. A field will be overwritten if
1406
+ # it is in the mask. If the user does not provide a mask then all fields will be
1407
+ # overwritten.
1408
+ # @param [Boolean] validate_only
1409
+ # Optional. True if you want the request to be validated and not executed; false
1410
+ # otherwise.
1411
+ # @param [String] fields
1412
+ # Selector specifying which fields to include in a partial response.
1413
+ # @param [String] quota_user
1414
+ # Available to use for quota purposes for server-side applications. Can be any
1415
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1416
+ # @param [Google::Apis::RequestOptions] options
1417
+ # Request-specific options
1418
+ #
1419
+ # @yield [result, err] Result & error if block supplied
1420
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1421
+ # @yieldparam err [StandardError] error object if request failed
1422
+ #
1423
+ # @return [Google::Apis::VmwareengineV1::Operation]
1424
+ #
1425
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1426
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1427
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1428
+ def patch_project_location_private_cloud_cluster(name, cluster_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1429
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1430
+ command.request_representation = Google::Apis::VmwareengineV1::Cluster::Representation
1431
+ command.request_object = cluster_object
1432
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1433
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1434
+ command.params['name'] = name unless name.nil?
1435
+ command.query['requestId'] = request_id unless request_id.nil?
1436
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1437
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1438
+ command.query['fields'] = fields unless fields.nil?
1439
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1440
+ execute_or_queue_command(command, &block)
1441
+ end
1442
+
1443
+ # Sets the access control policy on the specified resource. Replaces any
1444
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1445
+ # PERMISSION_DENIED` errors.
1446
+ # @param [String] resource
1447
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1448
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1449
+ # appropriate value for this field.
1450
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
1451
+ # @param [String] fields
1452
+ # Selector specifying which fields to include in a partial response.
1453
+ # @param [String] quota_user
1454
+ # Available to use for quota purposes for server-side applications. Can be any
1455
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1456
+ # @param [Google::Apis::RequestOptions] options
1457
+ # Request-specific options
1458
+ #
1459
+ # @yield [result, err] Result & error if block supplied
1460
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1461
+ # @yieldparam err [StandardError] error object if request failed
1462
+ #
1463
+ # @return [Google::Apis::VmwareengineV1::Policy]
1464
+ #
1465
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1466
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1467
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1468
+ def set_cluster_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1469
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1470
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
1471
+ command.request_object = set_iam_policy_request_object
1472
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1473
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1474
+ command.params['resource'] = resource unless resource.nil?
1475
+ command.query['fields'] = fields unless fields.nil?
1476
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1477
+ execute_or_queue_command(command, &block)
1478
+ end
1479
+
1480
+ # Returns permissions that a caller has on the specified resource. If the
1481
+ # resource does not exist, this will return an empty set of permissions, not a `
1482
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1483
+ # permission-aware UIs and command-line tools, not for authorization checking.
1484
+ # This operation may "fail open" without warning.
1485
+ # @param [String] resource
1486
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1487
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1488
+ # appropriate value for this field.
1489
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1490
+ # @param [String] fields
1491
+ # Selector specifying which fields to include in a partial response.
1492
+ # @param [String] quota_user
1493
+ # Available to use for quota purposes for server-side applications. Can be any
1494
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1495
+ # @param [Google::Apis::RequestOptions] options
1496
+ # Request-specific options
1497
+ #
1498
+ # @yield [result, err] Result & error if block supplied
1499
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
1500
+ # @yieldparam err [StandardError] error object if request failed
1501
+ #
1502
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
1503
+ #
1504
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1505
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1506
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1507
+ def test_cluster_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1508
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1509
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
1510
+ command.request_object = test_iam_permissions_request_object
1511
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
1512
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
1513
+ command.params['resource'] = resource unless resource.nil?
1514
+ command.query['fields'] = fields unless fields.nil?
1515
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1516
+ execute_or_queue_command(command, &block)
1517
+ end
1518
+
1519
+ # Creates a new HCX activation key in a given private cloud.
1520
+ # @param [String] parent
1521
+ # Required. The resource name of the private cloud to create the key for.
1522
+ # Resource names are schemeless URIs that follow the conventions in https://
1523
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1524
+ # locations/us-central1/privateClouds/my-cloud`
1525
+ # @param [Google::Apis::VmwareengineV1::HcxActivationKey] hcx_activation_key_object
1526
+ # @param [String] hcx_activation_key_id
1527
+ # Required. The user-provided identifier of the `HcxActivationKey` to be created.
1528
+ # This identifier must be unique among `HcxActivationKey` resources within the
1529
+ # parent and becomes the final token in the name URI. The identifier must meet
1530
+ # the following requirements: * Only contains 1-63 alphanumeric characters and
1531
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
1532
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
1533
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
1534
+ # @param [String] request_id
1535
+ # A request ID to identify requests. Specify a unique request ID so that if you
1536
+ # must retry your request, the server will know to ignore the request if it has
1537
+ # already been completed. The server guarantees that a request doesn't result in
1538
+ # creation of duplicate commitments for at least 60 minutes. For example,
1539
+ # consider a situation where you make an initial request and the request times
1540
+ # out. If you make the request again with the same request ID, the server can
1541
+ # check if original operation with the same request ID was received, and if so,
1542
+ # will ignore the second request. This prevents clients from accidentally
1543
+ # creating duplicate commitments. The request ID must be a valid UUID with the
1544
+ # exception that zero UUID is not supported (00000000-0000-0000-0000-
1545
+ # 000000000000).
1546
+ # @param [String] fields
1547
+ # Selector specifying which fields to include in a partial response.
1548
+ # @param [String] quota_user
1549
+ # Available to use for quota purposes for server-side applications. Can be any
1550
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1551
+ # @param [Google::Apis::RequestOptions] options
1552
+ # Request-specific options
1553
+ #
1554
+ # @yield [result, err] Result & error if block supplied
1555
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1556
+ # @yieldparam err [StandardError] error object if request failed
1557
+ #
1558
+ # @return [Google::Apis::VmwareengineV1::Operation]
1559
+ #
1560
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1561
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1562
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1563
+ def create_project_location_private_cloud_hcx_activation_key(parent, hcx_activation_key_object = nil, hcx_activation_key_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1564
+ command = make_simple_command(:post, 'v1/{+parent}/hcxActivationKeys', options)
1565
+ command.request_representation = Google::Apis::VmwareengineV1::HcxActivationKey::Representation
1566
+ command.request_object = hcx_activation_key_object
1567
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1568
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1569
+ command.params['parent'] = parent unless parent.nil?
1570
+ command.query['hcxActivationKeyId'] = hcx_activation_key_id unless hcx_activation_key_id.nil?
1571
+ command.query['requestId'] = request_id unless request_id.nil?
1572
+ command.query['fields'] = fields unless fields.nil?
1573
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1574
+ execute_or_queue_command(command, &block)
1575
+ end
1576
+
1577
+ # Retrieves a `HcxActivationKey` resource by its resource name.
1578
+ # @param [String] name
1579
+ # Required. The resource name of the HCX activation key to retrieve. Resource
1580
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
1581
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
1582
+ # central1/privateClouds/my-cloud/hcxActivationKeys/my-key`
1583
+ # @param [String] fields
1584
+ # Selector specifying which fields to include in a partial response.
1585
+ # @param [String] quota_user
1586
+ # Available to use for quota purposes for server-side applications. Can be any
1587
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1588
+ # @param [Google::Apis::RequestOptions] options
1589
+ # Request-specific options
1590
+ #
1591
+ # @yield [result, err] Result & error if block supplied
1592
+ # @yieldparam result [Google::Apis::VmwareengineV1::HcxActivationKey] parsed result object
1593
+ # @yieldparam err [StandardError] error object if request failed
1594
+ #
1595
+ # @return [Google::Apis::VmwareengineV1::HcxActivationKey]
1596
+ #
1597
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1598
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1599
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1600
+ def get_project_location_private_cloud_hcx_activation_key(name, fields: nil, quota_user: nil, options: nil, &block)
1601
+ command = make_simple_command(:get, 'v1/{+name}', options)
1602
+ command.response_representation = Google::Apis::VmwareengineV1::HcxActivationKey::Representation
1603
+ command.response_class = Google::Apis::VmwareengineV1::HcxActivationKey
1604
+ command.params['name'] = name unless name.nil?
1605
+ command.query['fields'] = fields unless fields.nil?
1606
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1607
+ execute_or_queue_command(command, &block)
1608
+ end
1609
+
1610
+ # Gets the access control policy for a resource. Returns an empty policy if the
1611
+ # resource exists and does not have a policy set.
1612
+ # @param [String] resource
1613
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1614
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1615
+ # appropriate value for this field.
1616
+ # @param [Fixnum] options_requested_policy_version
1617
+ # Optional. The maximum policy version that will be used to format the policy.
1618
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1619
+ # rejected. Requests for policies with any conditional role bindings must
1620
+ # specify version 3. Policies with no conditional role bindings may specify any
1621
+ # valid value or leave the field unset. The policy in the response might use the
1622
+ # policy version that you specified, or it might use a lower policy version. For
1623
+ # example, if you specify version 3, but the policy has no conditional role
1624
+ # bindings, the response uses version 1. To learn which resources support
1625
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1626
+ # google.com/iam/help/conditions/resource-policies).
1627
+ # @param [String] fields
1628
+ # Selector specifying which fields to include in a partial response.
1629
+ # @param [String] quota_user
1630
+ # Available to use for quota purposes for server-side applications. Can be any
1631
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1632
+ # @param [Google::Apis::RequestOptions] options
1633
+ # Request-specific options
1634
+ #
1635
+ # @yield [result, err] Result & error if block supplied
1636
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1637
+ # @yieldparam err [StandardError] error object if request failed
1638
+ #
1639
+ # @return [Google::Apis::VmwareengineV1::Policy]
1640
+ #
1641
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1642
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1643
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1644
+ def get_project_location_private_cloud_hcx_activation_key_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1645
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1646
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1647
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1648
+ command.params['resource'] = resource unless resource.nil?
1649
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1650
+ command.query['fields'] = fields unless fields.nil?
1651
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1652
+ execute_or_queue_command(command, &block)
1653
+ end
1654
+
1655
+ # Lists `HcxActivationKey` resources in a given private cloud.
1656
+ # @param [String] parent
1657
+ # Required. The resource name of the private cloud to be queried for HCX
1658
+ # activation keys. Resource names are schemeless URIs that follow the
1659
+ # conventions in https://cloud.google.com/apis/design/resource_names. For
1660
+ # example: `projects/my-project/locations/us-central1/privateClouds/my-cloud`
1661
+ # @param [Fixnum] page_size
1662
+ # The maximum number of HCX activation keys to return in one page. The service
1663
+ # may return fewer than this value. The maximum value is coerced to 1000. The
1664
+ # default value of this field is 500.
1665
+ # @param [String] page_token
1666
+ # A page token, received from a previous `ListHcxActivationKeys` call. Provide
1667
+ # this to retrieve the subsequent page. When paginating, all other parameters
1668
+ # provided to `ListHcxActivationKeys` must match the call that provided the page
1669
+ # token.
1670
+ # @param [String] fields
1671
+ # Selector specifying which fields to include in a partial response.
1672
+ # @param [String] quota_user
1673
+ # Available to use for quota purposes for server-side applications. Can be any
1674
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1675
+ # @param [Google::Apis::RequestOptions] options
1676
+ # Request-specific options
1677
+ #
1678
+ # @yield [result, err] Result & error if block supplied
1679
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse] parsed result object
1680
+ # @yieldparam err [StandardError] error object if request failed
1681
+ #
1682
+ # @return [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse]
1683
+ #
1684
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1685
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1686
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1687
+ def list_project_location_private_cloud_hcx_activation_keys(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1688
+ command = make_simple_command(:get, 'v1/{+parent}/hcxActivationKeys', options)
1689
+ command.response_representation = Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse::Representation
1690
+ command.response_class = Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse
1691
+ command.params['parent'] = parent unless parent.nil?
1692
+ command.query['pageSize'] = page_size unless page_size.nil?
1693
+ command.query['pageToken'] = page_token unless page_token.nil?
1694
+ command.query['fields'] = fields unless fields.nil?
1695
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1696
+ execute_or_queue_command(command, &block)
1697
+ end
1698
+
1699
+ # Sets the access control policy on the specified resource. Replaces any
1700
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1701
+ # PERMISSION_DENIED` errors.
1702
+ # @param [String] resource
1703
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1704
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1705
+ # appropriate value for this field.
1706
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
1707
+ # @param [String] fields
1708
+ # Selector specifying which fields to include in a partial response.
1709
+ # @param [String] quota_user
1710
+ # Available to use for quota purposes for server-side applications. Can be any
1711
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1712
+ # @param [Google::Apis::RequestOptions] options
1713
+ # Request-specific options
1714
+ #
1715
+ # @yield [result, err] Result & error if block supplied
1716
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1717
+ # @yieldparam err [StandardError] error object if request failed
1718
+ #
1719
+ # @return [Google::Apis::VmwareengineV1::Policy]
1720
+ #
1721
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1722
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1723
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1724
+ def set_hcx_activation_key_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1725
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1726
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
1727
+ command.request_object = set_iam_policy_request_object
1728
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1729
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1730
+ command.params['resource'] = resource unless resource.nil?
1731
+ command.query['fields'] = fields unless fields.nil?
1732
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1733
+ execute_or_queue_command(command, &block)
1734
+ end
1735
+
1736
+ # Returns permissions that a caller has on the specified resource. If the
1737
+ # resource does not exist, this will return an empty set of permissions, not a `
1738
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1739
+ # permission-aware UIs and command-line tools, not for authorization checking.
1740
+ # This operation may "fail open" without warning.
1741
+ # @param [String] resource
1742
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1743
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1744
+ # appropriate value for this field.
1745
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1746
+ # @param [String] fields
1747
+ # Selector specifying which fields to include in a partial response.
1748
+ # @param [String] quota_user
1749
+ # Available to use for quota purposes for server-side applications. Can be any
1750
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1751
+ # @param [Google::Apis::RequestOptions] options
1752
+ # Request-specific options
1753
+ #
1754
+ # @yield [result, err] Result & error if block supplied
1755
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
1756
+ # @yieldparam err [StandardError] error object if request failed
1757
+ #
1758
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
1759
+ #
1760
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1761
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1762
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1763
+ def test_hcx_activation_key_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1764
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1765
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
1766
+ command.request_object = test_iam_permissions_request_object
1767
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
1768
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
1769
+ command.params['resource'] = resource unless resource.nil?
1770
+ command.query['fields'] = fields unless fields.nil?
1771
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1772
+ execute_or_queue_command(command, &block)
1773
+ end
1774
+
1775
+ # Gets details of a single subnet.
1776
+ # @param [String] name
1777
+ # Required. The resource name of the subnet to retrieve. Resource names are
1778
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1779
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
1780
+ # a/privateClouds/my-cloud/subnets/my-subnet`
1781
+ # @param [String] fields
1782
+ # Selector specifying which fields to include in a partial response.
1783
+ # @param [String] quota_user
1784
+ # Available to use for quota purposes for server-side applications. Can be any
1785
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1786
+ # @param [Google::Apis::RequestOptions] options
1787
+ # Request-specific options
1788
+ #
1789
+ # @yield [result, err] Result & error if block supplied
1790
+ # @yieldparam result [Google::Apis::VmwareengineV1::Subnet] parsed result object
1791
+ # @yieldparam err [StandardError] error object if request failed
1792
+ #
1793
+ # @return [Google::Apis::VmwareengineV1::Subnet]
1794
+ #
1795
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1796
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1797
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1798
+ def get_project_location_private_cloud_subnet(name, fields: nil, quota_user: nil, options: nil, &block)
1799
+ command = make_simple_command(:get, 'v1/{+name}', options)
1800
+ command.response_representation = Google::Apis::VmwareengineV1::Subnet::Representation
1801
+ command.response_class = Google::Apis::VmwareengineV1::Subnet
1802
+ command.params['name'] = name unless name.nil?
1803
+ command.query['fields'] = fields unless fields.nil?
1804
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1805
+ execute_or_queue_command(command, &block)
1806
+ end
1807
+
1808
+ # Lists subnets in a given private cloud.
1809
+ # @param [String] parent
1810
+ # Required. The resource name of the private cloud to be queried for subnets.
1811
+ # Resource names are schemeless URIs that follow the conventions in https://
1812
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1813
+ # locations/us-central1-a/privateClouds/my-cloud`
1814
+ # @param [Fixnum] page_size
1815
+ # The maximum number of subnets to return in one page. The service may return
1816
+ # fewer than this value. The maximum value is coerced to 1000. The default value
1817
+ # of this field is 500.
1818
+ # @param [String] page_token
1819
+ # A page token, received from a previous `ListSubnetsRequest` call. Provide this
1820
+ # to retrieve the subsequent page. When paginating, all other parameters
1821
+ # provided to `ListSubnetsRequest` must match the call that provided the page
1822
+ # token.
1823
+ # @param [String] fields
1824
+ # Selector specifying which fields to include in a partial response.
1825
+ # @param [String] quota_user
1826
+ # Available to use for quota purposes for server-side applications. Can be any
1827
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1828
+ # @param [Google::Apis::RequestOptions] options
1829
+ # Request-specific options
1830
+ #
1831
+ # @yield [result, err] Result & error if block supplied
1832
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListSubnetsResponse] parsed result object
1833
+ # @yieldparam err [StandardError] error object if request failed
1834
+ #
1835
+ # @return [Google::Apis::VmwareengineV1::ListSubnetsResponse]
1836
+ #
1837
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1838
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1839
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1840
+ def list_project_location_private_cloud_subnets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1841
+ command = make_simple_command(:get, 'v1/{+parent}/subnets', options)
1842
+ command.response_representation = Google::Apis::VmwareengineV1::ListSubnetsResponse::Representation
1843
+ command.response_class = Google::Apis::VmwareengineV1::ListSubnetsResponse
1844
+ command.params['parent'] = parent unless parent.nil?
1845
+ command.query['pageSize'] = page_size unless page_size.nil?
1846
+ command.query['pageToken'] = page_token unless page_token.nil?
1847
+ command.query['fields'] = fields unless fields.nil?
1848
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1849
+ execute_or_queue_command(command, &block)
1850
+ end
1851
+
1852
+ # Updates the parameters of a single subnet. Only fields specified in `
1853
+ # update_mask` are applied. *Note*: This API is synchronous and always returns a
1854
+ # successful `google.longrunning.Operation` (LRO). The returned LRO will only
1855
+ # have `done` and `response` fields.
1856
+ # @param [String] name
1857
+ # Output only. The resource name of this subnet. Resource names are schemeless
1858
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
1859
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
1860
+ # privateClouds/my-cloud/subnets/my-subnet`
1861
+ # @param [Google::Apis::VmwareengineV1::Subnet] subnet_object
1862
+ # @param [String] update_mask
1863
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1864
+ # Subnet` resource by the update. The fields specified in the `update_mask` are
1865
+ # relative to the resource, not the full request. A field will be overwritten if
1866
+ # it is in the mask. If the user does not provide a mask then all fields will be
1867
+ # overwritten.
1868
+ # @param [String] fields
1869
+ # Selector specifying which fields to include in a partial response.
1870
+ # @param [String] quota_user
1871
+ # Available to use for quota purposes for server-side applications. Can be any
1872
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1873
+ # @param [Google::Apis::RequestOptions] options
1874
+ # Request-specific options
1875
+ #
1876
+ # @yield [result, err] Result & error if block supplied
1877
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1878
+ # @yieldparam err [StandardError] error object if request failed
1879
+ #
1880
+ # @return [Google::Apis::VmwareengineV1::Operation]
1881
+ #
1882
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1883
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1884
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1885
+ def patch_project_location_private_cloud_subnet(name, subnet_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1886
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1887
+ command.request_representation = Google::Apis::VmwareengineV1::Subnet::Representation
1888
+ command.request_object = subnet_object
1889
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1890
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1891
+ command.params['name'] = name unless name.nil?
1892
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1893
+ command.query['fields'] = fields unless fields.nil?
1894
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1895
+ execute_or_queue_command(command, &block)
1896
+ end
1897
+
1898
+ # Creates a new private connection that can be used for accessing private Clouds.
1899
+ # @param [String] parent
1900
+ # Required. The resource name of the location to create the new private
1901
+ # connection in. Private connection is a regional resource. Resource names are
1902
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1903
+ # design/resource_names. For example: `projects/my-project/locations/us-central1`
1904
+ # @param [Google::Apis::VmwareengineV1::PrivateConnection] private_connection_object
1905
+ # @param [String] private_connection_id
1906
+ # Required. The user-provided identifier of the new private connection. This
1907
+ # identifier must be unique among private connection resources within the parent
1908
+ # and becomes the final token in the name URI. The identifier must meet the
1909
+ # following requirements: * Only contains 1-63 alphanumeric characters and
1910
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
1911
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
1912
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
1913
+ # @param [String] request_id
1914
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1915
+ # that if you must retry your request, the server will know to ignore the
1916
+ # request if it has already been completed. The server guarantees that a request
1917
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
1918
+ # For example, consider a situation where you make an initial request and the
1919
+ # request times out. If you make the request again with the same request ID, the
1920
+ # server can check if original operation with the same request ID was received,
1921
+ # and if so, will ignore the second request. This prevents clients from
1922
+ # accidentally creating duplicate commitments. The request ID must be a valid
1923
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
1924
+ # 0000-000000000000).
1925
+ # @param [String] fields
1926
+ # Selector specifying which fields to include in a partial response.
1927
+ # @param [String] quota_user
1928
+ # Available to use for quota purposes for server-side applications. Can be any
1929
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1930
+ # @param [Google::Apis::RequestOptions] options
1931
+ # Request-specific options
1932
+ #
1933
+ # @yield [result, err] Result & error if block supplied
1934
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1935
+ # @yieldparam err [StandardError] error object if request failed
1936
+ #
1937
+ # @return [Google::Apis::VmwareengineV1::Operation]
1938
+ #
1939
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1940
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1941
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1942
+ def create_project_location_private_connection(parent, private_connection_object = nil, private_connection_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1943
+ command = make_simple_command(:post, 'v1/{+parent}/privateConnections', options)
1944
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateConnection::Representation
1945
+ command.request_object = private_connection_object
1946
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1947
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1948
+ command.params['parent'] = parent unless parent.nil?
1949
+ command.query['privateConnectionId'] = private_connection_id unless private_connection_id.nil?
1950
+ command.query['requestId'] = request_id unless request_id.nil?
1951
+ command.query['fields'] = fields unless fields.nil?
1952
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1953
+ execute_or_queue_command(command, &block)
1954
+ end
1955
+
1956
+ # Deletes a `PrivateConnection` resource. When a private connection is deleted
1957
+ # for a VMware Engine network, the connected network becomes inaccessible to
1958
+ # that VMware Engine network.
1959
+ # @param [String] name
1960
+ # Required. The resource name of the private connection to be deleted. Resource
1961
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
1962
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
1963
+ # central1/privateConnections/my-connection`
1964
+ # @param [String] request_id
1965
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1966
+ # that if you must retry your request, the server will know to ignore the
1967
+ # request if it has already been completed. The server guarantees that a request
1968
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
1969
+ # For example, consider a situation where you make an initial request and the
1970
+ # request times out. If you make the request again with the same request ID, the
1971
+ # server can check if original operation with the same request ID was received,
1972
+ # and if so, will ignore the second request. This prevents clients from
1973
+ # accidentally creating duplicate commitments. The request ID must be a valid
1974
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
1975
+ # 0000-000000000000).
1976
+ # @param [String] fields
1977
+ # Selector specifying which fields to include in a partial response.
1978
+ # @param [String] quota_user
1979
+ # Available to use for quota purposes for server-side applications. Can be any
1980
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1981
+ # @param [Google::Apis::RequestOptions] options
1982
+ # Request-specific options
1983
+ #
1984
+ # @yield [result, err] Result & error if block supplied
1985
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1986
+ # @yieldparam err [StandardError] error object if request failed
1987
+ #
1988
+ # @return [Google::Apis::VmwareengineV1::Operation]
1989
+ #
1990
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1991
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1992
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1993
+ def delete_project_location_private_connection(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1994
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1995
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1996
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1997
+ command.params['name'] = name unless name.nil?
1998
+ command.query['requestId'] = request_id unless request_id.nil?
1999
+ command.query['fields'] = fields unless fields.nil?
2000
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2001
+ execute_or_queue_command(command, &block)
2002
+ end
2003
+
2004
+ # Retrieves a `PrivateConnection` resource by its resource name. The resource
2005
+ # contains details of the private connection, such as connected network, routing
2006
+ # mode and state.
2007
+ # @param [String] name
2008
+ # Required. The resource name of the private connection to retrieve. Resource
2009
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2010
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
2011
+ # central1/privateConnections/my-connection`
2012
+ # @param [String] fields
2013
+ # Selector specifying which fields to include in a partial response.
2014
+ # @param [String] quota_user
2015
+ # Available to use for quota purposes for server-side applications. Can be any
2016
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2017
+ # @param [Google::Apis::RequestOptions] options
2018
+ # Request-specific options
2019
+ #
2020
+ # @yield [result, err] Result & error if block supplied
2021
+ # @yieldparam result [Google::Apis::VmwareengineV1::PrivateConnection] parsed result object
2022
+ # @yieldparam err [StandardError] error object if request failed
2023
+ #
2024
+ # @return [Google::Apis::VmwareengineV1::PrivateConnection]
2025
+ #
2026
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2027
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2028
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2029
+ def get_project_location_private_connection(name, fields: nil, quota_user: nil, options: nil, &block)
2030
+ command = make_simple_command(:get, 'v1/{+name}', options)
2031
+ command.response_representation = Google::Apis::VmwareengineV1::PrivateConnection::Representation
2032
+ command.response_class = Google::Apis::VmwareengineV1::PrivateConnection
2033
+ command.params['name'] = name unless name.nil?
2034
+ command.query['fields'] = fields unless fields.nil?
2035
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2036
+ execute_or_queue_command(command, &block)
2037
+ end
2038
+
2039
+ # Lists `PrivateConnection` resources in a given project and location.
2040
+ # @param [String] parent
2041
+ # Required. The resource name of the location to query for private connections.
2042
+ # Resource names are schemeless URIs that follow the conventions in https://
2043
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
2044
+ # locations/us-central1`
2045
+ # @param [String] filter
2046
+ # A filter expression that matches resources returned in the response. The
2047
+ # expression must specify the field name, a comparison operator, and the value
2048
+ # that you want to use for filtering. The value must be a string, a number, or a
2049
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
2050
+ # if you are filtering a list of private connections, you can exclude the ones
2051
+ # named `example-connection` by specifying `name != "example-connection"`. To
2052
+ # filter on multiple expressions, provide each separate expression within
2053
+ # parentheses. For example: ``` (name = "example-connection") (createTime > "
2054
+ # 2022-09-22T08:15:10.40Z") ``` By default, each expression is an `AND`
2055
+ # expression. However, you can include `AND` and `OR` expressions explicitly.
2056
+ # For example: ``` (name = "example-connection-1") AND (createTime > "2021-04-
2057
+ # 12T08:15:10.40Z") OR (name = "example-connection-2") ```
2058
+ # @param [String] order_by
2059
+ # Sorts list results by a certain order. By default, returned results are
2060
+ # ordered by `name` in ascending order. You can also sort results in descending
2061
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
2062
+ # ordering by `name` is supported.
2063
+ # @param [Fixnum] page_size
2064
+ # The maximum number of private connections to return in one page. The maximum
2065
+ # value is coerced to 1000. The default value of this field is 500.
2066
+ # @param [String] page_token
2067
+ # A page token, received from a previous `ListPrivateConnections` call. Provide
2068
+ # this to retrieve the subsequent page. When paginating, all other parameters
2069
+ # provided to `ListPrivateConnections` must match the call that provided the
2070
+ # page token.
2071
+ # @param [String] fields
2072
+ # Selector specifying which fields to include in a partial response.
2073
+ # @param [String] quota_user
2074
+ # Available to use for quota purposes for server-side applications. Can be any
2075
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2076
+ # @param [Google::Apis::RequestOptions] options
2077
+ # Request-specific options
2078
+ #
2079
+ # @yield [result, err] Result & error if block supplied
2080
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListPrivateConnectionsResponse] parsed result object
2081
+ # @yieldparam err [StandardError] error object if request failed
2082
+ #
2083
+ # @return [Google::Apis::VmwareengineV1::ListPrivateConnectionsResponse]
2084
+ #
2085
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2086
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2087
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2088
+ def list_project_location_private_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2089
+ command = make_simple_command(:get, 'v1/{+parent}/privateConnections', options)
2090
+ command.response_representation = Google::Apis::VmwareengineV1::ListPrivateConnectionsResponse::Representation
2091
+ command.response_class = Google::Apis::VmwareengineV1::ListPrivateConnectionsResponse
2092
+ command.params['parent'] = parent unless parent.nil?
2093
+ command.query['filter'] = filter unless filter.nil?
2094
+ command.query['orderBy'] = order_by unless order_by.nil?
2095
+ command.query['pageSize'] = page_size unless page_size.nil?
2096
+ command.query['pageToken'] = page_token unless page_token.nil?
2097
+ command.query['fields'] = fields unless fields.nil?
2098
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2099
+ execute_or_queue_command(command, &block)
2100
+ end
2101
+
2102
+ # Modifies a `PrivateConnection` resource. Only `description` and `routing_mode`
2103
+ # fields can be updated. Only fields specified in `updateMask` are applied.
2104
+ # @param [String] name
2105
+ # Output only. The resource name of the private connection. Resource names are
2106
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
2107
+ # design/resource_names. For example: `projects/my-project/locations/us-central1/
2108
+ # privateConnections/my-connection`
2109
+ # @param [Google::Apis::VmwareengineV1::PrivateConnection] private_connection_object
2110
+ # @param [String] request_id
2111
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2112
+ # that if you must retry your request, the server will know to ignore the
2113
+ # request if it has already been completed. The server guarantees that a request
2114
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2115
+ # For example, consider a situation where you make an initial request and the
2116
+ # request times out. If you make the request again with the same request ID, the
2117
+ # server can check if original operation with the same request ID was received,
2118
+ # and if so, will ignore the second request. This prevents clients from
2119
+ # accidentally creating duplicate commitments. The request ID must be a valid
2120
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
2121
+ # 0000-000000000000).
2122
+ # @param [String] update_mask
2123
+ # Required. Field mask is used to specify the fields to be overwritten in the `
2124
+ # PrivateConnection` resource by the update. The fields specified in the `
2125
+ # update_mask` are relative to the resource, not the full request. A field will
2126
+ # be overwritten if it is in the mask. If the user does not provide a mask then
2127
+ # all fields will be overwritten.
2128
+ # @param [String] fields
2129
+ # Selector specifying which fields to include in a partial response.
2130
+ # @param [String] quota_user
2131
+ # Available to use for quota purposes for server-side applications. Can be any
2132
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2133
+ # @param [Google::Apis::RequestOptions] options
2134
+ # Request-specific options
2135
+ #
2136
+ # @yield [result, err] Result & error if block supplied
2137
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2138
+ # @yieldparam err [StandardError] error object if request failed
2139
+ #
2140
+ # @return [Google::Apis::VmwareengineV1::Operation]
2141
+ #
2142
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2143
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2144
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2145
+ def patch_project_location_private_connection(name, private_connection_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2146
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2147
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateConnection::Representation
2148
+ command.request_object = private_connection_object
2149
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2150
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2151
+ command.params['name'] = name unless name.nil?
2152
+ command.query['requestId'] = request_id unless request_id.nil?
2153
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2154
+ command.query['fields'] = fields unless fields.nil?
2155
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2156
+ execute_or_queue_command(command, &block)
2157
+ end
2158
+
2159
+ # Lists the private connection routes exchanged over a peering connection.
2160
+ # @param [String] parent
2161
+ # Required. The resource name of the private connection to retrieve peering
2162
+ # routes from. Resource names are schemeless URIs that follow the conventions in
2163
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
2164
+ # project/locations/us-west1/privateConnections/my-connection`
2165
+ # @param [Fixnum] page_size
2166
+ # The maximum number of peering routes to return in one page. The service may
2167
+ # return fewer than this value. The maximum value is coerced to 1000. The
2168
+ # default value of this field is 500.
2169
+ # @param [String] page_token
2170
+ # A page token, received from a previous `ListPrivateConnectionPeeringRoutes`
2171
+ # call. Provide this to retrieve the subsequent page. When paginating, all other
2172
+ # parameters provided to `ListPrivateConnectionPeeringRoutes` must match the
2173
+ # call that provided the page token.
2174
+ # @param [String] fields
2175
+ # Selector specifying which fields to include in a partial response.
2176
+ # @param [String] quota_user
2177
+ # Available to use for quota purposes for server-side applications. Can be any
2178
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2179
+ # @param [Google::Apis::RequestOptions] options
2180
+ # Request-specific options
2181
+ #
2182
+ # @yield [result, err] Result & error if block supplied
2183
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListPrivateConnectionPeeringRoutesResponse] parsed result object
2184
+ # @yieldparam err [StandardError] error object if request failed
2185
+ #
2186
+ # @return [Google::Apis::VmwareengineV1::ListPrivateConnectionPeeringRoutesResponse]
2187
+ #
2188
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2189
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2190
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2191
+ def list_project_location_private_connection_peering_routes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2192
+ command = make_simple_command(:get, 'v1/{+parent}/peeringRoutes', options)
2193
+ command.response_representation = Google::Apis::VmwareengineV1::ListPrivateConnectionPeeringRoutesResponse::Representation
2194
+ command.response_class = Google::Apis::VmwareengineV1::ListPrivateConnectionPeeringRoutesResponse
2195
+ command.params['parent'] = parent unless parent.nil?
2196
+ command.query['pageSize'] = page_size unless page_size.nil?
2197
+ command.query['pageToken'] = page_token unless page_token.nil?
2198
+ command.query['fields'] = fields unless fields.nil?
2199
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2200
+ execute_or_queue_command(command, &block)
2201
+ end
2202
+
2203
+ # Creates a new VMware Engine network that can be used by a private cloud.
2204
+ # @param [String] parent
2205
+ # Required. The resource name of the location to create the new VMware Engine
2206
+ # network in. A VMware Engine network of type `LEGACY` is a regional resource,
2207
+ # and a VMware Engine network of type `STANDARD` is a global resource. Resource
2208
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2209
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/
2210
+ # global`
2211
+ # @param [Google::Apis::VmwareengineV1::VmwareEngineNetwork] vmware_engine_network_object
2212
+ # @param [String] request_id
2213
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2214
+ # that if you must retry your request, the server will know to ignore the
2215
+ # request if it has already been completed. The server guarantees that a request
2216
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2217
+ # For example, consider a situation where you make an initial request and the
2218
+ # request times out. If you make the request again with the same request ID, the
2219
+ # server can check if original operation with the same request ID was received,
2220
+ # and if so, will ignore the second request. This prevents clients from
2221
+ # accidentally creating duplicate commitments. The request ID must be a valid
2222
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
2223
+ # 0000-000000000000).
2224
+ # @param [String] vmware_engine_network_id
2225
+ # Required. The user-provided identifier of the new VMware Engine network. This
2226
+ # identifier must be unique among VMware Engine network resources within the
2227
+ # parent and becomes the final token in the name URI. The identifier must meet
2228
+ # the following requirements: * For networks of type LEGACY, adheres to the
2229
+ # format: ``region-id`-default`. Replace ``region-id`` with the region where you
2230
+ # want to create the VMware Engine network. For example, "us-central1-default". *
2231
+ # Only contains 1-63 alphanumeric characters and hyphens * Begins with an
2232
+ # alphabetical character * Ends with a non-hyphen character * Not formatted as a
2233
+ # UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034)
2234
+ # (section 3.5)
2235
+ # @param [String] fields
2236
+ # Selector specifying which fields to include in a partial response.
2237
+ # @param [String] quota_user
2238
+ # Available to use for quota purposes for server-side applications. Can be any
2239
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2240
+ # @param [Google::Apis::RequestOptions] options
2241
+ # Request-specific options
2242
+ #
2243
+ # @yield [result, err] Result & error if block supplied
2244
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2245
+ # @yieldparam err [StandardError] error object if request failed
2246
+ #
2247
+ # @return [Google::Apis::VmwareengineV1::Operation]
2248
+ #
2249
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2250
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2251
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2252
+ def create_project_location_vmware_engine_network(parent, vmware_engine_network_object = nil, request_id: nil, vmware_engine_network_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2253
+ command = make_simple_command(:post, 'v1/{+parent}/vmwareEngineNetworks', options)
2254
+ command.request_representation = Google::Apis::VmwareengineV1::VmwareEngineNetwork::Representation
2255
+ command.request_object = vmware_engine_network_object
2256
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2257
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2258
+ command.params['parent'] = parent unless parent.nil?
2259
+ command.query['requestId'] = request_id unless request_id.nil?
2260
+ command.query['vmwareEngineNetworkId'] = vmware_engine_network_id unless vmware_engine_network_id.nil?
2261
+ command.query['fields'] = fields unless fields.nil?
2262
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2263
+ execute_or_queue_command(command, &block)
2264
+ end
2265
+
2266
+ # Deletes a `VmwareEngineNetwork` resource. You can only delete a VMware Engine
2267
+ # network after all resources that refer to it are deleted. For example, a
2268
+ # private cloud, a network peering, and a network policy can all refer to the
2269
+ # same VMware Engine network.
2270
+ # @param [String] name
2271
+ # Required. The resource name of the VMware Engine network to be deleted.
2272
+ # Resource names are schemeless URIs that follow the conventions in https://
2273
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
2274
+ # locations/global/vmwareEngineNetworks/my-network`
2275
+ # @param [String] etag
2276
+ # Optional. Checksum used to ensure that the user-provided value is up to date
2277
+ # before the server processes the request. The server compares provided checksum
2278
+ # with the current checksum of the resource. If the user-provided value is out
2279
+ # of date, this request returns an `ABORTED` error.
2280
+ # @param [String] request_id
2281
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2282
+ # that if you must retry your request, the server will know to ignore the
2283
+ # request if it has already been completed. The server guarantees that a request
2284
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2285
+ # For example, consider a situation where you make an initial request and the
2286
+ # request times out. If you make the request again with the same request ID, the
2287
+ # server can check if original operation with the same request ID was received,
2288
+ # and if so, will ignore the second request. This prevents clients from
2289
+ # accidentally creating duplicate commitments. The request ID must be a valid
2290
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
2291
+ # 0000-000000000000).
2292
+ # @param [String] fields
2293
+ # Selector specifying which fields to include in a partial response.
2294
+ # @param [String] quota_user
2295
+ # Available to use for quota purposes for server-side applications. Can be any
2296
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2297
+ # @param [Google::Apis::RequestOptions] options
2298
+ # Request-specific options
2299
+ #
2300
+ # @yield [result, err] Result & error if block supplied
2301
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2302
+ # @yieldparam err [StandardError] error object if request failed
2303
+ #
2304
+ # @return [Google::Apis::VmwareengineV1::Operation]
2305
+ #
2306
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2307
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2308
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2309
+ def delete_project_location_vmware_engine_network(name, etag: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2310
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2311
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2312
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2313
+ command.params['name'] = name unless name.nil?
2314
+ command.query['etag'] = etag unless etag.nil?
2315
+ command.query['requestId'] = request_id unless request_id.nil?
2316
+ command.query['fields'] = fields unless fields.nil?
2317
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2318
+ execute_or_queue_command(command, &block)
2319
+ end
2320
+
2321
+ # Retrieves a `VmwareEngineNetwork` resource by its resource name. The resource
2322
+ # contains details of the VMware Engine network, such as its VMware Engine
2323
+ # network type, peered networks in a service project, and state (for example, `
2324
+ # CREATING`, `ACTIVE`, `DELETING`).
2325
+ # @param [String] name
2326
+ # Required. The resource name of the VMware Engine network to retrieve. Resource
2327
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2328
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/
2329
+ # global/vmwareEngineNetworks/my-network`
2330
+ # @param [String] fields
2331
+ # Selector specifying which fields to include in a partial response.
2332
+ # @param [String] quota_user
2333
+ # Available to use for quota purposes for server-side applications. Can be any
2334
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2335
+ # @param [Google::Apis::RequestOptions] options
2336
+ # Request-specific options
2337
+ #
2338
+ # @yield [result, err] Result & error if block supplied
2339
+ # @yieldparam result [Google::Apis::VmwareengineV1::VmwareEngineNetwork] parsed result object
2340
+ # @yieldparam err [StandardError] error object if request failed
2341
+ #
2342
+ # @return [Google::Apis::VmwareengineV1::VmwareEngineNetwork]
2343
+ #
2344
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2345
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2346
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2347
+ def get_project_location_vmware_engine_network(name, fields: nil, quota_user: nil, options: nil, &block)
2348
+ command = make_simple_command(:get, 'v1/{+name}', options)
2349
+ command.response_representation = Google::Apis::VmwareengineV1::VmwareEngineNetwork::Representation
2350
+ command.response_class = Google::Apis::VmwareengineV1::VmwareEngineNetwork
2351
+ command.params['name'] = name unless name.nil?
2352
+ command.query['fields'] = fields unless fields.nil?
2353
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2354
+ execute_or_queue_command(command, &block)
2355
+ end
2356
+
2357
+ # Lists `VmwareEngineNetwork` resources in a given project and location.
2358
+ # @param [String] parent
2359
+ # Required. The resource name of the location to query for VMware Engine
2360
+ # networks. Resource names are schemeless URIs that follow the conventions in
2361
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
2362
+ # project/locations/global`
2363
+ # @param [String] filter
2364
+ # A filter expression that matches resources returned in the response. The
2365
+ # expression must specify the field name, a comparison operator, and the value
2366
+ # that you want to use for filtering. The value must be a string, a number, or a
2367
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
2368
+ # if you are filtering a list of network peerings, you can exclude the ones
2369
+ # named `example-network` by specifying `name != "example-network"`. To filter
2370
+ # on multiple expressions, provide each separate expression within parentheses.
2371
+ # For example: ``` (name = "example-network") (createTime > "2021-04-12T08:15:10.
2372
+ # 40Z") ``` By default, each expression is an `AND` expression. However, you can
2373
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
2374
+ # example-network-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
2375
+ # example-network-2") ```
2376
+ # @param [String] order_by
2377
+ # Sorts list results by a certain order. By default, returned results are
2378
+ # ordered by `name` in ascending order. You can also sort results in descending
2379
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
2380
+ # ordering by `name` is supported.
2381
+ # @param [Fixnum] page_size
2382
+ # The maximum number of results to return in one page. The maximum value is
2383
+ # coerced to 1000. The default value of this field is 500.
2384
+ # @param [String] page_token
2385
+ # A page token, received from a previous `ListVmwareEngineNetworks` call.
2386
+ # Provide this to retrieve the subsequent page. When paginating, all other
2387
+ # parameters provided to `ListVmwareEngineNetworks` must match the call that
2388
+ # provided the page token.
2389
+ # @param [String] fields
2390
+ # Selector specifying which fields to include in a partial response.
2391
+ # @param [String] quota_user
2392
+ # Available to use for quota purposes for server-side applications. Can be any
2393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2394
+ # @param [Google::Apis::RequestOptions] options
2395
+ # Request-specific options
2396
+ #
2397
+ # @yield [result, err] Result & error if block supplied
2398
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListVmwareEngineNetworksResponse] parsed result object
2399
+ # @yieldparam err [StandardError] error object if request failed
2400
+ #
2401
+ # @return [Google::Apis::VmwareengineV1::ListVmwareEngineNetworksResponse]
2402
+ #
2403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2406
+ def list_project_location_vmware_engine_networks(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2407
+ command = make_simple_command(:get, 'v1/{+parent}/vmwareEngineNetworks', options)
2408
+ command.response_representation = Google::Apis::VmwareengineV1::ListVmwareEngineNetworksResponse::Representation
2409
+ command.response_class = Google::Apis::VmwareengineV1::ListVmwareEngineNetworksResponse
2410
+ command.params['parent'] = parent unless parent.nil?
2411
+ command.query['filter'] = filter unless filter.nil?
2412
+ command.query['orderBy'] = order_by unless order_by.nil?
2413
+ command.query['pageSize'] = page_size unless page_size.nil?
2414
+ command.query['pageToken'] = page_token unless page_token.nil?
2415
+ command.query['fields'] = fields unless fields.nil?
2416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2417
+ execute_or_queue_command(command, &block)
2418
+ end
2419
+
2420
+ # Modifies a VMware Engine network resource. Only the following fields can be
2421
+ # updated: `description`. Only fields specified in `updateMask` are applied.
2422
+ # @param [String] name
2423
+ # Output only. The resource name of the VMware Engine network. Resource names
2424
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
2425
+ # apis/design/resource_names. For example: `projects/my-project/locations/global/
2426
+ # vmwareEngineNetworks/my-network`
2427
+ # @param [Google::Apis::VmwareengineV1::VmwareEngineNetwork] vmware_engine_network_object
2428
+ # @param [String] request_id
2429
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2430
+ # that if you must retry your request, the server will know to ignore the
2431
+ # request if it has already been completed. The server guarantees that a request
2432
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2433
+ # For example, consider a situation where you make an initial request and the
2434
+ # request times out. If you make the request again with the same request ID, the
2435
+ # server can check if original operation with the same request ID was received,
2436
+ # and if so, will ignore the second request. This prevents clients from
2437
+ # accidentally creating duplicate commitments. The request ID must be a valid
2438
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
2439
+ # 0000-000000000000).
2440
+ # @param [String] update_mask
2441
+ # Required. Field mask is used to specify the fields to be overwritten in the
2442
+ # VMware Engine network resource by the update. The fields specified in the `
2443
+ # update_mask` are relative to the resource, not the full request. A field will
2444
+ # be overwritten if it is in the mask. If the user does not provide a mask then
2445
+ # all fields will be overwritten. Only the following fields can be updated: `
2446
+ # description`.
2447
+ # @param [String] fields
2448
+ # Selector specifying which fields to include in a partial response.
2449
+ # @param [String] quota_user
2450
+ # Available to use for quota purposes for server-side applications. Can be any
2451
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2452
+ # @param [Google::Apis::RequestOptions] options
2453
+ # Request-specific options
2454
+ #
2455
+ # @yield [result, err] Result & error if block supplied
2456
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2457
+ # @yieldparam err [StandardError] error object if request failed
2458
+ #
2459
+ # @return [Google::Apis::VmwareengineV1::Operation]
2460
+ #
2461
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2462
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2463
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2464
+ def patch_project_location_vmware_engine_network(name, vmware_engine_network_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2465
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2466
+ command.request_representation = Google::Apis::VmwareengineV1::VmwareEngineNetwork::Representation
2467
+ command.request_object = vmware_engine_network_object
2468
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2469
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2470
+ command.params['name'] = name unless name.nil?
2471
+ command.query['requestId'] = request_id unless request_id.nil?
2472
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2473
+ command.query['fields'] = fields unless fields.nil?
2474
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2475
+ execute_or_queue_command(command, &block)
2476
+ end
2477
+
2478
+ protected
2479
+
2480
+ def apply_command_defaults(command)
2481
+ command.query['key'] = key unless key.nil?
2482
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2483
+ end
2484
+ end
2485
+ end
2486
+ end
2487
+ end