google-cloud-container 0.6.1 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 195f15f4b42eba085f0a5568b1681d6441900bee5f47255c408244858463bb82
4
- data.tar.gz: 4fe237103fdb10a21ba03ab62d01a2b0e73d6006151ec275bf281eb10cc2b3f6
3
+ metadata.gz: 76830e17c1a68396c63a74afbab9ad85882e77e6a156120df5e588046dd5f8f2
4
+ data.tar.gz: 7ff0352f9c069901ac82cee42b059bfb270d992a66abd0fd09f4f3e922e407ac
5
5
  SHA512:
6
- metadata.gz: 16dce290be96795188d32767af65c72c22c710e285e0e5f2ced6f6ea39c112b06f906c99aafe37b7613eac9b3265e2a4b6f8b396448eeaee4c001abf318e1814
7
- data.tar.gz: 7e131b8a823dc1e65fa81bcb7422f9dfda523ac7061eee0c09418fc964b8b08566550d4ed5c5572ce7625551b9811489a52355eec525d8e8e19ebb3c36d33623
6
+ metadata.gz: dc9fcfe8c3439218fc8410cfa854b13940adc1c26e23a391c02df854b8edcc86444e321baf7ffef6dd8520666fa0d83867b60b9c25a76c0eb15f1f975032d79b
7
+ data.tar.gz: 661db22a42b5a2ddf01c811cd630e08c27b275464ef59c8b2da5a3fc263206b1d16cc0ea6bf6e239cc06b636786d2088f43b626ef2b5473c6832e6e794982e8d
data/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Ruby Client for Kubernetes Engine API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
2
2
 
3
3
  [Kubernetes Engine API][Product Documentation]:
4
- The Google Kubernetes Engine API is used for building and managing container
5
- based applications, powered by the open source Kubernetes technology.
4
+ Builds and manages container-based applications, powered by the open source
5
+ Kubernetes technology.
6
6
  - [Client Library Documentation][]
7
7
  - [Product Documentation][]
8
8
 
@@ -24,8 +24,8 @@ module Google
24
24
  # # Ruby Client for Kubernetes Engine API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
25
25
  #
26
26
  # [Kubernetes Engine API][Product Documentation]:
27
- # The Google Kubernetes Engine API is used for building and managing container
28
- # based applications, powered by the open source Kubernetes technology.
27
+ # Builds and manages container-based applications, powered by the open source
28
+ # Kubernetes technology.
29
29
  # - [Product Documentation][]
30
30
  #
31
31
  # ## Quick Start
@@ -24,8 +24,8 @@ module Google
24
24
  # # Ruby Client for Kubernetes Engine API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
25
25
  #
26
26
  # [Kubernetes Engine API][Product Documentation]:
27
- # The Google Kubernetes Engine API is used for building and managing container
28
- # based applications, powered by the open source Kubernetes technology.
27
+ # Builds and manages container-based applications, powered by the open source
28
+ # Kubernetes technology.
29
29
  # - [Product Documentation][]
30
30
  #
31
31
  # ## Quick Start
@@ -52,6 +52,15 @@ module Google
52
52
 
53
53
  DEFAULT_TIMEOUT = 30
54
54
 
55
+ PAGE_DESCRIPTORS = {
56
+ "list_usable_subnetworks" => Google::Gax::PageDescriptor.new(
57
+ "page_token",
58
+ "next_page_token",
59
+ "subnetworks")
60
+ }.freeze
61
+
62
+ private_constant :PAGE_DESCRIPTORS
63
+
55
64
  # The scopes needed to make gRPC calls to all of the methods defined in
56
65
  # this service.
57
66
  ALL_SCOPES = [
@@ -147,6 +156,7 @@ module Google
147
156
  client_config,
148
157
  Google::Gax::Grpc::STATUS_CODE_NAMES,
149
158
  timeout,
159
+ page_descriptors: PAGE_DESCRIPTORS,
150
160
  errors: Google::Gax::Grpc::API_ERRORS,
151
161
  metadata: headers
152
162
  )
@@ -407,6 +417,14 @@ module Google
407
417
  {'name' => request.name}
408
418
  end
409
419
  )
420
+ @list_usable_subnetworks = Google::Gax.create_api_call(
421
+ @cluster_manager_stub.method(:list_usable_subnetworks),
422
+ defaults["list_usable_subnetworks"],
423
+ exception_transformer: exception_transformer,
424
+ params_extractor: proc do |request|
425
+ {'parent' => request.parent}
426
+ end
427
+ )
410
428
  end
411
429
 
412
430
  # Service calls
@@ -415,11 +433,11 @@ module Google
415
433
  # zones.
416
434
  #
417
435
  # @param project_id [String]
418
- # Deprecated. The Google Developers Console [project ID or project
436
+ # Required. Deprecated. The Google Developers Console [project ID or project
419
437
  # number](https://support.google.com/cloud/answer/6158840).
420
438
  # This field has been deprecated and replaced by the parent field.
421
439
  # @param zone [String]
422
- # Deprecated. The name of the Google Compute Engine
440
+ # Required. Deprecated. The name of the Google Compute Engine
423
441
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
424
442
  # resides, or "-" for all zones.
425
443
  # This field has been deprecated and replaced by the parent field.
@@ -465,16 +483,16 @@ module Google
465
483
  # Gets the details of a specific cluster.
466
484
  #
467
485
  # @param project_id [String]
468
- # Deprecated. The Google Developers Console [project ID or project
486
+ # Required. Deprecated. The Google Developers Console [project ID or project
469
487
  # number](https://support.google.com/cloud/answer/6158840).
470
488
  # This field has been deprecated and replaced by the name field.
471
489
  # @param zone [String]
472
- # Deprecated. The name of the Google Compute Engine
490
+ # Required. Deprecated. The name of the Google Compute Engine
473
491
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
474
492
  # resides.
475
493
  # This field has been deprecated and replaced by the name field.
476
494
  # @param cluster_id [String]
