google-apis-gkehub_v1alpha 0.9.0 → 0.13.0

data/lib/google/apis/gkehub_v1alpha/service.rb

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module GkehubV1alpha
-      # GKE Hub
+      # GKE Hub API
       #
       # 
       #
@@ -462,6 +462,200 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # 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.
+        # @param [String] parent
+        #   Required. The parent (project and location) where the Memberships will be
+        #   created. Specified in the format `projects/*/locations/*`.
+        # @param [Google::Apis::GkehubV1alpha::Membership] membership_object
+        # @param [String] membership_id
+        #   Required. Client chosen ID for the membership. `membership_id` must be a valid
+        #   RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must
+        #   consist of lower case alphanumeric characters or `-` 3. It must start and end
+        #   with an alphanumeric character Which can be expressed as the regex: `[a-z0-9]([
+        #   -a-z0-9]*[a-z0-9])?`, with a maximum length of 63 characters.
+        # @param [String] request_id
+        #   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).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_project_location_membership(parent, membership_object = nil, membership_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+parent}/memberships', options)
+          command.request_representation = Google::Apis::GkehubV1alpha::Membership::Representation
+          command.request_object = membership_object
+          command.response_representation = Google::Apis::GkehubV1alpha::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['membershipId'] = membership_id unless membership_id.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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.
+        # @param [String] name
+        #   Required. The Membership resource name in the format `projects/*/locations/*/
+        #   memberships/*`.
+        # @param [String] request_id
+        #   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).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project_location_membership(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::GkehubV1alpha::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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.
+        # @param [String] name
+        #   Required. The Membership resource name the Agent will associate with, in the
+        #   format `projects/*/locations/*/memberships/*`.
+        # @param [String] image_pull_secret_content
+        #   Optional. The image pull secret content for the registry, if not public.
+        # @param [Boolean] is_upgrade
+        #   Optional. If true, generate the resources for upgrade only. Some resources
+        #   generated only for installation (e.g. secrets) will be excluded.
+        # @param [String] namespace
+        #   Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`.
+        #   The Connect Agent is authorized automatically when run in the default
+        #   namespace. Otherwise, explicit authorization must be granted with an
+        #   additional IAM binding.
+        # @param [String] proxy
+        #   Optional. URI of a proxy if connectivity from the agent to gkeconnect.
+        #   googleapis.com requires the use of a proxy. Format must be in the form `http(s)
+        #   ://`proxy_address``, depending on the HTTP/HTTPS protocol supported by the
+        #   proxy. This will direct the connect agent's outbound traffic through a HTTP(S)
+        #   proxy.
+        # @param [String] registry
+        #   Optional. The registry to fetch the connect agent image from. Defaults to gcr.
+        #   io/gkeconnect.
+        # @param [String] version
+        #   Optional. The Connect agent version to use. Defaults to the most current
+        #   version.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::GenerateConnectManifestResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::GenerateConnectManifestResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def generate_project_location_membership_connect_manifest(name, image_pull_secret_content: nil, is_upgrade: nil, namespace: nil, proxy: nil, registry: nil, version: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+name}:generateConnectManifest', options)
+          command.response_representation = Google::Apis::GkehubV1alpha::GenerateConnectManifestResponse::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::GenerateConnectManifestResponse
+          command.params['name'] = name unless name.nil?
+          command.query['imagePullSecretContent'] = image_pull_secret_content unless image_pull_secret_content.nil?
+          command.query['isUpgrade'] = is_upgrade unless is_upgrade.nil?
+          command.query['namespace'] = namespace unless namespace.nil?
+          command.query['proxy'] = proxy unless proxy.nil?
+          command.query['registry'] = registry unless registry.nil?
+          command.query['version'] = version unless version.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the details of a Membership.
+        # @param [String] name
+        #   Required. The Membership resource name in the format `projects/*/locations/*/
+        #   memberships/*`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::Membership] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::Membership]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_membership(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::GkehubV1alpha::Membership::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::Membership
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the access control policy for a resource. Returns an empty policy if the
         # resource exists and does not have a policy set.
         # @param [String] resource
