google-cloud-spanner 1.15.0 → 2.1.0

data/lib/google/cloud/spanner/database/job.rb

@@ -14,6 +14,7 @@
 
 
 require "google/cloud/spanner/status"
+require "google/cloud/spanner/database/job/list"
 
 module Google
   module Cloud
@@ -51,7 +52,7 @@ module Google
         #
         class Job
           ##
-          # @private The Google::Gax::Operation gRPC object.
+          # @private The `Gapic::Operation` gRPC object.
           attr_accessor :grpc
 
           ##
@@ -87,6 +88,8 @@ module Google
           def database
             return nil unless done?
             return nil unless @grpc.grpc_op.result == :response
+            return nil unless @grpc.results.instance_of? \
+              Admin::Database::V1::Database
             Database.from_grpc @grpc.results, service
           end
 
@@ -198,7 +201,7 @@ module Google
           end
 
           ##
-          # @private New Database::Job from a Google::Gax::Operation object.
+          # @private New Database::Job from a `Gapic::Operation` object.
           def self.from_grpc grpc, service
             new.tap do |job|
               job.instance_variable_set :@grpc, grpc

data/lib/google/cloud/spanner/database/job/list.rb

@@ -0,0 +1,177 @@
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "delegate"
+
+module Google
+  module Cloud
+    module Spanner
+      class Database
+        class Job
+          ##
+          # # List
+          #
+          # List is a special case Array with additional values for database
+          # operations.
+          #
+          class List < DelegateClass(::Array)
+            # @private
+            # The gRPC Service object.
+            attr_accessor :service
+
+            # @private
+            # The gRPC page enumerable object.
+            attr_accessor :grpc
+
+            ##
+            # @private Create a new Database::Job::List with an array of
+            # Google::Lognrunning::Operation instances.
+            def initialize arr = []
+              super arr
+            end
+
+            ##
+            # Whether there is a next page of database jobs.
+            #
+            # @return [Boolean]
+            #
+            # @example
+            #   require "google/cloud/spanner"
+            #
+            #   spanner = Google::Cloud::Spanner.new
+            #
+            #   instance = spanner.instance "my-instance"
+            #
+            #   jobs = instance.database_operations
+            #   if jobs.next?
+            #     next_jobs = jobs.next
+            #   end
+            #
+            def next?
+              grpc.next_page?
+            end
+
+            ##
+            # Retrieve the next page of database jobs.
+            #
+            # @return [Google::Cloud::Spanner::Database::Job::List]
+            #
+            # @example
+            #   require "google/cloud/spanner"
+            #
+            #   spanner = Google::Cloud::Spanner.new
+            #
+            #   instance = spanner.instance "my-instance"
+            #
+            #   jobs = instance.database_operations
+            #   if jobs.next?
+            #     next_jobs = jobs.next
+            #   end
+            #
+            def next
+              ensure_service!
+
+              return nil unless next?
+              grpc.next_page
+              self.class.from_grpc grpc, service
+            end
+
+            ##
+            # Retrieves remaining results by repeatedly invoking {#next} until
+            # {#next?} returns `false`. Calls the given block once for each
+            # result, which is passed as the argument to the block.
+            #
+            # An Enumerator is returned if no block is given.
+            #
+            # This method will make repeated API calls until all remaining
+            # results are retrieved. (Unlike `#each`, for example, which merely
+            # iterates over the results returned by a single API call.) Use with
+            # caution.
+            #
+            # @yield [job] The block for accessing each database job.
+            # @yieldparam [Google::Cloud::Spanner::Database::Job] job The
+            #   database job object.
+            #
+            # @return [Enumerator]
+            #
+            # @example Iterating each database job by passing a block:
+            #   require "google/cloud/spanner"
+            #
+            #   spanner = Google::Cloud::Spanner.new
+            #
+            #   instance = spanner.instance "my-instance"
+            #
+            #   jobs = instance.database_operations
+            #   jobs.all do |job|
+            #     puts job.database.database_id
+            #   end
+            #
+            # @example Using the enumerator by not passing a block:
+            #   require "google/cloud/spanner"
+            #
+            #   spanner = Google::Cloud::Spanner.new
+            #
+            #   instance = spanner.instance "my-instance"
+            #
+            #   jobs = instance.database_operations
+            #   all_database_ids = jobs.all.map do |job|
+            #     job.database.database_id
+            #   end
+            #
+            def all
+              return enum_for :all unless block_given?
+
+              results = self
+              loop do
+                results.each { |r| yield r }
+                break unless next?
+                grpc.next_page
+                results = self.class.from_grpc grpc, service
+              end
+            end
+
+            ##
+            # @private
+            #
+            # New Database::Job::List from a
+            # `Gapic::PagedEnumerable<Google::Longrunning::Operation>`
+            # object. Operation object is a database operation.
+            #
+            def self.from_grpc grpc, service
+              operations_client = \
+                service.databases.instance_variable_get "@operations_client"
+              jobs = new(Array(grpc.response.operations).map do |job_grpc|
+                Job.from_grpc \
+                  Gapic::Operation.new(job_grpc, operations_client),
+                  service
+              end)
+              jobs.grpc = grpc
+              jobs.service = service
+              jobs
+            end
+
+            protected
+
+            ##
+            # Raise an error unless an active service is available.
+            def ensure_service!
+              raise "Must have active connection" unless @service
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/spanner/database/list.rb

