google-cloud-datastream-v1 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2865771d5703e977f575ae4680e005ede6fbf8a2705b91f2deb65c1d6e1ed7dd
-  data.tar.gz: 97234c2963d0ddc29ad0865892c4cba6ccee33398e78b2a4f1c6dc63b3c43dbe
+  metadata.gz: 5b486bd127833c24901addb2a8b235b87264ec1b9d3e046c189b0528860805e0
+  data.tar.gz: 6838f42a6a34a628a24161ae9e2538f745dab358b0168d3c592d9fcd9f83a6f3
 SHA512:
-  metadata.gz: dd48e429316bee0a5b7eeb779a6123c3af6b4134ba49c17a0eaaeb179bde85391246a6fb86d1f0dec640a4c41e06d6ca07e059925da02404c38f0844850932f8
-  data.tar.gz: 42b32e45c05c072f7bf5078ddddeb9b42b08c5d2957b0ecda05cc594a89f556662c597d081b0adb740ca907fb09d5c63e04e8d0852cb4e6ff8bf7af5dccaa17b
+  metadata.gz: b699f6dfef75aeec2c3f3c2bb73da67111eb661d8ed043214415a89a4090a4009f74e32b85cdc095fe0552e2d9fd0650ae0b3f85609057b8592f2e1ccdf98dc1
+  data.tar.gz: 79c9a683bd57e7829a833e36204245efff762c928826944d63047af1fb4fdedf5e316d62d2d6420cc1b069952d2f8b470c1822cbe717d28ba59e74aa9127e383

data/lib/google/cloud/datastream/v1/datastream/client.rb

@@ -183,7 +183,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
 
@@ -2857,6 +2858,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 Datastream API.
               #

data/lib/google/cloud/datastream/v1/datastream/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/datastream/v1/datastream/rest/client.rb

@@ -244,6 +244,26 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::ListConnectionProfilesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::ListConnectionProfilesRequest.new
+              #
+              #   # Call the list_connection_profiles method.
+              #   result = client.list_connection_profiles 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::Datastream::V1::ConnectionProfile.
+              #     p item
+              #   end
+              #
               def list_connection_profiles request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -306,6 +326,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::ConnectionProfile]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::GetConnectionProfileRequest.new
+              #
+              #   # Call the get_connection_profile method.
+              #   result = client.get_connection_profile request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::ConnectionProfile.
+              #   p result
+              #
               def get_connection_profile request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -391,6 +427,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::CreateConnectionProfileRequest.new
+              #
+              #   # Call the create_connection_profile method.
+              #   result = client.create_connection_profile 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_connection_profile request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -479,6 +538,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::UpdateConnectionProfileRequest.new
+              #
+              #   # Call the update_connection_profile method.
+              #   result = client.update_connection_profile 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_connection_profile request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -556,6 +638,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::DeleteConnectionProfileRequest.new
+              #
+              #   # Call the delete_connection_profile method.
+              #   result = client.delete_connection_profile 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_connection_profile request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -638,6 +743,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::DiscoverConnectionProfileResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::DiscoverConnectionProfileRequest.new
+              #
+              #   # Call the discover_connection_profile method.
+              #   result = client.discover_connection_profile request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::DiscoverConnectionProfileResponse.
+              #   p result
+              #
               def discover_connection_profile request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -714,6 +835,26 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::ListStreamsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::ListStreamsRequest.new
+              #
+              #   # Call the list_streams method.
+              #   result = client.list_streams 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::Datastream::V1::Stream.
+              #     p item
+              #   end
+              #
               def list_streams request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -776,6 +917,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::Stream]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::GetStreamRequest.new
+              #
+              #   # Call the get_stream method.
+              #   result = client.get_stream request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::Stream.
+              #   p result
+              #
               def get_stream request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -861,6 +1018,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::CreateStreamRequest.new
