google-cloud-gke_hub-v1 0.4.0 → 0.5.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: e211e3671a0c7c0ffae2b48a5da58e845d6157c309f8850f1ea8c27baf24a750
4
- data.tar.gz: 51aa70f26d9cdc2c05a4d1722256079f1fdb71b8b8032d947c4c862cb10bd586
3
+ metadata.gz: 68b640139c983d7fb3f82ae7a8d2167f75c0ad214d1ac8c605f6c196a252568f
4
+ data.tar.gz: 8e2820da7d7998e2ea610da93ba8765869400374bfa58f9dd9132c70c6ff72bd
5
5
  SHA512:
6
- metadata.gz: e33bb17ef24514e8a6fe326da7dcc3764aa066d9478522d4caa9f8768bc186e8e2ff9645ca60e76e0972a106ccf2f5a7e15caa844ee9021e7cc47db00cbefa64
7
- data.tar.gz: b70f7a2fec748e8194c03356fe72b3ba1d316261ee8ce3cf72f5165371904c35e4ff167e5aa42ce7b53bf26c567cb1a9070ace63fc0470813731b50948280602
6
+ metadata.gz: a91172fa0e47681f0dba2caa871a261ba383f356ad540eec3f9c7f5ef19d4c49e3a8060a24ab7530214461190d9fbadf744fbec2951b55766fc350c707e58680
7
+ data.tar.gz: 131589f7f062ed906c51d4d097c8eaa9cec11a9d0e0730c80efd395732225abb6af3aae0c2ea19fd33155faa4e2ef595437efa55651399295c020f819691f016
data/README.md CHANGED
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -36,7 +36,10 @@ module Google
36
36
  # * {::Google::Cloud::GkeHub::V1::Membership Membership}
37
37
  # * {::Google::Cloud::GkeHub::V1::Feature Feature}
38
38
  #
39
- # GKE Hub is currently only available in the global region.
39
+ # GKE Hub is currently available in the global region and all regions in
40
+ # https://cloud.google.com/compute/docs/regions-zones. Feature is only
41
+ # available in global region while membership is global region and all the
42
+ # regions.
40
43
  #
41
44
  # **Membership management may be non-trivial:** it is recommended to use one
42
45
  # of the Google-provided client libraries or tools where possible when working
@@ -194,19 +197,20 @@ module Google
194
197
  # the default parameter values, pass an empty Hash as a request object (see above).
195
198
  #
196
199
  # @param parent [::String]
197
- # Required. The parent (project and location) where the Memberships will be listed.
198
- # Specified in the format `projects/*/locations/*`.
200
+ # Required. The parent (project and location) where the Memberships will be
201
+ # listed. Specified in the format `projects/*/locations/*`.
202
+ # `projects/*/locations/-` list memberships in all the regions.
199
203
  # @param page_size [::Integer]
200
- # Optional. When requesting a 'page' of resources, `page_size` specifies number of
201
- # resources to return. If unspecified or set to 0, all resources will
202
- # be returned.
204
+ # Optional. When requesting a 'page' of resources, `page_size` specifies
205
+ # number of resources to return. If unspecified or set to 0, all resources
206
+ # will be returned.
203
207
  # @param page_token [::String]
204
208
  # Optional. Token returned by previous call to `ListMemberships` which
205
209
  # specifies the position in the list from where to continue listing the
206
210
  # resources.
207
211
  # @param filter [::String]
208
- # Optional. Lists Memberships that match the filter expression, following the syntax
209
- # outlined in https://google.aip.dev/160.
212
+ # Optional. Lists Memberships that match the filter expression, following the
213
+ # syntax outlined in https://google.aip.dev/160.
210
214
  #
211
215
  # Examples:
212
216
  #
@@ -612,11 +616,11 @@ module Google
612
616
  # the default parameter values, pass an empty Hash as a request object (see above).
613
617
  #
614
618
  # @param parent [::String]
615
- # Required. The parent (project and location) where the Memberships will be created.
616
- # Specified in the format `projects/*/locations/*`.
619
+ # Required. The parent (project and location) where the Memberships will be
620
+ # created. Specified in the format `projects/*/locations/*`.
617
621
  # @param membership_id [::String]
618
- # Required. Client chosen ID for the membership. `membership_id` must be a valid RFC
619
- # 1123 compliant DNS label:
622
+ # Required. Client chosen ID for the membership. `membership_id` must be a
623
+ # valid RFC 1123 compliant DNS label:
620
624
  #
621
625
  # 1. At most 63 characters in length
622
626
  # 2. It must consist of lower case alphanumeric characters or `-`
@@ -842,7 +846,7 @@ module Google
842
846
  # @param options [::Gapic::CallOptions, ::Hash]
843
847
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
844
848
  #
845
- # @overload delete_membership(name: nil, request_id: nil)
849
+ # @overload delete_membership(name: nil, request_id: nil, force: nil)
846
850
  # Pass arguments to `delete_membership` via keyword arguments. Note that at
847
851
  # least one keyword argument is required. To specify no parameters, or to keep all
848
852
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -864,6 +868,10 @@ module Google
864
868
  #
865
869
  # The request ID must be a valid UUID with the exception that zero UUID is
866
870
  # not supported (00000000-0000-0000-0000-000000000000).