@@ -503,6 +697,156 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists Memberships in a given project and location.
+        # @param [String] parent
+        #   Required. The parent (project and location) where the Memberships will be
+        #   listed. Specified in the format `projects/*/locations/*`.
+        # @param [String] filter
+        #   Optional. Lists Memberships that match the filter expression, following the
+        #   syntax outlined in https://google.aip.dev/160. Examples: - Name is `bar` in
+        #   project `foo-proj` and location `global`: name = "projects/foo-proj/locations/
+        #   global/membership/bar" - Memberships that have a label called `foo`: labels.
+        #   foo:* - Memberships that have a label called `foo` whose value is `bar`:
+        #   labels.foo = bar - Memberships in the CREATING state: state = CREATING
+        # @param [String] order_by
+        #   Optional. One or more fields to compare and use to sort the output. See https:/
+        #   /google.aip.dev/132#ordering.
+        # @param [Fixnum] page_size
+        #   Optional. When requesting a 'page' of resources, `page_size` specifies number
+        #   of resources to return. If unspecified or set to 0, all resources will be
+        #   returned.
+        # @param [String] page_token
+        #   Optional. Token returned by previous call to `ListMemberships` which specifies
+        #   the position in the list from where to continue listing the resources.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::ListMembershipsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::ListMembershipsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_location_memberships(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+parent}/memberships', options)
+          command.response_representation = Google::Apis::GkehubV1alpha::ListMembershipsResponse::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::ListMembershipsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists Memberships of admin clusters in a given project and location. **This
+        # method is only used internally**.
+        # @param [String] parent
+        #   Required. The parent (project and location) where the Memberships of admin
+        #   cluster will be listed. Specified in the format `projects/*/locations/*`.
+        # @param [String] filter
+        #   Optional. Lists Memberships of admin clusters that match the filter expression.
+        # @param [String] order_by
+        #   Optional. One or more fields to compare and use to sort the output. See https:/
+        #   /google.aip.dev/132#ordering.
+        # @param [Fixnum] page_size
+        #   Optional. When requesting a 'page' of resources, `page_size` specifies number
+        #   of resources to return. If unspecified or set to 0, all resources will be
+        #   returned.
+        # @param [String] page_token
+        #   Optional. Token returned by previous call to `ListAdminClusterMemberships`
+        #   which specifies the position in the list from where to continue listing the
+        #   resources.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::ListAdminClusterMembershipsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::ListAdminClusterMembershipsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_location_membership_admin(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+parent}/memberships:listAdmin', options)
+          command.response_representation = Google::Apis::GkehubV1alpha::ListAdminClusterMembershipsResponse::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::ListAdminClusterMembershipsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates an existing Membership.
+        # @param [String] name
+        #   Required. The Membership resource name in the format `projects/*/locations/*/
+        #   memberships/*`.
+        # @param [Google::Apis::GkehubV1alpha::Membership] membership_object
+        # @param [String] request_id
+        #   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).
+        # @param [String] update_mask
+        #   Required. Mask of fields to update.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GkehubV1alpha::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1alpha::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_project_location_membership(name, membership_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1alpha/{+name}', options)
+          command.request_representation = Google::Apis::GkehubV1alpha::Membership::Representation
+          command.request_object = membership_object
+          command.response_representation = Google::Apis::GkehubV1alpha::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1alpha::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
         # PERMISSION_DENIED` errors.

data/lib/google/apis/gkehub_v1alpha.rb

@@ -19,13 +19,13 @@ require 'google/apis/gkehub_v1alpha/gem_version.rb'
 
 module Google
   module Apis
-    # GKE Hub
+    # GKE Hub API
     #
     # 
     #
     # @see https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster
     module GkehubV1alpha
-      # Version of the GKE Hub this client connects to.
+      # Version of the GKE Hub API this client connects to.
       # This is NOT the gem version.
       VERSION = 'V1alpha'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-gkehub_v1alpha
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-09 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -30,12 +30,12 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
-description: This is the simple REST client for GKE Hub V1alpha. Simple REST clients
+description: This is the simple REST client for GKE Hub API V1alpha. Simple REST clients
   are Ruby client libraries that provide access to Google services via their HTTP
   REST API endpoints. These libraries are generated and updated automatically based
   on the discovery documents published by the service, and they handle most concerns
   such as authentication, pagination, retry, timeouts, and logging. You can use this
-  client to access the GKE Hub, but note that some services may provide a separate
+  client to access the GKE Hub API, but note that some services may provide a separate
   modern client that is easier to use.
 email: googleapis-packages@google.com
 executables: []
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-gkehub_v1alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-gkehub_v1alpha/v0.9.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-gkehub_v1alpha
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkehub_v1alpha/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gkehub_v1alpha/v0.13.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkehub_v1alpha
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -78,5 +78,5 @@ requirements: []
 rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
-summary: Simple REST client for GKE Hub V1alpha
+summary: Simple REST client for GKE Hub API V1alpha
 test_files: []