google-apis-compute_beta 0.126.0 → 0.127.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
@@ -29026,8 +29298,10 @@ module Google
29026
29298
  # This has billing implications. Projects in the hierarchy with effective
29027
29299
  # hierarchical security policies will be automatically enrolled into Cloud
29028
29300
  # Armor Enterprise if not already enrolled.
29029
- # Use of this API to modify firewall policies is deprecated. Use
29030
- # firewallPolicies.addAssociation instead if possible.
29301
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29302
+ # versions of this API were used to modify firewall policies. This usage is
29303
+ # now disabled for most organizations. Use firewallPolicies.addAssociation
29304
+ # instead.
29031
29305
  # @param [String] security_policy
29032
29306
  # Name of the security policy to update.
29033
29307
  # @param [Google::Apis::ComputeBeta::SecurityPolicyAssociation] security_policy_association_object
@@ -29082,6 +29356,9 @@ module Google
29082
29356
  end
29083
29357
 
29084
29358
  # Inserts a rule into a security policy.
29359
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29360
+ # versions of this API were used to modify firewall policies. This usage is
29361
+ # now disabled for most organizations. Use firewallPolicies.addRule instead.
29085
29362
  # @param [String] security_policy
29086
29363
  # Name of the security policy to update.
29087
29364
  # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
@@ -29131,8 +29408,10 @@ module Google
29131
29408
  end
29132
29409
 
29133
29410
  # Copies rules to the specified security policy.
29134
- # Use of this API to modify firewall policies is deprecated. Use
29135
- # firewallPolicies.copyRules instead.
29411
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29412
+ # versions of this API were used to modify firewall policies. This usage is
29413
+ # now disabled for most organizations. Use firewallPolicies.cloneRules
29414
+ # instead.
29136
29415
  # @param [String] security_policy
29137
29416
  # Name of the security policy to update.
29138
29417
  # @param [String] request_id
@@ -29182,8 +29461,9 @@ module Google
29182
29461
  end
29183
29462
 
29184
29463
  # Deletes the specified policy.
29185
- # Use of this API to remove firewall policies is deprecated. Use
29186
- # firewallPolicies.delete instead.
29464
+ # Use this API to remove Cloud Armor policies. Previously, alpha and beta
29465
+ # versions of this API were used to remove firewall policies. This usage is
29466
+ # now disabled for most organizations. Use firewallPolicies.delete instead.
29187
29467
  # @param [String] security_policy
29188
29468
  # Name of the security policy to delete.
29189
29469
  # @param [String] request_id
@@ -29230,8 +29510,9 @@ module Google
29230
29510
  end
29231
29511
 
29232
29512
  # 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.
29513
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29514
+ # versions of this API were used to read firewall policies. This usage is now
29515
+ # disabled for most organizations. Use firewallPolicies.get instead.
29235
29516
  # @param [String] security_policy
29236
29517
  # Name of the security policy to get.
29237
29518
  # @param [String] fields
@@ -29265,8 +29546,10 @@ module Google
29265
29546
  end
29266
29547
 
29267
29548
  # 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.
29549
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29550
+ # versions of this API were used to read firewall policies. This usage is
29551
+ # now disabled for most organizations. Use firewallPolicies.getAssociation
29552
+ # instead.
29270
29553
  # @param [String] security_policy
29271
29554
  # Name of the security policy to which the queried rule belongs.
29272
29555
  # @param [String] name
@@ -29303,8 +29586,9 @@ module Google
29303
29586
  end
29304
29587
 
29305
29588
  # Gets a rule at the specified priority.
29306
- # Use of this API to read firewall policies is deprecated. Use
29307
- # firewallPolicies.getRule instead.
29589
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29590
+ # versions of this API were used to read firewall policies. This usage is now
29591
+ # disabled for most organizations. Use firewallPolicies.getRule instead.
29308
29592
  # @param [String] security_policy
29309
29593
  # Name of the security policy to which the queried rule belongs.
29310
29594
  # @param [Fixnum] priority
@@ -29342,8 +29626,9 @@ module Google
29342
29626
 
