google-cloud-spanner-admin-database-v1 0.7.3 → 0.7.6

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

@@ -31,10 +31,11 @@ module Google
               #
               # Cloud Spanner Database Admin API
               #
-              # The Cloud Spanner Database Admin API can be used to create, drop, and
-              # list databases. It also enables updating the schema of pre-existing
-              # databases. It can be also used to create, delete and list backups for a
-              # database and to restore from an existing backup.
+              # The Cloud Spanner Database Admin API can be used to:
+              #   * create, drop, and list databases
+              #   * update the schema of pre-existing databases
+              #   * create, delete and list backups for a database
+              #   * restore a database from an existing backup
               #
               class Client
                 include Paths
@@ -212,6 +213,7 @@ module Google
 
                   @operations_client = Operations.new do |config|
                     config.credentials = credentials
+                    config.quota_project = @quota_project_id
                     config.endpoint = @config.endpoint
                   end
 
@@ -270,6 +272,27 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 all elements by calling #each, and the enumerable
+                #   # will lazily make API calls to fetch subsequent pages. Other
+                #   # methods are also available for managing paging directly.
+                #   result.each do |response|
+                #     # Each element is of type ::Google::Cloud::Spanner::Admin::Database::V1::Database.
+                #     p response
+                #   end
+                #
                 def list_databases request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -287,9 +310,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -330,7 +355,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload create_database(parent: nil, create_statement: nil, extra_statements: nil, encryption_config: nil)
+                # @overload create_database(parent: nil, create_statement: nil, extra_statements: nil, encryption_config: nil, database_dialect: nil)
                 #   Pass arguments to `create_database` via keyword arguments. Note that at
                 #   least one keyword argument is required. To specify no parameters, or to keep all
                 #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -353,6 +378,8 @@ module Google
                 #     Optional. The encryption configuration for the database. If this field is not
                 #     specified, Cloud Spanner will encrypt/decrypt all data at rest using
                 #     Google default encryption.
+                #   @param database_dialect [::Google::Cloud::Spanner::Admin::Database::V1::DatabaseDialect]
+                #     Optional. The dialect of the Cloud Spanner Database.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::Operation]
@@ -362,6 +389,28 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 this
+                #   # object to check the status of an operation, cancel it, or wait
+                #   # for results. Here is how to block until completion:
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "Error!"
+                #   end
+                #
                 def create_database request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -379,9 +428,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -432,6 +483,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -449,9 +515,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "name" => request.name
-                  }
+                  header_params = {}
+                  if request.name
+                    header_params["name"] = request.name
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -528,6 +596,28 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 this
+                #   # object to check the status of an operation, cancel it, or wait
+                #   # for results. Here is how to block until completion:
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "Error!"
+                #   end
+                #
                 def update_database_ddl request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -545,9 +635,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "database" => request.database
-                  }
+                  header_params = {}
+                  if request.database
+                    header_params["database"] = request.database
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -572,6 +664,8 @@ module Google
                 # Drops (aka deletes) a Cloud Spanner database.
                 # Completed backups for the database will be retained according to their
                 # `expire_time`.
+                # Note: Cloud Spanner might continue to accept requests for a few seconds
+                # after the database has been deleted.
                 #
                 # @overload drop_database(request, options = nil)
                 #   Pass arguments to `drop_database` via a request object, either of type
@@ -599,6 +693,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -616,9 +725,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "database" => request.database
-                  }
+                  header_params = {}
+                  if request.database
+                    header_params["database"] = request.database
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -671,6 +782,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -688,9 +814,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "database" => request.database
-                  }
+                  header_params = {}
+                  if request.database
+                    header_params["database"] = request.database
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -751,6 +879,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -768,9 +911,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "resource" => request.resource
-                  }
+                  header_params = {}
+                  if request.resource
+                    header_params["resource"] = request.resource
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -830,6 +975,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -847,9 +1007,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "resource" => request.resource
-                  }
+                  header_params = {}
+                  if request.resource
+                    header_params["resource"] = request.resource
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -913,6 +1075,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -930,9 +1107,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "resource" => request.resource
-                  }
+                  header_params = {}
+                  if request.resource
+                    header_params["resource"] = request.resource
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1009,6 +1188,28 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 this
+                #   # object to check the status of an operation, cancel it, or wait
+                #   # for results. Here is how to block until completion:
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "Error!"
+                #   end
+                #
                 def create_backup request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1026,9 +1227,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1080,6 +1283,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -1097,9 +1315,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "name" => request.name
-                  }
+                  header_params = {}
+                  if request.name
+                    header_params["name"] = request.name
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1157,6 +1377,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -1174,9 +1409,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "backup.name" => request.backup.name
-                  }
+                  header_params = {}
+                  if request.backup&.name
+                    header_params["backup.name"] = request.backup.name
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1227,6 +1464,21 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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?
 
@@ -1244,9 +1496,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "name" => request.name
-                  }
+                  header_params = {}
+                  if request.name
+                    header_params["name"] = request.name
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1342,6 +1596,27 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 all elements by calling #each, and the enumerable
+                #   # will lazily make API calls to fetch subsequent pages. Other
+                #   # methods are also available for managing paging directly.
+                #   result.each do |response|
+                #     # Each element is of type ::Google::Cloud::Spanner::Admin::Database::V1::Backup.
+                #     p response
+                #   end
+                #
                 def list_backups request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1359,9 +1634,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1446,6 +1723,28 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 this
+                #   # object to check the status of an operation, cancel it, or wait
+                #   # for results. Here is how to block until completion:
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "Error!"
+                #   end
+                #
                 def restore_database request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1463,9 +1762,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1572,6 +1873,27 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 all elements by calling #each, and the enumerable
+                #   # will lazily make API calls to fetch subsequent pages. Other
+                #   # methods are also available for managing paging directly.
+                #   result.each do |response|
+                #     # Each element is of type ::Google::Longrunning::Operation.
+                #     p response
+                #   end
+                #
                 def list_database_operations request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1589,9 +1911,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1699,6 +2023,27 @@ module Google
                 #
                 # @raise [::Google::Cloud::Error] if the RPC 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::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 all elements by calling #each, and the enumerable
+                #   # will lazily make API calls to fetch subsequent pages. Other
+                #   # methods are also available for managing paging directly.
+                #   result.each do |response|
+                #     # Each element is of type ::Google::Longrunning::Operation.
+                #     p response
+                #   end
+                #
                 def list_backup_operations request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1716,9 +2061,11 @@ module Google
                     gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
                   metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                  header_params = {
-                    "parent" => request.parent
-                  }
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+
                   request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                   metadata[:"x-goog-request-params"] ||= request_params_header