@@ -142,7 +142,7 @@ module Google
 
           ##
           # @private New Database::List from a
-          # Google::Spanner::Admin::Database::V1::ListDatabasesResponse
+          # `Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse`
           # object.
           def self.from_grpc grpc, service, instance_id, max = nil
             databases = List.new(Array(grpc.databases).map do |database|

data/lib/google/cloud/spanner/database/restore_info.rb

@@ -0,0 +1,63 @@
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/cloud/spanner/database/backup_info"
+
+module Google
+  module Cloud
+    module Spanner
+      class Database
+        class RestoreInfo
+          ##
+          # @private Creates a new Database::RestoreInfo instance.
+          def initialize grpc
+            @grpc = grpc
+          end
+
+          ##
+          # The database restored from source type `:BACKUP`.
+          # @return [Symbol]
+          def source_type
+            @grpc.source_type
+          end
+
+          ##
+          # Database restored from backup.
+          #
+          # @return [Boolean]
+          def source_backup?
+            @grpc.source_type == :BACKUP
+          end
+
+          # Information about the backup used to restore the database.
+          # The backup may no longer exist.
+          #
+          # @return [Google::Cloud::Spanner::Database::BackupInfo, nil]
+          def backup_info
+            return nil unless @grpc.backup_info
+            BackupInfo.from_grpc @grpc.backup_info
+          end
+
+          ##
+          # @private Creates a new Database::RestoreInfo instance from a
+          # `Google::Cloud::Spanner::Admin::Database::V1::RestoreInfo`
+          def self.from_grpc grpc
+            new grpc
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -372,9 +372,9 @@ module Google
         ##
         # @private
         def to_grpc_type
-          Google::Spanner::V1::Type.new(
+          V1::Type.new(
             code: :STRUCT,
-            struct_type: Google::Spanner::V1::StructType.new(
+            struct_type: V1::StructType.new(
               fields: @grpc_fields
             )
           )
@@ -382,7 +382,7 @@ module Google
 
         ##
         # @private Creates a new Fields instance from a
-        # Google::Spanner::V1::Metadata::Row_type::Fields.
+        # V1::Metadata::Row_type::Fields.
         def self.from_grpc fields
           new([]).tap do |f|
             f.instance_variable_set :@grpc_fields, Array(fields)
@@ -412,18 +412,18 @@ module Google
           if pair.is_a?(Array)
             if pair.count == 2
               if pair.first.is_a?(Integer)
-                Google::Spanner::V1::StructType::Field.new(
+                V1::StructType::Field.new(
                   type: Convert.grpc_type_for_field(pair.last)
                 )
               else
-                Google::Spanner::V1::StructType::Field.new(
+                V1::StructType::Field.new(
                   name: String(pair.first),
                   type: Convert.grpc_type_for_field(pair.last)
                 )
               end
             else
-              Google::Spanner::V1::StructType::Field.new(
-                type: Google::Spanner::V1::Type.new(
+              V1::StructType::Field.new(
+                type: V1::Type.new(
                   code: :ARRAY,
                   array_element_type: Convert.grpc_type_for_field(pair.last)
                 )
@@ -435,7 +435,7 @@ module Google
             unless pair.is_a?(Symbol)
               raise ArgumentError, "type must be a symbol"
             end
-            Google::Spanner::V1::StructType::Field.new(
+            V1::StructType::Field.new(
               type: Convert.grpc_type_for_field(pair)
             )
           end

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

@@ -334,6 +334,406 @@ module Google
           Database::Job.from_grpc grpc, service
         end
 
+        ##
+        # Retrieves the list of database operations for the given instance.
+        #
+        # @param filter [String]
+        #   A filter expression that filters what operations are returned in the
+        #   response.
+        #
+        #   The response returns a list of
+        #  `Google::Longrunning::Operation` long-running operations whose names
+        #   are prefixed by a database name within the specified instance.
+        #   The long-running operation
+        #   `Google::Longrunning::Operation#metadata` metadata field type
+        #   `metadata.type_url` describes the type of the metadata.
+        #
+        #   The filter expression must specify the field name,
+        #   a comparison operator, and the value that you want to use for
+        #   filtering. The value must be a string, a number, or a boolean.
+        #   The comparison operator must be
+        #   <, >, <=, >=, !=, =, or :. Colon ':' represents a HAS operator
+        #   which is roughly synonymous with equality. Filter rules are case
+        #   insensitive.
+        #
+        #   The long-running operation fields eligible for filtering are:
+        #     * `name` --> The name of the long-running operation
+        #     * `done` --> False if the operation is in progress, else true.
+        #     * `metadata.type_url` (using filter string `metadata.@type`) and
+        #       fields in `metadata.value` (using filter string
+        #       `metadata.<field_name>`, where <field_name> is a field in
+        #       metadata.value) are eligible for filtering.
+        #     * `error` --> Error associated with the long-running operation.
+        #     * `response.type_url` (using filter string `response.@type`) and
+        #       fields in `response.value` (using filter string
+        #       `response.<field_name>`, where <field_name> is a field in
+        #       response.value)are eligible for filtering.
+        #
+        #     To filter on multiple expressions, provide each separate
+        #     expression within parentheses. By default, each expression
+        #     is an AND expression. However, you can include AND, OR, and NOT
+        #     expressions explicitly.
+        #
+        #   Some examples of using filters are:
+        #
+        #     * `done:true` --> The operation is complete.
+        #     * `(metadata.@type:type.googleapis.com/google.spanner.admin.\
+        #       database.v1.RestoreDatabaseMetadata)
+        #       AND (metadata.source_type:BACKUP)
+        #       AND (metadata.backup_info.backup:backup_howl)
+        #       AND (metadata.name:restored_howl)
+        #       AND (metadata.progress.start_time < \"2018-03-28T14:50:00Z\")
+        #       AND (error:*)`
+        #       --> Return RestoreDatabase operations from backups whose name
+        #       contains "backup_howl", where the created database name
+        #       contains the string "restored_howl", the start_time of the
+        #       restore operation is before 2018-03-28T14:50:00Z,
+        #       and the operation returned an error.
+        # @param page_size [Integer]
+        #   The maximum number of resources contained in the underlying API
+        #   response. If page streaming is performed per-resource, this
+        #   parameter does not affect the return value. If page streaming is
+        #   performed per-page, this determines the maximum number of
+        #   resources in a page.
+        #
+        # @return [Array<Google::Cloud::Spanner::Database::Job>] List
+        #   representing the long-running, asynchronous processing
+        #   of a database operations.
+        #   (See {Google::Cloud::Spanner::Database::Job::List})
+        #
+        # @example
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.database_operations
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       p job.database.database_id
+        #     end
+        #   end
+        #
+        # @example Retrieve all
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.database_operations
+        #   jobs.all do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       puts job.database.database_id
+        #     end
+        #   end
+        #
+        # @example List by page size
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.database_operations page_size: 10
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       puts job.database.database_id
+        #     end
+        #   end
+        #
+        # @example Filter and list
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   filter = "metadata.@type:CreateDatabaseMetadata"
+        #   jobs = instance.database_operations filter: filter
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       puts job.database.database_id
+        #     end
+        #   end
+        #
+        def database_operations filter: nil, page_size: nil
+          grpc = service.list_database_operations \
+            instance_id,
+            filter: filter,
+            page_size: page_size
+          Database::Job::List.from_grpc grpc, service
+        end
+
+        ##
+        # Retrieves backups belonging to the instance.
+        #
+        # @param [String] filter Optional. A filter expression that filters
+        #   backups listed in the response. The expression must specify the
+        #   field name, a comparison operator, and the value that you want to
+        #   use for filtering. The value must be a string, a number, or a
+        #   boolean. The comparison operator must be
+        #   <, >, <=, >=, !=, =, or :. Colon ':' represents a HAS operator
+        #   which is roughly synonymous with equality.
+        #   Filter rules are case insensitive.
+        #
+        #   The fields eligible for filtering are:
+        #     * `name`
+        #     * `database`
+        #     * `state`
+        #     * `create_time`(and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+        #     * `expire_time`(and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+        #     * `size_bytes`
+        #
+        #   To filter on multiple expressions, provide each separate expression
+        #   within parentheses. By default, each expression is an AND
+        #   expression. However, you can include AND, OR, and NOT expressions
+        #   explicitly.
+        #
+        #   Some examples of using filters are:
+        #
+        #     * `name:Howl` --> The backup's name contains the string "howl".
+        #     * `database:prod`
+        #          --> The database's name contains the string "prod".
+        #     * `state:CREATING` --> The backup is pending creation.
+        #     * `state:READY` --> The backup is fully created and ready for use.
+        #     * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")`
+        #          --> The backup name contains the string "howl" and
+        #              `create_time` of the backup is before
+        #               2018-03-28T14:50:00Z.
+        #     * `expire_time < \"2018-03-28T14:50:00Z\"`
+        #          --> The backup `expire_time` is before 2018-03-28T14:50:00Z.
+        #     * `size_bytes > 10000000000` -->
+        #              The backup's size is greater than 10GB
+        # @param [Integer] page_size Optional. Number of backups to be returned
+        #   in the response. If 0 or less, defaults to the server's maximum
+        #   allowed page size.
+        # @return [Array<Google::Cloud::Spanner::Backup>] Enumerable list of
+        #   backups. (See {Google::Cloud::Spanner::Backup::List})
+        #
+        # @example
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #
+        #   instance.backups.all.each do |backup|
+        #     puts backup.backup_id
+        #   end
+        #
+        # @example List backups by page size
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #
+        #   instance.backups(page_size: 5).all.each do |backup|
+        #     puts backup.backup_id
+        #   end
+        #
+        # @example Filter and list backups
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #
+        #   # filter backups by name.
+        #   instance.backups(filter: "name:my-backup").all.each do |backup|
+        #     puts backup.backup_id
+        #   end
+        #
+        #   # filter backups by database name.
+        #   instance.backups(filter: "database:prod-db").all.each do |backup|
+        #     puts backup.backup_id
+        #   end
+        #
+        def backups filter: nil, page_size: nil
+          ensure_service!
+          grpc = service.list_backups \
+            instance_id,
+            filter: filter,
+            page_size: page_size
+          Backup::List.from_grpc grpc, service
+        end
+
+        ##
+        # Retrieves a backup belonging to the instance by identifier.
+        #
+        # @param [String] backup_id The unique identifier for the backup.
+        #
+        # @return [Google::Cloud::Spanner::Backup, nil] Returns `nil`
+        #   if database does not exist.
+        #
+        # @example
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #   backup = instance.backup "my-backup"
+        #
+        # @example Will return `nil` if backup does not exist.
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #   backup = instance.backup "non-existing-backup" # nil
+        #
+        def backup backup_id
+          ensure_service!
+          grpc = service.get_backup instance_id, backup_id
+          Backup.from_grpc grpc, service
+        rescue Google::Cloud::NotFoundError
+          nil
+        end
+
+        ##
+        # Retrieves the list of database backup operations for the given
+        # instance.
+        #
+        # @param filter [String]
+        #   A filter expression that filters what operations are returned in the
+        #   response.
+        #
+        #   The response returns a list of
+        #   `Google::Longrunning::Operation` long-running operations whose names
+        #   are prefixed by a backup name within the specified instance.
+        #   The long-running operation
+        #   `Google::Longrunning::Operation#metadata` metadata field type
+        #   `metadata.type_url` describes the type of the metadata.
+        #
+        #   The filter expression must specify the field name of an operation, a
+        #   comparison operator, and the value that you want to use for
+        #   filtering.
+        #   The value must be a string, a number, or a boolean. The comparison
+        #   operator must be
+        #   <, >, <=, >=, !=, =, or :. Colon ':'' represents a HAS operator
+        #   which is roughly synonymous with equality. Filter rules are case
+        #   insensitive.
+        #
+        #   The long-running operation fields eligible for filtering are:
+        #     * `name` --> The name of the long-running operation
+        #     * `done` --> False if the operation is in progress, else true.
+        #     * `metadata.type_url` (using filter string `metadata.@type`) and
+        #       fields in `metadata.value` (using filter string
+        #       `metadata.<field_name>`, where <field_name> is a field in
+        #       metadata.value) are eligible for filtering.
+        #     * `error` --> Error associated with the long-running operation.
+        #     * `response.type_url` (using filter string `response.@type`) and
+        #       fields in `response.value` (using filter string
+        #       `response.<field_name>`, where <field_name> is a field in
+        #       response.value) are eligible for filtering.
+        #
+        #     To filter on multiple expressions, provide each separate
+        #     expression within parentheses. By default, each expression is an
+        #     AND expression. However, you can include AND, OR, and NOT
+        #     expressions explicitly.
+        #
+        #   Some examples of using filters are:
+        #
+        #     * `done:true` --> The operation is complete.
+        #     * `metadata.database:prod`
+        #       --> The database the backup was taken from has a name containing
+        #       the string "prod".
+        #     * `(metadata.@type:type.googleapis.com/google.spanner.admin.\
+        #       database.v1.CreateBackupMetadata)
+        #       AND (metadata.name:howl)
+        #       AND (metadata.progress.start_time < \"2018-03-28T14:50:00Z\")
+        #       AND (error:*)`
+        #       --> Return CreateBackup operations where the created backup name
+        #       contains the string "howl", the progress.start_time of the
+        #       backup operation is before 2018-03-28T14:50:00Z, and the
+        #       operation returned an error.
+        # @param page_size [Integer]
+        #   The maximum number of resources contained in the underlying API
+        #   response. If page streaming is performed per-resource, this
+        #   parameter does not affect the return value. If page streaming is
+        #   performed per-page, this determines the maximum number of
+        #   resources in a page.
+        #
+        # @return [Array<Google::Cloud::Spanner::Backup::Job>] List representing
+        #   the long-running, asynchronous processing of a backup operations.
+        #   (See {Google::Cloud::Spanner::Backup::Job::List})
+        #
+        # @example
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.backup_operations
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       p job.backup.backup_id
+        #     end
+        #   end
+        #
+        # @example Retrieve all
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.backup_operations
+        #   jobs.all do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       p job.backup.backup_id
+        #     end
+        #   end
+        #
+        # @example List by page size
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #   instance = spanner.instance "my-instance"
+        #
+        #   jobs = instance.backup_operations page_size: 10
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       puts job.backup.backup_id
+        #     end
+        #   end
+        #
+        # @example Filter and list
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #
+        #   filter = "metadata.@type:CreateBackupMetadata"
+        #   jobs = instance.backup_operations filter: filter
+        #   jobs.each do |job|
+        #     if job.error?
+        #       p job.error
+        #     else
+        #       puts job.backup.backup_id
+        #     end
+        #   end
+        #
+        def backup_operations filter: nil, page_size: nil
+          grpc = service.list_backup_operations \
+            instance_id,
+            filter: filter,
+            page_size: page_size
+          Backup::Job::List.from_grpc grpc, service
+        end
+
         ##
         # Gets the [Cloud IAM](https://cloud.google.com/iam/) access control
         # policy for this instance.
@@ -456,7 +856,7 @@ module Google
 
         ##
         # @private Creates a new Instance instance from a
-        # Google::Spanner::Admin::Instance::V1::Instance.
+        # `Google::Cloud::Spanner::Admin::Instance::V1::Instance`.
         def self.from_grpc grpc, service
           new grpc, service
         end
@@ -469,13 +869,6 @@ module Google
         def ensure_service!
           raise "Must have active connection to service" unless service
         end
-
-        def instance_config_path name
-          return name if name.to_s.include? "/"
-          Admin::Instance::V1::InstanceAdminClient.instance_config_path(
-            project, name.to_s
-          )
-        end
       end
     end
   end