google-cloud-deploy-v1 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1785ddf18e0bbd50dfc2e9bb5df736040b17bef8b5a9499f0983f1b543690230
-  data.tar.gz: e63cfce08bba9037232fe4acf47add2c4e5caee0fa773ccaced09cb0452a0917
+  metadata.gz: d62b25b7f8a779a6275d78c6cc2708690191973abde9bfe6640fc7915119732f
+  data.tar.gz: 074c1747dc9c61a914069e8f5f4c927a7e3edebe61218ae3cc7d2fe912a037f9
 SHA512:
-  metadata.gz: 70931d394f75f284e815fc38e5c066f2558cbea28dbdb2813e0a88c75b7b1506d7db3a3be97f8dd61e66bd82d9b7b1fc92b37b5ddb2e00d4871be92e8d1aff77
-  data.tar.gz: c5af39b5311dd9b749b62780a27b236893af44e7564d5a8a373ed15d010b47ff3175a772af56a0960e96be879f36094bacc428a9f80d2ee2fc06a13dbac9bb1c
+  metadata.gz: da3a8e428dc2ac4cd6692918b0ce00578c67715144bc86fde2c2a6a81a2d70ef01fb9361d042a75d4364009106f2f964919c1eb758b90da1d4b290dcd364fb51
+  data.tar.gz: a7d2388d351f70775009a8a650f3f65e1947b7106e006a9be0082267d10cedeb97e43aa1fb6458b7720237d7adfd90b1f55c8cb2da187666b2e26e1c22d0e06c

data/lib/google/cloud/deploy/v1/cloud_deploy/client.rb

@@ -244,7 +244,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -3007,6 +3008,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the CloudDeploy API.
               #

data/lib/google/cloud/deploy/v1/cloud_deploy/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/deploy/v1/cloud_deploy/rest/client.rb

@@ -308,6 +308,26 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ListDeliveryPipelinesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ListDeliveryPipelinesRequest.new
+              #
+              #   # Call the list_delivery_pipelines method.
+              #   result = client.list_delivery_pipelines request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Deploy::V1::DeliveryPipeline.
+              #     p item
+              #   end
+              #
               def list_delivery_pipelines request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -371,6 +391,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::DeliveryPipeline]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetDeliveryPipelineRequest.new
+              #
+              #   # Call the get_delivery_pipeline method.
+              #   result = client.get_delivery_pipeline request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::DeliveryPipeline.
+              #   p result
+              #
               def get_delivery_pipeline request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -455,6 +491,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::CreateDeliveryPipelineRequest.new
+              #
+              #   # Call the create_delivery_pipeline method.
+              #   result = client.create_delivery_pipeline request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_delivery_pipeline request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -544,6 +603,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::UpdateDeliveryPipelineRequest.new
+              #
+              #   # Call the update_delivery_pipeline method.
+              #   result = client.update_delivery_pipeline request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_delivery_pipeline request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -636,6 +718,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::DeleteDeliveryPipelineRequest.new
+              #
+              #   # Call the delete_delivery_pipeline method.
+              #   result = client.delete_delivery_pipeline request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_delivery_pipeline request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -717,6 +822,26 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ListTargetsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ListTargetsRequest.new
+              #
+              #   # Call the list_targets method.
+              #   result = client.list_targets request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Deploy::V1::Target.
+              #     p item
+              #   end
+              #
               def list_targets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -780,6 +905,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::Target]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetTargetRequest.new
+              #
+              #   # Call the get_target method.
+              #   result = client.get_target request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::Target.
+              #   p result
+              #
               def get_target request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -865,6 +1006,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::CreateTargetRequest.new
+              #
+              #   # Call the create_target method.
+              #   result = client.create_target request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_target request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -954,6 +1118,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::UpdateTargetRequest.new
+              #
+              #   # Call the update_target method.
+              #   result = client.update_target request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_target request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1042,6 +1229,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::DeleteTargetRequest.new
+              #
+              #   # Call the delete_target method.
+              #   result = client.delete_target request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_target request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1123,6 +1333,26 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ListReleasesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ListReleasesRequest.new
+              #
+              #   # Call the list_releases method.
+              #   result = client.list_releases request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Deploy::V1::Release.
+              #     p item
+              #   end
+              #
               def list_releases request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1186,6 +1416,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::Release]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetReleaseRequest.new