477
- # Deprecated. The name of the cluster to retrieve.
495
+ # Required. Deprecated. The name of the cluster to retrieve.
478
496
  # This field has been deprecated and replaced by the name field.
479
497
  # @param name [String]
480
498
  # The name (project, location, cluster) of the cluster to retrieve.
@@ -526,24 +544,24 @@ module Google
526
544
  # [default network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks).
527
545
  #
528
546
  # One firewall is added for the cluster. After cluster creation,
529
- # the cluster creates routes for each node to allow the containers
547
+ # the Kubelet creates routes for each node to allow the containers
530
548
  # on that node to communicate with all other instances in the
531
549
  # cluster.
532
550
  #
533
551
  # Finally, an entry is added to the project's global metadata indicating
534
- # which CIDR range is being used by the cluster.
552
+ # which CIDR range the cluster is using.
535
553
  #
536
554
  # @param project_id [String]
537
- # Deprecated. The Google Developers Console [project ID or project
555
+ # Required. Deprecated. The Google Developers Console [project ID or project
538
556
  # number](https://support.google.com/cloud/answer/6158840).
539
557
  # This field has been deprecated and replaced by the parent field.
540
558
  # @param zone [String]
541
- # Deprecated. The name of the Google Compute Engine
559
+ # Required. Deprecated. The name of the Google Compute Engine
542
560
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
543
561
  # resides.
544
562
  # This field has been deprecated and replaced by the parent field.
545
563
  # @param cluster [Google::Container::V1::Cluster | Hash]
546
- # A [cluster
564
+ # Required. A [cluster
547
565
  # resource](/container-engine/reference/rest/v1/projects.zones.clusters)
548
566
  # A hash of the same form as `Google::Container::V1::Cluster`
549
567
  # can also be provided.
@@ -593,19 +611,19 @@ module Google
593
611
  # Updates the settings of a specific cluster.
594
612
  #
595
613
  # @param project_id [String]
596
- # Deprecated. The Google Developers Console [project ID or project
614
+ # Required. Deprecated. The Google Developers Console [project ID or project
597
615
  # number](https://support.google.com/cloud/answer/6158840).
598
616
  # This field has been deprecated and replaced by the name field.
599
617
  # @param zone [String]
600
- # Deprecated. The name of the Google Compute Engine
618
+ # Required. Deprecated. The name of the Google Compute Engine
601
619
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
602
620
  # resides.
603
621
  # This field has been deprecated and replaced by the name field.
604
622
  # @param cluster_id [String]
605
- # Deprecated. The name of the cluster to upgrade.
623
+ # Required. Deprecated. The name of the cluster to upgrade.
606
624
  # This field has been deprecated and replaced by the name field.
607
625
  # @param update [Google::Container::V1::ClusterUpdate | Hash]
608
- # A description of the update.
626
+ # Required. A description of the update.
609
627
  # A hash of the same form as `Google::Container::V1::ClusterUpdate`
610
628
  # can also be provided.
611
629
  # @param name [String]
@@ -656,25 +674,25 @@ module Google
656
674
  @update_cluster.call(req, options, &block)
657
675
  end
658
676
 
659
- # Updates the version and/or image type for a specific node pool.
677
+ # Updates the version and/or image type for the specified node pool.
660
678
  #
661
679
  # @param project_id [String]
662
- # Deprecated. The Google Developers Console [project ID or project
680
+ # Required. Deprecated. The Google Developers Console [project ID or project
663
681
  # number](https://support.google.com/cloud/answer/6158840).
664
682
  # This field has been deprecated and replaced by the name field.
665
683
  # @param zone [String]
666
- # Deprecated. The name of the Google Compute Engine
684
+ # Required. Deprecated. The name of the Google Compute Engine
667
685
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
668
686
  # resides.
669
687
  # This field has been deprecated and replaced by the name field.
670
688
  # @param cluster_id [String]
671
- # Deprecated. The name of the cluster to upgrade.
689
+ # Required. Deprecated. The name of the cluster to upgrade.
672
690
  # This field has been deprecated and replaced by the name field.
673
691
  # @param node_pool_id [String]
674
- # Deprecated. The name of the node pool to upgrade.
692
+ # Required. Deprecated. The name of the node pool to upgrade.
675
693
  # This field has been deprecated and replaced by the name field.
676
694
  # @param node_version [String]
677
- # The Kubernetes version to change the nodes to (typically an
695
+ # Required. The Kubernetes version to change the nodes to (typically an
678
696
  # upgrade).
679
697
  #
680
698
  # Users may specify either explicit versions offered by Kubernetes Engine or
@@ -686,7 +704,7 @@ module Google
686
704
  # * "1.X.Y-gke.N": picks an explicit Kubernetes version
687
705
  # * "-": picks the Kubernetes master version
688
706
  # @param image_type [String]
689
- # The desired image type for the node pool.
707
+ # Required. The desired image type for the node pool.
690
708
  # @param name [String]
691
709
  # The name (project, location, cluster, node pool) of the node pool to
692
710
  # update. Specified in the format
@@ -746,25 +764,25 @@ module Google
746
764
  @update_node_pool.call(req, options, &block)
747
765
  end
748
766
 
749
- # Sets the autoscaling settings for a specific node pool.
767
+ # Sets the autoscaling settings for the specified node pool.
750
768
  #
751
769
  # @param project_id [String]
752
- # Deprecated. The Google Developers Console [project ID or project
770
+ # Required. Deprecated. The Google Developers Console [project ID or project
753
771
  # number](https://support.google.com/cloud/answer/6158840).
754
772
  # This field has been deprecated and replaced by the name field.
755
773
  # @param zone [String]
756
- # Deprecated. The name of the Google Compute Engine
774
+ # Required. Deprecated. The name of the Google Compute Engine
757
775
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
758
776
  # resides.
759
777
  # This field has been deprecated and replaced by the name field.
760
778
  # @param cluster_id [String]
761
- # Deprecated. The name of the cluster to upgrade.
779
+ # Required. Deprecated. The name of the cluster to upgrade.
762
780
  # This field has been deprecated and replaced by the name field.
