google-apis-gkehub_v1beta 0.58.0 → 0.59.0

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

@@ -689,6 +689,205 @@ 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::GkehubV1beta::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::GkehubV1beta::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, 'v1beta/{+parent}/memberships', options)
+          command.request_representation = Google::Apis::GkehubV1beta::Membership::Representation
+          command.request_object = membership_object
+          command.response_representation = Google::Apis::GkehubV1beta::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1beta::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 [Boolean] force
+        #   Optional. If set to true, any subresource from this Membership will also be
+        #   deleted. Otherwise, the request will only work if the Membership has no
+        #   subresource.
+        # @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::GkehubV1beta::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::GkehubV1beta::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1beta::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['force'] = force unless force.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::GkehubV1beta::GenerateConnectManifestResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, 'v1beta/{+name}:generateConnectManifest', options)
+          command.response_representation = Google::Apis::GkehubV1beta::GenerateConnectManifestResponse::Representation
+          command.response_class = Google::Apis::GkehubV1beta::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::GkehubV1beta::Membership] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::GkehubV1beta::Membership::Representation
+          command.response_class = Google::Apis::GkehubV1beta::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
@@ -734,6 +933,108 @@ 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/*`. `projects/*/
+        #   locations/-` list memberships in all the regions.
+        # @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::GkehubV1beta::ListMembershipsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, 'v1beta/{+parent}/memberships', options)
+          command.response_representation = Google::Apis::GkehubV1beta::ListMembershipsResponse::Representation
+          command.response_class = Google::Apis::GkehubV1beta::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
+        
+        # Updates an existing Membership.
+        # @param [String] name
+        #   Required. The Membership resource name in the format `projects/*/locations/*/
+        #   memberships/*`.
+        # @param [Google::Apis::GkehubV1beta::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::GkehubV1beta::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GkehubV1beta::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, 'v1beta/{+name}', options)
+          command.request_representation = Google::Apis::GkehubV1beta::Membership::Representation
+          command.request_object = membership_object
+          command.response_representation = Google::Apis::GkehubV1beta::Operation::Representation
+          command.response_class = Google::Apis::GkehubV1beta::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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-gkehub_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.58.0
+  version: 0.59.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-01 00:00:00.000000000 Z
+date: 2023-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkehub_v1beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-gkehub_v1beta/v0.58.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gkehub_v1beta/v0.59.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkehub_v1beta
 post_install_message: 
 rdoc_options: []