871
+ # @param force [::Boolean]
872
+ # Optional. If set to true, any subresource from this Membership will also be
873
+ # deleted. Otherwise, the request will only work if the Membership has no
874
+ # subresource.
867
875
  #
868
876
  # @yield [response, operation] Access the result along with the RPC operation
869
877
  # @yieldparam response [::Gapic::Operation]
@@ -1309,22 +1317,24 @@ module Google
1309
1317
  # the default parameter values, pass an empty Hash as a request object (see above).
1310
1318
  #
1311
1319
  # @param name [::String]
1312
- # Required. The Membership resource name the Agent will associate with, in the format
1313
- # `projects/*/locations/*/memberships/*`.
1320
+ # Required. The Membership resource name the Agent will associate with, in
1321
+ # the format `projects/*/locations/*/memberships/*`.
1314
1322
  # @param namespace [::String]
1315
- # Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`.
1323
+ # Optional. Namespace for GKE Connect agent resources. Defaults to
1324
+ # `gke-connect`.
1316
1325
  #
1317
1326
  # The Connect Agent is authorized automatically when run in the default
1318
1327
  # namespace. Otherwise, explicit authorization must be granted with an
1319
1328
  # additional IAM binding.
1320
1329
  # @param proxy [::String]
1321
- # Optional. URI of a proxy if connectivity from the agent to gkeconnect.googleapis.com
1322
- # requires the use of a proxy. Format must be in the form
1323
- # `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
1330
+ # Optional. URI of a proxy if connectivity from the agent to
1331
+ # gkeconnect.googleapis.com requires the use of a proxy. Format must be in
1332
+ # the form `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
1324
1333
  # supported by the proxy. This will direct the connect agent's outbound
1325
1334
  # traffic through a HTTP(S) proxy.
1326
1335
  # @param version [::String]
1327
- # Optional. The Connect agent version to use. Defaults to the most current version.
1336
+ # Optional. The Connect agent version to use. Defaults to the most current
1337
+ # version.
1328
1338
  # @param is_upgrade [::Boolean]
1329
1339
  # Optional. If true, generate the resources for upgrade only. Some resources
1330
1340
  # generated only for installation (e.g. secrets) will be excluded.
@@ -1436,9 +1446,9 @@ module Google
1436
1446
  # * (`String`) The path to a service account key file in JSON format
1437
1447
  # * (`Hash`) A service account key as a Hash
1438
1448
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1439
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1449
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1440
1450
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1441
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1451
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1442
1452
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1443
1453
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1444
1454
  # * (`nil`) indicating no credentials
@@ -620,9 +620,9 @@ module Google
620
620
  # * (`String`) The path to a service account key file in JSON format
621
621
  # * (`Hash`) A service account key as a Hash
622
622
  # * (`Google::Auth::Credentials`) A googleauth credentials object
623
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
623
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
624
624
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
625
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
625
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
626
626
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
627
627
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
628
628
  # * (`nil`) indicating no credentials
@@ -38,7 +38,10 @@ module Google
38
38
  # * {::Google::Cloud::GkeHub::V1::Membership Membership}
39
39
  # * {::Google::Cloud::GkeHub::V1::Feature Feature}
40
40
  #
41
- # GKE Hub is currently only available in the global region.
41
+ # GKE Hub is currently available in the global region and all regions in
42
+ # https://cloud.google.com/compute/docs/regions-zones. Feature is only
43
+ # available in global region while membership is global region and all the
44
+ # regions.
42
45
  #
43
46
  # **Membership management may be non-trivial:** it is recommended to use one
44
47
  # of the Google-provided client libraries or tools where possible when working
@@ -185,19 +188,20 @@ module Google
185
188
  # the default parameter values, pass an empty Hash as a request object (see above).
186
189
  #
187
190
  # @param parent [::String]
188
- # Required. The parent (project and location) where the Memberships will be listed.
189
- # Specified in the format `projects/*/locations/*`.
191
+ # Required. The parent (project and location) where the Memberships will be
192
+ # listed. Specified in the format `projects/*/locations/*`.
193
+ # `projects/*/locations/-` list memberships in all the regions.
190
194
  # @param page_size [::Integer]
191
- # Optional. When requesting a 'page' of resources, `page_size` specifies number of
192
- # resources to return. If unspecified or set to 0, all resources will
193
- # be returned.
195
+ # Optional. When requesting a 'page' of resources, `page_size` specifies
196
+ # number of resources to return. If unspecified or set to 0, all resources
197
+ # will be returned.
194
198
  # @param page_token [::String]
195
199
  # Optional. Token returned by previous call to `ListMemberships` which
196
200
  # specifies the position in the list from where to continue listing the
197
201
  # resources.
198
202
  # @param filter [::String]
199
- # Optional. Lists Memberships that match the filter expression, following the syntax
200
- # outlined in https://google.aip.dev/160.
203
+ # Optional. Lists Memberships that match the filter expression, following the
204
+ # syntax outlined in https://google.aip.dev/160.
201
205
  #
202
206
  # Examples:
203
207
  #
@@ -502,11 +506,11 @@ module Google
502
506
  # the default parameter values, pass an empty Hash as a request object (see above).
503
507
  #
504
508
  # @param parent [::String]