763
781
  # @param node_pool_id [String]
764
- # Deprecated. The name of the node pool to upgrade.
782
+ # Required. Deprecated. The name of the node pool to upgrade.
765
783
  # This field has been deprecated and replaced by the name field.
766
784
  # @param autoscaling [Google::Container::V1::NodePoolAutoscaling | Hash]
767
- # Autoscaling configuration for the node pool.
785
+ # Required. Autoscaling configuration for the node pool.
768
786
  # A hash of the same form as `Google::Container::V1::NodePoolAutoscaling`
769
787
  # can also be provided.
770
788
  # @param name [String]
@@ -824,19 +842,19 @@ module Google
824
842
  # Sets the logging service for a specific cluster.
825
843
  #
826
844
  # @param project_id [String]
827
- # Deprecated. The Google Developers Console [project ID or project
845
+ # Required. Deprecated. The Google Developers Console [project ID or project
828
846
  # number](https://support.google.com/cloud/answer/6158840).
829
847
  # This field has been deprecated and replaced by the name field.
830
848
  # @param zone [String]
831
- # Deprecated. The name of the Google Compute Engine
849
+ # Required. Deprecated. The name of the Google Compute Engine
832
850
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
833
851
  # resides.
834
852
  # This field has been deprecated and replaced by the name field.
835
853
  # @param cluster_id [String]
836
- # Deprecated. The name of the cluster to upgrade.
854
+ # Required. Deprecated. The name of the cluster to upgrade.
837
855
  # This field has been deprecated and replaced by the name field.
838
856
  # @param logging_service [String]
839
- # The logging service the cluster should use to write metrics.
857
+ # Required. The logging service the cluster should use to write metrics.
840
858
  # Currently available options:
841
859
  #
842
860
  # * "logging.googleapis.com" - the Google Cloud Logging service
@@ -892,21 +910,23 @@ module Google
892
910
  # Sets the monitoring service for a specific cluster.
893
911
  #
894
912
  # @param project_id [String]
895
- # Deprecated. The Google Developers Console [project ID or project
913
+ # Required. Deprecated. The Google Developers Console [project ID or project
896
914
  # number](https://support.google.com/cloud/answer/6158840).
897
915
  # This field has been deprecated and replaced by the name field.
898
916
  # @param zone [String]
899
- # Deprecated. The name of the Google Compute Engine
917
+ # Required. Deprecated. The name of the Google Compute Engine
900
918
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
901
919
  # resides.
902
920
  # This field has been deprecated and replaced by the name field.
903
921
  # @param cluster_id [String]
904
- # Deprecated. The name of the cluster to upgrade.
922
+ # Required. Deprecated. The name of the cluster to upgrade.
905
923
  # This field has been deprecated and replaced by the name field.
906
924
  # @param monitoring_service [String]
907
- # The monitoring service the cluster should use to write metrics.
925
+ # Required. The monitoring service the cluster should use to write metrics.
908
926
  # Currently available options:
909
927
  #
928
+ # * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring
929
+ # service with Kubernetes-native resource model
910
930
  # * "monitoring.googleapis.com" - the Google Cloud Monitoring service
911
931
  # * "none" - no metrics will be exported from the cluster
912
932
  # @param name [String]
@@ -960,19 +980,19 @@ module Google
960
980
  # Sets the addons for a specific cluster.
961
981
  #
962
982
  # @param project_id [String]
963
- # Deprecated. The Google Developers Console [project ID or project
983
+ # Required. Deprecated. The Google Developers Console [project ID or project
964
984
  # number](https://support.google.com/cloud/answer/6158840).
965
985
  # This field has been deprecated and replaced by the name field.
966
986
  # @param zone [String]
967
- # Deprecated. The name of the Google Compute Engine
987
+ # Required. Deprecated. The name of the Google Compute Engine
968
988
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
969
989
  # resides.
970
990
  # This field has been deprecated and replaced by the name field.
971
991
  # @param cluster_id [String]
972
- # Deprecated. The name of the cluster to upgrade.
992
+ # Required. Deprecated. The name of the cluster to upgrade.
973
993
  # This field has been deprecated and replaced by the name field.
974
994
  # @param addons_config [Google::Container::V1::AddonsConfig | Hash]
975
- # The desired configurations for the various addons available to run in the
995
+ # Required. The desired configurations for the various addons available to run in the
976
996
  # cluster.
977
997
  # A hash of the same form as `Google::Container::V1::AddonsConfig`
978
998
  # can also be provided.
@@ -1027,20 +1047,20 @@ module Google
1027
1047
  # Sets the locations for a specific cluster.
1028
1048
  #
1029
1049
  # @param project_id [String]
1030
- # Deprecated. The Google Developers Console [project ID or project
1050
+ # Required. Deprecated. The Google Developers Console [project ID or project
1031
1051
  # number](https://support.google.com/cloud/answer/6158840).
1032
1052
  # This field has been deprecated and replaced by the name field.
1033
1053
  # @param zone [String]
1034
- # Deprecated. The name of the Google Compute Engine
1054
+ # Required. Deprecated. The name of the Google Compute Engine
1035
1055
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1036
1056
  # resides.
1037
1057
  # This field has been deprecated and replaced by the name field.
1038
1058
  # @param cluster_id [String]
1039
- # Deprecated. The name of the cluster to upgrade.
1059
+ # Required. Deprecated. The name of the cluster to upgrade.
1040
1060
  # This field has been deprecated and replaced by the name field.
1041
1061
  # @param locations [Array<String>]
1042
- # The desired list of Google Compute Engine
1043
- # [locations](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
1062
+ # Required. The desired list of Google Compute Engine
1063
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
1044
1064
  # should be located. Changing the locations a cluster is in will result
1045
1065
  # in nodes being either created or removed from the cluster, depending on
1046
1066
  # whether locations are being added or removed.
@@ -1097,19 +1117,19 @@ module Google
1097
1117
  # Updates the master for a specific cluster.
