google-apis-compute_beta 0.139.0 → 0.141.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.
@@ -11384,6 +11384,232 @@ module Google
11384
11384
  execute_or_queue_command(command, &block)
11385
11385
  end
11386
11386
 
11387
+ # Retrieves information about the specified host.
11388
+ # @param [String] project
11389
+ # The project ID for this request.
11390
+ # @param [String] zone
11391
+ # The name of the zone for this request, formatted as RFC1035.
11392
+ # @param [String] association
11393
+ # The parent resource association for the Host. This field specifies the
11394
+ # hierarchical context (e.g., reservation, block, sub-block) when
11395
+ # accessing the host. For example, reservations/reservation_name,
11396
+ # reservations/reservation_name/reservationBlocks/reservation_block_name or
11397
+ # reservations/reservation_name/reservationBlocks/reservation_block_name/
11398
+ # reservationSubBlocks/reservation_sub_block_name.
11399
+ # @param [String] host
11400
+ # The name of the host, formatted as RFC1035 or a resource ID
11401
+ # number.
11402
+ # @param [String] fields
11403
+ # Selector specifying which fields to include in a partial response.
11404
+ # @param [String] quota_user
11405
+ # Available to use for quota purposes for server-side applications. Can be any
11406
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
11407
+ # @param [String] user_ip
11408
+ # Legacy name for parameter that has been superseded by `quotaUser`.
11409
+ # @param [Google::Apis::RequestOptions] options
11410
+ # Request-specific options
11411
+ #
11412
+ # @yield [result, err] Result & error if block supplied
11413
+ # @yieldparam result [Google::Apis::ComputeBeta::Host] parsed result object
11414
+ # @yieldparam err [StandardError] error object if request failed
11415
+ #
11416
+ # @return [Google::Apis::ComputeBeta::Host]
11417
+ #
11418
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11419
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11420
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
11421
+ def get_host(project, zone, association, host, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11422
+ command = make_simple_command(:get, 'projects/{project}/zones/{zone}/{association}/hosts/{host}', options)
11423
+ command.response_representation = Google::Apis::ComputeBeta::Host::Representation
11424
+ command.response_class = Google::Apis::ComputeBeta::Host
11425
+ command.params['project'] = project unless project.nil?
11426
+ command.params['zone'] = zone unless zone.nil?
11427
+ command.params['association'] = association unless association.nil?
11428
+ command.params['host'] = host unless host.nil?
11429
+ command.query['fields'] = fields unless fields.nil?
11430
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
11431
+ command.query['userIp'] = user_ip unless user_ip.nil?
11432
+ execute_or_queue_command(command, &block)
11433
+ end
11434
+
11435
+ # Allows customers to get SBOM versions of a host.
11436
+ # @param [String] project
11437
+ # Project ID for this request.
11438
+ # @param [String] zone
11439
+ # Name of the zone for this request. Zone name should conform to RFC1035.
11440
+ # @param [String] association
11441
+ # The parent resource association for the Host. This field specifies the
11442
+ # hierarchical context (e.g., reservation, block, sub-block) when
11443
+ # accessing the host.
11444
+ # @param [String] host
11445
+ # The name of the host, formatted as RFC1035 or a resource ID
11446
+ # number.
11447
+ # @param [Google::Apis::ComputeBeta::HostsGetVersionRequest] hosts_get_version_request_object
11448
+ # @param [String] request_id
11449
+ # An optional request ID to identify requests. Specify a unique request ID so
11450
+ # that if you must retry your request, the server will know to ignore the
11451
+ # request if it has already been completed.
11452
+ # @param [String] fields
11453
+ # Selector specifying which fields to include in a partial response.
11454
+ # @param [String] quota_user
11455
+ # Available to use for quota purposes for server-side applications. Can be any
11456
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
11457
+ # @param [String] user_ip
11458
+ # Legacy name for parameter that has been superseded by `quotaUser`.
11459
+ # @param [Google::Apis::RequestOptions] options
11460
+ # Request-specific options
11461
+ #
11462
+ # @yield [result, err] Result & error if block supplied
11463
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
11464
+ # @yieldparam err [StandardError] error object if request failed
11465
+ #
11466
+ # @return [Google::Apis::ComputeBeta::Operation]
11467
+ #
11468
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11469
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11470
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
11471
+ def get_host_version(project, zone, association, host, hosts_get_version_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11472
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion', options)
11473
+ command.request_representation = Google::Apis::ComputeBeta::HostsGetVersionRequest::Representation
11474
+ command.request_object = hosts_get_version_request_object
11475
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
11476
+ command.response_class = Google::Apis::ComputeBeta::Operation
11477
+ command.params['project'] = project unless project.nil?
11478
+ command.params['zone'] = zone unless zone.nil?
11479
+ command.params['association'] = association unless association.nil?
11480
+ command.params['host'] = host unless host.nil?
11481
+ command.query['requestId'] = request_id unless request_id.nil?
11482
+ command.query['fields'] = fields unless fields.nil?
11483
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
11484
+ command.query['userIp'] = user_ip unless user_ip.nil?
11485
+ execute_or_queue_command(command, &block)
11486
+ end
11487
+
11488
+ # Retrieves a list of hosts.
11489
+ # @param [String] project
11490
+ # The project ID for this request.
11491
+ # @param [String] zone
11492
+ # The name of the zone for this request, formatted as RFC1035.
11493
+ # @param [String] association
11494
+ # The parent resource association for the Host. This field specifies the
11495
+ # hierarchical context (e.g., reservation, block, sub-block) when
11496
+ # accessing the host. For example, reservations/reservation_name,
11497
+ # reservations/reservation_name/reservationBlocks/reservation_block_name or
11498
+ # reservations/reservation_name/reservationBlocks/reservation_block_name/
11499
+ # reservationSubBlocks/reservation_sub_block_name.
11500
+ # @param [String] filter
11501
+ # A filter expression that filters resources listed in the response. Most
11502
+ # Compute resources support two types of filter expressions:
11503
+ # expressions that support regular expressions and expressions that follow
11504
+ # API improvement proposal AIP-160.
11505
+ # These two types of filter expressions cannot be mixed in one request.
11506
+ # If you want to use AIP-160, your expression must specify the field name, an
11507
+ # operator, and the value that you want to use for filtering. The value
11508
+ # must be a string, a number, or a boolean. The operator
11509
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
11510
+ # For example, if you are filtering Compute Engine instances, you can
11511
+ # exclude instances named `example-instance` by specifying
11512
+ # `name != example-instance`.
11513
+ # The `:*` comparison can be used to test whether a key has been defined.
11514
+ # For example, to find all objects with `owner` label use:
11515
+ # ```
11516
+ # labels.owner:*
11517
+ # ```
11518
+ # You can also filter nested fields. For example, you could specify
11519
+ # `scheduling.automaticRestart = false` to include instances only
11520
+ # if they are not scheduled for automatic restarts. You can use filtering
11521
+ # on nested fields to filter based onresource labels.
11522
+ # To filter on multiple expressions, provide each separate expression within
11523
+ # parentheses. For example:
11524
+ # ```
11525
+ # (scheduling.automaticRestart = true)
11526
+ # (cpuPlatform = "Intel Skylake")
11527
+ # ```
11528
+ # By default, each expression is an `AND` expression. However, you
11529
+ # can include `AND` and `OR` expressions explicitly.
11530
+ # For example:
11531
+ # ```
11532
+ # (cpuPlatform = "Intel Skylake") OR
11533
+ # (cpuPlatform = "Intel Broadwell") AND
11534
+ # (scheduling.automaticRestart = true)
11535
+ # ```
11536
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
11537
+ # (not equal) operator against a single un-parenthesized expression with or
11538
+ # without quotes or against multiple parenthesized expressions. Examples:
11539
+ # `fieldname eq unquoted literal`
11540
+ # `fieldname eq 'single quoted literal'`
11541
+ # `fieldname eq "double quoted literal"`
11542
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
11543
+ # The literal value is interpreted as a regular expression using GoogleRE2
11544
+ # library syntax.
11545
+ # The literal value must match the entire field.
11546
+ # For example, to filter for instances that do not end with name "instance",
11547
+ # you would use `name ne .*instance`.
11548
+ # You cannot combine constraints on multiple fields using regular
11549
+ # expressions.
11550
+ # @param [Fixnum] max_results
11551
+ # The maximum number of results per page that should be returned.
11552
+ # If the number of available results is larger than `maxResults`,
11553
+ # Compute Engine returns a `nextPageToken` that can be used to get
11554
+ # the next page of results in subsequent list requests. Acceptable values are
11555
+ # `0` to `500`, inclusive. (Default: `500`)
11556
+ # @param [String] order_by
11557
+ # Sorts list results by a certain order. By default, results
11558
+ # are returned in alphanumerical order based on the resource name.
11559
+ # You can also sort results in descending order based on the creation
11560
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
11561
+ # results based on the `creationTimestamp` field in
11562
+ # reverse chronological order (newest result first). Use this to sort
11563
+ # resources like operations so that the newest operation is returned first.
11564
+ # Currently, only sorting by `name` or
11565
+ # `creationTimestamp desc` is supported.
11566
+ # @param [String] page_token
11567
+ # Specifies a page token to use. Set `pageToken` to the
11568
+ # `nextPageToken` returned by a previous list request to get
11569
+ # the next page of results.
11570
+ # @param [Boolean] return_partial_success
11571
+ # Opt-in for partial success behavior which provides partial results in case
11572
+ # of failure. The default value is false.
11573
+ # For example, when partial success behavior is enabled, aggregatedList for a
11574
+ # single zone scope either returns all resources in the zone or no resources,
11575
+ # with an error code.
11576
+ # @param [String] fields
11577
+ # Selector specifying which fields to include in a partial response.
11578
+ # @param [String] quota_user
11579
+ # Available to use for quota purposes for server-side applications. Can be any
11580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
11581
+ # @param [String] user_ip
11582
+ # Legacy name for parameter that has been superseded by `quotaUser`.
11583
+ # @param [Google::Apis::RequestOptions] options
11584
+ # Request-specific options
11585
+ #
11586
+ # @yield [result, err] Result & error if block supplied
11587
+ # @yieldparam result [Google::Apis::ComputeBeta::HostsListResponse] parsed result object
11588
+ # @yieldparam err [StandardError] error object if request failed
11589
+ #
11590
+ # @return [Google::Apis::ComputeBeta::HostsListResponse]
11591
+ #
11592
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11593
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11594
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
11595
+ def list_hosts(project, zone, association, 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)
11596
+ command = make_simple_command(:get, 'projects/{project}/zones/{zone}/{association}/hosts', options)
11597
+ command.response_representation = Google::Apis::ComputeBeta::HostsListResponse::Representation
11598
+ command.response_class = Google::Apis::ComputeBeta::HostsListResponse
11599
+ command.params['project'] = project unless project.nil?
11600
+ command.params['zone'] = zone unless zone.nil?
11601
+ command.params['association'] = association unless association.nil?
11602
+ command.query['filter'] = filter unless filter.nil?
11603
+ command.query['maxResults'] = max_results unless max_results.nil?
11604
+ command.query['orderBy'] = order_by unless order_by.nil?
11605
+ command.query['pageToken'] = page_token unless page_token.nil?
11606
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
11607
+ command.query['fields'] = fields unless fields.nil?
11608
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
11609
+ command.query['userIp'] = user_ip unless user_ip.nil?
11610
+ execute_or_queue_command(command, &block)
11611
+ end
11612
+
11387
11613
  # Deletes the specified HttpHealthCheck resource.
11388
11614
  # @param [String] project
11389
11615
  # Project ID for this request.
@@ -12218,6 +12444,46 @@ module Google
12218
12444
  execute_or_queue_command(command, &block)
12219
12445
  end
12220
12446
 
12447
+ # Returns the specified global ImageView resource, with a regional
12448
+ # context.
12449
+ # @param [String] project
12450
+ # Required. Project ID for this request.
12451
+ # @param [String] region
12452
+ # Required. Name of the region for this request.
12453
+ # @param [String] resource_id
12454
+ # Name of the image resource to return.
12455
+ # @param [String] fields
12456
+ # Selector specifying which fields to include in a partial response.
12457
+ # @param [String] quota_user
12458
+ # Available to use for quota purposes for server-side applications. Can be any
12459
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
12460
+ # @param [String] user_ip
12461
+ # Legacy name for parameter that has been superseded by `quotaUser`.
12462
+ # @param [Google::Apis::RequestOptions] options
12463
+ # Request-specific options
12464
+ #
12465
+ # @yield [result, err] Result & error if block supplied
12466
+ # @yieldparam result [Google::Apis::ComputeBeta::ImageView] parsed result object
12467
+ # @yieldparam err [StandardError] error object if request failed
12468
+ #
12469
+ # @return [Google::Apis::ComputeBeta::ImageView]
12470
+ #
12471
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
12472
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
12473
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
12474
+ def get_image_view(project, region, resource_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
12475
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/imageViews/{resourceId}', options)
12476
+ command.response_representation = Google::Apis::ComputeBeta::ImageView::Representation
12477
+ command.response_class = Google::Apis::ComputeBeta::ImageView
12478
+ command.params['project'] = project unless project.nil?
12479
+ command.params['region'] = region unless region.nil?
12480
+ command.params['resourceId'] = resource_id unless resource_id.nil?
12481
+ command.query['fields'] = fields unless fields.nil?
12482
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
12483
+ command.query['userIp'] = user_ip unless user_ip.nil?
12484
+ execute_or_queue_command(command, &block)
12485
+ end
12486
+
12221
12487
  # Deletes the specified image.
12222
12488
  # @param [String] project
12223
12489
  # Project ID for this request.
@@ -30069,21 +30335,11 @@ module Google
30069
30335
  execute_or_queue_command(command, &block)
30070
30336
  end
30071
30337
 
30072
- # Inserts an association for the specified security policy.
30073
- # This has billing implications. Projects in the hierarchy with effective
30074
- # hierarchical security policies will be automatically enrolled into Cloud
30075
- # Armor Enterprise if not already enrolled.
30076
- # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30077
- # versions of this API were used to modify firewall policies. This usage is
30078
- # now disabled for most organizations. Use firewallPolicies.addAssociation
30079
- # instead.
30080
- # @param [String] security_policy
30081
- # Name of the security policy to update.
30082
- # @param [Google::Apis::ComputeBeta::SecurityPolicyAssociation] security_policy_association_object
30083
- # @param [Boolean] replace_existing_association
30084
- # Indicates whether or not to replace it if an association of the attachment
30085
- # already exists. This is false by default, in which case an error will be
30086
- # returned if an association already exists.
30338
+ # Deletes an OrganizationRolloutPlan.
30339
+ # @param [String] organization
30340
+ # Organization ID for this request.
30341
+ # @param [String] rollout_plan
30342
+ # Name of the OrganizationRolloutPlan resource to delete.
30087
30343
  # @param [String] request_id
30088
30344
  # An optional request ID to identify requests. Specify a unique request ID so
30089
30345
  # that if you must retry your request, the server will know to ignore the
@@ -30115,14 +30371,12 @@ module Google
30115
30371
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30116
30372
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30117
30373
  # @raise [Google::Apis::AuthorizationError] Authorization is required
30118
- def add_organization_security_policy_association(security_policy, security_policy_association_object = nil, replace_existing_association: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30119
- command = make_simple_command(:post, 'locations/global/securityPolicies/{securityPolicy}/addAssociation', options)
30120
- command.request_representation = Google::Apis::ComputeBeta::SecurityPolicyAssociation::Representation
30121
- command.request_object = security_policy_association_object
30374
+ def delete_organization_rollout_plan(organization, rollout_plan, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30375
+ command = make_simple_command(:delete, '{+organization}/global/rolloutPlans/{rolloutPlan}', options)
30122
30376
  command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30123
30377
  command.response_class = Google::Apis::ComputeBeta::Operation
30124
- command.params['securityPolicy'] = security_policy unless security_policy.nil?
30125
- command.query['replaceExistingAssociation'] = replace_existing_association unless replace_existing_association.nil?
30378
+ command.params['organization'] = organization unless organization.nil?
30379
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
30126
30380
  command.query['requestId'] = request_id unless request_id.nil?
30127
30381
  command.query['fields'] = fields unless fields.nil?
30128
30382
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -30130,25 +30384,11 @@ module Google
30130
30384
  execute_or_queue_command(command, &block)
30131
30385
  end
30132
30386
 
30133
- # Inserts a rule into a security policy.
30134
- # Use this API to modify Cloud Armor policies. Previously, alpha and beta
30135
- # versions of this API were used to modify firewall policies. This usage is
30136
- # now disabled for most organizations. Use firewallPolicies.addRule instead.
30137
- # @param [String] security_policy
30138
- # Name of the security policy to update.
30139
- # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
30140
- # @param [String] request_id
30141
- # An optional request ID to identify requests. Specify a unique request ID so
30142
- # that if you must retry your request, the server will know to ignore the
30143
- # request if it has already been completed.
30144
- # For example, consider a situation where you make an initial request and
30145
- # the request times out. If you make the request again with the same
30146
- # request ID, the server can check if original operation with the same
30147
- # request ID was received, and if so, will ignore the second request. This
30148
- # prevents clients from accidentally creating duplicate commitments.
30149
- # The request ID must be
30150
- # a valid UUID with the exception that zero UUID is not supported
30151
- # (00000000-0000-0000-0000-000000000000).
30387
+ # Gets details of a single organization-scoped RolloutPlan.
30388
+ # @param [String] organization
30389
+ # Organization ID for this request.
30390
+ # @param [String] rollout_plan
30391
+ # Name of the persistent rollout plan to return.
30152
30392
  # @param [String] fields
30153
30393
  # Selector specifying which fields to include in a partial response.
30154
30394
  # @param [String] quota_user
@@ -30160,7 +30400,696 @@ module Google
30160
30400
  # Request-specific options
30161
30401
  #
30162
30402
  # @yield [result, err] Result & error if block supplied
30163
- # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30403
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlan] parsed result object
30404
+ # @yieldparam err [StandardError] error object if request failed
30405
+ #
30406
+ # @return [Google::Apis::ComputeBeta::RolloutPlan]
30407
+ #
30408
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30409
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30410
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30411
+ def get_organization_rollout_plan(organization, rollout_plan, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30412
+ command = make_simple_command(:get, '{+organization}/global/rolloutPlans/{rolloutPlan}', options)
30413
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
30414
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlan
30415
+ command.params['organization'] = organization unless organization.nil?
30416
+ command.params['rolloutPlan'] = rollout_plan unless rollout_plan.nil?
30417
+ command.query['fields'] = fields unless fields.nil?
30418
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30419
+ command.query['userIp'] = user_ip unless user_ip.nil?
30420
+ execute_or_queue_command(command, &block)
30421
+ end
30422
+
30423
+ # Creates a new RolloutPlan in a given organization and location.
30424
+ # @param [String] organization
30425
+ # Organization ID for this request.
30426
+ # @param [Google::Apis::ComputeBeta::RolloutPlan] rollout_plan_object
30427
+ # @param [String] request_id
30428
+ # An optional request ID to identify requests. Specify a unique request ID so
30429
+ # that if you must retry your request, the server will know to ignore the
30430
+ # request if it has already been completed.
30431
+ # For example, consider a situation where you make an initial request and
30432
+ # the request times out. If you make the request again with the same
30433
+ # request ID, the server can check if original operation with the same
30434
+ # request ID was received, and if so, will ignore the second request. This
30435
+ # prevents clients from accidentally creating duplicate commitments.
30436
+ # The request ID must be
30437
+ # a valid UUID with the exception that zero UUID is not supported
30438
+ # (00000000-0000-0000-0000-000000000000).
30439
+ # @param [String] fields
30440
+ # Selector specifying which fields to include in a partial response.
30441
+ # @param [String] quota_user
30442
+ # Available to use for quota purposes for server-side applications. Can be any
30443
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30444
+ # @param [String] user_ip
30445
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30446
+ # @param [Google::Apis::RequestOptions] options
30447
+ # Request-specific options
30448
+ #
30449
+ # @yield [result, err] Result & error if block supplied
30450
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30451
+ # @yieldparam err [StandardError] error object if request failed
30452
+ #
30453
+ # @return [Google::Apis::ComputeBeta::Operation]
30454
+ #
30455
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30456
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30457
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30458
+ def insert_organization_rollout_plan(organization, rollout_plan_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30459
+ command = make_simple_command(:post, '{+organization}/global/rolloutPlans', options)
30460
+ command.request_representation = Google::Apis::ComputeBeta::RolloutPlan::Representation
30461
+ command.request_object = rollout_plan_object
30462
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30463
+ command.response_class = Google::Apis::ComputeBeta::Operation
30464
+ command.params['organization'] = organization unless organization.nil?
30465
+ command.query['requestId'] = request_id unless request_id.nil?
30466
+ command.query['fields'] = fields unless fields.nil?
30467
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30468
+ command.query['userIp'] = user_ip unless user_ip.nil?
30469
+ execute_or_queue_command(command, &block)
30470
+ end
30471
+
30472
+ # Lists OrganizationRolloutPlans in a given organization and location.
30473
+ # @param [String] organization
30474
+ # Organization ID for this request.
30475
+ # @param [String] filter
30476
+ # A filter expression that filters resources listed in the response. Most
30477
+ # Compute resources support two types of filter expressions:
30478
+ # expressions that support regular expressions and expressions that follow
30479
+ # API improvement proposal AIP-160.
30480
+ # These two types of filter expressions cannot be mixed in one request.
30481
+ # If you want to use AIP-160, your expression must specify the field name, an
30482
+ # operator, and the value that you want to use for filtering. The value
30483
+ # must be a string, a number, or a boolean. The operator
30484
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
30485
+ # For example, if you are filtering Compute Engine instances, you can
30486
+ # exclude instances named `example-instance` by specifying
30487
+ # `name != example-instance`.
30488
+ # The `:*` comparison can be used to test whether a key has been defined.
30489
+ # For example, to find all objects with `owner` label use:
30490
+ # ```
30491
+ # labels.owner:*
30492
+ # ```
30493
+ # You can also filter nested fields. For example, you could specify
30494
+ # `scheduling.automaticRestart = false` to include instances only
30495
+ # if they are not scheduled for automatic restarts. You can use filtering
30496
+ # on nested fields to filter based onresource labels.
30497
+ # To filter on multiple expressions, provide each separate expression within
30498
+ # parentheses. For example:
30499
+ # ```
30500
+ # (scheduling.automaticRestart = true)
30501
+ # (cpuPlatform = "Intel Skylake")
30502
+ # ```
30503
+ # By default, each expression is an `AND` expression. However, you
30504
+ # can include `AND` and `OR` expressions explicitly.
30505
+ # For example:
30506
+ # ```
30507
+ # (cpuPlatform = "Intel Skylake") OR
30508
+ # (cpuPlatform = "Intel Broadwell") AND
30509
+ # (scheduling.automaticRestart = true)
30510
+ # ```
30511
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
30512
+ # (not equal) operator against a single un-parenthesized expression with or
30513
+ # without quotes or against multiple parenthesized expressions. Examples:
30514
+ # `fieldname eq unquoted literal`
30515
+ # `fieldname eq 'single quoted literal'`
30516
+ # `fieldname eq "double quoted literal"`
30517
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
30518
+ # The literal value is interpreted as a regular expression using GoogleRE2
30519
+ # library syntax.
30520
+ # The literal value must match the entire field.
30521
+ # For example, to filter for instances that do not end with name "instance",
30522
+ # you would use `name ne .*instance`.
30523
+ # You cannot combine constraints on multiple fields using regular
30524
+ # expressions.
30525
+ # @param [Fixnum] max_results
30526
+ # The maximum number of results per page that should be returned.
30527
+ # If the number of available results is larger than `maxResults`,
30528
+ # Compute Engine returns a `nextPageToken` that can be used to get
30529
+ # the next page of results in subsequent list requests. Acceptable values are
30530
+ # `0` to `500`, inclusive. (Default: `500`)
30531
+ # @param [String] order_by
30532
+ # Sorts list results by a certain order. By default, results
30533
+ # are returned in alphanumerical order based on the resource name.
30534
+ # You can also sort results in descending order based on the creation
30535
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
30536
+ # results based on the `creationTimestamp` field in
30537
+ # reverse chronological order (newest result first). Use this to sort
30538
+ # resources like operations so that the newest operation is returned first.
30539
+ # Currently, only sorting by `name` or
30540
+ # `creationTimestamp desc` is supported.
30541
+ # @param [String] page_token
30542
+ # Specifies a page token to use. Set `pageToken` to the
30543
+ # `nextPageToken` returned by a previous list request to get
30544
+ # the next page of results.
30545
+ # @param [Boolean] return_partial_success
30546
+ # Opt-in for partial success behavior which provides partial results in case
30547
+ # of failure. The default value is false.
30548
+ # For example, when partial success behavior is enabled, aggregatedList for a
30549
+ # single zone scope either returns all resources in the zone or no resources,
30550
+ # with an error code.
30551
+ # @param [String] fields
30552
+ # Selector specifying which fields to include in a partial response.
30553
+ # @param [String] quota_user
30554
+ # Available to use for quota purposes for server-side applications. Can be any
30555
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30556
+ # @param [String] user_ip
30557
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30558
+ # @param [Google::Apis::RequestOptions] options
30559
+ # Request-specific options
30560
+ #
30561
+ # @yield [result, err] Result & error if block supplied
30562
+ # @yieldparam result [Google::Apis::ComputeBeta::RolloutPlansListResponse] parsed result object
30563
+ # @yieldparam err [StandardError] error object if request failed
30564
+ #
30565
+ # @return [Google::Apis::ComputeBeta::RolloutPlansListResponse]
30566
+ #
30567
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30568
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30569
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30570
+ def list_organization_rollout_plans(organization, 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)
30571
+ command = make_simple_command(:get, '{+organization}/global/rolloutPlans', options)
30572
+ command.response_representation = Google::Apis::ComputeBeta::RolloutPlansListResponse::Representation
30573
+ command.response_class = Google::Apis::ComputeBeta::RolloutPlansListResponse
30574
+ command.params['organization'] = organization unless organization.nil?
30575
+ command.query['filter'] = filter unless filter.nil?
30576
+ command.query['maxResults'] = max_results unless max_results.nil?
30577
+ command.query['orderBy'] = order_by unless order_by.nil?
30578
+ command.query['pageToken'] = page_token unless page_token.nil?
30579
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
30580
+ command.query['fields'] = fields unless fields.nil?
30581
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30582
+ command.query['userIp'] = user_ip unless user_ip.nil?
30583
+ execute_or_queue_command(command, &block)
30584
+ end
30585
+
30586
+ # Advances a Rollout to the next wave, or completes it if no waves remain.
30587
+ # @param [String] organization
30588
+ # Required. Organization ID for this request.
30589
+ # @param [String] rollout
30590
+ # Required. Name of the Rollout resource to advance.
30591
+ # @param [Fixnum] current_wave_number
30592
+ # Required. Wave number of the current wave.
30593
+ # @param [String] request_id
30594
+ # An optional request ID to identify requests. Specify a unique request ID so
30595
+ # that if you must retry your request, the server will know to ignore the
30596
+ # request if it has already been completed.
30597
+ # For example, consider a situation where you make an initial request and
30598
+ # the request times out. If you make the request again with the same
30599
+ # request ID, the server can check if original operation with the same
30600
+ # request ID was received, and if so, will ignore the second request. This
30601
+ # prevents clients from accidentally creating duplicate commitments.
30602
+ # The request ID must be
30603
+ # a valid UUID with the exception that zero UUID is not supported
30604
+ # (00000000-0000-0000-0000-000000000000).
30605
+ # @param [String] fields
30606
+ # Selector specifying which fields to include in a partial response.
30607
+ # @param [String] quota_user
30608
+ # Available to use for quota purposes for server-side applications. Can be any
30609
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30610
+ # @param [String] user_ip
30611
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30612
+ # @param [Google::Apis::RequestOptions] options
30613
+ # Request-specific options
30614
+ #
30615
+ # @yield [result, err] Result & error if block supplied
30616
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30617
+ # @yieldparam err [StandardError] error object if request failed
30618
+ #
30619
+ # @return [Google::Apis::ComputeBeta::Operation]
30620
+ #
30621
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30622
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30623
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30624
+ def advance_organization_rollout(organization, rollout, current_wave_number: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30625
+ command = make_simple_command(:post, '{+organization}/global/rollouts/{rollout}/advance', options)
30626
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30627
+ command.response_class = Google::Apis::ComputeBeta::Operation
30628
+ command.params['organization'] = organization unless organization.nil?
30629
+ command.params['rollout'] = rollout unless rollout.nil?
30630
+ command.query['currentWaveNumber'] = current_wave_number unless current_wave_number.nil?
30631
+ command.query['requestId'] = request_id unless request_id.nil?
30632
+ command.query['fields'] = fields unless fields.nil?
30633
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30634
+ command.query['userIp'] = user_ip unless user_ip.nil?
30635
+ execute_or_queue_command(command, &block)
30636
+ end
30637
+
30638
+ # Cancels a Rollout.
30639
+ # @param [String] organization
30640
+ # Required. Organization ID for this request.
30641
+ # @param [String] rollout
30642
+ # Name of the Rollout resource to cancel.
30643
+ # @param [String] request_id
30644
+ # An optional request ID to identify requests. Specify a unique request ID so
30645
+ # that if you must retry your request, the server will know to ignore the
30646
+ # request if it has already been completed.
30647
+ # For example, consider a situation where you make an initial request and
30648
+ # the request times out. If you make the request again with the same
30649
+ # request ID, the server can check if original operation with the same
30650
+ # request ID was received, and if so, will ignore the second request. This
30651
+ # prevents clients from accidentally creating duplicate commitments.
30652
+ # The request ID must be
30653
+ # a valid UUID with the exception that zero UUID is not supported
30654
+ # (00000000-0000-0000-0000-000000000000).
30655
+ # @param [Boolean] rollback
30656
+ # Optional. If true, then the ongoing rollout must be rolled back. Else, just
30657
+ # cancel
30658
+ # the rollout without taking any further actions. Note that products must
30659
+ # support at least one of these options, however, it does not need to support
30660
+ # both.
30661
+ # @param [String] fields
30662
+ # Selector specifying which fields to include in a partial response.
30663
+ # @param [String] quota_user
30664
+ # Available to use for quota purposes for server-side applications. Can be any
30665
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30666
+ # @param [String] user_ip
30667
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30668
+ # @param [Google::Apis::RequestOptions] options
30669
+ # Request-specific options
30670
+ #
30671
+ # @yield [result, err] Result & error if block supplied
30672
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30673
+ # @yieldparam err [StandardError] error object if request failed
30674
+ #
30675
+ # @return [Google::Apis::ComputeBeta::Operation]
30676
+ #
30677
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30678
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30679
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30680
+ def cancel_organization_rollout(organization, rollout, request_id: nil, rollback: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30681
+ command = make_simple_command(:patch, '{+organization}/global/rollouts/{rollout}', options)
30682
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30683
+ command.response_class = Google::Apis::ComputeBeta::Operation
30684
+ command.params['organization'] = organization unless organization.nil?
30685
+ command.params['rollout'] = rollout unless rollout.nil?
30686
+ command.query['requestId'] = request_id unless request_id.nil?
30687
+ command.query['rollback'] = rollback unless rollback.nil?
30688
+ command.query['fields'] = fields unless fields.nil?
30689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30690
+ command.query['userIp'] = user_ip unless user_ip.nil?
30691
+ execute_or_queue_command(command, &block)
30692
+ end
30693
+
30694
+ # Deletes a Rollout.
30695
+ # @param [String] organization
30696
+ # Required. Organization ID for this request.
30697
+ # @param [String] rollout
30698
+ # Name of the Rollout resource to delete.
30699
+ # @param [String] request_id
30700
+ # An optional request ID to identify requests. Specify a unique request ID so
30701
+ # that if you must retry your request, the server will know to ignore the
30702
+ # request if it has already been completed.
30703
+ # For example, consider a situation where you make an initial request and
30704
+ # the request times out. If you make the request again with the same
30705
+ # request ID, the server can check if original operation with the same
30706
+ # request ID was received, and if so, will ignore the second request. This
30707
+ # prevents clients from accidentally creating duplicate commitments.
30708
+ # The request ID must be
30709
+ # a valid UUID with the exception that zero UUID is not supported
30710
+ # (00000000-0000-0000-0000-000000000000).
30711
+ # @param [String] fields
30712
+ # Selector specifying which fields to include in a partial response.
30713
+ # @param [String] quota_user
30714
+ # Available to use for quota purposes for server-side applications. Can be any
30715
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30716
+ # @param [String] user_ip
30717
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30718
+ # @param [Google::Apis::RequestOptions] options
30719
+ # Request-specific options
30720
+ #
30721
+ # @yield [result, err] Result & error if block supplied
30722
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30723
+ # @yieldparam err [StandardError] error object if request failed
30724
+ #
30725
+ # @return [Google::Apis::ComputeBeta::Operation]
30726
+ #
30727
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30728
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30729
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30730
+ def delete_organization_rollout(organization, rollout, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30731
+ command = make_simple_command(:delete, '{+organization}/global/rollouts/{rollout}', options)
30732
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30733
+ command.response_class = Google::Apis::ComputeBeta::Operation
30734
+ command.params['organization'] = organization unless organization.nil?
30735
+ command.params['rollout'] = rollout unless rollout.nil?
30736
+ command.query['requestId'] = request_id unless request_id.nil?
30737
+ command.query['fields'] = fields unless fields.nil?
30738
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30739
+ command.query['userIp'] = user_ip unless user_ip.nil?
30740
+ execute_or_queue_command(command, &block)
30741
+ end
30742
+
30743
+ # Gets details of a single organization-scoped Rollout.
30744
+ # @param [String] organization
30745
+ # Organization ID for this request.
30746
+ # @param [String] rollout
30747
+ # Name of the persistent rollout to return.
30748
+ # @param [String] fields
30749
+ # Selector specifying which fields to include in a partial response.
30750
+ # @param [String] quota_user
30751
+ # Available to use for quota purposes for server-side applications. Can be any
30752
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30753
+ # @param [String] user_ip
30754
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30755
+ # @param [Google::Apis::RequestOptions] options
30756
+ # Request-specific options
30757
+ #
30758
+ # @yield [result, err] Result & error if block supplied
30759
+ # @yieldparam result [Google::Apis::ComputeBeta::Rollout] parsed result object
30760
+ # @yieldparam err [StandardError] error object if request failed
30761
+ #
30762
+ # @return [Google::Apis::ComputeBeta::Rollout]
30763
+ #
30764
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30765
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30766
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30767
+ def get_organization_rollout(organization, rollout, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30768
+ command = make_simple_command(:get, '{+organization}/global/rollouts/{rollout}', options)
30769
+ command.response_representation = Google::Apis::ComputeBeta::Rollout::Representation
30770
+ command.response_class = Google::Apis::ComputeBeta::Rollout
30771
+ command.params['organization'] = organization unless organization.nil?
30772
+ command.params['rollout'] = rollout unless rollout.nil?
30773
+ command.query['fields'] = fields unless fields.nil?
30774
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30775
+ command.query['userIp'] = user_ip unless user_ip.nil?
30776
+ execute_or_queue_command(command, &block)
30777
+ end
30778
+
30779
+ # Lists Rollouts in a given organization and location.
30780
+ # @param [String] organization
30781
+ # Required. Organization ID for this request.
30782
+ # @param [String] filter
30783
+ # A filter expression that filters resources listed in the response. Most
30784
+ # Compute resources support two types of filter expressions:
30785
+ # expressions that support regular expressions and expressions that follow
30786
+ # API improvement proposal AIP-160.
30787
+ # These two types of filter expressions cannot be mixed in one request.
30788
+ # If you want to use AIP-160, your expression must specify the field name, an
30789
+ # operator, and the value that you want to use for filtering. The value
30790
+ # must be a string, a number, or a boolean. The operator
30791
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
30792
+ # For example, if you are filtering Compute Engine instances, you can
30793
+ # exclude instances named `example-instance` by specifying
30794
+ # `name != example-instance`.
30795
+ # The `:*` comparison can be used to test whether a key has been defined.
30796
+ # For example, to find all objects with `owner` label use:
30797
+ # ```
30798
+ # labels.owner:*
30799
+ # ```
30800
+ # You can also filter nested fields. For example, you could specify
30801
+ # `scheduling.automaticRestart = false` to include instances only
30802
+ # if they are not scheduled for automatic restarts. You can use filtering
30803
+ # on nested fields to filter based onresource labels.
30804
+ # To filter on multiple expressions, provide each separate expression within
30805
+ # parentheses. For example:
30806
+ # ```
30807
+ # (scheduling.automaticRestart = true)
30808
+ # (cpuPlatform = "Intel Skylake")
30809
+ # ```
30810
+ # By default, each expression is an `AND` expression. However, you
30811
+ # can include `AND` and `OR` expressions explicitly.
30812
+ # For example:
30813
+ # ```
30814
+ # (cpuPlatform = "Intel Skylake") OR
30815
+ # (cpuPlatform = "Intel Broadwell") AND
30816
+ # (scheduling.automaticRestart = true)
30817
+ # ```
30818
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
30819
+ # (not equal) operator against a single un-parenthesized expression with or
30820
+ # without quotes or against multiple parenthesized expressions. Examples:
30821
+ # `fieldname eq unquoted literal`
30822
+ # `fieldname eq 'single quoted literal'`
30823
+ # `fieldname eq "double quoted literal"`
30824
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
30825
+ # The literal value is interpreted as a regular expression using GoogleRE2
30826
+ # library syntax.
30827
+ # The literal value must match the entire field.
30828
+ # For example, to filter for instances that do not end with name "instance",
30829
+ # you would use `name ne .*instance`.
30830
+ # You cannot combine constraints on multiple fields using regular
30831
+ # expressions.
30832
+ # @param [Fixnum] max_results
30833
+ # The maximum number of results per page that should be returned.
30834
+ # If the number of available results is larger than `maxResults`,
30835
+ # Compute Engine returns a `nextPageToken` that can be used to get
30836
+ # the next page of results in subsequent list requests. Acceptable values are
30837
+ # `0` to `500`, inclusive. (Default: `500`)
30838
+ # @param [String] order_by
30839
+ # Sorts list results by a certain order. By default, results
30840
+ # are returned in alphanumerical order based on the resource name.
30841
+ # You can also sort results in descending order based on the creation
30842
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
30843
+ # results based on the `creationTimestamp` field in
30844
+ # reverse chronological order (newest result first). Use this to sort
30845
+ # resources like operations so that the newest operation is returned first.
30846
+ # Currently, only sorting by `name` or
30847
+ # `creationTimestamp desc` is supported.
30848
+ # @param [String] page_token
30849
+ # Specifies a page token to use. Set `pageToken` to the
30850
+ # `nextPageToken` returned by a previous list request to get
30851
+ # the next page of results.
30852
+ # @param [Boolean] return_partial_success
30853
+ # Opt-in for partial success behavior which provides partial results in case
30854
+ # of failure. The default value is false.
30855
+ # For example, when partial success behavior is enabled, aggregatedList for a
30856
+ # single zone scope either returns all resources in the zone or no resources,
30857
+ # with an error code.
30858
+ # @param [String] fields
30859
+ # Selector specifying which fields to include in a partial response.
30860
+ # @param [String] quota_user
30861
+ # Available to use for quota purposes for server-side applications. Can be any
30862
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30863
+ # @param [String] user_ip
30864
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30865
+ # @param [Google::Apis::RequestOptions] options
30866
+ # Request-specific options
30867
+ #
30868
+ # @yield [result, err] Result & error if block supplied
30869
+ # @yieldparam result [Google::Apis::ComputeBeta::OrganizationRolloutsListResponse] parsed result object
30870
+ # @yieldparam err [StandardError] error object if request failed
30871
+ #
30872
+ # @return [Google::Apis::ComputeBeta::OrganizationRolloutsListResponse]
30873
+ #
30874
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30875
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30876
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30877
+ def list_organization_rollouts(organization, 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)
30878
+ command = make_simple_command(:get, '{+organization}/global/rollouts', options)
30879
+ command.response_representation = Google::Apis::ComputeBeta::OrganizationRolloutsListResponse::Representation
30880
+ command.response_class = Google::Apis::ComputeBeta::OrganizationRolloutsListResponse
30881
+ command.params['organization'] = organization unless organization.nil?
30882
+ command.query['filter'] = filter unless filter.nil?
30883
+ command.query['maxResults'] = max_results unless max_results.nil?
30884
+ command.query['orderBy'] = order_by unless order_by.nil?
30885
+ command.query['pageToken'] = page_token unless page_token.nil?
30886
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
30887
+ command.query['fields'] = fields unless fields.nil?
30888
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30889
+ command.query['userIp'] = user_ip unless user_ip.nil?
30890
+ execute_or_queue_command(command, &block)
30891
+ end
30892
+
30893
+ # Pauses a Rollout.
30894
+ # @param [String] organization
30895
+ # Required. Organization ID for this request.
30896
+ # @param [String] rollout
30897
+ # Required. Name of the Rollout resource to pause.
30898
+ # @param [String] etag
30899
+ # The etag of the Rollout.
30900
+ # If this is provided, the request will only succeed if the etag matches
30901
+ # the current etag of the Rollout.
30902
+ # @param [String] request_id
30903
+ # An optional request ID to identify requests. Specify a unique request ID so
30904
+ # that if you must retry your request, the server will know to ignore the
30905
+ # request if it has already been completed.
30906
+ # For example, consider a situation where you make an initial request and
30907
+ # the request times out. If you make the request again with the same
30908
+ # request ID, the server can check if original operation with the same
30909
+ # request ID was received, and if so, will ignore the second request. This
30910
+ # prevents clients from accidentally creating duplicate commitments.
30911
+ # The request ID must be
30912
+ # a valid UUID with the exception that zero UUID is not supported
30913
+ # (00000000-0000-0000-0000-000000000000).
30914
+ # @param [String] fields
30915
+ # Selector specifying which fields to include in a partial response.
30916
+ # @param [String] quota_user
30917
+ # Available to use for quota purposes for server-side applications. Can be any
30918
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30919
+ # @param [String] user_ip
30920
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30921
+ # @param [Google::Apis::RequestOptions] options
30922
+ # Request-specific options
30923
+ #
30924
+ # @yield [result, err] Result & error if block supplied
30925
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30926
+ # @yieldparam err [StandardError] error object if request failed
30927
+ #
30928
+ # @return [Google::Apis::ComputeBeta::Operation]
30929
+ #
30930
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30931
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30932
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30933
+ def pause_organization_rollout(organization, rollout, etag: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30934
+ command = make_simple_command(:post, '{+organization}/global/rollouts/{rollout}/pause', options)
30935
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30936
+ command.response_class = Google::Apis::ComputeBeta::Operation
30937
+ command.params['organization'] = organization unless organization.nil?
30938
+ command.params['rollout'] = rollout unless rollout.nil?
30939
+ command.query['etag'] = etag unless etag.nil?
30940
+ command.query['requestId'] = request_id unless request_id.nil?
30941
+ command.query['fields'] = fields unless fields.nil?
30942
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30943
+ command.query['userIp'] = user_ip unless user_ip.nil?
30944
+ execute_or_queue_command(command, &block)
30945
+ end
30946
+
30947
+ # Resumes a Rollout.
30948
+ # @param [String] organization
30949
+ # Required. Organization ID for this request.
30950
+ # @param [String] rollout
30951
+ # Required. Name of the Rollout resource to resume.
30952
+ # @param [String] etag
30953
+ # The etag of the Rollout.
30954
+ # If this is provided, the request will only succeed if the etag matches
30955
+ # the current etag of the Rollout.
30956
+ # @param [String] request_id
30957
+ # An optional request ID to identify requests. Specify a unique request ID so
30958
+ # that if you must retry your request, the server will know to ignore the
30959
+ # request if it has already been completed.
30960
+ # For example, consider a situation where you make an initial request and
30961
+ # the request times out. If you make the request again with the same
30962
+ # request ID, the server can check if original operation with the same
30963
+ # request ID was received, and if so, will ignore the second request. This
30964
+ # prevents clients from accidentally creating duplicate commitments.
30965
+ # The request ID must be
30966
+ # a valid UUID with the exception that zero UUID is not supported
30967
+ # (00000000-0000-0000-0000-000000000000).
30968
+ # @param [String] fields
30969
+ # Selector specifying which fields to include in a partial response.
30970
+ # @param [String] quota_user
30971
+ # Available to use for quota purposes for server-side applications. Can be any
30972
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
30973
+ # @param [String] user_ip
30974
+ # Legacy name for parameter that has been superseded by `quotaUser`.
30975
+ # @param [Google::Apis::RequestOptions] options
30976
+ # Request-specific options
30977
+ #
30978
+ # @yield [result, err] Result & error if block supplied
30979
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30980
+ # @yieldparam err [StandardError] error object if request failed
30981
+ #
30982
+ # @return [Google::Apis::ComputeBeta::Operation]
30983
+ #
30984
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
30985
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
30986
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
30987
+ def resume_organization_rollout(organization, rollout, etag: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
30988
+ command = make_simple_command(:post, '{+organization}/global/rollouts/{rollout}/resume', options)
30989
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
30990
+ command.response_class = Google::Apis::ComputeBeta::Operation
30991
+ command.params['organization'] = organization unless organization.nil?
30992
+ command.params['rollout'] = rollout unless rollout.nil?
30993
+ command.query['etag'] = etag unless etag.nil?
30994
+ command.query['requestId'] = request_id unless request_id.nil?
30995
+ command.query['fields'] = fields unless fields.nil?
30996
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
30997
+ command.query['userIp'] = user_ip unless user_ip.nil?
30998
+ execute_or_queue_command(command, &block)
30999
+ end
31000
+
31001
+ # Inserts an association for the specified security policy.
31002
+ # This has billing implications. Projects in the hierarchy with effective
31003
+ # hierarchical security policies will be automatically enrolled into Cloud
31004
+ # Armor Enterprise if not already enrolled.
31005
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
31006
+ # versions of this API were used to modify firewall policies. This usage is
31007
+ # now disabled for most organizations. Use firewallPolicies.addAssociation
31008
+ # instead.
31009
+ # @param [String] security_policy
31010
+ # Name of the security policy to update.
31011
+ # @param [Google::Apis::ComputeBeta::SecurityPolicyAssociation] security_policy_association_object
31012
+ # @param [Boolean] replace_existing_association
31013
+ # Indicates whether or not to replace it if an association of the attachment
31014
+ # already exists. This is false by default, in which case an error will be
31015
+ # returned if an association already exists.
31016
+ # @param [String] request_id
31017
+ # An optional request ID to identify requests. Specify a unique request ID so
31018
+ # that if you must retry your request, the server will know to ignore the
31019
+ # request if it has already been completed.
31020
+ # For example, consider a situation where you make an initial request and
31021
+ # the request times out. If you make the request again with the same
31022
+ # request ID, the server can check if original operation with the same
31023
+ # request ID was received, and if so, will ignore the second request. This
31024
+ # prevents clients from accidentally creating duplicate commitments.
31025
+ # The request ID must be
31026
+ # a valid UUID with the exception that zero UUID is not supported
31027
+ # (00000000-0000-0000-0000-000000000000).
31028
+ # @param [String] fields
31029
+ # Selector specifying which fields to include in a partial response.
31030
+ # @param [String] quota_user
31031
+ # Available to use for quota purposes for server-side applications. Can be any
31032
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
31033
+ # @param [String] user_ip
31034
+ # Legacy name for parameter that has been superseded by `quotaUser`.
31035
+ # @param [Google::Apis::RequestOptions] options
31036
+ # Request-specific options
31037
+ #
31038
+ # @yield [result, err] Result & error if block supplied
31039
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
31040
+ # @yieldparam err [StandardError] error object if request failed
31041
+ #
31042
+ # @return [Google::Apis::ComputeBeta::Operation]
31043
+ #
31044
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
31045
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
31046
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
31047
+ def add_organization_security_policy_association(security_policy, security_policy_association_object = nil, replace_existing_association: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
31048
+ command = make_simple_command(:post, 'locations/global/securityPolicies/{securityPolicy}/addAssociation', options)
31049
+ command.request_representation = Google::Apis::ComputeBeta::SecurityPolicyAssociation::Representation
31050
+ command.request_object = security_policy_association_object
31051
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
31052
+ command.response_class = Google::Apis::ComputeBeta::Operation
31053
+ command.params['securityPolicy'] = security_policy unless security_policy.nil?
31054
+ command.query['replaceExistingAssociation'] = replace_existing_association unless replace_existing_association.nil?
31055
+ command.query['requestId'] = request_id unless request_id.nil?
31056
+ command.query['fields'] = fields unless fields.nil?
31057
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
31058
+ command.query['userIp'] = user_ip unless user_ip.nil?
31059
+ execute_or_queue_command(command, &block)
31060
+ end
31061
+
31062
+ # Inserts a rule into a security policy.
31063
+ # Use this API to modify Cloud Armor policies. Previously, alpha and beta
31064
+ # versions of this API were used to modify firewall policies. This usage is
31065
+ # now disabled for most organizations. Use firewallPolicies.addRule instead.
31066
+ # @param [String] security_policy
31067
+ # Name of the security policy to update.
31068
+ # @param [Google::Apis::ComputeBeta::SecurityPolicyRule] security_policy_rule_object
31069
+ # @param [String] request_id
31070
+ # An optional request ID to identify requests. Specify a unique request ID so
31071
+ # that if you must retry your request, the server will know to ignore the
31072
+ # request if it has already been completed.
31073
+ # For example, consider a situation where you make an initial request and
31074
+ # the request times out. If you make the request again with the same
31075
+ # request ID, the server can check if original operation with the same
31076
+ # request ID was received, and if so, will ignore the second request. This
31077
+ # prevents clients from accidentally creating duplicate commitments.
31078
+ # The request ID must be
31079
+ # a valid UUID with the exception that zero UUID is not supported
31080
+ # (00000000-0000-0000-0000-000000000000).
31081
+ # @param [String] fields
31082
+ # Selector specifying which fields to include in a partial response.
31083
+ # @param [String] quota_user
31084
+ # Available to use for quota purposes for server-side applications. Can be any
31085
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
31086
+ # @param [String] user_ip
31087
+ # Legacy name for parameter that has been superseded by `quotaUser`.
31088
+ # @param [Google::Apis::RequestOptions] options
31089
+ # Request-specific options
31090
+ #
31091
+ # @yield [result, err] Result & error if block supplied
31092
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
30164
31093
  # @yieldparam err [StandardError] error object if request failed
30165
31094
  #
30166
31095
  # @return [Google::Apis::ComputeBeta::Operation]
@@ -31691,6 +32620,43 @@ module Google
31691
32620
  execute_or_queue_command(command, &block)
31692
32621
  end
31693
32622
 
32623
+ # Returns the specified global ProjectViews resource, with a regional
32624
+ # context.
32625
+ # @param [String] project
32626
+ # Required. Project ID for this request. This is part of the URL path.
32627
+ # @param [String] region
32628
+ # Required. Name of the region for this request. This is part of the URL path.
32629
+ # @param [String] fields
32630
+ # Selector specifying which fields to include in a partial response.
32631
+ # @param [String] quota_user
32632
+ # Available to use for quota purposes for server-side applications. Can be any
32633
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
32634
+ # @param [String] user_ip
32635
+ # Legacy name for parameter that has been superseded by `quotaUser`.
32636
+ # @param [Google::Apis::RequestOptions] options
32637
+ # Request-specific options
32638
+ #
32639
+ # @yield [result, err] Result & error if block supplied
32640
+ # @yieldparam result [Google::Apis::ComputeBeta::ProjectView] parsed result object
32641
+ # @yieldparam err [StandardError] error object if request failed
32642
+ #
32643
+ # @return [Google::Apis::ComputeBeta::ProjectView]
32644
+ #
32645
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
32646
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
32647
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
32648
+ def get_project_view(project, region, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
32649
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/projectViews', options)
32650
+ command.response_representation = Google::Apis::ComputeBeta::ProjectView::Representation
32651
+ command.response_class = Google::Apis::ComputeBeta::ProjectView
32652
+ command.params['project'] = project unless project.nil?
32653
+ command.params['region'] = region unless region.nil?
32654
+ command.query['fields'] = fields unless fields.nil?
32655
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
32656
+ command.query['userIp'] = user_ip unless user_ip.nil?
32657
+ execute_or_queue_command(command, &block)
32658
+ end
32659
+
31694
32660
  # Disable this project as a shared VPC host project.
31695
32661
  # @param [String] project
31696
32662
  # Project ID for this request.