29343
29627
  # Creates a new policy in the specified organization using the data included
29344
29628
  # in the request.
29345
- # Use of this API to insert firewall policies is deprecated. Use
29346
- # firewallPolicies.insert instead.
29629
+ # Use this API to add Cloud Armor policies. Previously, alpha and beta
29630
+ # versions of this API were used to add firewall policies. This usage is now
29631
+ # disabled for most organizations. Use firewallPolicies.insert instead.
29347
29632
  # @param [Google::Apis::ComputeBeta::SecurityPolicy] security_policy_object
29348
29633
  # @param [String] parent_id
29349
29634
  # Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]"
@@ -29396,8 +29681,9 @@ module Google
29396
29681
 
29397
29682
  # List all the policies that have been configured for the specified
29398
29683
  # organization.
29399
- # Use of this API to read firewall policies is deprecated. Use
29400
- # firewallPolicies.list instead.
29684
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29685
+ # versions of this API were used to read firewall policies. This usage is now
29686
+ # disabled for most organizations. Use firewallPolicies.list instead.
29401
29687
  # @param [String] filter
29402
29688
  # A filter expression that filters resources listed in the response. Most
29403
29689
  # Compute resources support two types of filter expressions:
@@ -29512,8 +29798,10 @@ module Google
29512
29798
  end
29513
29799
 
29514
29800
  # 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.
29801
+ # Use this API to read Cloud Armor policies. Previously, alpha and beta
29802
+ # versions of this API were used to read firewall policies. This usage is
29803
+ # now disabled for most organizations. Use firewallPolicies.listAssociations
29804
+ # instead.
29517
29805
  # @param [String] target_resource
29518
29806
  # The target resource to list associations. It is an organization, or a
29519
29807
  # folder.
@@ -29663,8 +29951,9 @@ module Google
29663
29951
  end
29664
29952
 
29665
29953
  # Moves the specified security policy.
29666
- # Use of this API to modify firewall policies is deprecated. Use
29667
- # firewallPolicies.move instead.
29954
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
29955
+ # versions of this API were used to modify firewall policies. This usage is
29956
+ # now disabled for most organizations. Use firewallPolicies.move instead.
29668
29957
  # @param [String] security_policy
29669
29958
  # Name of the security policy to update.
29670
29959
  # @param [String] parent_id
@@ -29714,8 +30003,9 @@ module Google
29714
30003
  end
29715
30004
 
29716
30005
  # 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.
30006
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30007
+ # versions of this API were used to modify firewall policies. This usage is
30008
+ # now disabled for most organizations. Use firewallPolicies.patch instead.
29719
30009
  # @param [String] security_policy
29720
30010
  # Name of the security policy to update.
29721
30011
  # @param [Google::Apis::ComputeBeta::SecurityPolicy] security_policy_object
@@ -29768,8 +30058,10 @@ module Google
29768
30058
  end
29769
30059
 
29770
30060
  # Patches a rule at the specified priority.
29771
- # Use of this API to modify firewall policies is deprecated. Use
29772
- # firewallPolicies.patchRule instead.
30061
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30062
+ # versions of this API were used to modify firewall policies. This usage is
30063
+ # now disabled for most organizations. Use firewallPolicies.patchRule
30064
+ # instead.
29773
30065
  # @param [String] security_policy
29774
30066
  # Name of the security policy to update.
29775
30067
  # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
@@ -29825,8 +30117,10 @@ module Google
29825
30117
  end
29826
30118
 
29827
30119
  # 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.
30120
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30121
+ # versions of this API were used to modify firewall policies. This usage is
30122
+ # now disabled for most organizations. Use firewallPolicies.removeAssociation
30123
+ # instead.
29830
30124
  # @param [String] security_policy
29831
30125
  # Name of the security policy to update.
29832
30126
  # @param [String] name
@@ -29876,6 +30170,10 @@ module Google
29876
30170
  end
29877
30171
 
29878
30172
  # Deletes a rule at the specified priority.
30173
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30174
+ # versions of this API were used to modify firewall policies. This usage is
30175
+ # now disabled for most organizations. Use firewallPolicies.removeRule
30176
+ # instead.
29879
30177
  # @param [String] security_policy
