google-apis-compute_beta 0.60.0 → 0.62.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.
@@ -849,8 +849,7 @@ module Google
849
849
  execute_or_queue_command(command, &block)
850
850
  end
851
851
 
852
- # Returns the specified autoscaler resource. Gets a list of available
853
- # autoscalers by making a list() request.
852
+ # Returns the specified autoscaler resource.
854
853
  # @param [String] project
855
854
  # Project ID for this request.
856
855
  # @param [String] zone
@@ -1331,8 +1330,7 @@ module Google
1331
1330
  execute_or_queue_command(command, &block)
1332
1331
  end
1333
1332
 
1334
- # Returns the specified BackendBucket resource. Gets a list of available backend
1335
- # buckets by making a list() request.
1333
+ # Returns the specified BackendBucket resource.
1336
1334
  # @param [String] project
1337
1335
  # Project ID for this request.
1338
1336
  # @param [String] backend_bucket
@@ -2025,8 +2023,7 @@ module Google
2025
2023
  execute_or_queue_command(command, &block)
2026
2024
  end
2027
2025
 
2028
- # Returns the specified BackendService resource. Gets a list of available
2029
- # backend services.
2026
+ # Returns the specified BackendService resource.
2030
2027
  # @param [String] project
2031
2028
  # Project ID for this request.
2032
2029
  # @param [String] backend_service
@@ -2661,8 +2658,7 @@ module Google
2661
2658
  execute_or_queue_command(command, &block)
2662
2659
  end
2663
2660
 
2664
- # Returns the specified disk type. Gets a list of available disk types by making
2665
- # a list() request.
2661
+ # Returns the specified disk type.
2666
2662
  # @param [String] project
2667
2663
  # Project ID for this request.
2668
2664
  # @param [String] zone
@@ -3054,8 +3050,7 @@ module Google
3054
3050
  execute_or_queue_command(command, &block)
3055
3051
  end
3056
3052
 
3057
- # Returns a specified persistent disk. Gets a list of available persistent disks
3058
- # by making a list() request.
3053
+ # Returns the specified persistent disk.
3059
3054
  # @param [String] project
3060
3055
  # Project ID for this request.
3061
3056
  # @param [String] zone
@@ -4322,7 +4317,9 @@ module Google
4322
4317
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
4323
4318
  # by a previous list request to get the next page of results.
4324
4319
  # @param [String] parent_id
4325
- # Parent ID for this request.
4320
+ # Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if
4321
+ # the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is
4322
+ # an organization.
4326
4323
  # @param [Boolean] return_partial_success
4327
4324
  # Opt-in for partial success behavior which provides partial results in case of
4328
4325
  # failure. The default value is false.
@@ -4398,7 +4395,9 @@ module Google
4398
4395
  # @param [String] firewall_policy
4399
4396
  # Name of the firewall policy to update.
4400
4397
  # @param [String] parent_id
4401
- # The new parent of the firewall policy.
4398
+ # The new parent of the firewall policy. The ID can be either be "folders/[
4399
+ # FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if
4400
+ # the parent is an organization.
4402
4401
  # @param [String] request_id
4403
4402
  # An optional request ID to identify requests. Specify a unique request ID so
4404
4403
  # that if you must retry your request, the server will know to ignore the
@@ -5647,8 +5646,7 @@ module Google
5647
5646
  execute_or_queue_command(command, &block)
5648
5647
  end
5649
5648
 
5650
- # Returns the specified address resource. Gets a list of available addresses by
5651
- # making a list() request.
5649
+ # Returns the specified address resource.
5652
5650
  # @param [String] project
5653
5651
  # Project ID for this request.
5654
5652
  # @param [String] address
@@ -6453,8 +6451,7 @@ module Google
6453
6451
  execute_or_queue_command(command, &block)
6454
6452
  end
6455
6453
 
6456
- # Returns the specified network endpoint group. Gets a list of available network
6457
- # endpoint groups by making a list() request.
6454
+ # Returns the specified network endpoint group.
6458
6455
  # @param [String] project
6459
6456
  # Project ID for this request.
6460
6457
  # @param [String] network_endpoint_group
@@ -7593,8 +7590,7 @@ module Google
7593
7590
  execute_or_queue_command(command, &block)
7594
7591
  end
7595
7592
 
7596
- # Returns the specified HealthCheck resource. Gets a list of available health
7597
- # checks by making a list() request.
7593
+ # Returns the specified HealthCheck resource.
7598
7594
  # @param [String] project
7599
7595
  # Project ID for this request.
7600
7596
  # @param [String] health_check
@@ -7955,8 +7951,7 @@ module Google
7955
7951
  execute_or_queue_command(command, &block)
7956
7952
  end
7957
7953
 
7958
- # Returns the specified HttpHealthCheck resource. Gets a list of available HTTP
7959
- # health checks by making a list() request.
7954
+ # Returns the specified HttpHealthCheck resource.
7960
7955
  # @param [String] project
7961
7956
  # Project ID for this request.