505
- # Required. The parent (project and location) where the Memberships will be created.
506
- # Specified in the format `projects/*/locations/*`.
509
+ # Required. The parent (project and location) where the Memberships will be
510
+ # created. Specified in the format `projects/*/locations/*`.
507
511
  # @param membership_id [::String]
508
- # Required. Client chosen ID for the membership. `membership_id` must be a valid RFC
509
- # 1123 compliant DNS label:
512
+ # Required. Client chosen ID for the membership. `membership_id` must be a
513
+ # valid RFC 1123 compliant DNS label:
510
514
  #
511
515
  # 1. At most 63 characters in length
512
516
  # 2. It must consist of lower case alphanumeric characters or `-`
@@ -672,7 +676,7 @@ module Google
672
676
  # @param options [::Gapic::CallOptions, ::Hash]
673
677
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
674
678
  #
675
- # @overload delete_membership(name: nil, request_id: nil)
679
+ # @overload delete_membership(name: nil, request_id: nil, force: nil)
676
680
  # Pass arguments to `delete_membership` via keyword arguments. Note that at
677
681
  # least one keyword argument is required. To specify no parameters, or to keep all
678
682
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -694,6 +698,10 @@ module Google
694
698
  #
695
699
  # The request ID must be a valid UUID with the exception that zero UUID is
696
700
  # not supported (00000000-0000-0000-0000-000000000000).
701
+ # @param force [::Boolean]
702
+ # Optional. If set to true, any subresource from this Membership will also be
703
+ # deleted. Otherwise, the request will only work if the Membership has no
704
+ # subresource.
697
705
  # @yield [result, operation] Access the result along with the TransportOperation object
698
706
  # @yieldparam result [::Gapic::Operation]
699
707
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1019,22 +1027,24 @@ module Google
1019
1027
  # the default parameter values, pass an empty Hash as a request object (see above).
1020
1028
  #
1021
1029
  # @param name [::String]
1022
- # Required. The Membership resource name the Agent will associate with, in the format
1023
- # `projects/*/locations/*/memberships/*`.
1030
+ # Required. The Membership resource name the Agent will associate with, in
1031
+ # the format `projects/*/locations/*/memberships/*`.
1024
1032
  # @param namespace [::String]
1025
- # Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`.
1033
+ # Optional. Namespace for GKE Connect agent resources. Defaults to
1034
+ # `gke-connect`.
1026
1035
  #
1027
1036
  # The Connect Agent is authorized automatically when run in the default
1028
1037
  # namespace. Otherwise, explicit authorization must be granted with an
1029
1038
  # additional IAM binding.
1030
1039
  # @param proxy [::String]
1031
- # Optional. URI of a proxy if connectivity from the agent to gkeconnect.googleapis.com
1032
- # requires the use of a proxy. Format must be in the form
1033
- # `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
1040
+ # Optional. URI of a proxy if connectivity from the agent to
1041
+ # gkeconnect.googleapis.com requires the use of a proxy. Format must be in
1042
+ # the form `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
1034
1043
  # supported by the proxy. This will direct the connect agent's outbound
1035
1044
  # traffic through a HTTP(S) proxy.
1036
1045
  # @param version [::String]
1037
- # Optional. The Connect agent version to use. Defaults to the most current version.
1046
+ # Optional. The Connect agent version to use. Defaults to the most current
1047
+ # version.
1038
1048
  # @param is_upgrade [::Boolean]
1039
1049
  # Optional. If true, generate the resources for upgrade only. Some resources
1040
1050
  # generated only for installation (e.g. secrets) will be excluded.
@@ -1123,9 +1133,9 @@ module Google
1123
1133
  # * (`String`) The path to a service account key file in JSON format
1124
1134
  # * (`Hash`) A service account key as a Hash
1125
1135
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1126
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1136
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1127
1137
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1128
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1138
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1129
1139
  # * (`nil`) indicating no credentials
1130
1140
  # @return [::Object]
1131
1141
  # @!attribute [rw] scope
@@ -411,9 +411,9 @@ module Google
411
411
  # * (`String`) The path to a service account key file in JSON format
412
412
  # * (`Hash`) A service account key as a Hash
413
413
  # * (`Google::Auth::Credentials`) A googleauth credentials object
414
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
414
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
415
415
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
416
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
416
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
417
417
  # * (`nil`) indicating no credentials
418
418
  # @return [::Object]
419
419
  # @!attribute [rw] scope
@@ -41,7 +41,10 @@ module Google
41
41
  # * {::Google::Cloud::GkeHub::V1::Membership Membership}
42
42
  # * {::Google::Cloud::GkeHub::V1::Feature Feature}
43
43
  #
44
- # GKE Hub is currently only available in the global region.
44
+ # GKE Hub is currently available in the global region and all regions in
45
+ # https://cloud.google.com/compute/docs/regions-zones. Feature is only
46
+ # available in global region while membership is global region and all the
47
+ # regions.
45
48
  #
46
49
  # **Membership management may be non-trivial:** it is recommended to use one
47
50
  # of the Google-provided client libraries or tools where possible when working
@@ -42,7 +42,10 @@ module Google
42
42
  # * {::Google::Cloud::GkeHub::V1::Membership Membership}
43
43
  # * {::Google::Cloud::GkeHub::V1::Feature Feature}
44
44
  #