1098
1118
  #
1099
1119
  # @param project_id [String]
1100
- # Deprecated. The Google Developers Console [project ID or project
1120
+ # Required. Deprecated. The Google Developers Console [project ID or project
1101
1121
  # number](https://support.google.com/cloud/answer/6158840).
1102
1122
  # This field has been deprecated and replaced by the name field.
1103
1123
  # @param zone [String]
1104
- # Deprecated. The name of the Google Compute Engine
1124
+ # Required. Deprecated. The name of the Google Compute Engine
1105
1125
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1106
1126
  # resides.
1107
1127
  # This field has been deprecated and replaced by the name field.
1108
1128
  # @param cluster_id [String]
1109
- # Deprecated. The name of the cluster to upgrade.
1129
+ # Required. Deprecated. The name of the cluster to upgrade.
1110
1130
  # This field has been deprecated and replaced by the name field.
1111
1131
  # @param master_version [String]
1112
- # The Kubernetes version to change the master to.
1132
+ # Required. The Kubernetes version to change the master to.
1113
1133
  #
1114
1134
  # Users may specify either explicit versions offered by Kubernetes Engine or
1115
1135
  # version aliases, which have the following behavior:
@@ -1167,26 +1187,26 @@ module Google
1167
1187
  @update_master.call(req, options, &block)
1168
1188
  end
1169
1189
 
1170
- # Used to set master auth materials. Currently supports :-
1171
- # Changing the admin password for a specific cluster.
1172
- # This can be either via password generation or explicitly set the password.
1190
+ # Sets master auth materials. Currently supports changing the admin password
1191
+ # or a specific cluster, either via password generation or explicitly setting
1192
+ # the password.
1173
1193
  #
1174
1194
  # @param project_id [String]
1175
- # Deprecated. The Google Developers Console [project ID or project
1195
+ # Required. Deprecated. The Google Developers Console [project ID or project
1176
1196
  # number](https://support.google.com/cloud/answer/6158840).
1177
1197
  # This field has been deprecated and replaced by the name field.
1178
1198
  # @param zone [String]
1179
- # Deprecated. The name of the Google Compute Engine
1199
+ # Required. Deprecated. The name of the Google Compute Engine
1180
1200
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1181
1201
  # resides.
1182
1202
  # This field has been deprecated and replaced by the name field.
1183
1203
  # @param cluster_id [String]
1184
- # Deprecated. The name of the cluster to upgrade.
1204
+ # Required. Deprecated. The name of the cluster to upgrade.
1185
1205
  # This field has been deprecated and replaced by the name field.
1186
1206
  # @param action [Google::Container::V1::SetMasterAuthRequest::Action]
1187
- # The exact form of action to be taken on the master auth.
1207
+ # Required. The exact form of action to be taken on the master auth.
1188
1208
  # @param update [Google::Container::V1::MasterAuth | Hash]
1189
- # A description of the update.
1209
+ # Required. A description of the update.
1190
1210
  # A hash of the same form as `Google::Container::V1::MasterAuth`
1191
1211
  # can also be provided.
1192
1212
  # @param name [String]
@@ -1248,21 +1268,21 @@ module Google
1248
1268
  # Firewalls and routes that were configured during cluster creation
1249
1269
  # are also deleted.
1250
1270
  #
1251
- # Other Google Compute Engine resources that might be in use by the cluster
1252
- # (e.g. load balancer resources) will not be deleted if they weren't present
1253
- # at the initial create time.
1271
+ # Other Google Compute Engine resources that might be in use by the cluster,
1272
+ # such as load balancer resources, are not deleted if they weren't present
1273
+ # when the cluster was initially created.
1254
1274
  #
1255
1275
  # @param project_id [String]
1256
- # Deprecated. The Google Developers Console [project ID or project
1276
+ # Required. Deprecated. The Google Developers Console [project ID or project
1257
1277
  # number](https://support.google.com/cloud/answer/6158840).
1258
1278
  # This field has been deprecated and replaced by the name field.
1259
1279
  # @param zone [String]
1260
- # Deprecated. The name of the Google Compute Engine
1280
+ # Required. Deprecated. The name of the Google Compute Engine
1261
1281
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1262
1282
  # resides.
1263
1283
  # This field has been deprecated and replaced by the name field.
1264
1284
  # @param cluster_id [String]
1265
- # Deprecated. The name of the cluster to delete.
1285
+ # Required. Deprecated. The name of the cluster to delete.
1266
1286
  # This field has been deprecated and replaced by the name field.
1267
1287
  # @param name [String]
1268
1288
  # The name (project, location, cluster) of the cluster to delete.
@@ -1310,11 +1330,11 @@ module Google
1310
1330
  # Lists all operations in a project in a specific zone or all zones.
1311
1331
  #
1312
1332
  # @param project_id [String]
1313
- # Deprecated. The Google Developers Console [project ID or project
1333
+ # Required. Deprecated. The Google Developers Console [project ID or project
1314
1334
  # number](https://support.google.com/cloud/answer/6158840).
1315
1335
  # This field has been deprecated and replaced by the parent field.
1316
1336
  # @param zone [String]
1317
- # Deprecated. The name of the Google Compute Engine
1337
+ # Required. Deprecated. The name of the Google Compute Engine
1318
1338
  # [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for, or `-` for
1319
1339
  # all zones. This field has been deprecated and replaced by the parent field.
1320
1340
  # @param parent [String]
@@ -1359,16 +1379,16 @@ module Google
1359
1379
  # Gets the specified operation.
1360
1380
  #
1361
1381
  # @param project_id [String]
1362
- # Deprecated. The Google Developers Console [project ID or project
1382
+ # Required. Deprecated. The Google Developers Console [project ID or project
1363
1383
  # number](https://support.google.com/cloud/answer/6158840).
1364
1384
  # This field has been deprecated and replaced by the name field.
1365
1385
  # @param zone [String]
