google-cloud-gke_hub-v1beta1 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6839d3339f55e54c697ad5ad2a9f8cb15bad54c7eefe67f9b443f0b4ac5446b0
-  data.tar.gz: 7b302bc97d963d3ed930d4e22563e5c8d1b994c783035e7a544c747a1edfdb0d
+  metadata.gz: 718c4f4e7822f2854e3d0bf972e221f6ee5e25182c8c2e74cca5823e24b562d3
+  data.tar.gz: b23faed4354600da9c06945d353a02704258459722b3632c741c7713c117b96e
 SHA512:
-  metadata.gz: ee11a554ae4fcfa6aba2d3abd3d4926bce69eb34899f3797dd3d3d8dedc86bbca41b304f1ae4ad33a648ce50b58ac6fc8c816a1d657ba9d1d1cd9c561675f55e
-  data.tar.gz: 8112840aeb8d4e1a887d96594b692a7596113f2cd6751f6807608f143b2d0d1d15c7f850b395cbdcba60587a7f3aeb2b16fd3667e50f1e6ccdc215a36051796e
+  metadata.gz: 2d4d122d174189c7ef42318fe7c5154fe75ed8363fa755a850716913db6ff6b4e256658c96dd13c0ab8991ec0118eeed78c95ba688c0fa45c8b4028ed7ec1050
+  data.tar.gz: 8dcd23a1eac1744ba2757f67dc42fa8aee124aff3b804003ba2d703c3304a93bcdb6f2086f3684eb7093d69592f130cd2fcae8757cabca396260097cc8a49fc2

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-gke_hub-v1beta1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Credentials}):
 
-1. `GKE_HUB_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `GKE_HUB_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `GKE_HUB_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GKE_HUB_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/gke_hub/v1beta1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/gke_hub/v1beta1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new d
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/gke_hub/v1beta1"

data/README.md

@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/gke_hub/v1beta1"
 
 client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new
-request = my_create_request
+request = ::Google::Cloud::GkeHub::V1beta1::ListMembershipsRequest.new # (request fields as keyword arguments...)
 response = client.list_memberships request
 ```
 

data/lib/google/cloud/gke_hub/v1beta1/gke_hub_membership_service/client.rb

@@ -27,8 +27,14 @@ module Google
           ##
           # Client for the GkeHubMembershipService service.
           #
-          # GKE Hub CRUD API for the Membership resource.
-          # The Membership service is currently only available in the global location.
+          # The GKE Hub MembershipService handles the registration of many Kubernetes
+          # clusters to Google Cloud, represented with the {::Google::Cloud::GkeHub::V1beta1::Membership Membership} resource.
+          #
+          # GKE Hub is currently only available in the global region.
+          #
+          # **Membership management may be non-trivial:** it is recommended to use one
+          # of the Google-provided client libraries or tools where possible when working
+          # with Membership resources.
           #
           class Client
             include Paths
@@ -42,13 +48,12 @@ module Google
             # See {::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
-            #
-            # To modify the configuration for all GkeHubMembershipService clients:
+            # @example
             #
-            #     ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all GkeHubMembershipService clients
+            #   ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -68,10 +73,7 @@ module Google
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 1.0,
-                max_delay: 10.0,
-                multiplier: 1.3,
-                retry_codes: [14]
+                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -103,19 +105,15 @@ module Google
             ##
             # Create a new GkeHubMembershipService client object.
             #
-            # ## Examples
+            # @example
             #
-            # To create a new GkeHubMembershipService client with the default
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new
             #
-            #     client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new
-            #
-            # To create a new GkeHubMembershipService client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the GkeHubMembershipService client.
             # @yieldparam config [Client::Configuration]
@@ -135,14 +133,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -259,7 +256,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_memberships.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_memberships.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :list_memberships, request, options: options do |response, operation|
@@ -327,7 +326,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_membership.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_membership.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :get_membership, request, options: options do |response, operation|
@@ -339,7 +340,11 @@ module Google
             end
 
             ##
-            # Adds a new Membership.
+            # Creates a new Membership.
+            #
+            # **This is currently only supported for GKE clusters on Google Cloud**.
+            # To register other clusters, follow the instructions at
+            # https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster.
             #
             # @overload create_membership(request, options = nil)
             #   Pass arguments to `create_membership` via a request object, either of type