45
- # GKE Hub is currently only available in the global region.
45
+ # GKE Hub is currently available in the global region and all regions in
46
+ # https://cloud.google.com/compute/docs/regions-zones. Feature is only
47
+ # available in global region while membership is global region and all the
48
+ # regions.
46
49
  #
47
50
  # **Membership management may be non-trivial:** it is recommended to use one
48
51
  # of the Google-provided client libraries or tools where possible when working
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module GkeHub
23
23
  module V1
24
- VERSION = "0.4.0"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -21,6 +21,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
21
21
  optional :last_connection_time, :message, 10, "google.protobuf.Timestamp"
22
22
  optional :unique_id, :string, 11
23
23
  optional :authority, :message, 12, "google.cloud.gkehub.v1.Authority"
24
+ optional :monitoring_config, :message, 14, "google.cloud.gkehub.v1.MonitoringConfig"
24
25
  oneof :type do
25
26
  optional :endpoint, :message, 4, "google.cloud.gkehub.v1.MembershipEndpoint"
26
27
  end
@@ -29,6 +30,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
29
30
  optional :gke_cluster, :message, 1, "google.cloud.gkehub.v1.GkeCluster"
30
31
  optional :kubernetes_metadata, :message, 2, "google.cloud.gkehub.v1.KubernetesMetadata"
31
32
  optional :kubernetes_resource, :message, 3, "google.cloud.gkehub.v1.KubernetesResource"
33
+ optional :google_managed, :bool, 8
32
34
  end
33
35
  add_message "google.cloud.gkehub.v1.KubernetesResource" do
34
36
  optional :membership_cr_manifest, :string, 1
@@ -47,6 +49,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
47
49
  end
48
50
  add_message "google.cloud.gkehub.v1.GkeCluster" do
49
51
  optional :resource_link, :string, 1
52
+ optional :cluster_missing, :bool, 2
50
53
  end
51
54
  add_message "google.cloud.gkehub.v1.KubernetesMetadata" do
52
55
  optional :kubernetes_api_server_version, :string, 1
@@ -56,6 +59,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
56
59
  optional :memory_mb, :int32, 5
57
60
  optional :update_time, :message, 100, "google.protobuf.Timestamp"
58
61
  end
62
+ add_message "google.cloud.gkehub.v1.MonitoringConfig" do
63
+ optional :project_id, :string, 1
64
+ optional :location, :string, 2
65
+ optional :cluster, :string, 3
66
+ optional :kubernetes_metrics_prefix, :string, 4
67
+ optional :cluster_hash, :string, 5
68
+ end
59
69
  add_message "google.cloud.gkehub.v1.MembershipState" do
60
70
  optional :code, :enum, 1, "google.cloud.gkehub.v1.MembershipState.Code"
61
71
  end
@@ -87,6 +97,7 @@ module Google
87
97
  ResourceManifest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.ResourceManifest").msgclass
88
98
  GkeCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.GkeCluster").msgclass
89
99
  KubernetesMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.KubernetesMetadata").msgclass
100
+ MonitoringConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.MonitoringConfig").msgclass
90
101
  MembershipState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.MembershipState").msgclass
91
102
  MembershipState::Code = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.MembershipState.Code").enummodule
92
103
  Authority = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1.Authority").msgclass
@@ -10,6 +10,7 @@ require 'google/api/resource_pb'
10
10
  require 'google/cloud/gkehub/v1/feature_pb'
11
11
  require 'google/cloud/gkehub/v1/membership_pb'
12
12
  require 'google/longrunning/operations_pb'
13
+ require 'google/protobuf/empty_pb'
13
14
  require 'google/protobuf/field_mask_pb'
14
15
  require 'google/protobuf/timestamp_pb'
15
16
 
@@ -39,6 +40,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
39
40
  add_message "google.cloud.gkehub.v1.DeleteMembershipRequest" do
40
41
  optional :name, :string, 1
41
42
  optional :request_id, :string, 2
43
+ optional :force, :bool, 3
42
44
  end
43
45
  add_message "google.cloud.gkehub.v1.UpdateMembershipRequest" do
44
46
  optional :name, :string, 1
@@ -33,7 +33,10 @@ module Google
33
33
  # * [Membership][google.cloud.gkehub.v1.Membership]
34
34
  # * [Feature][google.cloud.gkehub.v1.Feature]
35
35
  #
36
- # GKE Hub is currently only available in the global region.
36
+ # GKE Hub is currently available in the global region and all regions in
37
+ # https://cloud.google.com/compute/docs/regions-zones. Feature is only
38
+ # available in global region while membership is global region and all the
39
+ # regions.
37
40
  #
38
41
  # **Membership management may be non-trivial:** it is recommended to use one
39
42
  # of the Google-provided client libraries or tools where possible when working
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
203
209
  # @!attribute [rw] common
204
210
  # @return [::Google::Api::CommonLanguageSettings]
205
211
  # Some settings.