1366
- # Deprecated. The name of the Google Compute Engine
1386
+ # Required. Deprecated. The name of the Google Compute Engine
1367
1387
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1368
1388
  # resides.
1369
1389
  # This field has been deprecated and replaced by the name field.
1370
1390
  # @param operation_id [String]
1371
- # Deprecated. The server-assigned `name` of the operation.
1391
+ # Required. Deprecated. The server-assigned `name` of the operation.
1372
1392
  # This field has been deprecated and replaced by the name field.
1373
1393
  # @param name [String]
1374
1394
  # The name (project, location, operation id) of the operation to get.
@@ -1416,15 +1436,15 @@ module Google
1416
1436
  # Cancels the specified operation.
1417
1437
  #
1418
1438
  # @param project_id [String]
1419
- # Deprecated. The Google Developers Console [project ID or project
1439
+ # Required. Deprecated. The Google Developers Console [project ID or project
1420
1440
  # number](https://support.google.com/cloud/answer/6158840).
1421
1441
  # This field has been deprecated and replaced by the name field.
1422
1442
  # @param zone [String]
1423
- # Deprecated. The name of the Google Compute Engine
1443
+ # Required. Deprecated. The name of the Google Compute Engine
1424
1444
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation resides.
1425
1445
  # This field has been deprecated and replaced by the name field.
1426
1446
  # @param operation_id [String]
1427
- # Deprecated. The server-assigned `name` of the operation.
1447
+ # Required. Deprecated. The server-assigned `name` of the operation.
1428
1448
  # This field has been deprecated and replaced by the name field.
1429
1449
  # @param name [String]
1430
1450
  # The name (project, location, operation id) of the operation to cancel.
@@ -1469,19 +1489,19 @@ module Google
1469
1489
  nil
1470
1490
  end
1471
1491
 
1472
- # Returns configuration info about the Kubernetes Engine service.
1492
+ # Returns configuration info about the Google Kubernetes Engine service.
1473
1493
  #
1474
1494
  # @param project_id [String]
1475
- # Deprecated. The Google Developers Console [project ID or project
1495
+ # Required. Deprecated. The Google Developers Console [project ID or project
1476
1496
  # number](https://support.google.com/cloud/answer/6158840).
1477
1497
  # This field has been deprecated and replaced by the name field.
1478
1498
  # @param zone [String]
1479
- # Deprecated. The name of the Google Compute Engine
1499
+ # Required. Deprecated. The name of the Google Compute Engine
1480
1500
  # [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for.
1481
1501
  # This field has been deprecated and replaced by the name field.
1482
1502
  # @param name [String]
1483
- # The name (project and location) of the server config to get
1484
- # Specified in the format 'projects/*/locations/*'.
1503
+ # The name (project and location) of the server config to get,
1504
+ # specified in the format 'projects/*/locations/*'.
1485
1505
  # @param options [Google::Gax::CallOptions]
1486
1506
  # Overrides the default settings for this call, e.g, timeout,
1487
1507
  # retries, etc.
@@ -1520,16 +1540,16 @@ module Google
1520
1540
  # Lists the node pools for a cluster.
1521
1541
  #
1522
1542
  # @param project_id [String]
1523
- # Deprecated. The Google Developers Console [project ID or project
1543
+ # Required. Deprecated. The Google Developers Console [project ID or project
1524
1544
  # number](https://developers.google.com/console/help/new/#projectnumber).
1525
1545
  # This field has been deprecated and replaced by the parent field.
1526
1546
  # @param zone [String]
1527
- # Deprecated. The name of the Google Compute Engine
1547
+ # Required. Deprecated. The name of the Google Compute Engine
1528
1548
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1529
1549
  # resides.
1530
1550
  # This field has been deprecated and replaced by the parent field.
1531
1551
  # @param cluster_id [String]
1532
- # Deprecated. The name of the cluster.
1552
+ # Required. Deprecated. The name of the cluster.
1533
1553
  # This field has been deprecated and replaced by the parent field.
1534
1554
  # @param parent [String]
1535
1555
  # The parent (project, location, cluster id) where the node pools will be
@@ -1574,22 +1594,22 @@ module Google
1574
1594
  @list_node_pools.call(req, options, &block)
1575
1595
  end
1576
1596
 
1577
- # Retrieves the node pool requested.
1597
+ # Retrieves the requested node pool.
1578
1598
  #
1579
1599
  # @param project_id [String]
1580
- # Deprecated. The Google Developers Console [project ID or project
1600
+ # Required. Deprecated. The Google Developers Console [project ID or project
1581
1601
  # number](https://developers.google.com/console/help/new/#projectnumber).
1582
1602
  # This field has been deprecated and replaced by the name field.
1583
1603
  # @param zone [String]
1584
- # Deprecated. The name of the Google Compute Engine
1604
+ # Required. Deprecated. The name of the Google Compute Engine
1585
1605
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1586
1606
  # resides.
1587
1607
  # This field has been deprecated and replaced by the name field.
1588
1608
  # @param cluster_id [String]
1589
- # Deprecated. The name of the cluster.
1609
+ # Required. Deprecated. The name of the cluster.
1590
1610
  # This field has been deprecated and replaced by the name field.
1591
1611
  # @param node_pool_id [String]
1592
- # Deprecated. The name of the node pool.
1612
+ # Required. Deprecated. The name of the node pool.
1593
1613
  # This field has been deprecated and replaced by the name field.
1594
1614
  # @param name [String]
1595
1615
  # The name (project, location, cluster, node pool id) of the node pool to
@@ -1643,19 +1663,19 @@ module Google
1643
1663
  # Creates a node pool for a cluster.
1644
1664
  #
1645
1665
  # @param project_id [String]
1646
- # Deprecated. The Google Developers Console [project ID or project
1666
+ # Required. Deprecated. The Google Developers Console [project ID or project
1647
1667
  # number](https://developers.google.com/console/help/new/#projectnumber).
1648
1668
  # This field has been deprecated and replaced by the parent field.
1649
1669
  # @param zone [String]