+              #
+              #   # Call the create_stream method.
+              #   result = client.create_stream 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_stream request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -949,6 +1129,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::UpdateStreamRequest.new
+              #
+              #   # Call the update_stream method.
+              #   result = client.update_stream 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_stream request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1026,6 +1229,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::DeleteStreamRequest.new
+              #
+              #   # Call the delete_stream method.
+              #   result = client.delete_stream 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_stream request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1089,6 +1315,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::StreamObject]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::GetStreamObjectRequest.new
+              #
+              #   # Call the get_stream_object method.
+              #   result = client.get_stream_object request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::StreamObject.
+              #   p result
+              #
               def get_stream_object request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1153,6 +1395,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::StreamObject]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::LookupStreamObjectRequest.new
+              #
+              #   # Call the lookup_stream_object method.
+              #   result = client.lookup_stream_object request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::StreamObject.
+              #   p result
+              #
               def lookup_stream_object request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1225,6 +1483,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Datastream::V1::StreamObject>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::ListStreamObjectsRequest.new
+              #
+              #   # Call the list_stream_objects method.
+              #   result = client.list_stream_objects 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::Datastream::V1::StreamObject.
+              #     p item
+              #   end
+              #
               def list_stream_objects request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1289,6 +1567,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::StartBackfillJobResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::StartBackfillJobRequest.new
+              #
+              #   # Call the start_backfill_job method.
+              #   result = client.start_backfill_job request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::StartBackfillJobResponse.
+              #   p result
+              #
               def start_backfill_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1352,6 +1646,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::StopBackfillJobResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::StopBackfillJobRequest.new
+              #
+              #   # Call the stop_backfill_job method.
+              #   result = client.stop_backfill_job request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::StopBackfillJobResponse.
+              #   p result
+              #
               def stop_backfill_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1421,6 +1731,22 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::String>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::FetchStaticIpsRequest.new
+              #
+              #   # Call the fetch_static_ips method.
+              #   result = client.fetch_static_ips request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::FetchStaticIpsResponse.
+              #   p result
+              #
               def fetch_static_ips request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1504,6 +1830,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::CreatePrivateConnectionRequest.new
+              #
+              #   # Call the create_private_connection method.
+              #   result = client.create_private_connection 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_private_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1567,6 +1916,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::PrivateConnection]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::GetPrivateConnectionRequest.new
+              #
+              #   # Call the get_private_connection method.
+              #   result = client.get_private_connection request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::PrivateConnection.
+              #   p result
+              #
               def get_private_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1647,6 +2012,26 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::ListPrivateConnectionsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::ListPrivateConnectionsRequest.new
+              #
+              #   # Call the list_private_connections method.
+              #   result = client.list_private_connections 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::Datastream::V1::PrivateConnection.
+              #     p item
+              #   end
+              #
               def list_private_connections request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1726,6 +2111,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::DeletePrivateConnectionRequest.new
+              #
+              #   # Call the delete_private_connection method.
+              #   result = client.delete_private_connection 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_private_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1808,6 +2216,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::CreateRouteRequest.new
+              #
+              #   # Call the create_route method.
+              #   result = client.create_route 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_route request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1871,6 +2302,22 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::Route]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::GetRouteRequest.new
+              #
+              #   # Call the get_route method.
+              #   result = client.get_route request
+              #
+              #   # The returned object is of type Google::Cloud::Datastream::V1::Route.
+              #   p result
+              #
               def get_route request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1950,6 +2397,26 @@ module Google
               # @return [::Google::Cloud::Datastream::V1::ListRoutesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::ListRoutesRequest.new
+              #
+              #   # Call the list_routes method.
+              #   result = client.list_routes 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::Datastream::V1::Route.
+              #     p item
+              #   end
+              #
               def list_routes request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2026,6 +2493,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/datastream/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Datastream::V1::Datastream::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Datastream::V1::DeleteRouteRequest.new
+              #
+              #   # Call the delete_route method.
+              #   result = client.delete_route 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_route request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/datastream/v1/datastream/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/datastream/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Datastream
       module V1
-        VERSION = "0.7.0"
+        VERSION = "0.8.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-datastream-v1
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-25 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
@@ -262,7 +262,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 Datastream V1 API