google-apis-vmwareengine_v1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,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