1650
- # Deprecated. The name of the Google Compute Engine
1670
+ # Required. Deprecated. The name of the Google Compute Engine
1651
1671
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1652
1672
  # resides.
1653
1673
  # This field has been deprecated and replaced by the parent field.
1654
1674
  # @param cluster_id [String]
1655
- # Deprecated. The name of the cluster.
1675
+ # Required. Deprecated. The name of the cluster.
1656
1676
  # This field has been deprecated and replaced by the parent field.
1657
1677
  # @param node_pool [Google::Container::V1::NodePool | Hash]
1658
- # The node pool to create.
1678
+ # Required. The node pool to create.
1659
1679
  # A hash of the same form as `Google::Container::V1::NodePool`
1660
1680
  # can also be provided.
1661
1681
  # @param parent [String]
@@ -1710,19 +1730,19 @@ module Google
1710
1730
  # Deletes a node pool from a cluster.
1711
1731
  #
1712
1732
  # @param project_id [String]
1713
- # Deprecated. The Google Developers Console [project ID or project
1733
+ # Required. Deprecated. The Google Developers Console [project ID or project
1714
1734
  # number](https://developers.google.com/console/help/new/#projectnumber).
1715
1735
  # This field has been deprecated and replaced by the name field.
1716
1736
  # @param zone [String]
1717
- # Deprecated. The name of the Google Compute Engine
1737
+ # Required. Deprecated. The name of the Google Compute Engine
1718
1738
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1719
1739
  # resides.
1720
1740
  # This field has been deprecated and replaced by the name field.
1721
1741
  # @param cluster_id [String]
1722
- # Deprecated. The name of the cluster.
1742
+ # Required. Deprecated. The name of the cluster.
1723
1743
  # This field has been deprecated and replaced by the name field.
1724
1744
  # @param node_pool_id [String]
1725
- # Deprecated. The name of the node pool to delete.
1745
+ # Required. Deprecated. The name of the node pool to delete.
1726
1746
  # This field has been deprecated and replaced by the name field.
1727
1747
  # @param name [String]
1728
1748
  # The name (project, location, cluster, node pool id) of the node pool to
@@ -1773,23 +1793,23 @@ module Google
1773
1793
  @delete_node_pool.call(req, options, &block)
1774
1794
  end
1775
1795
 
1776
- # Roll back the previously Aborted or Failed NodePool upgrade.
1777
- # This will be an no-op if the last upgrade successfully completed.
1796
+ # Rolls back a previously Aborted or Failed NodePool upgrade.
1797
+ # This makes no changes if the last upgrade successfully completed.
1778
1798
  #
1779
1799
  # @param project_id [String]
1780
- # Deprecated. The Google Developers Console [project ID or project
1800
+ # Required. Deprecated. The Google Developers Console [project ID or project
1781
1801
  # number](https://support.google.com/cloud/answer/6158840).
1782
1802
  # This field has been deprecated and replaced by the name field.
1783
1803
  # @param zone [String]
1784
- # Deprecated. The name of the Google Compute Engine
1804
+ # Required. Deprecated. The name of the Google Compute Engine
1785
1805
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1786
1806
  # resides.
1787
1807
  # This field has been deprecated and replaced by the name field.
1788
1808
  # @param cluster_id [String]
1789
- # Deprecated. The name of the cluster to rollback.
1809
+ # Required. Deprecated. The name of the cluster to rollback.
1790
1810
  # This field has been deprecated and replaced by the name field.
1791
1811
  # @param node_pool_id [String]
1792
- # Deprecated. The name of the node pool to rollback.
1812
+ # Required. Deprecated. The name of the node pool to rollback.
1793
1813
  # This field has been deprecated and replaced by the name field.
1794
1814
  # @param name [String]
1795
1815
  # The name (project, location, cluster, node pool id) of the node poll to
@@ -1843,22 +1863,22 @@ module Google
1843
1863
  # Sets the NodeManagement options for a node pool.
1844
1864
  #
1845
1865
  # @param project_id [String]
1846
- # Deprecated. The Google Developers Console [project ID or project
1866
+ # Required. Deprecated. The Google Developers Console [project ID or project
1847
1867
  # number](https://support.google.com/cloud/answer/6158840).
1848
1868
  # This field has been deprecated and replaced by the name field.
1849
1869
  # @param zone [String]
1850
- # Deprecated. The name of the Google Compute Engine
1870
+ # Required. Deprecated. The name of the Google Compute Engine
1851
1871
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1852
1872
  # resides.
1853
1873
  # This field has been deprecated and replaced by the name field.
1854
1874
  # @param cluster_id [String]
1855
- # Deprecated. The name of the cluster to update.
1875
+ # Required. Deprecated. The name of the cluster to update.
1856
1876
  # This field has been deprecated and replaced by the name field.
1857
1877
  # @param node_pool_id [String]
1858
- # Deprecated. The name of the node pool to update.
1878
+ # Required. Deprecated. The name of the node pool to update.
1859
1879
  # This field has been deprecated and replaced by the name field.
1860
1880
  # @param management [Google::Container::V1::NodeManagement | Hash]
1861
- # NodeManagement configuration for the node pool.
1881
+ # Required. NodeManagement configuration for the node pool.
1862
1882
  # A hash of the same form as `Google::Container::V1::NodeManagement`
1863
1883
  # can also be provided.
1864
1884
  # @param name [String]
@@ -1918,21 +1938,21 @@ module Google
1918
1938
  # Sets labels on a cluster.
1919
1939
  #
1920
1940
  # @param project_id [String]
1921
- # Deprecated. The Google Developers Console [project ID or project
1941
+ # Required. Deprecated. The Google Developers Console [project ID or project
1922
1942
  # number](https://developers.google.com/console/help/new/#projectnumber).
1923
1943
  # This field has been deprecated and replaced by the name field.
1924
1944
  # @param zone [String]
1925
- # Deprecated. The name of the Google Compute Engine
1945
+ # Required. Deprecated. The name of the Google Compute Engine
1926
1946
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
1927
1947
  # resides.
