google-cloud-spanner-admin-database-v1 0.14.2 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea66c18d21325c1ff3b7b66d15c33d828135371878242cd566510ecf2d8d4c87
-  data.tar.gz: ec560da6690355ac82c4c8423643b51f542f826183a1e6d9e7bc29fb59bf53b5
+  metadata.gz: d80f52c9149db5cb504f370b9032a45c72961067825b82afbef40f4570ae3efb
+  data.tar.gz: f09e8f2b540031be683cc0ed3d0d8047189d82508e16f285e7740ae7f94b2fdb
 SHA512:
-  metadata.gz: 4664bacd9194ddc24a7ed27efaee23914617abf7ba8820650056f1b22def907103bf77ddc62b95f6996bdc7279463c0731789a264f7746605c46a38509f584ac
-  data.tar.gz: 85d4e1ac4ad0bdce86a628121b4ea05fb37be5fe2c1c3523886cd3c0ab80f6cc510eeab5ec80bef432b81a1b0ce2f170502b00cc2ac3f5033af1a4454a55921f
+  metadata.gz: 2794516391abb6ef0b55dd961f3ccc2f7cd6f2bffe56eca33328a2e92648c9ea4f4edaba332defe7c28c2527894ba6e08debfb92af92f47189c6ad396ba3be14
+  data.tar.gz: 6537551aaca485ab7ef91865b7fac41e38b4ffeeb2c76531691f5c34edeb65765e363e080dfb33902b87e3f2b9eba3d8ff0aef63c9de4af8b31d501a5b2ff4dd

data/lib/google/cloud/spanner/admin/database/v1/database_admin/client.rb

@@ -234,7 +234,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
 
@@ -2606,6 +2607,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 DatabaseAdmin API.
                   #

data/lib/google/cloud/spanner/admin/database/v1/database_admin/operations.rb

@@ -95,7 +95,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
@@ -703,6 +704,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/spanner/admin/database/v1/database_admin/rest/client.rb

@@ -273,6 +273,26 @@ module Google
                   # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Database>]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesRequest.new
+                  #
+                  #   # Call the list_databases method.
+                  #   result = client.list_databases 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::Spanner::Admin::Database::V1::Database.
+                  #     p item
+                  #   end
+                  #
                   def list_databases request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -361,6 +381,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseRequest.new
+                  #
+                  #   # Call the create_database method.
+                  #   result = client.create_database 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_database request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -425,6 +468,22 @@ module Google
                   # @return [::Google::Cloud::Spanner::Admin::Database::V1::Database]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseRequest.new
+                  #
+                  #   # Call the get_database method.
+                  #   result = client.get_database request
+                  #
+                  #   # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::Database.
+                  #   p result
+                  #
                   def get_database request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -527,6 +586,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest.new
+                  #
+                  #   # Call the update_database method.
+                  #   result = client.update_database 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_database request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -618,6 +700,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest.new
+                  #
+                  #   # Call the update_database_ddl method.
+                  #   result = client.update_database_ddl 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_database_ddl request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -685,6 +790,22 @@ module Google
                   # @return [::Google::Protobuf::Empty]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::DropDatabaseRequest.new
+                  #
+                  #   # Call the drop_database method.
+                  #   result = client.drop_database request
+                  #
+                  #   # The returned object is of type Google::Protobuf::Empty.
+                  #   p result
+                  #
                   def drop_database request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -751,6 +872,22 @@ module Google
                   # @return [::Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseDdlResponse]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseDdlRequest.new
+                  #
+                  #   # Call the get_database_ddl method.
+                  #   result = client.get_database_ddl request
+                  #
+                  #   # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseDdlResponse.
+                  #   p result
+                  #
                   def get_database_ddl request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -831,6 +968,22 @@ module Google
                   # @return [::Google::Iam::V1::Policy]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Iam::V1::SetIamPolicyRequest.new
+                  #
+                  #   # Call the set_iam_policy method.
+                  #   result = client.set_iam_policy request
+                  #
+                  #   # The returned object is of type Google::Iam::V1::Policy.
+                  #   p result
+                  #
                   def set_iam_policy request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -904,6 +1057,22 @@ module Google
                   # @return [::Google::Iam::V1::Policy]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Iam::V1::GetIamPolicyRequest.new