212
+ # @!attribute [rw] renamed_services
213
+ # @return [::Google::Protobuf::Map{::String => ::String}]
214
+ # Map from original service names to renamed versions.
215
+ # This is used when the default generated types
216
+ # would cause a naming conflict. (Neither name is
217
+ # fully-qualified.)
218
+ # Example: Subscriber to SubscriberServiceApi.
219
+ # @!attribute [rw] renamed_resources
220
+ # @return [::Google::Protobuf::Map{::String => ::String}]
221
+ # Map from full resource types to the effective short name
222
+ # for the resource. This is used when otherwise resource
223
+ # named from different services would cause naming collisions.
224
+ # Example entry:
225
+ # "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
226
+ # @!attribute [rw] ignored_resources
227
+ # @return [::Array<::String>]
228
+ # List of full resource types to ignore during generation.
229
+ # This is typically used for API-specific Location resources,
230
+ # which should be handled by the generator as if they were actually
231
+ # the common Location resources.
232
+ # Example entry: "documentai.googleapis.com/Location"
233
+ # @!attribute [rw] forced_namespace_aliases
234
+ # @return [::Array<::String>]
235
+ # Namespaces which must be aliased in snippets due to
236
+ # a known (but non-generator-predictable) naming collision
237
+ # @!attribute [rw] handwritten_signatures
238
+ # @return [::Array<::String>]
239
+ # Method signatures (in the form "service.method(signature)")
240
+ # which are provided separately, so shouldn't be generated.
241
+ # Snippets *calling* these methods are still generated, however.
206
242
  class DotnetSettings
207
243
  include ::Google::Protobuf::MessageExts
208
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
245
+
246
+ # @!attribute [rw] key
247
+ # @return [::String]
248
+ # @!attribute [rw] value
249
+ # @return [::String]
250
+ class RenamedServicesEntry
251
+ include ::Google::Protobuf::MessageExts
252
+ extend ::Google::Protobuf::MessageExts::ClassMethods
253
+ end
254
+
255
+ # @!attribute [rw] key
256
+ # @return [::String]
257
+ # @!attribute [rw] value
258
+ # @return [::String]
259
+ class RenamedResourcesEntry
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
209
263
  end
210
264
 
211
265
  # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
240
294
  # Example of a YAML configuration::
241
295
  #
242
296
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
297
+ # method_settings:
298
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
299
  # long_running:
246
300
  # initial_poll_delay:
247
301
  # seconds: 60 # 1 minute
@@ -27,8 +27,9 @@ module Google
27
27
  # Optional. Endpoint information to reach this member.
28
28
  # @!attribute [r] name
29
29
  # @return [::String]
30
- # Output only. The full, unique name of this Membership resource in the format
31
- # `projects/*/locations/*/memberships/{membership_id}`, set during creation.
30
+ # Output only. The full, unique name of this Membership resource in the
31
+ # format `projects/*/locations/*/memberships/{membership_id}`, set during
32
+ # creation.
32
33
  #
33
34
  # `membership_id` must be a valid RFC 1123 compliant DNS label:
34
35
  #
@@ -40,7 +41,7 @@ module Google
40
41
  # with a maximum length of 63 characters.
41
42
  # @!attribute [rw] labels
42
43
  # @return [::Google::Protobuf::Map{::String => ::String}]
43
- # Optional. GCP labels for this membership.
44
+ # Optional. Labels for this membership.
44
45
  # @!attribute [r] description
45
46
  # @return [::String]
46
47
  # Output only. Description of this membership, limited to 63 characters.
@@ -61,8 +62,8 @@ module Google
61
62
  # Output only. When the Membership was deleted.
62
63
  # @!attribute [rw] external_id
63
64
  # @return [::String]
64
- # Optional. An externally-generated and managed ID for this Membership. This ID may
65
- # be modified after creation, but this is not recommended.
65
+ # Optional. An externally-generated and managed ID for this Membership. This
66
+ # ID may be modified after creation, but this is not recommended.
66
67
  #
67
68
  # The ID must match the regex: `[a-zA-Z0-9][a-zA-Z0-9_\-\.]*`
68
69
  #
@@ -70,20 +71,24 @@ module Google
70
71
  # set to the UID of the `kube-system` namespace object.
71
72
  # @!attribute [r] last_connection_time
72
73
  # @return [::Google::Protobuf::Timestamp]
73
- # Output only. For clusters using Connect, the timestamp of the most recent connection
74
- # established with Google Cloud. This time is updated every several minutes,
75
- # not continuously. For clusters that do not use GKE Connect, or that have
76
- # never connected successfully, this field will be unset.
74
+ # Output only. For clusters using Connect, the timestamp of the most recent
75
+ # connection established with Google Cloud. This time is updated every
76
+ # several minutes, not continuously. For clusters that do not use GKE
77
+ # Connect, or that have never connected successfully, this field will be
78
+ # unset.
77
79
  # @!attribute [r] unique_id
78
80
  # @return [::String]
79
- # Output only. Google-generated UUID for this resource. This is unique across all
80
- # Membership resources. If a Membership resource is deleted and another
81
+ # Output only. Google-generated UUID for this resource. This is unique across
82
+ # all Membership resources. If a Membership resource is deleted and another
81
83
  # resource with the same name is created, it gets a different unique_id.
82
84
  # @!attribute [rw] authority
83
85
  # @return [::Google::Cloud::GkeHub::V1::Authority]
84
86
  # Optional. How to identify workloads from this Membership.
85
87
  # See the documentation on Workload Identity for more details:
86
88
  # https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