1928
1948
  # This field has been deprecated and replaced by the name field.
1929
1949
  # @param cluster_id [String]
1930
- # Deprecated. The name of the cluster.
1950
+ # Required. Deprecated. The name of the cluster.
1931
1951
  # This field has been deprecated and replaced by the name field.
1932
1952
  # @param resource_labels [Hash{String => String}]
1933
- # The labels to set for that cluster.
1953
+ # Required. The labels to set for that cluster.
1934
1954
  # @param label_fingerprint [String]
1935
- # The fingerprint of the previous set of labels for this resource,
1955
+ # Required. The fingerprint of the previous set of labels for this resource,
1936
1956
  # used to detect conflicts. The fingerprint is initially generated by
1937
1957
  # Kubernetes Engine and changes after every request to modify or update
1938
1958
  # labels. You must always provide an up-to-date fingerprint hash when
@@ -1994,19 +2014,19 @@ module Google
1994
2014
  # Enables or disables the ABAC authorization mechanism on a cluster.
1995
2015
  #
1996
2016
  # @param project_id [String]
1997
- # Deprecated. The Google Developers Console [project ID or project
2017
+ # Required. Deprecated. The Google Developers Console [project ID or project
1998
2018
  # number](https://support.google.com/cloud/answer/6158840).
1999
2019
  # This field has been deprecated and replaced by the name field.
2000
2020
  # @param zone [String]
2001
- # Deprecated. The name of the Google Compute Engine
2021
+ # Required. Deprecated. The name of the Google Compute Engine
2002
2022
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2003
2023
  # resides.
2004
2024
  # This field has been deprecated and replaced by the name field.
2005
2025
  # @param cluster_id [String]
2006
- # Deprecated. The name of the cluster to update.
2026
+ # Required. Deprecated. The name of the cluster to update.
2007
2027
  # This field has been deprecated and replaced by the name field.
2008
2028
  # @param enabled [true, false]
2009
- # Whether ABAC authorization will be enabled in the cluster.
2029
+ # Required. Whether ABAC authorization will be enabled in the cluster.
2010
2030
  # @param name [String]
2011
2031
  # The name (project, location, cluster id) of the cluster to set legacy abac.
2012
2032
  # Specified in the format 'projects/*/locations/*/clusters/*'.
@@ -2055,19 +2075,19 @@ module Google
2055
2075
  @set_legacy_abac.call(req, options, &block)
2056
2076
  end
2057
2077
 
2058
- # Start master IP rotation.
2078
+ # Starts master IP rotation.
2059
2079
  #
2060
2080
  # @param project_id [String]
2061
- # Deprecated. The Google Developers Console [project ID or project
2081
+ # Required. Deprecated. The Google Developers Console [project ID or project
2062
2082
  # number](https://developers.google.com/console/help/new/#projectnumber).
2063
2083
  # This field has been deprecated and replaced by the name field.
2064
2084
  # @param zone [String]
2065
- # Deprecated. The name of the Google Compute Engine
2085
+ # Required. Deprecated. The name of the Google Compute Engine
2066
2086
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2067
2087
  # resides.
2068
2088
  # This field has been deprecated and replaced by the name field.
2069
2089
  # @param cluster_id [String]
2070
- # Deprecated. The name of the cluster.
2090
+ # Required. Deprecated. The name of the cluster.
2071
2091
  # This field has been deprecated and replaced by the name field.
2072
2092
  # @param name [String]
2073
2093
  # The name (project, location, cluster id) of the cluster to start IP
@@ -2119,16 +2139,16 @@ module Google
2119
2139
  # Completes master IP rotation.
2120
2140
  #
2121
2141
  # @param project_id [String]
2122
- # Deprecated. The Google Developers Console [project ID or project
2142
+ # Required. Deprecated. The Google Developers Console [project ID or project
2123
2143
  # number](https://developers.google.com/console/help/new/#projectnumber).
2124
2144
  # This field has been deprecated and replaced by the name field.
2125
2145
  # @param zone [String]
2126
- # Deprecated. The name of the Google Compute Engine
2146
+ # Required. Deprecated. The name of the Google Compute Engine
2127
2147
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2128
2148
  # resides.
2129
2149
  # This field has been deprecated and replaced by the name field.
2130
2150
  # @param cluster_id [String]
2131
- # Deprecated. The name of the cluster.
2151
+ # Required. Deprecated. The name of the cluster.
2132
2152
  # This field has been deprecated and replaced by the name field.
2133
2153
  # @param name [String]
2134
2154
  # The name (project, location, cluster id) of the cluster to complete IP
@@ -2176,22 +2196,22 @@ module Google
2176
2196
  # Sets the size for a specific node pool.
2177
2197
  #
2178
2198
  # @param project_id [String]
2179
- # Deprecated. The Google Developers Console [project ID or project
2199
+ # Required. Deprecated. The Google Developers Console [project ID or project
2180
2200
  # number](https://support.google.com/cloud/answer/6158840).
2181
2201
  # This field has been deprecated and replaced by the name field.
2182
2202
  # @param zone [String]
2183
- # Deprecated. The name of the Google Compute Engine
2203
+ # Required. Deprecated. The name of the Google Compute Engine
2184
2204
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2185
2205
  # resides.
2186
2206
  # This field has been deprecated and replaced by the name field.
2187
2207
  # @param cluster_id [String]
2188
- # Deprecated. The name of the cluster to update.
2208
+ # Required. Deprecated. The name of the cluster to update.
2189
2209
  # This field has been deprecated and replaced by the name field.
2190
2210
  # @param node_pool_id [String]
2191
- # Deprecated. The name of the node pool to update.
2211
+ # Required. Deprecated. The name of the node pool to update.
2192
2212
  # This field has been deprecated and replaced by the name field.
2193
2213
  # @param node_count [Integer]
2194
- # The desired node count for the pool.
2214
+ # Required. The desired node count for the pool.
2195
2215
  # @param name [String]
