google-cloud-build-v1 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea9a6859457936f6b56971252fb53b0f5ddc2f6450429b3fc1ec3fbe3af1fa2d
-  data.tar.gz: fa8194d01ef4b669c38ee63ddc34ec86829bead0dd992f97565b19a12954aafc
+  metadata.gz: 70a6588393194bcc795b8e5b1f386a21a6994f1040175ab7b3054d85f54df753
+  data.tar.gz: 1e2dabb6155abc01cf03a571b8aa6212301a6bc10de6aa1cc4bc50022e63c0f1
 SHA512:
-  metadata.gz: 7a1a144d8f4c7667f130098fe9534cf974d8ecda46586bbc611bcbfe538c2228093e0af066428d53c351e8a167365cb440b3e3dcff6534f38ffff6812317cac8
-  data.tar.gz: bd7166c77874ff5bee7a49493c469928f39a8e69204baf8d30e694535d112a545fd477766991365066f1a33708024a23823f7df1dfbe7b812a939f5ce13830c3
+  metadata.gz: 400174cab7050b4699a37151580636b4428241f64da09ceae6e4132dfe282b8356ce99dfdc5687242e0006164d973d6162b292e1bf2b32a2a2006e93421ce86d
+  data.tar.gz: c8698e44f7a904f583e68718effc8e1eeb1dc22cf880c44af65a12f47566fcd592d0429d1bfe3b0ced2d161bd3e423ad88dcfc9b805193603627d58f30b13467

data/lib/google/cloud/build/v1/cloud_build/client.rb

@@ -295,11 +295,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
+              if request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_build.timeout,
@@ -389,14 +392,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.id
-                header_params["id"] = request.id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/builds/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_build.timeout,
@@ -501,11 +504,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
+              if request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_builds.timeout,
@@ -592,14 +598,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.id
-                header_params["id"] = request.id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/builds/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.cancel_build.timeout,
@@ -639,7 +645,7 @@ module Google
             #
             # For builds that specify `StorageSource`:
             #
-            # * If the original build pulled source from Google Cloud Storage without
+            # * If the original build pulled source from Cloud Storage without
             # specifying the generation of the object, the new build will use the current
             # object, which may be different from the original build source.
             # * If the original build pulled source from Cloud Storage and specified the
@@ -718,14 +724,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.id
-                header_params["id"] = request.id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/builds/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.retry_build.timeout,
@@ -823,10 +829,13 @@ module Google
 
               header_params = {}
               if request.name
-                header_params["name"] = request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/builds/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.approve_build.timeout,
@@ -915,11 +924,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
+              if request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_build_trigger.timeout,
@@ -1007,14 +1019,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.trigger_id
-                header_params["trigger_id"] = request.trigger_id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/triggers/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_build_trigger.timeout,
@@ -1108,11 +1120,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
+              if request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_build_triggers.timeout,
@@ -1201,14 +1216,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.trigger_id
-                header_params["trigger_id"] = request.trigger_id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/triggers/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_build_trigger.timeout,
@@ -1295,14 +1310,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.trigger_id
-                header_params["trigger_id"] = request.trigger_id
+              if request.trigger&.resource_name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/triggers/[^/]+/?$}.match request.trigger.resource_name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_build_trigger.timeout,
@@ -1324,6 +1339,12 @@ module Google
             ##
             # Runs a `BuildTrigger` at a particular source revision.
             #
+            # To run a regional or global trigger, use the POST request
+            # that includes the location endpoint in the path (ex.
+            # v1/projects/\\{projectId}/locations/\\{region}/triggers/\\{triggerId}:run). The
+            # POST request that does not include the location endpoint in the path can
+            # only be used when running global triggers.
+            #
             # @overload run_build_trigger(request, options = nil)
             #   Pass arguments to `run_build_trigger` via a request object, either of type
             #   {::Google::Cloud::Build::V1::RunBuildTriggerRequest} or an equivalent Hash.
@@ -1348,6 +1369,7 @@ module Google
             #     Required. ID of the trigger.
             #   @param source [::Google::Cloud::Build::V1::RepoSource, ::Hash]
             #     Source to build against this trigger.
+            #     Branch and tag names cannot consist of regular expressions.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1397,14 +1419,14 @@ module Google
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
-              if request.project_id
-                header_params["project_id"] = request.project_id
-              end
-              if request.trigger_id
-                header_params["trigger_id"] = request.trigger_id
+              if request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/triggers/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.run_build_trigger.timeout,
@@ -1604,10 +1626,13 @@ module Google
 
               header_params = {}
               if request.parent
-                header_params["parent"] = request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_worker_pool.timeout,
@@ -1691,10 +1716,13 @@ module Google
 
               header_params = {}
               if request.name