+              #
+              #   # Call the get_release method.
+              #   result = client.get_release request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::Release.
+              #   p result
+              #
               def get_release request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1271,6 +1517,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::CreateReleaseRequest.new
+              #
+              #   # Call the create_release method.
+              #   result = client.create_release request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_release request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1336,6 +1605,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::AbandonReleaseResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::AbandonReleaseRequest.new
+              #
+              #   # Call the abandon_release method.
+              #   result = client.abandon_release request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::AbandonReleaseResponse.
+              #   p result
+              #
               def abandon_release request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1402,6 +1687,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ApproveRolloutResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ApproveRolloutRequest.new
+              #
+              #   # Call the approve_rollout method.
+              #   result = client.approve_rollout request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::ApproveRolloutResponse.
+              #   p result
+              #
               def approve_rollout request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1468,6 +1769,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::AdvanceRolloutResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::AdvanceRolloutRequest.new
+              #
+              #   # Call the advance_rollout method.
+              #   result = client.advance_rollout request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::AdvanceRolloutResponse.
+              #   p result
+              #
               def advance_rollout request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1532,6 +1849,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::CancelRolloutResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::CancelRolloutRequest.new
+              #
+              #   # Call the cancel_rollout method.
+              #   result = client.cancel_rollout request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::CancelRolloutResponse.
+              #   p result
+              #
               def cancel_rollout request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1611,6 +1944,26 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ListRolloutsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ListRolloutsRequest.new
+              #
+              #   # Call the list_rollouts method.
+              #   result = client.list_rollouts request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Deploy::V1::Rollout.
+              #     p item
+              #   end
+              #
               def list_rollouts request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1674,6 +2027,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::Rollout]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetRolloutRequest.new
+              #
+              #   # Call the get_rollout method.
+              #   result = client.get_rollout request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::Rollout.
+              #   p result
+              #
               def get_rollout request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1762,6 +2131,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::CreateRolloutRequest.new
+              #
+              #   # Call the create_rollout method.
+              #   result = client.create_rollout request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_rollout request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1831,6 +2223,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::IgnoreJobResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::IgnoreJobRequest.new
+              #
+              #   # Call the ignore_job method.
+              #   result = client.ignore_job request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::IgnoreJobResponse.
+              #   p result
+              #
               def ignore_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1899,6 +2307,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::RetryJobResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::RetryJobRequest.new
+              #
+              #   # Call the retry_job method.
+              #   result = client.retry_job request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::RetryJobResponse.
+              #   p result
+              #
               def retry_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1978,6 +2402,26 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::ListJobRunsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::ListJobRunsRequest.new
+              #
+              #   # Call the list_job_runs method.
+              #   result = client.list_job_runs request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Deploy::V1::JobRun.
+              #     p item
+              #   end
+              #
               def list_job_runs request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2041,6 +2485,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::JobRun]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetJobRunRequest.new
+              #
+              #   # Call the get_job_run method.
+              #   result = client.get_job_run request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::JobRun.
+              #   p result
+              #
               def get_job_run request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2105,6 +2565,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::TerminateJobRunResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::TerminateJobRunRequest.new
+              #
+              #   # Call the terminate_job_run method.
+              #   result = client.terminate_job_run request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::TerminateJobRunResponse.
+              #   p result
+              #
               def terminate_job_run request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2167,6 +2643,22 @@ module Google
               # @return [::Google::Cloud::Deploy::V1::Config]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/deploy/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Deploy::V1::CloudDeploy::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Deploy::V1::GetConfigRequest.new
+              #
+              #   # Call the get_config method.
+              #   result = client.get_config request
+              #
+              #   # The returned object is of type Google::Cloud::Deploy::V1::Config.
+              #   p result
+              #
               def get_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/deploy/v1/cloud_deploy/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Longrunning::Operation.
+              #     p item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Deploy
       module V1
-        VERSION = "0.11.0"
+        VERSION = "0.12.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-deploy-v1
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-28 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -274,7 +274,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: API Client library for the Google Cloud Deploy V1 API