2196
2216
  # The name (project, location, cluster, node pool id) of the node pool to set
2197
2217
  # size.
@@ -2246,22 +2266,22 @@ module Google
2246
2266
  @set_node_pool_size.call(req, options, &block)
2247
2267
  end
2248
2268
 
2249
- # Enables/Disables Network Policy for a cluster.
2269
+ # Enables or disables Network Policy for a cluster.
2250
2270
  #
2251
2271
  # @param project_id [String]
2252
- # Deprecated. The Google Developers Console [project ID or project
2272
+ # Required. Deprecated. The Google Developers Console [project ID or project
2253
2273
  # number](https://developers.google.com/console/help/new/#projectnumber).
2254
2274
  # This field has been deprecated and replaced by the name field.
2255
2275
  # @param zone [String]
2256
- # Deprecated. The name of the Google Compute Engine
2276
+ # Required. Deprecated. The name of the Google Compute Engine
2257
2277
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2258
2278
  # resides.
2259
2279
  # This field has been deprecated and replaced by the name field.
2260
2280
  # @param cluster_id [String]
2261
- # Deprecated. The name of the cluster.
2281
+ # Required. Deprecated. The name of the cluster.
2262
2282
  # This field has been deprecated and replaced by the name field.
2263
2283
  # @param network_policy [Google::Container::V1::NetworkPolicy | Hash]
2264
- # Configuration options for the NetworkPolicy feature.
2284
+ # Required. Configuration options for the NetworkPolicy feature.
2265
2285
  # A hash of the same form as `Google::Container::V1::NetworkPolicy`
2266
2286
  # can also be provided.
2267
2287
  # @param name [String]
@@ -2315,16 +2335,16 @@ module Google
2315
2335
  # Sets the maintenance policy for a cluster.
2316
2336
  #
2317
2337
  # @param project_id [String]
2318
- # The Google Developers Console [project ID or project
2338
+ # Required. The Google Developers Console [project ID or project
2319
2339
  # number](https://support.google.com/cloud/answer/6158840).
2320
2340
  # @param zone [String]
2321
- # The name of the Google Compute Engine
2341
+ # Required. The name of the Google Compute Engine
2322
2342
  # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
2323
2343
  # resides.
2324
2344
  # @param cluster_id [String]
2325
- # The name of the cluster to update.
2345
+ # Required. The name of the cluster to update.
2326
2346
  # @param maintenance_policy [Google::Container::V1::MaintenancePolicy | Hash]
2327
- # The maintenance policy to be set for the cluster. An empty field
2347
+ # Required. The maintenance policy to be set for the cluster. An empty field
2328
2348
  # clears the existing maintenance policy.
2329
2349
  # A hash of the same form as `Google::Container::V1::MaintenancePolicy`
2330
2350
  # can also be provided.
@@ -2376,6 +2396,67 @@ module Google
2376
2396
  req = Google::Gax::to_proto(req, Google::Container::V1::SetMaintenancePolicyRequest)
2377
2397
  @set_maintenance_policy.call(req, options, &block)
2378
2398
  end
2399
+
2400
+ # Lists subnetworks that are usable for creating clusters in a project.
2401
+ #
2402
+ # @param parent [String]
2403
+ # The parent project where subnetworks are usable.
2404
+ # Specified in the format 'projects/*'.
2405
+ # @param filter [String]
2406
+ # Filtering currently only supports equality on the networkProjectId and must
2407
+ # be in the form: "networkProjectId=[PROJECTID]", where `networkProjectId`
2408
+ # is the project which owns the listed subnetworks. This defaults to the
2409
+ # parent project ID.
2410
+ # @param page_size [Integer]
2411
+ # The maximum number of resources contained in the underlying API
2412
+ # response. If page streaming is performed per-resource, this
2413
+ # parameter does not affect the return value. If page streaming is
2414
+ # performed per-page, this determines the maximum number of
2415
+ # resources in a page.
2416
+ # @param options [Google::Gax::CallOptions]
2417
+ # Overrides the default settings for this call, e.g, timeout,
2418
+ # retries, etc.
2419
+ # @yield [result, operation] Access the result along with the RPC operation
2420
+ # @yieldparam result [Google::Gax::PagedEnumerable<Google::Container::V1::UsableSubnetwork>]
2421
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2422
+ # @return [Google::Gax::PagedEnumerable<Google::Container::V1::UsableSubnetwork>]
2423
+ # An enumerable of Google::Container::V1::UsableSubnetwork instances.
2424
+ # See Google::Gax::PagedEnumerable documentation for other
2425
+ # operations such as per-page iteration or access to the response
2426
+ # object.
2427
+ # @raise [Google::Gax::GaxError] if the RPC is aborted.
2428
+ # @example
2429
+ # require "google/cloud/container"
2430
+ #
2431
+ # cluster_manager_client = Google::Cloud::Container.new(version: :v1)
2432
+ #
2433
+ # # Iterate over all results.
2434
+ # cluster_manager_client.list_usable_subnetworks.each do |element|
2435
+ # # Process element.
2436
+ # end
2437
+ #
2438
+ # # Or iterate over results one page at a time.
2439
+ # cluster_manager_client.list_usable_subnetworks.each_page do |page|
2440
+ # # Process each page at a time.
2441
+ # page.each do |element|
2442
+ # # Process element.
2443
+ # end
2444
+ # end
2445
+
2446
+ def list_usable_subnetworks \
2447
+ parent: nil,
2448
+ filter: nil,
2449
+ page_size: nil,
2450
+ options: nil,
2451
+ &block
2452
+ req = {
2453
+ parent: parent,
2454
+ filter: filter,
2455
+ page_size: page_size
2456
+ }.delete_if { |_, v| v.nil? }
2457
+ req = Google::Gax::to_proto(req, Google::Container::V1::ListUsableSubnetworksRequest)
2458
+ @list_usable_subnetworks.call(req, options, &block)
2459
+ end
2379
2460
  end
2380
2461
  end
2381
2462
  end