@@ -351,7 +356,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload create_membership(parent: nil, membership_id: nil, resource: nil)
+            # @overload create_membership(parent: nil, membership_id: nil, resource: nil, request_id: nil)
             #   Pass arguments to `create_membership` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -371,6 +376,20 @@ module Google
             #     with a maximum length of 63 characters.
             #   @param resource [::Google::Cloud::GkeHub::V1beta1::Membership, ::Hash]
             #     Required. The membership to create.
+            #   @param request_id [::String]
+            #     Optional. A request ID to identify requests. Specify a unique request ID
+            #     so that if you must retry your request, the server will know to ignore
+            #     the request if it has already been completed. The server will guarantee
+            #     that for at least 60 minutes after the first request.
+            #
+            #     For example, consider a situation where you make an initial request and
+            #     the request times out. If you make the request again with the same request
+            #     ID, the server can check if original operation with the same request ID
+            #     was received, and if so, will ignore the second request. This prevents
+            #     clients from accidentally creating duplicate commitments.
+            #
+            #     The request ID must be a valid UUID with the exception that zero UUID is
+            #     not supported (00000000-0000-0000-0000-000000000000).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -406,7 +425,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_membership.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_membership.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :create_membership, request, options: options do |response, operation|
@@ -421,6 +442,10 @@ module Google
             ##
             # Removes a Membership.
             #
+            # **This is currently only supported for GKE clusters on Google Cloud**.
+            # To unregister other clusters, follow the instructions at
+            # https://cloud.google.com/anthos/multicluster-management/connect/unregistering-a-cluster.
+            #
             # @overload delete_membership(request, options = nil)
             #   Pass arguments to `delete_membership` via a request object, either of type
             #   {::Google::Cloud::GkeHub::V1beta1::DeleteMembershipRequest} or an equivalent Hash.
@@ -431,7 +456,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload delete_membership(name: nil)
+            # @overload delete_membership(name: nil, request_id: nil)
             #   Pass arguments to `delete_membership` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -439,6 +464,20 @@ module Google
             #   @param name [::String]
             #     Required. The Membership resource name in the format
             #     `projects/*/locations/*/memberships/*`.
+            #   @param request_id [::String]
+            #     Optional. A request ID to identify requests. Specify a unique request ID
+            #     so that if you must retry your request, the server will know to ignore
+            #     the request if it has already been completed. The server will guarantee
+            #     that for at least 60 minutes after the first request.
+            #
+            #     For example, consider a situation where you make an initial request and
+            #     the request times out. If you make the request again with the same request
+            #     ID, the server can check if original operation with the same request ID
+            #     was received, and if so, will ignore the second request. This prevents
+            #     clients from accidentally creating duplicate commitments.
+            #
+            #     The request ID must be a valid UUID with the exception that zero UUID is
+            #     not supported (00000000-0000-0000-0000-000000000000).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -474,7 +513,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_membership.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_membership.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :delete_membership, request, options: options do |response, operation|
@@ -499,7 +540,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload update_membership(name: nil, update_mask: nil, resource: nil)
+            # @overload update_membership(name: nil, update_mask: nil, resource: nil, request_id: nil)
             #   Pass arguments to `update_membership` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -517,6 +558,22 @@ module Google
             #     If you are updating a map field, set the value of a key to null or empty
             #     string to delete the key from the map. It's not possible to update a key's
             #     value to the empty string.
+            #     If you specify the update_mask to be a special path "*", fully replaces all
+            #     user-modifiable fields to match `resource`.
+            #   @param request_id [::String]
+            #     Optional. A request ID to identify requests. Specify a unique request ID
+            #     so that if you must retry your request, the server will know to ignore
+            #     the request if it has already been completed. The server will guarantee
+            #     that for at least 60 minutes after the first request.
+            #
+            #     For example, consider a situation where you make an initial request and
+            #     the request times out. If you make the request again with the same request
+            #     ID, the server can check if original operation with the same request ID
+            #     was received, and if so, will ignore the second request. This prevents
+            #     clients from accidentally creating duplicate commitments.
+            #
+            #     The request ID must be a valid UUID with the exception that zero UUID is
+            #     not supported (00000000-0000-0000-0000-000000000000).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -552,7 +609,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_membership.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_membership.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :update_membership, request, options: options do |response, operation|
@@ -567,6 +626,9 @@ module Google
             ##
             # Generates the manifest for deployment of the GKE connect agent.
             #
