google-apis-compute_v1 0.89.0 → 0.90.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.
@@ -55,7 +55,8 @@ module Google
55
55
  @batch_path = 'batch/compute/v1'
56
56
  end
57
57
 
58
- # Retrieves an aggregated list of accelerator types.
58
+ # Retrieves an aggregated list of accelerator types. To prevent failure, Google
59
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
59
60
  # @param [String] project
60
61
  # Project ID for this request.
61
62
  # @param [String] filter
@@ -115,7 +116,9 @@ module Google
115
116
  # by a previous list request to get the next page of results.
116
117
  # @param [Boolean] return_partial_success
117
118
  # Opt-in for partial success behavior which provides partial results in case of
118
- # failure. The default value is false.
119
+ # failure. The default value is false. For example, when partial success
120
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
121
+ # resources in the zone or no resources, with an error code.
119
122
  # @param [Fixnum] service_project_number
120
123
  # The Shared VPC service project id or service project number for which
121
124
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -251,7 +254,9 @@ module Google
251
254
  # by a previous list request to get the next page of results.
252
255
  # @param [Boolean] return_partial_success
253
256
  # Opt-in for partial success behavior which provides partial results in case of
254
- # failure. The default value is false.
257
+ # failure. The default value is false. For example, when partial success
258
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
259
+ # resources in the zone or no resources, with an error code.
255
260
  # @param [String] fields
256
261
  # Selector specifying which fields to include in a partial response.
257
262
  # @param [String] quota_user
@@ -288,7 +293,8 @@ module Google
288
293
  execute_or_queue_command(command, &block)
289
294
  end
290
295
 
291
- # Retrieves an aggregated list of addresses.
296
+ # Retrieves an aggregated list of addresses. To prevent failure, Google
297
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
292
298
  # @param [String] project
293
299
  # Project ID for this request.
294
300
  # @param [String] filter
@@ -348,7 +354,9 @@ module Google
348
354
  # by a previous list request to get the next page of results.
349
355
  # @param [Boolean] return_partial_success
350
356
  # Opt-in for partial success behavior which provides partial results in case of
351
- # failure. The default value is false.
357
+ # failure. The default value is false. For example, when partial success
358
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
359
+ # resources in the zone or no resources, with an error code.
352
360
  # @param [Fixnum] service_project_number
353
361
  # The Shared VPC service project id or service project number for which
354
362
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -584,7 +592,9 @@ module Google
584
592
  # by a previous list request to get the next page of results.
585
593
  # @param [Boolean] return_partial_success
586
594
  # Opt-in for partial success behavior which provides partial results in case of
587
- # failure. The default value is false.
595
+ # failure. The default value is false. For example, when partial success
596
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
597
+ # resources in the zone or no resources, with an error code.
588
598
  # @param [String] fields
589
599
  # Selector specifying which fields to include in a partial response.
590
600
  # @param [String] quota_user
@@ -728,7 +738,8 @@ module Google
728
738
  execute_or_queue_command(command, &block)
729
739
  end
730
740
 
731
- # Retrieves an aggregated list of autoscalers.
741
+ # Retrieves an aggregated list of autoscalers. To prevent failure, Google
742
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
732
743
  # @param [String] project
733
744
  # Project ID for this request.
734
745
  # @param [String] filter
@@ -788,7 +799,9 @@ module Google
788
799
  # by a previous list request to get the next page of results.
789
800
  # @param [Boolean] return_partial_success
790
801
  # Opt-in for partial success behavior which provides partial results in case of
791
- # failure. The default value is false.
802
+ # failure. The default value is false. For example, when partial success
803
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
804
+ # resources in the zone or no resources, with an error code.
792
805
  # @param [Fixnum] service_project_number
793
806
  # The Shared VPC service project id or service project number for which
794
807
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -1024,7 +1037,9 @@ module Google
1024
1037
  # by a previous list request to get the next page of results.
1025
1038
  # @param [Boolean] return_partial_success
1026
1039
  # Opt-in for partial success behavior which provides partial results in case of
1027
- # failure. The default value is false.
1040
+ # failure. The default value is false. For example, when partial success
1041
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
1042
+ # resources in the zone or no resources, with an error code.
1028
1043
  # @param [String] fields
1029
1044
  # Selector specifying which fields to include in a partial response.
1030
1045
  # @param [String] quota_user
@@ -1497,7 +1512,9 @@ module Google
1497
1512
  # by a previous list request to get the next page of results.
1498
1513
  # @param [Boolean] return_partial_success
1499
1514
  # Opt-in for partial success behavior which provides partial results in case of
1500
- # failure. The default value is false.
1515
+ # failure. The default value is false. For example, when partial success
1516
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
1517
+ # resources in the zone or no resources, with an error code.
1501
1518
  # @param [String] fields
1502
1519
  # Selector specifying which fields to include in a partial response.
1503
1520
  # @param [String] quota_user
@@ -1818,7 +1835,8 @@ module Google
1818
1835
  end
1819
1836
 
1820
1837
  # Retrieves the list of all BackendService resources, regional and global,
1821
- # available to the specified project.
1838
+ # available to the specified project. To prevent failure, Google recommends that
1839
+ # you set the `returnPartialSuccess` parameter to `true`.
1822
1840
  # @param [String] project
1823
1841
  # Name of the project scoping this request.
1824
1842
  # @param [String] filter
@@ -1878,7 +1896,9 @@ module Google
1878
1896
  # by a previous list request to get the next page of results.
1879
1897
  # @param [Boolean] return_partial_success
1880
1898
  # Opt-in for partial success behavior which provides partial results in case of
1881
- # failure. The default value is false.
1899
+ # failure. The default value is false. For example, when partial success
1900
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
1901
+ # resources in the zone or no resources, with an error code.
1882
1902
  # @param [Fixnum] service_project_number
1883
1903
  # The Shared VPC service project id or service project number for which
1884
1904
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -2236,7 +2256,9 @@ module Google
2236
2256
  # by a previous list request to get the next page of results.
2237
2257
  # @param [Boolean] return_partial_success
2238
2258
  # Opt-in for partial success behavior which provides partial results in case of
2239
- # failure. The default value is false.
2259
+ # failure. The default value is false. For example, when partial success
2260
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
2261
+ # resources in the zone or no resources, with an error code.
2240
2262
  # @param [String] fields
2241
2263
  # Selector specifying which fields to include in a partial response.
2242
2264
  # @param [String] quota_user
@@ -2326,7 +2348,9 @@ module Google
2326
2348
  # by a previous list request to get the next page of results.
2327
2349
  # @param [Boolean] return_partial_success
2328
2350
  # Opt-in for partial success behavior which provides partial results in case of
2329
- # failure. The default value is false.
2351
+ # failure. The default value is false. For example, when partial success
2352
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
2353
+ # resources in the zone or no resources, with an error code.
2330
2354
  # @param [String] fields
2331
2355
  # Selector specifying which fields to include in a partial response.
2332
2356
  # @param [String] quota_user
@@ -2648,7 +2672,8 @@ module Google
2648
2672
  execute_or_queue_command(command, &block)
2649
2673
  end
2650
2674
 
2651
- # Retrieves an aggregated list of disk types.
2675
+ # Retrieves an aggregated list of disk types. To prevent failure, Google
2676
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
2652
2677
  # @param [String] project
2653
2678
  # Project ID for this request.
2654
2679
  # @param [String] filter
@@ -2708,7 +2733,9 @@ module Google
2708
2733
  # by a previous list request to get the next page of results.
2709
2734
  # @param [Boolean] return_partial_success
2710
2735
  # Opt-in for partial success behavior which provides partial results in case of
2711
- # failure. The default value is false.
2736
+ # failure. The default value is false. For example, when partial success
2737
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
2738
+ # resources in the zone or no resources, with an error code.
2712
2739
  # @param [Fixnum] service_project_number
2713
2740
  # The Shared VPC service project id or service project number for which
2714
2741
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -2843,7 +2870,9 @@ module Google
2843
2870
  # by a previous list request to get the next page of results.
2844
2871
  # @param [Boolean] return_partial_success
2845
2872
  # Opt-in for partial success behavior which provides partial results in case of
2846
- # failure. The default value is false.
2873
+ # failure. The default value is false. For example, when partial success
2874
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
2875
+ # resources in the zone or no resources, with an error code.
2847
2876
  # @param [String] fields
2848
2877
  # Selector specifying which fields to include in a partial response.
2849
2878
  # @param [String] quota_user
@@ -2934,7 +2963,8 @@ module Google
2934
2963
  execute_or_queue_command(command, &block)
2935
2964
  end
2936
2965
 
2937
- # Retrieves an aggregated list of persistent disks.
2966
+ # Retrieves an aggregated list of persistent disks. To prevent failure, Google
2967
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
2938
2968
  # @param [String] project
2939
2969
  # Project ID for this request.
2940
2970
  # @param [String] filter
@@ -2994,7 +3024,9 @@ module Google
2994
3024
  # by a previous list request to get the next page of results.
2995
3025
  # @param [Boolean] return_partial_success
2996
3026
  # Opt-in for partial success behavior which provides partial results in case of
2997
- # failure. The default value is false.
3027
+ # failure. The default value is false. For example, when partial success
3028
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
3029
+ # resources in the zone or no resources, with an error code.
2998
3030
  # @param [Fixnum] service_project_number
2999
3031
  # The Shared VPC service project id or service project number for which
3000
3032
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -3391,7 +3423,9 @@ module Google
3391
3423
  # by a previous list request to get the next page of results.
3392
3424
  # @param [Boolean] return_partial_success
3393
3425
  # Opt-in for partial success behavior which provides partial results in case of
3394
- # failure. The default value is false.
3426
+ # failure. The default value is false. For example, when partial success
3427
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
3428
+ # resources in the zone or no resources, with an error code.
3395
3429
  # @param [String] fields
3396
3430
  # Selector specifying which fields to include in a partial response.
3397
3431
  # @param [String] quota_user
@@ -4075,7 +4109,9 @@ module Google
4075
4109
  # by a previous list request to get the next page of results.
4076
4110
  # @param [Boolean] return_partial_success
4077
4111
  # Opt-in for partial success behavior which provides partial results in case of
4078
- # failure. The default value is false.
4112
+ # failure. The default value is false. For example, when partial success
4113
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
4114
+ # resources in the zone or no resources, with an error code.
4079
4115
  # @param [String] fields
4080
4116
  # Selector specifying which fields to include in a partial response.
4081
4117
  # @param [String] quota_user
@@ -4628,7 +4664,9 @@ module Google
4628
4664
  # an organization.
4629
4665
  # @param [Boolean] return_partial_success
4630
4666
  # Opt-in for partial success behavior which provides partial results in case of
4631
- # failure. The default value is false.
4667
+ # failure. The default value is false. For example, when partial success
4668
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
4669
+ # resources in the zone or no resources, with an error code.
4632
4670
  # @param [String] fields
4633
4671
  # Selector specifying which fields to include in a partial response.
4634
4672
  # @param [String] quota_user
@@ -5194,7 +5232,9 @@ module Google
5194
5232
  # by a previous list request to get the next page of results.
5195
5233
  # @param [Boolean] return_partial_success
5196
5234
  # Opt-in for partial success behavior which provides partial results in case of
5197
- # failure. The default value is false.
5235
+ # failure. The default value is false. For example, when partial success
5236
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
5237
+ # resources in the zone or no resources, with an error code.
5198
5238
  # @param [String] fields
5199
5239
  # Selector specifying which fields to include in a partial response.
5200
5240
  # @param [String] quota_user
@@ -5334,7 +5374,8 @@ module Google
5334
5374
  execute_or_queue_command(command, &block)
5335
5375
  end
5336
5376
 
5337
- # Retrieves an aggregated list of forwarding rules.
5377
+ # Retrieves an aggregated list of forwarding rules. To prevent failure, Google
5378
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
5338
5379
  # @param [String] project
5339
5380
  # Project ID for this request.
5340
5381
  # @param [String] filter
@@ -5394,7 +5435,9 @@ module Google
5394
5435
  # by a previous list request to get the next page of results.
5395
5436
  # @param [Boolean] return_partial_success
5396
5437
  # Opt-in for partial success behavior which provides partial results in case of
5397
- # failure. The default value is false.
5438
+ # failure. The default value is false. For example, when partial success
5439
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
5440
+ # resources in the zone or no resources, with an error code.
5398
5441
  # @param [Fixnum] service_project_number
5399
5442
  # The Shared VPC service project id or service project number for which
5400
5443
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -5631,7 +5674,9 @@ module Google
5631
5674
  # by a previous list request to get the next page of results.
5632
5675
  # @param [Boolean] return_partial_success
5633
5676
  # Opt-in for partial success behavior which provides partial results in case of
5634
- # failure. The default value is false.
5677
+ # failure. The default value is false. For example, when partial success
5678
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
5679
+ # resources in the zone or no resources, with an error code.
5635
5680
  # @param [String] fields
5636
5681
  # Selector specifying which fields to include in a partial response.
5637
5682
  # @param [String] quota_user
@@ -6015,7 +6060,9 @@ module Google
6015
6060
  # by a previous list request to get the next page of results.
6016
6061
  # @param [Boolean] return_partial_success
6017
6062
  # Opt-in for partial success behavior which provides partial results in case of
6018
- # failure. The default value is false.
6063
+ # failure. The default value is false. For example, when partial success
6064
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
6065
+ # resources in the zone or no resources, with an error code.
6019
6066
  # @param [String] fields
6020
6067
  # Selector specifying which fields to include in a partial response.
6021
6068
  # @param [String] quota_user
@@ -6327,7 +6374,9 @@ module Google
6327
6374
  # by a previous list request to get the next page of results.
6328
6375
  # @param [Boolean] return_partial_success
6329
6376
  # Opt-in for partial success behavior which provides partial results in case of
6330
- # failure. The default value is false.
6377
+ # failure. The default value is false. For example, when partial success
6378
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
6379
+ # resources in the zone or no resources, with an error code.
6331
6380
  # @param [String] fields
6332
6381
  # Selector specifying which fields to include in a partial response.
6333
6382
  # @param [String] quota_user
@@ -6795,7 +6844,9 @@ module Google
6795
6844
  # by a previous list request to get the next page of results.
6796
6845
  # @param [Boolean] return_partial_success
6797
6846
  # Opt-in for partial success behavior which provides partial results in case of
6798
- # failure. The default value is false.
6847
+ # failure. The default value is false. For example, when partial success
6848
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
6849
+ # resources in the zone or no resources, with an error code.
6799
6850
  # @param [String] fields
6800
6851
  # Selector specifying which fields to include in a partial response.
6801
6852
  # @param [String] quota_user
@@ -6887,7 +6938,9 @@ module Google
6887
6938
  # by a previous list request to get the next page of results.
6888
6939
  # @param [Boolean] return_partial_success
6889
6940
  # Opt-in for partial success behavior which provides partial results in case of
6890
- # failure. The default value is false.
6941
+ # failure. The default value is false. For example, when partial success
6942
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
6943
+ # resources in the zone or no resources, with an error code.
6891
6944
  # @param [String] fields
6892
6945
  # Selector specifying which fields to include in a partial response.
6893
6946
  # @param [String] quota_user
@@ -6924,7 +6977,8 @@ module Google
6924
6977
  execute_or_queue_command(command, &block)
6925
6978
  end
6926
6979
 
6927
- # Retrieves an aggregated list of all operations.
6980
+ # Retrieves an aggregated list of all operations. To prevent failure, Google
6981
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
6928
6982
  # @param [String] project
6929
6983
  # Project ID for this request.
6930
6984
  # @param [String] filter
@@ -6984,7 +7038,9 @@ module Google
6984
7038
  # by a previous list request to get the next page of results.
6985
7039
  # @param [Boolean] return_partial_success
6986
7040
  # Opt-in for partial success behavior which provides partial results in case of
6987
- # failure. The default value is false.
7041
+ # failure. The default value is false. For example, when partial success
7042
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
7043
+ # resources in the zone or no resources, with an error code.
6988
7044
  # @param [Fixnum] service_project_number
6989
7045
  # The Shared VPC service project id or service project number for which
6990
7046
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -7148,7 +7204,9 @@ module Google
7148
7204
  # by a previous list request to get the next page of results.
7149
7205
  # @param [Boolean] return_partial_success
7150
7206
  # Opt-in for partial success behavior which provides partial results in case of
7151
- # failure. The default value is false.
7207
+ # failure. The default value is false. For example, when partial success
7208
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
7209
+ # resources in the zone or no resources, with an error code.
7152
7210
  # @param [String] fields
7153
7211
  # Selector specifying which fields to include in a partial response.
7154
7212
  # @param [String] quota_user
@@ -7354,7 +7412,9 @@ module Google
7354
7412
  # Parent ID for this request.
7355
7413
  # @param [Boolean] return_partial_success
7356
7414
  # Opt-in for partial success behavior which provides partial results in case of
7357
- # failure. The default value is false.
7415
+ # failure. The default value is false. For example, when partial success
7416
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
7417
+ # resources in the zone or no resources, with an error code.
7358
7418
  # @param [String] fields
7359
7419
  # Selector specifying which fields to include in a partial response.
7360
7420
  # @param [String] quota_user
@@ -7574,7 +7634,9 @@ module Google
7574
7634
  # by a previous list request to get the next page of results.
7575
7635
  # @param [Boolean] return_partial_success
7576
7636
  # Opt-in for partial success behavior which provides partial results in case of
7577
- # failure. The default value is false.
7637
+ # failure. The default value is false. For example, when partial success
7638
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
7639
+ # resources in the zone or no resources, with an error code.
7578
7640
  # @param [String] fields
7579
7641
  # Selector specifying which fields to include in a partial response.
7580
7642
  # @param [String] quota_user
@@ -7663,7 +7725,8 @@ module Google
7663
7725
  end
7664
7726
 
7665
7727
  # Retrieves the list of all HealthCheck resources, regional and global,
7666
- # available to the specified project.
7728
+ # available to the specified project. To prevent failure, Google recommends that
7729
+ # you set the `returnPartialSuccess` parameter to `true`.
7667
7730
  # @param [String] project
7668
7731
  # Name of the project scoping this request.
7669
7732
  # @param [String] filter
@@ -7723,7 +7786,9 @@ module Google
7723
7786
  # by a previous list request to get the next page of results.
7724
7787
  # @param [Boolean] return_partial_success
7725
7788
  # Opt-in for partial success behavior which provides partial results in case of
7726
- # failure. The default value is false.
7789
+ # failure. The default value is false. For example, when partial success
7790
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
7791
+ # resources in the zone or no resources, with an error code.
7727
7792
  # @param [Fixnum] service_project_number
7728
7793
  # The Shared VPC service project id or service project number for which
7729
7794
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -7948,7 +8013,9 @@ module Google
7948
8013
  # by a previous list request to get the next page of results.
7949
8014
  # @param [Boolean] return_partial_success
7950
8015
  # Opt-in for partial success behavior which provides partial results in case of
7951
- # failure. The default value is false.
8016
+ # failure. The default value is false. For example, when partial success
8017
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
8018
+ # resources in the zone or no resources, with an error code.
7952
8019
  # @param [String] fields
7953
8020
  # Selector specifying which fields to include in a partial response.
7954
8021
  # @param [String] quota_user
@@ -8272,7 +8339,9 @@ module Google
8272
8339
  # by a previous list request to get the next page of results.
8273
8340
  # @param [Boolean] return_partial_success
8274
8341
  # Opt-in for partial success behavior which provides partial results in case of
8275
- # failure. The default value is false.
8342
+ # failure. The default value is false. For example, when partial success
8343
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
8344
+ # resources in the zone or no resources, with an error code.
8276
8345
  # @param [String] fields
8277
8346
  # Selector specifying which fields to include in a partial response.
8278
8347
  # @param [String] quota_user
@@ -8596,7 +8665,9 @@ module Google
8596
8665
  # by a previous list request to get the next page of results.
8597
8666
  # @param [Boolean] return_partial_success
8598
8667
  # Opt-in for partial success behavior which provides partial results in case of
8599
- # failure. The default value is false.
8668
+ # failure. The default value is false. For example, when partial success
8669
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
8670
+ # resources in the zone or no resources, with an error code.
8600
8671
  # @param [String] fields
8601
8672
  # Selector specifying which fields to include in a partial response.
8602
8673
  # @param [String] quota_user
@@ -9097,7 +9168,9 @@ module Google
9097
9168
  # by a previous list request to get the next page of results.
9098
9169
  # @param [Boolean] return_partial_success
9099
9170
  # Opt-in for partial success behavior which provides partial results in case of
9100
- # failure. The default value is false.
9171
+ # failure. The default value is false. For example, when partial success
9172
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
9173
+ # resources in the zone or no resources, with an error code.
9101
9174
  # @param [String] fields
9102
9175
  # Selector specifying which fields to include in a partial response.
9103
9176
  # @param [String] quota_user
@@ -9367,7 +9440,9 @@ module Google
9367
9440
  execute_or_queue_command(command, &block)
9368
9441
  end
9369
9442
 
9370
- # Retrieves the list of managed instance groups and groups them by zone.
9443
+ # Retrieves the list of managed instance groups and groups them by zone. To
9444
+ # prevent failure, Google recommends that you set the `returnPartialSuccess`
9445
+ # parameter to `true`.
9371
9446
  # @param [String] project
9372
9447
  # Project ID for this request.
9373
9448
  # @param [String] filter
@@ -9427,7 +9502,9 @@ module Google
9427
9502
  # by a previous list request to get the next page of results.
9428
9503
  # @param [Boolean] return_partial_success
9429
9504
  # Opt-in for partial success behavior which provides partial results in case of
9430
- # failure. The default value is false.
9505
+ # failure. The default value is false. For example, when partial success
9506
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
9507
+ # resources in the zone or no resources, with an error code.
9431
9508
  # @param [Fixnum] service_project_number
9432
9509
  # The Shared VPC service project id or service project number for which
9433
9510
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -9880,7 +9957,9 @@ module Google
9880
9957
  # by a previous list request to get the next page of results.
9881
9958
  # @param [Boolean] return_partial_success
9882
9959
  # Opt-in for partial success behavior which provides partial results in case of
9883
- # failure. The default value is false.
9960
+ # failure. The default value is false. For example, when partial success
9961
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
9962
+ # resources in the zone or no resources, with an error code.
9884
9963
  # @param [String] fields
9885
9964
  # Selector specifying which fields to include in a partial response.
9886
9965
  # @param [String] quota_user
@@ -9978,7 +10057,9 @@ module Google
9978
10057
  # by a previous list request to get the next page of results.
9979
10058
  # @param [Boolean] return_partial_success
9980
10059
  # Opt-in for partial success behavior which provides partial results in case of
9981
- # failure. The default value is false.
10060
+ # failure. The default value is false. For example, when partial success
10061
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
10062
+ # resources in the zone or no resources, with an error code.
9982
10063
  # @param [String] fields
9983
10064
  # Selector specifying which fields to include in a partial response.
9984
10065
  # @param [String] quota_user
@@ -10079,7 +10160,9 @@ module Google
10079
10160
  # by a previous list request to get the next page of results.
10080
10161
  # @param [Boolean] return_partial_success
10081
10162
  # Opt-in for partial success behavior which provides partial results in case of
10082
- # failure. The default value is false.
10163
+ # failure. The default value is false. For example, when partial success
10164
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
10165
+ # resources in the zone or no resources, with an error code.
10083
10166
  # @param [String] fields
10084
10167
  # Selector specifying which fields to include in a partial response.
10085
10168
  # @param [String] quota_user
@@ -10176,7 +10259,9 @@ module Google
10176
10259
  # by a previous list request to get the next page of results.
10177
10260
  # @param [Boolean] return_partial_success
10178
10261
  # Opt-in for partial success behavior which provides partial results in case of
10179
- # failure. The default value is false.
10262
+ # failure. The default value is false. For example, when partial success
10263
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
10264
+ # resources in the zone or no resources, with an error code.
10180
10265
  # @param [String] fields
10181
10266
  # Selector specifying which fields to include in a partial response.
10182
10267
  # @param [String] quota_user
@@ -10687,7 +10772,9 @@ module Google
10687
10772
  execute_or_queue_command(command, &block)
10688
10773
  end
10689
10774
 
10690
- # Retrieves the list of instance groups and sorts them by zone.
10775
+ # Retrieves the list of instance groups and sorts them by zone. To prevent
10776
+ # failure, Google recommends that you set the `returnPartialSuccess` parameter
10777
+ # to `true`.
10691
10778
  # @param [String] project
10692
10779
  # Project ID for this request.
10693
10780
  # @param [String] filter
@@ -10747,7 +10834,9 @@ module Google
10747
10834
  # by a previous list request to get the next page of results.
10748
10835
  # @param [Boolean] return_partial_success
10749
10836
  # Opt-in for partial success behavior which provides partial results in case of
10750
- # failure. The default value is false.
10837
+ # failure. The default value is false. For example, when partial success
10838
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
10839
+ # resources in the zone or no resources, with an error code.
10751
10840
  # @param [Fixnum] service_project_number
10752
10841
  # The Shared VPC service project id or service project number for which
10753
10842
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -10989,7 +11078,9 @@ module Google
10989
11078
  # by a previous list request to get the next page of results.
10990
11079
  # @param [Boolean] return_partial_success
10991
11080
  # Opt-in for partial success behavior which provides partial results in case of
10992
- # failure. The default value is false.
11081
+ # failure. The default value is false. For example, when partial success
11082
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
11083
+ # resources in the zone or no resources, with an error code.
10993
11084
  # @param [String] fields
10994
11085
  # Selector specifying which fields to include in a partial response.
10995
11086
  # @param [String] quota_user
@@ -11087,7 +11178,9 @@ module Google
11087
11178
  # by a previous list request to get the next page of results.
11088
11179
  # @param [Boolean] return_partial_success