89
+ # @!attribute [rw] monitoring_config
90
+ # @return [::Google::Cloud::GkeHub::V1::MonitoringConfig]
91
+ # Optional. The monitoring config information for this membership.
87
92
  class Membership
88
93
  include ::Google::Protobuf::MessageExts
89
94
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -108,14 +113,18 @@ module Google
108
113
  # Output only. Useful Kubernetes-specific metadata.
109
114
  # @!attribute [rw] kubernetes_resource
110
115
  # @return [::Google::Cloud::GkeHub::V1::KubernetesResource]
111
- # Optional. The in-cluster Kubernetes Resources that should be applied for a correctly
112
- # registered cluster, in the steady state. These resources:
116
+ # Optional. The in-cluster Kubernetes Resources that should be applied for a
117
+ # correctly registered cluster, in the steady state. These resources:
113
118
  #
114
119
  # * Ensure that the cluster is exclusively registered to one and only one
115
120
  # Hub Membership.
116
121
  # * Propagate Workload Pool Information available in the Membership
117
122
  # Authority field.
118
123
  # * Ensure proper initial configuration of default Hub Features.
124
+ # @!attribute [r] google_managed
125
+ # @return [::Boolean]
126
+ # Output only. Whether the lifecycle of this membership is managed by a
127
+ # google cluster platform service.
119
128
  class MembershipEndpoint
120
129
  include ::Google::Protobuf::MessageExts
121
130
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -126,8 +135,8 @@ module Google
126
135
  # UpdateMembership, these resources should be re-applied in the cluster.
127
136
  # @!attribute [rw] membership_cr_manifest
128
137
  # @return [::String]
129
- # Input only. The YAML representation of the Membership CR. This field is ignored for GKE
130
- # clusters where Hub can read the CR directly.
138
+ # Input only. The YAML representation of the Membership CR. This field is
139
+ # ignored for GKE clusters where Hub can read the CR directly.
131
140
  #
132
141
  # Callers should provide the CR that is currently present in the cluster
133
142
  # during CreateMembership or UpdateMembership, or leave this field empty if
@@ -135,8 +144,8 @@ module Google
135
144
  # registered with another Membership.
136
145
  # @!attribute [r] membership_resources
137
146
  # @return [::Array<::Google::Cloud::GkeHub::V1::ResourceManifest>]
138
- # Output only. Additional Kubernetes resources that need to be applied to the cluster
139
- # after Membership creation, and after every update.
147
+ # Output only. Additional Kubernetes resources that need to be applied to the
148
+ # cluster after Membership creation, and after every update.
140
149
  #
141
150
  # This field is only populated in the Membership returned from a successful
142
151
  # long-running operation from CreateMembership or UpdateMembership. It is not
@@ -163,9 +172,9 @@ module Google
163
172
  # ResourceOptions represent options for Kubernetes resource generation.
164
173
  # @!attribute [rw] connect_version
165
174
  # @return [::String]
166
- # Optional. The Connect agent version to use for connect_resources. Defaults to the
167
- # latest GKE Connect version. The version must be a currently supported
168
- # version, obsolete versions will be rejected.
175
+ # Optional. The Connect agent version to use for connect_resources. Defaults
176
+ # to the latest GKE Connect version. The version must be a currently
177
+ # supported version, obsolete versions will be rejected.
169
178
  # @!attribute [rw] v1beta1_crd
170
179
  # @return [::Boolean]
171
180
  # Optional. Use `apiextensions/v1beta1` instead of `apiextensions/v1` for
@@ -174,8 +183,8 @@ module Google
174
183
  # <1.16.
175
184
  # @!attribute [rw] k8s_version
176
185
  # @return [::String]
177
- # Optional. Major version of the Kubernetes cluster. This is only used to determine
178
- # which version to use for the CustomResourceDefinition resources,
186
+ # Optional. Major version of the Kubernetes cluster. This is only used to
187
+ # determine which version to use for the CustomResourceDefinition resources,
179
188
  # `apiextensions/v1beta1` or`apiextensions/v1`.
180
189
  class ResourceOptions
181
190
  include ::Google::Protobuf::MessageExts
@@ -202,11 +211,16 @@ module Google
202
211
  # GkeCluster contains information specific to GKE clusters.
203
212
  # @!attribute [rw] resource_link
204
213
  # @return [::String]
205
- # Immutable. Self-link of the GCP resource for the GKE cluster. For example:
214
+ # Immutable. Self-link of the Google Cloud resource for the GKE cluster. For
215
+ # example:
206
216
  #
207
217
  # //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
208
218
  #
209
219
  # Zonal clusters are also supported.
220
+ # @!attribute [r] cluster_missing
221
+ # @return [::Boolean]
222
+ # Output only. If cluster_missing is set then it denotes that the GKE cluster
223
+ # no longer exists in the GKE Control Plane.
210
224
  class GkeCluster
211
225
  include ::Google::Protobuf::MessageExts
212
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -216,12 +230,13 @@ module Google
216
230
  # representing Kubernetes clusters.
217
231
  # @!attribute [r] kubernetes_api_server_version
218
232
  # @return [::String]
219
- # Output only. Kubernetes API server version string as reported by `/version`.
233
+ # Output only. Kubernetes API server version string as reported by
234
+ # `/version`.
220
235
  # @!attribute [r] node_provider_id