+            # **This method is used internally by Google-provided libraries.**
+            # Most clients should not need to call this method directly.
+            #
             # @overload generate_connect_manifest(request, options = nil)
             #   Pass arguments to `generate_connect_manifest` via a request object, either of type
             #   {::Google::Cloud::GkeHub::V1beta1::GenerateConnectManifestRequest} or an equivalent Hash.
@@ -632,7 +694,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.generate_connect_manifest.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.generate_connect_manifest.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :generate_connect_manifest, request, options: options do |response, operation|
@@ -706,7 +770,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.validate_exclusivity.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.validate_exclusivity.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :validate_exclusivity, request, options: options do |response, operation|
@@ -792,7 +858,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.generate_exclusivity_manifest.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.generate_exclusivity_manifest.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @gke_hub_membership_service_stub.call_rpc :generate_exclusivity_manifest, request, options: options do |response, operation|
@@ -816,22 +884,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_memberships
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_memberships.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_memberships.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_memberships to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_memberships.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_memberships.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/gke_hub/v1beta1/gke_hub_membership_service/operations.rb

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -169,7 +169,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_operations.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_operations.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -239,7 +241,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -309,7 +313,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -384,7 +390,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.cancel_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.cancel_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -396,9 +404,9 @@ module Google
             end
 
             ##
-            # Waits for the specified long-running operation until it is done or reaches
-            # at most a specified timeout, returning the latest state.  If the operation
-            # is already done, the latest state is immediately returned.  If the timeout
+            # Waits until the specified long-running operation is done or reaches at most
+            # a specified timeout, returning the latest state.  If the operation is
+            # already done, the latest state is immediately returned.  If the timeout
             # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
             # timeout is used.  If the server does not support this method, it returns
             # `google.rpc.Code.UNIMPLEMENTED`.
@@ -456,7 +464,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.wait_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +491,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_operations
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Longrunning::Operations::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Longrunning::Operations::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_operations to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Longrunning::Operations::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Longrunning::Operations::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/gke_hub/v1beta1/gke_hub_membership_service.rb

@@ -32,8 +32,14 @@ module Google
     module GkeHub
       module V1beta1
         ##
-        # GKE Hub CRUD API for the Membership resource.
-        # The Membership service is currently only available in the global location.
+        # The GKE Hub MembershipService handles the registration of many Kubernetes
+        # clusters to Google Cloud, represented with the {::Google::Cloud::GkeHub::V1beta1::Membership Membership} resource.
+        #
+        # GKE Hub is currently only available in the global region.
+        #
+        # **Membership management may be non-trivial:** it is recommended to use one
+        # of the Google-provided client libraries or tools where possible when working
+        # with Membership resources.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/gke_hub/v1beta1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module GkeHub
       module V1beta1
-        VERSION = "0.1.0"
+        VERSION = "0.2.0"
       end
     end
   end

data/lib/google/cloud/gkehub/v1beta1/membership_pb.rb

@@ -36,9 +36,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :MULTI_CLOUD, 2
     end
     add_message "google.cloud.gkehub.v1beta1.MembershipEndpoint" do
-      optional :gke_cluster, :message, 4, "google.cloud.gkehub.v1beta1.GkeCluster"
       optional :kubernetes_metadata, :message, 5, "google.cloud.gkehub.v1beta1.KubernetesMetadata"
       optional :kubernetes_resource, :message, 6, "google.cloud.gkehub.v1beta1.KubernetesResource"
+      oneof :type do
+        optional :gke_cluster, :message, 4, "google.cloud.gkehub.v1beta1.GkeCluster"
+        optional :on_prem_cluster, :message, 7, "google.cloud.gkehub.v1beta1.OnPremCluster"
+        optional :multi_cloud_cluster, :message, 8, "google.cloud.gkehub.v1beta1.MultiCloudCluster"
+      end
     end
     add_message "google.cloud.gkehub.v1beta1.KubernetesResource" do
       optional :membership_cr_manifest, :string, 1
@@ -56,6 +60,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.gkehub.v1beta1.GkeCluster" do
       optional :resource_link, :string, 1
+      optional :cluster_missing, :bool, 3
+    end
+    add_message "google.cloud.gkehub.v1beta1.OnPremCluster" do
+      optional :resource_link, :string, 1
+      optional :cluster_missing, :bool, 2
+      optional :admin_cluster, :bool, 3
+    end
+    add_message "google.cloud.gkehub.v1beta1.MultiCloudCluster" do
+      optional :resource_link, :string, 1
+      optional :cluster_missing, :bool, 2
     end
     add_message "google.cloud.gkehub.v1beta1.KubernetesMetadata" do
       optional :kubernetes_api_server_version, :string, 1
