google-apis-vmwareengine_v1 0.1.0 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -123,23 +123,138 @@ module Google
123
123
  execute_or_queue_command(command, &block)
124
124
  end
125
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.
126
+ # Gets all the principals having bind permission on the intranet VPC associated
127
+ # with the consumer project granted by the Grant API.
128
+ # @param [String] name
129
+ # Required. The name of the resource which stores the users/service accounts
130
+ # having the permission to bind to the corresponding intranet VPC of the
131
+ # consumer project. DnsBindPermission is a global resource. Resource names are
132
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
133
+ # design/resource_names. For example: `projects/my-project/locations/global/
134
+ # dnsBindPermission`
135
+ # @param [String] fields
136
+ # Selector specifying which fields to include in a partial response.
137
+ # @param [String] quota_user
138
+ # Available to use for quota purposes for server-side applications. Can be any
139
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
140
+ # @param [Google::Apis::RequestOptions] options
141
+ # Request-specific options
142
+ #
143
+ # @yield [result, err] Result & error if block supplied
144
+ # @yieldparam result [Google::Apis::VmwareengineV1::DnsBindPermission] parsed result object
145
+ # @yieldparam err [StandardError] error object if request failed
146
+ #
147
+ # @return [Google::Apis::VmwareengineV1::DnsBindPermission]
148
+ #
149
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
150
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
151
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
152
+ def get_project_location_global_dns_bind_permission(name, fields: nil, quota_user: nil, options: nil, &block)
153
+ command = make_simple_command(:get, 'v1/{+name}', options)
154
+ command.response_representation = Google::Apis::VmwareengineV1::DnsBindPermission::Representation
155
+ command.response_class = Google::Apis::VmwareengineV1::DnsBindPermission
156
+ command.params['name'] = name unless name.nil?
157
+ command.query['fields'] = fields unless fields.nil?
158
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
159
+ execute_or_queue_command(command, &block)
160
+ end
161
+
162
+ # Grants the bind permission to the customer provided principal(user / service
163
+ # account) to bind their DNS zone with the intranet VPC associated with the
164
+ # project.
165
+ # @param [String] name
166
+ # Required. The name of the resource which stores the users/service accounts
167
+ # having the permission to bind to the corresponding intranet VPC of the
168
+ # consumer project. DnsBindPermission is a global resource. Resource names are
169
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
170
+ # design/resource_names. For example: `projects/my-project/locations/global/
171
+ # dnsBindPermission`
172
+ # @param [Google::Apis::VmwareengineV1::GrantDnsBindPermissionRequest] grant_dns_bind_permission_request_object
173
+ # @param [String] fields
174
+ # Selector specifying which fields to include in a partial response.
175
+ # @param [String] quota_user
176
+ # Available to use for quota purposes for server-side applications. Can be any
177
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
178
+ # @param [Google::Apis::RequestOptions] options
179
+ # Request-specific options
180
+ #
181
+ # @yield [result, err] Result & error if block supplied
182
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
183
+ # @yieldparam err [StandardError] error object if request failed
184
+ #
185
+ # @return [Google::Apis::VmwareengineV1::Operation]
186
+ #
187
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
188
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
189
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
190
+ def grant_dns_bind_permission(name, grant_dns_bind_permission_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
191
+ command = make_simple_command(:post, 'v1/{+name}:grant', options)
192
+ command.request_representation = Google::Apis::VmwareengineV1::GrantDnsBindPermissionRequest::Representation
193
+ command.request_object = grant_dns_bind_permission_request_object
194
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
195
+ command.response_class = Google::Apis::VmwareengineV1::Operation
196
+ command.params['name'] = name unless name.nil?
197
+ command.query['fields'] = fields unless fields.nil?
198
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
199
+ execute_or_queue_command(command, &block)
200
+ end
201
+
202
+ # Revokes the bind permission from the customer provided principal(user /
203
+ # service account) on the intranet VPC associated with the consumer project.
204
+ # @param [String] name
205
+ # Required. The name of the resource which stores the users/service accounts
206
+ # having the permission to bind to the corresponding intranet VPC of the
207
+ # consumer project. DnsBindPermission is a global resource. Resource names are
208
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
209
+ # design/resource_names. For example: `projects/my-project/locations/global/
210
+ # dnsBindPermission`
211
+ # @param [Google::Apis::VmwareengineV1::RevokeDnsBindPermissionRequest] revoke_dns_bind_permission_request_object
212
+ # @param [String] fields
213
+ # Selector specifying which fields to include in a partial response.
214
+ # @param [String] quota_user
215
+ # Available to use for quota purposes for server-side applications. Can be any
216
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
217
+ # @param [Google::Apis::RequestOptions] options
218
+ # Request-specific options
219
+ #
220
+ # @yield [result, err] Result & error if block supplied
221
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
222
+ # @yieldparam err [StandardError] error object if request failed
223
+ #
224
+ # @return [Google::Apis::VmwareengineV1::Operation]
225
+ #
226
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
227
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
228
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
229
+ def revoke_dns_bind_permission(name, revoke_dns_bind_permission_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
230
+ command = make_simple_command(:post, 'v1/{+name}:revoke', options)
231
+ command.request_representation = Google::Apis::VmwareengineV1::RevokeDnsBindPermissionRequest::Representation
232
+ command.request_object = revoke_dns_bind_permission_request_object
233
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
234
+ command.response_class = Google::Apis::VmwareengineV1::Operation
235
+ command.params['name'] = name unless name.nil?
236
+ command.query['fields'] = fields unless fields.nil?
237
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
238
+ execute_or_queue_command(command, &block)
239
+ end
240
+
241
+ # Creates a new network peering between the peer network and VMware Engine
242
+ # network provided in a `NetworkPeering` resource.
129
243
  # @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
244
+ # Required. The resource name of the location to create the new network peering
245
+ # in. This value is always `global`, because `NetworkPeering` is a global
246
+ # resource. Resource names are schemeless URIs that follow the conventions in
132
247
  # 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)
248
+ # project/locations/global`
249
+ # @param [Google::Apis::VmwareengineV1::NetworkPeering] network_peering_object
250
+ # @param [String] network_peering_id
251
+ # Required. The user-provided identifier of the new `NetworkPeering`. This
252
+ # identifier must be unique among `NetworkPeering` resources within the parent
253
+ # and becomes the final token in the name URI. The identifier must meet the
254
+ # following requirements: * Only contains 1-63 alphanumeric characters and
255
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
256
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
257
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
143
258
  # @param [String] request_id
144
259
  # Optional. A request ID to identify requests. Specify a unique request ID so
145
260
  # that if you must retry your request, the server will know to ignore the
@@ -169,28 +284,28 @@ module Google
169
284
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
170
285
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
171
286
  # @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
287
+ def create_project_location_global_network_peering(parent, network_peering_object = nil, network_peering_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
288
+ command = make_simple_command(:post, 'v1/{+parent}/networkPeerings', options)
289
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPeering::Representation
290
+ command.request_object = network_peering_object
176
291
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
177
292
  command.response_class = Google::Apis::VmwareengineV1::Operation
178
293
  command.params['parent'] = parent unless parent.nil?
179
- command.query['networkPolicyId'] = network_policy_id unless network_policy_id.nil?
294
+ command.query['networkPeeringId'] = network_peering_id unless network_peering_id.nil?
180
295
  command.query['requestId'] = request_id unless request_id.nil?
181
296
  command.query['fields'] = fields unless fields.nil?
182
297
  command.query['quotaUser'] = quota_user unless quota_user.nil?
183
298
  execute_or_queue_command(command, &block)
184
299
  end
185
300
 
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.
301
+ # Deletes a `NetworkPeering` resource. When a network peering is deleted for a
302
+ # VMware Engine network, the peer network becomes inaccessible to that VMware
303
+ # Engine network.
189
304
  # @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`
305
+ # Required. The resource name of the network peering to be deleted. Resource
306
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
307
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/
308
+ # global/networkPeerings/my-peering`
194
309
  # @param [String] request_id
195
310
  # Optional. A request ID to identify requests. Specify a unique request ID so
196
311
  # that if you must retry your request, the server will know to ignore the
@@ -220,7 +335,7 @@ module Google
220
335
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
221
336
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
222
337
  # @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)
338
+ def delete_project_location_global_network_peering(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
224
339
  command = make_simple_command(:delete, 'v1/{+name}', options)
225
340
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
226
341
  command.response_class = Google::Apis::VmwareengineV1::Operation
@@ -231,12 +346,14 @@ module Google
231
346
  execute_or_queue_command(command, &block)
232
347
  end
233
348
 
234
- # Retrieves a `NetworkPolicy` resource by its resource name.
349
+ # Retrieves a `NetworkPeering` resource by its resource name. The resource
350
+ # contains details of the network peering, such as peered networks, import and
351
+ # export custom route configurations, and peering state.
235
352
  # @param [String] name
236
- # Required. The resource name of the network policy to retrieve. Resource names
353
+ # Required. The resource name of the network peering to retrieve. Resource names
237
354
  # 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`
355
+ # apis/design/resource_names. For example: `projects/my-project/locations/global/
356
+ # networkPeerings/my-peering`
240
357
  # @param [String] fields
241
358
  # Selector specifying which fields to include in a partial response.
242
359
  # @param [String] quota_user
@@ -246,56 +363,55 @@ module Google
246
363
  # Request-specific options
247
364
  #
248
365
  # @yield [result, err] Result & error if block supplied
249
- # @yieldparam result [Google::Apis::VmwareengineV1::NetworkPolicy] parsed result object
366
+ # @yieldparam result [Google::Apis::VmwareengineV1::NetworkPeering] parsed result object
250
367
  # @yieldparam err [StandardError] error object if request failed
251
368
  #
252
- # @return [Google::Apis::VmwareengineV1::NetworkPolicy]
369
+ # @return [Google::Apis::VmwareengineV1::NetworkPeering]
253
370
  #
254
371
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
255
372
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
256
373
  # @raise [Google::Apis::AuthorizationError] Authorization is required
257
- def get_project_location_network_policy(name, fields: nil, quota_user: nil, options: nil, &block)
374
+ def get_project_location_global_network_peering(name, fields: nil, quota_user: nil, options: nil, &block)
258
375
  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
376
+ command.response_representation = Google::Apis::VmwareengineV1::NetworkPeering::Representation
377
+ command.response_class = Google::Apis::VmwareengineV1::NetworkPeering
261
378
  command.params['name'] = name unless name.nil?
262
379
  command.query['fields'] = fields unless fields.nil?
263
380
  command.query['quotaUser'] = quota_user unless quota_user.nil?
264
381
  execute_or_queue_command(command, &block)
265
382
  end
266
383
 
267
- # Lists `NetworkPolicy` resources in a specified project and location.
384
+ # Lists `NetworkPeering` resources in a given project.
268
385
  # @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
386
+ # Required. The resource name of the location (global) to query for network
387
+ # peerings. Resource names are schemeless URIs that follow the conventions in
271
388
  # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
272
- # project/locations/us-central1`
389
+ # project/locations/global`
273
390
  # @param [String] filter
274
391
  # A filter expression that matches resources returned in the response. The
275
392
  # expression must specify the field name, a comparison operator, and the value
276
393
  # that you want to use for filtering. The value must be a string, a number, or a
277
394
  # 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
395
+ # if you are filtering a list of network peerings, you can exclude the ones
396
+ # named `example-peering` by specifying `name != "example-peering"`. To filter
397
+ # on multiple expressions, provide each separate expression within parentheses.
398
+ # For example: ``` (name = "example-peering") (createTime > "2021-04-12T08:15:10.
399
+ # 40Z") ``` By default, each expression is an `AND` expression. However, you can
283
400
  # 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") ```
401
+ # example-peering-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
402
+ # example-peering-2") ```
286
403
  # @param [String] order_by
287
404
  # Sorts list results by a certain order. By default, returned results are
288
405
  # ordered by `name` in ascending order. You can also sort results in descending
289
406
  # order based on the `name` value using `orderBy="name desc"`. Currently, only
290
407
  # ordering by `name` is supported.
291
408
  # @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.
409
+ # The maximum number of network peerings to return in one page. The maximum
410
+ # value is coerced to 1000. The default value of this field is 500.
295
411
  # @param [String] page_token
296
- # A page token, received from a previous `ListNetworkPolicies` call. Provide
412
+ # A page token, received from a previous `ListNetworkPeerings` call. Provide
297
413
  # this to retrieve the subsequent page. When paginating, all other parameters
298
- # provided to `ListNetworkPolicies` must match the call that provided the page
414
+ # provided to `ListNetworkPeerings` must match the call that provided the page
299
415
  # token.
300
416
  # @param [String] fields
301
417
  # Selector specifying which fields to include in a partial response.
@@ -306,18 +422,18 @@ module Google
306
422
  # Request-specific options
307
423
  #
308
424
  # @yield [result, err] Result & error if block supplied
309
- # @yieldparam result [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse] parsed result object
425
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNetworkPeeringsResponse] parsed result object
310
426
  # @yieldparam err [StandardError] error object if request failed
311
427
  #
312
- # @return [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse]
428
+ # @return [Google::Apis::VmwareengineV1::ListNetworkPeeringsResponse]
313
429
  #
314
430
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
315
431
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
316
432
  # @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
433
+ def list_project_location_global_network_peerings(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
434
+ command = make_simple_command(:get, 'v1/{+parent}/networkPeerings', options)
435
+ command.response_representation = Google::Apis::VmwareengineV1::ListNetworkPeeringsResponse::Representation
436
+ command.response_class = Google::Apis::VmwareengineV1::ListNetworkPeeringsResponse
321
437
  command.params['parent'] = parent unless parent.nil?
322
438
  command.query['filter'] = filter unless filter.nil?
323
439
  command.query['orderBy'] = order_by unless order_by.nil?
@@ -328,22 +444,14 @@ module Google
328
444
  execute_or_queue_command(command, &block)
329
445
  end
330
446
 
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.
447
+ # Modifies a `NetworkPeering` resource. Only the `description` field can be
448
+ # updated. Only fields specified in `updateMask` are applied.
341
449
  # @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
450
+ # Output only. The resource name of the network peering. Resource names are
451
+ # scheme-less URIs that follow the conventions in https://cloud.google.com/apis/
452
+ # design/resource_names. For example: `projects/my-project/locations/global/
453
+ # networkPeerings/my-peering`
454
+ # @param [Google::Apis::VmwareengineV1::NetworkPeering] network_peering_object
347
455
  # @param [String] request_id
348
456
  # Optional. A request ID to identify requests. Specify a unique request ID so
349
457
  # that if you must retry your request, the server will know to ignore the
@@ -358,7 +466,7 @@ module Google
358
466
  # 0000-000000000000).
359
467
  # @param [String] update_mask
360
468
  # 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 `
469
+ # NetworkPeering` resource by the update. The fields specified in the `
362
470
  # update_mask` are relative to the resource, not the full request. A field will
363
471
  # be overwritten if it is in the mask. If the user does not provide a mask then
364
472
  # all fields will be overwritten.
@@ -379,10 +487,10 @@ module Google
379
487
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
380
488
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
381
489
  # @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)
490
+ def patch_project_location_global_network_peering(name, network_peering_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
383
491
  command = make_simple_command(:patch, 'v1/{+name}', options)
384
- command.request_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
385
- command.request_object = network_policy_object
492
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPeering::Representation
493
+ command.request_object = network_peering_object
386
494
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
387
495
  command.response_class = Google::Apis::VmwareengineV1::Operation
388
496
  command.params['name'] = name unless name.nil?
@@ -393,12 +501,27 @@ module Google
393
501
  execute_or_queue_command(command, &block)
394
502
  end
395
503
 
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`
504
+ # Lists the network peering routes exchanged over a peering connection.
505
+ # @param [String] parent
506
+ # Required. The resource name of the network peering to retrieve peering routes
507
+ # from. Resource names are schemeless URIs that follow the conventions in https:/
508
+ # /cloud.google.com/apis/design/resource_names. For example: `projects/my-
509
+ # project/locations/global/networkPeerings/my-peering`
510
+ # @param [String] filter
511
+ # A filter expression that matches resources returned in the response. Currently,
512
+ # only filtering on the `direction` field is supported. To return routes
513
+ # imported from the peer network, provide "direction=INCOMING". To return routes
514
+ # exported from the VMware Engine network, provide "direction=OUTGOING". Other
515
+ # filter expressions return an error.
516
+ # @param [Fixnum] page_size
517
+ # The maximum number of peering routes to return in one page. The service may
518
+ # return fewer than this value. The maximum value is coerced to 1000. The
519
+ # default value of this field is 500.
520
+ # @param [String] page_token
521
+ # A page token, received from a previous `ListPeeringRoutes` call. Provide this
522
+ # to retrieve the subsequent page. When paginating, all other parameters
523
+ # provided to `ListPeeringRoutes` must match the call that provided the page
524
+ # token.
402
525
  # @param [String] fields
403
526
  # Selector specifying which fields to include in a partial response.
404
527
  # @param [String] quota_user
@@ -408,50 +531,56 @@ module Google
408
531
  # Request-specific options
409
532
  #
410
533
  # @yield [result, err] Result & error if block supplied
411
- # @yieldparam result [Google::Apis::VmwareengineV1::NodeType] parsed result object
534
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListPeeringRoutesResponse] parsed result object
412
535
  # @yieldparam err [StandardError] error object if request failed
413
536
  #
414
- # @return [Google::Apis::VmwareengineV1::NodeType]
537
+ # @return [Google::Apis::VmwareengineV1::ListPeeringRoutesResponse]
415
538
  #
416
539
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
417
540
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
418
541
  # @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?
542
+ def list_project_location_global_network_peering_peering_routes(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
543
+ command = make_simple_command(:get, 'v1/{+parent}/peeringRoutes', options)
544
+ command.response_representation = Google::Apis::VmwareengineV1::ListPeeringRoutesResponse::Representation
545
+ command.response_class = Google::Apis::VmwareengineV1::ListPeeringRoutesResponse
546
+ command.params['parent'] = parent unless parent.nil?
547
+ command.query['filter'] = filter unless filter.nil?
548
+ command.query['pageSize'] = page_size unless page_size.nil?
549
+ command.query['pageToken'] = page_token unless page_token.nil?
424
550
  command.query['fields'] = fields unless fields.nil?
425
551
  command.query['quotaUser'] = quota_user unless quota_user.nil?
426
552
  execute_or_queue_command(command, &block)
427
553
  end
428
554
 
429
- # Lists node types
555
+ # Creates a new network policy in a given VMware Engine network of a project and
556
+ # location (region). A new network policy cannot be created if another network
557
+ # policy already exists in the same scope.
430
558
  # @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.
559
+ # Required. The resource name of the location (region) to create the new network
560
+ # policy in. Resource names are schemeless URIs that follow the conventions in
561
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
562
+ # project/locations/us-central1`
563
+ # @param [Google::Apis::VmwareengineV1::NetworkPolicy] network_policy_object
564
+ # @param [String] network_policy_id
565
+ # Required. The user-provided identifier of the network policy to be created.
566
+ # This identifier must be unique within parent `projects/`my-project`/locations/`
567
+ # us-central1`/networkPolicies` and becomes the final token in the name URI. The
568
+ # identifier must meet the following requirements: * Only contains 1-63
569
+ # alphanumeric characters and hyphens * Begins with an alphabetical character *
570
+ # Ends with a non-hyphen character * Not formatted as a UUID * Complies with [
571
+ # RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
572
+ # @param [String] request_id
573
+ # Optional. A request ID to identify requests. Specify a unique request ID so
574
+ # that if you must retry your request, the server will know to ignore the
575
+ # request if it has already been completed. The server guarantees that a request
576
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
577
+ # For example, consider a situation where you make an initial request and the
578
+ # request times out. If you make the request again with the same request ID, the
579
+ # server can check if original operation with the same request ID was received,
580
+ # and if so, will ignore the second request. This prevents clients from
581
+ # accidentally creating duplicate commitments. The request ID must be a valid
582
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
583
+ # 0000-000000000000).
455
584
  # @param [String] fields
456
585
  # Selector specifying which fields to include in a partial response.
457
586
  # @param [String] quota_user
@@ -461,33 +590,48 @@ module Google
461
590
  # Request-specific options
462
591
  #
463
592
  # @yield [result, err] Result & error if block supplied
464
- # @yieldparam result [Google::Apis::VmwareengineV1::ListNodeTypesResponse] parsed result object
593
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
465
594
  # @yieldparam err [StandardError] error object if request failed
466
595
  #
467
- # @return [Google::Apis::VmwareengineV1::ListNodeTypesResponse]
596
+ # @return [Google::Apis::VmwareengineV1::Operation]
468
597
  #
469
598
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
470
599
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
471
600
  # @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
601
+ 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)
602
+ command = make_simple_command(:post, 'v1/{+parent}/networkPolicies', options)
603
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
604
+ command.request_object = network_policy_object
605
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
606
+ command.response_class = Google::Apis::VmwareengineV1::Operation
476
607
  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?
608
+ command.query['networkPolicyId'] = network_policy_id unless network_policy_id.nil?
609
+ command.query['requestId'] = request_id unless request_id.nil?
480
610
  command.query['fields'] = fields unless fields.nil?
481
611
  command.query['quotaUser'] = quota_user unless quota_user.nil?
482
612
  execute_or_queue_command(command, &block)
483
613
  end
484
614
 
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`.
615
+ # Deletes a `NetworkPolicy` resource. A network policy cannot be deleted when `
616
+ # NetworkService.state` is set to `RECONCILING` for either its external IP or
617
+ # internet access service.
489
618
  # @param [String] name
490
- # The name of the operation resource to be deleted.
619
+ # Required. The resource name of the network policy to delete. Resource names
620
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
621
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
622
+ # central1/networkPolicies/my-network-policy`
623
+ # @param [String] request_id
624
+ # Optional. A request ID to identify requests. Specify a unique request ID so
625
+ # that if you must retry your request, the server will know to ignore the
626
+ # request if it has already been completed. The server guarantees that a request
627
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
628
+ # For example, consider a situation where you make an initial request and the
629
+ # request times out. If you make the request again with the same request ID, the
630
+ # server can check if original operation with the same request ID was received,
631
+ # and if so, will ignore the second request. This prevents clients from
632
+ # accidentally creating duplicate commitments. The request ID must be a valid
633
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
634
+ # 0000-000000000000).
491
635
  # @param [String] fields
492
636
  # Selector specifying which fields to include in a partial response.
493
637
  # @param [String] quota_user
@@ -497,28 +641,76 @@ module Google
497
641
  # Request-specific options
498
642
  #
499
643
  # @yield [result, err] Result & error if block supplied
500
- # @yieldparam result [Google::Apis::VmwareengineV1::Empty] parsed result object
644
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
501
645
  # @yieldparam err [StandardError] error object if request failed
502
646
  #
503
- # @return [Google::Apis::VmwareengineV1::Empty]
647
+ # @return [Google::Apis::VmwareengineV1::Operation]
504
648
  #
505
649
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
506
650
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
507
651
  # @raise [Google::Apis::AuthorizationError] Authorization is required
508
- def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
652
+ def delete_project_location_network_policy(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
509
653
  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
654
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
655
+ command.response_class = Google::Apis::VmwareengineV1::Operation
512
656
  command.params['name'] = name unless name.nil?
657
+ command.query['requestId'] = request_id unless request_id.nil?
513
658
  command.query['fields'] = fields unless fields.nil?
514
659
  command.query['quotaUser'] = quota_user unless quota_user.nil?
515
660
  execute_or_queue_command(command, &block)
516
661
  end
517
662
 
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.
663
+ # Lists external IP addresses assigned to VMware workload VMs within the scope
664
+ # of the given network policy.
665
+ # @param [String] network_policy
666
+ # Required. The resource name of the network policy to query for assigned
667
+ # external IP addresses. Resource names are schemeless URIs that follow the
668
+ # conventions in https://cloud.google.com/apis/design/resource_names. For
669
+ # example: `projects/my-project/locations/us-central1/networkPolicies/my-policy`
670
+ # @param [Fixnum] page_size
671
+ # The maximum number of external IP addresses to return in one page. The service
672
+ # may return fewer than this value. The maximum value is coerced to 1000. The
673
+ # default value of this field is 500.
674
+ # @param [String] page_token
675
+ # A page token, received from a previous `FetchNetworkPolicyExternalAddresses`
676
+ # call. Provide this to retrieve the subsequent page. When paginating, all
677
+ # parameters provided to `FetchNetworkPolicyExternalAddresses`, except for `
678
+ # page_size` and `page_token`, must match the call that provided the page token.
679
+ # @param [String] fields
680
+ # Selector specifying which fields to include in a partial response.
681
+ # @param [String] quota_user
682
+ # Available to use for quota purposes for server-side applications. Can be any
683
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
684
+ # @param [Google::Apis::RequestOptions] options
685
+ # Request-specific options
686
+ #
687
+ # @yield [result, err] Result & error if block supplied
688
+ # @yieldparam result [Google::Apis::VmwareengineV1::FetchNetworkPolicyExternalAddressesResponse] parsed result object
689
+ # @yieldparam err [StandardError] error object if request failed
690
+ #
691
+ # @return [Google::Apis::VmwareengineV1::FetchNetworkPolicyExternalAddressesResponse]
692
+ #
693
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
694
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
695
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
696
+ def fetch_project_location_network_policy_external_addresses(network_policy, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
697
+ command = make_simple_command(:get, 'v1/{+networkPolicy}:fetchExternalAddresses', options)
698
+ command.response_representation = Google::Apis::VmwareengineV1::FetchNetworkPolicyExternalAddressesResponse::Representation
699
+ command.response_class = Google::Apis::VmwareengineV1::FetchNetworkPolicyExternalAddressesResponse
700
+ command.params['networkPolicy'] = network_policy unless network_policy.nil?
701
+ command.query['pageSize'] = page_size unless page_size.nil?
702
+ command.query['pageToken'] = page_token unless page_token.nil?
703
+ command.query['fields'] = fields unless fields.nil?
704
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
705
+ execute_or_queue_command(command, &block)
706
+ end
707
+
708
+ # Retrieves a `NetworkPolicy` resource by its resource name.
520
709
  # @param [String] name
521
- # The name of the operation resource.
710
+ # Required. The resource name of the network policy to retrieve. Resource names
711
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
712
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
713
+ # central1/networkPolicies/my-network-policy`
522
714
  # @param [String] fields
523
715
  # Selector specifying which fields to include in a partial response.
524
716
  # @param [String] quota_user
@@ -528,34 +720,57 @@ module Google
528
720
  # Request-specific options
529
721
  #
530
722
  # @yield [result, err] Result & error if block supplied
531
- # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
723
+ # @yieldparam result [Google::Apis::VmwareengineV1::NetworkPolicy] parsed result object
532
724
  # @yieldparam err [StandardError] error object if request failed
533
725
  #
534
- # @return [Google::Apis::VmwareengineV1::Operation]
726
+ # @return [Google::Apis::VmwareengineV1::NetworkPolicy]
535
727
  #
536
728
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
537
729
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
538
730
  # @raise [Google::Apis::AuthorizationError] Authorization is required
539
- def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
731
+ def get_project_location_network_policy(name, fields: nil, quota_user: nil, options: nil, &block)
540
732
  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
733
+ command.response_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
734
+ command.response_class = Google::Apis::VmwareengineV1::NetworkPolicy
543
735
  command.params['name'] = name unless name.nil?
544
736
  command.query['fields'] = fields unless fields.nil?
545
737
  command.query['quotaUser'] = quota_user unless quota_user.nil?
546
738
  execute_or_queue_command(command, &block)
547
739
  end
548
740
 
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.
741
+ # Lists `NetworkPolicy` resources in a specified project and location.
742
+ # @param [String] parent
743
+ # Required. The resource name of the location (region) to query for network
744
+ # policies. Resource names are schemeless URIs that follow the conventions in
745
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
746
+ # project/locations/us-central1`
553
747
  # @param [String] filter
554
- # The standard list filter.
748
+ # A filter expression that matches resources returned in the response. The
749
+ # expression must specify the field name, a comparison operator, and the value
750
+ # that you want to use for filtering. The value must be a string, a number, or a
751
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
752
+ # if you are filtering a list of network policies, you can exclude the ones
753
+ # named `example-policy` by specifying `name != "example-policy"`. To filter on
754
+ # multiple expressions, provide each separate expression within parentheses. For
755
+ # example: ``` (name = "example-policy") (createTime > "2021-04-12T08:15:10.40Z")
756
+ # ``` By default, each expression is an `AND` expression. However, you can
757
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
758
+ # example-policy-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
759
+ # example-policy-2") ```
760
+ # @param [String] order_by
761
+ # Sorts list results by a certain order. By default, returned results are
762
+ # ordered by `name` in ascending order. You can also sort results in descending
763
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
764
+ # ordering by `name` is supported.
555
765
  # @param [Fixnum] page_size
556
- # The standard list page size.
766
+ # The maximum number of network policies to return in one page. The service may
767
+ # return fewer than this value. The maximum value is coerced to 1000. The
768
+ # default value of this field is 500.
557
769
  # @param [String] page_token
558
- # The standard list page token.
770
+ # A page token, received from a previous `ListNetworkPolicies` call. Provide
771
+ # this to retrieve the subsequent page. When paginating, all other parameters
772
+ # provided to `ListNetworkPolicies` must match the call that provided the page
773
+ # token.
559
774
  # @param [String] fields
560
775
  # Selector specifying which fields to include in a partial response.
561
776
  # @param [String] quota_user
@@ -565,20 +780,21 @@ module Google
565
780
  # Request-specific options
566
781
  #
567
782
  # @yield [result, err] Result & error if block supplied
568
- # @yieldparam result [Google::Apis::VmwareengineV1::ListOperationsResponse] parsed result object
783
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse] parsed result object
569
784
  # @yieldparam err [StandardError] error object if request failed
570
785
  #
571
- # @return [Google::Apis::VmwareengineV1::ListOperationsResponse]
786
+ # @return [Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse]
572
787
  #
573
788
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
574
789
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
575
790
  # @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?
791
+ 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)
792
+ command = make_simple_command(:get, 'v1/{+parent}/networkPolicies', options)
793
+ command.response_representation = Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse::Representation
794
+ command.response_class = Google::Apis::VmwareengineV1::ListNetworkPoliciesResponse
795
+ command.params['parent'] = parent unless parent.nil?
581
796
  command.query['filter'] = filter unless filter.nil?
797
+ command.query['orderBy'] = order_by unless order_by.nil?
582
798
  command.query['pageSize'] = page_size unless page_size.nil?
583
799
  command.query['pageToken'] = page_token unless page_token.nil?
584
800
  command.query['fields'] = fields unless fields.nil?
@@ -586,31 +802,98 @@ module Google
586
802
  execute_or_queue_command(command, &block)
587
803
  end
588
804
 
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.
805
+ # Modifies a `NetworkPolicy` resource. Only the following fields can be updated:
806
+ # `internet_access`, `external_ip`, `edge_services_cidr`. Only fields specified
807
+ # in `updateMask` are applied. When updating a network policy, the external IP
808
+ # network service can only be disabled if there are no external IP addresses
809
+ # present in the scope of the policy. Also, a `NetworkService` cannot be updated
810
+ # when `NetworkService.state` is set to `RECONCILING`. During operation
811
+ # processing, the resource is temporarily in the `ACTIVE` state before the
812
+ # operation fully completes. For that period of time, you can't update the
813
+ # resource. Use the operation status to determine when the processing fully
814
+ # completes.
815
+ # @param [String] name
816
+ # Output only. The resource name of this network policy. Resource names are
817
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
818
+ # design/resource_names. For example: `projects/my-project/locations/us-central1/
819
+ # networkPolicies/my-network-policy`
820
+ # @param [Google::Apis::VmwareengineV1::NetworkPolicy] network_policy_object
821
+ # @param [String] request_id
822
+ # Optional. A request ID to identify requests. Specify a unique request ID so
823
+ # that if you must retry your request, the server will know to ignore the
824
+ # request if it has already been completed. The server guarantees that a request
825
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
826
+ # For example, consider a situation where you make an initial request and the
827
+ # request times out. If you make the request again with the same request ID, the
828
+ # server can check if original operation with the same request ID was received,
829
+ # and if so, will ignore the second request. This prevents clients from
830
+ # accidentally creating duplicate commitments. The request ID must be a valid
831
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
832
+ # 0000-000000000000).
833
+ # @param [String] update_mask
834
+ # Required. Field mask is used to specify the fields to be overwritten in the `
835
+ # NetworkPolicy` resource by the update. The fields specified in the `
836
+ # update_mask` are relative to the resource, not the full request. A field will
837
+ # be overwritten if it is in the mask. If the user does not provide a mask then
838
+ # all fields will be overwritten.
839
+ # @param [String] fields
840
+ # Selector specifying which fields to include in a partial response.
841
+ # @param [String] quota_user
842
+ # Available to use for quota purposes for server-side applications. Can be any
843
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
844
+ # @param [Google::Apis::RequestOptions] options
845
+ # Request-specific options
846
+ #
847
+ # @yield [result, err] Result & error if block supplied
848
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
849
+ # @yieldparam err [StandardError] error object if request failed
850
+ #
851
+ # @return [Google::Apis::VmwareengineV1::Operation]
852
+ #
853
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
854
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
855
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
856
+ 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)
857
+ command = make_simple_command(:patch, 'v1/{+name}', options)
858
+ command.request_representation = Google::Apis::VmwareengineV1::NetworkPolicy::Representation
859
+ command.request_object = network_policy_object
860
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
861
+ command.response_class = Google::Apis::VmwareengineV1::Operation
862
+ command.params['name'] = name unless name.nil?
863
+ command.query['requestId'] = request_id unless request_id.nil?
864
+ command.query['updateMask'] = update_mask unless update_mask.nil?
865
+ command.query['fields'] = fields unless fields.nil?
866
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
867
+ execute_or_queue_command(command, &block)
868
+ end
869
+
870
+ # Creates a new external access rule in a given network policy.
594
871
  # @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)
872
+ # Required. The resource name of the network policy to create a new external
873
+ # access firewall rule in. Resource names are schemeless URIs that follow the
874
+ # conventions in https://cloud.google.com/apis/design/resource_names. For
875
+ # example: `projects/my-project/locations/us-central1/networkPolicies/my-policy`
876
+ # @param [Google::Apis::VmwareengineV1::ExternalAccessRule] external_access_rule_object
877
+ # @param [String] external_access_rule_id
878
+ # Required. The user-provided identifier of the `ExternalAccessRule` to be
879
+ # created. This identifier must be unique among `ExternalAccessRule` resources
880
+ # within the parent and becomes the final token in the name URI. The identifier
881
+ # must meet the following requirements: * Only contains 1-63 alphanumeric
882
+ # characters and hyphens * Begins with an alphabetical character * Ends with a
883
+ # non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](
884
+ # https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
608
885
  # @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.
886
+ # A request ID to identify requests. Specify a unique request ID so that if you
887
+ # must retry your request, the server will know to ignore the request if it has
888
+ # already been completed. The server guarantees that a request doesn't result in
889
+ # creation of duplicate commitments for at least 60 minutes. For example,
890
+ # consider a situation where you make an initial request and the request times
891
+ # out. If you make the request again with the same request ID, the server can
892
+ # check if the original operation with the same request ID was received, and if
893
+ # so, will ignore the second request. This prevents clients from accidentally
894
+ # creating duplicate commitments. The request ID must be a valid UUID with the
895
+ # exception that zero UUID is not supported (00000000-0000-0000-0000-
896
+ # 000000000000).
614
897
  # @param [String] fields
615
898
  # Selector specifying which fields to include in a partial response.
616
899
  # @param [String] quota_user
@@ -628,28 +911,477 @@ module Google
628
911
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
629
912
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
630
913
  # @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
914
+ def create_project_location_network_policy_external_access_rule(parent, external_access_rule_object = nil, external_access_rule_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
915
+ command = make_simple_command(:post, 'v1/{+parent}/externalAccessRules', options)
916
+ command.request_representation = Google::Apis::VmwareengineV1::ExternalAccessRule::Representation
917
+ command.request_object = external_access_rule_object
635
918
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
636
919
  command.response_class = Google::Apis::VmwareengineV1::Operation
637
920
  command.params['parent'] = parent unless parent.nil?
638
- command.query['privateCloudId'] = private_cloud_id unless private_cloud_id.nil?
921
+ command.query['externalAccessRuleId'] = external_access_rule_id unless external_access_rule_id.nil?
639
922
  command.query['requestId'] = request_id unless request_id.nil?
640
- command.query['validateOnly'] = validate_only unless validate_only.nil?
641
923
  command.query['fields'] = fields unless fields.nil?
642
924
  command.query['quotaUser'] = quota_user unless quota_user.nil?
643
925
  execute_or_queue_command(command, &block)
644
926
  end
645
927
 
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 `
928
+ # Deletes a single external access rule.
929
+ # @param [String] name
930
+ # Required. The resource name of the external access firewall rule to delete.
931
+ # Resource names are schemeless URIs that follow the conventions in https://
932
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
933
+ # locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`
934
+ # @param [String] request_id
935
+ # Optional. A request ID to identify requests. Specify a unique request ID so
936
+ # that if you must retry your request, the server will know to ignore the
937
+ # request if it has already been completed. The server guarantees that a request
938
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
939
+ # For example, consider a situation where you make an initial request and the
940
+ # request times out. If you make the request again with the same request ID, the
941
+ # server can check if the original operation with the same request ID was
942
+ # received, and if so, will ignore the second request. This prevents clients
943
+ # from accidentally creating duplicate commitments. The request ID must be a
944
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
945
+ # 0000-0000-000000000000).
946
+ # @param [String] fields
947
+ # Selector specifying which fields to include in a partial response.
948
+ # @param [String] quota_user
949
+ # Available to use for quota purposes for server-side applications. Can be any
950
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
951
+ # @param [Google::Apis::RequestOptions] options
952
+ # Request-specific options
953
+ #
954
+ # @yield [result, err] Result & error if block supplied
955
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
956
+ # @yieldparam err [StandardError] error object if request failed
957
+ #
958
+ # @return [Google::Apis::VmwareengineV1::Operation]
959
+ #
960
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
961
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
962
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
963
+ def delete_project_location_network_policy_external_access_rule(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
964
+ command = make_simple_command(:delete, 'v1/{+name}', options)
965
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
966
+ command.response_class = Google::Apis::VmwareengineV1::Operation
967
+ command.params['name'] = name unless name.nil?
968
+ command.query['requestId'] = request_id unless request_id.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Gets details of a single external access rule.
975
+ # @param [String] name
976
+ # Required. The resource name of the external access firewall rule to retrieve.
977
+ # Resource names are schemeless URIs that follow the conventions in https://
978
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
979
+ # locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`
980
+ # @param [String] fields
981
+ # Selector specifying which fields to include in a partial response.
982
+ # @param [String] quota_user
983
+ # Available to use for quota purposes for server-side applications. Can be any
984
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
985
+ # @param [Google::Apis::RequestOptions] options
986
+ # Request-specific options
987
+ #
988
+ # @yield [result, err] Result & error if block supplied
989
+ # @yieldparam result [Google::Apis::VmwareengineV1::ExternalAccessRule] parsed result object
990
+ # @yieldparam err [StandardError] error object if request failed
991
+ #
992
+ # @return [Google::Apis::VmwareengineV1::ExternalAccessRule]
993
+ #
994
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
995
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
996
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
997
+ def get_project_location_network_policy_external_access_rule(name, fields: nil, quota_user: nil, options: nil, &block)
998
+ command = make_simple_command(:get, 'v1/{+name}', options)
999
+ command.response_representation = Google::Apis::VmwareengineV1::ExternalAccessRule::Representation
1000
+ command.response_class = Google::Apis::VmwareengineV1::ExternalAccessRule
1001
+ command.params['name'] = name unless name.nil?
1002
+ command.query['fields'] = fields unless fields.nil?
1003
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1004
+ execute_or_queue_command(command, &block)
1005
+ end
1006
+
1007
+ # Lists `ExternalAccessRule` resources in the specified network policy.
1008
+ # @param [String] parent
1009
+ # Required. The resource name of the network policy to query for external access
1010
+ # firewall rules. Resource names are schemeless URIs that follow the conventions
1011
+ # in https://cloud.google.com/apis/design/resource_names. For example: `projects/
1012
+ # my-project/locations/us-central1/networkPolicies/my-policy`
1013
+ # @param [String] filter
1014
+ # A filter expression that matches resources returned in the response. The
1015
+ # expression must specify the field name, a comparison operator, and the value
1016
+ # that you want to use for filtering. The value must be a string, a number, or a
1017
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
1018
+ # if you are filtering a list of external access rules, you can exclude the ones
1019
+ # named `example-rule` by specifying `name != "example-rule"`. To filter on
1020
+ # multiple expressions, provide each separate expression within parentheses. For
1021
+ # example: ``` (name = "example-rule") (createTime > "2021-04-12T08:15:10.40Z") `
1022
+ # `` By default, each expression is an `AND` expression. However, you can
1023
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
1024
+ # example-rule-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
1025
+ # example-rule-2") ```
1026
+ # @param [String] order_by
1027
+ # Sorts list results by a certain order. By default, returned results are
1028
+ # ordered by `name` in ascending order. You can also sort results in descending
1029
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
1030
+ # ordering by `name` is supported.
1031
+ # @param [Fixnum] page_size
1032
+ # The maximum number of external access rules to return in one page. The service
1033
+ # may return fewer than this value. The maximum value is coerced to 1000. The
1034
+ # default value of this field is 500.
1035
+ # @param [String] page_token
1036
+ # A page token, received from a previous `ListExternalAccessRulesRequest` call.
1037
+ # Provide this to retrieve the subsequent page. When paginating, all other
1038
+ # parameters provided to `ListExternalAccessRulesRequest` must match the call
1039
+ # that provided the page token.
1040
+ # @param [String] fields
1041
+ # Selector specifying which fields to include in a partial response.
1042
+ # @param [String] quota_user
1043
+ # Available to use for quota purposes for server-side applications. Can be any
1044
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1045
+ # @param [Google::Apis::RequestOptions] options
1046
+ # Request-specific options
1047
+ #
1048
+ # @yield [result, err] Result & error if block supplied
1049
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListExternalAccessRulesResponse] parsed result object
1050
+ # @yieldparam err [StandardError] error object if request failed
1051
+ #
1052
+ # @return [Google::Apis::VmwareengineV1::ListExternalAccessRulesResponse]
1053
+ #
1054
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1055
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1056
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1057
+ def list_project_location_network_policy_external_access_rules(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1058
+ command = make_simple_command(:get, 'v1/{+parent}/externalAccessRules', options)
1059
+ command.response_representation = Google::Apis::VmwareengineV1::ListExternalAccessRulesResponse::Representation
1060
+ command.response_class = Google::Apis::VmwareengineV1::ListExternalAccessRulesResponse
1061
+ command.params['parent'] = parent unless parent.nil?
1062
+ command.query['filter'] = filter unless filter.nil?
1063
+ command.query['orderBy'] = order_by unless order_by.nil?
1064
+ command.query['pageSize'] = page_size unless page_size.nil?
1065
+ command.query['pageToken'] = page_token unless page_token.nil?
1066
+ command.query['fields'] = fields unless fields.nil?
1067
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1068
+ execute_or_queue_command(command, &block)
1069
+ end
1070
+
1071
+ # Updates the parameters of a single external access rule. Only fields specified
1072
+ # in `update_mask` are applied.
1073
+ # @param [String] name
1074
+ # Output only. The resource name of this external access rule. Resource names
1075
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
1076
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
1077
+ # central1/networkPolicies/my-policy/externalAccessRules/my-rule`
1078
+ # @param [Google::Apis::VmwareengineV1::ExternalAccessRule] external_access_rule_object
1079
+ # @param [String] request_id
1080
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1081
+ # that if you must retry your request, the server will know to ignore the
1082
+ # request if it has already been completed. The server guarantees that a request
1083
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
1084
+ # For example, consider a situation where you make an initial request and the
1085
+ # request times out. If you make the request again with the same request ID, the
1086
+ # server can check if the original operation with the same request ID was
1087
+ # received, and if so, will ignore the second request. This prevents clients
1088
+ # from accidentally creating duplicate commitments. The request ID must be a
1089
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
1090
+ # 0000-0000-000000000000).
1091
+ # @param [String] update_mask
1092
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1093
+ # ExternalAccessRule` resource by the update. The fields specified in the `
1094
+ # update_mask` are relative to the resource, not the full request. A field will
1095
+ # be overwritten if it is in the mask. If the user does not provide a mask then
1096
+ # all fields will be overwritten.
1097
+ # @param [String] fields
1098
+ # Selector specifying which fields to include in a partial response.
1099
+ # @param [String] quota_user
1100
+ # Available to use for quota purposes for server-side applications. Can be any
1101
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1102
+ # @param [Google::Apis::RequestOptions] options
1103
+ # Request-specific options
1104
+ #
1105
+ # @yield [result, err] Result & error if block supplied
1106
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1107
+ # @yieldparam err [StandardError] error object if request failed
1108
+ #
1109
+ # @return [Google::Apis::VmwareengineV1::Operation]
1110
+ #
1111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1114
+ def patch_project_location_network_policy_external_access_rule(name, external_access_rule_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1115
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1116
+ command.request_representation = Google::Apis::VmwareengineV1::ExternalAccessRule::Representation
1117
+ command.request_object = external_access_rule_object
1118
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1119
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1120
+ command.params['name'] = name unless name.nil?
1121
+ command.query['requestId'] = request_id unless request_id.nil?
1122
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1123
+ command.query['fields'] = fields unless fields.nil?
1124
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1125
+ execute_or_queue_command(command, &block)
1126
+ end
1127
+
1128
+ # Gets details of a single `NodeType`.
1129
+ # @param [String] name
1130
+ # Required. The resource name of the node type to retrieve. Resource names are
1131
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1132
+ # design/resource_names. For example: `projects/my-proj/locations/us-central1-a/
1133
+ # nodeTypes/standard-72`
1134
+ # @param [String] fields
1135
+ # Selector specifying which fields to include in a partial response.
1136
+ # @param [String] quota_user
1137
+ # Available to use for quota purposes for server-side applications. Can be any
1138
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1139
+ # @param [Google::Apis::RequestOptions] options
1140
+ # Request-specific options
1141
+ #
1142
+ # @yield [result, err] Result & error if block supplied
1143
+ # @yieldparam result [Google::Apis::VmwareengineV1::NodeType] parsed result object
1144
+ # @yieldparam err [StandardError] error object if request failed
1145
+ #
1146
+ # @return [Google::Apis::VmwareengineV1::NodeType]
1147
+ #
1148
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1149
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1150
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1151
+ def get_project_location_node_type(name, fields: nil, quota_user: nil, options: nil, &block)
1152
+ command = make_simple_command(:get, 'v1/{+name}', options)
1153
+ command.response_representation = Google::Apis::VmwareengineV1::NodeType::Representation
1154
+ command.response_class = Google::Apis::VmwareengineV1::NodeType
1155
+ command.params['name'] = name unless name.nil?
1156
+ command.query['fields'] = fields unless fields.nil?
1157
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1158
+ execute_or_queue_command(command, &block)
1159
+ end
1160
+
1161
+ # Lists node types
1162
+ # @param [String] parent
1163
+ # Required. The resource name of the location to be queried for node types.
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`
1167
+ # @param [String] filter
1168
+ # A filter expression that matches resources returned in the response. The
1169
+ # expression must specify the field name, a comparison operator, and the value
1170
+ # that you want to use for filtering. The value must be a string, a number, or a
1171
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
1172
+ # if you are filtering a list of node types, you can exclude the ones named `
1173
+ # standard-72` by specifying `name != "standard-72"`. To filter on multiple
1174
+ # expressions, provide each separate expression within parentheses. For example:
1175
+ # ``` (name = "standard-72") (virtual_cpu_count > 2) ``` By default, each
1176
+ # expression is an `AND` expression. However, you can include `AND` and `OR`
1177
+ # expressions explicitly. For example: ``` (name = "standard-96") AND (
1178
+ # virtual_cpu_count > 2) OR (name = "standard-72") ```
1179
+ # @param [Fixnum] page_size
1180
+ # The maximum number of node types to return in one page. The service may return
1181
+ # fewer than this value. The maximum value is coerced to 1000. The default value
1182
+ # of this field is 500.
1183
+ # @param [String] page_token
1184
+ # A page token, received from a previous `ListNodeTypes` call. Provide this to
1185
+ # retrieve the subsequent page. When paginating, all other parameters provided
1186
+ # to `ListNodeTypes` must match the call that provided the page token.
1187
+ # @param [String] fields
1188
+ # Selector specifying which fields to include in a partial response.
1189
+ # @param [String] quota_user
1190
+ # Available to use for quota purposes for server-side applications. Can be any
1191
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1192
+ # @param [Google::Apis::RequestOptions] options
1193
+ # Request-specific options
1194
+ #
1195
+ # @yield [result, err] Result & error if block supplied
1196
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNodeTypesResponse] parsed result object
1197
+ # @yieldparam err [StandardError] error object if request failed
1198
+ #
1199
+ # @return [Google::Apis::VmwareengineV1::ListNodeTypesResponse]
1200
+ #
1201
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1202
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1203
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1204
+ def list_project_location_node_types(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1205
+ command = make_simple_command(:get, 'v1/{+parent}/nodeTypes', options)
1206
+ command.response_representation = Google::Apis::VmwareengineV1::ListNodeTypesResponse::Representation
1207
+ command.response_class = Google::Apis::VmwareengineV1::ListNodeTypesResponse
1208
+ command.params['parent'] = parent unless parent.nil?
1209
+ command.query['filter'] = filter unless filter.nil?
1210
+ command.query['pageSize'] = page_size unless page_size.nil?
1211
+ command.query['pageToken'] = page_token unless page_token.nil?
1212
+ command.query['fields'] = fields unless fields.nil?
1213
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1214
+ execute_or_queue_command(command, &block)
1215
+ end
1216
+
1217
+ # Deletes a long-running operation. This method indicates that the client is no
1218
+ # longer interested in the operation result. It does not cancel the operation.
1219
+ # If the server doesn't support this method, it returns `google.rpc.Code.
1220
+ # UNIMPLEMENTED`.
1221
+ # @param [String] name
1222
+ # The name of the operation resource to be deleted.
1223
+ # @param [String] fields
1224
+ # Selector specifying which fields to include in a partial response.
1225
+ # @param [String] quota_user
1226
+ # Available to use for quota purposes for server-side applications. Can be any
1227
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1228
+ # @param [Google::Apis::RequestOptions] options
1229
+ # Request-specific options
1230
+ #
1231
+ # @yield [result, err] Result & error if block supplied
1232
+ # @yieldparam result [Google::Apis::VmwareengineV1::Empty] parsed result object
1233
+ # @yieldparam err [StandardError] error object if request failed
1234
+ #
1235
+ # @return [Google::Apis::VmwareengineV1::Empty]
1236
+ #
1237
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1238
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1239
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1240
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1241
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1242
+ command.response_representation = Google::Apis::VmwareengineV1::Empty::Representation
1243
+ command.response_class = Google::Apis::VmwareengineV1::Empty
1244
+ command.params['name'] = name unless name.nil?
1245
+ command.query['fields'] = fields unless fields.nil?
1246
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1247
+ execute_or_queue_command(command, &block)
1248
+ end
1249
+
1250
+ # Gets the latest state of a long-running operation. Clients can use this method
1251
+ # to poll the operation result at intervals as recommended by the API service.
1252
+ # @param [String] name
1253
+ # The name of the operation resource.
1254
+ # @param [String] fields
1255
+ # Selector specifying which fields to include in a partial response.
1256
+ # @param [String] quota_user
1257
+ # Available to use for quota purposes for server-side applications. Can be any
1258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1259
+ # @param [Google::Apis::RequestOptions] options
1260
+ # Request-specific options
1261
+ #
1262
+ # @yield [result, err] Result & error if block supplied
1263
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1264
+ # @yieldparam err [StandardError] error object if request failed
1265
+ #
1266
+ # @return [Google::Apis::VmwareengineV1::Operation]
1267
+ #
1268
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1269
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1270
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1271
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1272
+ command = make_simple_command(:get, 'v1/{+name}', options)
1273
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1274
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1275
+ command.params['name'] = name unless name.nil?
1276
+ command.query['fields'] = fields unless fields.nil?
1277
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1278
+ execute_or_queue_command(command, &block)
1279
+ end
1280
+
1281
+ # Lists operations that match the specified filter in the request. If the server
1282
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1283
+ # @param [String] name
1284
+ # The name of the operation's parent resource.
1285
+ # @param [String] filter
1286
+ # The standard list filter.
1287
+ # @param [Fixnum] page_size
1288
+ # The standard list page size.
1289
+ # @param [String] page_token
1290
+ # The standard list page token.
1291
+ # @param [String] fields
1292
+ # Selector specifying which fields to include in a partial response.
1293
+ # @param [String] quota_user
1294
+ # Available to use for quota purposes for server-side applications. Can be any
1295
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1296
+ # @param [Google::Apis::RequestOptions] options
1297
+ # Request-specific options
1298
+ #
1299
+ # @yield [result, err] Result & error if block supplied
1300
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListOperationsResponse] parsed result object
1301
+ # @yieldparam err [StandardError] error object if request failed
1302
+ #
1303
+ # @return [Google::Apis::VmwareengineV1::ListOperationsResponse]
1304
+ #
1305
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1306
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1307
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1308
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1309
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1310
+ command.response_representation = Google::Apis::VmwareengineV1::ListOperationsResponse::Representation
1311
+ command.response_class = Google::Apis::VmwareengineV1::ListOperationsResponse
1312
+ command.params['name'] = name unless name.nil?
1313
+ command.query['filter'] = filter unless filter.nil?
1314
+ command.query['pageSize'] = page_size unless page_size.nil?
1315
+ command.query['pageToken'] = page_token unless page_token.nil?
1316
+ command.query['fields'] = fields unless fields.nil?
1317
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1318
+ execute_or_queue_command(command, &block)
1319
+ end
1320
+
1321
+ # Creates a new `PrivateCloud` resource in a given project and location. Private
1322
+ # clouds of type `STANDARD` and `TIME_LIMITED` are zonal resources, `STRETCHED`
1323
+ # private clouds are regional. Creating a private cloud also creates a [
1324
+ # management cluster](https://cloud.google.com/vmware-engine/docs/concepts-
1325
+ # vmware-components) for that private cloud.
1326
+ # @param [String] parent
1327
+ # Required. The resource name of the location to create the new private cloud in.
1328
+ # Resource names are schemeless URIs that follow the conventions in https://
1329
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1330
+ # locations/us-central1-a`
1331
+ # @param [Google::Apis::VmwareengineV1::PrivateCloud] private_cloud_object
1332
+ # @param [String] private_cloud_id
1333
+ # Required. The user-provided identifier of the private cloud to be created.
1334
+ # This identifier must be unique among each `PrivateCloud` within the parent and
1335
+ # becomes the final token in the name URI. The identifier must meet the
1336
+ # following requirements: * Only contains 1-63 alphanumeric characters and
1337
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
1338
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
1339
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
1340
+ # @param [String] request_id
1341
+ # Optional. The request ID must be a valid UUID with the exception that zero
1342
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1343
+ # @param [Boolean] validate_only
1344
+ # Optional. True if you want the request to be validated and not executed; false
1345
+ # otherwise.
1346
+ # @param [String] fields
1347
+ # Selector specifying which fields to include in a partial response.
1348
+ # @param [String] quota_user
1349
+ # Available to use for quota purposes for server-side applications. Can be any
1350
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1351
+ # @param [Google::Apis::RequestOptions] options
1352
+ # Request-specific options
1353
+ #
1354
+ # @yield [result, err] Result & error if block supplied
1355
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1356
+ # @yieldparam err [StandardError] error object if request failed
1357
+ #
1358
+ # @return [Google::Apis::VmwareengineV1::Operation]
1359
+ #
1360
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1361
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1362
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1363
+ 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)
1364
+ command = make_simple_command(:post, 'v1/{+parent}/privateClouds', options)
1365
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
1366
+ command.request_object = private_cloud_object
1367
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1368
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1369
+ command.params['parent'] = parent unless parent.nil?
1370
+ command.query['privateCloudId'] = private_cloud_id unless private_cloud_id.nil?
1371
+ command.query['requestId'] = request_id unless request_id.nil?
1372
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1373
+ command.query['fields'] = fields unless fields.nil?
1374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1375
+ execute_or_queue_command(command, &block)
1376
+ end
1377
+
1378
+ # Schedules a `PrivateCloud` resource for deletion. A `PrivateCloud` resource
1379
+ # scheduled for deletion has `PrivateCloud.state` set to `DELETED` and `
1380
+ # expireTime` set to the time when deletion is final and can no longer be
1381
+ # reversed. The delete operation is marked as done as soon as the `PrivateCloud`
1382
+ # is successfully scheduled for deletion (this also applies when `delayHours` is
1383
+ # set to zero), and the operation is not kept in pending state until `
1384
+ # PrivateCloud` is purged. `PrivateCloud` can be restored using `
653
1385
  # UndeletePrivateCloud` method before the `expireTime` elapses. When `expireTime`
654
1386
  # is reached, deletion is final and all private cloud resources are
655
1387
  # irreversibly removed and billing stops. During the final removal process, `
@@ -657,26 +1389,854 @@ module Google
657
1389
  # standard `GET` method for the whole period of deletion and purging. It will
658
1390
  # not be returned only when it is completely purged.
659
1391
  # @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.
1392
+ # Required. The resource name of the private cloud to delete. Resource names are
1393
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1394
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
1395
+ # a/privateClouds/my-cloud`
1396
+ # @param [Fixnum] delay_hours
1397
+ # Optional. Time delay of the deletion specified in hours. The default value is `
1398
+ # 3`. Specifying a non-zero value for this field changes the value of `
1399
+ # PrivateCloud.state` to `DELETED` and sets `expire_time` to the planned
1400
+ # deletion time. Deletion can be cancelled before `expire_time` elapses using
1401
+ # VmwareEngine.UndeletePrivateCloud. Specifying a value of `0` for this field
1402
+ # instead begins the deletion process and ceases billing immediately. During the
1403
+ # final deletion process, the value of `PrivateCloud.state` becomes `PURGING`.
1404
+ # @param [Boolean] force
1405
+ # Optional. If set to true, cascade delete is enabled and all children of this
1406
+ # private cloud resource are also deleted. When this flag is set to false, the
1407
+ # private cloud will not be deleted if there are any children other than the
1408
+ # management cluster. The management cluster is always deleted.
1409
+ # @param [String] request_id
1410
+ # Optional. The request ID must be a valid UUID with the exception that zero
1411
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1412
+ # @param [String] fields
1413
+ # Selector specifying which fields to include in a partial response.
1414
+ # @param [String] quota_user
1415
+ # Available to use for quota purposes for server-side applications. Can be any
1416
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1417
+ # @param [Google::Apis::RequestOptions] options
1418
+ # Request-specific options
1419
+ #
1420
+ # @yield [result, err] Result & error if block supplied
1421
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1422
+ # @yieldparam err [StandardError] error object if request failed
1423
+ #
1424
+ # @return [Google::Apis::VmwareengineV1::Operation]
1425
+ #
1426
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1427
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1428
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1429
+ def delete_project_location_private_cloud(name, delay_hours: nil, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1430
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1431
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1432
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1433
+ command.params['name'] = name unless name.nil?
1434
+ command.query['delayHours'] = delay_hours unless delay_hours.nil?
1435
+ command.query['force'] = force unless force.nil?
1436
+ command.query['requestId'] = request_id unless request_id.nil?
1437
+ command.query['fields'] = fields unless fields.nil?
1438
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1439
+ execute_or_queue_command(command, &block)
1440
+ end
1441
+
1442
+ # Retrieves a `PrivateCloud` resource by its resource name.
1443
+ # @param [String] name
1444
+ # Required. The resource name of the private cloud to retrieve. Resource names
1445
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
1446
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
1447
+ # central1-a/privateClouds/my-cloud`
1448
+ # @param [String] fields
1449
+ # Selector specifying which fields to include in a partial response.
1450
+ # @param [String] quota_user
1451
+ # Available to use for quota purposes for server-side applications. Can be any
1452
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1453
+ # @param [Google::Apis::RequestOptions] options
1454
+ # Request-specific options
1455
+ #
1456
+ # @yield [result, err] Result & error if block supplied
1457
+ # @yieldparam result [Google::Apis::VmwareengineV1::PrivateCloud] parsed result object
1458
+ # @yieldparam err [StandardError] error object if request failed
1459
+ #
1460
+ # @return [Google::Apis::VmwareengineV1::PrivateCloud]
1461
+ #
1462
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1463
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1464
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1465
+ def get_project_location_private_cloud(name, fields: nil, quota_user: nil, options: nil, &block)
1466
+ command = make_simple_command(:get, 'v1/{+name}', options)
1467
+ command.response_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
1468
+ command.response_class = Google::Apis::VmwareengineV1::PrivateCloud
1469
+ command.params['name'] = name unless name.nil?
1470
+ command.query['fields'] = fields unless fields.nil?
1471
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1472
+ execute_or_queue_command(command, &block)
1473
+ end
1474
+
1475
+ # Gets details of the `DnsForwarding` config.
1476
+ # @param [String] name
1477
+ # Required. The resource name of a `DnsForwarding` to retrieve. Resource names
1478
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
1479
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
1480
+ # central1-a/privateClouds/my-cloud/dnsForwarding`
1481
+ # @param [String] fields
1482
+ # Selector specifying which fields to include in a partial response.
1483
+ # @param [String] quota_user
1484
+ # Available to use for quota purposes for server-side applications. Can be any
1485
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1486
+ # @param [Google::Apis::RequestOptions] options
1487
+ # Request-specific options
1488
+ #
1489
+ # @yield [result, err] Result & error if block supplied
1490
+ # @yieldparam result [Google::Apis::VmwareengineV1::DnsForwarding] parsed result object
1491
+ # @yieldparam err [StandardError] error object if request failed
1492
+ #
1493
+ # @return [Google::Apis::VmwareengineV1::DnsForwarding]
1494
+ #
1495
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1496
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1497
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1498
+ def get_project_location_private_cloud_dns_forwarding(name, fields: nil, quota_user: nil, options: nil, &block)
1499
+ command = make_simple_command(:get, 'v1/{+name}', options)
1500
+ command.response_representation = Google::Apis::VmwareengineV1::DnsForwarding::Representation
1501
+ command.response_class = Google::Apis::VmwareengineV1::DnsForwarding
1502
+ command.params['name'] = name unless name.nil?
1503
+ command.query['fields'] = fields unless fields.nil?
1504
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1505
+ execute_or_queue_command(command, &block)
1506
+ end
1507
+
1508
+ # Gets the access control policy for a resource. Returns an empty policy if the
1509
+ # resource exists and does not have a policy set.
1510
+ # @param [String] resource
1511
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1512
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1513
+ # appropriate value for this field.
1514
+ # @param [Fixnum] options_requested_policy_version
1515
+ # Optional. The maximum policy version that will be used to format the policy.
1516
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1517
+ # rejected. Requests for policies with any conditional role bindings must
1518
+ # specify version 3. Policies with no conditional role bindings may specify any
1519
+ # valid value or leave the field unset. The policy in the response might use the
1520
+ # policy version that you specified, or it might use a lower policy version. For
1521
+ # example, if you specify version 3, but the policy has no conditional role
1522
+ # bindings, the response uses version 1. To learn which resources support
1523
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1524
+ # google.com/iam/help/conditions/resource-policies).
1525
+ # @param [String] fields
1526
+ # Selector specifying which fields to include in a partial response.
1527
+ # @param [String] quota_user
1528
+ # Available to use for quota purposes for server-side applications. Can be any
1529
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1530
+ # @param [Google::Apis::RequestOptions] options
1531
+ # Request-specific options
1532
+ #
1533
+ # @yield [result, err] Result & error if block supplied
1534
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1535
+ # @yieldparam err [StandardError] error object if request failed
1536
+ #
1537
+ # @return [Google::Apis::VmwareengineV1::Policy]
1538
+ #
1539
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1540
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1541
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1542
+ def get_project_location_private_cloud_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1543
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1544
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1545
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1546
+ command.params['resource'] = resource unless resource.nil?
1547
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1548
+ command.query['fields'] = fields unless fields.nil?
1549
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1550
+ execute_or_queue_command(command, &block)
1551
+ end
1552
+
1553
+ # Lists `PrivateCloud` resources in a given project and location.
1554
+ # @param [String] parent
1555
+ # Required. The resource name of the private cloud to be queried for clusters.
1556
+ # Resource names are schemeless URIs that follow the conventions in https://
1557
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1558
+ # locations/us-central1-a`
1559
+ # @param [String] filter
1560
+ # A filter expression that matches resources returned in the response. The
1561
+ # expression must specify the field name, a comparison operator, and the value
1562
+ # that you want to use for filtering. The value must be a string, a number, or a
1563
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
1564
+ # if you are filtering a list of private clouds, you can exclude the ones named `
1565
+ # example-pc` by specifying `name != "example-pc"`. You can also filter nested
1566
+ # fields. For example, you could specify `networkConfig.managementCidr = "192.
1567
+ # 168.0.0/24"` to include private clouds only if they have a matching address in
1568
+ # their network configuration. To filter on multiple expressions, provide each
1569
+ # separate expression within parentheses. For example: ``` (name = "example-pc")
1570
+ # (createTime > "2021-04-12T08:15:10.40Z") ``` By default, each expression is an
1571
+ # `AND` expression. However, you can include `AND` and `OR` expressions
1572
+ # explicitly. For example: ``` (name = "private-cloud-1") AND (createTime > "
1573
+ # 2021-04-12T08:15:10.40Z") OR (name = "private-cloud-2") ```
1574
+ # @param [String] order_by
1575
+ # Sorts list results by a certain order. By default, returned results are
1576
+ # ordered by `name` in ascending order. You can also sort results in descending
1577
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
1578
+ # ordering by `name` is supported.
1579
+ # @param [Fixnum] page_size
1580
+ # The maximum number of private clouds to return in one page. The service may
1581
+ # return fewer than this value. The maximum value is coerced to 1000. The
1582
+ # default value of this field is 500.
1583
+ # @param [String] page_token
1584
+ # A page token, received from a previous `ListPrivateClouds` call. Provide this
1585
+ # to retrieve the subsequent page. When paginating, all other parameters
1586
+ # provided to `ListPrivateClouds` must match the call that provided the page
1587
+ # token.
1588
+ # @param [String] fields
1589
+ # Selector specifying which fields to include in a partial response.
1590
+ # @param [String] quota_user
1591
+ # Available to use for quota purposes for server-side applications. Can be any
1592
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1593
+ # @param [Google::Apis::RequestOptions] options
1594
+ # Request-specific options
1595
+ #
1596
+ # @yield [result, err] Result & error if block supplied
1597
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse] parsed result object
1598
+ # @yieldparam err [StandardError] error object if request failed
1599
+ #
1600
+ # @return [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse]
1601
+ #
1602
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1603
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1604
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1605
+ 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)
1606
+ command = make_simple_command(:get, 'v1/{+parent}/privateClouds', options)
1607
+ command.response_representation = Google::Apis::VmwareengineV1::ListPrivateCloudsResponse::Representation
1608
+ command.response_class = Google::Apis::VmwareengineV1::ListPrivateCloudsResponse
1609
+ command.params['parent'] = parent unless parent.nil?
1610
+ command.query['filter'] = filter unless filter.nil?
1611
+ command.query['orderBy'] = order_by unless order_by.nil?
1612
+ command.query['pageSize'] = page_size unless page_size.nil?
1613
+ command.query['pageToken'] = page_token unless page_token.nil?
1614
+ command.query['fields'] = fields unless fields.nil?
1615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1616
+ execute_or_queue_command(command, &block)
1617
+ end
1618
+
1619
+ # Modifies a `PrivateCloud` resource. Only the following fields can be updated: `
1620
+ # description`. Only fields specified in `updateMask` are applied. During
1621
+ # operation processing, the resource is temporarily in the `ACTIVE` state before
1622
+ # the operation fully completes. For that period of time, you can't update the
1623
+ # resource. Use the operation status to determine when the processing fully
1624
+ # completes.
1625
+ # @param [String] name
1626
+ # Output only. The resource name of this private cloud. Resource names are
1627
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1628
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
1629
+ # a/privateClouds/my-cloud`
1630
+ # @param [Google::Apis::VmwareengineV1::PrivateCloud] private_cloud_object
1631
+ # @param [String] request_id
1632
+ # Optional. The request ID must be a valid UUID with the exception that zero
1633
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1634
+ # @param [String] update_mask
1635
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1636
+ # PrivateCloud` resource by the update. The fields specified in `updateMask` are
1637
+ # relative to the resource, not the full request. A field will be overwritten if
1638
+ # it is in the mask. If the user does not provide a mask then all fields will be
1639
+ # overwritten.
1640
+ # @param [String] fields
1641
+ # Selector specifying which fields to include in a partial response.
1642
+ # @param [String] quota_user
1643
+ # Available to use for quota purposes for server-side applications. Can be any
1644
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1645
+ # @param [Google::Apis::RequestOptions] options
1646
+ # Request-specific options
1647
+ #
1648
+ # @yield [result, err] Result & error if block supplied
1649
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1650
+ # @yieldparam err [StandardError] error object if request failed
1651
+ #
1652
+ # @return [Google::Apis::VmwareengineV1::Operation]
1653
+ #
1654
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1655
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1656
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1657
+ 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)
1658
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1659
+ command.request_representation = Google::Apis::VmwareengineV1::PrivateCloud::Representation
1660
+ command.request_object = private_cloud_object
1661
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1662
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1663
+ command.params['name'] = name unless name.nil?
1664
+ command.query['requestId'] = request_id unless request_id.nil?
1665
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1666
+ command.query['fields'] = fields unless fields.nil?
1667
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1668
+ execute_or_queue_command(command, &block)
1669
+ end
1670
+
1671
+ # Resets credentials of the NSX appliance.
1672
+ # @param [String] private_cloud
1673
+ # Required. The resource name of the private cloud to reset credentials for.
1674
+ # Resource names are schemeless URIs that follow the conventions in https://
1675
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1676
+ # locations/us-central1-a/privateClouds/my-cloud`
1677
+ # @param [Google::Apis::VmwareengineV1::ResetNsxCredentialsRequest] reset_nsx_credentials_request_object
1678
+ # @param [String] fields
1679
+ # Selector specifying which fields to include in a partial response.
1680
+ # @param [String] quota_user
1681
+ # Available to use for quota purposes for server-side applications. Can be any
1682
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1683
+ # @param [Google::Apis::RequestOptions] options
1684
+ # Request-specific options
1685
+ #
1686
+ # @yield [result, err] Result & error if block supplied
1687
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1688
+ # @yieldparam err [StandardError] error object if request failed
1689
+ #
1690
+ # @return [Google::Apis::VmwareengineV1::Operation]
1691
+ #
1692
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1693
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1694
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1695
+ def reset_private_cloud_nsx_credentials(private_cloud, reset_nsx_credentials_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1696
+ command = make_simple_command(:post, 'v1/{+privateCloud}:resetNsxCredentials', options)
1697
+ command.request_representation = Google::Apis::VmwareengineV1::ResetNsxCredentialsRequest::Representation
1698
+ command.request_object = reset_nsx_credentials_request_object
1699
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1700
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1701
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1702
+ command.query['fields'] = fields unless fields.nil?
1703
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1704
+ execute_or_queue_command(command, &block)
1705
+ end
1706
+
1707
+ # Resets credentials of the Vcenter appliance.
1708
+ # @param [String] private_cloud
1709
+ # Required. The resource name of the private cloud to reset credentials for.
1710
+ # Resource names are schemeless URIs that follow the conventions in https://
1711
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1712
+ # locations/us-central1-a/privateClouds/my-cloud`
1713
+ # @param [Google::Apis::VmwareengineV1::ResetVcenterCredentialsRequest] reset_vcenter_credentials_request_object
1714
+ # @param [String] fields
1715
+ # Selector specifying which fields to include in a partial response.
1716
+ # @param [String] quota_user
1717
+ # Available to use for quota purposes for server-side applications. Can be any
1718
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1719
+ # @param [Google::Apis::RequestOptions] options
1720
+ # Request-specific options
1721
+ #
1722
+ # @yield [result, err] Result & error if block supplied
1723
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1724
+ # @yieldparam err [StandardError] error object if request failed
1725
+ #
1726
+ # @return [Google::Apis::VmwareengineV1::Operation]
1727
+ #
1728
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1729
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1730
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1731
+ def reset_private_cloud_vcenter_credentials(private_cloud, reset_vcenter_credentials_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1732
+ command = make_simple_command(:post, 'v1/{+privateCloud}:resetVcenterCredentials', options)
1733
+ command.request_representation = Google::Apis::VmwareengineV1::ResetVcenterCredentialsRequest::Representation
1734
+ command.request_object = reset_vcenter_credentials_request_object
1735
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1736
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1737
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1738
+ command.query['fields'] = fields unless fields.nil?
1739
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1740
+ execute_or_queue_command(command, &block)
1741
+ end
1742
+
1743
+ # Sets the access control policy on the specified resource. Replaces any
1744
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1745
+ # PERMISSION_DENIED` errors.
1746
+ # @param [String] resource
1747
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1748
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1749
+ # appropriate value for this field.
1750
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
1751
+ # @param [String] fields
1752
+ # Selector specifying which fields to include in a partial response.
1753
+ # @param [String] quota_user
1754
+ # Available to use for quota purposes for server-side applications. Can be any
1755
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1756
+ # @param [Google::Apis::RequestOptions] options
1757
+ # Request-specific options
1758
+ #
1759
+ # @yield [result, err] Result & error if block supplied
1760
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1761
+ # @yieldparam err [StandardError] error object if request failed
1762
+ #
1763
+ # @return [Google::Apis::VmwareengineV1::Policy]
1764
+ #
1765
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1766
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1767
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1768
+ def set_private_cloud_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1769
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1770
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
1771
+ command.request_object = set_iam_policy_request_object
1772
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
1773
+ command.response_class = Google::Apis::VmwareengineV1::Policy
1774
+ command.params['resource'] = resource unless resource.nil?
1775
+ command.query['fields'] = fields unless fields.nil?
1776
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1777
+ execute_or_queue_command(command, &block)
1778
+ end
1779
+
1780
+ # Gets details of credentials for NSX appliance.
1781
+ # @param [String] private_cloud
1782
+ # Required. The resource name of the private cloud to be queried for credentials.
1783
+ # Resource names are schemeless URIs that follow the conventions in https://
1784
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1785
+ # locations/us-central1-a/privateClouds/my-cloud`
1786
+ # @param [String] fields
1787
+ # Selector specifying which fields to include in a partial response.
1788
+ # @param [String] quota_user
1789
+ # Available to use for quota purposes for server-side applications. Can be any
1790
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1791
+ # @param [Google::Apis::RequestOptions] options
1792
+ # Request-specific options
1793
+ #
1794
+ # @yield [result, err] Result & error if block supplied
1795
+ # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
1796
+ # @yieldparam err [StandardError] error object if request failed
1797
+ #
1798
+ # @return [Google::Apis::VmwareengineV1::Credentials]
1799
+ #
1800
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1801
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1802
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1803
+ def show_project_location_private_cloud_nsx_credentials(private_cloud, fields: nil, quota_user: nil, options: nil, &block)
1804
+ command = make_simple_command(:get, 'v1/{+privateCloud}:showNsxCredentials', options)
1805
+ command.response_representation = Google::Apis::VmwareengineV1::Credentials::Representation
1806
+ command.response_class = Google::Apis::VmwareengineV1::Credentials
1807
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1808
+ command.query['fields'] = fields unless fields.nil?
1809
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1810
+ execute_or_queue_command(command, &block)
1811
+ end
1812
+
1813
+ # Gets details of credentials for Vcenter appliance.
1814
+ # @param [String] private_cloud
1815
+ # Required. The resource name of the private cloud to be queried for credentials.
1816
+ # Resource names are schemeless URIs that follow the conventions in https://
1817
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1818
+ # locations/us-central1-a/privateClouds/my-cloud`
1819
+ # @param [String] username
1820
+ # Optional. The username of the user to be queried for credentials. The default
1821
+ # value of this field is CloudOwner@gve.local. The provided value must be one of
1822
+ # the following: CloudOwner@gve.local, solution-user-01@gve.local, solution-user-
1823
+ # 02@gve.local, solution-user-03@gve.local, solution-user-04@gve.local, solution-
1824
+ # user-05@gve.local, zertoadmin@gve.local.
1825
+ # @param [String] fields
1826
+ # Selector specifying which fields to include in a partial response.
1827
+ # @param [String] quota_user
1828
+ # Available to use for quota purposes for server-side applications. Can be any
1829
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1830
+ # @param [Google::Apis::RequestOptions] options
1831
+ # Request-specific options
1832
+ #
1833
+ # @yield [result, err] Result & error if block supplied
1834
+ # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
1835
+ # @yieldparam err [StandardError] error object if request failed
1836
+ #
1837
+ # @return [Google::Apis::VmwareengineV1::Credentials]
1838
+ #
1839
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1840
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1841
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1842
+ def show_project_location_private_cloud_vcenter_credentials(private_cloud, username: nil, fields: nil, quota_user: nil, options: nil, &block)
1843
+ command = make_simple_command(:get, 'v1/{+privateCloud}:showVcenterCredentials', options)
1844
+ command.response_representation = Google::Apis::VmwareengineV1::Credentials::Representation
1845
+ command.response_class = Google::Apis::VmwareengineV1::Credentials
1846
+ command.params['privateCloud'] = private_cloud unless private_cloud.nil?
1847
+ command.query['username'] = username unless username.nil?
1848
+ command.query['fields'] = fields unless fields.nil?
1849
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1850
+ execute_or_queue_command(command, &block)
1851
+ end
1852
+
1853
+ # Returns permissions that a caller has on the specified resource. If the
1854
+ # resource does not exist, this will return an empty set of permissions, not a `
1855
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1856
+ # permission-aware UIs and command-line tools, not for authorization checking.
1857
+ # This operation may "fail open" without warning.
1858
+ # @param [String] resource
1859
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1860
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1861
+ # appropriate value for this field.
1862
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1863
+ # @param [String] fields
1864
+ # Selector specifying which fields to include in a partial response.
1865
+ # @param [String] quota_user
1866
+ # Available to use for quota purposes for server-side applications. Can be any
1867
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1868
+ # @param [Google::Apis::RequestOptions] options
1869
+ # Request-specific options
1870
+ #
1871
+ # @yield [result, err] Result & error if block supplied
1872
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
1873
+ # @yieldparam err [StandardError] error object if request failed
1874
+ #
1875
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
1876
+ #
1877
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1878
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1879
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1880
+ def test_private_cloud_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1881
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1882
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
1883
+ command.request_object = test_iam_permissions_request_object
1884
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
1885
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
1886
+ command.params['resource'] = resource unless resource.nil?
1887
+ command.query['fields'] = fields unless fields.nil?
1888
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1889
+ execute_or_queue_command(command, &block)
1890
+ end
1891
+
1892
+ # Restores a private cloud that was previously scheduled for deletion by `
1893
+ # DeletePrivateCloud`. A `PrivateCloud` resource scheduled for deletion has `
1894
+ # PrivateCloud.state` set to `DELETED` and `PrivateCloud.expireTime` set to the
1895
+ # time when deletion can no longer be reversed.
1896
+ # @param [String] name
1897
+ # Required. The resource name of the private cloud scheduled for deletion.
1898
+ # Resource names are schemeless URIs that follow the conventions in https://
1899
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1900
+ # locations/us-central1-a/privateClouds/my-cloud`
1901
+ # @param [Google::Apis::VmwareengineV1::UndeletePrivateCloudRequest] undelete_private_cloud_request_object
1902
+ # @param [String] fields
1903
+ # Selector specifying which fields to include in a partial response.
1904
+ # @param [String] quota_user
1905
+ # Available to use for quota purposes for server-side applications. Can be any
1906
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1907
+ # @param [Google::Apis::RequestOptions] options
1908
+ # Request-specific options
1909
+ #
1910
+ # @yield [result, err] Result & error if block supplied
1911
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1912
+ # @yieldparam err [StandardError] error object if request failed
1913
+ #
1914
+ # @return [Google::Apis::VmwareengineV1::Operation]
1915
+ #
1916
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1917
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1918
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1919
+ def undelete_private_cloud(name, undelete_private_cloud_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1920
+ command = make_simple_command(:post, 'v1/{+name}:undelete', options)
1921
+ command.request_representation = Google::Apis::VmwareengineV1::UndeletePrivateCloudRequest::Representation
1922
+ command.request_object = undelete_private_cloud_request_object
1923
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1924
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1925
+ command.params['name'] = name unless name.nil?
1926
+ command.query['fields'] = fields unless fields.nil?
1927
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1928
+ execute_or_queue_command(command, &block)
1929
+ end
1930
+
1931
+ # Updates the parameters of the `DnsForwarding` config, like associated domains.
1932
+ # Only fields specified in `update_mask` are applied.
1933
+ # @param [String] name
1934
+ # Output only. The resource name of this DNS profile. Resource names are
1935
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
1936
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
1937
+ # a/privateClouds/my-cloud/dnsForwarding`
1938
+ # @param [Google::Apis::VmwareengineV1::DnsForwarding] dns_forwarding_object
1939
+ # @param [String] request_id
1940
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1941
+ # that if you must retry your request, the server will know to ignore the
1942
+ # request if it has already been completed. The server guarantees that a request
1943
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
1944
+ # For example, consider a situation where you make an initial request and the
1945
+ # request times out. If you make the request again with the same request ID, the
1946
+ # server can check if original operation with the same request ID was received,
1947
+ # and if so, will ignore the second request. This prevents clients from
1948
+ # accidentally creating duplicate commitments. The request ID must be a valid
1949
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
1950
+ # 0000-000000000000).
1951
+ # @param [String] update_mask
1952
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1953
+ # DnsForwarding` resource by the update. The fields specified in the `
1954
+ # update_mask` are relative to the resource, not the full request. A field will
1955
+ # be overwritten if it is in the mask. If the user does not provide a mask then
1956
+ # all fields will be overwritten.
1957
+ # @param [String] fields
1958
+ # Selector specifying which fields to include in a partial response.
1959
+ # @param [String] quota_user
1960
+ # Available to use for quota purposes for server-side applications. Can be any
1961
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1962
+ # @param [Google::Apis::RequestOptions] options
1963
+ # Request-specific options
1964
+ #
1965
+ # @yield [result, err] Result & error if block supplied
1966
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1967
+ # @yieldparam err [StandardError] error object if request failed
1968
+ #
1969
+ # @return [Google::Apis::VmwareengineV1::Operation]
1970
+ #
1971
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1972
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1973
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1974
+ def update_project_location_private_cloud_dns_forwarding(name, dns_forwarding_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1975
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1976
+ command.request_representation = Google::Apis::VmwareengineV1::DnsForwarding::Representation
1977
+ command.request_object = dns_forwarding_object
1978
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1979
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1980
+ command.params['name'] = name unless name.nil?
1981
+ command.query['requestId'] = request_id unless request_id.nil?
1982
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1983
+ command.query['fields'] = fields unless fields.nil?
1984
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1985
+ execute_or_queue_command(command, &block)
1986
+ end
1987
+
1988
+ # Creates a new cluster in a given private cloud. Creating a new cluster
1989
+ # provides additional nodes for use in the parent private cloud and requires
1990
+ # sufficient [node quota](https://cloud.google.com/vmware-engine/quotas).
1991
+ # @param [String] parent
1992
+ # Required. The resource name of the private cloud to create a new cluster in.
1993
+ # Resource names are schemeless URIs that follow the conventions in https://
1994
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
1995
+ # locations/us-central1-a/privateClouds/my-cloud`
1996
+ # @param [Google::Apis::VmwareengineV1::Cluster] cluster_object
1997
+ # @param [String] cluster_id
1998
+ # Required. The user-provided identifier of the new `Cluster`. This identifier
1999
+ # must be unique among clusters within the parent and becomes the final token in
2000
+ # the name URI. The identifier must meet the following requirements: * Only
2001
+ # contains 1-63 alphanumeric characters and hyphens * Begins with an
2002
+ # alphabetical character * Ends with a non-hyphen character * Not formatted as a
2003
+ # UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034)
2004
+ # (section 3.5)
2005
+ # @param [String] request_id
2006
+ # Optional. The request ID must be a valid UUID with the exception that zero
2007
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
2008
+ # @param [Boolean] validate_only
2009
+ # Optional. True if you want the request to be validated and not executed; false
2010
+ # otherwise.
2011
+ # @param [String] fields
2012
+ # Selector specifying which fields to include in a partial response.
2013
+ # @param [String] quota_user
2014
+ # Available to use for quota purposes for server-side applications. Can be any
2015
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2016
+ # @param [Google::Apis::RequestOptions] options
2017
+ # Request-specific options
2018
+ #
2019
+ # @yield [result, err] Result & error if block supplied
2020
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2021
+ # @yieldparam err [StandardError] error object if request failed
2022
+ #
2023
+ # @return [Google::Apis::VmwareengineV1::Operation]
2024
+ #
2025
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2026
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2027
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2028
+ 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)
2029
+ command = make_simple_command(:post, 'v1/{+parent}/clusters', options)
2030
+ command.request_representation = Google::Apis::VmwareengineV1::Cluster::Representation
2031
+ command.request_object = cluster_object
2032
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2033
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2034
+ command.params['parent'] = parent unless parent.nil?
2035
+ command.query['clusterId'] = cluster_id unless cluster_id.nil?
2036
+ command.query['requestId'] = request_id unless request_id.nil?
2037
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2038
+ command.query['fields'] = fields unless fields.nil?
2039
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2040
+ execute_or_queue_command(command, &block)
2041
+ end
2042
+
2043
+ # Deletes a `Cluster` resource. To avoid unintended data loss, migrate or
2044
+ # gracefully shut down any workloads running on the cluster before deletion. You
2045
+ # cannot delete the management cluster of a private cloud using this method.
2046
+ # @param [String] name
2047
+ # Required. The resource name of the cluster to delete. Resource names are
2048
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
2049
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
2050
+ # a/privateClouds/my-cloud/clusters/my-cluster`
2051
+ # @param [String] request_id
2052
+ # Optional. The request ID must be a valid UUID with the exception that zero
2053
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
2054
+ # @param [String] fields
2055
+ # Selector specifying which fields to include in a partial response.
2056
+ # @param [String] quota_user
2057
+ # Available to use for quota purposes for server-side applications. Can be any
2058
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2059
+ # @param [Google::Apis::RequestOptions] options
2060
+ # Request-specific options
2061
+ #
2062
+ # @yield [result, err] Result & error if block supplied
2063
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2064
+ # @yieldparam err [StandardError] error object if request failed
2065
+ #
2066
+ # @return [Google::Apis::VmwareengineV1::Operation]
2067
+ #
2068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2071
+ def delete_project_location_private_cloud_cluster(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2072
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2073
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2074
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2075
+ command.params['name'] = name unless name.nil?
2076
+ command.query['requestId'] = request_id unless request_id.nil?
2077
+ command.query['fields'] = fields unless fields.nil?
2078
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2079
+ execute_or_queue_command(command, &block)
2080
+ end
2081
+
2082
+ # Retrieves a `Cluster` resource by its resource name.
2083
+ # @param [String] name
2084
+ # Required. The cluster resource name to retrieve. Resource names are schemeless
2085
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
2086
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
2087
+ # privateClouds/my-cloud/clusters/my-cluster`
2088
+ # @param [String] fields
2089
+ # Selector specifying which fields to include in a partial response.
2090
+ # @param [String] quota_user
2091
+ # Available to use for quota purposes for server-side applications. Can be any
2092
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2093
+ # @param [Google::Apis::RequestOptions] options
2094
+ # Request-specific options
2095
+ #
2096
+ # @yield [result, err] Result & error if block supplied
2097
+ # @yieldparam result [Google::Apis::VmwareengineV1::Cluster] parsed result object
2098
+ # @yieldparam err [StandardError] error object if request failed
2099
+ #
2100
+ # @return [Google::Apis::VmwareengineV1::Cluster]
2101
+ #
2102
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2103
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2104
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2105
+ def get_project_location_private_cloud_cluster(name, fields: nil, quota_user: nil, options: nil, &block)
2106
+ command = make_simple_command(:get, 'v1/{+name}', options)
2107
+ command.response_representation = Google::Apis::VmwareengineV1::Cluster::Representation
2108
+ command.response_class = Google::Apis::VmwareengineV1::Cluster
2109
+ command.params['name'] = name unless name.nil?
2110
+ command.query['fields'] = fields unless fields.nil?
2111
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2112
+ execute_or_queue_command(command, &block)
2113
+ end
2114
+
2115
+ # Gets the access control policy for a resource. Returns an empty policy if the
2116
+ # resource exists and does not have a policy set.
2117
+ # @param [String] resource
2118
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
2119
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2120
+ # appropriate value for this field.
2121
+ # @param [Fixnum] options_requested_policy_version
2122
+ # Optional. The maximum policy version that will be used to format the policy.
2123
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2124
+ # rejected. Requests for policies with any conditional role bindings must
2125
+ # specify version 3. Policies with no conditional role bindings may specify any
2126
+ # valid value or leave the field unset. The policy in the response might use the
2127
+ # policy version that you specified, or it might use a lower policy version. For
2128
+ # example, if you specify version 3, but the policy has no conditional role
2129
+ # bindings, the response uses version 1. To learn which resources support
2130
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2131
+ # google.com/iam/help/conditions/resource-policies).
2132
+ # @param [String] fields
2133
+ # Selector specifying which fields to include in a partial response.
2134
+ # @param [String] quota_user
2135
+ # Available to use for quota purposes for server-side applications. Can be any
2136
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2137
+ # @param [Google::Apis::RequestOptions] options
2138
+ # Request-specific options
2139
+ #
2140
+ # @yield [result, err] Result & error if block supplied
2141
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
2142
+ # @yieldparam err [StandardError] error object if request failed
2143
+ #
2144
+ # @return [Google::Apis::VmwareengineV1::Policy]
2145
+ #
2146
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2147
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2148
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2149
+ def get_project_location_private_cloud_cluster_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2150
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2151
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
2152
+ command.response_class = Google::Apis::VmwareengineV1::Policy
2153
+ command.params['resource'] = resource unless resource.nil?
2154
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2155
+ command.query['fields'] = fields unless fields.nil?
2156
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2157
+ execute_or_queue_command(command, &block)
2158
+ end
2159
+
2160
+ # Lists `Cluster` resources in a given private cloud.
2161
+ # @param [String] parent
2162
+ # Required. The resource name of the private cloud to query for clusters.
2163
+ # Resource names are schemeless URIs that follow the conventions in https://
2164
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
2165
+ # locations/us-central1-a/privateClouds/my-cloud`
2166
+ # @param [String] filter
2167
+ # To filter on multiple expressions, provide each separate expression within
2168
+ # parentheses. For example: ``` (name = "example-cluster") (nodeCount = "3") ```
2169
+ # By default, each expression is an `AND` expression. However, you can include `
2170
+ # AND` and `OR` expressions explicitly. For example: ``` (name = "example-
2171
+ # cluster-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "example-
2172
+ # cluster-2") ```
2173
+ # @param [String] order_by
2174
+ # Sorts list results by a certain order. By default, returned results are
2175
+ # ordered by `name` in ascending order. You can also sort results in descending
2176
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
2177
+ # ordering by `name` is supported.
2178
+ # @param [Fixnum] page_size
2179
+ # The maximum number of clusters to return in one page. The service may return
2180
+ # fewer than this value. The maximum value is coerced to 1000. The default value
2181
+ # of this field is 500.
2182
+ # @param [String] page_token
2183
+ # A page token, received from a previous `ListClusters` call. Provide this to
2184
+ # retrieve the subsequent page. When paginating, all other parameters provided
2185
+ # to `ListClusters` must match the call that provided the page token.
2186
+ # @param [String] fields
2187
+ # Selector specifying which fields to include in a partial response.
2188
+ # @param [String] quota_user
2189
+ # Available to use for quota purposes for server-side applications. Can be any
2190
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2191
+ # @param [Google::Apis::RequestOptions] options
2192
+ # Request-specific options
2193
+ #
2194
+ # @yield [result, err] Result & error if block supplied
2195
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListClustersResponse] parsed result object
2196
+ # @yieldparam err [StandardError] error object if request failed
2197
+ #
2198
+ # @return [Google::Apis::VmwareengineV1::ListClustersResponse]
2199
+ #
2200
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2201
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2202
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2203
+ 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)
2204
+ command = make_simple_command(:get, 'v1/{+parent}/clusters', options)
2205
+ command.response_representation = Google::Apis::VmwareengineV1::ListClustersResponse::Representation
2206
+ command.response_class = Google::Apis::VmwareengineV1::ListClustersResponse
2207
+ command.params['parent'] = parent unless parent.nil?
2208
+ command.query['filter'] = filter unless filter.nil?
2209
+ command.query['orderBy'] = order_by unless order_by.nil?
2210
+ command.query['pageSize'] = page_size unless page_size.nil?
2211
+ command.query['pageToken'] = page_token unless page_token.nil?
2212
+ command.query['fields'] = fields unless fields.nil?
2213
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2214
+ execute_or_queue_command(command, &block)
2215
+ end
2216
+
2217
+ # Modifies a `Cluster` resource. Only fields specified in `updateMask` are
2218
+ # applied. During operation processing, the resource is temporarily in the `
2219
+ # ACTIVE` state before the operation fully completes. For that period of time,
2220
+ # you can't update the resource. Use the operation status to determine when the
2221
+ # processing fully completes.
2222
+ # @param [String] name
2223
+ # Output only. The resource name of this cluster. Resource names are schemeless
2224
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
2225
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
2226
+ # privateClouds/my-cloud/clusters/my-cluster`
2227
+ # @param [Google::Apis::VmwareengineV1::Cluster] cluster_object
677
2228
  # @param [String] request_id
678
2229
  # Optional. The request ID must be a valid UUID with the exception that zero
679
2230
  # UUID is not supported (00000000-0000-0000-0000-000000000000).
2231
+ # @param [String] update_mask
2232
+ # Required. Field mask is used to specify the fields to be overwritten in the `
2233
+ # Cluster` resource by the update. The fields specified in the `updateMask` are
2234
+ # relative to the resource, not the full request. A field will be overwritten if
2235
+ # it is in the mask. If the user does not provide a mask then all fields will be
2236
+ # overwritten.
2237
+ # @param [Boolean] validate_only
2238
+ # Optional. True if you want the request to be validated and not executed; false
2239
+ # otherwise.
680
2240
  # @param [String] fields
681
2241
  # Selector specifying which fields to include in a partial response.
682
2242
  # @param [String] quota_user
@@ -694,25 +2254,29 @@ module Google
694
2254
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
695
2255
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
696
2256
  # @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)
2257
+ 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)
2258
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2259
+ command.request_representation = Google::Apis::VmwareengineV1::Cluster::Representation
2260
+ command.request_object = cluster_object
699
2261
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
700
2262
  command.response_class = Google::Apis::VmwareengineV1::Operation
701
2263
  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
2264
  command.query['requestId'] = request_id unless request_id.nil?
2265
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2266
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
705
2267
  command.query['fields'] = fields unless fields.nil?
706
2268
  command.query['quotaUser'] = quota_user unless quota_user.nil?
707
2269
  execute_or_queue_command(command, &block)
708
2270
  end
709
2271
 
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`
2272
+ # Sets the access control policy on the specified resource. Replaces any
2273
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2274
+ # PERMISSION_DENIED` errors.
2275
+ # @param [String] resource
2276
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
2277
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2278
+ # appropriate value for this field.
2279
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
716
2280
  # @param [String] fields
717
2281
  # Selector specifying which fields to include in a partial response.
718
2282
  # @param [String] quota_user
@@ -722,41 +2286,36 @@ module Google
722
2286
  # Request-specific options
723
2287
  #
724
2288
  # @yield [result, err] Result & error if block supplied
725
- # @yieldparam result [Google::Apis::VmwareengineV1::PrivateCloud] parsed result object
2289
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
726
2290
  # @yieldparam err [StandardError] error object if request failed
727
2291
  #
728
- # @return [Google::Apis::VmwareengineV1::PrivateCloud]
2292
+ # @return [Google::Apis::VmwareengineV1::Policy]
729
2293
  #
730
2294
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
731
2295
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
732
2296
  # @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?
2297
+ def set_cluster_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2298
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2299
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
2300
+ command.request_object = set_iam_policy_request_object
2301
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
2302
+ command.response_class = Google::Apis::VmwareengineV1::Policy
2303
+ command.params['resource'] = resource unless resource.nil?
738
2304
  command.query['fields'] = fields unless fields.nil?
739
2305
  command.query['quotaUser'] = quota_user unless quota_user.nil?
740
2306
  execute_or_queue_command(command, &block)
741
2307
  end
742
2308
 
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.
2309
+ # Returns permissions that a caller has on the specified resource. If the
2310
+ # resource does not exist, this will return an empty set of permissions, not a `
2311
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2312
+ # permission-aware UIs and command-line tools, not for authorization checking.
2313
+ # This operation may "fail open" without warning.
745
2314
  # @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
2315
+ # REQUIRED: The resource for which the policy detail is being requested. See [
2316
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
748
2317
  # 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).
2318
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
760
2319
  # @param [String] fields
761
2320
  # Selector specifying which fields to include in a partial response.
762
2321
  # @param [String] quota_user
@@ -766,60 +2325,31 @@ module Google
766
2325
  # Request-specific options
767
2326
  #
768
2327
  # @yield [result, err] Result & error if block supplied
769
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
2328
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
770
2329
  # @yieldparam err [StandardError] error object if request failed
771
2330
  #
772
- # @return [Google::Apis::VmwareengineV1::Policy]
2331
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
773
2332
  #
774
2333
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
2334
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
2335
  # @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
2336
+ def test_cluster_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2337
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2338
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
2339
+ command.request_object = test_iam_permissions_request_object
2340
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
2341
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
781
2342
  command.params['resource'] = resource unless resource.nil?
782
- command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
783
2343
  command.query['fields'] = fields unless fields.nil?
784
2344
  command.query['quotaUser'] = quota_user unless quota_user.nil?
785
2345
  execute_or_queue_command(command, &block)
786
2346
  end
787
2347
 
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.
2348
+ # Gets details of a single node.
2349
+ # @param [String] name
2350
+ # Required. The resource name of the node to retrieve. For example: `projects/`
2351
+ # project`/locations/`location`/privateClouds/`private_cloud`/clusters/`cluster`/
2352
+ # nodes/`node``
823
2353
  # @param [String] fields
824
2354
  # Selector specifying which fields to include in a partial response.
825
2355
  # @param [String] quota_user
@@ -829,49 +2359,38 @@ module Google
829
2359
  # Request-specific options
830
2360
  #
831
2361
  # @yield [result, err] Result & error if block supplied
832
- # @yieldparam result [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse] parsed result object
2362
+ # @yieldparam result [Google::Apis::VmwareengineV1::Node] parsed result object
833
2363
  # @yieldparam err [StandardError] error object if request failed
834
2364
  #
835
- # @return [Google::Apis::VmwareengineV1::ListPrivateCloudsResponse]
2365
+ # @return [Google::Apis::VmwareengineV1::Node]
836
2366
  #
837
2367
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
838
2368
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
839
2369
  # @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?
2370
+ def get_project_location_private_cloud_cluster_node(name, fields: nil, quota_user: nil, options: nil, &block)
2371
+ command = make_simple_command(:get, 'v1/{+name}', options)
2372
+ command.response_representation = Google::Apis::VmwareengineV1::Node::Representation
2373
+ command.response_class = Google::Apis::VmwareengineV1::Node
2374
+ command.params['name'] = name unless name.nil?
849
2375
  command.query['fields'] = fields unless fields.nil?
850
2376
  command.query['quotaUser'] = quota_user unless quota_user.nil?
851
2377
  execute_or_queue_command(command, &block)
852
2378
  end
853
2379
 
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.
2380
+ # Lists nodes in a given cluster.
2381
+ # @param [String] parent
2382
+ # Required. The resource name of the cluster to be queried for nodes. Resource
2383
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2384
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
2385
+ # central1-a/privateClouds/my-cloud/clusters/my-cluster`
2386
+ # @param [Fixnum] page_size
2387
+ # The maximum number of nodes to return in one page. The service may return
2388
+ # fewer than this value. The maximum value is coerced to 1000. The default value
2389
+ # of this field is 500.
2390
+ # @param [String] page_token
2391
+ # A page token, received from a previous `ListNodes` call. Provide this to
2392
+ # retrieve the subsequent page. When paginating, all other parameters provided
2393
+ # to `ListNodes` must match the call that provided the page token.
875
2394
  # @param [String] fields
876
2395
  # Selector specifying which fields to include in a partial response.
877
2396
  # @param [String] quota_user
@@ -881,35 +2400,55 @@ module Google
881
2400
  # Request-specific options
882
2401
  #
883
2402
  # @yield [result, err] Result & error if block supplied
884
- # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2403
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListNodesResponse] parsed result object
885
2404
  # @yieldparam err [StandardError] error object if request failed
886
2405
  #
887
- # @return [Google::Apis::VmwareengineV1::Operation]
2406
+ # @return [Google::Apis::VmwareengineV1::ListNodesResponse]
888
2407
  #
889
2408
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
890
2409
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
891
2410
  # @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?
2411
+ def list_project_location_private_cloud_cluster_nodes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2412
+ command = make_simple_command(:get, 'v1/{+parent}/nodes', options)
2413
+ command.response_representation = Google::Apis::VmwareengineV1::ListNodesResponse::Representation
2414
+ command.response_class = Google::Apis::VmwareengineV1::ListNodesResponse
2415
+ command.params['parent'] = parent unless parent.nil?
2416
+ command.query['pageSize'] = page_size unless page_size.nil?
2417
+ command.query['pageToken'] = page_token unless page_token.nil?
901
2418
  command.query['fields'] = fields unless fields.nil?
902
2419
  command.query['quotaUser'] = quota_user unless quota_user.nil?
903
2420
  execute_or_queue_command(command, &block)
904
2421
  end
905
2422
 
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
2423
+ # Creates a new `ExternalAddress` resource in a given private cloud. The network
2424
+ # policy that corresponds to the private cloud must have the external IP address
2425
+ # network service enabled (`NetworkPolicy.external_ip`).
2426
+ # @param [String] parent
2427
+ # Required. The resource name of the private cloud to create a new external IP
2428
+ # address in. Resource names are schemeless URIs that follow the conventions in
2429
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
2430
+ # project/locations/us-central1-a/privateClouds/my-cloud`
2431
+ # @param [Google::Apis::VmwareengineV1::ExternalAddress] external_address_object
2432
+ # @param [String] external_address_id
2433
+ # Required. The user-provided identifier of the `ExternalAddress` to be created.
2434
+ # This identifier must be unique among `ExternalAddress` resources within the
2435
+ # parent and becomes the final token in the name URI. The identifier must meet
2436
+ # the following requirements: * Only contains 1-63 alphanumeric characters and
2437
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
2438
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
2439
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
2440
+ # @param [String] request_id
2441
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2442
+ # that if you must retry your request, the server will know to ignore the
2443
+ # request if it has already been completed. The server guarantees that a request
2444
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2445
+ # For example, consider a situation where you make an initial request and the
2446
+ # request times out. If you make the request again with the same request ID, the
2447
+ # server can check if the original operation with the same request ID was
2448
+ # received, and if so, will ignore the second request. This prevents clients
2449
+ # from accidentally creating duplicate commitments. The request ID must be a
2450
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
2451
+ # 0000-0000-000000000000).
913
2452
  # @param [String] fields
914
2453
  # Selector specifying which fields to include in a partial response.
915
2454
  # @param [String] quota_user
@@ -927,25 +2466,40 @@ module Google
927
2466
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
928
2467
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
929
2468
  # @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
2469
+ def create_project_location_private_cloud_external_address(parent, external_address_object = nil, external_address_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2470
+ command = make_simple_command(:post, 'v1/{+parent}/externalAddresses', options)
2471
+ command.request_representation = Google::Apis::VmwareengineV1::ExternalAddress::Representation
2472
+ command.request_object = external_address_object
934
2473
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
935
2474
  command.response_class = Google::Apis::VmwareengineV1::Operation
936
- command.params['privateCloud'] = private_cloud unless private_cloud.nil?
2475
+ command.params['parent'] = parent unless parent.nil?
2476
+ command.query['externalAddressId'] = external_address_id unless external_address_id.nil?
2477
+ command.query['requestId'] = request_id unless request_id.nil?
937
2478
  command.query['fields'] = fields unless fields.nil?
938
2479
  command.query['quotaUser'] = quota_user unless quota_user.nil?
939
2480
  execute_or_queue_command(command, &block)
940
2481
  end
941
2482
 
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
2483
+ # Deletes a single external IP address. When you delete an external IP address,
2484
+ # connectivity between the external IP address and the corresponding internal IP
2485
+ # address is lost.
2486
+ # @param [String] name
2487
+ # Required. The resource name of the external IP address to delete. Resource
2488
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2489
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
2490
+ # central1-a/privateClouds/my-cloud/externalAddresses/my-ip`
2491
+ # @param [String] request_id
2492
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2493
+ # that if you must retry your request, the server will know to ignore the
2494
+ # request if it has already been completed. The server guarantees that a request
2495
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2496
+ # For example, consider a situation where you make an initial request and the
2497
+ # request times out. If you make the request again with the same request ID, the
2498
+ # server can check if the original operation with the same request ID was
2499
+ # received, and if so, will ignore the second request. This prevents clients
2500
+ # from accidentally creating duplicate commitments. The request ID must be a
2501
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
2502
+ # 0000-0000-000000000000).
949
2503
  # @param [String] fields
950
2504
  # Selector specifying which fields to include in a partial response.
951
2505
  # @param [String] quota_user
@@ -963,26 +2517,23 @@ module Google
963
2517
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
964
2518
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
965
2519
  # @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
2520
+ def delete_project_location_private_cloud_external_address(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2521
+ command = make_simple_command(:delete, 'v1/{+name}', options)
970
2522
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
971
2523
  command.response_class = Google::Apis::VmwareengineV1::Operation
972
- command.params['privateCloud'] = private_cloud unless private_cloud.nil?
2524
+ command.params['name'] = name unless name.nil?
2525
+ command.query['requestId'] = request_id unless request_id.nil?
973
2526
  command.query['fields'] = fields unless fields.nil?
974
2527
  command.query['quotaUser'] = quota_user unless quota_user.nil?
975
2528
  execute_or_queue_command(command, &block)
976
2529
  end
977
2530
 
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
2531
+ # Gets details of a single external IP address.
2532
+ # @param [String] name
2533
+ # Required. The resource name of the external IP address to retrieve. Resource
2534
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2535
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
2536
+ # central1-a/privateClouds/my-cloud/externalAddresses/my-ip`
986
2537
  # @param [String] fields
987
2538
  # Selector specifying which fields to include in a partial response.
988
2539
  # @param [String] quota_user
@@ -992,32 +2543,57 @@ module Google
992
2543
  # Request-specific options
993
2544
  #
994
2545
  # @yield [result, err] Result & error if block supplied
995
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
2546
+ # @yieldparam result [Google::Apis::VmwareengineV1::ExternalAddress] parsed result object
996
2547
  # @yieldparam err [StandardError] error object if request failed
997
2548
  #
998
- # @return [Google::Apis::VmwareengineV1::Policy]
2549
+ # @return [Google::Apis::VmwareengineV1::ExternalAddress]
999
2550
  #
1000
2551
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1001
2552
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1002
2553
  # @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?
2554
+ def get_project_location_private_cloud_external_address(name, fields: nil, quota_user: nil, options: nil, &block)
2555
+ command = make_simple_command(:get, 'v1/{+name}', options)
2556
+ command.response_representation = Google::Apis::VmwareengineV1::ExternalAddress::Representation
2557
+ command.response_class = Google::Apis::VmwareengineV1::ExternalAddress
2558
+ command.params['name'] = name unless name.nil?
1010
2559
  command.query['fields'] = fields unless fields.nil?
1011
2560
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1012
2561
  execute_or_queue_command(command, &block)
1013
2562
  end
1014
2563
 
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`
2564
+ # Lists external IP addresses assigned to VMware workload VMs in a given private
2565
+ # cloud.
2566
+ # @param [String] parent
2567
+ # Required. The resource name of the private cloud to be queried for external IP
2568
+ # addresses. Resource names are schemeless URIs that follow the conventions in
2569
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
2570
+ # project/locations/us-central1-a/privateClouds/my-cloud`
2571
+ # @param [String] filter
2572
+ # A filter expression that matches resources returned in the response. The
2573
+ # expression must specify the field name, a comparison operator, and the value
2574
+ # that you want to use for filtering. The value must be a string, a number, or a
2575
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
2576
+ # if you are filtering a list of IP addresses, you can exclude the ones named `
2577
+ # example-ip` by specifying `name != "example-ip"`. To filter on multiple
2578
+ # expressions, provide each separate expression within parentheses. For example:
2579
+ # ``` (name = "example-ip") (createTime > "2021-04-12T08:15:10.40Z") ``` By
2580
+ # default, each expression is an `AND` expression. However, you can include `AND`
2581
+ # and `OR` expressions explicitly. For example: ``` (name = "example-ip-1") AND
2582
+ # (createTime > "2021-04-12T08:15:10.40Z") OR (name = "example-ip-2") ```
2583
+ # @param [String] order_by
2584
+ # Sorts list results by a certain order. By default, returned results are
2585
+ # ordered by `name` in ascending order. You can also sort results in descending
2586
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
2587
+ # ordering by `name` is supported.
2588
+ # @param [Fixnum] page_size
2589
+ # The maximum number of external IP addresses to return in one page. The service
2590
+ # may return fewer than this value. The maximum value is coerced to 1000. The
2591
+ # default value of this field is 500.
2592
+ # @param [String] page_token
2593
+ # A page token, received from a previous `ListExternalAddresses` call. Provide
2594
+ # this to retrieve the subsequent page. When paginating, all other parameters
2595
+ # provided to `ListExternalAddresses` must match the call that provided the page
2596
+ # token.
1021
2597
  # @param [String] fields
1022
2598
  # Selector specifying which fields to include in a partial response.
1023
2599
  # @param [String] quota_user
@@ -1027,30 +2603,57 @@ module Google
1027
2603
  # Request-specific options
1028
2604
  #
1029
2605
  # @yield [result, err] Result & error if block supplied
1030
- # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
2606
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListExternalAddressesResponse] parsed result object
1031
2607
  # @yieldparam err [StandardError] error object if request failed
1032
2608
  #
1033
- # @return [Google::Apis::VmwareengineV1::Credentials]
2609
+ # @return [Google::Apis::VmwareengineV1::ListExternalAddressesResponse]
1034
2610
  #
1035
2611
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1036
2612
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1037
2613
  # @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?
2614
+ def list_project_location_private_cloud_external_addresses(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2615
+ command = make_simple_command(:get, 'v1/{+parent}/externalAddresses', options)
2616
+ command.response_representation = Google::Apis::VmwareengineV1::ListExternalAddressesResponse::Representation
2617
+ command.response_class = Google::Apis::VmwareengineV1::ListExternalAddressesResponse
2618
+ command.params['parent'] = parent unless parent.nil?
2619
+ command.query['filter'] = filter unless filter.nil?
2620
+ command.query['orderBy'] = order_by unless order_by.nil?
2621
+ command.query['pageSize'] = page_size unless page_size.nil?
2622
+ command.query['pageToken'] = page_token unless page_token.nil?
1043
2623
  command.query['fields'] = fields unless fields.nil?
1044
2624
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1045
2625
  execute_or_queue_command(command, &block)
1046
2626
  end
1047
2627
 
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`
2628
+ # Updates the parameters of a single external IP address. Only fields specified
2629
+ # in `update_mask` are applied. During operation processing, the resource is
2630
+ # temporarily in the `ACTIVE` state before the operation fully completes. For
2631
+ # that period of time, you can't update the resource. Use the operation status
2632
+ # to determine when the processing fully completes.
2633
+ # @param [String] name
2634
+ # Output only. The resource name of this external IP address. Resource names are
2635
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
2636
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
2637
+ # a/privateClouds/my-cloud/externalAddresses/my-address`
2638
+ # @param [Google::Apis::VmwareengineV1::ExternalAddress] external_address_object
2639
+ # @param [String] request_id
2640
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2641
+ # that if you must retry your request, the server will know to ignore the
2642
+ # request if it has already been completed. The server guarantees that a request
2643
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2644
+ # For example, consider a situation where you make an initial request and the
2645
+ # request times out. If you make the request again with the same request ID, the
2646
+ # server can check if the original operation with the same request ID was
2647
+ # received, and if so, will ignore the second request. This prevents clients
2648
+ # from accidentally creating duplicate commitments. The request ID must be a
2649
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
2650
+ # 0000-0000-000000000000).
2651
+ # @param [String] update_mask
2652
+ # Required. Field mask is used to specify the fields to be overwritten in the `
2653
+ # ExternalAddress` resource by the update. The fields specified in the `
2654
+ # update_mask` are relative to the resource, not the full request. A field will
2655
+ # be overwritten if it is in the mask. If the user does not provide a mask then
2656
+ # all fields will be overwritten.
1054
2657
  # @param [String] fields
1055
2658
  # Selector specifying which fields to include in a partial response.
1056
2659
  # @param [String] quota_user
@@ -1060,34 +2663,55 @@ module Google
1060
2663
  # Request-specific options
1061
2664
  #
1062
2665
  # @yield [result, err] Result & error if block supplied
1063
- # @yieldparam result [Google::Apis::VmwareengineV1::Credentials] parsed result object
2666
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1064
2667
  # @yieldparam err [StandardError] error object if request failed
1065
2668
  #
1066
- # @return [Google::Apis::VmwareengineV1::Credentials]
2669
+ # @return [Google::Apis::VmwareengineV1::Operation]
1067
2670
  #
1068
2671
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1069
2672
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1070
2673
  # @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?
2674
+ def patch_project_location_private_cloud_external_address(name, external_address_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2675
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2676
+ command.request_representation = Google::Apis::VmwareengineV1::ExternalAddress::Representation
2677
+ command.request_object = external_address_object
2678
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2679
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2680
+ command.params['name'] = name unless name.nil?
2681
+ command.query['requestId'] = request_id unless request_id.nil?
2682
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1076
2683
  command.query['fields'] = fields unless fields.nil?
1077
2684
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1078
2685
  execute_or_queue_command(command, &block)
1079
2686
  end
1080
2687
 
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
2688
+ # Creates a new HCX activation key in a given private cloud.
2689
+ # @param [String] parent
2690
+ # Required. The resource name of the private cloud to create the key for.
2691
+ # Resource names are schemeless URIs that follow the conventions in https://
2692
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
2693
+ # locations/us-central1/privateClouds/my-cloud`
2694
+ # @param [Google::Apis::VmwareengineV1::HcxActivationKey] hcx_activation_key_object
2695
+ # @param [String] hcx_activation_key_id
2696
+ # Required. The user-provided identifier of the `HcxActivationKey` to be created.
2697
+ # This identifier must be unique among `HcxActivationKey` resources within the
2698
+ # parent and becomes the final token in the name URI. The identifier must meet
2699
+ # the following requirements: * Only contains 1-63 alphanumeric characters and
2700
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
2701
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
2702
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
2703
+ # @param [String] request_id
2704
+ # A request ID to identify requests. Specify a unique request ID so that if you
2705
+ # must retry your request, the server will know to ignore the request if it has
2706
+ # already been completed. The server guarantees that a request doesn't result in
2707
+ # creation of duplicate commitments for at least 60 minutes. For example,
2708
+ # consider a situation where you make an initial request and the request times
2709
+ # out. If you make the request again with the same request ID, the server can
2710
+ # check if original operation with the same request ID was received, and if so,
2711
+ # will ignore the second request. This prevents clients from accidentally
2712
+ # creating duplicate commitments. The request ID must be a valid UUID with the
2713
+ # exception that zero UUID is not supported (00000000-0000-0000-0000-
2714
+ # 000000000000).
1091
2715
  # @param [String] fields
1092
2716
  # Selector specifying which fields to include in a partial response.
1093
2717
  # @param [String] quota_user
@@ -1097,36 +2721,34 @@ module Google
1097
2721
  # Request-specific options
1098
2722
  #
1099
2723
  # @yield [result, err] Result & error if block supplied
1100
- # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
2724
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1101
2725
  # @yieldparam err [StandardError] error object if request failed
1102
2726
  #
1103
- # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
2727
+ # @return [Google::Apis::VmwareengineV1::Operation]
1104
2728
  #
1105
2729
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1106
2730
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1107
2731
  # @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?
2732
+ 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)
2733
+ command = make_simple_command(:post, 'v1/{+parent}/hcxActivationKeys', options)
2734
+ command.request_representation = Google::Apis::VmwareengineV1::HcxActivationKey::Representation
2735
+ command.request_object = hcx_activation_key_object
2736
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2737
+ command.response_class = Google::Apis::VmwareengineV1::Operation
2738
+ command.params['parent'] = parent unless parent.nil?
2739
+ command.query['hcxActivationKeyId'] = hcx_activation_key_id unless hcx_activation_key_id.nil?
2740
+ command.query['requestId'] = request_id unless request_id.nil?
1115
2741
  command.query['fields'] = fields unless fields.nil?
1116
2742
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1117
2743
  execute_or_queue_command(command, &block)
1118
2744
  end
1119
2745
 
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.
2746
+ # Retrieves a `HcxActivationKey` resource by its resource name.
1124
2747
  # @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
2748
+ # Required. The resource name of the HCX activation key to retrieve. Resource
2749
+ # names are schemeless URIs that follow the conventions in https://cloud.google.
2750
+ # com/apis/design/resource_names. For example: `projects/my-project/locations/us-
2751
+ # central1/privateClouds/my-cloud/hcxActivationKeys/my-key`
1130
2752
  # @param [String] fields
1131
2753
  # Selector specifying which fields to include in a partial response.
1132
2754
  # @param [String] quota_user
@@ -1136,49 +2758,41 @@ module Google
1136
2758
  # Request-specific options
1137
2759
  #
1138
2760
  # @yield [result, err] Result & error if block supplied
1139
- # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2761
+ # @yieldparam result [Google::Apis::VmwareengineV1::HcxActivationKey] parsed result object
1140
2762
  # @yieldparam err [StandardError] error object if request failed
1141
2763
  #
1142
- # @return [Google::Apis::VmwareengineV1::Operation]
2764
+ # @return [Google::Apis::VmwareengineV1::HcxActivationKey]
1143
2765
  #
1144
2766
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1145
2767
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1146
2768
  # @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
2769
+ def get_project_location_private_cloud_hcx_activation_key(name, fields: nil, quota_user: nil, options: nil, &block)
2770
+ command = make_simple_command(:get, 'v1/{+name}', options)
2771
+ command.response_representation = Google::Apis::VmwareengineV1::HcxActivationKey::Representation
2772
+ command.response_class = Google::Apis::VmwareengineV1::HcxActivationKey
1153
2773
  command.params['name'] = name unless name.nil?
1154
2774
  command.query['fields'] = fields unless fields.nil?
1155
2775
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1156
2776
  execute_or_queue_command(command, &block)
1157
2777
  end
1158
2778
 
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.
2779
+ # Gets the access control policy for a resource. Returns an empty policy if the
2780
+ # resource exists and does not have a policy set.
2781
+ # @param [String] resource
2782
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
2783
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2784
+ # appropriate value for this field.
2785
+ # @param [Fixnum] options_requested_policy_version
2786
+ # Optional. The maximum policy version that will be used to format the policy.
2787
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2788
+ # rejected. Requests for policies with any conditional role bindings must
2789
+ # specify version 3. Policies with no conditional role bindings may specify any
2790
+ # valid value or leave the field unset. The policy in the response might use the
2791
+ # policy version that you specified, or it might use a lower policy version. For
2792
+ # example, if you specify version 3, but the policy has no conditional role
2793
+ # bindings, the response uses version 1. To learn which resources support
2794
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2795
+ # google.com/iam/help/conditions/resource-policies).
1182
2796
  # @param [String] fields
1183
2797
  # Selector specifying which fields to include in a partial response.
1184
2798
  # @param [String] quota_user
@@ -1188,40 +2802,40 @@ module Google
1188
2802
  # Request-specific options
1189
2803
  #
1190
2804
  # @yield [result, err] Result & error if block supplied
1191
- # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2805
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1192
2806
  # @yieldparam err [StandardError] error object if request failed
1193
2807
  #
1194
- # @return [Google::Apis::VmwareengineV1::Operation]
2808
+ # @return [Google::Apis::VmwareengineV1::Policy]
1195
2809
  #
1196
2810
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1197
2811
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1198
2812
  # @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?
2813
+ 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)
2814
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2815
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
2816
+ command.response_class = Google::Apis::VmwareengineV1::Policy
2817
+ command.params['resource'] = resource unless resource.nil?
2818
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1209
2819
  command.query['fields'] = fields unless fields.nil?
1210
2820
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1211
2821
  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).
2822
+ end
2823
+
2824
+ # Lists `HcxActivationKey` resources in a given private cloud.
2825
+ # @param [String] parent
2826
+ # Required. The resource name of the private cloud to be queried for HCX
2827
+ # activation keys. Resource names are schemeless URIs that follow the
2828
+ # conventions in https://cloud.google.com/apis/design/resource_names. For
2829
+ # example: `projects/my-project/locations/us-central1/privateClouds/my-cloud`
2830
+ # @param [Fixnum] page_size
2831
+ # The maximum number of HCX activation keys to return in one page. The service
2832
+ # may return fewer than this value. The maximum value is coerced to 1000. The
2833
+ # default value of this field is 500.
2834
+ # @param [String] page_token
2835
+ # A page token, received from a previous `ListHcxActivationKeys` call. Provide
2836
+ # this to retrieve the subsequent page. When paginating, all other parameters
2837
+ # provided to `ListHcxActivationKeys` must match the call that provided the page
2838
+ # token.
1225
2839
  # @param [String] fields
1226
2840
  # Selector specifying which fields to include in a partial response.
1227
2841
  # @param [String] quota_user
@@ -1231,31 +2845,34 @@ module Google
1231
2845
  # Request-specific options
1232
2846
  #
1233
2847
  # @yield [result, err] Result & error if block supplied
1234
- # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
2848
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse] parsed result object
1235
2849
  # @yieldparam err [StandardError] error object if request failed
1236
2850
  #
1237
- # @return [Google::Apis::VmwareengineV1::Operation]
2851
+ # @return [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse]
1238
2852
  #
1239
2853
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1240
2854
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1241
2855
  # @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?
2856
+ def list_project_location_private_cloud_hcx_activation_keys(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2857
+ command = make_simple_command(:get, 'v1/{+parent}/hcxActivationKeys', options)
2858
+ command.response_representation = Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse::Representation
2859
+ command.response_class = Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse
2860
+ command.params['parent'] = parent unless parent.nil?
2861
+ command.query['pageSize'] = page_size unless page_size.nil?
2862
+ command.query['pageToken'] = page_token unless page_token.nil?
1248
2863
  command.query['fields'] = fields unless fields.nil?
1249
2864
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1250
2865
  execute_or_queue_command(command, &block)
1251
2866
  end
1252
2867
 
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`
2868
+ # Sets the access control policy on the specified resource. Replaces any
2869
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2870
+ # PERMISSION_DENIED` errors.
2871
+ # @param [String] resource
2872
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
2873
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2874
+ # appropriate value for this field.
2875
+ # @param [Google::Apis::VmwareengineV1::SetIamPolicyRequest] set_iam_policy_request_object
1259
2876
  # @param [String] fields
1260
2877
  # Selector specifying which fields to include in a partial response.
1261
2878
  # @param [String] quota_user
@@ -1265,41 +2882,36 @@ module Google
1265
2882
  # Request-specific options
1266
2883
  #
1267
2884
  # @yield [result, err] Result & error if block supplied
1268
- # @yieldparam result [Google::Apis::VmwareengineV1::Cluster] parsed result object
2885
+ # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
1269
2886
  # @yieldparam err [StandardError] error object if request failed
1270
2887
  #
1271
- # @return [Google::Apis::VmwareengineV1::Cluster]
2888
+ # @return [Google::Apis::VmwareengineV1::Policy]
1272
2889
  #
1273
2890
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1274
2891
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1275
2892
  # @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?
2893
+ def set_hcx_activation_key_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2894
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2895
+ command.request_representation = Google::Apis::VmwareengineV1::SetIamPolicyRequest::Representation
2896
+ command.request_object = set_iam_policy_request_object
2897
+ command.response_representation = Google::Apis::VmwareengineV1::Policy::Representation
2898
+ command.response_class = Google::Apis::VmwareengineV1::Policy
2899
+ command.params['resource'] = resource unless resource.nil?
1281
2900
  command.query['fields'] = fields unless fields.nil?
1282
2901
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1283
2902
  execute_or_queue_command(command, &block)
1284
2903
  end
1285
2904
 
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.
2905
+ # Returns permissions that a caller has on the specified resource. If the
2906
+ # resource does not exist, this will return an empty set of permissions, not a `
2907
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2908
+ # permission-aware UIs and command-line tools, not for authorization checking.
2909
+ # This operation may "fail open" without warning.
1288
2910
  # @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
2911
+ # REQUIRED: The resource for which the policy detail is being requested. See [
2912
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1291
2913
  # 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).
2914
+ # @param [Google::Apis::VmwareengineV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1303
2915
  # @param [String] fields
1304
2916
  # Selector specifying which fields to include in a partial response.
1305
2917
  # @param [String] quota_user
@@ -1309,51 +2921,53 @@ module Google
1309
2921
  # Request-specific options
1310
2922
  #
1311
2923
  # @yield [result, err] Result & error if block supplied
1312
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
2924
+ # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
1313
2925
  # @yieldparam err [StandardError] error object if request failed
1314
2926
  #
1315
- # @return [Google::Apis::VmwareengineV1::Policy]
2927
+ # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
1316
2928
  #
1317
2929
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1318
2930
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1319
2931
  # @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
2932
+ def test_hcx_activation_key_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2933
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2934
+ command.request_representation = Google::Apis::VmwareengineV1::TestIamPermissionsRequest::Representation
2935
+ command.request_object = test_iam_permissions_request_object
2936
+ command.response_representation = Google::Apis::VmwareengineV1::TestIamPermissionsResponse::Representation
2937
+ command.response_class = Google::Apis::VmwareengineV1::TestIamPermissionsResponse
1324
2938
  command.params['resource'] = resource unless resource.nil?
1325
- command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1326
2939
  command.query['fields'] = fields unless fields.nil?
1327
2940
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1328
2941
  execute_or_queue_command(command, &block)
1329
2942
  end
1330
2943
 
1331
- # Lists `Cluster` resources in a given private cloud.
2944
+ # Create a new logging server for a given private cloud.
1332
2945
  # @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.
2946
+ # Required. The resource name of the private cloud to create a new Logging
2947
+ # Server in. Resource names are schemeless URIs that follow the conventions in
2948
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
2949
+ # project/locations/us-central1-a/privateClouds/my-cloud`
2950
+ # @param [Google::Apis::VmwareengineV1::LoggingServer] logging_server_object
2951
+ # @param [String] logging_server_id
2952
+ # Required. The user-provided identifier of the `LoggingServer` to be created.
2953
+ # This identifier must be unique among `LoggingServer` resources within the
2954
+ # parent and becomes the final token in the name URI. The identifier must meet
2955
+ # the following requirements: * Only contains 1-63 alphanumeric characters and
2956
+ # hyphens * Begins with an alphabetical character * Ends with a non-hyphen
2957
+ # character * Not formatted as a UUID * Complies with [RFC 1034](https://
2958
+ # datatracker.ietf.org/doc/html/rfc1034) (section 3.5)
2959
+ # @param [String] request_id
2960
+ # Optional. A request ID to identify requests. Specify a unique request ID so
2961
+ # that if you must retry your request, the server will know to ignore the
2962
+ # request if it has already been completed. The server guarantees that a request
2963
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
2964
+ # For example, consider a situation where you make an initial request and the
2965
+ # request times out. If you make the request again with the same request ID, the
2966
+ # server can check if original operation with the same request ID was received,
2967
+ # and if so, will ignore the second request. This prevents clients from
2968
+ # accidentally creating duplicate commitments. The request ID must be a valid
2969
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
2970
+ # 0000-000000000000).
1357
2971
  # @param [String] fields
1358
2972
  # Selector specifying which fields to include in a partial response.
1359
2973
  # @param [String] quota_user
@@ -1363,51 +2977,46 @@ module Google
1363
2977
  # Request-specific options
1364
2978
  #
1365
2979
  # @yield [result, err] Result & error if block supplied
1366
- # @yieldparam result [Google::Apis::VmwareengineV1::ListClustersResponse] parsed result object
2980
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1367
2981
  # @yieldparam err [StandardError] error object if request failed
1368
2982
  #
1369
- # @return [Google::Apis::VmwareengineV1::ListClustersResponse]
2983
+ # @return [Google::Apis::VmwareengineV1::Operation]
1370
2984
  #
1371
2985
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1372
2986
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1373
2987
  # @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
2988
+ def create_project_location_private_cloud_logging_server(parent, logging_server_object = nil, logging_server_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2989
+ command = make_simple_command(:post, 'v1/{+parent}/loggingServers', options)
2990
+ command.request_representation = Google::Apis::VmwareengineV1::LoggingServer::Representation
2991
+ command.request_object = logging_server_object
2992
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
2993
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1378
2994
  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?
2995
+ command.query['loggingServerId'] = logging_server_id unless logging_server_id.nil?
2996
+ command.query['requestId'] = request_id unless request_id.nil?
1383
2997
  command.query['fields'] = fields unless fields.nil?
1384
2998
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1385
2999
  execute_or_queue_command(command, &block)
1386
3000
  end
1387
3001
 
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.
3002
+ # Deletes a single logging server.
1393
3003
  # @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
3004
+ # Required. The resource name of the logging server to delete. Resource names
3005
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
3006
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
3007
+ # central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`
1399
3008
  # @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.
3009
+ # Optional. A request ID to identify requests. Specify a unique request ID so
3010
+ # that if you must retry your request, the server will know to ignore the
3011
+ # request if it has already been completed. The server guarantees that a request
3012
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
3013
+ # For example, consider a situation where you make an initial request and the
3014
+ # request times out. If you make the request again with the same request ID, the
3015
+ # server can check if original operation with the same request ID was received,
3016
+ # and if so, will ignore the second request. This prevents clients from
3017
+ # accidentally creating duplicate commitments. The request ID must be a valid
3018
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
3019
+ # 0000-000000000000).
1411
3020
  # @param [String] fields
1412
3021
  # Selector specifying which fields to include in a partial response.
1413
3022
  # @param [String] quota_user
@@ -1425,29 +3034,23 @@ module Google
1425
3034
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1426
3035
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1427
3036
  # @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
3037
+ def delete_project_location_private_cloud_logging_server(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3038
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1432
3039
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1433
3040
  command.response_class = Google::Apis::VmwareengineV1::Operation
1434
3041
  command.params['name'] = name unless name.nil?
1435
3042
  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
3043
  command.query['fields'] = fields unless fields.nil?
1439
3044
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1440
3045
  execute_or_queue_command(command, &block)
1441
3046
  end
1442
3047
 
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
3048
+ # Gets details of a logging server.
3049
+ # @param [String] name
3050
+ # Required. The resource name of the Logging Server to retrieve. Resource names
3051
+ # are schemeless URIs that follow the conventions in https://cloud.google.com/
3052
+ # apis/design/resource_names. For example: `projects/my-project/locations/us-
3053
+ # central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`
1451
3054
  # @param [String] fields
1452
3055
  # Selector specifying which fields to include in a partial response.
1453
3056
  # @param [String] quota_user
@@ -1457,36 +3060,114 @@ module Google
1457
3060
  # Request-specific options
1458
3061
  #
1459
3062
  # @yield [result, err] Result & error if block supplied
1460
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
3063
+ # @yieldparam result [Google::Apis::VmwareengineV1::LoggingServer] parsed result object
3064
+ # @yieldparam err [StandardError] error object if request failed
3065
+ #
3066
+ # @return [Google::Apis::VmwareengineV1::LoggingServer]
3067
+ #
3068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3071
+ def get_project_location_private_cloud_logging_server(name, fields: nil, quota_user: nil, options: nil, &block)
3072
+ command = make_simple_command(:get, 'v1/{+name}', options)
3073
+ command.response_representation = Google::Apis::VmwareengineV1::LoggingServer::Representation
3074
+ command.response_class = Google::Apis::VmwareengineV1::LoggingServer
3075
+ command.params['name'] = name unless name.nil?
3076
+ command.query['fields'] = fields unless fields.nil?
3077
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3078
+ execute_or_queue_command(command, &block)
3079
+ end
3080
+
3081
+ # Lists logging servers configured for a given private cloud.
3082
+ # @param [String] parent
3083
+ # Required. The resource name of the private cloud to be queried for logging
3084
+ # servers. Resource names are schemeless URIs that follow the conventions in
3085
+ # https://cloud.google.com/apis/design/resource_names. For example: `projects/my-
3086
+ # project/locations/us-central1-a/privateClouds/my-cloud`
3087
+ # @param [String] filter
3088
+ # A filter expression that matches resources returned in the response. The
3089
+ # expression must specify the field name, a comparison operator, and the value
3090
+ # that you want to use for filtering. The value must be a string, a number, or a
3091
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
3092
+ # if you are filtering a list of logging servers, you can exclude the ones named
3093
+ # `example-server` by specifying `name != "example-server"`. To filter on
3094
+ # multiple expressions, provide each separate expression within parentheses. For
3095
+ # example: ``` (name = "example-server") (createTime > "2021-04-12T08:15:10.40Z")
3096
+ # ``` By default, each expression is an `AND` expression. However, you can
3097
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
3098
+ # example-server-1") AND (createTime > "2021-04-12T08:15:10.40Z") OR (name = "
3099
+ # example-server-2") ```
3100
+ # @param [String] order_by
3101
+ # Sorts list results by a certain order. By default, returned results are
3102
+ # ordered by `name` in ascending order. You can also sort results in descending
3103
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
3104
+ # ordering by `name` is supported.
3105
+ # @param [Fixnum] page_size
3106
+ # The maximum number of logging servers to return in one page. The service may
3107
+ # return fewer than this value. The maximum value is coerced to 1000. The
3108
+ # default value of this field is 500.
3109
+ # @param [String] page_token
3110
+ # A page token, received from a previous `ListLoggingServersRequest` call.
3111
+ # Provide this to retrieve the subsequent page. When paginating, all other
3112
+ # parameters provided to `ListLoggingServersRequest` must match the call that
3113
+ # provided the page token.
3114
+ # @param [String] fields
3115
+ # Selector specifying which fields to include in a partial response.
3116
+ # @param [String] quota_user
3117
+ # Available to use for quota purposes for server-side applications. Can be any
3118
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3119
+ # @param [Google::Apis::RequestOptions] options
3120
+ # Request-specific options
3121
+ #
3122
+ # @yield [result, err] Result & error if block supplied
3123
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListLoggingServersResponse] parsed result object
1461
3124
  # @yieldparam err [StandardError] error object if request failed
1462
3125
  #
1463
- # @return [Google::Apis::VmwareengineV1::Policy]
3126
+ # @return [Google::Apis::VmwareengineV1::ListLoggingServersResponse]
1464
3127
  #
1465
3128
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1466
3129
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1467
3130
  # @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?
3131
+ def list_project_location_private_cloud_logging_servers(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3132
+ command = make_simple_command(:get, 'v1/{+parent}/loggingServers', options)
3133
+ command.response_representation = Google::Apis::VmwareengineV1::ListLoggingServersResponse::Representation
3134
+ command.response_class = Google::Apis::VmwareengineV1::ListLoggingServersResponse
3135
+ command.params['parent'] = parent unless parent.nil?
3136
+ command.query['filter'] = filter unless filter.nil?
3137
+ command.query['orderBy'] = order_by unless order_by.nil?
3138
+ command.query['pageSize'] = page_size unless page_size.nil?
3139
+ command.query['pageToken'] = page_token unless page_token.nil?
1475
3140
  command.query['fields'] = fields unless fields.nil?
1476
3141
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1477
3142
  execute_or_queue_command(command, &block)
1478
3143
  end
1479
3144
 
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
3145
+ # Updates the parameters of a single logging server. Only fields specified in `
3146
+ # update_mask` are applied.
3147
+ # @param [String] name
3148
+ # Output only. The resource name of this logging server. Resource names are
3149
+ # schemeless URIs that follow the conventions in https://cloud.google.com/apis/
3150
+ # design/resource_names. For example: `projects/my-project/locations/us-central1-
3151
+ # a/privateClouds/my-cloud/loggingServers/my-logging-server`
3152
+ # @param [Google::Apis::VmwareengineV1::LoggingServer] logging_server_object
3153
+ # @param [String] request_id
3154
+ # Optional. A request ID to identify requests. Specify a unique request ID so
3155
+ # that if you must retry your request, the server will know to ignore the
3156
+ # request if it has already been completed. The server guarantees that a request
3157
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
3158
+ # For example, consider a situation where you make an initial request and the
3159
+ # request times out. If you make the request again with the same request ID, the
3160
+ # server can check if original operation with the same request ID was received,
3161
+ # and if so, will ignore the second request. This prevents clients from
3162
+ # accidentally creating duplicate commitments. The request ID must be a valid
3163
+ # UUID with the exception that zero UUID is not supported (00000000-0000-0000-
3164
+ # 0000-000000000000).
3165
+ # @param [String] update_mask
3166
+ # Required. Field mask is used to specify the fields to be overwritten in the `
3167
+ # LoggingServer` resource by the update. The fields specified in the `
3168
+ # update_mask` are relative to the resource, not the full request. A field will
3169
+ # be overwritten if it is in the mask. If the user does not provide a mask then
3170
+ # all fields will be overwritten.
1490
3171
  # @param [String] fields
1491
3172
  # Selector specifying which fields to include in a partial response.
1492
3173
  # @param [String] quota_user
@@ -1496,53 +3177,62 @@ module Google
1496
3177
  # Request-specific options
1497
3178
  #
1498
3179
  # @yield [result, err] Result & error if block supplied
1499
- # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
3180
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1500
3181
  # @yieldparam err [StandardError] error object if request failed
1501
3182
  #
1502
- # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
3183
+ # @return [Google::Apis::VmwareengineV1::Operation]
1503
3184
  #
1504
3185
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1505
3186
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1506
3187
  # @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?
3188
+ def patch_project_location_private_cloud_logging_server(name, logging_server_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3189
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3190
+ command.request_representation = Google::Apis::VmwareengineV1::LoggingServer::Representation
3191
+ command.request_object = logging_server_object
3192
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
3193
+ command.response_class = Google::Apis::VmwareengineV1::Operation
3194
+ command.params['name'] = name unless name.nil?
3195
+ command.query['requestId'] = request_id unless request_id.nil?
3196
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1514
3197
  command.query['fields'] = fields unless fields.nil?
1515
3198
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1516
3199
  execute_or_queue_command(command, &block)
1517
3200
  end
1518
3201
 
1519
- # Creates a new HCX activation key in a given private cloud.
3202
+ # Creates a new `ManagementDnsZoneBinding` resource in a private cloud. This RPC
3203
+ # creates the DNS binding and the resource that represents the DNS binding of
3204
+ # the consumer VPC network to the management DNS zone. A management DNS zone is
3205
+ # the Cloud DNS cross-project binding zone that VMware Engine creates for each
3206
+ # private cloud. It contains FQDNs and corresponding IP addresses for the
3207
+ # private cloud's ESXi hosts and management VM appliances like vCenter and NSX
3208
+ # Manager.
1520
3209
  # @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)
3210
+ # Required. The resource name of the private cloud to create a new management
3211
+ # DNS zone binding for. Resource names are schemeless URIs that follow the
3212
+ # conventions in https://cloud.google.com/apis/design/resource_names. For
3213
+ # example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`
3214
+ # @param [Google::Apis::VmwareengineV1::ManagementDnsZoneBinding] management_dns_zone_binding_object
3215
+ # @param [String] management_dns_zone_binding_id
3216
+ # Required. The user-provided identifier of the `ManagementDnsZoneBinding`
3217
+ # resource to be created. This identifier must be unique among `
3218
+ # ManagementDnsZoneBinding` resources within the parent and becomes the final
3219
+ # token in the name URI. The identifier must meet the following requirements: *
3220
+ # Only contains 1-63 alphanumeric characters and hyphens * Begins with an
3221
+ # alphabetical character * Ends with a non-hyphen character * Not formatted as a
3222
+ # UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034)
3223
+ # (section 3.5)
1534
3224
  # @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).
3225
+ # Optional. A request ID to identify requests. Specify a unique request ID so
3226
+ # that if you must retry your request, the server will know to ignore the
3227
+ # request if it has already been completed. The server guarantees that a request
3228
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
3229
+ # For example, consider a situation where you make an initial request and the
3230
+ # request times out. If you make the request again with the same request ID, the
3231
+ # server can check if the original operation with the same request ID was
3232
+ # received, and if so, will ignore the second request. This prevents clients
3233
+ # from accidentally creating duplicate commitments. The request ID must be a
3234
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
3235
+ # 0000-0000-000000000000).
1546
3236
  # @param [String] fields
1547
3237
  # Selector specifying which fields to include in a partial response.
1548
3238
  # @param [String] quota_user
@@ -1560,26 +3250,41 @@ module Google
1560
3250
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1561
3251
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1562
3252
  # @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
3253
+ def create_project_location_private_cloud_management_dns_zone_binding(parent, management_dns_zone_binding_object = nil, management_dns_zone_binding_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3254
+ command = make_simple_command(:post, 'v1/{+parent}/managementDnsZoneBindings', options)
3255
+ command.request_representation = Google::Apis::VmwareengineV1::ManagementDnsZoneBinding::Representation
3256
+ command.request_object = management_dns_zone_binding_object
1567
3257
  command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
1568
3258
  command.response_class = Google::Apis::VmwareengineV1::Operation
1569
3259
  command.params['parent'] = parent unless parent.nil?
1570
- command.query['hcxActivationKeyId'] = hcx_activation_key_id unless hcx_activation_key_id.nil?
3260
+ command.query['managementDnsZoneBindingId'] = management_dns_zone_binding_id unless management_dns_zone_binding_id.nil?
1571
3261
  command.query['requestId'] = request_id unless request_id.nil?
1572
3262
  command.query['fields'] = fields unless fields.nil?
1573
3263
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1574
3264
  execute_or_queue_command(command, &block)
1575
3265
  end
1576
3266
 
1577
- # Retrieves a `HcxActivationKey` resource by its resource name.
3267
+ # Deletes a `ManagementDnsZoneBinding` resource. When a management DNS zone
3268
+ # binding is deleted, the corresponding consumer VPC network is no longer bound
3269
+ # to the management DNS zone.
1578
3270
  # @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`
3271
+ # Required. The resource name of the management DNS zone binding to delete.
3272
+ # Resource names are schemeless URIs that follow the conventions in https://
3273
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
3274
+ # locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-
3275
+ # management-dns-zone-binding`
3276
+ # @param [String] request_id
3277
+ # Optional. A request ID to identify requests. Specify a unique request ID so
3278
+ # that if you must retry your request, the server will know to ignore the
3279
+ # request if it has already been completed. The server guarantees that a request
3280
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
3281
+ # For example, consider a situation where you make an initial request and the
3282
+ # request times out. If you make the request again with the same request ID, the
3283
+ # server can check if the original operation with the same request ID was
3284
+ # received, and if so, will ignore the second request. This prevents clients
3285
+ # from accidentally creating duplicate commitments. The request ID must be a
3286
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
3287
+ # 0000-0000-000000000000).
1583
3288
  # @param [String] fields
1584
3289
  # Selector specifying which fields to include in a partial response.
1585
3290
  # @param [String] quota_user
@@ -1589,41 +3294,32 @@ module Google
1589
3294
  # Request-specific options
1590
3295
  #
1591
3296
  # @yield [result, err] Result & error if block supplied
1592
- # @yieldparam result [Google::Apis::VmwareengineV1::HcxActivationKey] parsed result object
3297
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1593
3298
  # @yieldparam err [StandardError] error object if request failed
1594
3299
  #
1595
- # @return [Google::Apis::VmwareengineV1::HcxActivationKey]
3300
+ # @return [Google::Apis::VmwareengineV1::Operation]
1596
3301
  #
1597
3302
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1598
3303
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1599
3304
  # @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
3305
+ def delete_project_location_private_cloud_management_dns_zone_binding(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3306
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3307
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
3308
+ command.response_class = Google::Apis::VmwareengineV1::Operation
1604
3309
  command.params['name'] = name unless name.nil?
3310
+ command.query['requestId'] = request_id unless request_id.nil?
1605
3311
  command.query['fields'] = fields unless fields.nil?
1606
3312
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1607
3313
  execute_or_queue_command(command, &block)
1608
3314
  end
1609
3315
 
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).
3316
+ # Retrieves a 'ManagementDnsZoneBinding' resource by its resource name.
3317
+ # @param [String] name
3318
+ # Required. The resource name of the management DNS zone binding to retrieve.
3319
+ # Resource names are schemeless URIs that follow the conventions in https://
3320
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
3321
+ # locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-
3322
+ # management-dns-zone-binding`
1627
3323
  # @param [String] fields
1628
3324
  # Selector specifying which fields to include in a partial response.
1629
3325
  # @param [String] quota_user
@@ -1633,40 +3329,58 @@ module Google
1633
3329
  # Request-specific options
1634
3330
  #
1635
3331
  # @yield [result, err] Result & error if block supplied
1636
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
3332
+ # @yieldparam result [Google::Apis::VmwareengineV1::ManagementDnsZoneBinding] parsed result object
1637
3333
  # @yieldparam err [StandardError] error object if request failed
1638
3334
  #
1639
- # @return [Google::Apis::VmwareengineV1::Policy]
3335
+ # @return [Google::Apis::VmwareengineV1::ManagementDnsZoneBinding]
1640
3336
  #
1641
3337
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1642
3338
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1643
3339
  # @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?
3340
+ def get_project_location_private_cloud_management_dns_zone_binding(name, fields: nil, quota_user: nil, options: nil, &block)
3341
+ command = make_simple_command(:get, 'v1/{+name}', options)
3342
+ command.response_representation = Google::Apis::VmwareengineV1::ManagementDnsZoneBinding::Representation
3343
+ command.response_class = Google::Apis::VmwareengineV1::ManagementDnsZoneBinding
3344
+ command.params['name'] = name unless name.nil?
1650
3345
  command.query['fields'] = fields unless fields.nil?
1651
3346
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1652
3347
  execute_or_queue_command(command, &block)
1653
3348
  end
1654
3349
 
1655
- # Lists `HcxActivationKey` resources in a given private cloud.
3350
+ # Lists Consumer VPCs bound to Management DNS Zone of a given private cloud.
1656
3351
  # @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
3352
+ # Required. The resource name of the private cloud to be queried for management
3353
+ # DNS zone bindings. Resource names are schemeless URIs that follow the
1659
3354
  # conventions in https://cloud.google.com/apis/design/resource_names. For
1660
- # example: `projects/my-project/locations/us-central1/privateClouds/my-cloud`
3355
+ # example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`
3356
+ # @param [String] filter
3357
+ # A filter expression that matches resources returned in the response. The
3358
+ # expression must specify the field name, a comparison operator, and the value
3359
+ # that you want to use for filtering. The value must be a string, a number, or a
3360
+ # boolean. The comparison operator must be `=`, `!=`, `>`, or `<`. For example,
3361
+ # if you are filtering a list of Management DNS Zone Bindings, you can exclude
3362
+ # the ones named `example-management-dns-zone-binding` by specifying `name != "
3363
+ # example-management-dns-zone-binding"`. To filter on multiple expressions,
3364
+ # provide each separate expression within parentheses. For example: ``` (name = "
3365
+ # example-management-dns-zone-binding") (createTime > "2021-04-12T08:15:10.40Z")
3366
+ # ``` By default, each expression is an `AND` expression. However, you can
3367
+ # include `AND` and `OR` expressions explicitly. For example: ``` (name = "
3368
+ # example-management-dns-zone-binding-1") AND (createTime > "2021-04-12T08:15:10.
3369
+ # 40Z") OR (name = "example-management-dns-zone-binding-2") ```
3370
+ # @param [String] order_by
3371
+ # Sorts list results by a certain order. By default, returned results are
3372
+ # ordered by `name` in ascending order. You can also sort results in descending
3373
+ # order based on the `name` value using `orderBy="name desc"`. Currently, only
3374
+ # ordering by `name` is supported.
1661
3375
  # @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.
3376
+ # The maximum number of management DNS zone bindings to return in one page. The
3377
+ # service may return fewer than this value. The maximum value is coerced to 1000.
3378
+ # The default value of this field is 500.
1665
3379
  # @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.
3380
+ # A page token, received from a previous `ListManagementDnsZoneBindings` call.
3381
+ # Provide this to retrieve the subsequent page. When paginating, all other
3382
+ # parameters provided to `ListManagementDnsZoneBindings` must match the call
3383
+ # that provided the page token.
1670
3384
  # @param [String] fields
1671
3385
  # Selector specifying which fields to include in a partial response.
1672
3386
  # @param [String] quota_user
@@ -1676,19 +3390,21 @@ module Google
1676
3390
  # Request-specific options
1677
3391
  #
1678
3392
  # @yield [result, err] Result & error if block supplied
1679
- # @yieldparam result [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse] parsed result object
3393
+ # @yieldparam result [Google::Apis::VmwareengineV1::ListManagementDnsZoneBindingsResponse] parsed result object
1680
3394
  # @yieldparam err [StandardError] error object if request failed
1681
3395
  #
1682
- # @return [Google::Apis::VmwareengineV1::ListHcxActivationKeysResponse]
3396
+ # @return [Google::Apis::VmwareengineV1::ListManagementDnsZoneBindingsResponse]
1683
3397
  #
1684
3398
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1685
3399
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1686
3400
  # @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
3401
+ def list_project_location_private_cloud_management_dns_zone_bindings(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3402
+ command = make_simple_command(:get, 'v1/{+parent}/managementDnsZoneBindings', options)
3403
+ command.response_representation = Google::Apis::VmwareengineV1::ListManagementDnsZoneBindingsResponse::Representation
3404
+ command.response_class = Google::Apis::VmwareengineV1::ListManagementDnsZoneBindingsResponse
1691
3405
  command.params['parent'] = parent unless parent.nil?
3406
+ command.query['filter'] = filter unless filter.nil?
3407
+ command.query['orderBy'] = order_by unless order_by.nil?
1692
3408
  command.query['pageSize'] = page_size unless page_size.nil?
1693
3409
  command.query['pageToken'] = page_token unless page_token.nil?
1694
3410
  command.query['fields'] = fields unless fields.nil?
@@ -1696,14 +3412,33 @@ module Google
1696
3412
  execute_or_queue_command(command, &block)
1697
3413
  end
1698
3414
 
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
3415
+ # Updates a `ManagementDnsZoneBinding` resource. Only fields specified in `
3416
+ # update_mask` are applied.
3417
+ # @param [String] name
3418
+ # Output only. The resource name of this binding. Resource names are schemeless
3419
+ # URIs that follow the conventions in https://cloud.google.com/apis/design/
3420
+ # resource_names. For example: `projects/my-project/locations/us-central1-a/
3421
+ # privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-
3422
+ # binding`
3423
+ # @param [Google::Apis::VmwareengineV1::ManagementDnsZoneBinding] management_dns_zone_binding_object
3424
+ # @param [String] request_id
3425
+ # Optional. A request ID to identify requests. Specify a unique request ID so
3426
+ # that if you must retry your request, the server will know to ignore the
3427
+ # request if it has already been completed. The server guarantees that a request
3428
+ # doesn't result in creation of duplicate commitments for at least 60 minutes.
3429
+ # For example, consider a situation where you make an initial request and the
3430
+ # request times out. If you make the request again with the same request ID, the
3431
+ # server can check if the original operation with the same request ID was
3432
+ # received, and if so, will ignore the second request. This prevents clients
3433
+ # from accidentally creating duplicate commitments. The request ID must be a
3434
+ # valid UUID with the exception that zero UUID is not supported (00000000-0000-
3435
+ # 0000-0000-000000000000).
3436
+ # @param [String] update_mask
3437
+ # Required. Field mask is used to specify the fields to be overwritten in the `
3438
+ # ManagementDnsZoneBinding` resource by the update. The fields specified in the `
3439
+ # update_mask` are relative to the resource, not the full request. A field will
3440
+ # be overwritten if it is in the mask. If the user does not provide a mask then
3441
+ # all fields will be overwritten.
1707
3442
  # @param [String] fields
1708
3443
  # Selector specifying which fields to include in a partial response.
1709
3444
  # @param [String] quota_user
@@ -1713,36 +3448,37 @@ module Google
1713
3448
  # Request-specific options
1714
3449
  #
1715
3450
  # @yield [result, err] Result & error if block supplied
1716
- # @yieldparam result [Google::Apis::VmwareengineV1::Policy] parsed result object
3451
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1717
3452
  # @yieldparam err [StandardError] error object if request failed
1718
3453
  #
1719
- # @return [Google::Apis::VmwareengineV1::Policy]
3454
+ # @return [Google::Apis::VmwareengineV1::Operation]
1720
3455
  #
1721
3456
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1722
3457
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1723
3458
  # @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?
3459
+ def patch_project_location_private_cloud_management_dns_zone_binding(name, management_dns_zone_binding_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3460
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3461
+ command.request_representation = Google::Apis::VmwareengineV1::ManagementDnsZoneBinding::Representation
3462
+ command.request_object = management_dns_zone_binding_object
3463
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
3464
+ command.response_class = Google::Apis::VmwareengineV1::Operation
3465
+ command.params['name'] = name unless name.nil?
3466
+ command.query['requestId'] = request_id unless request_id.nil?
3467
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1731
3468
  command.query['fields'] = fields unless fields.nil?
1732
3469
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1733
3470
  execute_or_queue_command(command, &block)
1734
3471
  end
1735
3472
 
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
3473
+ # Retries to create a `ManagementDnsZoneBinding` resource that is in failed
3474
+ # state.
3475
+ # @param [String] name
3476
+ # Required. The resource name of the management DNS zone binding to repair.
3477
+ # Resource names are schemeless URIs that follow the conventions in https://
3478
+ # cloud.google.com/apis/design/resource_names. For example: `projects/my-project/
3479
+ # locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-
3480
+ # management-dns-zone-binding`
3481
+ # @param [Google::Apis::VmwareengineV1::RepairManagementDnsZoneBindingRequest] repair_management_dns_zone_binding_request_object
1746
3482
  # @param [String] fields
1747
3483
  # Selector specifying which fields to include in a partial response.
1748
3484
  # @param [String] quota_user
@@ -1752,21 +3488,21 @@ module Google
1752
3488
  # Request-specific options
1753
3489
  #
1754
3490
  # @yield [result, err] Result & error if block supplied
1755
- # @yieldparam result [Google::Apis::VmwareengineV1::TestIamPermissionsResponse] parsed result object
3491
+ # @yieldparam result [Google::Apis::VmwareengineV1::Operation] parsed result object
1756
3492
  # @yieldparam err [StandardError] error object if request failed
1757
3493
  #
1758
- # @return [Google::Apis::VmwareengineV1::TestIamPermissionsResponse]
3494
+ # @return [Google::Apis::VmwareengineV1::Operation]
1759
3495
  #
1760
3496
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1761
3497
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1762
3498
  # @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?
3499
+ def repair_management_dns_zone_binding(name, repair_management_dns_zone_binding_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3500
+ command = make_simple_command(:post, 'v1/{+name}:repair', options)
3501
+ command.request_representation = Google::Apis::VmwareengineV1::RepairManagementDnsZoneBindingRequest::Representation
3502
+ command.request_object = repair_management_dns_zone_binding_request_object
3503
+ command.response_representation = Google::Apis::VmwareengineV1::Operation::Representation
3504
+ command.response_class = Google::Apis::VmwareengineV1::Operation
3505
+ command.params['name'] = name unless name.nil?
1770
3506
  command.query['fields'] = fields unless fields.nil?
1771
3507
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1772
3508
  execute_or_queue_command(command, &block)