7962
7957
  # @param [String] http_health_check
@@ -8318,8 +8313,7 @@ module Google
8318
8313
  execute_or_queue_command(command, &block)
8319
8314
  end
8320
8315
 
8321
- # Returns the specified HttpsHealthCheck resource. Gets a list of available
8322
- # HTTPS health checks by making a list() request.
8316
+ # Returns the specified HttpsHealthCheck resource.
8323
8317
  # @param [String] project
8324
8318
  # Project ID for this request.
8325
8319
  # @param [String] https_health_check
@@ -8772,8 +8766,7 @@ module Google
8772
8766
  execute_or_queue_command(command, &block)
8773
8767
  end
8774
8768
 
8775
- # Returns the specified image. Gets a list of available images by making a list()
8776
- # request.
8769
+ # Returns the specified image.
8777
8770
  # @param [String] project
8778
8771
  # Project ID for this request.
8779
8772
  # @param [String] image
@@ -8810,8 +8803,11 @@ module Google
8810
8803
  end
8811
8804
 
8812
8805
  # Returns the latest image that is part of an image family and is not deprecated.
8806
+ # For more information on image families, see Public image families
8807
+ # documentation.
8813
8808
  # @param [String] project
8814
- # Project ID for this request.
8809
+ # The image project that the image belongs to. For example, to get a CentOS
8810
+ # image, specify centos-cloud as the image project.
8815
8811
  # @param [String] family
8816
8812
  # Name of the image family to search for.
8817
8813
  # @param [String] fields
@@ -9619,8 +9615,7 @@ module Google
9619
9615
  execute_or_queue_command(command, &block)
9620
9616
  end
9621
9617
 
9622
- # Returns all of the details about the specified managed instance group. Gets a
9623
- # list of available managed instance groups by making a list() request.
9618
+ # Returns all of the details about the specified managed instance group.
9624
9619
  # @param [String] project
9625
9620
  # Project ID for this request.
9626
9621
  # @param [String] zone
@@ -11382,6 +11377,103 @@ module Google
11382
11377
  execute_or_queue_command(command, &block)
11383
11378
  end
11384
11379
 