@@ -103,14 +117,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :membership_id, :string, 2
       optional :resource, :message, 3, "google.cloud.gkehub.v1beta1.Membership"
+      optional :request_id, :string, 4
     end
     add_message "google.cloud.gkehub.v1beta1.DeleteMembershipRequest" do
       optional :name, :string, 1
+      optional :request_id, :string, 4
     end
     add_message "google.cloud.gkehub.v1beta1.UpdateMembershipRequest" do
       optional :name, :string, 1
       optional :update_mask, :message, 2, "google.protobuf.FieldMask"
       optional :resource, :message, 3, "google.cloud.gkehub.v1beta1.Membership"
+      optional :request_id, :string, 4
     end
     add_message "google.cloud.gkehub.v1beta1.GenerateConnectManifestRequest" do
       optional :name, :string, 1
@@ -176,6 +193,8 @@ module Google
         ResourceOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.ResourceOptions").msgclass
         ResourceManifest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.ResourceManifest").msgclass
         GkeCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.GkeCluster").msgclass
+        OnPremCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.OnPremCluster").msgclass
+        MultiCloudCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.MultiCloudCluster").msgclass
         KubernetesMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.KubernetesMetadata").msgclass
         Authority = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.Authority").msgclass
         MembershipState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.gkehub.v1beta1.MembershipState").msgclass

data/lib/google/cloud/gkehub/v1beta1/membership_services_pb.rb

@@ -24,8 +24,14 @@ module Google
     module GkeHub
       module V1beta1
         module GkeHubMembershipService
-          # GKE Hub CRUD API for the Membership resource.
-          # The Membership service is currently only available in the global location.
+          # The GKE Hub MembershipService handles the registration of many Kubernetes
+          # clusters to Google Cloud, represented with the [Membership][google.cloud.gkehub.v1beta1.Membership] resource.
+          #
+          # GKE Hub is currently only available in the global region.
+          #
+          # **Membership management may be non-trivial:** it is recommended to use one
+          # of the Google-provided client libraries or tools where possible when working
+          # with Membership resources.
           class Service
 
             include GRPC::GenericService
@@ -38,13 +44,24 @@ module Google
             rpc :ListMemberships, ::Google::Cloud::GkeHub::V1beta1::ListMembershipsRequest, ::Google::Cloud::GkeHub::V1beta1::ListMembershipsResponse
             # Gets the details of a Membership.
             rpc :GetMembership, ::Google::Cloud::GkeHub::V1beta1::GetMembershipRequest, ::Google::Cloud::GkeHub::V1beta1::Membership
-            # Adds a new Membership.
+            # Creates a new Membership.
+            #
+            # **This is currently only supported for GKE clusters on Google Cloud**.
+            # To register other clusters, follow the instructions at
+            # https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster.
             rpc :CreateMembership, ::Google::Cloud::GkeHub::V1beta1::CreateMembershipRequest, ::Google::Longrunning::Operation
             # Removes a Membership.
+            #
+            # **This is currently only supported for GKE clusters on Google Cloud**.
+            # To unregister other clusters, follow the instructions at
+            # https://cloud.google.com/anthos/multicluster-management/connect/unregistering-a-cluster.
             rpc :DeleteMembership, ::Google::Cloud::GkeHub::V1beta1::DeleteMembershipRequest, ::Google::Longrunning::Operation
             # Updates an existing Membership.
             rpc :UpdateMembership, ::Google::Cloud::GkeHub::V1beta1::UpdateMembershipRequest, ::Google::Longrunning::Operation
             # Generates the manifest for deployment of the GKE connect agent.
+            #
+            # **This method is used internally by Google-provided libraries.**
+            # Most clients should not need to call this method directly.
             rpc :GenerateConnectManifest, ::Google::Cloud::GkeHub::V1beta1::GenerateConnectManifestRequest, ::Google::Cloud::GkeHub::V1beta1::GenerateConnectManifestResponse
             # ValidateExclusivity validates the state of exclusivity in the cluster.
             # The validation does not depend on an existing Hub membership resource.

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

data/proto_docs/google/cloud/gkehub/v1beta1/membership.rb

@@ -40,7 +40,7 @@ module Google
         #     Optional. GCP labels for this membership.
         # @!attribute [rw] description
         #   @return [::String]
