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

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

@@ -40,6 +40,9 @@ module Google
                 #   * restore a database from an existing backup
                 #
                 class Client
+                  # @private
+                  DEFAULT_ENDPOINT_TEMPLATE = "spanner.$UNIVERSE_DOMAIN$"
+
                   include Paths
 
                   # @private
@@ -182,6 +185,15 @@ module Google
                     @config
                   end
 
+                  ##
+                  # The effective universe domain
+                  #
+                  # @return [String]
+                  #
+                  def universe_domain
+                    @database_admin_stub.universe_domain
+                  end
+
                   ##
                   # Create a new DatabaseAdmin REST client object.
                   #
@@ -209,8 +221,9 @@ module Google
                     credentials = @config.credentials
                     # Use self-signed JWT if the endpoint is unchanged from default,
                     # but only if the default endpoint does not have a region prefix.
-                    enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
-                                             !@config.endpoint.split(".").first.include?("-")
+                    enable_self_signed_jwt = @config.endpoint.nil? ||
+                                             (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
+                                             !@config.endpoint.split(".").first.include?("-"))
                     credentials ||= Credentials.default scope: @config.scope,
                                                         enable_self_signed_jwt: enable_self_signed_jwt
                     if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -224,9 +237,15 @@ module Google
                       config.credentials = credentials
                       config.quota_project = @quota_project_id
                       config.endpoint = @config.endpoint
+                      config.universe_domain = @config.universe_domain
                     end
 
-                    @database_admin_stub = ::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
+                    @database_admin_stub = ::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::ServiceStub.new(
+                      endpoint: @config.endpoint,
+                      endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
+                      universe_domain: @config.universe_domain,
+                      credentials: credentials
+                    )
                   end
 
                   ##
@@ -273,6 +292,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 +400,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 +487,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 +605,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 +719,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 +809,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 +891,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 +987,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 +1076,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 +1169,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 +1275,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 +1396,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 +1484,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 +1571,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 +1651,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 +1776,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 +1894,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 +2039,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 +2207,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 +2299,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?
 
@@ -1984,9 +2385,9 @@ module Google
                   #   end
                   #
                   # @!attribute [rw] endpoint
-                  #   The hostname or hostname:port of the service endpoint.
-                  #   Defaults to `"spanner.googleapis.com"`.
-                  #   @return [::String]
+                  #   A custom service endpoint, as a hostname or hostname:port. The default is
+                  #   nil, indicating to use the default endpoint in the current universe domain.
+                  #   @return [::String,nil]
                   # @!attribute [rw] credentials
                   #   Credentials to send with calls. You may provide any of the following types:
                   #    *  (`String`) The path to a service account key file in JSON format
@@ -2023,13 +2424,20 @@ module Google
                   # @!attribute [rw] quota_project
                   #   A separate project against which to charge quota.
                   #   @return [::String]
+                  # @!attribute [rw] universe_domain
+                  #   The universe domain within which to make requests. This determines the
+                  #   default endpoint URL. The default value of nil uses the environment
+                  #   universe (usually the default "googleapis.com" universe).
+                  #   @return [::String,nil]
                   #
                   class Configuration
                     extend ::Gapic::Config
 
+                    # @private
+                    # The endpoint specific to the default "googleapis.com" universe. Deprecated.
                     DEFAULT_ENDPOINT = "spanner.googleapis.com"
 
-                    config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
+                    config_attr :endpoint,      nil, ::String, nil
                     config_attr :credentials,   nil do |value|
                       allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                       allowed.any? { |klass| klass === value }
@@ -2041,6 +2449,7 @@ module Google
                     config_attr :metadata,      nil, ::Hash, nil
                     config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                     config_attr :quota_project, nil, ::String, nil
+                    config_attr :universe_domain, nil, ::String, nil
 
                     # @private
                     def initialize parent_config = nil