google-cloud-spanner 2.10.1 → 2.11.0

data/lib/google/cloud/spanner/instance.rb

@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# DO NOT EDIT: Unless you're fixing a P0/P1 and/or a security issue. This class
+# is frozen to all new features from `google-cloud-spanner/v2.11.0` onwards.
+
 
 require "google/cloud/spanner/instance/job"
 require "google/cloud/spanner/instance/list"
@@ -25,6 +28,13 @@ module Google
       ##
       # # Instance
       #
+      # NOTE: From `google-cloud-spanner/v2.11.0` onwards, new features for
+      # mananging instances will only be available through the
+      # [google-cloud-spanner-admin-instance-v1](https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-spanner-admin-instance-v1)
+      # client. See the
+      # [README](https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-spanner#google-cloud-spanner)
+      # for further details.
+      #
       # Represents a Cloud Spanner instance. Instances are dedicated Cloud
       # Spanner serving and storage resources to be used by Cloud Spanner
       # databases. Instances offer isolation: problems with databases in one
@@ -38,6 +48,10 @@ module Google
       # {Google::Cloud::Spanner::Project#instance}, and
       # {Google::Cloud::Spanner::Project#create_instance}.
       #
+      # @deprecated Use
+      # {Google::Cloud::Spanner::Admin::Instance#instance_admin}
+      # instead.
+      #
       # @example
       #   require "google/cloud/spanner"
       #

data/lib/google/cloud/spanner/project.rb

@@ -106,6 +106,10 @@ module Google
         # @return [Array<Google::Cloud::Spanner::Instance>] The list of
         #   instances. (See {Google::Cloud::Spanner::Instance::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#list_instances}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -140,6 +144,10 @@ module Google
         # @return [Google::Cloud::Spanner::Instance, nil] The instance, or `nil`
         #   if the instance does not exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#get_instance}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -200,6 +208,10 @@ module Google
         #   asynchronous processing of an instance create operation.
         # @raise [ArgumentError] if both processing_units or nodes are specified.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#create_instance}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -266,6 +278,10 @@ module Google
         #   instance configurations. (See
         #   {Google::Cloud::Spanner::Instance::Config::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#list_instance_configs}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -303,6 +319,10 @@ module Google
         #   configuration, or `nil` if the instance configuration does not
         #   exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#get_instance_config}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -335,6 +355,10 @@ module Google
         # @return [Array<Google::Cloud::Spanner::Database>] The list of
         #   databases. (See {Google::Cloud::Spanner::Database::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#list_databases}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -370,6 +394,10 @@ module Google
         # @return [Google::Cloud::Spanner::Database, nil] The database, or `nil`
         #   if the database does not exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#get_database}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -417,6 +445,10 @@ module Google
         # @return [Database::Job] The job representing the long-running,
         #   asynchronous processing of a database create operation.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#create_database}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -629,6 +661,9 @@ module Google
           raise "Must have active connection to service" unless service
         end
 
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#database_path}
+        # instead.
         def database_path instance_id, database_id
           Admin::Database::V1::DatabaseAdminClient.database_path(
             project, instance_id, database_id

data/lib/google/cloud/spanner/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "2.10.1".freeze
+      VERSION = "2.11.0".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner
 version: !ruby/object:Gem::Version
-  version: 2.10.1
+  version: 2.11.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-09 00:00:00.000000000 Z
+date: 2021-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -269,7 +269,9 @@ files:
 - TROUBLESHOOTING.md
 - lib/google-cloud-spanner.rb
 - lib/google/cloud/spanner.rb
+- lib/google/cloud/spanner/admin/database.rb
 - lib/google/cloud/spanner/admin/database/credentials.rb
+- lib/google/cloud/spanner/admin/instance.rb
 - lib/google/cloud/spanner/admin/instance/credentials.rb
 - lib/google/cloud/spanner/backup.rb
 - lib/google/cloud/spanner/backup/job.rb