11089
11180
  # Opt-in for partial success behavior which provides partial results in case of
11090
- # failure. The default value is false.
11181
+ # failure. The default value is false. For example, when partial success
11182
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
11183
+ # resources in the zone or no resources, with an error code.
11091
11184
  # @param [String] fields
11092
11185
  # Selector specifying which fields to include in a partial response.
11093
11186
  # @param [String] quota_user
@@ -11237,7 +11330,8 @@ module Google
11237
11330
  end
11238
11331
 
11239
11332
  # Retrieves the list of all InstanceTemplates resources, regional and global,
11240
- # available to the specified project.
11333
+ # available to the specified project. To prevent failure, Google recommends that
11334
+ # you set the `returnPartialSuccess` parameter to `true`.
11241
11335
  # @param [String] project
11242
11336
  # Name of the project scoping this request.
11243
11337
  # @param [String] filter
@@ -11297,7 +11391,9 @@ module Google
11297
11391
  # by a previous list request to get the next page of results.
11298
11392
  # @param [Boolean] return_partial_success
11299
11393
  # Opt-in for partial success behavior which provides partial results in case of
11300
- # failure. The default value is false.
11394
+ # failure. The default value is false. For example, when partial success
11395
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
11396
+ # resources in the zone or no resources, with an error code.
11301
11397
  # @param [Fixnum] service_project_number
11302
11398
  # The Shared VPC service project id or service project number for which
11303
11399
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -11567,7 +11663,9 @@ module Google
11567
11663
  # by a previous list request to get the next page of results.
11568
11664
  # @param [Boolean] return_partial_success
11569
11665
  # Opt-in for partial success behavior which provides partial results in case of
11570
- # failure. The default value is false.
11666
+ # failure. The default value is false. For example, when partial success
11667
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
11668
+ # resources in the zone or no resources, with an error code.
11571
11669
  # @param [String] fields
11572
11670
  # Selector specifying which fields to include in a partial response.
11573
11671
  # @param [String] quota_user
@@ -11795,7 +11893,9 @@ module Google
11795
11893
 
11796
11894
  # Retrieves an aggregated list of all of the instances in your project across
11797
11895
  # all regions and zones. The performance of this method degrades when a filter
11798
- # is specified on a project that has a very large number of instances.
11896
+ # is specified on a project that has a very large number of instances. To
11897
+ # prevent failure, Google recommends that you set the `returnPartialSuccess`
11898
+ # parameter to `true`.
11799
11899
  # @param [String] project
11800
11900
  # Project ID for this request.
11801
11901
  # @param [String] filter
@@ -11855,7 +11955,9 @@ module Google
11855
11955
  # by a previous list request to get the next page of results.
11856
11956
  # @param [Boolean] return_partial_success
11857
11957
  # Opt-in for partial success behavior which provides partial results in case of
11858
- # failure. The default value is false.
11958
+ # failure. The default value is false. For example, when partial success
11959
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
11960
+ # resources in the zone or no resources, with an error code.
11859
11961
  # @param [Fixnum] service_project_number
11860
11962
  # The Shared VPC service project id or service project number for which
11861
11963
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -12591,7 +12693,9 @@ module Google
12591
12693
  # by a previous list request to get the next page of results.
12592
12694
  # @param [Boolean] return_partial_success
12593
12695
  # Opt-in for partial success behavior which provides partial results in case of
12594
- # failure. The default value is false.
12696
+ # failure. The default value is false. For example, when partial success
12697
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
12698
+ # resources in the zone or no resources, with an error code.
12595
12699
  # @param [String] fields
12596
12700
  # Selector specifying which fields to include in a partial response.
12597
12701
  # @param [String] quota_user
@@ -12689,7 +12793,9 @@ module Google
12689
12793
  # by a previous list request to get the next page of results.
12690
12794
  # @param [Boolean] return_partial_success
12691
12795
  # Opt-in for partial success behavior which provides partial results in case of
12692
- # failure. The default value is false.
12796
+ # failure. The default value is false. For example, when partial success
12797
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
12798
+ # resources in the zone or no resources, with an error code.
12693
12799
  # @param [String] fields
12694
12800
  # Selector specifying which fields to include in a partial response.
12695
12801
  # @param [String] quota_user
@@ -14335,7 +14441,8 @@ module Google
14335
14441
  execute_or_queue_command(command, &block)
14336
14442
  end
14337
14443
 
14338
- # Retrieves an aggregated list of interconnect attachments.
14444
+ # Retrieves an aggregated list of instantSnapshots. To prevent failure, Google
14445
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
14339
14446
  # @param [String] project
14340
14447
  # Project ID for this request.
14341
14448
  # @param [String] filter
@@ -14395,7 +14502,534 @@ module Google
14395
14502
  # by a previous list request to get the next page of results.
14396
14503
  # @param [Boolean] return_partial_success
14397
14504
  # Opt-in for partial success behavior which provides partial results in case of