29880
30178
  # Name of the security policy to update.
29881
30179
  # @param [Fixnum] priority
@@ -50488,6 +50786,509 @@ module Google
50488
50786
  execute_or_queue_command(command, &block)
50489
50787
  end
50490
50788
 
50789
+ # Deletes a RolloutPlan.
50790
+ # @param [String] project
50791
+ # Project ID for this request.
50792
+ # @param [String] rollout_plan
50793
+ # Name of the RolloutPlan resource to delete.
50794
+ # @param [String] request_id
50795
+ # An optional request ID to identify requests. Specify a unique request ID so
50796
+ # that if you must retry your request, the server will know to ignore the
50797
+ # request if it has already been completed.
50798
+ # For example, consider a situation where you make an initial request and
50799
+ # the request times out. If you make the request again with the same
50800
+ # request ID, the server can check if original operation with the same
50801
+ # request ID was received, and if so, will ignore the second request. This
50802
+ # prevents clients from accidentally creating duplicate commitments.
50803
+ # The request ID must be
50804
+ # a valid UUID with the exception that zero UUID is not supported
50805
+ # (00000000-0000-0000-0000-000000000000).
50806
+ # @param [String] fields
50807
+ # Selector specifying which fields to include in a partial response.
50808
+ # @param [String] quota_user
50809
+ # Available to use for quota purposes for server-side applications. Can be any
50810
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
50811
+ # @param [String] user_ip
50812
+ # Legacy name for parameter that has been superseded by `quotaUser`.
50813
+ # @param [Google::Apis::RequestOptions] options
50814
+ # Request-specific options
50815
+ #
50816
+ # @yield [result, err] Result & error if block supplied
50817
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
50818
+ # @yieldparam err [StandardError] error object if request failed
50819
+ #
50820
+ # @return [Google::Apis::ComputeBeta::Operation]
50821
+ #
50822
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
50823
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
50824
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
50825
+ def delete_rollout_plan(project, rollout_plan, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
50826
+ command = make_simple_command(:delete, 'projects/{project}/global/rolloutPlans/{rolloutPlan}', options)
50827
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
50828
+ command.response_class = Google::Apis::ComputeBeta::Operation
50829
+ command.params['project'] = project unless project.nil?
50830
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
50831
+ command.query['requestId'] = request_id unless request_id.nil?
50832
+ command.query['fields'] = fields unless fields.nil?
50833
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
50834
+ command.query['userIp'] = user_ip unless user_ip.nil?
50835
+ execute_or_queue_command(command, &block)
50836
+ end
50837
+
50838
+ # Gets details of a single project-scoped RolloutPlan.
50839
+ # @param [String] project
50840
+ # Project ID for this request.
50841
+ # @param [String] rollout_plan
50842
+ # Name of the persistent rollout plan to return.
50843
+ # @param [String] fields
50844
+ # Selector specifying which fields to include in a partial response.
50845
+ # @param [String] quota_user
50846
+ # Available to use for quota purposes for server-side applications. Can be any
50847
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
50848
+ # @param [String] user_ip
50849
+ # Legacy name for parameter that has been superseded by `quotaUser`.
50850
+ # @param [Google::Apis::RequestOptions] options
50851
+ # Request-specific options
50852
+ #
50853
+ # @yield [result, err] Result & error if block supplied
50854
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlan] parsed result object
50855
+ # @yieldparam err [StandardError] error object if request failed
50856
+ #
50857
+ # @return [Google::Apis::ComputeBeta::RolloutPlan]
50858
+ #
50859
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
50860
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
50861
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
50862
+ def get_rollout_plan(project, rollout_plan, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
50863
+ command = make_simple_command(:get, 'projects/{project}/global/rolloutPlans/{rolloutPlan}', options)
50864
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
50865
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlan
50866
+ command.params['project'] = project unless project.nil?
50867
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
50868
+ command.query['fields'] = fields unless fields.nil?
50869
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
50870
+ command.query['userIp'] = user_ip unless user_ip.nil?
50871
+ execute_or_queue_command(command, &block)
50872
+ end
50873
+
50874
+ # Creates a new RolloutPlan in a given project and location.
50875
+ # @param [String] project
50876
+ # Project ID for this request.
50877
+ # @param [Google::Apis::ComputeBeta::RolloutPlan] rollout_plan_object
50878
+ # @param [String] request_id
50879
+ # An optional request ID to identify requests. Specify a unique request ID so
50880
+ # that if you must retry your request, the server will know to ignore the
50881
+ # request if it has already been completed.
50882
+ # For example, consider a situation where you make an initial request and
50883
+ # the request times out. If you make the request again with the same
50884
+ # request ID, the server can check if original operation with the same
50885
+ # request ID was received, and if so, will ignore the second request. This
50886
+ # prevents clients from accidentally creating duplicate commitments.
50887
+ # The request ID must be
50888
+ # a valid UUID with the exception that zero UUID is not supported
50889
+ # (00000000-0000-0000-0000-000000000000).
50890
+ # @param [String] fields
50891
+ # Selector specifying which fields to include in a partial response.
50892
+ # @param [String] quota_user
50893
+ # Available to use for quota purposes for server-side applications. Can be any
50894
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
50895
+ # @param [String] user_ip
50896
+ # Legacy name for parameter that has been superseded by `quotaUser`.
50897
+ # @param [Google::Apis::RequestOptions] options
50898
+ # Request-specific options
50899
+ #
50900
+ # @yield [result, err] Result & error if block supplied
50901
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
50902
+ # @yieldparam err [StandardError] error object if request failed
50903
+ #
50904
+ # @return [Google::Apis::ComputeBeta::Operation]
50905
+ #
50906
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
50907
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
50908
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
50909
+ def insert_rollout_plan(project, rollout_plan_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
50910
+ command = make_simple_command(:post, 'projects/{project}/global/rolloutPlans', options)
50911
+ command.request_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
50912
+ command.request_object = rollout_plan_object
50913
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
50914
+ command.response_class = Google::Apis::ComputeBeta::Operation
50915
+ command.params['project'] = project unless project.nil?
50916
+ command.query['requestId'] = request_id unless request_id.nil?
50917
+ command.query['fields'] = fields unless fields.nil?
50918
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
50919
+ command.query['userIp'] = user_ip unless user_ip.nil?
50920
+ execute_or_queue_command(command, &block)
50921
+ end
50922
+
50923
+ # Lists RolloutPlans in a given project and location.
50924
+ # @param [String] project
50925
+ # Project ID for this request.
50926
+ # @param [String] filter
50927
+ # A filter expression that filters resources listed in the response. Most
50928
+ # Compute resources support two types of filter expressions:
50929
+ # expressions that support regular expressions and expressions that follow
50930
+ # API improvement proposal AIP-160.
50931
+ # These two types of filter expressions cannot be mixed in one request.
50932
+ # If you want to use AIP-160, your expression must specify the field name, an
50933
+ # operator, and the value that you want to use for filtering. The value
50934
+ # must be a string, a number, or a boolean. The operator
50935
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
50936
+ # For example, if you are filtering Compute Engine instances, you can
50937
+ # exclude instances named `example-instance` by specifying
50938
+ # `name != example-instance`.
50939
+ # The `:*` comparison can be used to test whether a key has been defined.
50940
+ # For example, to find all objects with `owner` label use:
50941
+ # ```
50942
+ # labels.owner:*
50943
+ # ```
50944
+ # You can also filter nested fields. For example, you could specify
50945
+ # `scheduling.automaticRestart = false` to include instances only
50946
+ # if they are not scheduled for automatic restarts. You can use filtering
50947
+ # on nested fields to filter based onresource labels.
50948
+ # To filter on multiple expressions, provide each separate expression within
50949
+ # parentheses. For example:
50950
+ # ```
50951
+ # (scheduling.automaticRestart = true)
50952
+ # (cpuPlatform = "Intel Skylake")
50953
+ # ```
50954
+ # By default, each expression is an `AND` expression. However, you
50955
+ # can include `AND` and `OR` expressions explicitly.
50956
+ # For example:
50957
+ # ```
50958
+ # (cpuPlatform = "Intel Skylake") OR
50959
+ # (cpuPlatform = "Intel Broadwell") AND
50960
+ # (scheduling.automaticRestart = true)
50961
+ # ```
50962
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
50963
+ # (not equal) operator against a single un-parenthesized expression with or
50964
+ # without quotes or against multiple parenthesized expressions. Examples:
50965
+ # `fieldname eq unquoted literal`
50966
+ # `fieldname eq 'single quoted literal'`
50967
+ # `fieldname eq "double quoted literal"`
50968
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
50969
+ # The literal value is interpreted as a regular expression using GoogleRE2
50970
+ # library syntax.
50971
+ # The literal value must match the entire field.
50972
+ # For example, to filter for instances that do not end with name "instance",
50973
+ # you would use `name ne .*instance`.
50974
+ # You cannot combine constraints on multiple fields using regular
50975
+ # expressions.
50976
+ # @param [Fixnum] max_results
50977
+ # The maximum number of results per page that should be returned.
50978
+ # If the number of available results is larger than `maxResults`,
50979
+ # Compute Engine returns a `nextPageToken` that can be used to get
50980
+ # the next page of results in subsequent list requests. Acceptable values are
50981
+ # `0` to `500`, inclusive. (Default: `500`)
50982
+ # @param [String] order_by
50983
+ # Sorts list results by a certain order. By default, results
50984
+ # are returned in alphanumerical order based on the resource name.
50985
+ # You can also sort results in descending order based on the creation
50986
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
50987
+ # results based on the `creationTimestamp` field in
50988
+ # reverse chronological order (newest result first). Use this to sort
50989
+ # resources like operations so that the newest operation is returned first.
50990
+ # Currently, only sorting by `name` or
50991
+ # `creationTimestamp desc` is supported.
50992
+ # @param [String] page_token
50993
+ # Specifies a page token to use. Set `pageToken` to the
50994
+ # `nextPageToken` returned by a previous list request to get
50995
+ # the next page of results.
50996
+ # @param [Boolean] return_partial_success
50997
+ # Opt-in for partial success behavior which provides partial results in case
50998
+ # of failure. The default value is false.
50999
+ # For example, when partial success behavior is enabled, aggregatedList for a
51000
+ # single zone scope either returns all resources in the zone or no resources,
51001
+ # with an error code.
51002
+ # @param [String] fields
51003
+ # Selector specifying which fields to include in a partial response.
51004
+ # @param [String] quota_user
51005
+ # Available to use for quota purposes for server-side applications. Can be any
51006
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51007
+ # @param [String] user_ip
51008
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51009
+ # @param [Google::Apis::RequestOptions] options
51010
+ # Request-specific options
51011
+ #
51012
+ # @yield [result, err] Result & error if block supplied
51013
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlansListResponse] parsed result object
51014
+ # @yieldparam err [StandardError] error object if request failed
51015
+ #
51016
+ # @return [Google::Apis::ComputeBeta::RolloutPlansListResponse]
51017
+ #
51018
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51019
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51020
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51021
+ 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)
51022
+ command = make_simple_command(:get, 'projects/{project}/global/rolloutPlans', options)
51023
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlansListResponse::Representation
51024
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlansListResponse
51025
+ command.params['project'] = project unless project.nil?
51026
+ command.query['filter'] = filter unless filter.nil?
51027
+ command.query['maxResults'] = max_results unless max_results.nil?
51028
+ command.query['orderBy'] = order_by unless order_by.nil?
51029
+ command.query['pageToken'] = page_token unless page_token.nil?
51030
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
51031
+ command.query['fields'] = fields unless fields.nil?
51032
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51033
+ command.query['userIp'] = user_ip unless user_ip.nil?
51034
+ execute_or_queue_command(command, &block)
51035
+ end
51036
+
51037
+ # Cancels a Rollout.
51038
+ # @param [String] project
51039
+ # Project ID for this request.
51040
+ # @param [String] rollout
51041
+ # Name of the Rollout resource to cancel.
51042
+ # @param [String] request_id
51043
+ # An optional request ID to identify requests. Specify a unique request ID so
51044
+ # that if you must retry your request, the server will know to ignore the
51045
+ # request if it has already been completed.
51046
+ # For example, consider a situation where you make an initial request and
51047
+ # the request times out. If you make the request again with the same
51048
+ # request ID, the server can check if original operation with the same
51049
+ # request ID was received, and if so, will ignore the second request. This
51050
+ # prevents clients from accidentally creating duplicate commitments.
51051
+ # The request ID must be
51052
+ # a valid UUID with the exception that zero UUID is not supported
51053
+ # (00000000-0000-0000-0000-000000000000).
51054
+ # @param [Boolean] rollback
51055
+ # Optional. If true, then the ongoing rollout must be rolled back. Else, just
51056
+ # cancel
51057
+ # the rollout without taking any further actions. Note that products must
51058
+ # support at least one of these options, however, it does not need to support
51059
+ # both.
51060
+ # @param [String] fields
51061
+ # Selector specifying which fields to include in a partial response.
51062
+ # @param [String] quota_user
51063
+ # Available to use for quota purposes for server-side applications. Can be any
51064
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51065
+ # @param [String] user_ip
51066
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51067
+ # @param [Google::Apis::RequestOptions] options
51068
+ # Request-specific options
51069
+ #
51070
+ # @yield [result, err] Result & error if block supplied
51071
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
51072
+ # @yieldparam err [StandardError] error object if request failed
51073
+ #
51074
+ # @return [Google::Apis::ComputeBeta::Operation]
51075
+ #
51076
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51077
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51078
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51079
+ def cancel_rollout(project, rollout, request_id: nil, rollback: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51080
+ command = make_simple_command(:patch, 'projects/{project}/global/rollouts/{rollout}', options)
51081
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
51082
+ command.response_class = Google::Apis::ComputeBeta::Operation
51083
+ command.params['project'] = project unless project.nil?
51084
+ command.params['rollout'] = rollout unless rollout.nil?
51085
+ command.query['requestId'] = request_id unless request_id.nil?
51086
+ command.query['rollback'] = rollback unless rollback.nil?
51087
+ command.query['fields'] = fields unless fields.nil?
51088
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51089
+ command.query['userIp'] = user_ip unless user_ip.nil?
51090
+ execute_or_queue_command(command, &block)
51091
+ end
51092
+
51093
+ # Deletes a Rollout.
51094
+ # @param [String] project
51095
+ # Project ID for this request.
51096
+ # @param [String] rollout
51097
+ # Name of the Rollout resource to delete.
51098
+ # @param [String] request_id
51099
+ # An optional request ID to identify requests. Specify a unique request ID so
51100
+ # that if you must retry your request, the server will know to ignore the
51101
+ # request if it has already been completed.
51102
+ # For example, consider a situation where you make an initial request and
51103
+ # the request times out. If you make the request again with the same
51104
+ # request ID, the server can check if original operation with the same
51105
+ # request ID was received, and if so, will ignore the second request. This
51106
+ # prevents clients from accidentally creating duplicate commitments.
51107
+ # The request ID must be
51108
+ # a valid UUID with the exception that zero UUID is not supported
51109
+ # (00000000-0000-0000-0000-000000000000).
51110
+ # @param [String] fields
51111
+ # Selector specifying which fields to include in a partial response.
51112
+ # @param [String] quota_user
51113
+ # Available to use for quota purposes for server-side applications. Can be any
51114
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51115
+ # @param [String] user_ip
51116
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51117
+ # @param [Google::Apis::RequestOptions] options
51118
+ # Request-specific options
51119
+ #
51120
+ # @yield [result, err] Result & error if block supplied
51121
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
51122
+ # @yieldparam err [StandardError] error object if request failed
51123
+ #
51124
+ # @return [Google::Apis::ComputeBeta::Operation]
51125
+ #
51126
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51127
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51128
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51129
+ def delete_rollout(project, rollout, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51130
+ command = make_simple_command(:delete, 'projects/{project}/global/rollouts/{rollout}', options)
51131
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
51132
+ command.response_class = Google::Apis::ComputeBeta::Operation
51133
+ command.params['project'] = project unless project.nil?
51134
+ command.params['rollout'] = rollout unless rollout.nil?
51135
+ command.query['requestId'] = request_id unless request_id.nil?
51136
+ command.query['fields'] = fields unless fields.nil?
51137
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51138
+ command.query['userIp'] = user_ip unless user_ip.nil?
51139
+ execute_or_queue_command(command, &block)
51140
+ end
51141
+
51142
+ # Gets details of a single project-scoped Rollout.
51143
+ # @param [String] project
51144
+ # Project ID for this request.
51145
+ # @param [String] rollout
51146
+ # Name of the persistent rollout to return.
51147
+ # @param [String] fields
51148
+ # Selector specifying which fields to include in a partial response.
51149
+ # @param [String] quota_user
51150
+ # Available to use for quota purposes for server-side applications. Can be any
51151
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51152
+ # @param [String] user_ip
51153
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51154
+ # @param [Google::Apis::RequestOptions] options
51155
+ # Request-specific options
51156
+ #
51157
+ # @yield [result, err] Result & error if block supplied
51158
+ # @yieldparam result [Google::Apis::ComputeBeta::Rollout] parsed result object
51159
+ # @yieldparam err [StandardError] error object if request failed
51160
+ #
51161
+ # @return [Google::Apis::ComputeBeta::Rollout]
51162
+ #
51163
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51164
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51165
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51166
+ def get_rollout(project, rollout, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
51167
+ command = make_simple_command(:get, 'projects/{project}/global/rollouts/{rollout}', options)
51168
+ command.response_representation = Google::Apis::ComputeBeta::Rollout::Representation
51169
+ command.response_class = Google::Apis::ComputeBeta::Rollout
51170
+ command.params['project'] = project unless project.nil?
51171
+ command.params['rollout'] = rollout unless rollout.nil?
51172
+ command.query['fields'] = fields unless fields.nil?
51173
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51174
+ command.query['userIp'] = user_ip unless user_ip.nil?
51175
+ execute_or_queue_command(command, &block)
51176
+ end
51177
+
51178
+ # Lists Rollouts in a given project and location.
51179
+ # @param [String] project
51180
+ # Project ID for this request.
51181
+ # @param [String] filter
51182
+ # A filter expression that filters resources listed in the response. Most
51183
+ # Compute resources support two types of filter expressions:
51184
+ # expressions that support regular expressions and expressions that follow
51185
+ # API improvement proposal AIP-160.
51186
+ # These two types of filter expressions cannot be mixed in one request.
51187
+ # If you want to use AIP-160, your expression must specify the field name, an
51188
+ # operator, and the value that you want to use for filtering. The value
51189
+ # must be a string, a number, or a boolean. The operator
51190
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
51191
+ # For example, if you are filtering Compute Engine instances, you can
51192
+ # exclude instances named `example-instance` by specifying
51193
+ # `name != example-instance`.
51194
+ # The `:*` comparison can be used to test whether a key has been defined.
51195
+ # For example, to find all objects with `owner` label use:
51196
+ # ```
51197
+ # labels.owner:*
51198
+ # ```
51199
+ # You can also filter nested fields. For example, you could specify
51200
+ # `scheduling.automaticRestart = false` to include instances only
51201
+ # if they are not scheduled for automatic restarts. You can use filtering
51202
+ # on nested fields to filter based onresource labels.
51203
+ # To filter on multiple expressions, provide each separate expression within
51204
+ # parentheses. For example:
51205
+ # ```
51206
+ # (scheduling.automaticRestart = true)
51207
+ # (cpuPlatform = "Intel Skylake")
51208
+ # ```
51209
+ # By default, each expression is an `AND` expression. However, you
51210
+ # can include `AND` and `OR` expressions explicitly.
51211
+ # For example:
51212
+ # ```
51213
+ # (cpuPlatform = "Intel Skylake") OR
51214
+ # (cpuPlatform = "Intel Broadwell") AND
51215
+ # (scheduling.automaticRestart = true)
51216
+ # ```
51217
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
51218
+ # (not equal) operator against a single un-parenthesized expression with or
51219
+ # without quotes or against multiple parenthesized expressions. Examples:
51220
+ # `fieldname eq unquoted literal`
51221
+ # `fieldname eq 'single quoted literal'`
51222
+ # `fieldname eq "double quoted literal"`
51223
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
51224
+ # The literal value is interpreted as a regular expression using GoogleRE2
51225
+ # library syntax.
51226
+ # The literal value must match the entire field.
51227
+ # For example, to filter for instances that do not end with name "instance",
51228
+ # you would use `name ne .*instance`.
51229
+ # You cannot combine constraints on multiple fields using regular
51230
+ # expressions.
51231
+ # @param [Fixnum] max_results
51232
+ # The maximum number of results per page that should be returned.
51233
+ # If the number of available results is larger than `maxResults`,
51234
+ # Compute Engine returns a `nextPageToken` that can be used to get
51235
+ # the next page of results in subsequent list requests. Acceptable values are
51236
+ # `0` to `500`, inclusive. (Default: `500`)
51237
+ # @param [String] order_by
51238
+ # Sorts list results by a certain order. By default, results
51239
+ # are returned in alphanumerical order based on the resource name.
51240
+ # You can also sort results in descending order based on the creation
51241
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
51242
+ # results based on the `creationTimestamp` field in
51243
+ # reverse chronological order (newest result first). Use this to sort
51244
+ # resources like operations so that the newest operation is returned first.
51245
+ # Currently, only sorting by `name` or
51246
+ # `creationTimestamp desc` is supported.
51247
+ # @param [String] page_token
51248
+ # Specifies a page token to use. Set `pageToken` to the
51249
+ # `nextPageToken` returned by a previous list request to get
51250
+ # the next page of results.
51251
+ # @param [Boolean] return_partial_success
51252
+ # Opt-in for partial success behavior which provides partial results in case
51253
+ # of failure. The default value is false.
51254
+ # For example, when partial success behavior is enabled, aggregatedList for a
51255
+ # single zone scope either returns all resources in the zone or no resources,
51256
+ # with an error code.
51257
+ # @param [String] fields
51258
+ # Selector specifying which fields to include in a partial response.
51259
+ # @param [String] quota_user
51260
+ # Available to use for quota purposes for server-side applications. Can be any
51261
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
51262
+ # @param [String] user_ip
51263
+ # Legacy name for parameter that has been superseded by `quotaUser`.
51264
+ # @param [Google::Apis::RequestOptions] options
51265
+ # Request-specific options
51266
+ #
51267
+ # @yield [result, err] Result & error if block supplied
51268
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutsListResponse] parsed result object
51269
+ # @yieldparam err [StandardError] error object if request failed
51270
+ #
51271
+ # @return [Google::Apis::ComputeBeta::RolloutsListResponse]
51272
+ #
51273
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
51274
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
51275
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
51276
+ 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)
51277
+ command = make_simple_command(:get, 'projects/{project}/global/rollouts', options)
51278
+ command.response_representation = Google::Apis::ComputeBeta::RolloutsListResponse::Representation
51279
+ command.response_class = Google::Apis::ComputeBeta::RolloutsListResponse
51280
+ command.params['project'] = project unless project.nil?
51281
+ command.query['filter'] = filter unless filter.nil?
51282
+ command.query['maxResults'] = max_results unless max_results.nil?
51283
+ command.query['orderBy'] = order_by unless order_by.nil?
51284
+ command.query['pageToken'] = page_token unless page_token.nil?
51285
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
51286
+ command.query['fields'] = fields unless fields.nil?
51287
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
51288
+ command.query['userIp'] = user_ip unless user_ip.nil?
51289
+ execute_or_queue_command(command, &block)
51290
+ end
51291
+
50491
51292
  # Retrieves an aggregated list of routers.
50492
51293
  # To prevent failure, Google recommends that you set the
50493
51294
  # `returnPartialSuccess` parameter to `true`.