-        #     Required. Description of this membership, limited to 63 characters.
+        #     Optional. Description of this membership, limited to 63 characters.
         #     Must match the regex: `[a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]*`
         # @!attribute [rw] endpoint
         #   @return [::Google::Cloud::GkeHub::V1beta1::MembershipEndpoint]
@@ -123,7 +123,13 @@ module Google
         # endpoint and any additional Kubernetes metadata.
         # @!attribute [rw] gke_cluster
         #   @return [::Google::Cloud::GkeHub::V1beta1::GkeCluster]
-        #     Optional. GKE-specific information. Only present if this Membership is a GKE cluster.
+        #     Optional. Specific information for a GKE-on-GCP cluster.
+        # @!attribute [rw] on_prem_cluster
+        #   @return [::Google::Cloud::GkeHub::V1beta1::OnPremCluster]
+        #     Optional. Specific information for a GKE On-Prem cluster.
+        # @!attribute [rw] multi_cloud_cluster
+        #   @return [::Google::Cloud::GkeHub::V1beta1::MultiCloudCluster]
+        #     Optional. Specific information for a GKE Multi-Cloud cluster.
         # @!attribute [r] kubernetes_metadata
         #   @return [::Google::Cloud::GkeHub::V1beta1::KubernetesMetadata]
         #     Output only. Useful Kubernetes-specific metadata.
@@ -220,14 +226,56 @@ module Google
         #   @return [::String]
         #     Immutable. Self-link of the GCP resource for the GKE cluster. For example:
         #
-        #     > container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
+        #         //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
         #
         #     Zonal clusters are also supported.
+        # @!attribute [r] cluster_missing
+        #   @return [::Boolean]
+        #     Output only. If cluster_missing is set then it denotes that the GKE cluster no longer
+        #     exists in the GKE Control Plane.
         class GkeCluster
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # OnPremCluster contains information specific to GKE On-Prem clusters.
+        # @!attribute [rw] resource_link
+        #   @return [::String]
+        #     Immutable. Self-link of the GCP resource for the GKE On-Prem cluster. For example:
+        #
+        #      //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster
+        #      //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster
+        # @!attribute [r] cluster_missing
+        #   @return [::Boolean]
+        #     Output only. If cluster_missing is set then it denotes that
+        #     API(gkeonprem.googleapis.com) resource for this GKE On-Prem cluster no
+        #     longer exists.
+        # @!attribute [rw] admin_cluster
+        #   @return [::Boolean]
+        #     Immutable. Whether the cluster is an admin cluster.
+        class OnPremCluster
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # MultiCloudCluster contains information specific to GKE Multi-Cloud clusters.
+        # @!attribute [rw] resource_link
+        #   @return [::String]
+        #     Immutable. Self-link of the GCP resource for the GKE Multi-Cloud cluster. For
+        #     example:
+        #
+        #      //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster
+        #      //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster
+        # @!attribute [r] cluster_missing
+        #   @return [::Boolean]
+        #     Output only. If cluster_missing is set then it denotes that
+        #     API(gkemulticloud.googleapis.com) resource for this GKE Multi-Cloud cluster
+        #     no longer exists.
+        class MultiCloudCluster
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # KubernetesMetadata provides informational metadata for Memberships
         # representing Kubernetes clusters.
         # @!attribute [r] kubernetes_api_server_version
@@ -426,6 +474,21 @@ module Google
         # @!attribute [rw] resource
         #   @return [::Google::Cloud::GkeHub::V1beta1::Membership]
         #     Required. The membership to create.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server will know to ignore
+        #     the request if it has already been completed. The server will guarantee
+        #     that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
         class CreateMembershipRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -436,6 +499,21 @@ module Google
         #   @return [::String]
         #     Required. The Membership resource name in the format
         #     `projects/*/locations/*/memberships/*`.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server will know to ignore
+        #     the request if it has already been completed. The server will guarantee
+        #     that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
         class DeleteMembershipRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -458,6 +536,23 @@ module Google
         #     If you are updating a map field, set the value of a key to null or empty
         #     string to delete the key from the map. It's not possible to update a key's
         #     value to the empty string.
+        #     If you specify the update_mask to be a special path "*", fully replaces all
+        #     user-modifiable fields to match `resource`.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server will know to ignore
+        #     the request if it has already been completed. The server will guarantee
+        #     that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
         class UpdateMembershipRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-gke_hub-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-30 00:00:00.000000000 Z
+date: 2021-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -204,7 +210,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the GKE Hub V1beta1 API