google-apis-compute_v1 0.55.0 → 0.56.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12913,6 +12913,9 @@ module Google
12913
12913
  # The name of the zone for this request.
12914
12914
  # @param [String] instance
12915
12915
  # Name of the instance resource to stop.
12916
+ # @param [Boolean] discard_local_ssd
12917
+ # If true, discard the contents of any attached localSSD partitions. Default
12918
+ # value is false.
12916
12919
  # @param [String] request_id
12917
12920
  # An optional request ID to identify requests. Specify a unique request ID so
12918
12921
  # that if you must retry your request, the server will know to ignore the
@@ -12942,13 +12945,14 @@ module Google
12942
12945
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
12943
12946
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
12944
12947
  # @raise [Google::Apis::AuthorizationError] Authorization is required
12945
- def stop_instance(project, zone, instance, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
12948
+ def stop_instance(project, zone, instance, discard_local_ssd: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
12946
12949
  command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instances/{instance}/stop', options)
12947
12950
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
12948
12951
  command.response_class = Google::Apis::ComputeV1::Operation
12949
12952
  command.params['project'] = project unless project.nil?
12950
12953
  command.params['zone'] = zone unless zone.nil?
12951
12954
  command.params['instance'] = instance unless instance.nil?
12955
+ command.query['discardLocalSsd'] = discard_local_ssd unless discard_local_ssd.nil?
12952
12956
  command.query['requestId'] = request_id unless request_id.nil?
12953
12957
  command.query['fields'] = fields unless fields.nil?
12954
12958
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -12969,6 +12973,9 @@ module Google
12969
12973
  # The name of the zone for this request.
12970
12974
  # @param [String] instance
12971
12975
  # Name of the instance resource to suspend.
12976
+ # @param [Boolean] discard_local_ssd
12977
+ # If true, discard the contents of any attached localSSD partitions. Default
12978
+ # value is false.
12972
12979
  # @param [String] request_id
12973
12980
  # An optional request ID to identify requests. Specify a unique request ID so
12974
12981
  # that if you must retry your request, the server will know to ignore the
@@ -12998,13 +13005,14 @@ module Google
12998
13005
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
12999
13006
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13000
13007
  # @raise [Google::Apis::AuthorizationError] Authorization is required
13001
- def suspend_instance(project, zone, instance, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13008
+ def suspend_instance(project, zone, instance, discard_local_ssd: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13002
13009
  command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instances/{instance}/suspend', options)
13003
13010
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
13004
13011
  command.response_class = Google::Apis::ComputeV1::Operation
13005
13012
  command.params['project'] = project unless project.nil?
13006
13013
  command.params['zone'] = zone unless zone.nil?
13007
13014
  command.params['instance'] = instance unless instance.nil?
13015
+ command.query['discardLocalSsd'] = discard_local_ssd unless discard_local_ssd.nil?
13008
13016
  command.query['requestId'] = request_id unless request_id.nil?
13009
13017
  command.query['fields'] = fields unless fields.nil?
13010
13018
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -13914,7 +13922,7 @@ module Google
13914
13922
  execute_or_queue_command(command, &block)
13915
13923
  end
13916
13924
 
13917
- # Deletes the specified interconnect.
13925
+ # Deletes the specified Interconnect.
13918
13926
  # @param [String] project
13919
13927
  # Project ID for this request.
13920
13928
  # @param [String] interconnect
@@ -13961,7 +13969,7 @@ module Google
13961
13969
  execute_or_queue_command(command, &block)
13962
13970
  end
13963
13971
 
13964
- # Returns the specified interconnect. Get a list of available interconnects by
13972
+ # Returns the specified Interconnect. Get a list of available Interconnects by
13965
13973
  # making a list() request.
13966
13974
  # @param [String] project
13967
13975
  # Project ID for this request.
@@ -13998,7 +14006,7 @@ module Google
13998
14006
  execute_or_queue_command(command, &block)
13999
14007
  end
14000
14008
 
14001
- # Returns the interconnectDiagnostics for the specified interconnect.
14009
+ # Returns the interconnectDiagnostics for the specified Interconnect.
14002
14010
  # @param [String] project
14003
14011
  # Project ID for this request.
14004
14012
  # @param [String] interconnect
@@ -14034,8 +14042,8 @@ module Google
14034
14042
  execute_or_queue_command(command, &block)
14035
14043
  end
14036
14044
 
14037
- # Creates a Interconnect in the specified project using the data included in the
14038
- # request.
14045
+ # Creates an Interconnect in the specified project using the data included in
14046
+ # the request.
14039
14047
  # @param [String] project
14040
14048
  # Project ID for this request.
14041
14049
  # @param [Google::Apis::ComputeV1::Interconnect] interconnect_object
@@ -14082,7 +14090,7 @@ module Google
14082
14090
  execute_or_queue_command(command, &block)
14083
14091
  end
14084
14092
 
14085
- # Retrieves the list of interconnect available to the specified project.
14093
+ # Retrieves the list of Interconnects available to the specified project.
14086
14094
  # @param [String] project
14087
14095
  # Project ID for this request.
14088
14096
  # @param [String] filter
@@ -14170,7 +14178,7 @@ module Google
14170
14178
  execute_or_queue_command(command, &block)
14171
14179
  end
14172
14180
 
14173
- # Updates the specified interconnect with the data included in the request. This
14181
+ # Updates the specified Interconnect with the data included in the request. This
14174
14182
  # method supports PATCH semantics and uses the JSON merge patch format and
14175
14183
  # processing rules.
14176
14184
  # @param [String] project
@@ -15267,6 +15275,464 @@ module Google
15267
15275
  execute_or_queue_command(command, &block)
15268
15276
  end
15269
15277
 
15278
+ # Retrieves the list of all NetworkAttachment resources, regional and global,
15279
+ # available to the specified project.
15280
+ # @param [String] project
15281
+ # Project ID for this request.
15282
+ # @param [String] filter
15283
+ # A filter expression that filters resources listed in the response. Most
15284
+ # Compute resources support two types of filter expressions: expressions that
15285
+ # support regular expressions and expressions that follow API improvement
15286
+ # proposal AIP-160. If you want to use AIP-160, your expression must specify the
15287
+ # field name, an operator, and the value that you want to use for filtering. The
15288
+ # value must be a string, a number, or a boolean. The operator must be either `=`
15289
+ # , `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
15290
+ # Engine instances, you can exclude instances named `example-instance` by
15291
+ # specifying `name != example-instance`. The `:` operator can be used with
15292
+ # string fields to match substrings. For non-string fields it is equivalent to
15293
+ # the `=` operator. The `:*` comparison can be used to test whether a key has
15294
+ # been defined. For example, to find all objects with `owner` label use: ```
15295
+ # labels.owner:* ``` You can also filter nested fields. For example, you could
15296
+ # specify `scheduling.automaticRestart = false` to include instances only if
15297
+ # they are not scheduled for automatic restarts. You can use filtering on nested
15298
+ # fields to filter based on resource labels. To filter on multiple expressions,
15299
+ # provide each separate expression within parentheses. For example: ``` (
15300
+ # scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By
15301
+ # default, each expression is an `AND` expression. However, you can include `AND`
15302
+ # and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel
15303
+ # Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
15304
+ # automaticRestart = true) ``` If you want to use a regular expression, use the `
15305
+ # eq` (equal) or `ne` (not equal) operator against a single un-parenthesized
15306
+ # expression with or without quotes or against multiple parenthesized
15307
+ # expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single
15308
+ # quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq
15309
+ # literal) (fieldname2 ne "literal")` The literal value is interpreted as a
15310
+ # regular expression using Google RE2 library syntax. The literal value must
15311
+ # match the entire field. For example, to filter for instances that do not end
15312
+ # with name "instance", you would use `name ne .*instance`.
15313
+ # @param [Boolean] include_all_scopes
15314
+ # Indicates whether every visible scope for each scope type (zone, region,
15315
+ # global) should be included in the response. For new resource types added after
15316
+ # this field, the flag has no effect as new resource types will always include
15317
+ # every visible scope for each scope type in response. For resource types which
15318
+ # predate this field, if this flag is omitted or false, only scopes of the scope
15319
+ # types where the resource type is expected to be found will be included.
15320
+ # @param [Fixnum] max_results
15321
+ # The maximum number of results per page that should be returned. If the number
15322
+ # of available results is larger than `maxResults`, Compute Engine returns a `
15323
+ # nextPageToken` that can be used to get the next page of results in subsequent
15324
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
15325
+ # @param [String] order_by
15326
+ # Sorts list results by a certain order. By default, results are returned in
15327
+ # alphanumerical order based on the resource name. You can also sort results in
15328
+ # descending order based on the creation timestamp using `orderBy="
15329
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
15330
+ # field in reverse chronological order (newest result first). Use this to sort
15331
+ # resources like operations so that the newest operation is returned first.
15332
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
15333
+ # @param [String] page_token
15334
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
15335
+ # by a previous list request to get the next page of results.
15336
+ # @param [Boolean] return_partial_success
15337
+ # Opt-in for partial success behavior which provides partial results in case of
15338
+ # failure. The default value is false.
15339
+ # @param [String] fields
15340
+ # Selector specifying which fields to include in a partial response.
15341
+ # @param [String] quota_user
15342
+ # Available to use for quota purposes for server-side applications. Can be any
15343
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15344
+ # @param [String] user_ip
15345
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15346
+ # @param [Google::Apis::RequestOptions] options
15347
+ # Request-specific options
15348
+ #
15349
+ # @yield [result, err] Result & error if block supplied
15350
+ # @yieldparam result [Google::Apis::ComputeV1::NetworkAttachmentAggregatedList] parsed result object
15351
+ # @yieldparam err [StandardError] error object if request failed
15352
+ #
15353
+ # @return [Google::Apis::ComputeV1::NetworkAttachmentAggregatedList]
15354
+ #
15355
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15356
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15357
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15358
+ def aggregated_network_attachment_list(project, filter: nil, include_all_scopes: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15359
+ command = make_simple_command(:get, 'projects/{project}/aggregated/networkAttachments', options)
15360
+ command.response_representation = Google::Apis::ComputeV1::NetworkAttachmentAggregatedList::Representation
15361
+ command.response_class = Google::Apis::ComputeV1::NetworkAttachmentAggregatedList
15362
+ command.params['project'] = project unless project.nil?
15363
+ command.query['filter'] = filter unless filter.nil?
15364
+ command.query['includeAllScopes'] = include_all_scopes unless include_all_scopes.nil?
15365
+ command.query['maxResults'] = max_results unless max_results.nil?
15366
+ command.query['orderBy'] = order_by unless order_by.nil?
15367
+ command.query['pageToken'] = page_token unless page_token.nil?
15368
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
15369
+ command.query['fields'] = fields unless fields.nil?
15370
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15371
+ command.query['userIp'] = user_ip unless user_ip.nil?
15372
+ execute_or_queue_command(command, &block)
15373
+ end
15374
+
15375
+ # Deletes the specified NetworkAttachment in the given scope
15376
+ # @param [String] project
15377
+ # Project ID for this request.
15378
+ # @param [String] region
15379
+ # Name of the region of this request.
15380
+ # @param [String] network_attachment
15381
+ # Name of the NetworkAttachment resource to delete.
15382
+ # @param [String] request_id
15383
+ # An optional request ID to identify requests. Specify a unique request ID so
15384
+ # that if you must retry your request, the server will know to ignore the
15385
+ # request if it has already been completed. For example, consider a situation
15386
+ # where you make an initial request and the request times out. If you make the
15387
+ # request again with the same request ID, the server can check if original
15388
+ # operation with the same request ID was received, and if so, will ignore the
15389
+ # second request. This prevents clients from accidentally creating duplicate
15390
+ # commitments. The request ID must be a valid UUID with the exception that zero
15391
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
15392
+ # MixerMutationRequestBuilder
15393
+ # @param [String] fields
15394
+ # Selector specifying which fields to include in a partial response.
15395
+ # @param [String] quota_user
15396
+ # Available to use for quota purposes for server-side applications. Can be any
15397
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15398
+ # @param [String] user_ip
15399
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15400
+ # @param [Google::Apis::RequestOptions] options
15401
+ # Request-specific options
15402
+ #
15403
+ # @yield [result, err] Result & error if block supplied
15404
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
15405
+ # @yieldparam err [StandardError] error object if request failed
15406
+ #
15407
+ # @return [Google::Apis::ComputeV1::Operation]
15408
+ #
15409
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15410
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15411
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15412
+ def delete_network_attachment(project, region, network_attachment, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15413
+ command = make_simple_command(:delete, 'projects/{project}/regions/{region}/networkAttachments/{networkAttachment}', options)
15414
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
15415
+ command.response_class = Google::Apis::ComputeV1::Operation
15416
+ command.params['project'] = project unless project.nil?
15417
+ command.params['region'] = region unless region.nil?
15418
+ command.params['networkAttachment'] = network_attachment unless network_attachment.nil?
15419
+ command.query['requestId'] = request_id unless request_id.nil?
15420
+ command.query['fields'] = fields unless fields.nil?
15421
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15422
+ command.query['userIp'] = user_ip unless user_ip.nil?
15423
+ execute_or_queue_command(command, &block)
15424
+ end
15425
+
15426
+ # Returns the specified NetworkAttachment resource in the given scope.
15427
+ # @param [String] project
15428
+ # Project ID for this request.
15429
+ # @param [String] region
15430
+ # Name of the region of this request.
15431
+ # @param [String] network_attachment
15432
+ # Name of the NetworkAttachment resource to return.
15433
+ # @param [String] fields
15434
+ # Selector specifying which fields to include in a partial response.
15435
+ # @param [String] quota_user
15436
+ # Available to use for quota purposes for server-side applications. Can be any
15437
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15438
+ # @param [String] user_ip
15439
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15440
+ # @param [Google::Apis::RequestOptions] options
15441
+ # Request-specific options
15442
+ #
15443
+ # @yield [result, err] Result & error if block supplied
15444
+ # @yieldparam result [Google::Apis::ComputeV1::NetworkAttachment] parsed result object
15445
+ # @yieldparam err [StandardError] error object if request failed
15446
+ #
15447
+ # @return [Google::Apis::ComputeV1::NetworkAttachment]
15448
+ #
15449
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15450
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15451
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15452
+ def get_network_attachment(project, region, network_attachment, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15453
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/networkAttachments/{networkAttachment}', options)
15454
+ command.response_representation = Google::Apis::ComputeV1::NetworkAttachment::Representation
15455
+ command.response_class = Google::Apis::ComputeV1::NetworkAttachment
15456
+ command.params['project'] = project unless project.nil?
15457
+ command.params['region'] = region unless region.nil?
15458
+ command.params['networkAttachment'] = network_attachment unless network_attachment.nil?
15459
+ command.query['fields'] = fields unless fields.nil?
15460
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15461
+ command.query['userIp'] = user_ip unless user_ip.nil?
15462
+ execute_or_queue_command(command, &block)
15463
+ end
15464
+
15465
+ # Gets the access control policy for a resource. May be empty if no such policy
15466
+ # or resource exists.
15467
+ # @param [String] project
15468
+ # Project ID for this request.
15469
+ # @param [String] region
15470
+ # The name of the region for this request.
15471
+ # @param [String] resource
15472
+ # Name or id of the resource for this request.
15473
+ # @param [Fixnum] options_requested_policy_version
15474
+ # Requested IAM Policy version.
15475
+ # @param [String] fields
15476
+ # Selector specifying which fields to include in a partial response.
15477
+ # @param [String] quota_user
15478
+ # Available to use for quota purposes for server-side applications. Can be any
15479
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15480
+ # @param [String] user_ip
15481
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15482
+ # @param [Google::Apis::RequestOptions] options
15483
+ # Request-specific options
15484
+ #
15485
+ # @yield [result, err] Result & error if block supplied
15486
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
15487
+ # @yieldparam err [StandardError] error object if request failed
15488
+ #
15489
+ # @return [Google::Apis::ComputeV1::Policy]
15490
+ #
15491
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15492
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15493
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15494
+ def get_network_attachment_iam_policy(project, region, resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15495
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy', options)
15496
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
15497
+ command.response_class = Google::Apis::ComputeV1::Policy
15498
+ command.params['project'] = project unless project.nil?
15499
+ command.params['region'] = region unless region.nil?
15500
+ command.params['resource'] = resource unless resource.nil?
15501
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
15502
+ command.query['fields'] = fields unless fields.nil?
15503
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15504
+ command.query['userIp'] = user_ip unless user_ip.nil?
15505
+ execute_or_queue_command(command, &block)
15506
+ end
15507
+
15508
+ # Creates a NetworkAttachment in the specified project in the given scope using
15509
+ # the parameters that are included in the request.
15510
+ # @param [String] project
15511
+ # Project ID for this request.
15512
+ # @param [String] region
15513
+ # Name of the region of this request.
15514
+ # @param [Google::Apis::ComputeV1::NetworkAttachment] network_attachment_object
15515
+ # @param [String] request_id
15516
+ # An optional request ID to identify requests. Specify a unique request ID so
15517
+ # that if you must retry your request, the server will know to ignore the
15518
+ # request if it has already been completed. For example, consider a situation
15519
+ # where you make an initial request and the request times out. If you make the
15520
+ # request again with the same request ID, the server can check if original
15521
+ # operation with the same request ID was received, and if so, will ignore the
15522
+ # second request. This prevents clients from accidentally creating duplicate
15523
+ # commitments. The request ID must be a valid UUID with the exception that zero
15524
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
15525
+ # MixerMutationRequestBuilder
15526
+ # @param [String] fields
15527
+ # Selector specifying which fields to include in a partial response.
15528
+ # @param [String] quota_user
15529
+ # Available to use for quota purposes for server-side applications. Can be any
15530
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15531
+ # @param [String] user_ip
15532
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15533
+ # @param [Google::Apis::RequestOptions] options
15534
+ # Request-specific options
15535
+ #
15536
+ # @yield [result, err] Result & error if block supplied
15537
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
15538
+ # @yieldparam err [StandardError] error object if request failed
15539
+ #
15540
+ # @return [Google::Apis::ComputeV1::Operation]
15541
+ #
15542
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15543
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15544
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15545
+ def insert_network_attachment(project, region, network_attachment_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15546
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/networkAttachments', options)
15547
+ command.request_representation = Google::Apis::ComputeV1::NetworkAttachment::Representation
15548
+ command.request_object = network_attachment_object
15549
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
15550
+ command.response_class = Google::Apis::ComputeV1::Operation
15551
+ command.params['project'] = project unless project.nil?
15552
+ command.params['region'] = region unless region.nil?
15553
+ command.query['requestId'] = request_id unless request_id.nil?
15554
+ command.query['fields'] = fields unless fields.nil?
15555
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15556
+ command.query['userIp'] = user_ip unless user_ip.nil?
15557
+ execute_or_queue_command(command, &block)
15558
+ end
15559
+
15560
+ # Lists the NetworkAttachments for a project in the given scope.
15561
+ # @param [String] project
15562
+ # Project ID for this request.
15563
+ # @param [String] region
15564
+ # Name of the region of this request.
15565
+ # @param [String] filter
15566
+ # A filter expression that filters resources listed in the response. Most
15567
+ # Compute resources support two types of filter expressions: expressions that
15568
+ # support regular expressions and expressions that follow API improvement
15569
+ # proposal AIP-160. If you want to use AIP-160, your expression must specify the
15570
+ # field name, an operator, and the value that you want to use for filtering. The
15571
+ # value must be a string, a number, or a boolean. The operator must be either `=`
15572
+ # , `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
15573
+ # Engine instances, you can exclude instances named `example-instance` by
15574
+ # specifying `name != example-instance`. The `:` operator can be used with
15575
+ # string fields to match substrings. For non-string fields it is equivalent to
15576
+ # the `=` operator. The `:*` comparison can be used to test whether a key has
15577
+ # been defined. For example, to find all objects with `owner` label use: ```
15578
+ # labels.owner:* ``` You can also filter nested fields. For example, you could
15579
+ # specify `scheduling.automaticRestart = false` to include instances only if
15580
+ # they are not scheduled for automatic restarts. You can use filtering on nested
15581
+ # fields to filter based on resource labels. To filter on multiple expressions,
15582
+ # provide each separate expression within parentheses. For example: ``` (
15583
+ # scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By
15584
+ # default, each expression is an `AND` expression. However, you can include `AND`
15585
+ # and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel
15586
+ # Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
15587
+ # automaticRestart = true) ``` If you want to use a regular expression, use the `
15588
+ # eq` (equal) or `ne` (not equal) operator against a single un-parenthesized
15589
+ # expression with or without quotes or against multiple parenthesized
15590
+ # expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single
15591
+ # quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq
15592
+ # literal) (fieldname2 ne "literal")` The literal value is interpreted as a
15593
+ # regular expression using Google RE2 library syntax. The literal value must
15594
+ # match the entire field. For example, to filter for instances that do not end
15595
+ # with name "instance", you would use `name ne .*instance`.
15596
+ # @param [Fixnum] max_results
15597
+ # The maximum number of results per page that should be returned. If the number
15598
+ # of available results is larger than `maxResults`, Compute Engine returns a `
15599
+ # nextPageToken` that can be used to get the next page of results in subsequent
15600
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
15601
+ # @param [String] order_by
15602
+ # Sorts list results by a certain order. By default, results are returned in
15603
+ # alphanumerical order based on the resource name. You can also sort results in
15604
+ # descending order based on the creation timestamp using `orderBy="
15605
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
15606
+ # field in reverse chronological order (newest result first). Use this to sort
15607
+ # resources like operations so that the newest operation is returned first.
15608
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
15609
+ # @param [String] page_token
15610
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
15611
+ # by a previous list request to get the next page of results.
15612
+ # @param [Boolean] return_partial_success
15613
+ # Opt-in for partial success behavior which provides partial results in case of
15614
+ # failure. The default value is false.
15615
+ # @param [String] fields
15616
+ # Selector specifying which fields to include in a partial response.
15617
+ # @param [String] quota_user
15618
+ # Available to use for quota purposes for server-side applications. Can be any
15619
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15620
+ # @param [String] user_ip
15621
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15622
+ # @param [Google::Apis::RequestOptions] options
15623
+ # Request-specific options
15624
+ #
15625
+ # @yield [result, err] Result & error if block supplied
15626
+ # @yieldparam result [Google::Apis::ComputeV1::NetworkAttachmentList] parsed result object
15627
+ # @yieldparam err [StandardError] error object if request failed
15628
+ #
15629
+ # @return [Google::Apis::ComputeV1::NetworkAttachmentList]
15630
+ #
15631
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15632
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15633
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15634
+ def list_network_attachments(project, region, filter: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15635
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/networkAttachments', options)
15636
+ command.response_representation = Google::Apis::ComputeV1::NetworkAttachmentList::Representation
15637
+ command.response_class = Google::Apis::ComputeV1::NetworkAttachmentList
15638
+ command.params['project'] = project unless project.nil?
15639
+ command.params['region'] = region unless region.nil?
15640
+ command.query['filter'] = filter unless filter.nil?
15641
+ command.query['maxResults'] = max_results unless max_results.nil?
15642
+ command.query['orderBy'] = order_by unless order_by.nil?
15643
+ command.query['pageToken'] = page_token unless page_token.nil?
15644
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
15645
+ command.query['fields'] = fields unless fields.nil?
15646
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15647
+ command.query['userIp'] = user_ip unless user_ip.nil?
15648
+ execute_or_queue_command(command, &block)
15649
+ end
15650
+
15651
+ # Sets the access control policy on the specified resource. Replaces any
15652
+ # existing policy.
15653
+ # @param [String] project
15654
+ # Project ID for this request.
15655
+ # @param [String] region
15656
+ # The name of the region for this request.
15657
+ # @param [String] resource
15658
+ # Name or id of the resource for this request.
15659
+ # @param [Google::Apis::ComputeV1::RegionSetPolicyRequest] region_set_policy_request_object
15660
+ # @param [String] fields
15661
+ # Selector specifying which fields to include in a partial response.
15662
+ # @param [String] quota_user
15663
+ # Available to use for quota purposes for server-side applications. Can be any
15664
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15665
+ # @param [String] user_ip
15666
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15667
+ # @param [Google::Apis::RequestOptions] options
15668
+ # Request-specific options
15669
+ #
15670
+ # @yield [result, err] Result & error if block supplied
15671
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
15672
+ # @yieldparam err [StandardError] error object if request failed
15673
+ #
15674
+ # @return [Google::Apis::ComputeV1::Policy]
15675
+ #
15676
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15677
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15678
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15679
+ def set_network_attachment_iam_policy(project, region, resource, region_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15680
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy', options)
15681
+ command.request_representation = Google::Apis::ComputeV1::RegionSetPolicyRequest::Representation
15682
+ command.request_object = region_set_policy_request_object
15683
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
15684
+ command.response_class = Google::Apis::ComputeV1::Policy
15685
+ command.params['project'] = project unless project.nil?
15686
+ command.params['region'] = region unless region.nil?
15687
+ command.params['resource'] = resource unless resource.nil?
15688
+ command.query['fields'] = fields unless fields.nil?
15689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15690
+ command.query['userIp'] = user_ip unless user_ip.nil?
15691
+ execute_or_queue_command(command, &block)
15692
+ end
15693
+
15694
+ # Returns permissions that a caller has on the specified resource.
15695
+ # @param [String] project
15696
+ # Project ID for this request.
15697
+ # @param [String] region
15698
+ # The name of the region for this request.
15699
+ # @param [String] resource
15700
+ # Name or id of the resource for this request.
15701
+ # @param [Google::Apis::ComputeV1::TestPermissionsRequest] test_permissions_request_object
15702
+ # @param [String] fields
15703
+ # Selector specifying which fields to include in a partial response.
15704
+ # @param [String] quota_user
15705
+ # Available to use for quota purposes for server-side applications. Can be any
15706
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
15707
+ # @param [String] user_ip
15708
+ # Legacy name for parameter that has been superseded by `quotaUser`.
15709
+ # @param [Google::Apis::RequestOptions] options
15710
+ # Request-specific options
15711
+ #
15712
+ # @yield [result, err] Result & error if block supplied
15713
+ # @yieldparam result [Google::Apis::ComputeV1::TestPermissionsResponse] parsed result object
15714
+ # @yieldparam err [StandardError] error object if request failed
15715
+ #
15716
+ # @return [Google::Apis::ComputeV1::TestPermissionsResponse]
15717
+ #
15718
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
15719
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
15720
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
15721
+ def test_network_attachment_iam_permissions(project, region, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
15722
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions', options)
15723
+ command.request_representation = Google::Apis::ComputeV1::TestPermissionsRequest::Representation
15724
+ command.request_object = test_permissions_request_object
15725
+ command.response_representation = Google::Apis::ComputeV1::TestPermissionsResponse::Representation
15726
+ command.response_class = Google::Apis::ComputeV1::TestPermissionsResponse
15727
+ command.params['project'] = project unless project.nil?
15728
+ command.params['region'] = region unless region.nil?
15729
+ command.params['resource'] = resource unless resource.nil?
15730
+ command.query['fields'] = fields unless fields.nil?
15731
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
15732
+ command.query['userIp'] = user_ip unless user_ip.nil?
15733
+ execute_or_queue_command(command, &block)
15734
+ end
15735
+
15270
15736
  # Retrieves the list of all NetworkEdgeSecurityService resources available to
15271
15737
  # the specified project.
15272
15738
  # @param [String] project
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-compute_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.55.0
4
+ version: 0.56.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-11-07 00:00:00.000000000 Z
11
+ date: 2022-12-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-compute_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-compute_v1/v0.55.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-compute_v1/v0.56.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-compute_v1
63
63
  post_install_message:
64
64
  rdoc_options: []