google-cloud-spanner 0.21.0

data/lib/google/cloud/spanner/v1/spanner_client_config.json

@@ -0,0 +1,78 @@
+{
+  "interfaces": {
+    "google.spanner.v1.Spanner": {
+      "retry_codes": {
+        "idempotent": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ],
+        "non_idempotent": [
+          "UNAVAILABLE"
+        ]
+      },
+      "retry_params": {
+        "default": {
+          "initial_retry_delay_millis": 1000,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 32000,
+          "initial_rpc_timeout_millis": 60000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 60000,
+          "total_timeout_millis": 600000
+        }
+      },
+      "methods": {
+        "CreateSession": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GetSession": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "DeleteSession": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ExecuteSql": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "ExecuteStreamingSql": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "Read": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "StreamingRead": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "BeginTransaction": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "Commit": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "Rollback": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,22 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# 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
+#
+#     http://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.
+
+
+module Google
+  module Cloud
+    module Spanner
+      VERSION = "0.21.0"
+    end
+  end
+end

data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb

@@ -0,0 +1,85 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/admin/database/v1/spanner_database_admin.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/auth_pb'
+require 'google/iam/v1/iam_policy_pb'
+require 'google/iam/v1/policy_pb'
+require 'google/longrunning/operations_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.admin.database.v1.Database" do
+    optional :name, :string, 1
+    optional :state, :enum, 2, "google.spanner.admin.database.v1.Database.State"
+  end
+  add_enum "google.spanner.admin.database.v1.Database.State" do
+    value :STATE_UNSPECIFIED, 0
+    value :CREATING, 1
+    value :READY, 2
+  end
+  add_message "google.spanner.admin.database.v1.ListDatabasesRequest" do
+    optional :parent, :string, 1
+    optional :page_size, :int32, 3
+    optional :page_token, :string, 4
+  end
+  add_message "google.spanner.admin.database.v1.ListDatabasesResponse" do
+    repeated :databases, :message, 1, "google.spanner.admin.database.v1.Database"
+    optional :next_page_token, :string, 2
+  end
+  add_message "google.spanner.admin.database.v1.CreateDatabaseRequest" do
+    optional :parent, :string, 1
+    optional :create_statement, :string, 2
+    repeated :extra_statements, :string, 3
+  end
+  add_message "google.spanner.admin.database.v1.CreateDatabaseMetadata" do
+    optional :database, :string, 1
+  end
+  add_message "google.spanner.admin.database.v1.GetDatabaseRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.admin.database.v1.UpdateDatabaseDdlRequest" do
+    optional :database, :string, 1
+    repeated :statements, :string, 2
+    optional :operation_id, :string, 3
+  end
+  add_message "google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata" do
+    optional :database, :string, 1
+    repeated :statements, :string, 2
+    repeated :commit_timestamps, :message, 3, "google.protobuf.Timestamp"
+  end
+  add_message "google.spanner.admin.database.v1.DropDatabaseRequest" do
+    optional :database, :string, 1
+  end
+  add_message "google.spanner.admin.database.v1.GetDatabaseDdlRequest" do
+    optional :database, :string, 1
+  end
+  add_message "google.spanner.admin.database.v1.GetDatabaseDdlResponse" do
+    repeated :statements, :string, 1
+  end
+end
+
+module Google
+  module Spanner
+    module Admin
+      module Database
+        module V1
+          Database = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.Database").msgclass
+          Database::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.Database.State").enummodule
+          ListDatabasesRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.ListDatabasesRequest").msgclass
+          ListDatabasesResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.ListDatabasesResponse").msgclass
+          CreateDatabaseRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateDatabaseRequest").msgclass
+          CreateDatabaseMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateDatabaseMetadata").msgclass
+          GetDatabaseRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.GetDatabaseRequest").msgclass
+          UpdateDatabaseDdlRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseDdlRequest").msgclass
+          UpdateDatabaseDdlMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata").msgclass
+          DropDatabaseRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.DropDatabaseRequest").msgclass
+          GetDatabaseDdlRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.GetDatabaseDdlRequest").msgclass
+          GetDatabaseDdlResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.GetDatabaseDdlResponse").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb

@@ -0,0 +1,95 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/spanner/admin/database/v1/spanner_database_admin.proto for package 'google.spanner.admin.database.v1'
+# Original file comments:
+# Copyright 2017 Google Inc.
+#
+# 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
+#
+#     http://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 'grpc'
+require 'google/spanner/admin/database/v1/spanner_database_admin_pb'
+
+module Google
+  module Spanner
+    module Admin
+      module Database
+        module V1
+          module DatabaseAdmin
+            # 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.
+            class Service
+
+              include GRPC::GenericService
+
+              self.marshal_class_method = :encode
+              self.unmarshal_class_method = :decode
+              self.service_name = 'google.spanner.admin.database.v1.DatabaseAdmin'
+
+              # Lists Cloud Spanner databases.
+              rpc :ListDatabases, ListDatabasesRequest, ListDatabasesResponse
+              # Creates a new Cloud Spanner database and starts to prepare it for serving.
+              # The returned [long-running operation][google.longrunning.Operation] will
+              # have a name of the format `<database_name>/operations/<operation_id>` and
+              # can be used to track preparation of the database. The
+              # [metadata][google.longrunning.Operation.metadata] field type is
+              # [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+              # [response][google.longrunning.Operation.response] field type is
+              # [Database][google.spanner.admin.database.v1.Database], if successful.
+              rpc :CreateDatabase, CreateDatabaseRequest, Google::Longrunning::Operation
+              # Gets the state of a Cloud Spanner database.
+              rpc :GetDatabase, GetDatabaseRequest, Database
+              # Updates the schema of a Cloud Spanner database by
+              # creating/altering/dropping tables, columns, indexes, etc. The returned
+              # [long-running operation][google.longrunning.Operation] will have a name of
+              # the format `<database_name>/operations/<operation_id>` and can be used to
+              # track execution of the schema change(s). The
+              # [metadata][google.longrunning.Operation.metadata] field type is
+              # [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
+              rpc :UpdateDatabaseDdl, UpdateDatabaseDdlRequest, Google::Longrunning::Operation
+              # Drops (aka deletes) a Cloud Spanner database.
+              rpc :DropDatabase, DropDatabaseRequest, Google::Protobuf::Empty
+              # Returns the schema of a Cloud Spanner database as a list of formatted
+              # DDL statements. This method does not show pending schema updates, those may
+              # be queried using the [Operations][google.longrunning.Operations] API.
+              rpc :GetDatabaseDdl, GetDatabaseDdlRequest, GetDatabaseDdlResponse
+              # Sets the access control policy on a database resource. Replaces any
+              # existing policy.
+              #
+              # Authorization requires `spanner.databases.setIamPolicy` permission on
+              # [resource][google.iam.v1.SetIamPolicyRequest.resource].
+              rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
+              # Gets the access control policy for a database resource. Returns an empty
+              # policy if a database exists but does not have a policy set.
+              #
+              # Authorization requires `spanner.databases.getIamPolicy` permission on
+              # [resource][google.iam.v1.GetIamPolicyRequest.resource].
+              rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
+              # Returns permissions that the caller has on the specified database resource.
+              #
+              # Attempting this RPC on a non-existent Cloud Spanner database will result in
+              # a NOT_FOUND error if the user has `spanner.databases.list` permission on
+              # the containing Cloud Spanner instance. Otherwise returns an empty set of
+              # permissions.
+              rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
+            end
+
+            Stub = Service.rpc_stub_class
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb

@@ -0,0 +1,106 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/admin/instance/v1/spanner_instance_admin.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/auth_pb'
+require 'google/iam/v1/iam_policy_pb'
+require 'google/iam/v1/policy_pb'
+require 'google/longrunning/operations_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.admin.instance.v1.InstanceConfig" do
+    optional :name, :string, 1
+    optional :display_name, :string, 2
+  end
+  add_message "google.spanner.admin.instance.v1.Instance" do
+    optional :name, :string, 1
+    optional :config, :string, 2
+    optional :display_name, :string, 3
+    optional :node_count, :int32, 5
+    optional :state, :enum, 6, "google.spanner.admin.instance.v1.Instance.State"
+    map :labels, :string, :string, 7
+  end
+  add_enum "google.spanner.admin.instance.v1.Instance.State" do
+    value :STATE_UNSPECIFIED, 0
+    value :CREATING, 1
+    value :READY, 2
+  end
+  add_message "google.spanner.admin.instance.v1.ListInstanceConfigsRequest" do
+    optional :parent, :string, 1
+    optional :page_size, :int32, 2
+    optional :page_token, :string, 3
+  end
+  add_message "google.spanner.admin.instance.v1.ListInstanceConfigsResponse" do
+    repeated :instance_configs, :message, 1, "google.spanner.admin.instance.v1.InstanceConfig"
+    optional :next_page_token, :string, 2
+  end
+  add_message "google.spanner.admin.instance.v1.GetInstanceConfigRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.admin.instance.v1.GetInstanceRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.admin.instance.v1.CreateInstanceRequest" do
+    optional :parent, :string, 1
+    optional :instance_id, :string, 2
+    optional :instance, :message, 3, "google.spanner.admin.instance.v1.Instance"
+  end
+  add_message "google.spanner.admin.instance.v1.ListInstancesRequest" do
+    optional :parent, :string, 1
+    optional :page_size, :int32, 2
+    optional :page_token, :string, 3
+    optional :filter, :string, 4
+  end
+  add_message "google.spanner.admin.instance.v1.ListInstancesResponse" do
+    repeated :instances, :message, 1, "google.spanner.admin.instance.v1.Instance"
+    optional :next_page_token, :string, 2
+  end
+  add_message "google.spanner.admin.instance.v1.UpdateInstanceRequest" do
+    optional :instance, :message, 1, "google.spanner.admin.instance.v1.Instance"
+    optional :field_mask, :message, 2, "google.protobuf.FieldMask"
+  end
+  add_message "google.spanner.admin.instance.v1.DeleteInstanceRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.admin.instance.v1.CreateInstanceMetadata" do
+    optional :instance, :message, 1, "google.spanner.admin.instance.v1.Instance"
+    optional :start_time, :message, 2, "google.protobuf.Timestamp"
+    optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
+    optional :end_time, :message, 4, "google.protobuf.Timestamp"
+  end
+  add_message "google.spanner.admin.instance.v1.UpdateInstanceMetadata" do
+    optional :instance, :message, 1, "google.spanner.admin.instance.v1.Instance"
+    optional :start_time, :message, 2, "google.protobuf.Timestamp"
+    optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
+    optional :end_time, :message, 4, "google.protobuf.Timestamp"
+  end
+end
+
+module Google
+  module Spanner
+    module Admin
+      module Instance
+        module V1
+          InstanceConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.InstanceConfig").msgclass
+          Instance = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance").msgclass
+          Instance::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance.State").enummodule
+          ListInstanceConfigsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigsRequest").msgclass
+          ListInstanceConfigsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigsResponse").msgclass
+          GetInstanceConfigRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.GetInstanceConfigRequest").msgclass
+          GetInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.GetInstanceRequest").msgclass
+          CreateInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceRequest").msgclass
+          ListInstancesRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstancesRequest").msgclass
+          ListInstancesResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstancesResponse").msgclass
+          UpdateInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.UpdateInstanceRequest").msgclass
+          DeleteInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.DeleteInstanceRequest").msgclass
+          CreateInstanceMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceMetadata").msgclass
+          UpdateInstanceMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.UpdateInstanceMetadata").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb

@@ -0,0 +1,180 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/spanner/admin/instance/v1/spanner_instance_admin.proto for package 'google.spanner.admin.instance.v1'
+# Original file comments:
+# Copyright 2017 Google Inc.
+#
+# 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
+#
+#     http://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 'grpc'
+require 'google/spanner/admin/instance/v1/spanner_instance_admin_pb'
+
+module Google
+  module Spanner
+    module Admin
+      module Instance
+        module V1
+          module InstanceAdmin
+            # Cloud Spanner Instance Admin API
+            #
+            # The Cloud Spanner Instance Admin API can be used to create, delete,
+            # modify and list instances. Instances are dedicated Cloud Spanner serving
+            # and storage resources to be used by Cloud Spanner databases.
+            #
+            # Each instance has a "configuration", which dictates where the
+            # serving resources for the Cloud Spanner instance are located (e.g.,
+            # US-central, Europe). Configurations are created by Google based on
+            # resource availability.
+            #
+            # Cloud Spanner billing is based on the instances that exist and their
+            # sizes. After an instance exists, there are no additional
+            # per-database or per-operation charges for use of the instance
+            # (though there may be additional network bandwidth charges).
+            # Instances offer isolation: problems with databases in one instance
+            # will not affect other instances. However, within an instance
+            # databases can affect each other. For example, if one database in an
+            # instance receives a lot of requests and consumes most of the
+            # instance resources, fewer resources are available for other
+            # databases in that instance, and their performance may suffer.
+            class Service
+
+              include GRPC::GenericService
+
+              self.marshal_class_method = :encode
+              self.unmarshal_class_method = :decode
+              self.service_name = 'google.spanner.admin.instance.v1.InstanceAdmin'
+
+              # Lists the supported instance configurations for a given project.
+              rpc :ListInstanceConfigs, ListInstanceConfigsRequest, ListInstanceConfigsResponse
+              # Gets information about a particular instance configuration.
+              rpc :GetInstanceConfig, GetInstanceConfigRequest, InstanceConfig
+              # Lists all instances in the given project.
+              rpc :ListInstances, ListInstancesRequest, ListInstancesResponse
+              # Gets information about a particular instance.
+              rpc :GetInstance, GetInstanceRequest, Instance
+              # Creates an instance and begins preparing it to begin serving. The
+              # returned [long-running operation][google.longrunning.Operation]
+              # can be used to track the progress of preparing the new
+              # instance. The instance name is assigned by the caller. If the
+              # named instance already exists, `CreateInstance` returns
+              # `ALREADY_EXISTS`.
+              #
+              # Immediately upon completion of this request:
+              #
+              #   * The instance is readable via the API, with all requested attributes
+              #     but no allocated resources. Its state is `CREATING`.
+              #
+              # Until completion of the returned operation:
+              #
+              #   * Cancelling the operation renders the instance immediately unreadable
+              #     via the API.
+              #   * The instance can be deleted.
+              #   * All other attempts to modify the instance are rejected.
+              #
+              # Upon completion of the returned operation:
+              #
+              #   * Billing for all successfully-allocated resources begins (some types
+              #     may have lower than the requested levels).
+              #   * Databases can be created in the instance.
+              #   * The instance's allocated resource levels are readable via the API.
+              #   * The instance's state becomes `READY`.
+              #
+              # The returned [long-running operation][google.longrunning.Operation] will
+              # have a name of the format `<instance_name>/operations/<operation_id>` and
+              # can be used to track creation of the instance.  The
+              # [metadata][google.longrunning.Operation.metadata] field type is
+              # [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata].
+              # The [response][google.longrunning.Operation.response] field type is
+              # [Instance][google.spanner.admin.instance.v1.Instance], if successful.
+              rpc :CreateInstance, CreateInstanceRequest, Google::Longrunning::Operation
+              # Updates an instance, and begins allocating or releasing resources
+              # as requested. The returned [long-running
+              # operation][google.longrunning.Operation] can be used to track the
+              # progress of updating the instance. If the named instance does not
+              # exist, returns `NOT_FOUND`.
+              #
+              # Immediately upon completion of this request:
+              #
+              #   * For resource types for which a decrease in the instance's allocation
+              #     has been requested, billing is based on the newly-requested level.
+              #
+              # Until completion of the returned operation:
+              #
+              #   * Cancelling the operation sets its metadata's
+              #     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins
+              #     restoring resources to their pre-request values. The operation
+              #     is guaranteed to succeed at undoing all resource changes,
+              #     after which point it terminates with a `CANCELLED` status.
+              #   * All other attempts to modify the instance are rejected.
+              #   * Reading the instance via the API continues to give the pre-request
+              #     resource levels.
+              #
+              # Upon completion of the returned operation:
+              #
+              #   * Billing begins for all successfully-allocated resources (some types
+              #     may have lower than the requested levels).
+              #   * All newly-reserved resources are available for serving the instance's
+              #     tables.
+              #   * The instance's new resource levels are readable via the API.
+              #
+              # The returned [long-running operation][google.longrunning.Operation] will
+              # have a name of the format `<instance_name>/operations/<operation_id>` and
+              # can be used to track the instance modification.  The
+              # [metadata][google.longrunning.Operation.metadata] field type is
+              # [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata].
+              # The [response][google.longrunning.Operation.response] field type is
+              # [Instance][google.spanner.admin.instance.v1.Instance], if successful.
+              #
+              # Authorization requires `spanner.instances.update` permission on
+              # resource [name][google.spanner.admin.instance.v1.Instance.name].
+              rpc :UpdateInstance, UpdateInstanceRequest, Google::Longrunning::Operation
+              # Deletes an instance.
+              #
+              # Immediately upon completion of the request:
+              #
+              #   * Billing ceases for all of the instance's reserved resources.
+              #
+              # Soon afterward:
+              #
+              #   * The instance and *all of its databases* immediately and
+              #     irrevocably disappear from the API. All data in the databases
+              #     is permanently deleted.
+              rpc :DeleteInstance, DeleteInstanceRequest, Google::Protobuf::Empty
+              # Sets the access control policy on an instance resource. Replaces any
+              # existing policy.
+              #
+              # Authorization requires `spanner.instances.setIamPolicy` on
+              # [resource][google.iam.v1.SetIamPolicyRequest.resource].
+              rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
+              # Gets the access control policy for an instance resource. Returns an empty
+              # policy if an instance exists but does not have a policy set.
+              #
+              # Authorization requires `spanner.instances.getIamPolicy` on
+              # [resource][google.iam.v1.GetIamPolicyRequest.resource].
+              rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
+              # Returns permissions that the caller has on the specified instance resource.
+              #
+              # Attempting this RPC on a non-existent Cloud Spanner instance resource will
+              # result in a NOT_FOUND error if the user has `spanner.instances.list`
+              # permission on the containing Google Cloud Project. Otherwise returns an
+              # empty set of permissions.
+              rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
+            end
+
+            Stub = Service.rpc_stub_class
+          end
+        end
+      end
+    end
+  end
+end