221
236
  # @return [::String]
222
- # Output only. Node providerID as reported by the first node in the list of nodes on
223
- # the Kubernetes endpoint. On Kubernetes platforms that support zero-node
224
- # clusters (like GKE-on-GCP), the node_count will be zero and the
237
+ # Output only. Node providerID as reported by the first node in the list of
238
+ # nodes on the Kubernetes endpoint. On Kubernetes platforms that support
239
+ # zero-node clusters (like GKE-on-GCP), the node_count will be zero and the
225
240
  # node_provider_id will be empty.
226
241
  # @!attribute [r] node_count
227
242
  # @return [::Integer]
@@ -231,18 +246,50 @@ module Google
231
246
  # Output only. vCPU count as reported by Kubernetes nodes resources.
232
247
  # @!attribute [r] memory_mb
233
248
  # @return [::Integer]
234
- # Output only. The total memory capacity as reported by the sum of all Kubernetes nodes
235
- # resources, defined in MB.
249
+ # Output only. The total memory capacity as reported by the sum of all
250
+ # Kubernetes nodes resources, defined in MB.
236
251
  # @!attribute [r] update_time
237
252
  # @return [::Google::Protobuf::Timestamp]
238
- # Output only. The time at which these details were last updated. This update_time is
239
- # different from the Membership-level update_time since EndpointDetails are
240
- # updated internally for API consumers.
253
+ # Output only. The time at which these details were last updated. This
254
+ # update_time is different from the Membership-level update_time since
255
+ # EndpointDetails are updated internally for API consumers.
241
256
  class KubernetesMetadata
242
257
  include ::Google::Protobuf::MessageExts
243
258
  extend ::Google::Protobuf::MessageExts::ClassMethods
244
259
  end
245
260
 
261
+ # This field informs Fleet-based applications/services/UIs with the necessary
262
+ # information for where each underlying Cluster reports its metrics.
263
+ # @!attribute [rw] project_id
264
+ # @return [::String]
265
+ # Immutable. Project used to report Metrics
266
+ # @!attribute [rw] location
267
+ # @return [::String]
268
+ # Immutable. Location used to report Metrics
269
+ # @!attribute [rw] cluster
270
+ # @return [::String]
271
+ # Immutable. Cluster name used to report metrics.
272
+ # For Anthos on VMWare/Baremetal, it would be in format
273
+ # `memberClusters/cluster_name`; And for Anthos on MultiCloud, it would be in
274
+ # format
275
+ # `{azureClusters, awsClusters}/cluster_name`.
276
+ # @!attribute [rw] kubernetes_metrics_prefix
277
+ # @return [::String]
278
+ # Kubernetes system metrics, if available, are written to this prefix.
279
+ # This defaults to kubernetes.io for GKE, and kubernetes.io/anthos for Anthos
280
+ # eventually. Noted: Anthos MultiCloud will have kubernetes.io prefix today
281
+ # but will migration to be under kubernetes.io/anthos
282
+ # @!attribute [rw] cluster_hash
283
+ # @return [::String]
284
+ # Immutable. Cluster hash, this is a unique string generated by google code,
285
+ # which does not contain any PII, which we can use to reference the cluster.
286
+ # This is expected to be created by the monitoring stack and persisted into
287
+ # the Cluster object as well as to GKE-Hub.
288
+ class MonitoringConfig
289
+ include ::Google::Protobuf::MessageExts
290
+ extend ::Google::Protobuf::MessageExts::ClassMethods
291
+ end
292
+
246
293
  # MembershipState describes the state of a Membership resource.
247
294
  # @!attribute [r] code
248
295
  # @return [::Google::Cloud::GkeHub::V1::MembershipState::Code]
@@ -278,8 +325,8 @@ module Google
278
325
  # https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
279
326
  # @!attribute [rw] issuer
280
327
  # @return [::String]
281
- # Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with `https://` and
282
- # be a valid URL with length <2000 characters.
328
+ # Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with
329
+ # `https://` and be a valid URL with length <2000 characters.
283
330
  #
284
331
  # If set, then Google will allow valid OIDC tokens from this issuer to
285
332
  # authenticate within the workload_identity_pool. OIDC discovery will be
@@ -290,8 +337,8 @@ module Google
290
337
  # a new issuer (and re-enabling Workload Identity).
291
338
  # @!attribute [r] workload_identity_pool
292
339
  # @return [::String]
293
- # Output only. The name of the workload identity pool in which `issuer` will be
294
- # recognized.
340
+ # Output only. The name of the workload identity pool in which `issuer` will
341
+ # be recognized.
295
342
  #
296
343
  # There is a single Workload Identity Pool per Hub that is shared
297
344
  # between all Memberships that belong to that Hub. For a Hub hosted in
@@ -299,11 +346,12 @@ module Google
299
346
  # although this is subject to change in newer versions of this API.
300
347
  # @!attribute [r] identity_provider
301
348
  # @return [::String]
302
- # Output only. An identity provider that reflects the `issuer` in the workload identity
303
- # pool.
349
+ # Output only. An identity provider that reflects the `issuer` in the
350
+ # workload identity pool.
304
351
  # @!attribute [rw] oidc_jwks
305
352
  # @return [::String]
