# Copyright 2020 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. require 'google/apis/core/base_service' require 'google/apis/core/json_representation' require 'google/apis/core/hashable' require 'google/apis/errors' module Google module Apis module DeveloperconnectV1 # Developer Connect API # # Connect third-party source code management to Google # # @example # require 'google/apis/developerconnect_v1' # # Developerconnect = Google::Apis::DeveloperconnectV1 # Alias the module # service = Developerconnect::DeveloperConnectService.new # # @see http://cloud.google.com/developer-connect/docs/overview class DeveloperConnectService < Google::Apis::Core::BaseService DEFAULT_ENDPOINT_TEMPLATE = "https://developerconnect.$UNIVERSE_DOMAIN$/" # @return [String] # API key. Your API key identifies your project and provides you with API access, # quota, and reports. Required unless you provide an OAuth 2.0 token. attr_accessor :key # @return [String] # 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. attr_accessor :quota_user def initialize super(DEFAULT_ENDPOINT_TEMPLATE, '', client_name: 'google-apis-developerconnect_v1', client_version: Google::Apis::DeveloperconnectV1::GEM_VERSION) @batch_path = 'batch' end # Gets information about a location. # @param [String] name # Resource name for the location. # @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::DeveloperconnectV1::Location] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Location] # # @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(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Location::Representation command.response_class = Google::Apis::DeveloperconnectV1::Location 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 # Lists information about the supported locations for this service. # @param [String] name # The resource that owns the locations collection, if applicable. # @param [String] filter # A filter to narrow down results to a preferred subset. The filtering language # accepts strings like `"displayName=tokyo"`, and is documented in more detail # in [AIP-160](https://google.aip.dev/160). # @param [Fixnum] page_size # The maximum number of results to return. If not set, the service selects a # default. # @param [String] page_token # A page token received from the `next_page_token` field in the response. Send # that page token to receive the subsequent page. # @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::DeveloperconnectV1::ListLocationsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::ListLocationsResponse] # # @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_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}/locations', options) command.response_representation = Google::Apis::DeveloperconnectV1::ListLocationsResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::ListLocationsResponse command.params['name'] = name unless name.nil? command.query['filter'] = filter unless filter.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 # Creates a new Connection in a given project and location. # @param [String] parent # Required. Value for parent. # @param [Google::Apis::DeveloperconnectV1::Connection] connection_object # @param [String] connection_id # Required. Id of the requesting object If auto-generating Id server-side, # remove this field and connection_id from the method_signature of Create RPC # @param [String] request_id # Optional. An optional 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 since 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 [Boolean] validate_only # Optional. If set, validate the request, but do not actually post it. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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_connection(parent, connection_object = nil, connection_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+parent}/connections', options) command.request_representation = Google::Apis::DeveloperconnectV1::Connection::Representation command.request_object = connection_object command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation command.params['parent'] = parent unless parent.nil? command.query['connectionId'] = connection_id unless connection_id.nil? command.query['requestId'] = request_id unless request_id.nil? command.query['validateOnly'] = validate_only unless validate_only.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Deletes a single Connection. # @param [String] name # Required. Name of the resource # @param [String] etag # Optional. The current etag of the Connection. If an etag is provided and does # not match the current etag of the Connection, deletion will be blocked and an # ABORTED error will be returned. # @param [String] request_id # Optional. An optional 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 [Boolean] validate_only # Optional. If set, validate the request, but do not actually post it. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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_connection(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation command.params['name'] = name unless name.nil? command.query['etag'] = etag unless etag.nil? command.query['requestId'] = request_id unless request_id.nil? command.query['validateOnly'] = validate_only unless validate_only.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # FetchGitHubInstallations returns the list of GitHub Installations that are # available to be added to a Connection. For github.com, only installations # accessible to the authorizer token are returned. For GitHub Enterprise, all # installations are returned. # @param [String] connection # Required. The resource name of the connection in the format `projects/*/ # locations/*/connections/*`. # @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::DeveloperconnectV1::FetchGitHubInstallationsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::FetchGitHubInstallationsResponse] # # @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 fetch_project_location_connection_git_hub_installations(connection, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+connection}:fetchGitHubInstallations', options) command.response_representation = Google::Apis::DeveloperconnectV1::FetchGitHubInstallationsResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::FetchGitHubInstallationsResponse command.params['connection'] = connection unless connection.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # FetchLinkableGitRepositories returns a list of git repositories from an SCM # that are available to be added to a Connection. # @param [String] connection # Required. The name of the Connection. Format: `projects/*/locations/*/ # connections/*`. # @param [Fixnum] page_size # Optional. Number of results to return in the list. Defaults to 20. # @param [String] page_token # Optional. Page start. # @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::DeveloperconnectV1::FetchLinkableGitRepositoriesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::FetchLinkableGitRepositoriesResponse] # # @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 fetch_project_location_connection_linkable_git_repositories(connection, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+connection}:fetchLinkableGitRepositories', options) command.response_representation = Google::Apis::DeveloperconnectV1::FetchLinkableGitRepositoriesResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::FetchLinkableGitRepositoriesResponse command.params['connection'] = connection unless connection.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 # Gets details of a single Connection. # @param [String] name # Required. Name of the resource # @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::DeveloperconnectV1::Connection] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Connection] # # @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_connection(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Connection::Representation command.response_class = Google::Apis::DeveloperconnectV1::Connection 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 # Lists Connections in a given project and location. # @param [String] parent # Required. Parent value for ListConnectionsRequest # @param [String] filter # Optional. Filtering results # @param [String] order_by # Optional. Hint for how to order the results # @param [Fixnum] page_size # Optional. Requested page size. Server may return fewer items than requested. # If unspecified, server will pick an appropriate default. # @param [String] page_token # Optional. A token identifying a page of results the server should return. # @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::DeveloperconnectV1::ListConnectionsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::ListConnectionsResponse] # # @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_connections(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, 'v1/{+parent}/connections', options) command.response_representation = Google::Apis::DeveloperconnectV1::ListConnectionsResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::ListConnectionsResponse 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 the parameters of a single Connection. # @param [String] name # Identifier. The resource name of the connection, in the format `projects/` # project`/locations/`location`/connections/`connection_id``. # @param [Google::Apis::DeveloperconnectV1::Connection] connection_object # @param [Boolean] allow_missing # Optional. If set to true, and the connection is not found a new connection # will be created. In this situation `update_mask` is ignored. The creation will # succeed only if the input connection has all the necessary information (e.g a # github_config with both user_oauth_token and installation_id properties). # @param [String] request_id # Optional. An optional 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 since 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. Field mask is used to specify the fields to be overwritten in the # Connection resource by the update. The fields specified in the update_mask are # relative to the resource, not the full request. A field will be overwritten if # it is in the mask. If the user does not provide a mask then all fields will be # overwritten. # @param [Boolean] validate_only # Optional. If set, validate the request, but do not actually post it. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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_connection(name, connection_object = nil, allow_missing: nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:patch, 'v1/{+name}', options) command.request_representation = Google::Apis::DeveloperconnectV1::Connection::Representation command.request_object = connection_object command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation command.params['name'] = name unless name.nil? command.query['allowMissing'] = allow_missing unless allow_missing.nil? command.query['requestId'] = request_id unless request_id.nil? command.query['updateMask'] = update_mask unless update_mask.nil? command.query['validateOnly'] = validate_only unless validate_only.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # ProcessGitHubEnterpriseWebhook is called by the external GitHub Enterprise # instances for notifying events. # @param [String] parent # Required. Project and location where the webhook will be received. Format: ` # projects/*/locations/*`. # @param [Google::Apis::DeveloperconnectV1::ProcessGitHubEnterpriseWebhookRequest] process_git_hub_enterprise_webhook_request_object # @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::DeveloperconnectV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Empty] # # @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 process_connection_git_hub_enterprise_webhook(parent, process_git_hub_enterprise_webhook_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+parent}/connections:processGitHubEnterpriseWebhook', options) command.request_representation = Google::Apis::DeveloperconnectV1::ProcessGitHubEnterpriseWebhookRequest::Representation command.request_object = process_git_hub_enterprise_webhook_request_object command.response_representation = Google::Apis::DeveloperconnectV1::Empty::Representation command.response_class = Google::Apis::DeveloperconnectV1::Empty command.params['parent'] = parent unless parent.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Creates a GitRepositoryLink. Upon linking a Git Repository, Developer Connect # will configure the Git Repository to send webhook events to Developer Connect. # Connections that use Firebase GitHub Application will have events forwarded to # the Firebase service. All other Connections will have events forwarded to # Cloud Build. # @param [String] parent # Required. Value for parent. # @param [Google::Apis::DeveloperconnectV1::GitRepositoryLink] git_repository_link_object # @param [String] git_repository_link_id # Required. The ID to use for the repository, which will become the final # component of the repository's resource name. This ID should be unique in the # connection. Allows alphanumeric characters and any of -._~%!$&'()*+,;=@. # @param [String] request_id # Optional. An optional 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 since 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 [Boolean] validate_only # Optional. If set, validate the request, but do not actually post it. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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_connection_git_repository_link(parent, git_repository_link_object = nil, git_repository_link_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+parent}/gitRepositoryLinks', options) command.request_representation = Google::Apis::DeveloperconnectV1::GitRepositoryLink::Representation command.request_object = git_repository_link_object command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation command.params['parent'] = parent unless parent.nil? command.query['gitRepositoryLinkId'] = git_repository_link_id unless git_repository_link_id.nil? command.query['requestId'] = request_id unless request_id.nil? command.query['validateOnly'] = validate_only unless validate_only.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Deletes a single GitRepositoryLink. # @param [String] name # Required. Name of the resource # @param [String] etag # Optional. This checksum is computed by the server based on the value of other # fields, and may be sent on update and delete requests to ensure the client has # an up-to-date value before proceeding. # @param [String] request_id # Optional. An optional 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 [Boolean] validate_only # Optional. If set, validate the request, but do not actually post it. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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_connection_git_repository_link(name, etag: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation command.params['name'] = name unless name.nil? command.query['etag'] = etag unless etag.nil? command.query['requestId'] = request_id unless request_id.nil? command.query['validateOnly'] = validate_only unless validate_only.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Fetch the list of branches or tags for a given repository. # @param [String] git_repository_link # Required. The resource name of GitRepositoryLink in the format `projects/*/ # locations/*/connections/*/gitRepositoryLinks/*`. # @param [Fixnum] page_size # Optional. Number of results to return in the list. Default to 20. # @param [String] page_token # Optional. Page start. # @param [String] ref_type # Required. Type of refs to fetch. # @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::DeveloperconnectV1::FetchGitRefsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::FetchGitRefsResponse] # # @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 fetch_project_location_connection_git_repository_link_git_refs(git_repository_link, page_size: nil, page_token: nil, ref_type: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+gitRepositoryLink}:fetchGitRefs', options) command.response_representation = Google::Apis::DeveloperconnectV1::FetchGitRefsResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::FetchGitRefsResponse command.params['gitRepositoryLink'] = git_repository_link unless git_repository_link.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['refType'] = ref_type unless ref_type.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Fetches read token of a given gitRepositoryLink. # @param [String] git_repository_link # Required. The resource name of the gitRepositoryLink in the format `projects/*/ # locations/*/connections/*/gitRepositoryLinks/*`. # @param [Google::Apis::DeveloperconnectV1::FetchReadTokenRequest] fetch_read_token_request_object # @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::DeveloperconnectV1::FetchReadTokenResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::FetchReadTokenResponse] # # @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 fetch_git_repository_link_read_token(git_repository_link, fetch_read_token_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+gitRepositoryLink}:fetchReadToken', options) command.request_representation = Google::Apis::DeveloperconnectV1::FetchReadTokenRequest::Representation command.request_object = fetch_read_token_request_object command.response_representation = Google::Apis::DeveloperconnectV1::FetchReadTokenResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::FetchReadTokenResponse command.params['gitRepositoryLink'] = git_repository_link unless git_repository_link.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Fetches read/write token of a given gitRepositoryLink. # @param [String] git_repository_link # Required. The resource name of the gitRepositoryLink in the format `projects/*/ # locations/*/connections/*/gitRepositoryLinks/*`. # @param [Google::Apis::DeveloperconnectV1::FetchReadWriteTokenRequest] fetch_read_write_token_request_object # @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::DeveloperconnectV1::FetchReadWriteTokenResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::FetchReadWriteTokenResponse] # # @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 fetch_git_repository_link_read_write_token(git_repository_link, fetch_read_write_token_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+gitRepositoryLink}:fetchReadWriteToken', options) command.request_representation = Google::Apis::DeveloperconnectV1::FetchReadWriteTokenRequest::Representation command.request_object = fetch_read_write_token_request_object command.response_representation = Google::Apis::DeveloperconnectV1::FetchReadWriteTokenResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::FetchReadWriteTokenResponse command.params['gitRepositoryLink'] = git_repository_link unless git_repository_link.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 details of a single GitRepositoryLink. # @param [String] name # Required. Name of the resource # @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::DeveloperconnectV1::GitRepositoryLink] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::GitRepositoryLink] # # @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_connection_git_repository_link(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::GitRepositoryLink::Representation command.response_class = Google::Apis::DeveloperconnectV1::GitRepositoryLink 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 # Lists GitRepositoryLinks in a given project, location, and connection. # @param [String] parent # Required. Parent value for ListGitRepositoryLinksRequest # @param [String] filter # Optional. Filtering results # @param [String] order_by # Optional. Hint for how to order the results # @param [Fixnum] page_size # Optional. Requested page size. Server may return fewer items than requested. # If unspecified, server will pick an appropriate default. # @param [String] page_token # Optional. A token identifying a page of results the server should return. # @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::DeveloperconnectV1::ListGitRepositoryLinksResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::ListGitRepositoryLinksResponse] # # @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_connection_git_repository_links(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, 'v1/{+parent}/gitRepositoryLinks', options) command.response_representation = Google::Apis::DeveloperconnectV1::ListGitRepositoryLinksResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::ListGitRepositoryLinksResponse 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 # ProcessGitLabEnterpriseWebhook is called by the external GitLab Enterprise # instances for notifying events. # @param [String] name # Required. The GitRepositoryLink resource where the webhook will be received. # Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`. # @param [Google::Apis::DeveloperconnectV1::ProcessGitLabEnterpriseWebhookRequest] process_git_lab_enterprise_webhook_request_object # @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::DeveloperconnectV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Empty] # # @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 process_git_repository_link_git_lab_enterprise_webhook(name, process_git_lab_enterprise_webhook_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+name}:processGitLabEnterpriseWebhook', options) command.request_representation = Google::Apis::DeveloperconnectV1::ProcessGitLabEnterpriseWebhookRequest::Representation command.request_object = process_git_lab_enterprise_webhook_request_object command.response_representation = Google::Apis::DeveloperconnectV1::Empty::Representation command.response_class = Google::Apis::DeveloperconnectV1::Empty 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 # ProcessGitLabWebhook is called by the GitLab.com for notifying events. # @param [String] name # Required. The GitRepositoryLink resource where the webhook will be received. # Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`. # @param [Google::Apis::DeveloperconnectV1::ProcessGitLabWebhookRequest] process_git_lab_webhook_request_object # @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::DeveloperconnectV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Empty] # # @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 process_git_repository_link_git_lab_webhook(name, process_git_lab_webhook_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+name}:processGitLabWebhook', options) command.request_representation = Google::Apis::DeveloperconnectV1::ProcessGitLabWebhookRequest::Representation command.request_object = process_git_lab_webhook_request_object command.response_representation = Google::Apis::DeveloperconnectV1::Empty::Representation command.response_class = Google::Apis::DeveloperconnectV1::Empty 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 # Starts asynchronous cancellation on a long-running operation. The server makes # a best effort to cancel the operation, but success is not guaranteed. If the # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. # Clients can use Operations.GetOperation or other methods to check whether the # cancellation succeeded or whether the operation completed despite cancellation. # On successful cancellation, the operation is not deleted; instead, it becomes # an operation with an Operation.error value with a google.rpc.Status.code of 1, # corresponding to `Code.CANCELLED`. # @param [String] name # The name of the operation resource to be cancelled. # @param [Google::Apis::DeveloperconnectV1::CancelOperationRequest] cancel_operation_request_object # @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::DeveloperconnectV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Empty] # # @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 cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/{+name}:cancel', options) command.request_representation = Google::Apis::DeveloperconnectV1::CancelOperationRequest::Representation command.request_object = cancel_operation_request_object command.response_representation = Google::Apis::DeveloperconnectV1::Empty::Representation command.response_class = Google::Apis::DeveloperconnectV1::Empty 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 # Deletes a long-running operation. This method indicates that the client is no # longer interested in the operation result. It does not cancel the operation. # If the server doesn't support this method, it returns `google.rpc.Code. # UNIMPLEMENTED`. # @param [String] name # The name of the operation resource to be deleted. # @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::DeveloperconnectV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::Empty] # # @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_operation(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Empty::Representation command.response_class = Google::Apis::DeveloperconnectV1::Empty 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 latest state of a long-running operation. Clients can use this method # to poll the operation result at intervals as recommended by the API service. # @param [String] name # The name of the operation resource. # @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::DeveloperconnectV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::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 get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}', options) command.response_representation = Google::Apis::DeveloperconnectV1::Operation::Representation command.response_class = Google::Apis::DeveloperconnectV1::Operation 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 # Lists operations that match the specified filter in the request. If the server # doesn't support this method, it returns `UNIMPLEMENTED`. # @param [String] name # The name of the operation's parent resource. # @param [String] filter # The standard list filter. # @param [Fixnum] page_size # The standard list page size. # @param [String] page_token # The standard list page token. # @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::DeveloperconnectV1::ListOperationsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # # @return [Google::Apis::DeveloperconnectV1::ListOperationsResponse] # # @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_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}/operations', options) command.response_representation = Google::Apis::DeveloperconnectV1::ListOperationsResponse::Representation command.response_class = Google::Apis::DeveloperconnectV1::ListOperationsResponse command.params['name'] = name unless name.nil? command.query['filter'] = filter unless filter.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 protected def apply_command_defaults(command) command.query['key'] = key unless key.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? end end end end end