14398
- # failure. The default value is false.
14505
+ # failure. The default value is false. For example, when partial success
14506
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
14507
+ # resources in the zone or no resources, with an error code.
14508
+ # @param [Fixnum] service_project_number
14509
+ # The Shared VPC service project id or service project number for which
14510
+ # aggregated list request is invoked for subnetworks list-usable api.
14511
+ # @param [String] fields
14512
+ # Selector specifying which fields to include in a partial response.
14513
+ # @param [String] quota_user
14514
+ # Available to use for quota purposes for server-side applications. Can be any
14515
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14516
+ # @param [String] user_ip
14517
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14518
+ # @param [Google::Apis::RequestOptions] options
14519
+ # Request-specific options
14520
+ #
14521
+ # @yield [result, err] Result & error if block supplied
14522
+ # @yieldparam result [Google::Apis::ComputeV1::InstantSnapshotAggregatedList] parsed result object
14523
+ # @yieldparam err [StandardError] error object if request failed
14524
+ #
14525
+ # @return [Google::Apis::ComputeV1::InstantSnapshotAggregatedList]
14526
+ #
14527
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14528
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14529
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14530
+ def aggregated_instant_snapshot_list(project, filter: nil, include_all_scopes: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, service_project_number: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14531
+ command = make_simple_command(:get, 'projects/{project}/aggregated/instantSnapshots', options)
14532
+ command.response_representation = Google::Apis::ComputeV1::InstantSnapshotAggregatedList::Representation
14533
+ command.response_class = Google::Apis::ComputeV1::InstantSnapshotAggregatedList
14534
+ command.params['project'] = project unless project.nil?
14535
+ command.query['filter'] = filter unless filter.nil?
14536
+ command.query['includeAllScopes'] = include_all_scopes unless include_all_scopes.nil?
14537
+ command.query['maxResults'] = max_results unless max_results.nil?
14538
+ command.query['orderBy'] = order_by unless order_by.nil?
14539
+ command.query['pageToken'] = page_token unless page_token.nil?
14540
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
14541
+ command.query['serviceProjectNumber'] = service_project_number unless service_project_number.nil?
14542
+ command.query['fields'] = fields unless fields.nil?
14543
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14544
+ command.query['userIp'] = user_ip unless user_ip.nil?
14545
+ execute_or_queue_command(command, &block)
14546
+ end
14547
+
14548
+ # Deletes the specified InstantSnapshot resource. Keep in mind that deleting a
14549
+ # single instantSnapshot might not necessarily delete all the data on that
14550
+ # instantSnapshot. If any data on the instantSnapshot that is marked for
14551
+ # deletion is needed for subsequent instantSnapshots, the data will be moved to
14552
+ # the next corresponding instantSnapshot. For more information, see Deleting
14553
+ # instantSnapshots.
14554
+ # @param [String] project
14555
+ # Project ID for this request.
14556
+ # @param [String] zone
14557
+ # The name of the zone for this request.
14558
+ # @param [String] instant_snapshot
14559
+ # Name of the InstantSnapshot resource to delete.
14560
+ # @param [String] request_id
14561
+ # An optional request ID to identify requests. Specify a unique request ID so
14562
+ # that if you must retry your request, the server will know to ignore the
14563
+ # request if it has already been completed. For example, consider a situation
14564
+ # where you make an initial request and the request times out. If you make the
14565
+ # request again with the same request ID, the server can check if original
14566
+ # operation with the same request ID was received, and if so, will ignore the
14567
+ # second request. This prevents clients from accidentally creating duplicate
14568
+ # commitments. The request ID must be a valid UUID with the exception that zero
14569
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
14570
+ # @param [String] fields
14571
+ # Selector specifying which fields to include in a partial response.
14572
+ # @param [String] quota_user
14573
+ # Available to use for quota purposes for server-side applications. Can be any
14574
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14575
+ # @param [String] user_ip
14576
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14577
+ # @param [Google::Apis::RequestOptions] options
14578
+ # Request-specific options
14579
+ #
14580
+ # @yield [result, err] Result & error if block supplied
14581
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
14582
+ # @yieldparam err [StandardError] error object if request failed
14583
+ #
14584
+ # @return [Google::Apis::ComputeV1::Operation]
14585
+ #
14586
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14587
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14588
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14589
+ def delete_instant_snapshot(project, zone, instant_snapshot, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14590
+ command = make_simple_command(:delete, 'projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}', options)
14591
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
14592
+ command.response_class = Google::Apis::ComputeV1::Operation
14593
+ command.params['project'] = project unless project.nil?
14594
+ command.params['zone'] = zone unless zone.nil?
14595
+ command.params['instantSnapshot'] = instant_snapshot unless instant_snapshot.nil?
14596
+ command.query['requestId'] = request_id unless request_id.nil?
14597
+ command.query['fields'] = fields unless fields.nil?
14598
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14599
+ command.query['userIp'] = user_ip unless user_ip.nil?
14600
+ execute_or_queue_command(command, &block)
14601
+ end
14602
+
14603
+ # Returns the specified InstantSnapshot resource in the specified zone.
14604
+ # @param [String] project
14605
+ # Project ID for this request.
14606
+ # @param [String] zone
14607
+ # The name of the zone for this request.
14608
+ # @param [String] instant_snapshot
14609
+ # Name of the InstantSnapshot resource to return.
14610
+ # @param [String] fields
14611
+ # Selector specifying which fields to include in a partial response.
14612
+ # @param [String] quota_user
14613
+ # Available to use for quota purposes for server-side applications. Can be any
14614
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14615
+ # @param [String] user_ip
14616
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14617
+ # @param [Google::Apis::RequestOptions] options
14618
+ # Request-specific options
14619
+ #
14620
+ # @yield [result, err] Result & error if block supplied
14621
+ # @yieldparam result [Google::Apis::ComputeV1::InstantSnapshot] parsed result object
14622
+ # @yieldparam err [StandardError] error object if request failed
14623
+ #
14624
+ # @return [Google::Apis::ComputeV1::InstantSnapshot]
14625
+ #
14626
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14627
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14628
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14629
+ def get_instant_snapshot(project, zone, instant_snapshot, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14630
+ command = make_simple_command(:get, 'projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}', options)
14631
+ command.response_representation = Google::Apis::ComputeV1::InstantSnapshot::Representation
14632
+ command.response_class = Google::Apis::ComputeV1::InstantSnapshot
14633
+ command.params['project'] = project unless project.nil?
14634
+ command.params['zone'] = zone unless zone.nil?
14635
+ command.params['instantSnapshot'] = instant_snapshot unless instant_snapshot.nil?
14636
+ command.query['fields'] = fields unless fields.nil?
14637
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14638
+ command.query['userIp'] = user_ip unless user_ip.nil?
14639
+ execute_or_queue_command(command, &block)
14640
+ end
14641
+
14642
+ # Gets the access control policy for a resource. May be empty if no such policy
14643
+ # or resource exists.
14644
+ # @param [String] project
14645
+ # Project ID for this request.
14646
+ # @param [String] zone
14647
+ # The name of the zone for this request.
14648
+ # @param [String] resource
14649
+ # Name or id of the resource for this request.
14650
+ # @param [Fixnum] options_requested_policy_version
14651
+ # Requested IAM Policy version.
14652
+ # @param [String] fields
14653
+ # Selector specifying which fields to include in a partial response.
14654
+ # @param [String] quota_user
14655
+ # Available to use for quota purposes for server-side applications. Can be any
14656
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14657
+ # @param [String] user_ip
14658
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14659
+ # @param [Google::Apis::RequestOptions] options
14660
+ # Request-specific options
14661
+ #
14662
+ # @yield [result, err] Result & error if block supplied
14663
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
14664
+ # @yieldparam err [StandardError] error object if request failed
14665
+ #
14666
+ # @return [Google::Apis::ComputeV1::Policy]
14667
+ #
14668
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14669
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14670
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14671
+ def get_instant_snapshot_iam_policy(project, zone, resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14672
+ command = make_simple_command(:get, 'projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy', options)
14673
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
14674
+ command.response_class = Google::Apis::ComputeV1::Policy
14675
+ command.params['project'] = project unless project.nil?
14676
+ command.params['zone'] = zone unless zone.nil?
14677
+ command.params['resource'] = resource unless resource.nil?
14678
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
14679
+ command.query['fields'] = fields unless fields.nil?
14680
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14681
+ command.query['userIp'] = user_ip unless user_ip.nil?
14682
+ execute_or_queue_command(command, &block)
14683
+ end
14684
+
14685
+ # Creates an instant snapshot in the specified zone.
14686
+ # @param [String] project
14687
+ # Project ID for this request.
14688
+ # @param [String] zone
14689
+ # Name of the zone for this request.
14690
+ # @param [Google::Apis::ComputeV1::InstantSnapshot] instant_snapshot_object
14691
+ # @param [String] request_id
14692
+ # An optional request ID to identify requests. Specify a unique request ID so
14693
+ # that if you must retry your request, the server will know to ignore the
14694
+ # request if it has already been completed. For example, consider a situation
14695
+ # where you make an initial request and the request times out. If you make the
14696
+ # request again with the same request ID, the server can check if original
14697
+ # operation with the same request ID was received, and if so, will ignore the
14698
+ # second request. This prevents clients from accidentally creating duplicate
14699
+ # commitments. The request ID must be a valid UUID with the exception that zero
14700
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
14701
+ # @param [String] fields
14702
+ # Selector specifying which fields to include in a partial response.
14703
+ # @param [String] quota_user
14704
+ # Available to use for quota purposes for server-side applications. Can be any
14705
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14706
+ # @param [String] user_ip
14707
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14708
+ # @param [Google::Apis::RequestOptions] options
14709
+ # Request-specific options
14710
+ #
14711
+ # @yield [result, err] Result & error if block supplied
14712
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
14713
+ # @yieldparam err [StandardError] error object if request failed
14714
+ #
14715
+ # @return [Google::Apis::ComputeV1::Operation]
14716
+ #
14717
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14718
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14719
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14720
+ def insert_instant_snapshot(project, zone, instant_snapshot_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14721
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instantSnapshots', options)
14722
+ command.request_representation = Google::Apis::ComputeV1::InstantSnapshot::Representation
14723
+ command.request_object = instant_snapshot_object
14724
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
14725
+ command.response_class = Google::Apis::ComputeV1::Operation
14726
+ command.params['project'] = project unless project.nil?
14727
+ command.params['zone'] = zone unless zone.nil?
14728
+ command.query['requestId'] = request_id unless request_id.nil?
14729
+ command.query['fields'] = fields unless fields.nil?
14730
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14731
+ command.query['userIp'] = user_ip unless user_ip.nil?
14732
+ execute_or_queue_command(command, &block)
14733
+ end
14734
+
14735
+ # Retrieves the list of InstantSnapshot resources contained within the specified
14736
+ # zone.
14737
+ # @param [String] project
14738
+ # Project ID for this request.
14739
+ # @param [String] zone
14740
+ # The name of the zone for this request.
14741
+ # @param [String] filter
14742
+ # A filter expression that filters resources listed in the response. Most
14743
+ # Compute resources support two types of filter expressions: expressions that
14744
+ # support regular expressions and expressions that follow API improvement
14745
+ # proposal AIP-160. These two types of filter expressions cannot be mixed in one
14746
+ # request. If you want to use AIP-160, your expression must specify the field
14747
+ # name, an operator, and the value that you want to use for filtering. The value
14748
+ # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
14749
+ # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
14750
+ # Engine instances, you can exclude instances named `example-instance` by
14751
+ # specifying `name != example-instance`. The `:*` comparison can be used to test
14752
+ # whether a key has been defined. For example, to find all objects with `owner`
14753
+ # label use: ``` labels.owner:* ``` You can also filter nested fields. For
14754
+ # example, you could specify `scheduling.automaticRestart = false` to include
14755
+ # instances only if they are not scheduled for automatic restarts. You can use
14756
+ # filtering on nested fields to filter based on resource labels. To filter on
14757
+ # multiple expressions, provide each separate expression within parentheses. For
14758
+ # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
14759
+ # Skylake") ``` By default, each expression is an `AND` expression. However, you
14760
+ # can include `AND` and `OR` expressions explicitly. For example: ``` (
14761
+ # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
14762
+ # scheduling.automaticRestart = true) ``` If you want to use a regular
14763
+ # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
14764
+ # un-parenthesized expression with or without quotes or against multiple
14765
+ # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
14766
+ # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
14767
+ # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
14768
+ # interpreted as a regular expression using Google RE2 library syntax. The
14769
+ # literal value must match the entire field. For example, to filter for
14770
+ # instances that do not end with name "instance", you would use `name ne .*
14771
+ # instance`. You cannot combine constraints on multiple fields using regular
14772
+ # expressions.
14773
+ # @param [Fixnum] max_results
14774
+ # The maximum number of results per page that should be returned. If the number
14775
+ # of available results is larger than `maxResults`, Compute Engine returns a `
14776
+ # nextPageToken` that can be used to get the next page of results in subsequent
14777
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
14778
+ # @param [String] order_by
14779
+ # Sorts list results by a certain order. By default, results are returned in
14780
+ # alphanumerical order based on the resource name. You can also sort results in
14781
+ # descending order based on the creation timestamp using `orderBy="
14782
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
14783
+ # field in reverse chronological order (newest result first). Use this to sort
14784
+ # resources like operations so that the newest operation is returned first.
14785
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
14786
+ # @param [String] page_token
14787
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
14788
+ # by a previous list request to get the next page of results.
14789
+ # @param [Boolean] return_partial_success
14790
+ # Opt-in for partial success behavior which provides partial results in case of
14791
+ # failure. The default value is false. For example, when partial success
14792
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
14793
+ # resources in the zone or no resources, with an error code.
14794
+ # @param [String] fields
14795
+ # Selector specifying which fields to include in a partial response.
14796
+ # @param [String] quota_user
14797
+ # Available to use for quota purposes for server-side applications. Can be any
14798
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14799
+ # @param [String] user_ip
14800
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14801
+ # @param [Google::Apis::RequestOptions] options
14802
+ # Request-specific options
14803
+ #
14804
+ # @yield [result, err] Result & error if block supplied
14805
+ # @yieldparam result [Google::Apis::ComputeV1::InstantSnapshotList] parsed result object
14806
+ # @yieldparam err [StandardError] error object if request failed
14807
+ #
14808
+ # @return [Google::Apis::ComputeV1::InstantSnapshotList]
14809
+ #
14810
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14811
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14812
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14813
+ def list_instant_snapshots(project, zone, 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)
14814
+ command = make_simple_command(:get, 'projects/{project}/zones/{zone}/instantSnapshots', options)
14815
+ command.response_representation = Google::Apis::ComputeV1::InstantSnapshotList::Representation
14816
+ command.response_class = Google::Apis::ComputeV1::InstantSnapshotList
14817
+ command.params['project'] = project unless project.nil?
14818
+ command.params['zone'] = zone unless zone.nil?
14819
+ command.query['filter'] = filter unless filter.nil?
14820
+ command.query['maxResults'] = max_results unless max_results.nil?
14821
+ command.query['orderBy'] = order_by unless order_by.nil?
14822
+ command.query['pageToken'] = page_token unless page_token.nil?
14823
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
14824
+ command.query['fields'] = fields unless fields.nil?
14825
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14826
+ command.query['userIp'] = user_ip unless user_ip.nil?
14827
+ execute_or_queue_command(command, &block)
14828
+ end
14829
+
14830
+ # Sets the access control policy on the specified resource. Replaces any
14831
+ # existing policy.
14832
+ # @param [String] project
14833
+ # Project ID for this request.
14834
+ # @param [String] zone
14835
+ # The name of the zone for this request.
14836
+ # @param [String] resource
14837
+ # Name or id of the resource for this request.
14838
+ # @param [Google::Apis::ComputeV1::ZoneSetPolicyRequest] zone_set_policy_request_object
14839
+ # @param [String] fields
14840
+ # Selector specifying which fields to include in a partial response.
14841
+ # @param [String] quota_user
14842
+ # Available to use for quota purposes for server-side applications. Can be any
14843
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14844
+ # @param [String] user_ip
14845
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14846
+ # @param [Google::Apis::RequestOptions] options
14847
+ # Request-specific options
14848
+ #
14849
+ # @yield [result, err] Result & error if block supplied
14850
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
14851
+ # @yieldparam err [StandardError] error object if request failed
14852
+ #
14853
+ # @return [Google::Apis::ComputeV1::Policy]
14854
+ #
14855
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14856
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14857
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14858
+ def set_instant_snapshot_iam_policy(project, zone, resource, zone_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14859
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy', options)
14860
+ command.request_representation = Google::Apis::ComputeV1::ZoneSetPolicyRequest::Representation
14861
+ command.request_object = zone_set_policy_request_object
14862
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
14863
+ command.response_class = Google::Apis::ComputeV1::Policy
14864
+ command.params['project'] = project unless project.nil?
14865
+ command.params['zone'] = zone unless zone.nil?
14866
+ command.params['resource'] = resource unless resource.nil?
14867
+ command.query['fields'] = fields unless fields.nil?
14868
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14869
+ command.query['userIp'] = user_ip unless user_ip.nil?
14870
+ execute_or_queue_command(command, &block)
14871
+ end
14872
+
14873
+ # Sets the labels on a instantSnapshot in the given zone. To learn more about
14874
+ # labels, read the Labeling Resources documentation.
14875
+ # @param [String] project
14876
+ # Project ID for this request.
14877
+ # @param [String] zone
14878
+ # The name of the zone for this request.
14879
+ # @param [String] resource
14880
+ # Name or id of the resource for this request.
14881
+ # @param [Google::Apis::ComputeV1::ZoneSetLabelsRequest] zone_set_labels_request_object
14882
+ # @param [String] request_id
14883
+ # An optional request ID to identify requests. Specify a unique request ID so
14884
+ # that if you must retry your request, the server will know to ignore the
14885
+ # request if it has already been completed. For example, consider a situation
14886
+ # where you make an initial request and the request times out. If you make the
14887
+ # request again with the same request ID, the server can check if original
14888
+ # operation with the same request ID was received, and if so, will ignore the
14889
+ # second request. This prevents clients from accidentally creating duplicate
14890
+ # commitments. The request ID must be a valid UUID with the exception that zero
14891
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
14892
+ # @param [String] fields
14893
+ # Selector specifying which fields to include in a partial response.
14894
+ # @param [String] quota_user
14895
+ # Available to use for quota purposes for server-side applications. Can be any
14896
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14897
+ # @param [String] user_ip
14898
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14899
+ # @param [Google::Apis::RequestOptions] options
14900
+ # Request-specific options
14901
+ #
14902
+ # @yield [result, err] Result & error if block supplied
14903
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
14904
+ # @yieldparam err [StandardError] error object if request failed
14905
+ #
14906
+ # @return [Google::Apis::ComputeV1::Operation]
14907
+ #
14908
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14909
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14910
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14911
+ def set_instant_snapshot_labels(project, zone, resource, zone_set_labels_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14912
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels', options)
14913
+ command.request_representation = Google::Apis::ComputeV1::ZoneSetLabelsRequest::Representation
14914
+ command.request_object = zone_set_labels_request_object
14915
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
14916
+ command.response_class = Google::Apis::ComputeV1::Operation
14917
+ command.params['project'] = project unless project.nil?
14918
+ command.params['zone'] = zone unless zone.nil?
14919
+ command.params['resource'] = resource unless resource.nil?
14920
+ command.query['requestId'] = request_id unless request_id.nil?
14921
+ command.query['fields'] = fields unless fields.nil?
14922
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14923
+ command.query['userIp'] = user_ip unless user_ip.nil?
14924
+ execute_or_queue_command(command, &block)
14925
+ end
14926
+
14927
+ # Returns permissions that a caller has on the specified resource.
14928
+ # @param [String] project
14929
+ # Project ID for this request.
14930
+ # @param [String] zone
14931
+ # The name of the zone for this request.
14932
+ # @param [String] resource
14933
+ # Name or id of the resource for this request.
14934
+ # @param [Google::Apis::ComputeV1::TestPermissionsRequest] test_permissions_request_object
14935
+ # @param [String] fields
14936
+ # Selector specifying which fields to include in a partial response.
14937
+ # @param [String] quota_user
14938
+ # Available to use for quota purposes for server-side applications. Can be any
14939
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14940
+ # @param [String] user_ip
14941
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14942
+ # @param [Google::Apis::RequestOptions] options
14943
+ # Request-specific options
14944
+ #
14945
+ # @yield [result, err] Result & error if block supplied
14946
+ # @yieldparam result [Google::Apis::ComputeV1::TestPermissionsResponse] parsed result object
14947
+ # @yieldparam err [StandardError] error object if request failed
14948
+ #
14949
+ # @return [Google::Apis::ComputeV1::TestPermissionsResponse]
14950
+ #
14951
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14952
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14953
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14954
+ def test_instant_snapshot_iam_permissions(project, zone, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14955
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions', options)
14956
+ command.request_representation = Google::Apis::ComputeV1::TestPermissionsRequest::Representation
14957
+ command.request_object = test_permissions_request_object
14958
+ command.response_representation = Google::Apis::ComputeV1::TestPermissionsResponse::Representation
14959
+ command.response_class = Google::Apis::ComputeV1::TestPermissionsResponse
14960
+ command.params['project'] = project unless project.nil?
14961
+ command.params['zone'] = zone unless zone.nil?
14962
+ command.params['resource'] = resource unless resource.nil?
14963
+ command.query['fields'] = fields unless fields.nil?
14964
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14965
+ command.query['userIp'] = user_ip unless user_ip.nil?
14966
+ execute_or_queue_command(command, &block)
14967
+ end
14968
+
14969
+ # Retrieves an aggregated list of interconnect attachments. To prevent failure,
14970
+ # Google recommends that you set the `returnPartialSuccess` parameter to `true`.
14971
+ # @param [String] project
14972
+ # Project ID for this request.
14973
+ # @param [String] filter
14974
+ # A filter expression that filters resources listed in the response. Most
14975
+ # Compute resources support two types of filter expressions: expressions that
14976
+ # support regular expressions and expressions that follow API improvement
14977
+ # proposal AIP-160. These two types of filter expressions cannot be mixed in one
14978
+ # request. If you want to use AIP-160, your expression must specify the field
14979
+ # name, an operator, and the value that you want to use for filtering. The value
14980
+ # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
14981
+ # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
14982
+ # Engine instances, you can exclude instances named `example-instance` by
14983
+ # specifying `name != example-instance`. The `:*` comparison can be used to test
14984
+ # whether a key has been defined. For example, to find all objects with `owner`
14985
+ # label use: ``` labels.owner:* ``` You can also filter nested fields. For
14986
+ # example, you could specify `scheduling.automaticRestart = false` to include
14987
+ # instances only if they are not scheduled for automatic restarts. You can use
14988
+ # filtering on nested fields to filter based on resource labels. To filter on
14989
+ # multiple expressions, provide each separate expression within parentheses. For
14990
+ # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
14991
+ # Skylake") ``` By default, each expression is an `AND` expression. However, you
14992
+ # can include `AND` and `OR` expressions explicitly. For example: ``` (
14993
+ # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
14994
+ # scheduling.automaticRestart = true) ``` If you want to use a regular
14995
+ # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
14996
+ # un-parenthesized expression with or without quotes or against multiple
14997
+ # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
14998
+ # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
14999
+ # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
15000
+ # interpreted as a regular expression using Google RE2 library syntax. The
15001
+ # literal value must match the entire field. For example, to filter for
15002
+ # instances that do not end with name "instance", you would use `name ne .*
15003
+ # instance`. You cannot combine constraints on multiple fields using regular
15004
+ # expressions.
15005
+ # @param [Boolean] include_all_scopes
15006
+ # Indicates whether every visible scope for each scope type (zone, region,
15007
+ # global) should be included in the response. For new resource types added after
15008
+ # this field, the flag has no effect as new resource types will always include
15009
+ # every visible scope for each scope type in response. For resource types which
15010
+ # predate this field, if this flag is omitted or false, only scopes of the scope
15011
+ # types where the resource type is expected to be found will be included.
15012
+ # @param [Fixnum] max_results
15013
+ # The maximum number of results per page that should be returned. If the number
15014
+ # of available results is larger than `maxResults`, Compute Engine returns a `
15015
+ # nextPageToken` that can be used to get the next page of results in subsequent
15016
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
15017
+ # @param [String] order_by
15018
+ # Sorts list results by a certain order. By default, results are returned in
15019
+ # alphanumerical order based on the resource name. You can also sort results in
15020
+ # descending order based on the creation timestamp using `orderBy="
15021
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
15022
+ # field in reverse chronological order (newest result first). Use this to sort
15023
+ # resources like operations so that the newest operation is returned first.
15024
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
15025
+ # @param [String] page_token
15026
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
15027
+ # by a previous list request to get the next page of results.
15028
+ # @param [Boolean] return_partial_success
15029
+ # Opt-in for partial success behavior which provides partial results in case of
15030
+ # failure. The default value is false. For example, when partial success
15031
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
15032
+ # resources in the zone or no resources, with an error code.
14399
15033
  # @param [Fixnum] service_project_number
14400
15034
  # The Shared VPC service project id or service project number for which
14401
15035
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -14635,7 +15269,9 @@ module Google
14635
15269
  # by a previous list request to get the next page of results.
14636
15270
  # @param [Boolean] return_partial_success
14637
15271
  # Opt-in for partial success behavior which provides partial results in case of
14638
- # failure. The default value is false.
15272
+ # failure. The default value is false. For example, when partial success
15273
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
15274
+ # resources in the zone or no resources, with an error code.
14639
15275
  # @param [String] fields
14640
15276
  # Selector specifying which fields to include in a partial response.
14641
15277
  # @param [String] quota_user
@@ -14872,7 +15508,9 @@ module Google
14872
15508
  # by a previous list request to get the next page of results.
14873
15509
  # @param [Boolean] return_partial_success
14874
15510
  # Opt-in for partial success behavior which provides partial results in case of
14875
- # failure. The default value is false.
15511
+ # failure. The default value is false. For example, when partial success
15512
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
15513
+ # resources in the zone or no resources, with an error code.
14876
15514
  # @param [String] fields
14877
15515
  # Selector specifying which fields to include in a partial response.
14878
15516
  # @param [String] quota_user
@@ -14999,7 +15637,9 @@ module Google
14999
15637
  # by a previous list request to get the next page of results.
15000
15638
  # @param [Boolean] return_partial_success
15001
15639
  # Opt-in for partial success behavior which provides partial results in case of
15002
- # failure. The default value is false.
15640
+ # failure. The default value is false. For example, when partial success
15641
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
15642
+ # resources in the zone or no resources, with an error code.
15003
15643
  # @param [String] fields
15004
15644
  # Selector specifying which fields to include in a partial response.
15005
15645
  # @param [String] quota_user
@@ -15296,7 +15936,9 @@ module Google
15296
15936
  # by a previous list request to get the next page of results.
15297
15937
  # @param [Boolean] return_partial_success
15298
15938
  # Opt-in for partial success behavior which provides partial results in case of
15299
- # failure. The default value is false.
15939
+ # failure. The default value is false. For example, when partial success
15940
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
15941
+ # resources in the zone or no resources, with an error code.
15300
15942
  # @param [String] fields
15301
15943
  # Selector specifying which fields to include in a partial response.
15302
15944
  # @param [String] quota_user
@@ -15739,7 +16381,9 @@ module Google
15739
16381
  # by a previous list request to get the next page of results.
15740
16382
  # @param [Boolean] return_partial_success
15741
16383
  # Opt-in for partial success behavior which provides partial results in case of
15742
- # failure. The default value is false.
16384
+ # failure. The default value is false. For example, when partial success
16385
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
16386
+ # resources in the zone or no resources, with an error code.
15743
16387
  # @param [String] fields
15744
16388
  # Selector specifying which fields to include in a partial response.
15745
16389
  # @param [String] quota_user
@@ -16088,7 +16732,9 @@ module Google
16088
16732
  # by a previous list request to get the next page of results.
16089
16733
  # @param [Boolean] return_partial_success
16090
16734
  # Opt-in for partial success behavior which provides partial results in case of
16091
- # failure. The default value is false.
16735
+ # failure. The default value is false. For example, when partial success
16736
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
16737
+ # resources in the zone or no resources, with an error code.
16092
16738
  # @param [String] fields
16093
16739
  # Selector specifying which fields to include in a partial response.
16094
16740
  # @param [String] quota_user
@@ -16203,7 +16849,8 @@ module Google
16203
16849
  execute_or_queue_command(command, &block)
16204
16850
  end
16205
16851
 
16206
- # Retrieves an aggregated list of machine types.
16852
+ # Retrieves an aggregated list of machine types. To prevent failure, Google
16853
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
16207
16854
  # @param [String] project
16208
16855
  # Project ID for this request.
16209
16856
  # @param [String] filter
@@ -16263,7 +16910,9 @@ module Google
16263
16910
  # by a previous list request to get the next page of results.
16264
16911
  # @param [Boolean] return_partial_success
16265
16912
  # Opt-in for partial success behavior which provides partial results in case of
16266
- # failure. The default value is false.
16913
+ # failure. The default value is false. For example, when partial success
16914
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
16915
+ # resources in the zone or no resources, with an error code.
16267
16916
  # @param [Fixnum] service_project_number
16268
16917
  # The Shared VPC service project id or service project number for which
16269
16918
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -16398,7 +17047,9 @@ module Google
16398
17047
  # by a previous list request to get the next page of results.
16399
17048
  # @param [Boolean] return_partial_success
16400
17049
  # Opt-in for partial success behavior which provides partial results in case of
16401
- # failure. The default value is false.
17050
+ # failure. The default value is false. For example, when partial success
17051
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
17052
+ # resources in the zone or no resources, with an error code.
16402
17053
  # @param [String] fields
16403
17054
  # Selector specifying which fields to include in a partial response.
16404
17055
  # @param [String] quota_user
@@ -16436,7 +17087,8 @@ module Google
16436
17087
  end
16437
17088
 
16438
17089
  # Retrieves the list of all NetworkAttachment resources, regional and global,
16439
- # available to the specified project.
17090
+ # available to the specified project. To prevent failure, Google recommends that
17091
+ # you set the `returnPartialSuccess` parameter to `true`.
16440
17092
  # @param [String] project
16441
17093
  # Project ID for this request.
16442
17094
  # @param [String] filter
@@ -16496,7 +17148,9 @@ module Google
16496
17148
  # by a previous list request to get the next page of results.
16497
17149
  # @param [Boolean] return_partial_success
16498
17150
  # Opt-in for partial success behavior which provides partial results in case of
16499
- # failure. The default value is false.
17151
+ # failure. The default value is false. For example, when partial success
17152
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
17153
+ # resources in the zone or no resources, with an error code.
16500
17154
  # @param [Fixnum] service_project_number
16501
17155
  # The Shared VPC service project id or service project number for which
16502
17156
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -16777,7 +17431,9 @@ module Google
16777
17431
  # by a previous list request to get the next page of results.
16778
17432
  # @param [Boolean] return_partial_success
16779
17433
  # Opt-in for partial success behavior which provides partial results in case of
16780
- # failure. The default value is false.
17434
+ # failure. The default value is false. For example, when partial success
17435
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
17436
+ # resources in the zone or no resources, with an error code.
16781
17437
  # @param [String] fields
16782
17438
  # Selector specifying which fields to include in a partial response.
16783
17439
  # @param [String] quota_user
@@ -16956,7 +17612,8 @@ module Google
16956
17612
  end
16957
17613
 
16958
17614
  # Retrieves the list of all NetworkEdgeSecurityService resources available to
16959
- # the specified project.
17615
+ # the specified project. To prevent failure, Google recommends that you set the `
17616
+ # returnPartialSuccess` parameter to `true`.
16960
17617
  # @param [String] project
16961
17618
  # Name of the project scoping this request.
16962
17619
  # @param [String] filter
@@ -17016,7 +17673,9 @@ module Google
17016
17673
  # by a previous list request to get the next page of results.
17017
17674
  # @param [Boolean] return_partial_success
17018
17675
  # Opt-in for partial success behavior which provides partial results in case of
17019
- # failure. The default value is false.
17676
+ # failure. The default value is false. For example, when partial success
17677
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
17678
+ # resources in the zone or no resources, with an error code.
17020
17679
  # @param [Fixnum] service_project_number
17021
17680
  # The Shared VPC service project id or service project number for which
17022
17681
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -17258,7 +17917,9 @@ module Google
17258
17917
  execute_or_queue_command(command, &block)
17259
17918
  end
17260
17919
 
17261
- # Retrieves the list of network endpoint groups and sorts them by zone.
17920
+ # Retrieves the list of network endpoint groups and sorts them by zone. To
17921
+ # prevent failure, Google recommends that you set the `returnPartialSuccess`
17922
+ # parameter to `true`.
17262
17923
  # @param [String] project
17263
17924
  # Project ID for this request.
17264
17925
  # @param [String] filter
@@ -17318,7 +17979,9 @@ module Google
17318
17979
  # by a previous list request to get the next page of results.
17319
17980
  # @param [Boolean] return_partial_success
17320
17981
  # Opt-in for partial success behavior which provides partial results in case of
17321
- # failure. The default value is false.
17982
+ # failure. The default value is false. For example, when partial success
17983
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
17984
+ # resources in the zone or no resources, with an error code.
17322
17985
  # @param [Fixnum] service_project_number
17323
17986
  # The Shared VPC service project id or service project number for which
17324
17987
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -17673,7 +18336,9 @@ module Google
17673
18336
  # by a previous list request to get the next page of results.
17674
18337
  # @param [Boolean] return_partial_success
17675
18338
  # Opt-in for partial success behavior which provides partial results in case of
17676
- # failure. The default value is false.
18339
+ # failure. The default value is false. For example, when partial success
18340
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
18341
+ # resources in the zone or no resources, with an error code.
17677
18342
  # @param [String] fields
17678
18343
  # Selector specifying which fields to include in a partial response.
17679
18344
  # @param [String] quota_user
@@ -17770,7 +18435,9 @@ module Google
17770
18435
  # by a previous list request to get the next page of results.
17771
18436
  # @param [Boolean] return_partial_success
17772
18437
  # Opt-in for partial success behavior which provides partial results in case of
17773
- # failure. The default value is false.
18438
+ # failure. The default value is false. For example, when partial success
18439
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
18440
+ # resources in the zone or no resources, with an error code.
17774
18441
  # @param [String] fields
17775
18442
  # Selector specifying which fields to include in a partial response.
17776
18443
  # @param [String] quota_user
@@ -18317,7 +18984,9 @@ module Google
18317
18984
  # by a previous list request to get the next page of results.
18318
18985
  # @param [Boolean] return_partial_success
18319
18986
  # Opt-in for partial success behavior which provides partial results in case of
18320
- # failure. The default value is false.
18987
+ # failure. The default value is false. For example, when partial success
18988
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
18989
+ # resources in the zone or no resources, with an error code.
18321
18990
  # @param [String] fields
18322
18991
  # Selector specifying which fields to include in a partial response.
18323
18992
  # @param [String] quota_user
@@ -18905,7 +19574,9 @@ module Google
18905
19574
  # by a previous list request to get the next page of results.
18906
19575
  # @param [Boolean] return_partial_success
18907
19576
  # Opt-in for partial success behavior which provides partial results in case of
18908
- # failure. The default value is false.
19577
+ # failure. The default value is false. For example, when partial success
19578
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
19579
+ # resources in the zone or no resources, with an error code.
18909
19580
  # @param [String] fields
18910
19581
  # Selector specifying which fields to include in a partial response.
18911
19582
  # @param [String] quota_user
@@ -19003,7 +19674,9 @@ module Google
19003
19674
  # routes and dynamic routes in the region.
19004
19675
  # @param [Boolean] return_partial_success
19005
19676
  # Opt-in for partial success behavior which provides partial results in case of
19006
- # failure. The default value is false.
19677
+ # failure. The default value is false. For example, when partial success
19678
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
19679
+ # resources in the zone or no resources, with an error code.
19007
19680
  # @param [String] fields
19008
19681
  # Selector specifying which fields to include in a partial response.
19009
19682
  # @param [String] quota_user
@@ -19297,7 +19970,8 @@ module Google
19297
19970
  end
19298
19971
 
19299
19972
  # Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes
19300
- # for more details about each group.
19973
+ # for more details about each group. To prevent failure, Google recommends that
19974
+ # you set the `returnPartialSuccess` parameter to `true`.
19301
19975
  # @param [String] project
19302
19976
  # Project ID for this request.
19303
19977
  # @param [String] filter
@@ -19357,7 +20031,9 @@ module Google
19357
20031
  # by a previous list request to get the next page of results.
19358
20032
  # @param [Boolean] return_partial_success
19359
20033
  # Opt-in for partial success behavior which provides partial results in case of
19360
- # failure. The default value is false.
20034
+ # failure. The default value is false. For example, when partial success
20035
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
20036
+ # resources in the zone or no resources, with an error code.
19361
20037
  # @param [Fixnum] service_project_number
19362
20038
  # The Shared VPC service project id or service project number for which
19363
20039
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -19695,7 +20371,9 @@ module Google
19695
20371
  # by a previous list request to get the next page of results.
19696
20372
  # @param [Boolean] return_partial_success
19697
20373
  # Opt-in for partial success behavior which provides partial results in case of
19698
- # failure. The default value is false.
20374
+ # failure. The default value is false. For example, when partial success
20375
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
20376
+ # resources in the zone or no resources, with an error code.
19699
20377
  # @param [String] fields
19700
20378
  # Selector specifying which fields to include in a partial response.
19701
20379
  # @param [String] quota_user
@@ -19789,7 +20467,9 @@ module Google
19789
20467
  # by a previous list request to get the next page of results.
19790
20468
  # @param [Boolean] return_partial_success
19791
20469
  # Opt-in for partial success behavior which provides partial results in case of
19792
- # failure. The default value is false.
20470
+ # failure. The default value is false. For example, when partial success
20471
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
20472
+ # resources in the zone or no resources, with an error code.
19793
20473
  # @param [String] fields
19794
20474
  # Selector specifying which fields to include in a partial response.
19795
20475
  # @param [String] quota_user
@@ -20072,7 +20752,8 @@ module Google
20072
20752
  execute_or_queue_command(command, &block)
20073
20753
  end
20074
20754
 
20075
- # Retrieves an aggregated list of node templates.
20755
+ # Retrieves an aggregated list of node templates. To prevent failure, Google
20756
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
20076
20757
  # @param [String] project
20077
20758
  # Project ID for this request.
20078
20759
  # @param [String] filter
@@ -20132,7 +20813,9 @@ module Google
20132
20813
  # by a previous list request to get the next page of results.
20133
20814
  # @param [Boolean] return_partial_success
20134
20815
  # Opt-in for partial success behavior which provides partial results in case of
20135
- # failure. The default value is false.
20816
+ # failure. The default value is false. For example, when partial success
20817
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
20818
+ # resources in the zone or no resources, with an error code.
20136
20819
  # @param [Fixnum] service_project_number
20137
20820
  # The Shared VPC service project id or service project number for which
20138
20821
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -20411,7 +21094,9 @@ module Google
20411
21094
  # by a previous list request to get the next page of results.
20412
21095
  # @param [Boolean] return_partial_success
20413
21096
  # Opt-in for partial success behavior which provides partial results in case of
20414
- # failure. The default value is false.
21097
+ # failure. The default value is false. For example, when partial success
21098
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
21099
+ # resources in the zone or no resources, with an error code.
20415
21100
  # @param [String] fields
20416
21101
  # Selector specifying which fields to include in a partial response.
20417
21102
  # @param [String] quota_user
@@ -20533,7 +21218,8 @@ module Google
20533
21218
  execute_or_queue_command(command, &block)
20534
21219
  end
20535
21220
 
20536
- # Retrieves an aggregated list of node types.
21221
+ # Retrieves an aggregated list of node types. To prevent failure, Google
21222
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
20537
21223
  # @param [String] project
20538
21224
  # Project ID for this request.
20539
21225
  # @param [String] filter
@@ -20593,7 +21279,9 @@ module Google
20593
21279
  # by a previous list request to get the next page of results.
20594
21280
  # @param [Boolean] return_partial_success
20595
21281
  # Opt-in for partial success behavior which provides partial results in case of
20596
- # failure. The default value is false.
21282
+ # failure. The default value is false. For example, when partial success
21283
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
21284
+ # resources in the zone or no resources, with an error code.
20597
21285
  # @param [Fixnum] service_project_number
20598
21286
  # The Shared VPC service project id or service project number for which
20599
21287
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -20728,7 +21416,9 @@ module Google
20728
21416
  # by a previous list request to get the next page of results.
20729
21417
  # @param [Boolean] return_partial_success
20730
21418
  # Opt-in for partial success behavior which provides partial results in case of
20731
- # failure. The default value is false.
21419
+ # failure. The default value is false. For example, when partial success
21420
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
21421
+ # resources in the zone or no resources, with an error code.
20732
21422
  # @param [String] fields
20733
21423
  # Selector specifying which fields to include in a partial response.
20734
21424
  # @param [String] quota_user
@@ -20765,7 +21455,8 @@ module Google
20765
21455
  execute_or_queue_command(command, &block)
20766
21456
  end
20767
21457
 
20768
- # Retrieves an aggregated list of packetMirrorings.
21458
+ # Retrieves an aggregated list of packetMirrorings. To prevent failure, Google
21459
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
20769
21460
  # @param [String] project
20770
21461
  # Project ID for this request.
20771
21462
  # @param [String] filter
@@ -20825,7 +21516,9 @@ module Google
20825
21516
  # by a previous list request to get the next page of results.
20826
21517
  # @param [Boolean] return_partial_success
20827
21518
  # Opt-in for partial success behavior which provides partial results in case of
20828
- # failure. The default value is false.
21519
+ # failure. The default value is false. For example, when partial success
21520
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
21521
+ # resources in the zone or no resources, with an error code.
20829
21522
  # @param [Fixnum] service_project_number
20830
21523
  # The Shared VPC service project id or service project number for which
20831
21524
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -21062,7 +21755,9 @@ module Google
21062
21755
  # by a previous list request to get the next page of results.
21063
21756
  # @param [Boolean] return_partial_success
21064
21757
  # Opt-in for partial success behavior which provides partial results in case of
21065
- # failure. The default value is false.
21758
+ # failure. The default value is false. For example, when partial success
21759
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
21760
+ # resources in the zone or no resources, with an error code.
21066
21761
  # @param [String] fields
21067
21762
  # Selector specifying which fields to include in a partial response.
21068
21763
  # @param [String] quota_user
@@ -21507,7 +22202,9 @@ module Google
21507
22202
  # by a previous list request to get the next page of results.
21508
22203
  # @param [Boolean] return_partial_success
21509
22204
  # Opt-in for partial success behavior which provides partial results in case of
21510
- # failure. The default value is false.
22205
+ # failure. The default value is false. For example, when partial success
22206
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
22207
+ # resources in the zone or no resources, with an error code.
21511
22208
  # @param [String] fields
21512
22209
  # Selector specifying which fields to include in a partial response.
21513
22210
  # @param [String] quota_user
@@ -21597,7 +22294,9 @@ module Google
21597
22294
  # by a previous list request to get the next page of results.
21598
22295
  # @param [Boolean] return_partial_success
21599
22296
  # Opt-in for partial success behavior which provides partial results in case of
21600
- # failure. The default value is false.
22297
+ # failure. The default value is false. For example, when partial success
22298
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
22299
+ # resources in the zone or no resources, with an error code.
21601
22300
  # @param [String] fields
21602
22301
  # Selector specifying which fields to include in a partial response.
21603
22302
  # @param [String] quota_user
@@ -21735,109 +22434,12 @@ module Google
21735
22434
  execute_or_queue_command(command, &block)
21736
22435
  end
21737
22436
 
21738
- # Sets metadata common to all instances within the specified project using the
21739
- # data included in the request.
21740
- # @param [String] project
21741
- # Project ID for this request.
21742
- # @param [Google::Apis::ComputeV1::Metadata] metadata_object
21743
- # @param [String] request_id
21744
- # An optional request ID to identify requests. Specify a unique request ID so
21745
- # that if you must retry your request, the server will know to ignore the
21746
- # request if it has already been completed. For example, consider a situation
21747
- # where you make an initial request and the request times out. If you make the
21748
- # request again with the same request ID, the server can check if original
21749
- # operation with the same request ID was received, and if so, will ignore the
21750
- # second request. This prevents clients from accidentally creating duplicate
21751
- # commitments. The request ID must be a valid UUID with the exception that zero
21752
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
21753
- # @param [String] fields
21754
- # Selector specifying which fields to include in a partial response.
21755
- # @param [String] quota_user
21756
- # Available to use for quota purposes for server-side applications. Can be any
21757
- # arbitrary string assigned to a user, but should not exceed 40 characters.
21758
- # @param [String] user_ip
21759
- # Legacy name for parameter that has been superseded by `quotaUser`.
21760
- # @param [Google::Apis::RequestOptions] options
21761
- # Request-specific options
21762
- #
21763
- # @yield [result, err] Result & error if block supplied
21764
- # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
21765
- # @yieldparam err [StandardError] error object if request failed
21766
- #
21767
- # @return [Google::Apis::ComputeV1::Operation]
21768
- #
21769
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
21770
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
21771
- # @raise [Google::Apis::AuthorizationError] Authorization is required
21772
- def set_common_instance_metadata(project, metadata_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
21773
- command = make_simple_command(:post, 'projects/{project}/setCommonInstanceMetadata', options)
21774
- command.request_representation = Google::Apis::ComputeV1::Metadata::Representation
21775
- command.request_object = metadata_object
21776
- command.response_representation = Google::Apis::ComputeV1::Operation::Representation
21777
- command.response_class = Google::Apis::ComputeV1::Operation
21778
- command.params['project'] = project unless project.nil?
21779
- command.query['requestId'] = request_id unless request_id.nil?
21780
- command.query['fields'] = fields unless fields.nil?
21781
- command.query['quotaUser'] = quota_user unless quota_user.nil?
21782
- command.query['userIp'] = user_ip unless user_ip.nil?
21783
- execute_or_queue_command(command, &block)
21784
- end
21785
-
21786
- # Sets the default network tier of the project. The default network tier is used
21787
- # when an address/forwardingRule/instance is created without specifying the
21788
- # network tier field.
21789
- # @param [String] project
21790
- # Project ID for this request.
21791
- # @param [Google::Apis::ComputeV1::ProjectsSetDefaultNetworkTierRequest] projects_set_default_network_tier_request_object
21792
- # @param [String] request_id
21793
- # An optional request ID to identify requests. Specify a unique request ID so
21794
- # that if you must retry your request, the server will know to ignore the
21795
- # request if it has already been completed. For example, consider a situation
21796
- # where you make an initial request and the request times out. If you make the
21797
- # request again with the same request ID, the server can check if original
21798
- # operation with the same request ID was received, and if so, will ignore the
21799
- # second request. This prevents clients from accidentally creating duplicate
21800
- # commitments. The request ID must be a valid UUID with the exception that zero
21801
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
21802
- # @param [String] fields
21803
- # Selector specifying which fields to include in a partial response.
21804
- # @param [String] quota_user
21805
- # Available to use for quota purposes for server-side applications. Can be any
21806
- # arbitrary string assigned to a user, but should not exceed 40 characters.
21807
- # @param [String] user_ip
21808
- # Legacy name for parameter that has been superseded by `quotaUser`.
21809
- # @param [Google::Apis::RequestOptions] options
21810
- # Request-specific options
21811
- #
21812
- # @yield [result, err] Result & error if block supplied
21813
- # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
21814
- # @yieldparam err [StandardError] error object if request failed
21815
- #
21816
- # @return [Google::Apis::ComputeV1::Operation]
21817
- #
21818
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
21819
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
21820
- # @raise [Google::Apis::AuthorizationError] Authorization is required
21821
- def set_project_default_network_tier(project, projects_set_default_network_tier_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
21822
- command = make_simple_command(:post, 'projects/{project}/setDefaultNetworkTier', options)
21823
- command.request_representation = Google::Apis::ComputeV1::ProjectsSetDefaultNetworkTierRequest::Representation
21824
- command.request_object = projects_set_default_network_tier_request_object
21825
- command.response_representation = Google::Apis::ComputeV1::Operation::Representation
21826
- command.response_class = Google::Apis::ComputeV1::Operation
21827
- command.params['project'] = project unless project.nil?
21828
- command.query['requestId'] = request_id unless request_id.nil?
21829
- command.query['fields'] = fields unless fields.nil?
21830
- command.query['quotaUser'] = quota_user unless quota_user.nil?
21831
- command.query['userIp'] = user_ip unless user_ip.nil?
21832
- execute_or_queue_command(command, &block)
21833
- end
21834
-
21835
- # Enables the usage export feature and sets the usage export bucket where
21836
- # reports are stored. If you provide an empty request body using this method,
21837
- # the usage export feature will be disabled.
22437
+ # Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the
22438
+ # billing account of the project must be subscribed to Cloud Armor Enterprise.
22439
+ # See Subscribing to Cloud Armor Enterprise for more information.
21838
22440
  # @param [String] project
21839
22441
  # Project ID for this request.
21840
- # @param [Google::Apis::ComputeV1::UsageExportLocation] usage_export_location_object
22442
+ # @param [Google::Apis::ComputeV1::ProjectsSetCloudArmorTierRequest] projects_set_cloud_armor_tier_request_object
21841
22443
  # @param [String] request_id
21842
22444
  # An optional request ID to identify requests. Specify a unique request ID so
21843
22445
  # that if you must retry your request, the server will know to ignore the
@@ -21867,10 +22469,10 @@ module Google
21867
22469
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
21868
22470
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
21869
22471
  # @raise [Google::Apis::AuthorizationError] Authorization is required
21870
- def set_usage_export_bucket(project, usage_export_location_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
21871
- command = make_simple_command(:post, 'projects/{project}/setUsageExportBucket', options)
21872
- command.request_representation = Google::Apis::ComputeV1::UsageExportLocation::Representation
21873
- command.request_object = usage_export_location_object
22472
+ def set_project_cloud_armor_tier(project, projects_set_cloud_armor_tier_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22473
+ command = make_simple_command(:post, 'projects/{project}/setCloudArmorTier', options)
22474
+ command.request_representation = Google::Apis::ComputeV1::ProjectsSetCloudArmorTierRequest::Representation
22475
+ command.request_object = projects_set_cloud_armor_tier_request_object
21874
22476
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
21875
22477
  command.response_class = Google::Apis::ComputeV1::Operation
21876
22478
  command.params['project'] = project unless project.nil?
@@ -21881,11 +22483,11 @@ module Google
21881
22483
  execute_or_queue_command(command, &block)
21882
22484
  end
21883
22485
 
21884
- # Announces the specified PublicAdvertisedPrefix
22486
+ # Sets metadata common to all instances within the specified project using the
22487
+ # data included in the request.
21885
22488
  # @param [String] project
21886
22489
  # Project ID for this request.
21887
- # @param [String] public_advertised_prefix
21888
- # The name of the public advertised prefix. It should comply with RFC1035.
22490
+ # @param [Google::Apis::ComputeV1::Metadata] metadata_object
21889
22491
  # @param [String] request_id
21890
22492
  # An optional request ID to identify requests. Specify a unique request ID so
21891
22493
  # that if you must retry your request, the server will know to ignore the
@@ -21915,12 +22517,13 @@ module Google
21915
22517
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
21916
22518
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
21917
22519
  # @raise [Google::Apis::AuthorizationError] Authorization is required
21918
- def announce_public_advertised_prefix(project, public_advertised_prefix, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
21919
- command = make_simple_command(:post, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce', options)
22520
+ def set_common_instance_metadata(project, metadata_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22521
+ command = make_simple_command(:post, 'projects/{project}/setCommonInstanceMetadata', options)
22522
+ command.request_representation = Google::Apis::ComputeV1::Metadata::Representation
22523
+ command.request_object = metadata_object
21920
22524
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
21921
22525
  command.response_class = Google::Apis::ComputeV1::Operation
21922
22526
  command.params['project'] = project unless project.nil?
21923
- command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
21924
22527
  command.query['requestId'] = request_id unless request_id.nil?
21925
22528
  command.query['fields'] = fields unless fields.nil?
21926
22529
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -21928,11 +22531,12 @@ module Google
21928
22531
  execute_or_queue_command(command, &block)
21929
22532
  end
21930
22533
 
21931
- # Deletes the specified PublicAdvertisedPrefix
22534
+ # Sets the default network tier of the project. The default network tier is used
22535
+ # when an address/forwardingRule/instance is created without specifying the
22536
+ # network tier field.
21932
22537
  # @param [String] project
21933
22538
  # Project ID for this request.
21934
- # @param [String] public_advertised_prefix
21935
- # Name of the PublicAdvertisedPrefix resource to delete.
22539
+ # @param [Google::Apis::ComputeV1::ProjectsSetDefaultNetworkTierRequest] projects_set_default_network_tier_request_object
21936
22540
  # @param [String] request_id
21937
22541
  # An optional request ID to identify requests. Specify a unique request ID so
21938
22542
  # that if you must retry your request, the server will know to ignore the
@@ -21962,12 +22566,13 @@ module Google
21962
22566
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
21963
22567
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
21964
22568
  # @raise [Google::Apis::AuthorizationError] Authorization is required
21965
- def delete_public_advertised_prefix(project, public_advertised_prefix, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
21966
- command = make_simple_command(:delete, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}', options)
22569
+ def set_project_default_network_tier(project, projects_set_default_network_tier_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22570
+ command = make_simple_command(:post, 'projects/{project}/setDefaultNetworkTier', options)
22571
+ command.request_representation = Google::Apis::ComputeV1::ProjectsSetDefaultNetworkTierRequest::Representation
22572
+ command.request_object = projects_set_default_network_tier_request_object
21967
22573
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
21968
22574
  command.response_class = Google::Apis::ComputeV1::Operation
21969
22575
  command.params['project'] = project unless project.nil?
21970
- command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
21971
22576
  command.query['requestId'] = request_id unless request_id.nil?
21972
22577
  command.query['fields'] = fields unless fields.nil?
21973
22578
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -21975,47 +22580,12 @@ module Google
21975
22580
  execute_or_queue_command(command, &block)
21976
22581
  end
21977
22582
 
21978
- # Returns the specified PublicAdvertisedPrefix resource.
21979
- # @param [String] project
21980
- # Project ID for this request.
21981
- # @param [String] public_advertised_prefix
21982
- # Name of the PublicAdvertisedPrefix resource to return.
21983
- # @param [String] fields
21984
- # Selector specifying which fields to include in a partial response.
21985
- # @param [String] quota_user
21986
- # Available to use for quota purposes for server-side applications. Can be any
21987
- # arbitrary string assigned to a user, but should not exceed 40 characters.
21988
- # @param [String] user_ip
21989
- # Legacy name for parameter that has been superseded by `quotaUser`.
21990
- # @param [Google::Apis::RequestOptions] options
21991
- # Request-specific options
21992
- #
21993
- # @yield [result, err] Result & error if block supplied
21994
- # @yieldparam result [Google::Apis::ComputeV1::PublicAdvertisedPrefix] parsed result object
21995
- # @yieldparam err [StandardError] error object if request failed
21996
- #
21997
- # @return [Google::Apis::ComputeV1::PublicAdvertisedPrefix]
21998
- #
21999
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22000
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22001
- # @raise [Google::Apis::AuthorizationError] Authorization is required
22002
- def get_public_advertised_prefix(project, public_advertised_prefix, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22003
- command = make_simple_command(:get, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}', options)
22004
- command.response_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefix::Representation
22005
- command.response_class = Google::Apis::ComputeV1::PublicAdvertisedPrefix
22006
- command.params['project'] = project unless project.nil?
22007
- command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
22008
- command.query['fields'] = fields unless fields.nil?
22009
- command.query['quotaUser'] = quota_user unless quota_user.nil?
22010
- command.query['userIp'] = user_ip unless user_ip.nil?
22011
- execute_or_queue_command(command, &block)
22012
- end
22013
-
22014
- # Creates a PublicAdvertisedPrefix in the specified project using the parameters
22015
- # that are included in the request.
22583
+ # Enables the usage export feature and sets the usage export bucket where
22584
+ # reports are stored. If you provide an empty request body using this method,
22585
+ # the usage export feature will be disabled.
22016
22586
  # @param [String] project
22017
22587
  # Project ID for this request.
22018
- # @param [Google::Apis::ComputeV1::PublicAdvertisedPrefix] public_advertised_prefix_object
22588
+ # @param [Google::Apis::ComputeV1::UsageExportLocation] usage_export_location_object
22019
22589
  # @param [String] request_id
22020
22590
  # An optional request ID to identify requests. Specify a unique request ID so
22021
22591
  # that if you must retry your request, the server will know to ignore the
@@ -22045,10 +22615,10 @@ module Google
22045
22615
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22046
22616
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22047
22617
  # @raise [Google::Apis::AuthorizationError] Authorization is required
22048
- def insert_public_advertised_prefix(project, public_advertised_prefix_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22049
- command = make_simple_command(:post, 'projects/{project}/global/publicAdvertisedPrefixes', options)
22050
- command.request_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefix::Representation
22051
- command.request_object = public_advertised_prefix_object
22618
+ def set_usage_export_bucket(project, usage_export_location_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22619
+ command = make_simple_command(:post, 'projects/{project}/setUsageExportBucket', options)
22620
+ command.request_representation = Google::Apis::ComputeV1::UsageExportLocation::Representation
22621
+ command.request_object = usage_export_location_object
22052
22622
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
22053
22623
  command.response_class = Google::Apis::ComputeV1::Operation
22054
22624
  command.params['project'] = project unless project.nil?
@@ -22059,103 +22629,283 @@ module Google
22059
22629
  execute_or_queue_command(command, &block)
22060
22630
  end
22061
22631
 
22062
- # Lists the PublicAdvertisedPrefixes for a project.
22063
- # @param [String] project
22064
- # Project ID for this request.
22065
- # @param [String] filter
22066
- # A filter expression that filters resources listed in the response. Most
22067
- # Compute resources support two types of filter expressions: expressions that
22068
- # support regular expressions and expressions that follow API improvement
22069
- # proposal AIP-160. These two types of filter expressions cannot be mixed in one
22070
- # request. If you want to use AIP-160, your expression must specify the field
22071
- # name, an operator, and the value that you want to use for filtering. The value
22072
- # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
22073
- # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
22074
- # Engine instances, you can exclude instances named `example-instance` by
22075
- # specifying `name != example-instance`. The `:*` comparison can be used to test
22076
- # whether a key has been defined. For example, to find all objects with `owner`
22077
- # label use: ``` labels.owner:* ``` You can also filter nested fields. For
22078
- # example, you could specify `scheduling.automaticRestart = false` to include
22079
- # instances only if they are not scheduled for automatic restarts. You can use
22080
- # filtering on nested fields to filter based on resource labels. To filter on
22081
- # multiple expressions, provide each separate expression within parentheses. For
22082
- # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
22083
- # Skylake") ``` By default, each expression is an `AND` expression. However, you
22084
- # can include `AND` and `OR` expressions explicitly. For example: ``` (
22085
- # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
22086
- # scheduling.automaticRestart = true) ``` If you want to use a regular
22087
- # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
22088
- # un-parenthesized expression with or without quotes or against multiple
22089
- # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
22090
- # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
22091
- # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
22092
- # interpreted as a regular expression using Google RE2 library syntax. The
22093
- # literal value must match the entire field. For example, to filter for
22094
- # instances that do not end with name "instance", you would use `name ne .*
22095
- # instance`. You cannot combine constraints on multiple fields using regular
22096
- # expressions.
22097
- # @param [Fixnum] max_results
22098
- # The maximum number of results per page that should be returned. If the number
22099
- # of available results is larger than `maxResults`, Compute Engine returns a `
22100
- # nextPageToken` that can be used to get the next page of results in subsequent
22101
- # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
22102
- # @param [String] order_by
22103
- # Sorts list results by a certain order. By default, results are returned in
22104
- # alphanumerical order based on the resource name. You can also sort results in
22105
- # descending order based on the creation timestamp using `orderBy="
22106
- # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
22107
- # field in reverse chronological order (newest result first). Use this to sort
22108
- # resources like operations so that the newest operation is returned first.
22109
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
22110
- # @param [String] page_token
22111
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
22112
- # by a previous list request to get the next page of results.
22113
- # @param [Boolean] return_partial_success
22114
- # Opt-in for partial success behavior which provides partial results in case of
22115
- # failure. The default value is false.
22116
- # @param [String] fields
22117
- # Selector specifying which fields to include in a partial response.
22118
- # @param [String] quota_user
22119
- # Available to use for quota purposes for server-side applications. Can be any
22120
- # arbitrary string assigned to a user, but should not exceed 40 characters.
22121
- # @param [String] user_ip
22122
- # Legacy name for parameter that has been superseded by `quotaUser`.
22123
- # @param [Google::Apis::RequestOptions] options
22124
- # Request-specific options
22125
- #
22126
- # @yield [result, err] Result & error if block supplied
22127
- # @yieldparam result [Google::Apis::ComputeV1::PublicAdvertisedPrefixList] parsed result object
22128
- # @yieldparam err [StandardError] error object if request failed
22129
- #
22130
- # @return [Google::Apis::ComputeV1::PublicAdvertisedPrefixList]
22131
- #
22132
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22133
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22134
- # @raise [Google::Apis::AuthorizationError] Authorization is required
22135
- def list_public_advertised_prefixes(project, filter: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22136
- command = make_simple_command(:get, 'projects/{project}/global/publicAdvertisedPrefixes', options)
22137
- command.response_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefixList::Representation
22138
- command.response_class = Google::Apis::ComputeV1::PublicAdvertisedPrefixList
22139
- command.params['project'] = project unless project.nil?
22140
- command.query['filter'] = filter unless filter.nil?
22141
- command.query['maxResults'] = max_results unless max_results.nil?
22142
- command.query['orderBy'] = order_by unless order_by.nil?
22143
- command.query['pageToken'] = page_token unless page_token.nil?
22144
- command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
22145
- command.query['fields'] = fields unless fields.nil?
22146
- command.query['quotaUser'] = quota_user unless quota_user.nil?
22147
- command.query['userIp'] = user_ip unless user_ip.nil?
22148
- execute_or_queue_command(command, &block)
22149
- end
22150
-
22151
- # Patches the specified Router resource with the data included in the request.
22152
- # This method supports PATCH semantics and uses JSON merge patch format and
22153
- # processing rules.
22632
+ # Announces the specified PublicAdvertisedPrefix
22154
22633
  # @param [String] project
22155
22634
  # Project ID for this request.
22156
22635
  # @param [String] public_advertised_prefix
22157
- # Name of the PublicAdvertisedPrefix resource to patch.
22158
- # @param [Google::Apis::ComputeV1::PublicAdvertisedPrefix] public_advertised_prefix_object
22636
+ # The name of the public advertised prefix. It should comply with RFC1035.
22637
+ # @param [String] request_id
22638
+ # An optional request ID to identify requests. Specify a unique request ID so
22639
+ # that if you must retry your request, the server will know to ignore the
22640
+ # request if it has already been completed. For example, consider a situation
22641
+ # where you make an initial request and the request times out. If you make the
22642
+ # request again with the same request ID, the server can check if original
22643
+ # operation with the same request ID was received, and if so, will ignore the
22644
+ # second request. This prevents clients from accidentally creating duplicate
22645
+ # commitments. The request ID must be a valid UUID with the exception that zero
22646
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22647
+ # @param [String] fields
22648
+ # Selector specifying which fields to include in a partial response.
22649
+ # @param [String] quota_user
22650
+ # Available to use for quota purposes for server-side applications. Can be any
22651
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
22652
+ # @param [String] user_ip
22653
+ # Legacy name for parameter that has been superseded by `quotaUser`.
22654
+ # @param [Google::Apis::RequestOptions] options
22655
+ # Request-specific options
22656
+ #
22657
+ # @yield [result, err] Result & error if block supplied
22658
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
22659
+ # @yieldparam err [StandardError] error object if request failed
22660
+ #
22661
+ # @return [Google::Apis::ComputeV1::Operation]
22662
+ #
22663
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22664
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22665
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
22666
+ def announce_public_advertised_prefix(project, public_advertised_prefix, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22667
+ command = make_simple_command(:post, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce', options)
22668
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
22669
+ command.response_class = Google::Apis::ComputeV1::Operation
22670
+ command.params['project'] = project unless project.nil?
22671
+ command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
22672
+ command.query['requestId'] = request_id unless request_id.nil?
22673
+ command.query['fields'] = fields unless fields.nil?
22674
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
22675
+ command.query['userIp'] = user_ip unless user_ip.nil?
22676
+ execute_or_queue_command(command, &block)
22677
+ end
22678
+
22679
+ # Deletes the specified PublicAdvertisedPrefix
22680
+ # @param [String] project
22681
+ # Project ID for this request.
22682
+ # @param [String] public_advertised_prefix
22683
+ # Name of the PublicAdvertisedPrefix resource to delete.
22684
+ # @param [String] request_id
22685
+ # An optional request ID to identify requests. Specify a unique request ID so
22686
+ # that if you must retry your request, the server will know to ignore the
22687
+ # request if it has already been completed. For example, consider a situation
22688
+ # where you make an initial request and the request times out. If you make the
22689
+ # request again with the same request ID, the server can check if original
22690
+ # operation with the same request ID was received, and if so, will ignore the
22691
+ # second request. This prevents clients from accidentally creating duplicate
22692
+ # commitments. The request ID must be a valid UUID with the exception that zero
22693
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22694
+ # @param [String] fields
22695
+ # Selector specifying which fields to include in a partial response.
22696
+ # @param [String] quota_user
22697
+ # Available to use for quota purposes for server-side applications. Can be any
22698
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
22699
+ # @param [String] user_ip
22700
+ # Legacy name for parameter that has been superseded by `quotaUser`.
22701
+ # @param [Google::Apis::RequestOptions] options
22702
+ # Request-specific options
22703
+ #
22704
+ # @yield [result, err] Result & error if block supplied
22705
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
22706
+ # @yieldparam err [StandardError] error object if request failed
22707
+ #
22708
+ # @return [Google::Apis::ComputeV1::Operation]
22709
+ #
22710
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22711
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22712
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
22713
+ def delete_public_advertised_prefix(project, public_advertised_prefix, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22714
+ command = make_simple_command(:delete, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}', options)
22715
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
22716
+ command.response_class = Google::Apis::ComputeV1::Operation
22717
+ command.params['project'] = project unless project.nil?
22718
+ command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
22719
+ command.query['requestId'] = request_id unless request_id.nil?
22720
+ command.query['fields'] = fields unless fields.nil?
22721
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
22722
+ command.query['userIp'] = user_ip unless user_ip.nil?
22723
+ execute_or_queue_command(command, &block)
22724
+ end
22725
+
22726
+ # Returns the specified PublicAdvertisedPrefix resource.
22727
+ # @param [String] project
22728
+ # Project ID for this request.
22729
+ # @param [String] public_advertised_prefix
22730
+ # Name of the PublicAdvertisedPrefix resource to return.
22731
+ # @param [String] fields
22732
+ # Selector specifying which fields to include in a partial response.
22733
+ # @param [String] quota_user
22734
+ # Available to use for quota purposes for server-side applications. Can be any
22735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
22736
+ # @param [String] user_ip
22737
+ # Legacy name for parameter that has been superseded by `quotaUser`.
22738
+ # @param [Google::Apis::RequestOptions] options
22739
+ # Request-specific options
22740
+ #
22741
+ # @yield [result, err] Result & error if block supplied
22742
+ # @yieldparam result [Google::Apis::ComputeV1::PublicAdvertisedPrefix] parsed result object
22743
+ # @yieldparam err [StandardError] error object if request failed
22744
+ #
22745
+ # @return [Google::Apis::ComputeV1::PublicAdvertisedPrefix]
22746
+ #
22747
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22748
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22749
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
22750
+ def get_public_advertised_prefix(project, public_advertised_prefix, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22751
+ command = make_simple_command(:get, 'projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}', options)
22752
+ command.response_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefix::Representation
22753
+ command.response_class = Google::Apis::ComputeV1::PublicAdvertisedPrefix
22754
+ command.params['project'] = project unless project.nil?
22755
+ command.params['publicAdvertisedPrefix'] = public_advertised_prefix unless public_advertised_prefix.nil?
22756
+ command.query['fields'] = fields unless fields.nil?
22757
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
22758
+ command.query['userIp'] = user_ip unless user_ip.nil?
22759
+ execute_or_queue_command(command, &block)
22760
+ end
22761
+
22762
+ # Creates a PublicAdvertisedPrefix in the specified project using the parameters
22763
+ # that are included in the request.
22764
+ # @param [String] project
22765
+ # Project ID for this request.
22766
+ # @param [Google::Apis::ComputeV1::PublicAdvertisedPrefix] public_advertised_prefix_object
22767
+ # @param [String] request_id
22768
+ # An optional request ID to identify requests. Specify a unique request ID so
22769
+ # that if you must retry your request, the server will know to ignore the
22770
+ # request if it has already been completed. For example, consider a situation
22771
+ # where you make an initial request and the request times out. If you make the
22772
+ # request again with the same request ID, the server can check if original
22773
+ # operation with the same request ID was received, and if so, will ignore the
22774
+ # second request. This prevents clients from accidentally creating duplicate
22775
+ # commitments. The request ID must be a valid UUID with the exception that zero
22776
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22777
+ # @param [String] fields
22778
+ # Selector specifying which fields to include in a partial response.
22779
+ # @param [String] quota_user
22780
+ # Available to use for quota purposes for server-side applications. Can be any
22781
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
22782
+ # @param [String] user_ip
22783
+ # Legacy name for parameter that has been superseded by `quotaUser`.
22784
+ # @param [Google::Apis::RequestOptions] options
22785
+ # Request-specific options
22786
+ #
22787
+ # @yield [result, err] Result & error if block supplied
22788
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
22789
+ # @yieldparam err [StandardError] error object if request failed
22790
+ #
22791
+ # @return [Google::Apis::ComputeV1::Operation]
22792
+ #
22793
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22794
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22795
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
22796
+ def insert_public_advertised_prefix(project, public_advertised_prefix_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22797
+ command = make_simple_command(:post, 'projects/{project}/global/publicAdvertisedPrefixes', options)
22798
+ command.request_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefix::Representation
22799
+ command.request_object = public_advertised_prefix_object
22800
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
22801
+ command.response_class = Google::Apis::ComputeV1::Operation
22802
+ command.params['project'] = project unless project.nil?
22803
+ command.query['requestId'] = request_id unless request_id.nil?
22804
+ command.query['fields'] = fields unless fields.nil?
22805
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
22806
+ command.query['userIp'] = user_ip unless user_ip.nil?
22807
+ execute_or_queue_command(command, &block)
22808
+ end
22809
+
22810
+ # Lists the PublicAdvertisedPrefixes for a project.
22811
+ # @param [String] project
22812
+ # Project ID for this request.
22813
+ # @param [String] filter
22814
+ # A filter expression that filters resources listed in the response. Most
22815
+ # Compute resources support two types of filter expressions: expressions that
22816
+ # support regular expressions and expressions that follow API improvement
22817
+ # proposal AIP-160. These two types of filter expressions cannot be mixed in one
22818
+ # request. If you want to use AIP-160, your expression must specify the field
22819
+ # name, an operator, and the value that you want to use for filtering. The value
22820
+ # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
22821
+ # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
22822
+ # Engine instances, you can exclude instances named `example-instance` by
22823
+ # specifying `name != example-instance`. The `:*` comparison can be used to test
22824
+ # whether a key has been defined. For example, to find all objects with `owner`
22825
+ # label use: ``` labels.owner:* ``` You can also filter nested fields. For
22826
+ # example, you could specify `scheduling.automaticRestart = false` to include
22827
+ # instances only if they are not scheduled for automatic restarts. You can use
22828
+ # filtering on nested fields to filter based on resource labels. To filter on
22829
+ # multiple expressions, provide each separate expression within parentheses. For
22830
+ # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
22831
+ # Skylake") ``` By default, each expression is an `AND` expression. However, you
22832
+ # can include `AND` and `OR` expressions explicitly. For example: ``` (
22833
+ # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
22834
+ # scheduling.automaticRestart = true) ``` If you want to use a regular
22835
+ # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
22836
+ # un-parenthesized expression with or without quotes or against multiple
22837
+ # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
22838
+ # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
22839
+ # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
22840
+ # interpreted as a regular expression using Google RE2 library syntax. The
22841
+ # literal value must match the entire field. For example, to filter for
22842
+ # instances that do not end with name "instance", you would use `name ne .*
22843
+ # instance`. You cannot combine constraints on multiple fields using regular
22844
+ # expressions.
22845
+ # @param [Fixnum] max_results
22846
+ # The maximum number of results per page that should be returned. If the number
22847
+ # of available results is larger than `maxResults`, Compute Engine returns a `
22848
+ # nextPageToken` that can be used to get the next page of results in subsequent
22849
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
22850
+ # @param [String] order_by
22851
+ # Sorts list results by a certain order. By default, results are returned in
22852
+ # alphanumerical order based on the resource name. You can also sort results in
22853
+ # descending order based on the creation timestamp using `orderBy="
22854
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
22855
+ # field in reverse chronological order (newest result first). Use this to sort
22856
+ # resources like operations so that the newest operation is returned first.
22857
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
22858
+ # @param [String] page_token
22859
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
22860
+ # by a previous list request to get the next page of results.
22861
+ # @param [Boolean] return_partial_success
22862
+ # Opt-in for partial success behavior which provides partial results in case of
22863
+ # failure. The default value is false. For example, when partial success
22864
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
22865
+ # resources in the zone or no resources, with an error code.
22866
+ # @param [String] fields
22867
+ # Selector specifying which fields to include in a partial response.
22868
+ # @param [String] quota_user
22869
+ # Available to use for quota purposes for server-side applications. Can be any
22870
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
22871
+ # @param [String] user_ip
22872
+ # Legacy name for parameter that has been superseded by `quotaUser`.
22873
+ # @param [Google::Apis::RequestOptions] options
22874
+ # Request-specific options
22875
+ #
22876
+ # @yield [result, err] Result & error if block supplied
22877
+ # @yieldparam result [Google::Apis::ComputeV1::PublicAdvertisedPrefixList] parsed result object
22878
+ # @yieldparam err [StandardError] error object if request failed
22879
+ #
22880
+ # @return [Google::Apis::ComputeV1::PublicAdvertisedPrefixList]
22881
+ #
22882
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
22883
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
22884
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
22885
+ def list_public_advertised_prefixes(project, filter: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
22886
+ command = make_simple_command(:get, 'projects/{project}/global/publicAdvertisedPrefixes', options)
22887
+ command.response_representation = Google::Apis::ComputeV1::PublicAdvertisedPrefixList::Representation
22888
+ command.response_class = Google::Apis::ComputeV1::PublicAdvertisedPrefixList
22889
+ command.params['project'] = project unless project.nil?
22890
+ command.query['filter'] = filter unless filter.nil?
22891
+ command.query['maxResults'] = max_results unless max_results.nil?
22892
+ command.query['orderBy'] = order_by unless order_by.nil?
22893
+ command.query['pageToken'] = page_token unless page_token.nil?
22894
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
22895
+ command.query['fields'] = fields unless fields.nil?
22896
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
22897
+ command.query['userIp'] = user_ip unless user_ip.nil?
22898
+ execute_or_queue_command(command, &block)
22899
+ end
22900
+
22901
+ # Patches the specified Router resource with the data included in the request.
22902
+ # This method supports PATCH semantics and uses JSON merge patch format and
22903
+ # processing rules.
22904
+ # @param [String] project
22905
+ # Project ID for this request.
22906
+ # @param [String] public_advertised_prefix
22907
+ # Name of the PublicAdvertisedPrefix resource to patch.
22908
+ # @param [Google::Apis::ComputeV1::PublicAdvertisedPrefix] public_advertised_prefix_object
22159
22909
  # @param [String] request_id
22160
22910
  # An optional request ID to identify requests. Specify a unique request ID so
22161
22911
  # that if you must retry your request, the server will know to ignore the
@@ -22248,7 +22998,8 @@ module Google
22248
22998
  end
22249
22999
 
22250
23000
  # Lists all PublicDelegatedPrefix resources owned by the specific project across
22251
- # all scopes.
23001
+ # all scopes. To prevent failure, Google recommends that you set the `
23002
+ # returnPartialSuccess` parameter to `true`.
22252
23003
  # @param [String] project
22253
23004
  # Name of the project scoping this request.
22254
23005
  # @param [String] filter
@@ -22308,7 +23059,9 @@ module Google
22308
23059
  # by a previous list request to get the next page of results.
22309
23060
  # @param [Boolean] return_partial_success
22310
23061
  # Opt-in for partial success behavior which provides partial results in case of
22311
- # failure. The default value is false.
23062
+ # failure. The default value is false. For example, when partial success
23063
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
23064
+ # resources in the zone or no resources, with an error code.
22312
23065
  # @param [Fixnum] service_project_number
22313
23066
  # The Shared VPC service project id or service project number for which
22314
23067
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -22595,7 +23348,9 @@ module Google
22595
23348
  # by a previous list request to get the next page of results.
22596
23349
  # @param [Boolean] return_partial_success
22597
23350
  # Opt-in for partial success behavior which provides partial results in case of
22598
- # failure. The default value is false.
23351
+ # failure. The default value is false. For example, when partial success
23352
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
23353
+ # resources in the zone or no resources, with an error code.
22599
23354
  # @param [String] fields
22600
23355
  # Selector specifying which fields to include in a partial response.
22601
23356
  # @param [String] quota_user
@@ -22933,7 +23688,9 @@ module Google
22933
23688
  # by a previous list request to get the next page of results.
22934
23689
  # @param [Boolean] return_partial_success
22935
23690
  # Opt-in for partial success behavior which provides partial results in case of
22936
- # failure. The default value is false.
23691
+ # failure. The default value is false. For example, when partial success
23692
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
23693
+ # resources in the zone or no resources, with an error code.
22937
23694
  # @param [String] fields
22938
23695
  # Selector specifying which fields to include in a partial response.
22939
23696
  # @param [String] quota_user
@@ -23360,7 +24117,9 @@ module Google
23360
24117
  # by a previous list request to get the next page of results.
23361
24118
  # @param [Boolean] return_partial_success
23362
24119
  # Opt-in for partial success behavior which provides partial results in case of
23363
- # failure. The default value is false.
24120
+ # failure. The default value is false. For example, when partial success
24121
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
24122
+ # resources in the zone or no resources, with an error code.
23364
24123
  # @param [String] fields
23365
24124
  # Selector specifying which fields to include in a partial response.
23366
24125
  # @param [String] quota_user
@@ -23454,7 +24213,9 @@ module Google
23454
24213
  # by a previous list request to get the next page of results.
23455
24214
  # @param [Boolean] return_partial_success
23456
24215
  # Opt-in for partial success behavior which provides partial results in case of
23457
- # failure. The default value is false.
24216
+ # failure. The default value is false. For example, when partial success
24217
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
24218
+ # resources in the zone or no resources, with an error code.
23458
24219
  # @param [String] fields
23459
24220
  # Selector specifying which fields to include in a partial response.
23460
24221
  # @param [String] quota_user
@@ -23741,7 +24502,8 @@ module Google
23741
24502
  execute_or_queue_command(command, &block)
23742
24503
  end
23743
24504
 
23744
- # Retrieves an aggregated list of commitments by region.
24505
+ # Retrieves an aggregated list of commitments by region. To prevent failure,
24506
+ # Google recommends that you set the `returnPartialSuccess` parameter to `true`.
23745
24507
  # @param [String] project
23746
24508
  # Project ID for this request.
23747
24509
  # @param [String] filter
@@ -23801,7 +24563,9 @@ module Google
23801
24563
  # by a previous list request to get the next page of results.
23802
24564
  # @param [Boolean] return_partial_success
23803
24565
  # Opt-in for partial success behavior which provides partial results in case of
23804
- # failure. The default value is false.
24566
+ # failure. The default value is false. For example, when partial success
24567
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
24568
+ # resources in the zone or no resources, with an error code.
23805
24569
  # @param [Fixnum] service_project_number
23806
24570
  # The Shared VPC service project id or service project number for which
23807
24571
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -23987,7 +24751,9 @@ module Google
23987
24751
  # by a previous list request to get the next page of results.
23988
24752
  # @param [Boolean] return_partial_success
23989
24753
  # Opt-in for partial success behavior which provides partial results in case of
23990
- # failure. The default value is false.
24754
+ # failure. The default value is false. For example, when partial success
24755
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
24756
+ # resources in the zone or no resources, with an error code.
23991
24757
  # @param [String] fields
23992
24758
  # Selector specifying which fields to include in a partial response.
23993
24759
  # @param [String] quota_user
@@ -24178,7 +24944,9 @@ module Google
24178
24944
  # by a previous list request to get the next page of results.
24179
24945
  # @param [Boolean] return_partial_success
24180
24946
  # Opt-in for partial success behavior which provides partial results in case of
24181
- # failure. The default value is false.
24947
+ # failure. The default value is false. For example, when partial success
24948
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
24949
+ # resources in the zone or no resources, with an error code.
24182
24950
  # @param [String] fields
24183
24951
  # Selector specifying which fields to include in a partial response.
24184
24952
  # @param [String] quota_user
@@ -24619,7 +25387,9 @@ module Google
24619
25387
  # by a previous list request to get the next page of results.
24620
25388
  # @param [Boolean] return_partial_success
24621
25389
  # Opt-in for partial success behavior which provides partial results in case of
24622
- # failure. The default value is false.
25390
+ # failure. The default value is false. For example, when partial success
25391
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
25392
+ # resources in the zone or no resources, with an error code.
24623
25393
  # @param [String] fields
24624
25394
  # Selector specifying which fields to include in a partial response.
24625
25395
  # @param [String] quota_user
@@ -25314,7 +26084,9 @@ module Google
25314
26084
  # by a previous list request to get the next page of results.
25315
26085
  # @param [Boolean] return_partial_success
25316
26086
  # Opt-in for partial success behavior which provides partial results in case of
25317
- # failure. The default value is false.
26087
+ # failure. The default value is false. For example, when partial success
26088
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
26089
+ # resources in the zone or no resources, with an error code.
25318
26090
  # @param [String] fields
25319
26091
  # Selector specifying which fields to include in a partial response.
25320
26092
  # @param [String] quota_user
@@ -25602,7 +26374,9 @@ module Google
25602
26374
  # by a previous list request to get the next page of results.
25603
26375
  # @param [Boolean] return_partial_success
25604
26376
  # Opt-in for partial success behavior which provides partial results in case of
25605
- # failure. The default value is false.
26377
+ # failure. The default value is false. For example, when partial success
26378
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
26379
+ # resources in the zone or no resources, with an error code.
25606
26380
  # @param [String] fields
25607
26381
  # Selector specifying which fields to include in a partial response.
25608
26382
  # @param [String] quota_user
@@ -26219,7 +26993,9 @@ module Google
26219
26993
  # by a previous list request to get the next page of results.
26220
26994
  # @param [Boolean] return_partial_success
26221
26995
  # Opt-in for partial success behavior which provides partial results in case of
26222
- # failure. The default value is false.
26996
+ # failure. The default value is false. For example, when partial success
26997
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
26998
+ # resources in the zone or no resources, with an error code.
26223
26999
  # @param [String] fields
26224
27000
  # Selector specifying which fields to include in a partial response.
26225
27001
  # @param [String] quota_user
@@ -26316,7 +27092,9 @@ module Google
26316
27092
  # by a previous list request to get the next page of results.
26317
27093
  # @param [Boolean] return_partial_success
26318
27094
  # Opt-in for partial success behavior which provides partial results in case of
26319
- # failure. The default value is false.
27095
+ # failure. The default value is false. For example, when partial success
27096
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
27097
+ # resources in the zone or no resources, with an error code.
26320
27098
  # @param [String] fields
26321
27099
  # Selector specifying which fields to include in a partial response.
26322
27100
  # @param [String] quota_user
@@ -26415,7 +27193,9 @@ module Google
26415
27193
  # by a previous list request to get the next page of results.
26416
27194
  # @param [Boolean] return_partial_success
26417
27195
  # Opt-in for partial success behavior which provides partial results in case of
26418
- # failure. The default value is false.
27196
+ # failure. The default value is false. For example, when partial success
27197
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
27198
+ # resources in the zone or no resources, with an error code.
26419
27199
  # @param [String] fields
26420
27200
  # Selector specifying which fields to include in a partial response.
26421
27201
  # @param [String] quota_user
@@ -26511,7 +27291,9 @@ module Google
26511
27291
  # by a previous list request to get the next page of results.
26512
27292
  # @param [Boolean] return_partial_success
26513
27293
  # Opt-in for partial success behavior which provides partial results in case of
26514
- # failure. The default value is false.
27294
+ # failure. The default value is false. For example, when partial success
27295
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
27296
+ # resources in the zone or no resources, with an error code.
26515
27297
  # @param [String] fields
26516
27298
  # Selector specifying which fields to include in a partial response.
26517
27299
  # @param [String] quota_user
@@ -27047,7 +27829,9 @@ module Google
27047
27829
  # by a previous list request to get the next page of results.
27048
27830
  # @param [Boolean] return_partial_success
27049
27831
  # Opt-in for partial success behavior which provides partial results in case of
27050
- # failure. The default value is false.
27832
+ # failure. The default value is false. For example, when partial success
27833
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
27834
+ # resources in the zone or no resources, with an error code.
27051
27835
  # @param [String] fields
27052
27836
  # Selector specifying which fields to include in a partial response.
27053
27837
  # @param [String] quota_user
@@ -27145,7 +27929,634 @@ module Google
27145
27929
  # by a previous list request to get the next page of results.
27146
27930
  # @param [Boolean] return_partial_success
27147
27931
  # Opt-in for partial success behavior which provides partial results in case of
27148
- # failure. The default value is false.
27932
+ # failure. The default value is false. For example, when partial success
27933
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
27934
+ # resources in the zone or no resources, with an error code.
27935
+ # @param [String] fields
27936
+ # Selector specifying which fields to include in a partial response.
27937
+ # @param [String] quota_user
27938
+ # Available to use for quota purposes for server-side applications. Can be any
27939
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
27940
+ # @param [String] user_ip
27941
+ # Legacy name for parameter that has been superseded by `quotaUser`.
27942
+ # @param [Google::Apis::RequestOptions] options
27943
+ # Request-specific options
27944
+ #
27945
+ # @yield [result, err] Result & error if block supplied
27946
+ # @yieldparam result [Google::Apis::ComputeV1::RegionInstanceGroupsListInstances] parsed result object
27947
+ # @yieldparam err [StandardError] error object if request failed
27948
+ #
27949
+ # @return [Google::Apis::ComputeV1::RegionInstanceGroupsListInstances]
27950
+ #
27951
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27952
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27953
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
27954
+ def list_region_instance_group_instances(project, region, instance_group, region_instance_groups_list_instances_request_object = nil, 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)
27955
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances', options)
27956
+ command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupsListInstancesRequest::Representation
27957
+ command.request_object = region_instance_groups_list_instances_request_object
27958
+ command.response_representation = Google::Apis::ComputeV1::RegionInstanceGroupsListInstances::Representation
27959
+ command.response_class = Google::Apis::ComputeV1::RegionInstanceGroupsListInstances
27960
+ command.params['project'] = project unless project.nil?
27961
+ command.params['region'] = region unless region.nil?
27962
+ command.params['instanceGroup'] = instance_group unless instance_group.nil?
27963
+ command.query['filter'] = filter unless filter.nil?
27964
+ command.query['maxResults'] = max_results unless max_results.nil?
27965
+ command.query['orderBy'] = order_by unless order_by.nil?
27966
+ command.query['pageToken'] = page_token unless page_token.nil?
27967
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
27968
+ command.query['fields'] = fields unless fields.nil?
27969
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
27970
+ command.query['userIp'] = user_ip unless user_ip.nil?
27971
+ execute_or_queue_command(command, &block)
27972
+ end
27973
+
27974
+ # Sets the named ports for the specified regional instance group.
27975
+ # @param [String] project
27976
+ # Project ID for this request.
27977
+ # @param [String] region
27978
+ # Name of the region scoping this request.
27979
+ # @param [String] instance_group
27980
+ # The name of the regional instance group where the named ports are updated.
27981
+ # @param [Google::Apis::ComputeV1::RegionInstanceGroupsSetNamedPortsRequest] region_instance_groups_set_named_ports_request_object
27982
+ # @param [String] request_id
27983
+ # An optional request ID to identify requests. Specify a unique request ID so
27984
+ # that if you must retry your request, the server will know to ignore the
27985
+ # request if it has already been completed. For example, consider a situation
27986
+ # where you make an initial request and the request times out. If you make the
27987
+ # request again with the same request ID, the server can check if original
27988
+ # operation with the same request ID was received, and if so, will ignore the
27989
+ # second request. This prevents clients from accidentally creating duplicate
27990
+ # commitments. The request ID must be a valid UUID with the exception that zero
27991
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27992
+ # @param [String] fields
27993
+ # Selector specifying which fields to include in a partial response.
27994
+ # @param [String] quota_user
27995
+ # Available to use for quota purposes for server-side applications. Can be any
27996
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
27997
+ # @param [String] user_ip
27998
+ # Legacy name for parameter that has been superseded by `quotaUser`.
27999
+ # @param [Google::Apis::RequestOptions] options
28000
+ # Request-specific options
28001
+ #
28002
+ # @yield [result, err] Result & error if block supplied
28003
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28004
+ # @yieldparam err [StandardError] error object if request failed
28005
+ #
28006
+ # @return [Google::Apis::ComputeV1::Operation]
28007
+ #
28008
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28009
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28010
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28011
+ def set_region_instance_group_named_ports(project, region, instance_group, region_instance_groups_set_named_ports_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28012
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts', options)
28013
+ command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupsSetNamedPortsRequest::Representation
28014
+ command.request_object = region_instance_groups_set_named_ports_request_object
28015
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28016
+ command.response_class = Google::Apis::ComputeV1::Operation
28017
+ command.params['project'] = project unless project.nil?
28018
+ command.params['region'] = region unless region.nil?
28019
+ command.params['instanceGroup'] = instance_group unless instance_group.nil?
28020
+ command.query['requestId'] = request_id unless request_id.nil?
28021
+ command.query['fields'] = fields unless fields.nil?
28022
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28023
+ command.query['userIp'] = user_ip unless user_ip.nil?
28024
+ execute_or_queue_command(command, &block)
28025
+ end
28026
+
28027
+ # Deletes the specified instance template. Deleting an instance template is
28028
+ # permanent and cannot be undone.
28029
+ # @param [String] project
28030
+ # Project ID for this request.
28031
+ # @param [String] region
28032
+ # The name of the region for this request.
28033
+ # @param [String] instance_template
28034
+ # The name of the instance template to delete.
28035
+ # @param [String] request_id
28036
+ # An optional request ID to identify requests. Specify a unique request ID so
28037
+ # that if you must retry your request, the server will know to ignore the
28038
+ # request if it has already been completed. For example, consider a situation
28039
+ # where you make an initial request and the request times out. If you make the
28040
+ # request again with the same request ID, the server can check if original
28041
+ # operation with the same request ID was received, and if so, will ignore the
28042
+ # second request. This prevents clients from accidentally creating duplicate
28043
+ # commitments. The request ID must be a valid UUID with the exception that zero
28044
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28045
+ # @param [String] fields
28046
+ # Selector specifying which fields to include in a partial response.
28047
+ # @param [String] quota_user
28048
+ # Available to use for quota purposes for server-side applications. Can be any
28049
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28050
+ # @param [String] user_ip
28051
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28052
+ # @param [Google::Apis::RequestOptions] options
28053
+ # Request-specific options
28054
+ #
28055
+ # @yield [result, err] Result & error if block supplied
28056
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28057
+ # @yieldparam err [StandardError] error object if request failed
28058
+ #
28059
+ # @return [Google::Apis::ComputeV1::Operation]
28060
+ #
28061
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28062
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28063
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28064
+ def delete_region_instance_template(project, region, instance_template, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28065
+ command = make_simple_command(:delete, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
28066
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28067
+ command.response_class = Google::Apis::ComputeV1::Operation
28068
+ command.params['project'] = project unless project.nil?
28069
+ command.params['region'] = region unless region.nil?
28070
+ command.params['instanceTemplate'] = instance_template unless instance_template.nil?
28071
+ command.query['requestId'] = request_id unless request_id.nil?
28072
+ command.query['fields'] = fields unless fields.nil?
28073
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28074
+ command.query['userIp'] = user_ip unless user_ip.nil?
28075
+ execute_or_queue_command(command, &block)
28076
+ end
28077
+
28078
+ # Returns the specified instance template.
28079
+ # @param [String] project
28080
+ # Project ID for this request.
28081
+ # @param [String] region
28082
+ # The name of the region for this request.
28083
+ # @param [String] instance_template
28084
+ # The name of the instance template.
28085
+ # @param [String] fields
28086
+ # Selector specifying which fields to include in a partial response.
28087
+ # @param [String] quota_user
28088
+ # Available to use for quota purposes for server-side applications. Can be any
28089
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28090
+ # @param [String] user_ip
28091
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28092
+ # @param [Google::Apis::RequestOptions] options
28093
+ # Request-specific options
28094
+ #
28095
+ # @yield [result, err] Result & error if block supplied
28096
+ # @yieldparam result [Google::Apis::ComputeV1::InstanceTemplate] parsed result object
28097
+ # @yieldparam err [StandardError] error object if request failed
28098
+ #
28099
+ # @return [Google::Apis::ComputeV1::InstanceTemplate]
28100
+ #
28101
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28102
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28103
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28104
+ def get_region_instance_template(project, region, instance_template, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28105
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
28106
+ command.response_representation = Google::Apis::ComputeV1::InstanceTemplate::Representation
28107
+ command.response_class = Google::Apis::ComputeV1::InstanceTemplate
28108
+ command.params['project'] = project unless project.nil?
28109
+ command.params['region'] = region unless region.nil?
28110
+ command.params['instanceTemplate'] = instance_template unless instance_template.nil?
28111
+ command.query['fields'] = fields unless fields.nil?
28112
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28113
+ command.query['userIp'] = user_ip unless user_ip.nil?
28114
+ execute_or_queue_command(command, &block)
28115
+ end
28116
+
28117
+ # Creates an instance template in the specified project and region using the
28118
+ # global instance template whose URL is included in the request.
28119
+ # @param [String] project
28120
+ # Project ID for this request.
28121
+ # @param [String] region
28122
+ # The name of the region for this request.
28123
+ # @param [Google::Apis::ComputeV1::InstanceTemplate] instance_template_object
28124
+ # @param [String] request_id
28125
+ # An optional request ID to identify requests. Specify a unique request ID so
28126
+ # that if you must retry your request, the server will know to ignore the
28127
+ # request if it has already been completed. For example, consider a situation
28128
+ # where you make an initial request and the request times out. If you make the
28129
+ # request again with the same request ID, the server can check if original
28130
+ # operation with the same request ID was received, and if so, will ignore the
28131
+ # second request. This prevents clients from accidentally creating duplicate
28132
+ # commitments. The request ID must be a valid UUID with the exception that zero
28133
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28134
+ # @param [String] fields
28135
+ # Selector specifying which fields to include in a partial response.
28136
+ # @param [String] quota_user
28137
+ # Available to use for quota purposes for server-side applications. Can be any
28138
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28139
+ # @param [String] user_ip
28140
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28141
+ # @param [Google::Apis::RequestOptions] options
28142
+ # Request-specific options
28143
+ #
28144
+ # @yield [result, err] Result & error if block supplied
28145
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28146
+ # @yieldparam err [StandardError] error object if request failed
28147
+ #
28148
+ # @return [Google::Apis::ComputeV1::Operation]
28149
+ #
28150
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28151
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28152
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28153
+ 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)
28154
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceTemplates', options)
28155
+ command.request_representation = Google::Apis::ComputeV1::InstanceTemplate::Representation
28156
+ command.request_object = instance_template_object
28157
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28158
+ command.response_class = Google::Apis::ComputeV1::Operation
28159
+ command.params['project'] = project unless project.nil?
28160
+ command.params['region'] = region unless region.nil?
28161
+ command.query['requestId'] = request_id unless request_id.nil?
28162
+ command.query['fields'] = fields unless fields.nil?
28163
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28164
+ command.query['userIp'] = user_ip unless user_ip.nil?
28165
+ execute_or_queue_command(command, &block)
28166
+ end
28167
+
28168
+ # Retrieves a list of instance templates that are contained within the specified
28169
+ # project and region.
28170
+ # @param [String] project
28171
+ # Project ID for this request.
28172
+ # @param [String] region
28173
+ # The name of the regions for this request.
28174
+ # @param [String] filter
28175
+ # A filter expression that filters resources listed in the response. Most
28176
+ # Compute resources support two types of filter expressions: expressions that
28177
+ # support regular expressions and expressions that follow API improvement
28178
+ # proposal AIP-160. These two types of filter expressions cannot be mixed in one
28179
+ # request. If you want to use AIP-160, your expression must specify the field
28180
+ # name, an operator, and the value that you want to use for filtering. The value
28181
+ # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
28182
+ # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
28183
+ # Engine instances, you can exclude instances named `example-instance` by
28184
+ # specifying `name != example-instance`. The `:*` comparison can be used to test
28185
+ # whether a key has been defined. For example, to find all objects with `owner`
28186
+ # label use: ``` labels.owner:* ``` You can also filter nested fields. For
28187
+ # example, you could specify `scheduling.automaticRestart = false` to include
28188
+ # instances only if they are not scheduled for automatic restarts. You can use
28189
+ # filtering on nested fields to filter based on resource labels. To filter on
28190
+ # multiple expressions, provide each separate expression within parentheses. For
28191
+ # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
28192
+ # Skylake") ``` By default, each expression is an `AND` expression. However, you
28193
+ # can include `AND` and `OR` expressions explicitly. For example: ``` (
28194
+ # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
28195
+ # scheduling.automaticRestart = true) ``` If you want to use a regular
28196
+ # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
28197
+ # un-parenthesized expression with or without quotes or against multiple
28198
+ # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
28199
+ # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
28200
+ # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
28201
+ # interpreted as a regular expression using Google RE2 library syntax. The
28202
+ # literal value must match the entire field. For example, to filter for
28203
+ # instances that do not end with name "instance", you would use `name ne .*
28204
+ # instance`. You cannot combine constraints on multiple fields using regular
28205
+ # expressions.
28206
+ # @param [Fixnum] max_results
28207
+ # The maximum number of results per page that should be returned. If the number
28208
+ # of available results is larger than `maxResults`, Compute Engine returns a `
28209
+ # nextPageToken` that can be used to get the next page of results in subsequent
28210
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
28211
+ # @param [String] order_by
28212
+ # Sorts list results by a certain order. By default, results are returned in
28213
+ # alphanumerical order based on the resource name. You can also sort results in
28214
+ # descending order based on the creation timestamp using `orderBy="
28215
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
28216
+ # field in reverse chronological order (newest result first). Use this to sort
28217
+ # resources like operations so that the newest operation is returned first.
28218
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
28219
+ # @param [String] page_token
28220
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
28221
+ # by a previous list request to get the next page of results.
28222
+ # @param [Boolean] return_partial_success
28223
+ # Opt-in for partial success behavior which provides partial results in case of
28224
+ # failure. The default value is false. For example, when partial success
28225
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
28226
+ # resources in the zone or no resources, with an error code.
28227
+ # @param [String] fields
28228
+ # Selector specifying which fields to include in a partial response.
28229
+ # @param [String] quota_user
28230
+ # Available to use for quota purposes for server-side applications. Can be any
28231
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28232
+ # @param [String] user_ip
28233
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28234
+ # @param [Google::Apis::RequestOptions] options
28235
+ # Request-specific options
28236
+ #
28237
+ # @yield [result, err] Result & error if block supplied
28238
+ # @yieldparam result [Google::Apis::ComputeV1::InstanceTemplateList] parsed result object
28239
+ # @yieldparam err [StandardError] error object if request failed
28240
+ #
28241
+ # @return [Google::Apis::ComputeV1::InstanceTemplateList]
28242
+ #
28243
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28244
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28245
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28246
+ 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)
28247
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates', options)
28248
+ command.response_representation = Google::Apis::ComputeV1::InstanceTemplateList::Representation
28249
+ command.response_class = Google::Apis::ComputeV1::InstanceTemplateList
28250
+ command.params['project'] = project unless project.nil?
28251
+ command.params['region'] = region unless region.nil?
28252
+ command.query['filter'] = filter unless filter.nil?
28253
+ command.query['maxResults'] = max_results unless max_results.nil?
28254
+ command.query['orderBy'] = order_by unless order_by.nil?
28255
+ command.query['pageToken'] = page_token unless page_token.nil?
28256
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
28257
+ command.query['fields'] = fields unless fields.nil?
28258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28259
+ command.query['userIp'] = user_ip unless user_ip.nil?
28260
+ execute_or_queue_command(command, &block)
28261
+ end
28262
+
28263
+ # Creates multiple instances in a given region. Count specifies the number of
28264
+ # instances to create.
28265
+ # @param [String] project
28266
+ # Project ID for this request.
28267
+ # @param [String] region
28268
+ # The name of the region for this request.
28269
+ # @param [Google::Apis::ComputeV1::BulkInsertInstanceResource] bulk_insert_instance_resource_object
28270
+ # @param [String] request_id
28271
+ # An optional request ID to identify requests. Specify a unique request ID so
28272
+ # that if you must retry your request, the server will know to ignore the
28273
+ # request if it has already been completed. For example, consider a situation
28274
+ # where you make an initial request and the request times out. If you make the
28275
+ # request again with the same request ID, the server can check if original
28276
+ # operation with the same request ID was received, and if so, will ignore the
28277
+ # second request. This prevents clients from accidentally creating duplicate
28278
+ # commitments. The request ID must be a valid UUID with the exception that zero
28279
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28280
+ # @param [String] fields
28281
+ # Selector specifying which fields to include in a partial response.
28282
+ # @param [String] quota_user
28283
+ # Available to use for quota purposes for server-side applications. Can be any
28284
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28285
+ # @param [String] user_ip
28286
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28287
+ # @param [Google::Apis::RequestOptions] options
28288
+ # Request-specific options
28289
+ #
28290
+ # @yield [result, err] Result & error if block supplied
28291
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28292
+ # @yieldparam err [StandardError] error object if request failed
28293
+ #
28294
+ # @return [Google::Apis::ComputeV1::Operation]
28295
+ #
28296
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28297
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28298
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28299
+ def bulk_region_instance_insert(project, region, bulk_insert_instance_resource_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28300
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instances/bulkInsert', options)
28301
+ command.request_representation = Google::Apis::ComputeV1::BulkInsertInstanceResource::Representation
28302
+ command.request_object = bulk_insert_instance_resource_object
28303
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28304
+ command.response_class = Google::Apis::ComputeV1::Operation
28305
+ command.params['project'] = project unless project.nil?
28306
+ command.params['region'] = region unless region.nil?
28307
+ command.query['requestId'] = request_id unless request_id.nil?
28308
+ command.query['fields'] = fields unless fields.nil?
28309
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28310
+ command.query['userIp'] = user_ip unless user_ip.nil?
28311
+ execute_or_queue_command(command, &block)
28312
+ end
28313
+
28314
+ # Deletes the specified InstantSnapshot resource. Keep in mind that deleting a
28315
+ # single instantSnapshot might not necessarily delete all the data on that
28316
+ # instantSnapshot. If any data on the instantSnapshot that is marked for
28317
+ # deletion is needed for subsequent instantSnapshots, the data will be moved to
28318
+ # the next corresponding instantSnapshot. For more information, see Deleting
28319
+ # instantSnapshots.
28320
+ # @param [String] project
28321
+ # Project ID for this request.
28322
+ # @param [String] region
28323
+ # The name of the region for this request.
28324
+ # @param [String] instant_snapshot
28325
+ # Name of the InstantSnapshot resource to delete.
28326
+ # @param [String] request_id
28327
+ # An optional request ID to identify requests. Specify a unique request ID so
28328
+ # that if you must retry your request, the server will know to ignore the
28329
+ # request if it has already been completed. For example, consider a situation
28330
+ # where you make an initial request and the request times out. If you make the
28331
+ # request again with the same request ID, the server can check if original
28332
+ # operation with the same request ID was received, and if so, will ignore the
28333
+ # second request. This prevents clients from accidentally creating duplicate
28334
+ # commitments. The request ID must be a valid UUID with the exception that zero
28335
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28336
+ # @param [String] fields
28337
+ # Selector specifying which fields to include in a partial response.
28338
+ # @param [String] quota_user
28339
+ # Available to use for quota purposes for server-side applications. Can be any
28340
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28341
+ # @param [String] user_ip
28342
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28343
+ # @param [Google::Apis::RequestOptions] options
28344
+ # Request-specific options
28345
+ #
28346
+ # @yield [result, err] Result & error if block supplied
28347
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28348
+ # @yieldparam err [StandardError] error object if request failed
28349
+ #
28350
+ # @return [Google::Apis::ComputeV1::Operation]
28351
+ #
28352
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28353
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28354
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28355
+ def delete_region_instant_snapshot(project, region, instant_snapshot, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28356
+ command = make_simple_command(:delete, 'projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}', options)
28357
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28358
+ command.response_class = Google::Apis::ComputeV1::Operation
28359
+ command.params['project'] = project unless project.nil?
28360
+ command.params['region'] = region unless region.nil?
28361
+ command.params['instantSnapshot'] = instant_snapshot unless instant_snapshot.nil?
28362
+ command.query['requestId'] = request_id unless request_id.nil?
28363
+ command.query['fields'] = fields unless fields.nil?
28364
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28365
+ command.query['userIp'] = user_ip unless user_ip.nil?
28366
+ execute_or_queue_command(command, &block)
28367
+ end
28368
+
28369
+ # Returns the specified InstantSnapshot resource in the specified region.
28370
+ # @param [String] project
28371
+ # Project ID for this request.
28372
+ # @param [String] region
28373
+ # The name of the region for this request.
28374
+ # @param [String] instant_snapshot
28375
+ # Name of the InstantSnapshot resource to return.
28376
+ # @param [String] fields
28377
+ # Selector specifying which fields to include in a partial response.
28378
+ # @param [String] quota_user
28379
+ # Available to use for quota purposes for server-side applications. Can be any
28380
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28381
+ # @param [String] user_ip
28382
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28383
+ # @param [Google::Apis::RequestOptions] options
28384
+ # Request-specific options
28385
+ #
28386
+ # @yield [result, err] Result & error if block supplied
28387
+ # @yieldparam result [Google::Apis::ComputeV1::InstantSnapshot] parsed result object
28388
+ # @yieldparam err [StandardError] error object if request failed
28389
+ #
28390
+ # @return [Google::Apis::ComputeV1::InstantSnapshot]
28391
+ #
28392
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28393
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28394
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28395
+ def get_region_instant_snapshot(project, region, instant_snapshot, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28396
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}', options)
28397
+ command.response_representation = Google::Apis::ComputeV1::InstantSnapshot::Representation
28398
+ command.response_class = Google::Apis::ComputeV1::InstantSnapshot
28399
+ command.params['project'] = project unless project.nil?
28400
+ command.params['region'] = region unless region.nil?
28401
+ command.params['instantSnapshot'] = instant_snapshot unless instant_snapshot.nil?
28402
+ command.query['fields'] = fields unless fields.nil?
28403
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28404
+ command.query['userIp'] = user_ip unless user_ip.nil?
28405
+ execute_or_queue_command(command, &block)
28406
+ end
28407
+
28408
+ # Gets the access control policy for a resource. May be empty if no such policy
28409
+ # or resource exists.
28410
+ # @param [String] project
28411
+ # Project ID for this request.
28412
+ # @param [String] region
28413
+ # The name of the region for this request.
28414
+ # @param [String] resource
28415
+ # Name or id of the resource for this request.
28416
+ # @param [Fixnum] options_requested_policy_version
28417
+ # Requested IAM Policy version.
28418
+ # @param [String] fields
28419
+ # Selector specifying which fields to include in a partial response.
28420
+ # @param [String] quota_user
28421
+ # Available to use for quota purposes for server-side applications. Can be any
28422
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28423
+ # @param [String] user_ip
28424
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28425
+ # @param [Google::Apis::RequestOptions] options
28426
+ # Request-specific options
28427
+ #
28428
+ # @yield [result, err] Result & error if block supplied
28429
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
28430
+ # @yieldparam err [StandardError] error object if request failed
28431
+ #
28432
+ # @return [Google::Apis::ComputeV1::Policy]
28433
+ #
28434
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28435
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28436
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28437
+ def get_region_instant_snapshot_iam_policy(project, region, resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28438
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy', options)
28439
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
28440
+ command.response_class = Google::Apis::ComputeV1::Policy
28441
+ command.params['project'] = project unless project.nil?
28442
+ command.params['region'] = region unless region.nil?
28443
+ command.params['resource'] = resource unless resource.nil?
28444
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
28445
+ command.query['fields'] = fields unless fields.nil?
28446
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28447
+ command.query['userIp'] = user_ip unless user_ip.nil?
28448
+ execute_or_queue_command(command, &block)
28449
+ end
28450
+
28451
+ # Creates an instant snapshot in the specified region.
28452
+ # @param [String] project
28453
+ # Project ID for this request.
28454
+ # @param [String] region
28455
+ # Name of the region for this request.
28456
+ # @param [Google::Apis::ComputeV1::InstantSnapshot] instant_snapshot_object
28457
+ # @param [String] request_id
28458
+ # An optional request ID to identify requests. Specify a unique request ID so
28459
+ # that if you must retry your request, the server will know to ignore the
28460
+ # request if it has already been completed. For example, consider a situation
28461
+ # where you make an initial request and the request times out. If you make the
28462
+ # request again with the same request ID, the server can check if original
28463
+ # operation with the same request ID was received, and if so, will ignore the
28464
+ # second request. This prevents clients from accidentally creating duplicate
28465
+ # commitments. The request ID must be a valid UUID with the exception that zero
28466
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28467
+ # @param [String] fields
28468
+ # Selector specifying which fields to include in a partial response.
28469
+ # @param [String] quota_user
28470
+ # Available to use for quota purposes for server-side applications. Can be any
28471
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
28472
+ # @param [String] user_ip
28473
+ # Legacy name for parameter that has been superseded by `quotaUser`.
28474
+ # @param [Google::Apis::RequestOptions] options
28475
+ # Request-specific options
28476
+ #
28477
+ # @yield [result, err] Result & error if block supplied
28478
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28479
+ # @yieldparam err [StandardError] error object if request failed
28480
+ #
28481
+ # @return [Google::Apis::ComputeV1::Operation]
28482
+ #
28483
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
28484
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
28485
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
28486
+ def insert_region_instant_snapshot(project, region, instant_snapshot_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28487
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instantSnapshots', options)
28488
+ command.request_representation = Google::Apis::ComputeV1::InstantSnapshot::Representation
28489
+ command.request_object = instant_snapshot_object
28490
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
28491
+ command.response_class = Google::Apis::ComputeV1::Operation
28492
+ command.params['project'] = project unless project.nil?
28493
+ command.params['region'] = region unless region.nil?
28494
+ command.query['requestId'] = request_id unless request_id.nil?
28495
+ command.query['fields'] = fields unless fields.nil?
28496
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
28497
+ command.query['userIp'] = user_ip unless user_ip.nil?
28498
+ execute_or_queue_command(command, &block)
28499
+ end
28500
+
28501
+ # Retrieves the list of InstantSnapshot resources contained within the specified
28502
+ # region.
28503
+ # @param [String] project
28504
+ # Project ID for this request.
28505
+ # @param [String] region
28506
+ # The name of the region for this request.
28507
+ # @param [String] filter
28508
+ # A filter expression that filters resources listed in the response. Most
28509
+ # Compute resources support two types of filter expressions: expressions that
28510
+ # support regular expressions and expressions that follow API improvement
28511
+ # proposal AIP-160. These two types of filter expressions cannot be mixed in one
28512
+ # request. If you want to use AIP-160, your expression must specify the field
28513
+ # name, an operator, and the value that you want to use for filtering. The value
28514
+ # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
28515
+ # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
28516
+ # Engine instances, you can exclude instances named `example-instance` by
28517
+ # specifying `name != example-instance`. The `:*` comparison can be used to test
28518
+ # whether a key has been defined. For example, to find all objects with `owner`
28519
+ # label use: ``` labels.owner:* ``` You can also filter nested fields. For
28520
+ # example, you could specify `scheduling.automaticRestart = false` to include
28521
+ # instances only if they are not scheduled for automatic restarts. You can use
28522
+ # filtering on nested fields to filter based on resource labels. To filter on
28523
+ # multiple expressions, provide each separate expression within parentheses. For
28524
+ # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
28525
+ # Skylake") ``` By default, each expression is an `AND` expression. However, you
28526
+ # can include `AND` and `OR` expressions explicitly. For example: ``` (
28527
+ # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
28528
+ # scheduling.automaticRestart = true) ``` If you want to use a regular
28529
+ # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
28530
+ # un-parenthesized expression with or without quotes or against multiple
28531
+ # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
28532
+ # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
28533
+ # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
28534
+ # interpreted as a regular expression using Google RE2 library syntax. The
28535
+ # literal value must match the entire field. For example, to filter for
28536
+ # instances that do not end with name "instance", you would use `name ne .*
28537
+ # instance`. You cannot combine constraints on multiple fields using regular
28538
+ # expressions.
28539
+ # @param [Fixnum] max_results
28540
+ # The maximum number of results per page that should be returned. If the number
28541
+ # of available results is larger than `maxResults`, Compute Engine returns a `
28542
+ # nextPageToken` that can be used to get the next page of results in subsequent
28543
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
28544
+ # @param [String] order_by
28545
+ # Sorts list results by a certain order. By default, results are returned in
28546
+ # alphanumerical order based on the resource name. You can also sort results in
28547
+ # descending order based on the creation timestamp using `orderBy="
28548
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
28549
+ # field in reverse chronological order (newest result first). Use this to sort
28550
+ # resources like operations so that the newest operation is returned first.
28551
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
28552
+ # @param [String] page_token
28553
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
28554
+ # by a previous list request to get the next page of results.
28555
+ # @param [Boolean] return_partial_success
28556
+ # Opt-in for partial success behavior which provides partial results in case of
28557
+ # failure. The default value is false. For example, when partial success
28558
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
28559
+ # resources in the zone or no resources, with an error code.
27149
28560
  # @param [String] fields
27150
28561
  # Selector specifying which fields to include in a partial response.
27151
28562
  # @param [String] quota_user
@@ -27157,23 +28568,20 @@ module Google
27157
28568
  # Request-specific options
27158
28569
  #
27159
28570
  # @yield [result, err] Result & error if block supplied
27160
- # @yieldparam result [Google::Apis::ComputeV1::RegionInstanceGroupsListInstances] parsed result object
28571
+ # @yieldparam result [Google::Apis::ComputeV1::InstantSnapshotList] parsed result object
27161
28572
  # @yieldparam err [StandardError] error object if request failed
27162
28573
  #
27163
- # @return [Google::Apis::ComputeV1::RegionInstanceGroupsListInstances]
28574
+ # @return [Google::Apis::ComputeV1::InstantSnapshotList]
27164
28575
  #
27165
28576
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27166
28577
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27167
28578
  # @raise [Google::Apis::AuthorizationError] Authorization is required
27168
- def list_region_instance_group_instances(project, region, instance_group, region_instance_groups_list_instances_request_object = nil, 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)
27169
- command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances', options)
27170
- command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupsListInstancesRequest::Representation
27171
- command.request_object = region_instance_groups_list_instances_request_object
27172
- command.response_representation = Google::Apis::ComputeV1::RegionInstanceGroupsListInstances::Representation
27173
- command.response_class = Google::Apis::ComputeV1::RegionInstanceGroupsListInstances
28579
+ def list_region_instant_snapshots(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)
28580
+ command = make_simple_command(:get, 'projects/{project}/regions/{region}/instantSnapshots', options)
28581
+ command.response_representation = Google::Apis::ComputeV1::InstantSnapshotList::Representation
28582
+ command.response_class = Google::Apis::ComputeV1::InstantSnapshotList
27174
28583
  command.params['project'] = project unless project.nil?
27175
28584
  command.params['region'] = region unless region.nil?
27176
- command.params['instanceGroup'] = instance_group unless instance_group.nil?
27177
28585
  command.query['filter'] = filter unless filter.nil?
27178
28586
  command.query['maxResults'] = max_results unless max_results.nil?
27179
28587
  command.query['orderBy'] = order_by unless order_by.nil?
@@ -27185,117 +28593,15 @@ module Google
27185
28593
  execute_or_queue_command(command, &block)
27186
28594
  end
27187
28595
 
27188
- # Sets the named ports for the specified regional instance group.
27189
- # @param [String] project
27190
- # Project ID for this request.
27191
- # @param [String] region
27192
- # Name of the region scoping this request.
27193
- # @param [String] instance_group
27194
- # The name of the regional instance group where the named ports are updated.
27195
- # @param [Google::Apis::ComputeV1::RegionInstanceGroupsSetNamedPortsRequest] region_instance_groups_set_named_ports_request_object
27196
- # @param [String] request_id
27197
- # An optional request ID to identify requests. Specify a unique request ID so
27198
- # that if you must retry your request, the server will know to ignore the
27199
- # request if it has already been completed. For example, consider a situation
27200
- # where you make an initial request and the request times out. If you make the
27201
- # request again with the same request ID, the server can check if original
27202
- # operation with the same request ID was received, and if so, will ignore the
27203
- # second request. This prevents clients from accidentally creating duplicate
27204
- # commitments. The request ID must be a valid UUID with the exception that zero
27205
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27206
- # @param [String] fields
27207
- # Selector specifying which fields to include in a partial response.
27208
- # @param [String] quota_user
27209
- # Available to use for quota purposes for server-side applications. Can be any
27210
- # arbitrary string assigned to a user, but should not exceed 40 characters.
27211
- # @param [String] user_ip
27212
- # Legacy name for parameter that has been superseded by `quotaUser`.
27213
- # @param [Google::Apis::RequestOptions] options
27214
- # Request-specific options
27215
- #
27216
- # @yield [result, err] Result & error if block supplied
27217
- # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
27218
- # @yieldparam err [StandardError] error object if request failed
27219
- #
27220
- # @return [Google::Apis::ComputeV1::Operation]
27221
- #
27222
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27223
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27224
- # @raise [Google::Apis::AuthorizationError] Authorization is required
27225
- def set_region_instance_group_named_ports(project, region, instance_group, region_instance_groups_set_named_ports_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27226
- command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts', options)
27227
- command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupsSetNamedPortsRequest::Representation
27228
- command.request_object = region_instance_groups_set_named_ports_request_object
27229
- command.response_representation = Google::Apis::ComputeV1::Operation::Representation
27230
- command.response_class = Google::Apis::ComputeV1::Operation
27231
- command.params['project'] = project unless project.nil?
27232
- command.params['region'] = region unless region.nil?
27233
- command.params['instanceGroup'] = instance_group unless instance_group.nil?
27234
- command.query['requestId'] = request_id unless request_id.nil?
27235
- command.query['fields'] = fields unless fields.nil?
27236
- command.query['quotaUser'] = quota_user unless quota_user.nil?
27237
- command.query['userIp'] = user_ip unless user_ip.nil?
27238
- execute_or_queue_command(command, &block)
27239
- end
27240
-
27241
- # Deletes the specified instance template. Deleting an instance template is
27242
- # permanent and cannot be undone.
27243
- # @param [String] project
27244
- # Project ID for this request.
27245
- # @param [String] region
27246
- # The name of the region for this request.
27247
- # @param [String] instance_template
27248
- # The name of the instance template to delete.
27249
- # @param [String] request_id
27250
- # An optional request ID to identify requests. Specify a unique request ID so
27251
- # that if you must retry your request, the server will know to ignore the
27252
- # request if it has already been completed. For example, consider a situation
27253
- # where you make an initial request and the request times out. If you make the
27254
- # request again with the same request ID, the server can check if original
27255
- # operation with the same request ID was received, and if so, will ignore the
27256
- # second request. This prevents clients from accidentally creating duplicate
27257
- # commitments. The request ID must be a valid UUID with the exception that zero
27258
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27259
- # @param [String] fields
27260
- # Selector specifying which fields to include in a partial response.
27261
- # @param [String] quota_user
27262
- # Available to use for quota purposes for server-side applications. Can be any
27263
- # arbitrary string assigned to a user, but should not exceed 40 characters.
27264
- # @param [String] user_ip
27265
- # Legacy name for parameter that has been superseded by `quotaUser`.
27266
- # @param [Google::Apis::RequestOptions] options
27267
- # Request-specific options
27268
- #
27269
- # @yield [result, err] Result & error if block supplied
27270
- # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
27271
- # @yieldparam err [StandardError] error object if request failed
27272
- #
27273
- # @return [Google::Apis::ComputeV1::Operation]
27274
- #
27275
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27276
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27277
- # @raise [Google::Apis::AuthorizationError] Authorization is required
27278
- def delete_region_instance_template(project, region, instance_template, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27279
- command = make_simple_command(:delete, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
27280
- command.response_representation = Google::Apis::ComputeV1::Operation::Representation
27281
- command.response_class = Google::Apis::ComputeV1::Operation
27282
- command.params['project'] = project unless project.nil?
27283
- command.params['region'] = region unless region.nil?
27284
- command.params['instanceTemplate'] = instance_template unless instance_template.nil?
27285
- command.query['requestId'] = request_id unless request_id.nil?
27286
- command.query['fields'] = fields unless fields.nil?
27287
- command.query['quotaUser'] = quota_user unless quota_user.nil?
27288
- command.query['userIp'] = user_ip unless user_ip.nil?
27289
- execute_or_queue_command(command, &block)
27290
- end
27291
-
27292
- # Returns the specified instance template.
28596
+ # Sets the access control policy on the specified resource. Replaces any
28597
+ # existing policy.
27293
28598
  # @param [String] project
27294
28599
  # Project ID for this request.
27295
28600
  # @param [String] region
27296
28601
  # The name of the region for this request.
27297
- # @param [String] instance_template
27298
- # The name of the instance template.
28602
+ # @param [String] resource
28603
+ # Name or id of the resource for this request.
28604
+ # @param [Google::Apis::ComputeV1::RegionSetPolicyRequest] region_set_policy_request_object
27299
28605
  # @param [String] fields
27300
28606
  # Selector specifying which fields to include in a partial response.
27301
28607
  # @param [String] quota_user
@@ -27307,34 +28613,38 @@ module Google
27307
28613
  # Request-specific options
27308
28614
  #
27309
28615
  # @yield [result, err] Result & error if block supplied
27310
- # @yieldparam result [Google::Apis::ComputeV1::InstanceTemplate] parsed result object
28616
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
27311
28617
  # @yieldparam err [StandardError] error object if request failed
27312
28618
  #
27313
- # @return [Google::Apis::ComputeV1::InstanceTemplate]
28619
+ # @return [Google::Apis::ComputeV1::Policy]
27314
28620
  #
27315
28621
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27316
28622
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27317
28623
  # @raise [Google::Apis::AuthorizationError] Authorization is required
27318
- def get_region_instance_template(project, region, instance_template, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27319
- command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}', options)
27320
- command.response_representation = Google::Apis::ComputeV1::InstanceTemplate::Representation
27321
- command.response_class = Google::Apis::ComputeV1::InstanceTemplate
28624
+ def set_region_instant_snapshot_iam_policy(project, region, resource, region_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28625
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy', options)
28626
+ command.request_representation = Google::Apis::ComputeV1::RegionSetPolicyRequest::Representation
28627
+ command.request_object = region_set_policy_request_object
28628
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
28629
+ command.response_class = Google::Apis::ComputeV1::Policy
27322
28630
  command.params['project'] = project unless project.nil?
27323
28631
  command.params['region'] = region unless region.nil?
27324
- command.params['instanceTemplate'] = instance_template unless instance_template.nil?
28632
+ command.params['resource'] = resource unless resource.nil?
27325
28633
  command.query['fields'] = fields unless fields.nil?
27326
28634
  command.query['quotaUser'] = quota_user unless quota_user.nil?
27327
28635
  command.query['userIp'] = user_ip unless user_ip.nil?
27328
28636
  execute_or_queue_command(command, &block)
27329
28637
  end
27330
28638
 
27331
- # Creates an instance template in the specified project and region using the
27332
- # global instance template whose URL is included in the request.
28639
+ # Sets the labels on a instantSnapshot in the given region. To learn more about
28640
+ # labels, read the Labeling Resources documentation.
27333
28641
  # @param [String] project
27334
28642
  # Project ID for this request.
27335
28643
  # @param [String] region
27336
- # The name of the region for this request.
27337
- # @param [Google::Apis::ComputeV1::InstanceTemplate] instance_template_object
28644
+ # The region for this request.
28645
+ # @param [String] resource
28646
+ # Name or id of the resource for this request.
28647
+ # @param [Google::Apis::ComputeV1::RegionSetLabelsRequest] region_set_labels_request_object
27338
28648
  # @param [String] request_id
27339
28649
  # An optional request ID to identify requests. Specify a unique request ID so
27340
28650
  # that if you must retry your request, the server will know to ignore the
@@ -27364,14 +28674,15 @@ module Google
27364
28674
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27365
28675
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27366
28676
  # @raise [Google::Apis::AuthorizationError] Authorization is required
27367
- 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)
27368
- command = make_simple_command(:post, 'projects/{project}/regions/{region}/instanceTemplates', options)
27369
- command.request_representation = Google::Apis::ComputeV1::InstanceTemplate::Representation
27370
- command.request_object = instance_template_object
28677
+ def set_region_instant_snapshot_labels(project, region, resource, region_set_labels_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28678
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels', options)
28679
+ command.request_representation = Google::Apis::ComputeV1::RegionSetLabelsRequest::Representation
28680
+ command.request_object = region_set_labels_request_object
27371
28681
  command.response_representation = Google::Apis::ComputeV1::Operation::Representation
27372
28682
  command.response_class = Google::Apis::ComputeV1::Operation
27373
28683
  command.params['project'] = project unless project.nil?
27374
28684
  command.params['region'] = region unless region.nil?
28685
+ command.params['resource'] = resource unless resource.nil?
27375
28686
  command.query['requestId'] = request_id unless request_id.nil?
27376
28687
  command.query['fields'] = fields unless fields.nil?
27377
28688
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -27379,116 +28690,14 @@ module Google
27379
28690
  execute_or_queue_command(command, &block)
27380
28691
  end
27381
28692
 
27382
- # Retrieves a list of instance templates that are contained within the specified
27383
- # project and region.
27384
- # @param [String] project
27385
- # Project ID for this request.
27386
- # @param [String] region
27387
- # The name of the regions for this request.
27388
- # @param [String] filter
27389
- # A filter expression that filters resources listed in the response. Most
27390
- # Compute resources support two types of filter expressions: expressions that
27391
- # support regular expressions and expressions that follow API improvement
27392
- # proposal AIP-160. These two types of filter expressions cannot be mixed in one
27393
- # request. If you want to use AIP-160, your expression must specify the field
27394
- # name, an operator, and the value that you want to use for filtering. The value
27395
- # must be a string, a number, or a boolean. The operator must be either `=`, `!=`
27396
- # , `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute
27397
- # Engine instances, you can exclude instances named `example-instance` by
27398
- # specifying `name != example-instance`. The `:*` comparison can be used to test
27399
- # whether a key has been defined. For example, to find all objects with `owner`
27400
- # label use: ``` labels.owner:* ``` You can also filter nested fields. For
27401
- # example, you could specify `scheduling.automaticRestart = false` to include
27402
- # instances only if they are not scheduled for automatic restarts. You can use
27403
- # filtering on nested fields to filter based on resource labels. To filter on
27404
- # multiple expressions, provide each separate expression within parentheses. For
27405
- # example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel
27406
- # Skylake") ``` By default, each expression is an `AND` expression. However, you
27407
- # can include `AND` and `OR` expressions explicitly. For example: ``` (
27408
- # cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (
27409
- # scheduling.automaticRestart = true) ``` If you want to use a regular
27410
- # expression, use the `eq` (equal) or `ne` (not equal) operator against a single
27411
- # un-parenthesized expression with or without quotes or against multiple
27412
- # parenthesized expressions. Examples: `fieldname eq unquoted literal` `
27413
- # fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(
27414
- # fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is
27415
- # interpreted as a regular expression using Google RE2 library syntax. The
27416
- # literal value must match the entire field. For example, to filter for
27417
- # instances that do not end with name "instance", you would use `name ne .*
27418
- # instance`. You cannot combine constraints on multiple fields using regular
27419
- # expressions.
27420
- # @param [Fixnum] max_results
27421
- # The maximum number of results per page that should be returned. If the number
27422
- # of available results is larger than `maxResults`, Compute Engine returns a `
27423
- # nextPageToken` that can be used to get the next page of results in subsequent
27424
- # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
27425
- # @param [String] order_by
27426
- # Sorts list results by a certain order. By default, results are returned in
27427
- # alphanumerical order based on the resource name. You can also sort results in
27428
- # descending order based on the creation timestamp using `orderBy="
27429
- # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
27430
- # field in reverse chronological order (newest result first). Use this to sort
27431
- # resources like operations so that the newest operation is returned first.
27432
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
27433
- # @param [String] page_token
27434
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
27435
- # by a previous list request to get the next page of results.
27436
- # @param [Boolean] return_partial_success
27437
- # Opt-in for partial success behavior which provides partial results in case of
27438
- # failure. The default value is false.
27439
- # @param [String] fields
27440
- # Selector specifying which fields to include in a partial response.
27441
- # @param [String] quota_user
27442
- # Available to use for quota purposes for server-side applications. Can be any
27443
- # arbitrary string assigned to a user, but should not exceed 40 characters.
27444
- # @param [String] user_ip
27445
- # Legacy name for parameter that has been superseded by `quotaUser`.
27446
- # @param [Google::Apis::RequestOptions] options
27447
- # Request-specific options
27448
- #
27449
- # @yield [result, err] Result & error if block supplied
27450
- # @yieldparam result [Google::Apis::ComputeV1::InstanceTemplateList] parsed result object
27451
- # @yieldparam err [StandardError] error object if request failed
27452
- #
27453
- # @return [Google::Apis::ComputeV1::InstanceTemplateList]
27454
- #
27455
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27456
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27457
- # @raise [Google::Apis::AuthorizationError] Authorization is required
27458
- 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)
27459
- command = make_simple_command(:get, 'projects/{project}/regions/{region}/instanceTemplates', options)
27460
- command.response_representation = Google::Apis::ComputeV1::InstanceTemplateList::Representation
27461
- command.response_class = Google::Apis::ComputeV1::InstanceTemplateList
27462
- command.params['project'] = project unless project.nil?
27463
- command.params['region'] = region unless region.nil?
27464
- command.query['filter'] = filter unless filter.nil?
27465
- command.query['maxResults'] = max_results unless max_results.nil?
27466
- command.query['orderBy'] = order_by unless order_by.nil?
27467
- command.query['pageToken'] = page_token unless page_token.nil?
27468
- command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
27469
- command.query['fields'] = fields unless fields.nil?
27470
- command.query['quotaUser'] = quota_user unless quota_user.nil?
27471
- command.query['userIp'] = user_ip unless user_ip.nil?
27472
- execute_or_queue_command(command, &block)
27473
- end
27474
-
27475
- # Creates multiple instances in a given region. Count specifies the number of
27476
- # instances to create.
28693
+ # Returns permissions that a caller has on the specified resource.
27477
28694
  # @param [String] project
27478
28695
  # Project ID for this request.
27479
28696
  # @param [String] region
27480
28697
  # The name of the region for this request.
27481
- # @param [Google::Apis::ComputeV1::BulkInsertInstanceResource] bulk_insert_instance_resource_object
27482
- # @param [String] request_id
27483
- # An optional request ID to identify requests. Specify a unique request ID so
27484
- # that if you must retry your request, the server will know to ignore the
27485
- # request if it has already been completed. For example, consider a situation
27486
- # where you make an initial request and the request times out. If you make the
27487
- # request again with the same request ID, the server can check if original
27488
- # operation with the same request ID was received, and if so, will ignore the
27489
- # second request. This prevents clients from accidentally creating duplicate
27490
- # commitments. The request ID must be a valid UUID with the exception that zero
27491
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28698
+ # @param [String] resource
28699
+ # Name or id of the resource for this request.
28700
+ # @param [Google::Apis::ComputeV1::TestPermissionsRequest] test_permissions_request_object
27492
28701
  # @param [String] fields
27493
28702
  # Selector specifying which fields to include in a partial response.
27494
28703
  # @param [String] quota_user
@@ -27500,23 +28709,23 @@ module Google
27500
28709
  # Request-specific options
27501
28710
  #
27502
28711
  # @yield [result, err] Result & error if block supplied
27503
- # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
28712
+ # @yieldparam result [Google::Apis::ComputeV1::TestPermissionsResponse] parsed result object
27504
28713
  # @yieldparam err [StandardError] error object if request failed
27505
28714
  #
27506
- # @return [Google::Apis::ComputeV1::Operation]
28715
+ # @return [Google::Apis::ComputeV1::TestPermissionsResponse]
27507
28716
  #
27508
28717
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
27509
28718
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
27510
28719
  # @raise [Google::Apis::AuthorizationError] Authorization is required
27511
- def bulk_region_instance_insert(project, region, bulk_insert_instance_resource_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
27512
- command = make_simple_command(:post, 'projects/{project}/regions/{region}/instances/bulkInsert', options)
27513
- command.request_representation = Google::Apis::ComputeV1::BulkInsertInstanceResource::Representation
27514
- command.request_object = bulk_insert_instance_resource_object
27515
- command.response_representation = Google::Apis::ComputeV1::Operation::Representation
27516
- command.response_class = Google::Apis::ComputeV1::Operation
28720
+ def test_region_instant_snapshot_iam_permissions(project, region, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
28721
+ command = make_simple_command(:post, 'projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions', options)
28722
+ command.request_representation = Google::Apis::ComputeV1::TestPermissionsRequest::Representation
28723
+ command.request_object = test_permissions_request_object
28724
+ command.response_representation = Google::Apis::ComputeV1::TestPermissionsResponse::Representation
28725
+ command.response_class = Google::Apis::ComputeV1::TestPermissionsResponse
27517
28726
  command.params['project'] = project unless project.nil?
27518
28727
  command.params['region'] = region unless region.nil?
27519
- command.query['requestId'] = request_id unless request_id.nil?
28728
+ command.params['resource'] = resource unless resource.nil?
27520
28729
  command.query['fields'] = fields unless fields.nil?
27521
28730
  command.query['quotaUser'] = quota_user unless quota_user.nil?
27522
28731
  command.query['userIp'] = user_ip unless user_ip.nil?
@@ -27836,7 +29045,9 @@ module Google
27836
29045
  # by a previous list request to get the next page of results.
27837
29046
  # @param [Boolean] return_partial_success
27838
29047
  # Opt-in for partial success behavior which provides partial results in case of
27839
- # failure. The default value is false.
29048
+ # failure. The default value is false. For example, when partial success
29049
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
29050
+ # resources in the zone or no resources, with an error code.
27840
29051
  # @param [String] fields
27841
29052
  # Selector specifying which fields to include in a partial response.
27842
29053
  # @param [String] quota_user
@@ -27932,7 +29143,9 @@ module Google
27932
29143
  # by a previous list request to get the next page of results.
27933
29144
  # @param [Boolean] return_partial_success
27934
29145
  # Opt-in for partial success behavior which provides partial results in case of
27935
- # failure. The default value is false.
29146
+ # failure. The default value is false. For example, when partial success
29147
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
29148
+ # resources in the zone or no resources, with an error code.
27936
29149
  # @param [String] fields
27937
29150
  # Selector specifying which fields to include in a partial response.
27938
29151
  # @param [String] quota_user
@@ -28503,7 +29716,9 @@ module Google
28503
29716
  # by a previous list request to get the next page of results.
28504
29717
  # @param [Boolean] return_partial_success
28505
29718
  # Opt-in for partial success behavior which provides partial results in case of
28506
- # failure. The default value is false.
29719
+ # failure. The default value is false. For example, when partial success
29720
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
29721
+ # resources in the zone or no resources, with an error code.
28507
29722
  # @param [String] fields
28508
29723
  # Selector specifying which fields to include in a partial response.
28509
29724
  # @param [String] quota_user
@@ -29035,7 +30250,9 @@ module Google
29035
30250
  # by a previous list request to get the next page of results.
29036
30251
  # @param [Boolean] return_partial_success
29037
30252
  # Opt-in for partial success behavior which provides partial results in case of
29038
- # failure. The default value is false.
30253
+ # failure. The default value is false. For example, when partial success
30254
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
30255
+ # resources in the zone or no resources, with an error code.
29039
30256
  # @param [String] fields
29040
30257
  # Selector specifying which fields to include in a partial response.
29041
30258
  # @param [String] quota_user
@@ -29203,7 +30420,9 @@ module Google
29203
30420
  # by a previous list request to get the next page of results.
29204
30421
  # @param [Boolean] return_partial_success
29205
30422
  # Opt-in for partial success behavior which provides partial results in case of
29206
- # failure. The default value is false.
30423
+ # failure. The default value is false. For example, when partial success
30424
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
30425
+ # resources in the zone or no resources, with an error code.
29207
30426
  # @param [String] fields
29208
30427
  # Selector specifying which fields to include in a partial response.
29209
30428
  # @param [String] quota_user
@@ -29574,7 +30793,9 @@ module Google
29574
30793
  # by a previous list request to get the next page of results.
29575
30794
  # @param [Boolean] return_partial_success
29576
30795
  # Opt-in for partial success behavior which provides partial results in case of
29577
- # failure. The default value is false.
30796
+ # failure. The default value is false. For example, when partial success
30797
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
30798
+ # resources in the zone or no resources, with an error code.
29578
30799
  # @param [String] fields
29579
30800
  # Selector specifying which fields to include in a partial response.
29580
30801
  # @param [String] quota_user
@@ -29961,7 +31182,9 @@ module Google
29961
31182
  # by a previous list request to get the next page of results.
29962
31183
  # @param [Boolean] return_partial_success
29963
31184
  # Opt-in for partial success behavior which provides partial results in case of
29964
- # failure. The default value is false.
31185
+ # failure. The default value is false. For example, when partial success
31186
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
31187
+ # resources in the zone or no resources, with an error code.
29965
31188
  # @param [String] fields
29966
31189
  # Selector specifying which fields to include in a partial response.
29967
31190
  # @param [String] quota_user
@@ -30197,7 +31420,9 @@ module Google
30197
31420
  # by a previous list request to get the next page of results.
30198
31421
  # @param [Boolean] return_partial_success
30199
31422
  # Opt-in for partial success behavior which provides partial results in case of
30200
- # failure. The default value is false.
31423
+ # failure. The default value is false. For example, when partial success
31424
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
31425
+ # resources in the zone or no resources, with an error code.
30201
31426
  # @param [String] fields
30202
31427
  # Selector specifying which fields to include in a partial response.
30203
31428
  # @param [String] quota_user
@@ -30290,7 +31515,9 @@ module Google
30290
31515
  # by a previous list request to get the next page of results.
30291
31516
  # @param [Boolean] return_partial_success
30292
31517
  # Opt-in for partial success behavior which provides partial results in case of
30293
- # failure. The default value is false.
31518
+ # failure. The default value is false. For example, when partial success
31519
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
31520
+ # resources in the zone or no resources, with an error code.
30294
31521
  # @param [String] fields
30295
31522
  # Selector specifying which fields to include in a partial response.
30296
31523
  # @param [String] quota_user
@@ -30577,7 +31804,9 @@ module Google
30577
31804
  # by a previous list request to get the next page of results.
30578
31805
  # @param [Boolean] return_partial_success
30579
31806
  # Opt-in for partial success behavior which provides partial results in case of
30580
- # failure. The default value is false.
31807
+ # failure. The default value is false. For example, when partial success
31808
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
31809
+ # resources in the zone or no resources, with an error code.
30581
31810
  # @param [String] fields
30582
31811
  # Selector specifying which fields to include in a partial response.
30583
31812
  # @param [String] quota_user
@@ -30863,7 +32092,9 @@ module Google
30863
32092
  # by a previous list request to get the next page of results.
30864
32093
  # @param [Boolean] return_partial_success
30865
32094
  # Opt-in for partial success behavior which provides partial results in case of
30866
- # failure. The default value is false.
32095
+ # failure. The default value is false. For example, when partial success
32096
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
32097
+ # resources in the zone or no resources, with an error code.
30867
32098
  # @param [String] fields
30868
32099
  # Selector specifying which fields to include in a partial response.
30869
32100
  # @param [String] quota_user
@@ -31257,7 +32488,9 @@ module Google
31257
32488
  # by a previous list request to get the next page of results.
31258
32489
  # @param [Boolean] return_partial_success
31259
32490
  # Opt-in for partial success behavior which provides partial results in case of
31260
- # failure. The default value is false.
32491
+ # failure. The default value is false. For example, when partial success
32492
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
32493
+ # resources in the zone or no resources, with an error code.
31261
32494
  # @param [String] fields
31262
32495
  # Selector specifying which fields to include in a partial response.
31263
32496
  # @param [String] quota_user
@@ -31474,7 +32707,9 @@ module Google
31474
32707
  # by a previous list request to get the next page of results.
31475
32708
  # @param [Boolean] return_partial_success
31476
32709
  # Opt-in for partial success behavior which provides partial results in case of
31477
- # failure. The default value is false.
32710
+ # failure. The default value is false. For example, when partial success
32711
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
32712
+ # resources in the zone or no resources, with an error code.
31478
32713
  # @param [String] fields
31479
32714
  # Selector specifying which fields to include in a partial response.
31480
32715
  # @param [String] quota_user
@@ -31702,7 +32937,9 @@ module Google
31702
32937
  # by a previous list request to get the next page of results.
31703
32938
  # @param [Boolean] return_partial_success
31704
32939
  # Opt-in for partial success behavior which provides partial results in case of
31705
- # failure. The default value is false.
32940
+ # failure. The default value is false. For example, when partial success
32941
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
32942
+ # resources in the zone or no resources, with an error code.
31706
32943
  # @param [String] fields
31707
32944
  # Selector specifying which fields to include in a partial response.
31708
32945
  # @param [String] quota_user
@@ -31841,7 +33078,9 @@ module Google
31841
33078
  # by a previous list request to get the next page of results.
31842
33079
  # @param [Boolean] return_partial_success
31843
33080
  # Opt-in for partial success behavior which provides partial results in case of
31844
- # failure. The default value is false.
33081
+ # failure. The default value is false. For example, when partial success
33082
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
33083
+ # resources in the zone or no resources, with an error code.
31845
33084
  # @param [String] fields
31846
33085
  # Selector specifying which fields to include in a partial response.
31847
33086
  # @param [String] quota_user
@@ -31877,7 +33116,8 @@ module Google
31877
33116
  execute_or_queue_command(command, &block)
31878
33117
  end
31879
33118
 
31880
- # Retrieves an aggregated list of reservations.
33119
+ # Retrieves an aggregated list of reservations. To prevent failure, Google
33120
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
31881
33121
  # @param [String] project
31882
33122
  # Project ID for this request.
31883
33123
  # @param [String] filter
@@ -31937,7 +33177,9 @@ module Google
31937
33177
  # by a previous list request to get the next page of results.
31938
33178
  # @param [Boolean] return_partial_success
31939
33179
  # Opt-in for partial success behavior which provides partial results in case of
31940
- # failure. The default value is false.
33180
+ # failure. The default value is false. For example, when partial success
33181
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
33182
+ # resources in the zone or no resources, with an error code.
31941
33183
  # @param [Fixnum] service_project_number
31942
33184
  # The Shared VPC service project id or service project number for which
31943
33185
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -32217,7 +33459,9 @@ module Google
32217
33459
  # by a previous list request to get the next page of results.
32218
33460
  # @param [Boolean] return_partial_success
32219
33461
  # Opt-in for partial success behavior which provides partial results in case of
32220
- # failure. The default value is false.
33462
+ # failure. The default value is false. For example, when partial success
33463
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
33464
+ # resources in the zone or no resources, with an error code.
32221
33465
  # @param [String] fields
32222
33466
  # Selector specifying which fields to include in a partial response.
32223
33467
  # @param [String] quota_user
@@ -32451,7 +33695,8 @@ module Google
32451
33695
  execute_or_queue_command(command, &block)
32452
33696
  end
32453
33697
 
32454
- # Retrieves an aggregated list of resource policies.
33698
+ # Retrieves an aggregated list of resource policies. To prevent failure, Google
33699
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
32455
33700
  # @param [String] project
32456
33701
  # Project ID for this request.
32457
33702
  # @param [String] filter
@@ -32511,7 +33756,9 @@ module Google
32511
33756
  # by a previous list request to get the next page of results.
32512
33757
  # @param [Boolean] return_partial_success
32513
33758
  # Opt-in for partial success behavior which provides partial results in case of
32514
- # failure. The default value is false.
33759
+ # failure. The default value is false. For example, when partial success
33760
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
33761
+ # resources in the zone or no resources, with an error code.
32515
33762
  # @param [Fixnum] service_project_number
32516
33763
  # The Shared VPC service project id or service project number for which
32517
33764
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -32790,7 +34037,9 @@ module Google
32790
34037
  # by a previous list request to get the next page of results.
32791
34038
  # @param [Boolean] return_partial_success
32792
34039
  # Opt-in for partial success behavior which provides partial results in case of
32793
- # failure. The default value is false.
34040
+ # failure. The default value is false. For example, when partial success
34041
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
34042
+ # resources in the zone or no resources, with an error code.
32794
34043
  # @param [String] fields
32795
34044
  # Selector specifying which fields to include in a partial response.
32796
34045
  # @param [String] quota_user
@@ -32968,7 +34217,8 @@ module Google
32968
34217
  execute_or_queue_command(command, &block)
32969
34218
  end
32970
34219
 
32971
- # Retrieves an aggregated list of routers.
34220
+ # Retrieves an aggregated list of routers. To prevent failure, Google recommends
34221
+ # that you set the `returnPartialSuccess` parameter to `true`.
32972
34222
  # @param [String] project
32973
34223
  # Project ID for this request.
32974
34224
  # @param [String] filter
@@ -33028,7 +34278,9 @@ module Google
33028
34278
  # by a previous list request to get the next page of results.
33029
34279
  # @param [Boolean] return_partial_success
33030
34280
  # Opt-in for partial success behavior which provides partial results in case of
33031
- # failure. The default value is false.
34281
+ # failure. The default value is false. For example, when partial success
34282
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
34283
+ # resources in the zone or no resources, with an error code.
33032
34284
  # @param [Fixnum] service_project_number
33033
34285
  # The Shared VPC service project id or service project number for which
33034
34286
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -33264,7 +34516,9 @@ module Google
33264
34516
  # by a previous list request to get the next page of results.
33265
34517
  # @param [Boolean] return_partial_success
33266
34518
  # Opt-in for partial success behavior which provides partial results in case of
33267
- # failure. The default value is false.
34519
+ # failure. The default value is false. For example, when partial success
34520
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
34521
+ # resources in the zone or no resources, with an error code.
33268
34522
  # @param [String] fields
33269
34523
  # Selector specifying which fields to include in a partial response.
33270
34524
  # @param [String] quota_user
@@ -33448,7 +34702,9 @@ module Google
33448
34702
  # by a previous list request to get the next page of results.
33449
34703
  # @param [Boolean] return_partial_success
33450
34704
  # Opt-in for partial success behavior which provides partial results in case of
33451
- # failure. The default value is false.
34705
+ # failure. The default value is false. For example, when partial success
34706
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
34707
+ # resources in the zone or no resources, with an error code.
33452
34708
  # @param [String] fields
33453
34709
  # Selector specifying which fields to include in a partial response.
33454
34710
  # @param [String] quota_user
@@ -33823,7 +35079,9 @@ module Google
33823
35079
  # by a previous list request to get the next page of results.
33824
35080
  # @param [Boolean] return_partial_success
33825
35081
  # Opt-in for partial success behavior which provides partial results in case of
33826
- # failure. The default value is false.
35082
+ # failure. The default value is false. For example, when partial success
35083
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
35084
+ # resources in the zone or no resources, with an error code.
33827
35085
  # @param [String] fields
33828
35086
  # Selector specifying which fields to include in a partial response.
33829
35087
  # @param [String] quota_user
@@ -33902,7 +35160,8 @@ module Google
33902
35160
  end
33903
35161
 
33904
35162
  # Retrieves the list of all SecurityPolicy resources, regional and global,
33905
- # available to the specified project.
35163
+ # available to the specified project. To prevent failure, Google recommends that
35164
+ # you set the `returnPartialSuccess` parameter to `true`.
33906
35165
  # @param [String] project
33907
35166
  # Name of the project scoping this request.
33908
35167
  # @param [String] filter
@@ -33962,7 +35221,9 @@ module Google
33962
35221
  # by a previous list request to get the next page of results.
33963
35222
  # @param [Boolean] return_partial_success
33964
35223
  # Opt-in for partial success behavior which provides partial results in case of
33965
- # failure. The default value is false.
35224
+ # failure. The default value is false. For example, when partial success
35225
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
35226
+ # resources in the zone or no resources, with an error code.
33966
35227
  # @param [Fixnum] service_project_number
33967
35228
  # The Shared VPC service project id or service project number for which
33968
35229
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -34229,7 +35490,9 @@ module Google
34229
35490
  # by a previous list request to get the next page of results.
34230
35491
  # @param [Boolean] return_partial_success
34231
35492
  # Opt-in for partial success behavior which provides partial results in case of
34232
- # failure. The default value is false.
35493
+ # failure. The default value is false. For example, when partial success
35494
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
35495
+ # resources in the zone or no resources, with an error code.
34233
35496
  # @param [String] fields
34234
35497
  # Selector specifying which fields to include in a partial response.
34235
35498
  # @param [String] quota_user
@@ -34319,7 +35582,9 @@ module Google
34319
35582
  # by a previous list request to get the next page of results.
34320
35583
  # @param [Boolean] return_partial_success
34321
35584
  # Opt-in for partial success behavior which provides partial results in case of
34322
- # failure. The default value is false.
35585
+ # failure. The default value is false. For example, when partial success
35586
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
35587
+ # resources in the zone or no resources, with an error code.
34323
35588
  # @param [String] fields
34324
35589
  # Selector specifying which fields to include in a partial response.
34325
35590
  # @param [String] quota_user
@@ -34540,7 +35805,8 @@ module Google
34540
35805
  end
34541
35806
 
34542
35807
  # Retrieves the list of all ServiceAttachment resources, regional and global,
34543
- # available to the specified project.
35808
+ # available to the specified project. To prevent failure, Google recommends that
35809
+ # you set the `returnPartialSuccess` parameter to `true`.
34544
35810
  # @param [String] project
34545
35811
  # Name of the project scoping this request.
34546
35812
  # @param [String] filter
@@ -34600,7 +35866,9 @@ module Google
34600
35866
  # by a previous list request to get the next page of results.
34601
35867
  # @param [Boolean] return_partial_success
34602
35868
  # Opt-in for partial success behavior which provides partial results in case of
34603
- # failure. The default value is false.
35869
+ # failure. The default value is false. For example, when partial success
35870
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
35871
+ # resources in the zone or no resources, with an error code.
34604
35872
  # @param [Fixnum] service_project_number
34605
35873
  # The Shared VPC service project id or service project number for which
34606
35874
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -34879,7 +36147,9 @@ module Google
34879
36147
  # by a previous list request to get the next page of results.
34880
36148
  # @param [Boolean] return_partial_success
34881
36149
  # Opt-in for partial success behavior which provides partial results in case of
34882
- # failure. The default value is false.
36150
+ # failure. The default value is false. For example, when partial success
36151
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
36152
+ # resources in the zone or no resources, with an error code.
34883
36153
  # @param [String] fields
34884
36154
  # Selector specifying which fields to include in a partial response.
34885
36155
  # @param [String] quota_user
@@ -35371,7 +36641,9 @@ module Google
35371
36641
  # by a previous list request to get the next page of results.
35372
36642
  # @param [Boolean] return_partial_success
35373
36643
  # Opt-in for partial success behavior which provides partial results in case of
35374
- # failure. The default value is false.
36644
+ # failure. The default value is false. For example, when partial success
36645
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
36646
+ # resources in the zone or no resources, with an error code.
35375
36647
  # @param [String] fields
35376
36648
  # Selector specifying which fields to include in a partial response.
35377
36649
  # @param [String] quota_user
@@ -35527,7 +36799,8 @@ module Google
35527
36799
  end
35528
36800
 
35529
36801
  # Retrieves the list of all SslCertificate resources, regional and global,
35530
- # available to the specified project.
36802
+ # available to the specified project. To prevent failure, Google recommends that
36803
+ # you set the `returnPartialSuccess` parameter to `true`.
35531
36804
  # @param [String] project
35532
36805
  # Name of the project scoping this request.
35533
36806
  # @param [String] filter
@@ -35587,7 +36860,9 @@ module Google
35587
36860
  # by a previous list request to get the next page of results.
35588
36861
  # @param [Boolean] return_partial_success
35589
36862
  # Opt-in for partial success behavior which provides partial results in case of
35590
- # failure. The default value is false.
36863
+ # failure. The default value is false. For example, when partial success
36864
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
36865
+ # resources in the zone or no resources, with an error code.
35591
36866
  # @param [Fixnum] service_project_number
35592
36867
  # The Shared VPC service project id or service project number for which
35593
36868
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -35813,7 +37088,9 @@ module Google
35813
37088
  # by a previous list request to get the next page of results.
35814
37089
  # @param [Boolean] return_partial_success
35815
37090
  # Opt-in for partial success behavior which provides partial results in case of
35816
- # failure. The default value is false.
37091
+ # failure. The default value is false. For example, when partial success
37092
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37093
+ # resources in the zone or no resources, with an error code.
35817
37094
  # @param [String] fields
35818
37095
  # Selector specifying which fields to include in a partial response.
35819
37096
  # @param [String] quota_user
@@ -35850,7 +37127,8 @@ module Google
35850
37127
  end
35851
37128
 
35852
37129
  # Retrieves the list of all SslPolicy resources, regional and global, available
35853
- # to the specified project.
37130
+ # to the specified project. To prevent failure, Google recommends that you set
37131
+ # the `returnPartialSuccess` parameter to `true`.
35854
37132
  # @param [String] project
35855
37133
  # Name of the project scoping this request.
35856
37134
  # @param [String] filter
@@ -35910,7 +37188,9 @@ module Google
35910
37188
  # by a previous list request to get the next page of results.
35911
37189
  # @param [Boolean] return_partial_success
35912
37190
  # Opt-in for partial success behavior which provides partial results in case of
35913
- # failure. The default value is false.
37191
+ # failure. The default value is false. For example, when partial success
37192
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37193
+ # resources in the zone or no resources, with an error code.
35914
37194
  # @param [Fixnum] service_project_number
35915
37195
  # The Shared VPC service project id or service project number for which
35916
37196
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -36137,7 +37417,9 @@ module Google
36137
37417
  # by a previous list request to get the next page of results.
36138
37418
  # @param [Boolean] return_partial_success
36139
37419
  # Opt-in for partial success behavior which provides partial results in case of
36140
- # failure. The default value is false.
37420
+ # failure. The default value is false. For example, when partial success
37421
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37422
+ # resources in the zone or no resources, with an error code.
36141
37423
  # @param [String] fields
36142
37424
  # Selector specifying which fields to include in a partial response.
36143
37425
  # @param [String] quota_user
@@ -36227,7 +37509,9 @@ module Google
36227
37509
  # by a previous list request to get the next page of results.
36228
37510
  # @param [Boolean] return_partial_success
36229
37511
  # Opt-in for partial success behavior which provides partial results in case of
36230
- # failure. The default value is false.
37512
+ # failure. The default value is false. For example, when partial success
37513
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37514
+ # resources in the zone or no resources, with an error code.
36231
37515
  # @param [String] fields
36232
37516
  # Selector specifying which fields to include in a partial response.
36233
37517
  # @param [String] quota_user
@@ -36314,7 +37598,8 @@ module Google
36314
37598
  execute_or_queue_command(command, &block)
36315
37599
  end
36316
37600
 
36317
- # Retrieves an aggregated list of subnetworks.
37601
+ # Retrieves an aggregated list of subnetworks. To prevent failure, Google
37602
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
36318
37603
  # @param [String] project
36319
37604
  # Project ID for this request.
36320
37605
  # @param [String] filter
@@ -36374,7 +37659,9 @@ module Google
36374
37659
  # by a previous list request to get the next page of results.
36375
37660
  # @param [Boolean] return_partial_success
36376
37661
  # Opt-in for partial success behavior which provides partial results in case of
36377
- # failure. The default value is false.
37662
+ # failure. The default value is false. For example, when partial success
37663
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37664
+ # resources in the zone or no resources, with an error code.
36378
37665
  # @param [Fixnum] service_project_number
36379
37666
  # The Shared VPC service project id or service project number for which
36380
37667
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -36706,7 +37993,9 @@ module Google
36706
37993
  # by a previous list request to get the next page of results.
36707
37994
  # @param [Boolean] return_partial_success
36708
37995
  # Opt-in for partial success behavior which provides partial results in case of
36709
- # failure. The default value is false.
37996
+ # failure. The default value is false. For example, when partial success
37997
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
37998
+ # resources in the zone or no resources, with an error code.
36710
37999
  # @param [String] fields
36711
38000
  # Selector specifying which fields to include in a partial response.
36712
38001
  # @param [String] quota_user
@@ -36796,7 +38085,9 @@ module Google
36796
38085
  # by a previous list request to get the next page of results.
36797
38086
  # @param [Boolean] return_partial_success
36798
38087
  # Opt-in for partial success behavior which provides partial results in case of
36799
- # failure. The default value is false.
38088
+ # failure. The default value is false. For example, when partial success
38089
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
38090
+ # resources in the zone or no resources, with an error code.
36800
38091
  # @param [String] fields
36801
38092
  # Selector specifying which fields to include in a partial response.
36802
38093
  # @param [String] quota_user
@@ -37220,7 +38511,9 @@ module Google
37220
38511
  # by a previous list request to get the next page of results.
37221
38512
  # @param [Boolean] return_partial_success
37222
38513
  # Opt-in for partial success behavior which provides partial results in case of
37223
- # failure. The default value is false.
38514
+ # failure. The default value is false. For example, when partial success
38515
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
38516
+ # resources in the zone or no resources, with an error code.
37224
38517
  # @param [String] fields
37225
38518
  # Selector specifying which fields to include in a partial response.
37226
38519
  # @param [String] quota_user
@@ -37309,7 +38602,8 @@ module Google
37309
38602
  end
37310
38603
 
37311
38604
  # Retrieves the list of all TargetHttpProxy resources, regional and global,
37312
- # available to the specified project.
38605
+ # available to the specified project. To prevent failure, Google recommends that
38606
+ # you set the `returnPartialSuccess` parameter to `true`.
37313
38607
  # @param [String] project
37314
38608
  # Name of the project scoping this request.
37315
38609
  # @param [String] filter
@@ -37369,7 +38663,9 @@ module Google
37369
38663
  # by a previous list request to get the next page of results.
37370
38664
  # @param [Boolean] return_partial_success
37371
38665
  # Opt-in for partial success behavior which provides partial results in case of
37372
- # failure. The default value is false.
38666
+ # failure. The default value is false. For example, when partial success
38667
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
38668
+ # resources in the zone or no resources, with an error code.
37373
38669
  # @param [Fixnum] service_project_number
37374
38670
  # The Shared VPC service project id or service project number for which
37375
38671
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -37595,7 +38891,9 @@ module Google
37595
38891
  # by a previous list request to get the next page of results.
37596
38892
  # @param [Boolean] return_partial_success
37597
38893
  # Opt-in for partial success behavior which provides partial results in case of
37598
- # failure. The default value is false.
38894
+ # failure. The default value is false. For example, when partial success
38895
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
38896
+ # resources in the zone or no resources, with an error code.
37599
38897
  # @param [String] fields
37600
38898
  # Selector specifying which fields to include in a partial response.
37601
38899
  # @param [String] quota_user
@@ -37734,7 +39032,8 @@ module Google
37734
39032
  end
37735
39033
 
37736
39034
  # Retrieves the list of all TargetHttpsProxy resources, regional and global,
37737
- # available to the specified project.
39035
+ # available to the specified project. To prevent failure, Google recommends that
39036
+ # you set the `returnPartialSuccess` parameter to `true`.
37738
39037
  # @param [String] project
37739
39038
  # Name of the project scoping this request.
37740
39039
  # @param [String] filter
@@ -37794,7 +39093,9 @@ module Google
37794
39093
  # by a previous list request to get the next page of results.
37795
39094
  # @param [Boolean] return_partial_success
37796
39095
  # Opt-in for partial success behavior which provides partial results in case of
37797
- # failure. The default value is false.
39096
+ # failure. The default value is false. For example, when partial success
39097
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
39098
+ # resources in the zone or no resources, with an error code.
37798
39099
  # @param [Fixnum] service_project_number
37799
39100
  # The Shared VPC service project id or service project number for which
37800
39101
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -38020,7 +39321,9 @@ module Google
38020
39321
  # by a previous list request to get the next page of results.
38021
39322
  # @param [Boolean] return_partial_success
38022
39323
  # Opt-in for partial success behavior which provides partial results in case of
38023
- # failure. The default value is false.
39324
+ # failure. The default value is false. For example, when partial success
39325
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
39326
+ # resources in the zone or no resources, with an error code.
38024
39327
  # @param [String] fields
38025
39328
  # Selector specifying which fields to include in a partial response.
38026
39329
  # @param [String] quota_user
@@ -38364,7 +39667,8 @@ module Google
38364
39667
  execute_or_queue_command(command, &block)
38365
39668
  end
38366
39669
 
38367
- # Retrieves an aggregated list of target instances.
39670
+ # Retrieves an aggregated list of target instances. To prevent failure, Google
39671
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
38368
39672
  # @param [String] project
38369
39673
  # Project ID for this request.
38370
39674
  # @param [String] filter
@@ -38424,7 +39728,9 @@ module Google
38424
39728
  # by a previous list request to get the next page of results.
38425
39729
  # @param [Boolean] return_partial_success
38426
39730
  # Opt-in for partial success behavior which provides partial results in case of
38427
- # failure. The default value is false.
39731
+ # failure. The default value is false. For example, when partial success
39732
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
39733
+ # resources in the zone or no resources, with an error code.
38428
39734
  # @param [Fixnum] service_project_number
38429
39735
  # The Shared VPC service project id or service project number for which
38430
39736
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -38661,7 +39967,9 @@ module Google
38661
39967
  # by a previous list request to get the next page of results.
38662
39968
  # @param [Boolean] return_partial_success
38663
39969
  # Opt-in for partial success behavior which provides partial results in case of
38664
- # failure. The default value is false.
39970
+ # failure. The default value is false. For example, when partial success
39971
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
39972
+ # resources in the zone or no resources, with an error code.
38665
39973
  # @param [String] fields
38666
39974
  # Selector specifying which fields to include in a partial response.
38667
39975
  # @param [String] quota_user
@@ -38859,7 +40167,8 @@ module Google
38859
40167
  execute_or_queue_command(command, &block)
38860
40168
  end
38861
40169
 
38862
- # Retrieves an aggregated list of target pools.
40170
+ # Retrieves an aggregated list of target pools. To prevent failure, Google
40171
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
38863
40172
  # @param [String] project
38864
40173
  # Project ID for this request.
38865
40174
  # @param [String] filter
@@ -38919,7 +40228,9 @@ module Google
38919
40228
  # by a previous list request to get the next page of results.
38920
40229
  # @param [Boolean] return_partial_success
38921
40230
  # Opt-in for partial success behavior which provides partial results in case of
38922
- # failure. The default value is false.
40231
+ # failure. The default value is false. For example, when partial success
40232
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
40233
+ # resources in the zone or no resources, with an error code.
38923
40234
  # @param [Fixnum] service_project_number
38924
40235
  # The Shared VPC service project id or service project number for which
38925
40236
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -39198,7 +40509,9 @@ module Google
39198
40509
  # by a previous list request to get the next page of results.
39199
40510
  # @param [Boolean] return_partial_success
39200
40511
  # Opt-in for partial success behavior which provides partial results in case of
39201
- # failure. The default value is false.
40512
+ # failure. The default value is false. For example, when partial success
40513
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
40514
+ # resources in the zone or no resources, with an error code.
39202
40515
  # @param [String] fields
39203
40516
  # Selector specifying which fields to include in a partial response.
39204
40517
  # @param [String] quota_user
@@ -39637,7 +40950,9 @@ module Google
39637
40950
  # by a previous list request to get the next page of results.
39638
40951
  # @param [Boolean] return_partial_success
39639
40952
  # Opt-in for partial success behavior which provides partial results in case of
39640
- # failure. The default value is false.
40953
+ # failure. The default value is false. For example, when partial success
40954
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
40955
+ # resources in the zone or no resources, with an error code.
39641
40956
  # @param [String] fields
39642
40957
  # Selector specifying which fields to include in a partial response.
39643
40958
  # @param [String] quota_user
@@ -39929,7 +41244,8 @@ module Google
39929
41244
  end
39930
41245
 
39931
41246
  # Retrieves the list of all TargetTcpProxy resources, regional and global,
39932
- # available to the specified project.
41247
+ # available to the specified project. To prevent failure, Google recommends that
41248
+ # you set the `returnPartialSuccess` parameter to `true`.
39933
41249
  # @param [String] project
39934
41250
  # Name of the project scoping this request.
39935
41251
  # @param [String] filter
@@ -39989,7 +41305,9 @@ module Google
39989
41305
  # by a previous list request to get the next page of results.
39990
41306
  # @param [Boolean] return_partial_success
39991
41307
  # Opt-in for partial success behavior which provides partial results in case of
39992
- # failure. The default value is false.
41308
+ # failure. The default value is false. For example, when partial success
41309
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
41310
+ # resources in the zone or no resources, with an error code.
39993
41311
  # @param [Fixnum] service_project_number
39994
41312
  # The Shared VPC service project id or service project number for which
39995
41313
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -40215,7 +41533,9 @@ module Google
40215
41533
  # by a previous list request to get the next page of results.
40216
41534
  # @param [Boolean] return_partial_success
40217
41535
  # Opt-in for partial success behavior which provides partial results in case of
40218
- # failure. The default value is false.
41536
+ # failure. The default value is false. For example, when partial success
41537
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
41538
+ # resources in the zone or no resources, with an error code.
40219
41539
  # @param [String] fields
40220
41540
  # Selector specifying which fields to include in a partial response.
40221
41541
  # @param [String] quota_user
@@ -40351,7 +41671,8 @@ module Google
40351
41671
  execute_or_queue_command(command, &block)
40352
41672
  end
40353
41673
 
40354
- # Retrieves an aggregated list of target VPN gateways.
41674
+ # Retrieves an aggregated list of target VPN gateways. To prevent failure,
41675
+ # Google recommends that you set the `returnPartialSuccess` parameter to `true`.
40355
41676
  # @param [String] project
40356
41677
  # Project ID for this request.
40357
41678
  # @param [String] filter
@@ -40411,7 +41732,9 @@ module Google
40411
41732
  # by a previous list request to get the next page of results.
40412
41733
  # @param [Boolean] return_partial_success
40413
41734
  # Opt-in for partial success behavior which provides partial results in case of
40414
- # failure. The default value is false.
41735
+ # failure. The default value is false. For example, when partial success
41736
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
41737
+ # resources in the zone or no resources, with an error code.
40415
41738
  # @param [Fixnum] service_project_number
40416
41739
  # The Shared VPC service project id or service project number for which
40417
41740
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -40648,7 +41971,9 @@ module Google
40648
41971
  # by a previous list request to get the next page of results.
40649
41972
  # @param [Boolean] return_partial_success
40650
41973
  # Opt-in for partial success behavior which provides partial results in case of
40651
- # failure. The default value is false.
41974
+ # failure. The default value is false. For example, when partial success
41975
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
41976
+ # resources in the zone or no resources, with an error code.
40652
41977
  # @param [String] fields
40653
41978
  # Selector specifying which fields to include in a partial response.
40654
41979
  # @param [String] quota_user
@@ -40740,7 +42065,8 @@ module Google
40740
42065
  end
40741
42066
 
40742
42067
  # Retrieves the list of all UrlMap resources, regional and global, available to
40743
- # the specified project.
42068
+ # the specified project. To prevent failure, Google recommends that you set the `
42069
+ # returnPartialSuccess` parameter to `true`.
40744
42070
  # @param [String] project
40745
42071
  # Name of the project scoping this request.
40746
42072
  # @param [String] filter
@@ -40800,7 +42126,9 @@ module Google
40800
42126
  # by a previous list request to get the next page of results.
40801
42127
  # @param [Boolean] return_partial_success
40802
42128
  # Opt-in for partial success behavior which provides partial results in case of
40803
- # failure. The default value is false.
42129
+ # failure. The default value is false. For example, when partial success
42130
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
42131
+ # resources in the zone or no resources, with an error code.
40804
42132
  # @param [Fixnum] service_project_number
40805
42133
  # The Shared VPC service project id or service project number for which
40806
42134
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -41077,7 +42405,9 @@ module Google
41077
42405
  # by a previous list request to get the next page of results.
41078
42406
  # @param [Boolean] return_partial_success
41079
42407
  # Opt-in for partial success behavior which provides partial results in case of
41080
- # failure. The default value is false.
42408
+ # failure. The default value is false. For example, when partial success
42409
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
42410
+ # resources in the zone or no resources, with an error code.
41081
42411
  # @param [String] fields
41082
42412
  # Selector specifying which fields to include in a partial response.
41083
42413
  # @param [String] quota_user
@@ -41255,7 +42585,8 @@ module Google
41255
42585
  execute_or_queue_command(command, &block)
41256
42586
  end
41257
42587
 
41258
- # Retrieves an aggregated list of VPN gateways.
42588
+ # Retrieves an aggregated list of VPN gateways. To prevent failure, Google
42589
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
41259
42590
  # @param [String] project
41260
42591
  # Project ID for this request.
41261
42592
  # @param [String] filter
@@ -41315,7 +42646,9 @@ module Google
41315
42646
  # by a previous list request to get the next page of results.
41316
42647
  # @param [Boolean] return_partial_success
41317
42648
  # Opt-in for partial success behavior which provides partial results in case of
41318
- # failure. The default value is false.
42649
+ # failure. The default value is false. For example, when partial success
42650
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
42651
+ # resources in the zone or no resources, with an error code.
41319
42652
  # @param [Fixnum] service_project_number
41320
42653
  # The Shared VPC service project id or service project number for which
41321
42654
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -41590,7 +42923,9 @@ module Google
41590
42923
  # by a previous list request to get the next page of results.
41591
42924
  # @param [Boolean] return_partial_success
41592
42925
  # Opt-in for partial success behavior which provides partial results in case of
41593
- # failure. The default value is false.
42926
+ # failure. The default value is false. For example, when partial success
42927
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
42928
+ # resources in the zone or no resources, with an error code.
41594
42929
  # @param [String] fields
41595
42930
  # Selector specifying which fields to include in a partial response.
41596
42931
  # @param [String] quota_user
@@ -41723,7 +43058,8 @@ module Google
41723
43058
  execute_or_queue_command(command, &block)
41724
43059
  end
41725
43060
 
41726
- # Retrieves an aggregated list of VPN tunnels.
43061
+ # Retrieves an aggregated list of VPN tunnels. To prevent failure, Google
43062
+ # recommends that you set the `returnPartialSuccess` parameter to `true`.
41727
43063
  # @param [String] project
41728
43064
  # Project ID for this request.
41729
43065
  # @param [String] filter
@@ -41783,7 +43119,9 @@ module Google
41783
43119
  # by a previous list request to get the next page of results.
41784
43120
  # @param [Boolean] return_partial_success
41785
43121
  # Opt-in for partial success behavior which provides partial results in case of
41786
- # failure. The default value is false.
43122
+ # failure. The default value is false. For example, when partial success
43123
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
43124
+ # resources in the zone or no resources, with an error code.
41787
43125
  # @param [Fixnum] service_project_number
41788
43126
  # The Shared VPC service project id or service project number for which
41789
43127
  # aggregated list request is invoked for subnetworks list-usable api.
@@ -42020,7 +43358,9 @@ module Google
42020
43358
  # by a previous list request to get the next page of results.
42021
43359
  # @param [Boolean] return_partial_success
42022
43360
  # Opt-in for partial success behavior which provides partial results in case of
42023
- # failure. The default value is false.
43361
+ # failure. The default value is false. For example, when partial success
43362
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
43363
+ # resources in the zone or no resources, with an error code.
42024
43364
  # @param [String] fields
42025
43365
  # Selector specifying which fields to include in a partial response.
42026
43366
  # @param [String] quota_user
@@ -42242,7 +43582,9 @@ module Google
42242
43582
  # by a previous list request to get the next page of results.
42243
43583
  # @param [Boolean] return_partial_success
42244
43584
  # Opt-in for partial success behavior which provides partial results in case of
42245
- # failure. The default value is false.
43585
+ # failure. The default value is false. For example, when partial success
43586
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
43587
+ # resources in the zone or no resources, with an error code.
42246
43588
  # @param [String] fields
42247
43589
  # Selector specifying which fields to include in a partial response.
42248
43590
  # @param [String] quota_user
@@ -42416,7 +43758,9 @@ module Google
42416
43758
  # by a previous list request to get the next page of results.
42417
43759
  # @param [Boolean] return_partial_success
42418
43760
  # Opt-in for partial success behavior which provides partial results in case of
42419
- # failure. The default value is false.
43761
+ # failure. The default value is false. For example, when partial success
43762
+ # behavior is enabled, aggregatedList for a single zone scope either returns all
43763
+ # resources in the zone or no resources, with an error code.
42420
43764
  # @param [String] fields
42421
43765
  # Selector specifying which fields to include in a partial response.
42422
43766
  # @param [String] quota_user