+                  #
+                  #   # Call the get_iam_policy method.
+                  #   result = client.get_iam_policy request
+                  #
+                  #   # The returned object is of type Google::Iam::V1::Policy.
+                  #   p result
+                  #
                   def get_iam_policy request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -981,6 +1150,22 @@ module Google
                   # @return [::Google::Iam::V1::TestIamPermissionsResponse]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+                  #
+                  #   # Call the test_iam_permissions method.
+                  #   result = client.test_iam_permissions request
+                  #
+                  #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+                  #   p result
+                  #
                   def test_iam_permissions request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1071,6 +1256,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::CreateBackupRequest.new
+                  #
+                  #   # Call the create_backup method.
+                  #   result = client.create_backup 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_backup request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1169,6 +1377,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest.new
+                  #
+                  #   # Call the copy_backup method.
+                  #   result = client.copy_backup 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 copy_backup request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1234,6 +1465,22 @@ module Google
                   # @return [::Google::Cloud::Spanner::Admin::Database::V1::Backup]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::GetBackupRequest.new
+                  #
+                  #   # Call the get_backup method.
+                  #   result = client.get_backup request
+                  #
+                  #   # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::Backup.
+                  #   p result
+                  #
                   def get_backup request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1305,6 +1552,22 @@ module Google
                   # @return [::Google::Cloud::Spanner::Admin::Database::V1::Backup]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::UpdateBackupRequest.new
+                  #
+                  #   # Call the update_backup method.
+                  #   result = client.update_backup request
+                  #
+                  #   # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::Backup.
+                  #   p result
+                  #
                   def update_backup request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1369,6 +1632,22 @@ module Google
                   # @return [::Google::Protobuf::Empty]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::DeleteBackupRequest.new
+                  #
+                  #   # Call the delete_backup method.
+                  #   result = client.delete_backup request
+                  #
+                  #   # The returned object is of type Google::Protobuf::Empty.
+                  #   p result
+                  #
                   def delete_backup request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1478,6 +1757,26 @@ module Google
                   # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Backup>]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::ListBackupsRequest.new
+                  #
+                  #   # Call the list_backups method.
+                  #   result = client.list_backups 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::Spanner::Admin::Database::V1::Backup.
+                  #     p item
+                  #   end
+                  #
                   def list_backups request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1576,6 +1875,29 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseRequest.new
+                  #
+                  #   # Call the restore_database method.
+                  #   result = client.restore_database 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 restore_database request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1698,6 +2020,26 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsRequest.new
+                  #
+                  #   # Call the list_database_operations method.
+                  #   result = client.list_database_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_database_operations request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1846,6 +2188,26 @@ module Google
                   # @return [::Gapic::Operation]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsRequest.new
+                  #
+                  #   # Call the list_backup_operations method.
+                  #   result = client.list_backup_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_backup_operations request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1918,6 +2280,26 @@ module Google
                   # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::DatabaseRole>]
                   #
                   # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  #
+                  # @example Basic example
+                  #   require "google/cloud/spanner/admin/database/v1"
+                  #
+                  #   # Create a client object. The client can be reused for multiple calls.
+                  #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
+                  #
+                  #   # Create a request. To set request fields, pass in keyword arguments.
+                  #   request = Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseRolesRequest.new
+                  #
+                  #   # Call the list_database_roles method.
+                  #   result = client.list_database_roles 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::Spanner::Admin::Database::V1::DatabaseRole.
+                  #     p item
+                  #   end
+                  #
                   def list_database_roles request, options = nil
                     raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/operations.rb

@@ -138,6 +138,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?
 
@@ -203,6 +223,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?
 
@@ -269,6 +312,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?
 
@@ -340,6 +399,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/spanner/admin/database/v1/version.rb

@@ -23,7 +23,7 @@ module Google
       module Admin
         module Database
           module V1
-            VERSION = "0.14.2"
+            VERSION = "0.15.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-spanner-admin-database-v1
 version: !ruby/object:Gem::Version
-  version: 0.14.2
+  version: 0.15.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-04 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
@@ -238,7 +238,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: Cloud Spanner is a managed, mission-critical, globally consistent and scalable