306
- # Optional. OIDC verification keys for this Membership in JWKS format (RFC 7517).
353
+ # Optional. OIDC verification keys for this Membership in JWKS format (RFC
354
+ # 7517).
307
355
  #
308
356
  # When this field is set, OIDC discovery will NOT be performed on `issuer`,
309
357
  # and instead OIDC tokens will be validated using this field.
@@ -24,13 +24,14 @@ module Google
24
24
  # Request message for `GkeHub.ListMemberships` method.
25
25
  # @!attribute [rw] parent
26
26
  # @return [::String]
27
- # Required. The parent (project and location) where the Memberships will be listed.
28
- # Specified in the format `projects/*/locations/*`.
27
+ # Required. The parent (project and location) where the Memberships will be
28
+ # listed. Specified in the format `projects/*/locations/*`.
29
+ # `projects/*/locations/-` list memberships in all the regions.
29
30
  # @!attribute [rw] page_size
30
31
  # @return [::Integer]
31
- # Optional. When requesting a 'page' of resources, `page_size` specifies number of
32
- # resources to return. If unspecified or set to 0, all resources will
33
- # be returned.
32
+ # Optional. When requesting a 'page' of resources, `page_size` specifies
33
+ # number of resources to return. If unspecified or set to 0, all resources
34
+ # will be returned.
34
35
  # @!attribute [rw] page_token
35
36
  # @return [::String]
36
37
  # Optional. Token returned by previous call to `ListMemberships` which
@@ -38,8 +39,8 @@ module Google
38
39
  # resources.
39
40
  # @!attribute [rw] filter
40
41
  # @return [::String]
41
- # Optional. Lists Memberships that match the filter expression, following the syntax
42
- # outlined in https://google.aip.dev/160.
42
+ # Optional. Lists Memberships that match the filter expression, following the
43
+ # syntax outlined in https://google.aip.dev/160.
43
44
  #
44
45
  # Examples:
45
46
  #
@@ -97,12 +98,12 @@ module Google
97
98
  # Request message for the `GkeHub.CreateMembership` method.
98
99
  # @!attribute [rw] parent
99
100
  # @return [::String]
100
- # Required. The parent (project and location) where the Memberships will be created.
101
- # Specified in the format `projects/*/locations/*`.
101
+ # Required. The parent (project and location) where the Memberships will be
102
+ # created. Specified in the format `projects/*/locations/*`.
102
103
  # @!attribute [rw] membership_id
103
104
  # @return [::String]
104
- # Required. Client chosen ID for the membership. `membership_id` must be a valid RFC
105
- # 1123 compliant DNS label:
105
+ # Required. Client chosen ID for the membership. `membership_id` must be a
106
+ # valid RFC 1123 compliant DNS label:
106
107
  #
107
108
  # 1. At most 63 characters in length
108
109
  # 2. It must consist of lower case alphanumeric characters or `-`
@@ -153,6 +154,11 @@ module Google
153
154
  #
154
155
  # The request ID must be a valid UUID with the exception that zero UUID is
155
156
  # not supported (00000000-0000-0000-0000-000000000000).
157
+ # @!attribute [rw] force
158
+ # @return [::Boolean]
159
+ # Optional. If set to true, any subresource from this Membership will also be
160
+ # deleted. Otherwise, the request will only work if the Membership has no
161
+ # subresource.
156
162
  class DeleteMembershipRequest
157
163
  include ::Google::Protobuf::MessageExts
158
164
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -201,25 +207,27 @@ module Google
201
207
  # .
202
208
  # @!attribute [rw] name
203
209
  # @return [::String]
204
- # Required. The Membership resource name the Agent will associate with, in the format
205
- # `projects/*/locations/*/memberships/*`.
210
+ # Required. The Membership resource name the Agent will associate with, in
211
+ # the format `projects/*/locations/*/memberships/*`.
206
212
  # @!attribute [rw] namespace
207
213
  # @return [::String]
208
- # Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`.
214
+ # Optional. Namespace for GKE Connect agent resources. Defaults to
215
+ # `gke-connect`.
209
216
  #
210
217
  # The Connect Agent is authorized automatically when run in the default
211
218
  # namespace. Otherwise, explicit authorization must be granted with an
212
219
  # additional IAM binding.
213
220
  # @!attribute [rw] proxy
214
221
  # @return [::String]
215
- # Optional. URI of a proxy if connectivity from the agent to gkeconnect.googleapis.com
216
- # requires the use of a proxy. Format must be in the form
217
- # `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
222
+ # Optional. URI of a proxy if connectivity from the agent to
223
+ # gkeconnect.googleapis.com requires the use of a proxy. Format must be in
224
+ # the form `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
218
225
  # supported by the proxy. This will direct the connect agent's outbound
219
226
  # traffic through a HTTP(S) proxy.
220
227
  # @!attribute [rw] version
221
228
  # @return [::String]
222
- # Optional. The Connect agent version to use. Defaults to the most current version.
229
+ # Optional. The Connect agent version to use. Defaults to the most current
230
+ # version.
223
231
  # @!attribute [rw] is_upgrade
224
232
  # @return [::Boolean]
225
233
  # Optional. If true, generate the resources for upgrade only. Some resources
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-gke_hub-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-03-08 00:00:00.000000000 Z
11
+ date: 2023-04-21 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common