11380
+ # Retrieves the list of all InstanceTemplates resources, regional and global,
11381
+ # available to the specified project.
11382
+ # @param [String] project
11383
+ # Name of the project scoping this request.
11384
+ # @param [String] filter
11385
+ # A filter expression that filters resources listed in the response. Most
11386
+ # Compute resources support two types of filter expressions: expressions that
11387
+ # support regular expressions and expressions that follow API improvement
11388
+ # proposal AIP-160. If you want to use AIP-160, your expression must specify the
11389
+ # field name, an operator, and the value that you want to use for filtering. The
11390
+ # value must be a string, a number, or a boolean. The operator must be either `=`
11391
+ # , `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
11392
+ # Engine instances, you can exclude instances named `example-instance` by
11393
+ # specifying `name != example-instance`. The `:` operator can be used with
11394
+ # string fields to match substrings. For non-string fields it is equivalent to
11395
+ # the `=` operator. The `:*` comparison can be used to test whether a key has
11396
+ # been defined. For example, to find all objects with `owner` label use: ```
11397
+ # labels.owner:* ``` You can also filter nested fields. For example, you could
11398
+ # specify `scheduling.automaticRestart = false` to include instances only if
11399
+ # they are not scheduled for automatic restarts. You can use filtering on nested
11400
+ # fields to filter based on resource labels. To filter on multiple expressions,
11401
+ # provide each separate expression within parentheses. For example: ``` (
11402
+ # scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By
11403
+ # default, each expression is an `AND` expression. However, you can include `AND`
11404
+ # and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel
11405
+ # Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
11406
+ # automaticRestart = true) ``` If you want to use a regular expression, use the `
11407
+ # eq` (equal) or `ne` (not equal) operator against a single un-parenthesized
11408
+ # expression with or without quotes or against multiple parenthesized
11409
+ # expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single
11410
+ # quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq
11411
+ # literal) (fieldname2 ne "literal")` The literal value is interpreted as a
11412
+ # regular expression using Google RE2 library syntax. The literal value must
11413
+ # match the entire field. For example, to filter for instances that do not end
11414
+ # with name "instance", you would use `name ne .*instance`.
11415
+ # @param [Boolean] include_all_scopes
11416
+ # Indicates whether every visible scope for each scope type (zone, region,
11417
+ # global) should be included in the response. For new resource types added after
11418
+ # this field, the flag has no effect as new resource types will always include
11419
+ # every visible scope for each scope type in response. For resource types which
11420
+ # predate this field, if this flag is omitted or false, only scopes of the scope
11421
+ # types where the resource type is expected to be found will be included.
11422
+ # @param [Fixnum] max_results
11423
+ # The maximum number of results per page that should be returned. If the number
11424
+ # of available results is larger than `maxResults`, Compute Engine returns a `
11425
+ # nextPageToken` that can be used to get the next page of results in subsequent
11426
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
11427
+ # @param [String] order_by
11428
+ # Sorts list results by a certain order. By default, results are returned in
11429
+ # alphanumerical order based on the resource name. You can also sort results in
11430
+ # descending order based on the creation timestamp using `orderBy="
11431
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
11432
+ # field in reverse chronological order (newest result first). Use this to sort
11433
+ # resources like operations so that the newest operation is returned first.
11434
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
11435
+ # @param [String] page_token
11436
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
11437
+ # by a previous list request to get the next page of results.
11438
+ # @param [Boolean] return_partial_success
11439
+ # Opt-in for partial success behavior which provides partial results in case of
11440
+ # failure. The default value is false.
11441
+ # @param [String] fields
11442
+ # Selector specifying which fields to include in a partial response.
11443
+ # @param [String] quota_user
11444
+ # Available to use for quota purposes for server-side applications. Can be any
11445
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
11446
+ # @param [String] user_ip
11447
+ # Legacy name for parameter that has been superseded by `quotaUser`.
11448
+ # @param [Google::Apis::RequestOptions] options
11449
+ # Request-specific options
11450
+ #
11451
+ # @yield [result, err] Result & error if block supplied
11452
+ # @yieldparam result [Google::Apis::ComputeBeta::InstanceTemplateAggregatedList] parsed result object
11453
+ # @yieldparam err [StandardError] error object if request failed
11454
+ #
11455
+ # @return [Google::Apis::ComputeBeta::InstanceTemplateAggregatedList]
11456
+ #
11457
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11458
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11459
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
11460
+ def aggregated_instance_template_list(project, filter: nil, include_all_scopes: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11461
+ command = make_simple_command(:get, 'projects/{project}/aggregated/instanceTemplates', options)
11462
+ command.response_representation = Google::Apis::ComputeBeta::InstanceTemplateAggregatedList::Representation
11463
+ command.response_class = Google::Apis::ComputeBeta::InstanceTemplateAggregatedList
11464
+ command.params['project'] = project unless project.nil?
11465
+ command.query['filter'] = filter unless filter.nil?
11466
+ command.query['includeAllScopes'] = include_all_scopes unless include_all_scopes.nil?
11467
+ command.query['maxResults'] = max_results unless max_results.nil?
11468
+ command.query['orderBy'] = order_by unless order_by.nil?
11469
+ command.query['pageToken'] = page_token unless page_token.nil?
11470
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
11471
+ command.query['fields'] = fields unless fields.nil?
11472
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
11473
+ command.query['userIp'] = user_ip unless user_ip.nil?
11474
+ execute_or_queue_command(command, &block)
11475
+ end
11476
+
11385
11477
  # Deletes the specified instance template. Deleting an instance template is
11386
11478
  # permanent and cannot be undone. It is not possible to delete templates that
11387
11479
  # are already in use by a managed instance group.
@@ -11431,8 +11523,7 @@ module Google
11431
11523
  execute_or_queue_command(command, &block)
11432
11524
  end
11433
11525
 
11434
- # Returns the specified instance template. Gets a list of available instance
11435
- # templates by making a list() request.
11526
+ # Returns the specified instance template.
11436
11527
  # @param [String] project
11437
11528
  # Project ID for this request.
11438
11529
  # @param [String] instance_template
@@ -12208,8 +12299,7 @@ module Google
12208
12299
  execute_or_queue_command(command, &block)
12209
12300
  end
12210
12301
 
12211
- # Returns the specified Instance resource. Gets a list of available instances by
12212
- # making a list() request.
12302
+ # Returns the specified Instance resource.
12213
12303
  # @param [String] project
12214
12304
  # Project ID for this request.
12215
12305
  # @param [String] zone
@@ -15878,8 +15968,7 @@ module Google
15878
15968
  execute_or_queue_command(command, &block)
15879
15969
  end
15880
15970
 
15881
- # Returns the specified machine image. Gets a list of available machine images
15882
- # by making a list() request.
15971
+ # Returns the specified machine image.
15883
15972
  # @param [String] project
15884
15973
  # Project ID for this request.
15885
15974
  # @param [String] machine_image
@@ -16272,8 +16361,7 @@ module Google
16272
16361
  execute_or_queue_command(command, &block)
16273
16362
  end
16274
16363
 
16275
- # Returns the specified machine type. Gets a list of available machine types by
16276
- # making a list() request.
16364
+ # Returns the specified machine type.
16277
16365
  # @param [String] project
16278
16366
  # Project ID for this request.
16279
16367
  # @param [String] zone
@@ -17420,8 +17508,7 @@ module Google
17420
17508
  execute_or_queue_command(command, &block)
17421
17509
  end
17422
17510
 
17423
- # Returns the specified network endpoint group. Gets a list of available network
17424
- # endpoint groups by making a list() request.
17511
+ # Returns the specified network endpoint group.
17425
17512
  # @param [String] project
17426
17513
  # Project ID for this request.
17427
17514
  # @param [String] zone
@@ -18626,8 +18713,7 @@ module Google
18626
18713
  execute_or_queue_command(command, &block)
18627
18714
  end
18628
18715
 
18629
- # Returns the specified network. Gets a list of available networks by making a
18630
- # list() request.
18716
+ # Returns the specified network.
18631
18717
  # @param [String] project
18632
18718
  # Project ID for this request.
18633
18719
  # @param [String] network
@@ -20143,8 +20229,7 @@ module Google
20143
20229
  execute_or_queue_command(command, &block)
20144
20230
  end
20145
20231
 
20146
- # Returns the specified node template. Gets a list of available node templates
20147
- # by making a list() request.
20232
+ # Returns the specified node template.
20148
20233
  # @param [String] project
20149
20234
  # Project ID for this request.
20150
20235
  # @param [String] region
@@ -20549,8 +20634,7 @@ module Google
20549
20634
  execute_or_queue_command(command, &block)
20550
20635
  end
20551
20636
 
20552
- # Returns the specified node type. Gets a list of available node types by making
20553
- # a list() request.
20637
+ # Returns the specified node type.
20554
20638
  # @param [String] project
20555
20639
  # Project ID for this request.
20556
20640
  # @param [String] zone
@@ -24135,8 +24219,7 @@ module Google
24135
24219
  execute_or_queue_command(command, &block)
24136
24220
  end
24137
24221
 
24138
- # Returns the specified commitment resource. Gets a list of available
24139
- # commitments by making a list() request.
24222
+ # Returns the specified commitment resource.
24140
24223
  # @param [String] project
24141
24224
  # Project ID for this request.
24142
24225
  # @param [String] region
@@ -24472,8 +24555,7 @@ module Google
24472
24555
  execute_or_queue_command(command, &block)
24473
24556
  end
24474
24557
 
24475
- # Returns the specified regional disk type. Gets a list of available disk types
24476
- # by making a list() request.
24558
+ # Returns the specified regional disk type.
24477
24559
  # @param [String] project
24478
24560
  # Project ID for this request.
24479
24561
  # @param [String] region
@@ -25679,8 +25761,7 @@ module Google
25679
25761
  execute_or_queue_command(command, &block)
25680
25762
  end
25681
25763
 
25682
- # Returns the specified HealthCheck resource. Gets a list of available health
25683
- # checks by making a list() request.
25764
+ # Returns the specified HealthCheck resource.
25684
25765
  # @param [String] project
25685
25766
  # Project ID for this request.
25686
25767
  # @param [String] region
@@ -27762,6 +27843,239 @@ module Google
27762
27843
  execute_or_queue_command(command, &block)
27763
27844
  end
27764
27845
 
27846
+ # Deletes the specified instance template. Deleting an instance template is
27847
+ # permanent and cannot be undone.
27848
+ # @param [String] project
27849
+ # Project ID for this request.
27850
+ # @param [String] region
27851
+ # The name of the region for this request.
27852
+ # @param [String] instance_template
27853
+ # The name of the instance template to delete.
27854
+ # @param [String] request_id
27855
+ # An optional request ID to identify requests. Specify a unique request ID so
27856
+ # that if you must retry your request, the server will know to ignore the
27857
+ # request if it has already been completed. For example, consider a situation
27858
+ # where you make an initial request and the request times out. If you make the
27859
+ # request again with the same request ID, the server can check if original
27860
+ # operation with the same request ID was received, and if so, will ignore the
27861
+ # second request. This prevents clients from accidentally creating duplicate
27862
+ # commitments. The request ID must be a valid UUID with the exception that zero
27863
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27864
+ # @param [String] fields
27865
+ # Selector specifying which fields to include in a partial response.
27866
+ # @param [String] quota_user
27867
+ # Available to use for quota purposes for server-side applications. Can be any
27868
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
27869
+ # @param [String] user_ip
27870
+ # Legacy name for parameter that has been superseded by `quotaUser`.
27871
+ # @param [Google::Apis::RequestOptions] options
27872
+ # Request-specific options
27873
+ #
27874
+ # @yield [result, err] Result & error if block supplied
27875
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
27876
+ # @yieldparam err [StandardError] error object if request failed
27877
+ #
27878
+ # @return [Google::Apis::ComputeBeta::Operation]
27879
+ #
27880
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27881
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27882
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
27883
+ def delete_region_instance_template(project, region, instance_template, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27884
+ command = make_simple_command(:delete, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
27885
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
27886
+ command.response_class = Google::Apis::ComputeBeta::Operation
27887
+ command.params['project'] = project unless project.nil?
27888
+ command.params['region'] = region unless region.nil?
27889
+ command.params['instanceTemplate'] = instance_template unless instance_template.nil?
27890
+ command.query['requestId'] = request_id unless request_id.nil?
27891
+ command.query['fields'] = fields unless fields.nil?
27892
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
27893
+ command.query['userIp'] = user_ip unless user_ip.nil?
27894
+ execute_or_queue_command(command, &block)
27895
+ end
27896
+
27897
+ # Returns the specified instance template.
27898
+ # @param [String] project
27899
+ # Project ID for this request.
27900
+ # @param [String] region
27901
+ # The name of the region for this request.
27902
+ # @param [String] instance_template
27903
+ # The name of the instance template.
27904
+ # @param [String] fields
27905
+ # Selector specifying which fields to include in a partial response.
27906
+ # @param [String] quota_user
27907
+ # Available to use for quota purposes for server-side applications. Can be any
27908
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
27909
+ # @param [String] user_ip
27910
+ # Legacy name for parameter that has been superseded by `quotaUser`.
27911
+ # @param [Google::Apis::RequestOptions] options
27912
+ # Request-specific options
27913
+ #
27914
+ # @yield [result, err] Result & error if block supplied
27915
+ # @yieldparam result [Google::Apis::ComputeBeta::InstanceTemplate] parsed result object
27916
+ # @yieldparam err [StandardError] error object if request failed
27917
+ #
27918
+ # @return [Google::Apis::ComputeBeta::InstanceTemplate]
27919
+ #
27920
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27921
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27922
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
27923
+ def get_region_instance_template(project, region, instance_template, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27924
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
27925
+ command.response_representation = Google::Apis::ComputeBeta::InstanceTemplate::Representation
27926
+ command.response_class = Google::Apis::ComputeBeta::InstanceTemplate
27927
+ command.params['project'] = project unless project.nil?
27928
+ command.params['region'] = region unless region.nil?
27929
+ command.params['instanceTemplate'] = instance_template unless instance_template.nil?
27930
+ command.query['fields'] = fields unless fields.nil?
27931
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
27932
+ command.query['userIp'] = user_ip unless user_ip.nil?
27933
+ execute_or_queue_command(command, &block)
27934
+ end
27935
+
27936
+ # Creates an instance template in the specified project and region using the
27937
+ # global instance template whose URL is included in the request.
27938
+ # @param [String] project
27939
+ # Project ID for this request.
27940
+ # @param [String] region
27941
+ # The name of the region for this request.
27942
+ # @param [Google::Apis::ComputeBeta::InstanceTemplate] instance_template_object
27943
+ # @param [String] request_id
27944
+ # An optional request ID to identify requests. Specify a unique request ID so
27945
+ # that if you must retry your request, the server will know to ignore the
27946
+ # request if it has already been completed. For example, consider a situation
27947
+ # where you make an initial request and the request times out. If you make the
27948
+ # request again with the same request ID, the server can check if original
27949
+ # operation with the same request ID was received, and if so, will ignore the
27950
+ # second request. This prevents clients from accidentally creating duplicate
27951
+ # commitments. The request ID must be a valid UUID with the exception that zero
27952
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27953
+ # @param [String] fields
27954
+ # Selector specifying which fields to include in a partial response.
27955
+ # @param [String] quota_user
27956
+ # Available to use for quota purposes for server-side applications. Can be any
27957
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
27958
+ # @param [String] user_ip
27959
+ # Legacy name for parameter that has been superseded by `quotaUser`.
27960
+ # @param [Google::Apis::RequestOptions] options
27961
+ # Request-specific options
27962
+ #
27963
+ # @yield [result, err] Result & error if block supplied
27964
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
27965
+ # @yieldparam err [StandardError] error object if request failed
27966
+ #
27967
+ # @return [Google::Apis::ComputeBeta::Operation]
27968
+ #
27969
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27970
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27971
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
27972
+ def insert_region_instance_template(project, region, instance_template_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27973
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceTemplates', options)
27974
+ command.request_representation = Google::Apis::ComputeBeta::InstanceTemplate::Representation
27975
+ command.request_object = instance_template_object
27976
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
27977
+ command.response_class = Google::Apis::ComputeBeta::Operation
27978
+ command.params['project'] = project unless project.nil?
27979
+ command.params['region'] = region unless region.nil?
27980
+ command.query['requestId'] = request_id unless request_id.nil?
27981
+ command.query['fields'] = fields unless fields.nil?
27982
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
27983
+ command.query['userIp'] = user_ip unless user_ip.nil?
27984
+ execute_or_queue_command(command, &block)
27985
+ end
27986
+
27987
+ # Retrieves a list of instance templates that are contained within the specified
27988
+ # project and region.
27989
+ # @param [String] project
27990
+ # Project ID for this request.
27991
+ # @param [String] region
27992
+ # The name of the regions for this request.
27993
+ # @param [String] filter
27994
+ # A filter expression that filters resources listed in the response. Most
27995
+ # Compute resources support two types of filter expressions: expressions that
27996
+ # support regular expressions and expressions that follow API improvement
27997
+ # proposal AIP-160. If you want to use AIP-160, your expression must specify the
27998
+ # field name, an operator, and the value that you want to use for filtering. The
27999
+ # value must be a string, a number, or a boolean. The operator must be either `=`
28000
+ # , `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
28001
+ # Engine instances, you can exclude instances named `example-instance` by
28002
+ # specifying `name != example-instance`. The `:` operator can be used with
28003
+ # string fields to match substrings. For non-string fields it is equivalent to
28004
+ # the `=` operator. The `:*` comparison can be used to test whether a key has
28005
+ # been defined. For example, to find all objects with `owner` label use: ```
28006
+ # labels.owner:* ``` You can also filter nested fields. For example, you could
28007
+ # specify `scheduling.automaticRestart = false` to include instances only if
28008
+ # they are not scheduled for automatic restarts. You can use filtering on nested
28009
+ # fields to filter based on resource labels. To filter on multiple expressions,
28010
+ # provide each separate expression within parentheses. For example: ``` (
28011
+ # scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By
28012
+ # default, each expression is an `AND` expression. However, you can include `AND`
28013
+ # and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel
28014
+ # Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
28015
+ # automaticRestart = true) ``` If you want to use a regular expression, use the `
28016
+ # eq` (equal) or `ne` (not equal) operator against a single un-parenthesized
28017
+ # expression with or without quotes or against multiple parenthesized
28018
+ # expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single
28019
+ # quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq
28020
+ # literal) (fieldname2 ne "literal")` The literal value is interpreted as a
28021
+ # regular expression using Google RE2 library syntax. The literal value must
28022
+ # match the entire field. For example, to filter for instances that do not end
28023
+ # with name "instance", you would use `name ne .*instance`.
28024
+ # @param [Fixnum] max_results
28025
+ # The maximum number of results per page that should be returned. If the number
28026
+ # of available results is larger than `maxResults`, Compute Engine returns a `
28027
+ # nextPageToken` that can be used to get the next page of results in subsequent
28028
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
28029
+ # @param [String] order_by
28030
+ # Sorts list results by a certain order. By default, results are returned in
28031
+ # alphanumerical order based on the resource name. You can also sort results in
28032
+ # descending order based on the creation timestamp using `orderBy="
28033
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
28034
+ # field in reverse chronological order (newest result first). Use this to sort
28035
+ # resources like operations so that the newest operation is returned first.
28036
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
28037
+ # @param [String] page_token
28038
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
28039
+ # by a previous list request to get the next page of results.
28040
+ # @param [Boolean] return_partial_success
28041
+ # Opt-in for partial success behavior which provides partial results in case of
28042
+ # failure. The default value is false.
28043
+ # @param [String] fields
28044
+ # Selector specifying which fields to include in a partial response.
28045
+ # @param [String] quota_user
28046
+ # Available to use for quota purposes for server-side applications. Can be any
28047
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28048
+ # @param [String] user_ip
28049
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28050
+ # @param [Google::Apis::RequestOptions] options
28051
+ # Request-specific options
28052
+ #
28053
+ # @yield [result, err] Result & error if block supplied
28054
+ # @yieldparam result [Google::Apis::ComputeBeta::InstanceTemplateList] parsed result object
28055
+ # @yieldparam err [StandardError] error object if request failed
28056
+ #
28057
+ # @return [Google::Apis::ComputeBeta::InstanceTemplateList]
28058
+ #
28059
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28060
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28061
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28062
+ def list_region_instance_templates(project, region, filter: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28063
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates', options)
28064
+ command.response_representation = Google::Apis::ComputeBeta::InstanceTemplateList::Representation
28065
+ command.response_class = Google::Apis::ComputeBeta::InstanceTemplateList
28066
+ command.params['project'] = project unless project.nil?
28067
+ command.params['region'] = region unless region.nil?
28068
+ command.query['filter'] = filter unless filter.nil?
28069
+ command.query['maxResults'] = max_results unless max_results.nil?
28070
+ command.query['orderBy'] = order_by unless order_by.nil?
28071
+ command.query['pageToken'] = page_token unless page_token.nil?
28072
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
28073
+ command.query['fields'] = fields unless fields.nil?
28074
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28075
+ command.query['userIp'] = user_ip unless user_ip.nil?
28076
+ execute_or_queue_command(command, &block)
28077
+ end
28078
+
27765
28079
  # Creates multiple instances in a given region. Count specifies the number of
27766
28080
  # instances to create.
27767
28081
  # @param [String] project
@@ -27866,8 +28180,7 @@ module Google
27866
28180
  execute_or_queue_command(command, &block)
27867
28181
  end
27868
28182
 
27869
- # Returns the specified network endpoint group. Gets a list of available network
27870
- # endpoint groups by making a list() request.
28183
+ # Returns the specified network endpoint group.
27871
28184
  # @param [String] project
27872
28185
  # Project ID for this request.
27873
28186
  # @param [String] region
@@ -30448,8 +30761,7 @@ module Google
30448
30761
  execute_or_queue_command(command, &block)
30449
30762
  end
30450
30763
 
30451
- # Returns the specified TargetHttpProxy resource in the specified region. Gets a
30452
- # list of available target HTTP proxies by making a list() request.
30764
+ # Returns the specified TargetHttpProxy resource in the specified region.
30453
30765
  # @param [String] project
30454
30766
  # Project ID for this request.
30455
30767
  # @param [String] region
@@ -30776,8 +31088,7 @@ module Google
30776
31088
  execute_or_queue_command(command, &block)
30777
31089
  end
30778
31090
 
30779
- # Returns the specified TargetHttpsProxy resource in the specified region. Gets
30780
- # a list of available target HTTP proxies by making a list() request.
31091
+ # Returns the specified TargetHttpsProxy resource in the specified region.
30781
31092
  # @param [String] project
30782
31093
  # Project ID for this request.
30783
31094
  # @param [String] region
@@ -31478,8 +31789,7 @@ module Google
31478
31789
  execute_or_queue_command(command, &block)
31479
31790
  end
31480
31791
 
31481
- # Returns the specified UrlMap resource. Gets a list of available URL maps by
31482
- # making a list() request.
31792
+ # Returns the specified UrlMap resource.
31483
31793
  # @param [String] project
31484
31794
  # Project ID for this request.
31485
31795
  # @param [String] region
@@ -31877,14 +32187,13 @@ module Google
31877
32187
  execute_or_queue_command(command, &block)
31878
32188
  end
31879
32189
 
31880
- # Returns the specified Region resource. Gets a list of available regions by
31881
- # making a list() request. To decrease latency for this method, you can
31882
- # optionally omit any unneeded information from the response by using a field
31883
- # mask. This practice is especially recommended for unused quota information (
31884
- # the `quotas` field). To exclude one or more fields, set your request's `fields`
31885
- # query parameter to only include the fields you need. For example, to only
31886
- # include the `id` and `selfLink` fields, add the query parameter `?fields=id,
31887
- # selfLink` to your request.
32190
+ # Returns the specified Region resource. To decrease latency for this method,
32191
+ # you can optionally omit any unneeded information from the response by using a
32192
+ # field mask. This practice is especially recommended for unused quota
32193
+ # information (the `quotas` field). To exclude one or more fields, set your
32194
+ # request's `fields` query parameter to only include the fields you need. For
32195
+ # example, to only include the `id` and `selfLink` fields, add the query
32196
+ # parameter `?fields=id,selfLink` to your request.
31888
32197
  # @param [String] project
31889
32198
  # Project ID for this request.
31890
32199
  # @param [String] region
@@ -33240,8 +33549,7 @@ module Google
33240
33549
  execute_or_queue_command(command, &block)
33241
33550
  end
33242
33551
 
33243
- # Returns the specified Router resource. Gets a list of available routers by
33244
- # making a list() request.
33552
+ # Returns the specified Router resource.
33245
33553
  # @param [String] project
33246
33554
  # Project ID for this request.
33247
33555
  # @param [String] region
@@ -33804,8 +34112,7 @@ module Google
33804
34112
  execute_or_queue_command(command, &block)
33805
34113
  end
33806
34114
 
33807
- # Returns the specified Route resource. Gets a list of available routes by
33808
- # making a list() request.
34115
+ # Returns the specified Route resource.
33809
34116
  # @param [String] project
33810
34117
  # Project ID for this request.
33811
34118
  # @param [String] route
@@ -35284,8 +35591,7 @@ module Google
35284
35591
  execute_or_queue_command(command, &block)
35285
35592
  end
35286
35593
 
35287
- # Returns the specified Snapshot resource. Gets a list of available snapshots by
35288
- # making a list() request.
35594
+ # Returns the specified Snapshot resource.
35289
35595
  # @param [String] project
35290
35596
  # Project ID for this request.
35291
35597
  # @param [String] snapshot
@@ -35763,8 +36069,7 @@ module Google
35763
36069
  execute_or_queue_command(command, &block)
35764
36070
  end
35765
36071
 
35766
- # Returns the specified SslCertificate resource. Gets a list of available SSL
35767
- # certificates by making a list() request.
36072
+ # Returns the specified SslCertificate resource.
35768
36073
  # @param [String] project
35769
36074
  # Project ID for this request.
35770
36075
  # @param [String] ssl_certificate
@@ -36159,8 +36464,7 @@ module Google
36159
36464
  execute_or_queue_command(command, &block)
36160
36465
  end
36161
36466
 
36162
- # Returns the specified SSL policy resource. Gets a list of available SSL
36163
- # policies by making a list() request.
36467
+ # Returns the specified SSL policy resource.
36164
36468
  # @param [String] project
36165
36469
  # Project ID for this request.
36166
36470
  # @param [Google::Apis::ComputeBeta::SslPolicy] ssl_policy_object
@@ -36673,8 +36977,7 @@ module Google
36673
36977
  execute_or_queue_command(command, &block)
36674
36978
  end
36675
36979
 
36676
- # Returns the specified subnetwork. Gets a list of available subnetworks list()
36677
- # request.
36980
+ # Returns the specified subnetwork.
36678
36981
  # @param [String] project
36679
36982
  # Project ID for this request.
36680
36983
  # @param [String] region
@@ -37649,8 +37952,7 @@ module Google
37649
37952
  execute_or_queue_command(command, &block)
37650
37953
  end
37651
37954
 
37652
- # Returns the specified TargetHttpProxy resource. Gets a list of available
37653
- # target HTTP proxies by making a list() request.
37955
+ # Returns the specified TargetHttpProxy resource.
37654
37956
  # @param [String] project
37655
37957
  # Project ID for this request.
37656
37958
  # @param [String] target_http_proxy
@@ -38108,8 +38410,7 @@ module Google
38108
38410
  execute_or_queue_command(command, &block)
38109
38411
  end
38110
38412
 
38111
- # Returns the specified TargetHttpsProxy resource. Gets a list of available
38112
- # target HTTPS proxies by making a list() request.
38413
+ # Returns the specified TargetHttpsProxy resource.
38113
38414
  # @param [String] project
38114
38415
  # Project ID for this request.
38115
38416
  # @param [String] target_https_proxy
@@ -38775,8 +39076,7 @@ module Google
38775
39076
  execute_or_queue_command(command, &block)
38776
39077
  end
38777
39078
 
38778
- # Returns the specified TargetInstance resource. Gets a list of available target
38779
- # instances by making a list() request.
39079
+ # Returns the specified TargetInstance resource.
38780
39080
  # @param [String] project
38781
39081
  # Project ID for this request.
38782
39082
  # @param [String] zone
@@ -39252,8 +39552,7 @@ module Google
39252
39552
  execute_or_queue_command(command, &block)
39253
39553
  end
39254
39554
 
39255
- # Returns the specified target pool. Gets a list of available target pools by
39256
- # making a list() request.
39555
+ # Returns the specified target pool.
39257
39556
  # @param [String] project
39258
39557
  # Project ID for this request.
39259
39558
  # @param [String] region
@@ -39728,8 +40027,7 @@ module Google
39728
40027
  execute_or_queue_command(command, &block)
39729
40028
  end
39730
40029
 
39731
- # Returns the specified TargetSslProxy resource. Gets a list of available target
39732
- # SSL proxies by making a list() request.
40030
+ # Returns the specified TargetSslProxy resource.
39733
40031
  # @param [String] project
39734
40032
  # Project ID for this request.
39735
40033
  # @param [String] target_ssl_proxy
@@ -40340,8 +40638,7 @@ module Google
40340
40638
  execute_or_queue_command(command, &block)
40341
40639
  end
40342
40640
 
40343
- # Returns the specified TargetTcpProxy resource. Gets a list of available target
40344
- # TCP proxies by making a list() request.
40641
+ # Returns the specified TargetTcpProxy resource.
40345
40642
  # @param [String] project
40346
40643
  # Project ID for this request.
40347
40644
  # @param [String] target_tcp_proxy
@@ -40799,8 +41096,7 @@ module Google
40799
41096
  execute_or_queue_command(command, &block)
40800
41097
  end
40801
41098
 
40802
- # Returns the specified target VPN gateway. Gets a list of available target VPN
40803
- # gateways by making a list() request.
41099
+ # Returns the specified target VPN gateway.
40804
41100
  # @param [String] project
40805
41101
  # Project ID for this request.
40806
41102
  # @param [String] region
@@ -41222,8 +41518,7 @@ module Google
41222
41518
  execute_or_queue_command(command, &block)
41223
41519
  end
41224
41520
 
41225
- # Returns the specified UrlMap resource. Gets a list of available URL maps by
41226
- # making a list() request.
41521
+ # Returns the specified UrlMap resource.
41227
41522
  # @param [String] project
41228
41523
  # Project ID for this request.
41229
41524
  # @param [String] url_map
@@ -41774,8 +42069,7 @@ module Google
41774
42069
  execute_or_queue_command(command, &block)
41775
42070
  end
41776
42071
 
41777
- # Returns the specified VPN gateway. Gets a list of available VPN gateways by
41778
- # making a list() request.
42072
+ # Returns the specified VPN gateway.
41779
42073
  # @param [String] project
41780
42074
  # Project ID for this request.
41781
42075
  # @param [String] region
@@ -42237,8 +42531,7 @@ module Google
42237
42531
  execute_or_queue_command(command, &block)
42238
42532
  end
42239
42533
 
42240
- # Returns the specified VpnTunnel resource. Gets a list of available VPN tunnels
42241
- # by making a list() request.
42534
+ # Returns the specified VpnTunnel resource.
42242
42535
  # @param [String] project
42243
42536
  # Project ID for this request.
42244
42537
  # @param [String] region
@@ -42731,8 +43024,7 @@ module Google
42731
43024
  execute_or_queue_command(command, &block)
42732
43025
  end
42733
43026
 
42734
- # Returns the specified Zone resource. Gets a list of available zones by making
42735
- # a list() request.
43027
+ # Returns the specified Zone resource.
42736
43028
  # @param [String] project
42737
43029
  # Project ID for this request.
42738
43030
  # @param [String] zone