google-apis-compute_beta 0.126.0 → 0.128.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.
@@ -10396,6 +10396,63 @@ module Google
10396
10396
  execute_or_queue_command(command, &block)
10397
10397
  end
10398
10398
 
10399
+ # Purge scoped resources (zonal policies) from a global VM extension
10400
+ # policy, and then delete the global VM extension policy. Purge of the scoped
10401
+ # resources is a pre-condition of the global VM extension policy deletion.
10402
+ # The deletion of the global VM extension policy happens after the purge
10403
+ # rollout is done, so it's not a part of the LRO. It's an automatic process
10404
+ # that triggers in the backend.
10405
+ # @param [String] project
10406
+ # Project ID for this request.
10407
+ # @param [String] global_vm_extension_policy
10408
+ # Name of the global VM extension policy to purge scoped resources for.
10409
+ # @param [Google::Apis::ComputeBeta::GlobalVmExtensionPolicyRolloutOperationRolloutInput] global_vm_extension_policy_rollout_operation_rollout_input_object
10410
+ # @param [String] request_id
10411
+ # An optional request ID to identify requests. Specify a unique request ID so
10412
+ # that if you must retry your request, the server will know to ignore the
10413
+ # request if it has already been completed.
10414
+ # For example, consider a situation where you make an initial request and
10415
+ # the request times out. If you make the request again with the same
10416
+ # request ID, the server can check if original operation with the same
10417
+ # request ID was received, and if so, will ignore the second request. This
10418
+ # prevents clients from accidentally creating duplicate commitments.
10419
+ # The request ID must be
10420
+ # a valid UUID with the exception that zero UUID is not supported
10421
+ # (00000000-0000-0000-0000-000000000000).
10422
+ # @param [String] fields
10423
+ # Selector specifying which fields to include in a partial response.
10424
+ # @param [String] quota_user
10425
+ # Available to use for quota purposes for server-side applications. Can be any
10426
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
10427
+ # @param [String] user_ip
10428
+ # Legacy name for parameter that has been superseded by `quotaUser`.
10429
+ # @param [Google::Apis::RequestOptions] options
10430
+ # Request-specific options
10431
+ #
10432
+ # @yield [result, err] Result & error if block supplied
10433
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
10434
+ # @yieldparam err [StandardError] error object if request failed
10435
+ #
10436
+ # @return [Google::Apis::ComputeBeta::Operation]
10437
+ #
10438
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
10439
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
10440
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
10441
+ def delete_global_vm_extension_policy(project, global_vm_extension_policy, global_vm_extension_policy_rollout_operation_rollout_input_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
10442
+ command = make_simple_command(:post, 'projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}/delete', options)
10443
+ command.request_representation = Google::Apis::ComputeBeta::GlobalVmExtensionPolicyRolloutOperationRolloutInput::Representation
10444
+ command.request_object = global_vm_extension_policy_rollout_operation_rollout_input_object
10445
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
10446
+ command.response_class = Google::Apis::ComputeBeta::Operation
10447
+ command.params['project'] = project unless project.nil?
10448
+ command.params['globalVmExtensionPolicy'] = global_vm_extension_policy unless global_vm_extension_policy.nil?
10449
+ command.query['requestId'] = request_id unless request_id.nil?
10450
+ command.query['fields'] = fields unless fields.nil?
10451
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
10452
+ command.query['userIp'] = user_ip unless user_ip.nil?
10453
+ execute_or_queue_command(command, &block)
10454
+ end
10455
+
10399
10456
  # Gets details of a global VM extension policy.
10400
10457
  # @param [String] project
10401
10458
  # Project ID for this request.
@@ -10432,6 +10489,221 @@ module Google
10432
10489
  execute_or_queue_command(command, &block)
10433
10490
  end
10434
10491
 
10492
+ # Creates a new project level GlobalVmExtensionPolicy.
10493
+ # @param [String] project
10494
+ # Project ID for this request.
10495
+ # @param [Google::Apis::ComputeBeta::GlobalVmExtensionPolicy] global_vm_extension_policy_object
10496
+ # @param [String] request_id
10497
+ # An optional request ID to identify requests. Specify a unique request ID so
10498
+ # that if you must retry your request, the server will know to ignore the
10499
+ # request if it has already been completed.
10500
+ # For example, consider a situation where you make an initial request and
10501
+ # the request times out. If you make the request again with the same
10502
+ # request ID, the server can check if original operation with the same
10503
+ # request ID was received, and if so, will ignore the second request. This
10504
+ # prevents clients from accidentally creating duplicate commitments.
10505
+ # The request ID must be
10506
+ # a valid UUID with the exception that zero UUID is not supported
10507
+ # (00000000-0000-0000-0000-000000000000).
10508
+ # @param [String] fields
10509
+ # Selector specifying which fields to include in a partial response.
10510
+ # @param [String] quota_user
10511
+ # Available to use for quota purposes for server-side applications. Can be any
10512
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
10513
+ # @param [String] user_ip
10514
+ # Legacy name for parameter that has been superseded by `quotaUser`.
10515
+ # @param [Google::Apis::RequestOptions] options
10516
+ # Request-specific options
10517
+ #
10518
+ # @yield [result, err] Result & error if block supplied
10519
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
10520
+ # @yieldparam err [StandardError] error object if request failed
10521
+ #
10522
+ # @return [Google::Apis::ComputeBeta::Operation]
10523
+ #
10524
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
10525
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
10526
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
10527
+ def insert_global_vm_extension_policy(project, global_vm_extension_policy_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
10528
+ command = make_simple_command(:post, 'projects/{project}/global/vmExtensionPolicies', options)
10529
+ command.request_representation = Google::Apis::ComputeBeta::GlobalVmExtensionPolicy::Representation
10530
+ command.request_object = global_vm_extension_policy_object
10531
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
10532
+ command.response_class = Google::Apis::ComputeBeta::Operation
10533
+ command.params['project'] = project unless project.nil?
10534
+ command.query['requestId'] = request_id unless request_id.nil?
10535
+ command.query['fields'] = fields unless fields.nil?
10536
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
10537
+ command.query['userIp'] = user_ip unless user_ip.nil?
10538
+ execute_or_queue_command(command, &block)
10539
+ end
10540
+
10541
+ # Lists global VM extension policies.
10542
+ # @param [String] project
10543
+ # Project ID for this request.
10544
+ # @param [String] filter
10545
+ # A filter expression that filters resources listed in the response. Most
10546
+ # Compute resources support two types of filter expressions:
10547
+ # expressions that support regular expressions and expressions that follow
10548
+ # API improvement proposal AIP-160.
10549
+ # These two types of filter expressions cannot be mixed in one request.
10550
+ # If you want to use AIP-160, your expression must specify the field name, an
10551
+ # operator, and the value that you want to use for filtering. The value
10552
+ # must be a string, a number, or a boolean. The operator
10553
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
10554
+ # For example, if you are filtering Compute Engine instances, you can
10555
+ # exclude instances named `example-instance` by specifying
10556
+ # `name != example-instance`.
10557
+ # The `:*` comparison can be used to test whether a key has been defined.
10558
+ # For example, to find all objects with `owner` label use:
10559
+ # ```
10560
+ # labels.owner:*
10561
+ # ```
10562
+ # You can also filter nested fields. For example, you could specify
10563
+ # `scheduling.automaticRestart = false` to include instances only
10564
+ # if they are not scheduled for automatic restarts. You can use filtering
10565
+ # on nested fields to filter based onresource labels.
10566
+ # To filter on multiple expressions, provide each separate expression within
10567
+ # parentheses. For example:
10568
+ # ```
10569
+ # (scheduling.automaticRestart = true)
10570
+ # (cpuPlatform = "Intel Skylake")
10571
+ # ```
10572
+ # By default, each expression is an `AND` expression. However, you
10573
+ # can include `AND` and `OR` expressions explicitly.
10574
+ # For example:
10575
+ # ```
10576
+ # (cpuPlatform = "Intel Skylake") OR
10577
+ # (cpuPlatform = "Intel Broadwell") AND
10578
+ # (scheduling.automaticRestart = true)
10579
+ # ```
10580
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
10581
+ # (not equal) operator against a single un-parenthesized expression with or
10582
+ # without quotes or against multiple parenthesized expressions. Examples:
10583
+ # `fieldname eq unquoted literal`
10584
+ # `fieldname eq 'single quoted literal'`
10585
+ # `fieldname eq "double quoted literal"`
10586
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
10587
+ # The literal value is interpreted as a regular expression using GoogleRE2
10588
+ # library syntax.
10589
+ # The literal value must match the entire field.
10590
+ # For example, to filter for instances that do not end with name "instance",
10591
+ # you would use `name ne .*instance`.
10592
+ # You cannot combine constraints on multiple fields using regular
10593
+ # expressions.
10594
+ # @param [Fixnum] max_results
10595
+ # The maximum number of results per page that should be returned.
10596
+ # If the number of available results is larger than `maxResults`,
10597
+ # Compute Engine returns a `nextPageToken` that can be used to get
10598
+ # the next page of results in subsequent list requests. Acceptable values are
10599
+ # `0` to `500`, inclusive. (Default: `500`)
10600
+ # @param [String] order_by
10601
+ # Sorts list results by a certain order. By default, results
10602
+ # are returned in alphanumerical order based on the resource name.
10603
+ # You can also sort results in descending order based on the creation
10604
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
10605
+ # results based on the `creationTimestamp` field in
10606
+ # reverse chronological order (newest result first). Use this to sort
10607
+ # resources like operations so that the newest operation is returned first.
10608
+ # Currently, only sorting by `name` or
10609
+ # `creationTimestamp desc` is supported.
10610
+ # @param [String] page_token
10611
+ # Specifies a page token to use. Set `pageToken` to the
10612
+ # `nextPageToken` returned by a previous list request to get
10613
+ # the next page of results.
10614
+ # @param [Boolean] return_partial_success
10615
+ # Opt-in for partial success behavior which provides partial results in case
10616
+ # of failure. The default value is false.
10617
+ # For example, when partial success behavior is enabled, aggregatedList for a
10618
+ # single zone scope either returns all resources in the zone or no resources,
10619
+ # with an error code.
10620
+ # @param [String] fields
10621
+ # Selector specifying which fields to include in a partial response.
10622
+ # @param [String] quota_user
10623
+ # Available to use for quota purposes for server-side applications. Can be any
10624
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
10625
+ # @param [String] user_ip
10626
+ # Legacy name for parameter that has been superseded by `quotaUser`.
10627
+ # @param [Google::Apis::RequestOptions] options
10628
+ # Request-specific options
10629
+ #
10630
+ # @yield [result, err] Result & error if block supplied
10631
+ # @yieldparam result [Google::Apis::ComputeBeta::GlobalVmExtensionPolicyList] parsed result object
10632
+ # @yieldparam err [StandardError] error object if request failed
10633
+ #
10634
+ # @return [Google::Apis::ComputeBeta::GlobalVmExtensionPolicyList]
10635
+ #
10636
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
10637
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
10638
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
10639
+ def list_global_vm_extension_policies(project, 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)
10640
+ command = make_simple_command(:get, 'projects/{project}/global/vmExtensionPolicies', options)
10641
+ command.response_representation = Google::Apis::ComputeBeta::GlobalVmExtensionPolicyList::Representation
10642
+ command.response_class = Google::Apis::ComputeBeta::GlobalVmExtensionPolicyList
10643
+ command.params['project'] = project unless project.nil?
10644
+ command.query['filter'] = filter unless filter.nil?
10645
+ command.query['maxResults'] = max_results unless max_results.nil?
10646
+ command.query['orderBy'] = order_by unless order_by.nil?
10647
+ command.query['pageToken'] = page_token unless page_token.nil?
10648
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
10649
+ command.query['fields'] = fields unless fields.nil?
10650
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
10651
+ command.query['userIp'] = user_ip unless user_ip.nil?
10652
+ execute_or_queue_command(command, &block)
10653
+ end
10654
+
10655
+ # Updates a global VM extension policy.
10656
+ # @param [String] project
10657
+ # Project ID for this request.
10658
+ # @param [String] global_vm_extension_policy
10659
+ # Name of the global VM extension policy to update.
10660
+ # @param [Google::Apis::ComputeBeta::GlobalVmExtensionPolicy] global_vm_extension_policy_object
10661
+ # @param [String] request_id
10662
+ # An optional request ID to identify requests. Specify a unique request ID so
10663
+ # that if you must retry your request, the server will know to ignore the
10664
+ # request if it has already been completed.
10665
+ # For example, consider a situation where you make an initial request and
10666
+ # the request times out. If you make the request again with the same
10667
+ # request ID, the server can check if original operation with the same
10668
+ # request ID was received, and if so, will ignore the second request. This
10669
+ # prevents clients from accidentally creating duplicate commitments.
10670
+ # The request ID must be
10671
+ # a valid UUID with the exception that zero UUID is not supported
10672
+ # (00000000-0000-0000-0000-000000000000).
10673
+ # @param [String] fields
10674
+ # Selector specifying which fields to include in a partial response.
10675
+ # @param [String] quota_user
10676
+ # Available to use for quota purposes for server-side applications. Can be any
10677
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
10678
+ # @param [String] user_ip
10679
+ # Legacy name for parameter that has been superseded by `quotaUser`.
10680
+ # @param [Google::Apis::RequestOptions] options
10681
+ # Request-specific options
10682
+ #
10683
+ # @yield [result, err] Result & error if block supplied
10684
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
10685
+ # @yieldparam err [StandardError] error object if request failed
10686
+ #
10687
+ # @return [Google::Apis::ComputeBeta::Operation]
10688
+ #
10689
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
10690
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
10691
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
10692
+ def update_global_vm_extension_policy(project, global_vm_extension_policy, global_vm_extension_policy_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
10693
+ command = make_simple_command(:patch, 'projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}', options)
10694
+ command.request_representation = Google::Apis::ComputeBeta::GlobalVmExtensionPolicy::Representation
10695
+ command.request_object = global_vm_extension_policy_object
10696
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
10697
+ command.response_class = Google::Apis::ComputeBeta::Operation
10698
+ command.params['project'] = project unless project.nil?
10699
+ command.params['globalVmExtensionPolicy'] = global_vm_extension_policy unless global_vm_extension_policy.nil?
10700
+ command.query['requestId'] = request_id unless request_id.nil?
10701
+ command.query['fields'] = fields unless fields.nil?
10702
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
10703
+ command.query['userIp'] = user_ip unless user_ip.nil?
10704
+ execute_or_queue_command(command, &block)
10705
+ end
10706
+
10435
10707
  # Retrieves the list of all HealthCheck resources, regional and global,
10436
10708
  # available to the specified project.
10437
10709
  # To prevent failure, Google recommends that you set the
@@ -26528,6 +26800,60 @@ module Google
26528
26800
  execute_or_queue_command(command, &block)
26529
26801
  end
26530
26802
 
26803
+ # Cancel requests to remove a peering from the specified network. Applicable
26804
+ # only for PeeringConnection with update_strategy=CONSENSUS. Cancels a
26805
+ # request to remove a peering from the specified network.
26806
+ # @param [String] project
26807
+ # Project ID for this request.
26808
+ # @param [String] network
26809
+ # Name of the network resource to remove peering from.
26810
+ # @param [Google::Apis::ComputeBeta::NetworksCancelRequestRemovePeeringRequest] networks_cancel_request_remove_peering_request_object
26811
+ # @param [String] request_id
26812
+ # An optional request ID to identify requests. Specify a unique request ID so
26813
+ # that if you must retry your request, the server will know to ignore the
26814
+ # request if it has already been completed.
26815
+ # For example, consider a situation where you make an initial request and
26816
+ # the request times out. If you make the request again with the same
26817
+ # request ID, the server can check if original operation with the same
26818
+ # request ID was received, and if so, will ignore the second request. This
26819
+ # prevents clients from accidentally creating duplicate commitments.
26820
+ # The request ID must be
26821
+ # a valid UUID with the exception that zero UUID is not supported
26822
+ # (00000000-0000-0000-0000-000000000000).
26823
+ # @param [String] fields
26824
+ # Selector specifying which fields to include in a partial response.
26825
+ # @param [String] quota_user
26826
+ # Available to use for quota purposes for server-side applications. Can be any
26827
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
26828
+ # @param [String] user_ip
26829
+ # Legacy name for parameter that has been superseded by `quotaUser`.
26830
+ # @param [Google::Apis::RequestOptions] options
26831
+ # Request-specific options
26832
+ #
26833
+ # @yield [result, err] Result & error if block supplied
26834
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
26835
+ # @yieldparam err [StandardError] error object if request failed
26836
+ #
26837
+ # @return [Google::Apis::ComputeBeta::Operation]
26838
+ #
26839
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
26840
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
26841
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
26842
+ def cancel_network_request_remove_peering(project, network, networks_cancel_request_remove_peering_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
26843
+ command = make_simple_command(:post, 'projects/{project}/global/networks/{network}/cancelRequestRemovePeering', options)
26844
+ command.request_representation = Google::Apis::ComputeBeta::NetworksCancelRequestRemovePeeringRequest::Representation
26845
+ command.request_object = networks_cancel_request_remove_peering_request_object
26846
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
26847
+ command.response_class = Google::Apis::ComputeBeta::Operation
26848
+ command.params['project'] = project unless project.nil?
26849
+ command.params['network'] = network unless network.nil?
26850
+ command.query['requestId'] = request_id unless request_id.nil?
26851
+ command.query['fields'] = fields unless fields.nil?
26852
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
26853
+ command.query['userIp'] = user_ip unless user_ip.nil?
26854
+ execute_or_queue_command(command, &block)
26855
+ end
26856
+
26531
26857
  # Deletes the specified network.
26532
26858
  # @param [String] project
26533
26859
  # Project ID for this request.
@@ -29026,8 +29352,10 @@ module Google
29026
29352
  # This has billing implications. Projects in the hierarchy with effective
29027
29353
  # hierarchical security policies will be automatically enrolled into Cloud
29028
29354
  # Armor Enterprise if not already enrolled.
29029
- # Use of this API to modify firewall policies is deprecated. Use
29030
- # firewallPolicies.addAssociation instead if possible.
29355
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29356
+ # versions of this API were used to modify firewall policies. This usage is
29357
+ # now disabled for most organizations. Use firewallPolicies.addAssociation
29358
+ # instead.
29031
29359
  # @param [String] security_policy
29032
29360
  # Name of the security policy to update.
29033
29361
  # @param [Google::Apis::ComputeBeta::SecurityPolicyAssociation] security_policy_association_object
@@ -29082,6 +29410,9 @@ module Google
29082
29410
  end
29083
29411
 
29084
29412
  # Inserts a rule into a security policy.
29413
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29414
+ # versions of this API were used to modify firewall policies. This usage is
29415
+ # now disabled for most organizations. Use firewallPolicies.addRule instead.
29085
29416
  # @param [String] security_policy
29086
29417
  # Name of the security policy to update.
29087
29418
  # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
@@ -29131,8 +29462,10 @@ module Google
29131
29462
  end
29132
29463
 
29133
29464
  # Copies rules to the specified security policy.
29134
- # Use of this API to modify firewall policies is deprecated. Use
29135
- # firewallPolicies.copyRules instead.
29465
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29466
+ # versions of this API were used to modify firewall policies. This usage is
29467
+ # now disabled for most organizations. Use firewallPolicies.cloneRules
29468
+ # instead.
29136
29469
  # @param [String] security_policy
29137
29470
  # Name of the security policy to update.
29138
29471
  # @param [String] request_id
@@ -29182,8 +29515,9 @@ module Google
29182
29515
  end
29183
29516
 
29184
29517
  # Deletes the specified policy.
29185
- # Use of this API to remove firewall policies is deprecated. Use
29186
- # firewallPolicies.delete instead.
29518
+ # Use this API to remove Cloud Armor policies. Previously, alpha and beta
29519
+ # versions of this API were used to remove firewall policies. This usage is
29520
+ # now disabled for most organizations. Use firewallPolicies.delete instead.
29187
29521
  # @param [String] security_policy
29188
29522
  # Name of the security policy to delete.
29189
29523
  # @param [String] request_id
@@ -29230,8 +29564,9 @@ module Google
29230
29564
  end
29231
29565
 
29232
29566
  # List all of the ordered rules present in a single specified policy.
29233
- # Use of this API to read firewall policies is deprecated. Use
29234
- # firewallPolicies.get instead.
29567
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29568
+ # versions of this API were used to read firewall policies. This usage is now
29569
+ # disabled for most organizations. Use firewallPolicies.get instead.
29235
29570
  # @param [String] security_policy
29236
29571
  # Name of the security policy to get.
29237
29572
  # @param [String] fields
@@ -29265,8 +29600,10 @@ module Google
29265
29600
  end
29266
29601
 
29267
29602
  # Gets an association with the specified name.
29268
- # Use of this API to read firewall policies is deprecated. Use
29269
- # firewallPolicies.getAssociation instead if possible.
29603
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29604
+ # versions of this API were used to read firewall policies. This usage is
29605
+ # now disabled for most organizations. Use firewallPolicies.getAssociation
29606
+ # instead.
29270
29607
  # @param [String] security_policy
29271
29608
  # Name of the security policy to which the queried rule belongs.
29272
29609
  # @param [String] name
@@ -29303,8 +29640,9 @@ module Google
29303
29640
  end
29304
29641
 
29305
29642
  # Gets a rule at the specified priority.
29306
- # Use of this API to read firewall policies is deprecated. Use
29307
- # firewallPolicies.getRule instead.
29643
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29644
+ # versions of this API were used to read firewall policies. This usage is now
29645
+ # disabled for most organizations. Use firewallPolicies.getRule instead.
29308
29646
  # @param [String] security_policy
29309
29647
  # Name of the security policy to which the queried rule belongs.
29310
29648
  # @param [Fixnum] priority
@@ -29342,8 +29680,9 @@ module Google
29342
29680
 
29343
29681
  # Creates a new policy in the specified organization using the data included
29344
29682
  # in the request.
29345
- # Use of this API to insert firewall policies is deprecated. Use
29346
- # firewallPolicies.insert instead.
29683
+ # Use this API to add Cloud Armor policies. Previously, alpha and beta
29684
+ # versions of this API were used to add firewall policies. This usage is now
29685
+ # disabled for most organizations. Use firewallPolicies.insert instead.
29347
29686
  # @param [Google::Apis::ComputeBeta::SecurityPolicy] security_policy_object
29348
29687
  # @param [String] parent_id
29349
29688
  # Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]"
@@ -29396,8 +29735,9 @@ module Google
29396
29735
 
29397
29736
  # List all the policies that have been configured for the specified
29398
29737
  # organization.
29399
- # Use of this API to read firewall policies is deprecated. Use
29400
- # firewallPolicies.list instead.
29738
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29739
+ # versions of this API were used to read firewall policies. This usage is now
29740
+ # disabled for most organizations. Use firewallPolicies.list instead.
29401
29741
  # @param [String] filter
29402
29742
  # A filter expression that filters resources listed in the response. Most
29403
29743
  # Compute resources support two types of filter expressions:
@@ -29512,8 +29852,10 @@ module Google
29512
29852
  end
29513
29853
 
29514
29854
  # Lists associations of a specified target, i.e., organization or folder.
29515
- # Use of this API to read firewall policies is deprecated. Use
29516
- # firewallPolicies.listAssociations instead if possible.
29855
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29856
+ # versions of this API were used to read firewall policies. This usage is
29857
+ # now disabled for most organizations. Use firewallPolicies.listAssociations
29858
+ # instead.
29517
29859
  # @param [String] target_resource
29518
29860
  # The target resource to list associations. It is an organization, or a
29519
29861
  # folder.
@@ -29663,8 +30005,9 @@ module Google
29663
30005
  end
29664
30006
 
29665
30007
  # Moves the specified security policy.
29666
- # Use of this API to modify firewall policies is deprecated. Use
29667
- # firewallPolicies.move instead.
30008
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30009
+ # versions of this API were used to modify firewall policies. This usage is
30010
+ # now disabled for most organizations. Use firewallPolicies.move instead.
29668
30011
  # @param [String] security_policy
29669
30012
  # Name of the security policy to update.
29670
30013
  # @param [String] parent_id
@@ -29714,8 +30057,9 @@ module Google
29714
30057
  end
29715
30058
 
29716
30059
  # Patches the specified policy with the data included in the request.
29717
- # Use of this API to modify firewall policies is deprecated. Use
29718
- # firewallPolicies.patch instead.
30060
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30061
+ # versions of this API were used to modify firewall policies. This usage is
30062
+ # now disabled for most organizations. Use firewallPolicies.patch instead.
29719
30063
  # @param [String] security_policy
29720
30064
  # Name of the security policy to update.
29721
30065
  # @param [Google::Apis::ComputeBeta::SecurityPolicy] security_policy_object
@@ -29768,8 +30112,10 @@ module Google
29768
30112
  end
29769
30113
 
29770
30114
  # Patches a rule at the specified priority.
29771
- # Use of this API to modify firewall policies is deprecated. Use
29772
- # firewallPolicies.patchRule instead.
30115
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30116
+ # versions of this API were used to modify firewall policies. This usage is
30117
+ # now disabled for most organizations. Use firewallPolicies.patchRule
30118
+ # instead.
29773
30119
  # @param [String] security_policy
29774
30120
  # Name of the security policy to update.
29775
30121
  # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
@@ -29825,8 +30171,10 @@ module Google
29825
30171
  end
29826
30172
 
29827
30173
  # Removes an association for the specified security policy.
29828
- # Use of this API to modify firewall policies is deprecated. Use
29829
- # firewallPolicies.removeAssociation instead if possible.
30174
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30175
+ # versions of this API were used to modify firewall policies. This usage is
30176
+ # now disabled for most organizations. Use firewallPolicies.removeAssociation
30177
+ # instead.
29830
30178
  # @param [String] security_policy
29831
30179
  # Name of the security policy to update.
29832
30180
  # @param [String] name
@@ -29876,6 +30224,10 @@ module Google
29876
30224
  end
29877
30225
 
29878
30226
  # Deletes a rule at the specified priority.
30227
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30228
+ # versions of this API were used to modify firewall policies. This usage is
30229
+ # now disabled for most organizations. Use firewallPolicies.removeRule
30230
+ # instead.
29879
30231
  # @param [String] security_policy
29880
30232
  # Name of the security policy to update.
29881
30233
  # @param [Fixnum] priority
@@ -38540,6 +38892,69 @@ module Google
38540
38892
  execute_or_queue_command(command, &block)
38541
38893
  end
38542
38894
 
38895
+ # Flags the specified instances to be adopted to the managed instance
38896
+ # group. Adopting an instance does not change the instance status, but it
38897
+ # adds the instance to any target pools that are applied by the managed
38898
+ # instance group. This method increases the targetSize of the managed
38899
+ # instance group by the number of instances that you adopt. This operation
38900
+ # is marked as DONE when the action is scheduled even if the instances have
38901
+ # not been adopted to the group yet. You must separately verify the status
38902
+ # of the adopting action with the listManagedInstances method.
38903
+ # @param [String] project
38904
+ # Project ID for this request.
38905
+ # @param [String] region
38906
+ # Name of the region scoping this request. It should conform to RFC1035.
38907
+ # @param [String] instance_group_manager
38908
+ # Name of the managed instance group. It should conform to RFC1035 or be a
38909
+ # resource ID.
38910
+ # @param [Google::Apis::ComputeBeta::RegionInstanceGroupManagersAdoptInstancesRequest] region_instance_group_managers_adopt_instances_request_object
38911
+ # @param [String] request_id
38912
+ # An optional request ID to identify requests. Specify a unique request ID so
38913
+ # that if you must retry your request, the server will know to ignore the
38914
+ # request if it has already been completed.
38915
+ # For example, consider a situation where you make an initial request and
38916
+ # the request times out. If you make the request again with the same
38917
+ # request ID, the server can check if original operation with the same
38918
+ # request ID was received, and if so, will ignore the second request. This
38919
+ # prevents clients from accidentally creating duplicate commitments.
38920
+ # The request ID must be
38921
+ # a valid UUID with the exception that zero UUID is not supported
38922
+ # (00000000-0000-0000-0000-000000000000).
38923
+ # @param [String] fields
38924
+ # Selector specifying which fields to include in a partial response.
38925
+ # @param [String] quota_user
38926
+ # Available to use for quota purposes for server-side applications. Can be any
38927
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
38928
+ # @param [String] user_ip
38929
+ # Legacy name for parameter that has been superseded by `quotaUser`.
38930
+ # @param [Google::Apis::RequestOptions] options
38931
+ # Request-specific options
38932
+ #
38933
+ # @yield [result, err] Result & error if block supplied
38934
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
38935
+ # @yieldparam err [StandardError] error object if request failed
38936
+ #
38937
+ # @return [Google::Apis::ComputeBeta::Operation]
38938
+ #
38939
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
38940
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
38941
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
38942
+ def adopt_region_instance_group_manager_instances(project, region, instance_group_manager, region_instance_group_managers_adopt_instances_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
38943
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/adoptInstances', options)
38944
+ command.request_representation = Google::Apis::ComputeBeta::RegionInstanceGroupManagersAdoptInstancesRequest::Representation
38945
+ command.request_object = region_instance_group_managers_adopt_instances_request_object
38946
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
38947
+ command.response_class = Google::Apis::ComputeBeta::Operation
38948
+ command.params['project'] = project unless project.nil?
38949
+ command.params['region'] = region unless region.nil?
38950
+ command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
38951
+ command.query['requestId'] = request_id unless request_id.nil?
38952
+ command.query['fields'] = fields unless fields.nil?
38953
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
38954
+ command.query['userIp'] = user_ip unless user_ip.nil?
38955
+ execute_or_queue_command(command, &block)
38956
+ end
38957
+
38543
38958
  # Apply updates to selected instances the managed instance group.
38544
38959
  # @param [String] project
38545
38960
  # Project ID for this request.
@@ -50488,6 +50903,509 @@ module Google
50488
50903
  execute_or_queue_command(command, &block)
50489
50904
  end
50490
50905
 
50906
+ # Deletes a RolloutPlan.
50907
+ # @param [String] project
50908
+ # Project ID for this request.
50909
+ # @param [String] rollout_plan
50910
+ # Name of the RolloutPlan resource to delete.
50911
+ # @param [String] request_id
50912
+ # An optional request ID to identify requests. Specify a unique request ID so
50913
+ # that if you must retry your request, the server will know to ignore the
50914
+ # request if it has already been completed.
50915
+ # For example, consider a situation where you make an initial request and
50916
+ # the request times out. If you make the request again with the same
50917
+ # request ID, the server can check if original operation with the same
50918
+ # request ID was received, and if so, will ignore the second request. This
50919
+ # prevents clients from accidentally creating duplicate commitments.
50920
+ # The request ID must be
50921
+ # a valid UUID with the exception that zero UUID is not supported
50922
+ # (00000000-0000-0000-0000-000000000000).
50923
+ # @param [String] fields
50924
+ # Selector specifying which fields to include in a partial response.
50925
+ # @param [String] quota_user
50926
+ # Available to use for quota purposes for server-side applications. Can be any
50927
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
50928
+ # @param [String] user_ip
50929
+ # Legacy name for parameter that has been superseded by `quotaUser`.
50930
+ # @param [Google::Apis::RequestOptions] options
50931
+ # Request-specific options
50932
+ #
50933
+ # @yield [result, err] Result & error if block supplied
50934
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
50935
+ # @yieldparam err [StandardError] error object if request failed
50936
+ #
50937
+ # @return [Google::Apis::ComputeBeta::Operation]
50938
+ #
50939
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
50940
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
50941
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
50942
+ def delete_rollout_plan(project, rollout_plan, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
50943
+ command = make_simple_command(:delete, 'projects/{project}/global/rolloutPlans/{rolloutPlan}', options)
50944
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
50945
+ command.response_class = Google::Apis::ComputeBeta::Operation
50946
+ command.params['project'] = project unless project.nil?
50947
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
50948
+ command.query['requestId'] = request_id unless request_id.nil?
50949
+ command.query['fields'] = fields unless fields.nil?
50950
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
50951
+ command.query['userIp'] = user_ip unless user_ip.nil?
50952
+ execute_or_queue_command(command, &block)
50953
+ end
50954
+
50955
+ # Gets details of a single project-scoped RolloutPlan.
50956
+ # @param [String] project
50957
+ # Project ID for this request.
50958
+ # @param [String] rollout_plan
50959
+ # Name of the persistent rollout plan to return.
50960
+ # @param [String] fields
50961
+ # Selector specifying which fields to include in a partial response.
50962
+ # @param [String] quota_user
50963
+ # Available to use for quota purposes for server-side applications. Can be any
50964
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
50965
+ # @param [String] user_ip
50966
+ # Legacy name for parameter that has been superseded by `quotaUser`.
50967
+ # @param [Google::Apis::RequestOptions] options
50968
+ # Request-specific options
50969
+ #
50970
+ # @yield [result, err] Result & error if block supplied
50971
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlan] parsed result object
50972
+ # @yieldparam err [StandardError] error object if request failed
50973
+ #
50974
+ # @return [Google::Apis::ComputeBeta::RolloutPlan]
50975
+ #
50976
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
50977
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
50978
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
50979
+ def get_rollout_plan(project, rollout_plan, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
50980
+ command = make_simple_command(:get, 'projects/{project}/global/rolloutPlans/{rolloutPlan}', options)
50981
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
50982
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlan
50983
+ command.params['project'] = project unless project.nil?
50984
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
50985
+ command.query['fields'] = fields unless fields.nil?
50986
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
50987
+ command.query['userIp'] = user_ip unless user_ip.nil?
50988
+ execute_or_queue_command(command, &block)
50989
+ end
50990
+
50991
+ # Creates a new RolloutPlan in a given project and location.
50992
+ # @param [String] project
50993
+ # Project ID for this request.
50994
+ # @param [Google::Apis::ComputeBeta::RolloutPlan] rollout_plan_object
50995
+ # @param [String] request_id
50996
+ # An optional request ID to identify requests. Specify a unique request ID so
50997
+ # that if you must retry your request, the server will know to ignore the
50998
+ # request if it has already been completed.
50999
+ # For example, consider a situation where you make an initial request and
51000
+ # the request times out. If you make the request again with the same
51001
+ # request ID, the server can check if original operation with the same
51002
+ # request ID was received, and if so, will ignore the second request. This
51003
+ # prevents clients from accidentally creating duplicate commitments.
51004
+ # The request ID must be
51005
+ # a valid UUID with the exception that zero UUID is not supported
51006
+ # (00000000-0000-0000-0000-000000000000).
51007
+ # @param [String] fields
51008
+ # Selector specifying which fields to include in a partial response.
51009
+ # @param [String] quota_user
51010
+ # Available to use for quota purposes for server-side applications. Can be any
51011
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51012
+ # @param [String] user_ip
51013
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51014
+ # @param [Google::Apis::RequestOptions] options
51015
+ # Request-specific options
51016
+ #
51017
+ # @yield [result, err] Result & error if block supplied
51018
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
51019
+ # @yieldparam err [StandardError] error object if request failed
51020
+ #
51021
+ # @return [Google::Apis::ComputeBeta::Operation]
51022
+ #
51023
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51024
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51025
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51026
+ def insert_rollout_plan(project, rollout_plan_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51027
+ command = make_simple_command(:post, 'projects/{project}/global/rolloutPlans', options)
51028
+ command.request_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
51029
+ command.request_object = rollout_plan_object
51030
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
51031
+ command.response_class = Google::Apis::ComputeBeta::Operation
51032
+ command.params['project'] = project unless project.nil?
51033
+ command.query['requestId'] = request_id unless request_id.nil?
51034
+ command.query['fields'] = fields unless fields.nil?
51035
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51036
+ command.query['userIp'] = user_ip unless user_ip.nil?
51037
+ execute_or_queue_command(command, &block)
51038
+ end
51039
+
51040
+ # Lists RolloutPlans in a given project and location.
51041
+ # @param [String] project
51042
+ # Project ID for this request.
51043
+ # @param [String] filter
51044
+ # A filter expression that filters resources listed in the response. Most
51045
+ # Compute resources support two types of filter expressions:
51046
+ # expressions that support regular expressions and expressions that follow
51047
+ # API improvement proposal AIP-160.
51048
+ # These two types of filter expressions cannot be mixed in one request.
51049
+ # If you want to use AIP-160, your expression must specify the field name, an
51050
+ # operator, and the value that you want to use for filtering. The value
51051
+ # must be a string, a number, or a boolean. The operator
51052
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
51053
+ # For example, if you are filtering Compute Engine instances, you can
51054
+ # exclude instances named `example-instance` by specifying
51055
+ # `name != example-instance`.
51056
+ # The `:*` comparison can be used to test whether a key has been defined.
51057
+ # For example, to find all objects with `owner` label use:
51058
+ # ```
51059
+ # labels.owner:*
51060
+ # ```
51061
+ # You can also filter nested fields. For example, you could specify
51062
+ # `scheduling.automaticRestart = false` to include instances only
51063
+ # if they are not scheduled for automatic restarts. You can use filtering
51064
+ # on nested fields to filter based onresource labels.
51065
+ # To filter on multiple expressions, provide each separate expression within
51066
+ # parentheses. For example:
51067
+ # ```
51068
+ # (scheduling.automaticRestart = true)
51069
+ # (cpuPlatform = "Intel Skylake")
51070
+ # ```
51071
+ # By default, each expression is an `AND` expression. However, you
51072
+ # can include `AND` and `OR` expressions explicitly.
51073
+ # For example:
51074
+ # ```
51075
+ # (cpuPlatform = "Intel Skylake") OR
51076
+ # (cpuPlatform = "Intel Broadwell") AND
51077
+ # (scheduling.automaticRestart = true)
51078
+ # ```
51079
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
51080
+ # (not equal) operator against a single un-parenthesized expression with or
51081
+ # without quotes or against multiple parenthesized expressions. Examples:
51082
+ # `fieldname eq unquoted literal`
51083
+ # `fieldname eq 'single quoted literal'`
51084
+ # `fieldname eq "double quoted literal"`
51085
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
51086
+ # The literal value is interpreted as a regular expression using GoogleRE2
51087
+ # library syntax.
51088
+ # The literal value must match the entire field.
51089
+ # For example, to filter for instances that do not end with name "instance",
51090
+ # you would use `name ne .*instance`.
51091
+ # You cannot combine constraints on multiple fields using regular
51092
+ # expressions.
51093
+ # @param [Fixnum] max_results
51094
+ # The maximum number of results per page that should be returned.
51095
+ # If the number of available results is larger than `maxResults`,
51096
+ # Compute Engine returns a `nextPageToken` that can be used to get
51097
+ # the next page of results in subsequent list requests. Acceptable values are
51098
+ # `0` to `500`, inclusive. (Default: `500`)
51099
+ # @param [String] order_by
51100
+ # Sorts list results by a certain order. By default, results
51101
+ # are returned in alphanumerical order based on the resource name.
51102
+ # You can also sort results in descending order based on the creation
51103
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
51104
+ # results based on the `creationTimestamp` field in
51105
+ # reverse chronological order (newest result first). Use this to sort
51106
+ # resources like operations so that the newest operation is returned first.
51107
+ # Currently, only sorting by `name` or
51108
+ # `creationTimestamp desc` is supported.
51109
+ # @param [String] page_token
51110
+ # Specifies a page token to use. Set `pageToken` to the
51111
+ # `nextPageToken` returned by a previous list request to get
51112
+ # the next page of results.
51113
+ # @param [Boolean] return_partial_success
51114
+ # Opt-in for partial success behavior which provides partial results in case
51115
+ # of failure. The default value is false.
51116
+ # For example, when partial success behavior is enabled, aggregatedList for a
51117
+ # single zone scope either returns all resources in the zone or no resources,
51118
+ # with an error code.
51119
+ # @param [String] fields
51120
+ # Selector specifying which fields to include in a partial response.
51121
+ # @param [String] quota_user
51122
+ # Available to use for quota purposes for server-side applications. Can be any
51123
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51124
+ # @param [String] user_ip
51125
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51126
+ # @param [Google::Apis::RequestOptions] options
51127
+ # Request-specific options
51128
+ #
51129
+ # @yield [result, err] Result & error if block supplied
51130
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlansListResponse] parsed result object
51131
+ # @yieldparam err [StandardError] error object if request failed
51132
+ #
51133
+ # @return [Google::Apis::ComputeBeta::RolloutPlansListResponse]
51134
+ #
51135
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51136
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51137
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51138
+ def list_rollout_plans(project, 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)
51139
+ command = make_simple_command(:get, 'projects/{project}/global/rolloutPlans', options)
51140
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlansListResponse::Representation
51141
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlansListResponse
51142
+ command.params['project'] = project unless project.nil?
51143
+ command.query['filter'] = filter unless filter.nil?
51144
+ command.query['maxResults'] = max_results unless max_results.nil?
51145
+ command.query['orderBy'] = order_by unless order_by.nil?
51146
+ command.query['pageToken'] = page_token unless page_token.nil?
51147
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
51148
+ command.query['fields'] = fields unless fields.nil?
51149
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51150
+ command.query['userIp'] = user_ip unless user_ip.nil?
51151
+ execute_or_queue_command(command, &block)
51152
+ end
51153
+
51154
+ # Cancels a Rollout.
51155
+ # @param [String] project
51156
+ # Project ID for this request.
51157
+ # @param [String] rollout
51158
+ # Name of the Rollout resource to cancel.
51159
+ # @param [String] request_id
51160
+ # An optional request ID to identify requests. Specify a unique request ID so
51161
+ # that if you must retry your request, the server will know to ignore the
51162
+ # request if it has already been completed.
51163
+ # For example, consider a situation where you make an initial request and
51164
+ # the request times out. If you make the request again with the same
51165
+ # request ID, the server can check if original operation with the same
51166
+ # request ID was received, and if so, will ignore the second request. This
51167
+ # prevents clients from accidentally creating duplicate commitments.
51168
+ # The request ID must be
51169
+ # a valid UUID with the exception that zero UUID is not supported
51170
+ # (00000000-0000-0000-0000-000000000000).
51171
+ # @param [Boolean] rollback
51172
+ # Optional. If true, then the ongoing rollout must be rolled back. Else, just
51173
+ # cancel
51174
+ # the rollout without taking any further actions. Note that products must
51175
+ # support at least one of these options, however, it does not need to support
51176
+ # both.
51177
+ # @param [String] fields
51178
+ # Selector specifying which fields to include in a partial response.
51179
+ # @param [String] quota_user
51180
+ # Available to use for quota purposes for server-side applications. Can be any
51181
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51182
+ # @param [String] user_ip
51183
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51184
+ # @param [Google::Apis::RequestOptions] options
51185
+ # Request-specific options
51186
+ #
51187
+ # @yield [result, err] Result & error if block supplied
51188
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
51189
+ # @yieldparam err [StandardError] error object if request failed
51190
+ #
51191
+ # @return [Google::Apis::ComputeBeta::Operation]
51192
+ #
51193
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51194
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51195
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51196
+ def cancel_rollout(project, rollout, request_id: nil, rollback: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51197
+ command = make_simple_command(:patch, 'projects/{project}/global/rollouts/{rollout}', options)
51198
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
51199
+ command.response_class = Google::Apis::ComputeBeta::Operation
51200
+ command.params['project'] = project unless project.nil?
51201
+ command.params['rollout'] = rollout unless rollout.nil?
51202
+ command.query['requestId'] = request_id unless request_id.nil?
51203
+ command.query['rollback'] = rollback unless rollback.nil?
51204
+ command.query['fields'] = fields unless fields.nil?
51205
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51206
+ command.query['userIp'] = user_ip unless user_ip.nil?
51207
+ execute_or_queue_command(command, &block)
51208
+ end
51209
+
51210
+ # Deletes a Rollout.
51211
+ # @param [String] project
51212
+ # Project ID for this request.
51213
+ # @param [String] rollout
51214
+ # Name of the Rollout resource to delete.
51215
+ # @param [String] request_id
51216
+ # An optional request ID to identify requests. Specify a unique request ID so
51217
+ # that if you must retry your request, the server will know to ignore the
51218
+ # request if it has already been completed.
51219
+ # For example, consider a situation where you make an initial request and
51220
+ # the request times out. If you make the request again with the same
51221
+ # request ID, the server can check if original operation with the same
51222
+ # request ID was received, and if so, will ignore the second request. This
51223
+ # prevents clients from accidentally creating duplicate commitments.
51224
+ # The request ID must be
51225
+ # a valid UUID with the exception that zero UUID is not supported
51226
+ # (00000000-0000-0000-0000-000000000000).
51227
+ # @param [String] fields
51228
+ # Selector specifying which fields to include in a partial response.
51229
+ # @param [String] quota_user
51230
+ # Available to use for quota purposes for server-side applications. Can be any
51231
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51232
+ # @param [String] user_ip
51233
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51234
+ # @param [Google::Apis::RequestOptions] options
51235
+ # Request-specific options
51236
+ #
51237
+ # @yield [result, err] Result & error if block supplied
51238
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
51239
+ # @yieldparam err [StandardError] error object if request failed
51240
+ #
51241
+ # @return [Google::Apis::ComputeBeta::Operation]
51242
+ #
51243
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51244
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51245
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51246
+ def delete_rollout(project, rollout, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51247
+ command = make_simple_command(:delete, 'projects/{project}/global/rollouts/{rollout}', options)
51248
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
51249
+ command.response_class = Google::Apis::ComputeBeta::Operation
51250
+ command.params['project'] = project unless project.nil?
51251
+ command.params['rollout'] = rollout unless rollout.nil?
51252
+ command.query['requestId'] = request_id unless request_id.nil?
51253
+ command.query['fields'] = fields unless fields.nil?
51254
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51255
+ command.query['userIp'] = user_ip unless user_ip.nil?
51256
+ execute_or_queue_command(command, &block)
51257
+ end
51258
+
51259
+ # Gets details of a single project-scoped Rollout.
51260
+ # @param [String] project
51261
+ # Project ID for this request.
51262
+ # @param [String] rollout
51263
+ # Name of the persistent rollout to return.
51264
+ # @param [String] fields
51265
+ # Selector specifying which fields to include in a partial response.
51266
+ # @param [String] quota_user
51267
+ # Available to use for quota purposes for server-side applications. Can be any
51268
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51269
+ # @param [String] user_ip
51270
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51271
+ # @param [Google::Apis::RequestOptions] options
51272
+ # Request-specific options
51273
+ #
51274
+ # @yield [result, err] Result & error if block supplied
51275
+ # @yieldparam result [Google::Apis::ComputeBeta::Rollout] parsed result object
51276
+ # @yieldparam err [StandardError] error object if request failed
51277
+ #
51278
+ # @return [Google::Apis::ComputeBeta::Rollout]
51279
+ #
51280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51283
+ def get_rollout(project, rollout, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51284
+ command = make_simple_command(:get, 'projects/{project}/global/rollouts/{rollout}', options)
51285
+ command.response_representation = Google::Apis::ComputeBeta::Rollout::Representation
51286
+ command.response_class = Google::Apis::ComputeBeta::Rollout
51287
+ command.params['project'] = project unless project.nil?
51288
+ command.params['rollout'] = rollout unless rollout.nil?
51289
+ command.query['fields'] = fields unless fields.nil?
51290
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51291
+ command.query['userIp'] = user_ip unless user_ip.nil?
51292
+ execute_or_queue_command(command, &block)
51293
+ end
51294
+
51295
+ # Lists Rollouts in a given project and location.
51296
+ # @param [String] project
51297
+ # Project ID for this request.
51298
+ # @param [String] filter
51299
+ # A filter expression that filters resources listed in the response. Most
51300
+ # Compute resources support two types of filter expressions:
51301
+ # expressions that support regular expressions and expressions that follow
51302
+ # API improvement proposal AIP-160.
51303
+ # These two types of filter expressions cannot be mixed in one request.
51304
+ # If you want to use AIP-160, your expression must specify the field name, an
51305
+ # operator, and the value that you want to use for filtering. The value
51306
+ # must be a string, a number, or a boolean. The operator
51307
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
51308
+ # For example, if you are filtering Compute Engine instances, you can
51309
+ # exclude instances named `example-instance` by specifying
51310
+ # `name != example-instance`.
51311
+ # The `:*` comparison can be used to test whether a key has been defined.
51312
+ # For example, to find all objects with `owner` label use:
51313
+ # ```
51314
+ # labels.owner:*
51315
+ # ```
51316
+ # You can also filter nested fields. For example, you could specify
51317
+ # `scheduling.automaticRestart = false` to include instances only
51318
+ # if they are not scheduled for automatic restarts. You can use filtering
51319
+ # on nested fields to filter based onresource labels.
51320
+ # To filter on multiple expressions, provide each separate expression within
51321
+ # parentheses. For example:
51322
+ # ```
51323
+ # (scheduling.automaticRestart = true)
51324
+ # (cpuPlatform = "Intel Skylake")
51325
+ # ```
51326
+ # By default, each expression is an `AND` expression. However, you
51327
+ # can include `AND` and `OR` expressions explicitly.
51328
+ # For example:
51329
+ # ```
51330
+ # (cpuPlatform = "Intel Skylake") OR
51331
+ # (cpuPlatform = "Intel Broadwell") AND
51332
+ # (scheduling.automaticRestart = true)
51333
+ # ```
51334
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
51335
+ # (not equal) operator against a single un-parenthesized expression with or
51336
+ # without quotes or against multiple parenthesized expressions. Examples:
51337
+ # `fieldname eq unquoted literal`
51338
+ # `fieldname eq 'single quoted literal'`
51339
+ # `fieldname eq "double quoted literal"`
51340
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
51341
+ # The literal value is interpreted as a regular expression using GoogleRE2
51342
+ # library syntax.
51343
+ # The literal value must match the entire field.
51344
+ # For example, to filter for instances that do not end with name "instance",
51345
+ # you would use `name ne .*instance`.
51346
+ # You cannot combine constraints on multiple fields using regular
51347
+ # expressions.
51348
+ # @param [Fixnum] max_results
51349
+ # The maximum number of results per page that should be returned.
51350
+ # If the number of available results is larger than `maxResults`,
51351
+ # Compute Engine returns a `nextPageToken` that can be used to get
51352
+ # the next page of results in subsequent list requests. Acceptable values are
51353
+ # `0` to `500`, inclusive. (Default: `500`)
51354
+ # @param [String] order_by
51355
+ # Sorts list results by a certain order. By default, results
51356
+ # are returned in alphanumerical order based on the resource name.
51357
+ # You can also sort results in descending order based on the creation
51358
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
51359
+ # results based on the `creationTimestamp` field in
51360
+ # reverse chronological order (newest result first). Use this to sort
51361
+ # resources like operations so that the newest operation is returned first.
51362
+ # Currently, only sorting by `name` or
51363
+ # `creationTimestamp desc` is supported.
51364
+ # @param [String] page_token
51365
+ # Specifies a page token to use. Set `pageToken` to the
51366
+ # `nextPageToken` returned by a previous list request to get
51367
+ # the next page of results.
51368
+ # @param [Boolean] return_partial_success
51369
+ # Opt-in for partial success behavior which provides partial results in case
51370
+ # of failure. The default value is false.
51371
+ # For example, when partial success behavior is enabled, aggregatedList for a
51372
+ # single zone scope either returns all resources in the zone or no resources,
51373
+ # with an error code.
51374
+ # @param [String] fields
51375
+ # Selector specifying which fields to include in a partial response.
51376
+ # @param [String] quota_user
51377
+ # Available to use for quota purposes for server-side applications. Can be any
51378
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51379
+ # @param [String] user_ip
51380
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51381
+ # @param [Google::Apis::RequestOptions] options
51382
+ # Request-specific options
51383
+ #
51384
+ # @yield [result, err] Result & error if block supplied
51385
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutsListResponse] parsed result object
51386
+ # @yieldparam err [StandardError] error object if request failed
51387
+ #
51388
+ # @return [Google::Apis::ComputeBeta::RolloutsListResponse]
51389
+ #
51390
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51391
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51392
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51393
+ def list_rollouts(project, 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)
51394
+ command = make_simple_command(:get, 'projects/{project}/global/rollouts', options)
51395
+ command.response_representation = Google::Apis::ComputeBeta::RolloutsListResponse::Representation
51396
+ command.response_class = Google::Apis::ComputeBeta::RolloutsListResponse
51397
+ command.params['project'] = project unless project.nil?
51398
+ command.query['filter'] = filter unless filter.nil?
51399
+ command.query['maxResults'] = max_results unless max_results.nil?
51400
+ command.query['orderBy'] = order_by unless order_by.nil?
51401
+ command.query['pageToken'] = page_token unless page_token.nil?
51402
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
51403
+ command.query['fields'] = fields unless fields.nil?
51404
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51405
+ command.query['userIp'] = user_ip unless user_ip.nil?
51406
+ execute_or_queue_command(command, &block)
51407
+ end
51408
+
50491
51409
  # Retrieves an aggregated list of routers.
50492
51410
  # To prevent failure, Google recommends that you set the
50493
51411
  # `returnPartialSuccess` parameter to `true`.