-                header_params["name"] = request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/workerPools/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_worker_pool.timeout,
@@ -1736,8 +1764,8 @@ module Google
             #     Format:
             #     `projects/{project}/locations/{location}/workerPools/{workerPool}`.
             #   @param etag [::String]
-            #     Optional. If this is provided, it must match the server's etag on the
-            #     workerpool for the request to be processed.
+            #     Optional. If provided, it must match the server's etag on the workerpool
+            #     for the request to be processed.
             #   @param allow_missing [::Boolean]
             #     If set to true, and the `WorkerPool` is not found, the request will succeed
             #     but no action will be taken on the server.
@@ -1794,10 +1822,13 @@ module Google
 
               header_params = {}
               if request.name
-                header_params["name"] = request.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/workerPools/[^/]+/?$}.match request.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_worker_pool.timeout,
@@ -1895,10 +1926,13 @@ module Google
 
               header_params = {}
               if request.worker_pool&.name
-                header_params["worker_pool.name"] = request.worker_pool.name
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/workerPools/[^/]+/?$}.match request.worker_pool.name
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_worker_pool.timeout,
@@ -1992,10 +2026,13 @@ module Google
 
               header_params = {}
               if request.parent
-                header_params["parent"] = request.parent
+                regex_match = %r{^projects/[^/]+/locations/(?<location>[^/]+)/?$}.match request.parent
+                if regex_match
+                  header_params["location"] = regex_match["location".to_s]
+                end
               end
 
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              request_params_header = URI.encode_www_form header_params
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_worker_pools.timeout,

data/lib/google/cloud/build/v1/cloud_build/paths.rb

@@ -127,6 +127,47 @@ module Google
               "projects/#{project}/locations/#{location}/keyRings/#{keyring}/cryptoKeys/#{key}"
             end
 
+            ##
+            # Create a fully-qualified GithubEnterpriseConfig resource string.
+            #
+            # @overload github_enterprise_config_path(project:, config:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/githubEnterpriseConfigs/{config}`
+            #
+            #   @param project [String]
+            #   @param config [String]
+            #
+            # @overload github_enterprise_config_path(project:, location:, config:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/githubEnterpriseConfigs/{config}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param config [String]
+            #
+            # @return [::String]
+            def github_enterprise_config_path **args
+              resources = {
+                "config:project" => (proc do |project:, config:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/githubEnterpriseConfigs/#{config}"
+                end),
+                "config:location:project" => (proc do |project:, location:, config:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/githubEnterpriseConfigs/#{config}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified Location resource string.
             #

data/lib/google/cloud/build/v1/cloud_build/rest/client.rb

@@ -521,7 +521,7 @@ module Google
               #
               # For builds that specify `StorageSource`:
               #
-              # * If the original build pulled source from Google Cloud Storage without
+              # * If the original build pulled source from Cloud Storage without
               # specifying the generation of the object, the new build will use the current
               # object, which may be different from the original build source.
               # * If the original build pulled source from Cloud Storage and specified the
@@ -1015,6 +1015,12 @@ module Google
               ##
               # Runs a `BuildTrigger` at a particular source revision.
               #
+              # To run a regional or global trigger, use the POST request
+              # that includes the location endpoint in the path (ex.
+              # v1/projects/\\{projectId}/locations/\\{region}/triggers/\\{triggerId}:run). The
+              # POST request that does not include the location endpoint in the path can
+              # only be used when running global triggers.
+              #
               # @overload run_build_trigger(request, options = nil)
               #   Pass arguments to `run_build_trigger` via a request object, either of type
               #   {::Google::Cloud::Build::V1::RunBuildTriggerRequest} or an equivalent Hash.
@@ -1039,6 +1045,7 @@ module Google
               #     Required. ID of the trigger.
               #   @param source [::Google::Cloud::Build::V1::RepoSource, ::Hash]
               #     Source to build against this trigger.
+              #     Branch and tag names cannot consist of regular expressions.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1315,8 +1322,8 @@ module Google
               #     Format:
               #     `projects/{project}/locations/{location}/workerPools/{workerPool}`.
               #   @param etag [::String]
-              #     Optional. If this is provided, it must match the server's etag on the
-              #     workerpool for the request to be processed.
+              #     Optional. If provided, it must match the server's etag on the workerpool
+              #     for the request to be processed.
               #   @param allow_missing [::Boolean]
               #     If set to true, and the `WorkerPool` is not found, the request will succeed
               #     but no action will be taken on the server.

data/lib/google/cloud/build/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Build
       module V1
-        VERSION = "0.19.0"
+        VERSION = "0.21.0"
       end
     end
   end