google-cloud-spanner 1.0.0 → 1.1.0

data/lib/google/cloud/spanner/admin/instance/v1/doc/overview.rb

@@ -0,0 +1,57 @@
+# Copyright 2017, 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
+      module Admin
+        # rubocop:disable LineLength
+
+        ##
+        # # Ruby Client for Cloud Spanner Instance Admin API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+        #
+        # [Cloud Spanner Instance Admin API][Product Documentation]:
+        #
+        # - [Product Documentation][]
+        #
+        # ## Quick Start
+        # In order to use this library, you first need to go through the following
+        # steps:
+        #
+        # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+        # 2. [Enable the Cloud Spanner Instance Admin API.](https://console.cloud.google.com/apis/api/spanner-admin-instance)
+        # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+        #
+        # ### Installation
+        # ```
+        # $ gem install google-cloud-spanner-admin-instance
+        # ```
+        #
+        # ### Next Steps
+        # - Read the [Cloud Spanner Instance Admin API Product documentation][Product Documentation]
+        #   to learn more about the product and see How-to Guides.
+        # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+        #   to see the full list of Cloud APIs that we cover.
+        #
+        # [Product Documentation]: https://cloud.google.com/spanner-admin-instance
+        #
+        #
+        module Instance
+          module V1
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin_client.rb

@@ -30,6 +30,7 @@ require "google/gax/operation"
 require "google/longrunning/operations_client"
 
 require "google/spanner/admin/instance/v1/spanner_instance_admin_pb"
+require "google/cloud/spanner/admin/instance/credentials"
 
 module Google
   module Cloud
@@ -141,50 +142,24 @@ module Google
                 )
               end
 
-              # Parses the project from a project resource.
-              # @param project_name [String]
-              # @return [String]
-              def self.match_project_from_project_name project_name
-                PROJECT_PATH_TEMPLATE.match(project_name)["project"]
-              end
-
-              # Parses the project from a instance_config resource.
-              # @param instance_config_name [String]
-              # @return [String]
-              def self.match_project_from_instance_config_name instance_config_name
-                INSTANCE_CONFIG_PATH_TEMPLATE.match(instance_config_name)["project"]
-              end
-
-              # Parses the instance_config from a instance_config resource.
-              # @param instance_config_name [String]
-              # @return [String]
-              def self.match_instance_config_from_instance_config_name instance_config_name
-                INSTANCE_CONFIG_PATH_TEMPLATE.match(instance_config_name)["instance_config"]
-              end
-
-              # Parses the project from a instance resource.
-              # @param instance_name [String]
-              # @return [String]
-              def self.match_project_from_instance_name instance_name
-                INSTANCE_PATH_TEMPLATE.match(instance_name)["project"]
-              end
-
-              # Parses the instance from a instance resource.
-              # @param instance_name [String]
-              # @return [String]
-              def self.match_instance_from_instance_name instance_name
-                INSTANCE_PATH_TEMPLATE.match(instance_name)["instance"]
-              end
-
-              # @param service_path [String]
-              #   The domain name of the API remote host.
-              # @param port [Integer]
-              #   The port on which to connect to the remote host.
-              # @param channel [Channel]
-              #   A Channel object through which to make calls.
-              # @param chan_creds [Grpc::ChannelCredentials]
-              #   A ChannelCredentials for the setting up the RPC client.
-              # @param client_config[Hash]
+              # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+              #   Provides the means for authenticating requests made by the client. This parameter can
+              #   be many types.
+              #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+              #   authenticating requests made by this client.
+              #   A `String` will be treated as the path to the keyfile to be used for the construction of
+              #   credentials for this client.
+              #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+              #   credentials for this client.
+              #   A `GRPC::Core::Channel` will be used to make calls through.
+              #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+              #   should already be composed with a `GRPC::Core::CallCredentials` object.
+              #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+              #   metadata for requests, generally, to give OAuth credentials.
+              # @param scopes [Array<String>]
+              #   The OAuth scopes for this service. This parameter is ignored if
+              #   an updater_proc is supplied.
+              # @param client_config [Hash]
               #   A Hash for call options for each method. See
               #   Google::Gax#construct_settings for the structure of
               #   this data. Falls back to the default config if not specified
@@ -196,11 +171,11 @@ module Google
                   port: DEFAULT_SERVICE_PORT,
                   channel: nil,
                   chan_creds: nil,
+                  updater_proc: nil,
+                  credentials: nil,
                   scopes: ALL_SCOPES,
                   client_config: {},
                   timeout: DEFAULT_TIMEOUT,
-                  app_name: nil,
-                  app_version: nil,
                   lib_name: nil,
                   lib_version: ""
                 # These require statements are intentionally placed here to initialize
@@ -209,27 +184,48 @@ module Google
                 require "google/gax/grpc"
                 require "google/spanner/admin/instance/v1/spanner_instance_admin_services_pb"
 
+                if channel || chan_creds || updater_proc
+                  warn "The `channel`, `chan_creds`, and `updater_proc` parameters will be removed " \
+                    "on 2017/09/08"
+                  credentials ||= channel
+                  credentials ||= chan_creds
+                  credentials ||= updater_proc
+                end
+                if service_path != SERVICE_ADDRESS || port != DEFAULT_SERVICE_PORT
+                  warn "`service_path` and `port` parameters are deprecated and will be removed"
+                end
+
+                credentials ||= Google::Cloud::Spanner::Admin::Instance::Credentials.default
+
                 @operations_client = Google::Longrunning::OperationsClient.new(
                   service_path: service_path,
-                  port: port,
-                  channel: channel,
-                  chan_creds: chan_creds,
+                  credentials: credentials,
                   scopes: scopes,
                   client_config: client_config,
                   timeout: timeout,
-                  app_name: app_name,
-                  app_version: app_version,
                   lib_name: lib_name,
                   lib_version: lib_version,
                 )
 
-                if app_name || app_version
-                  warn "`app_name` and `app_version` are no longer being used in the request headers."
+                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                  updater_proc = Google::Cloud::Spanner::Admin::Instance::Credentials.new(credentials).updater_proc
+                end
+                if credentials.is_a?(GRPC::Core::Channel)
+                  channel = credentials
+                end
+                if credentials.is_a?(GRPC::Core::ChannelCredentials)
+                  chan_creds = credentials
+                end
+                if credentials.is_a?(Proc)
+                  updater_proc = credentials
+                end
+                if credentials.is_a?(Google::Auth::Credentials)
+                  updater_proc = credentials.updater_proc
                 end
 
                 google_api_client = "gl-ruby/#{RUBY_VERSION}"
                 google_api_client << " #{lib_name}/#{lib_version}" if lib_name
-                google_api_client << " gapic/0.6.8 gax/#{Google::Gax::VERSION}"
+                google_api_client << " gapic/0.1.0 gax/#{Google::Gax::VERSION}"
                 google_api_client << " grpc/#{GRPC::VERSION}"
                 google_api_client.freeze
 
@@ -254,6 +250,7 @@ module Google
                   port,
                   chan_creds: chan_creds,
                   channel: channel,
+                  updater_proc: updater_proc,
                   scopes: scopes,
                   &Google::Spanner::Admin::Instance::V1::InstanceAdmin::Stub.method(:new)
                 )
@@ -324,12 +321,10 @@ module Google
               #   object.
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_parent = InstanceAdminClient.project_path("[PROJECT]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.project_path("[PROJECT]")
               #
               #   # Iterate over all results.
               #   instance_admin_client.list_instance_configs(formatted_parent).each do |element|
@@ -348,10 +343,11 @@ module Google
                   parent,
                   page_size: nil,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::ListInstanceConfigsRequest.new({
+                req = {
                   parent: parent,
                   page_size: page_size
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::ListInstanceConfigsRequest)
                 @list_instance_configs.call(req, options)
               end
 
@@ -366,20 +362,19 @@ module Google
               # @return [Google::Spanner::Admin::Instance::V1::InstanceConfig]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
-              #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_name = InstanceAdminClient.instance_config_path("[PROJECT]", "[INSTANCE_CONFIG]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_name = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_config_path("[PROJECT]", "[INSTANCE_CONFIG]")
               #   response = instance_admin_client.get_instance_config(formatted_name)
 
               def get_instance_config \
                   name,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::GetInstanceConfigRequest.new({
+                req = {
                   name: name
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::GetInstanceConfigRequest)
                 @get_instance_config.call(req, options)
               end
 
@@ -398,22 +393,22 @@ module Google
               #   An expression for filtering the results of the request. Filter rules are
               #   case insensitive. The fields eligible for filtering are:
               #
-              #     * name
-              #     * display_name
-              #     * labels.key where key is the name of a label
-              #
-              #   Some examples of using filters are:
-              #
-              #     * name:* --> The instance has a name.
-              #     * name:Howl --> The instance's name contains the string "howl".
-              #     * name:HOWL --> Equivalent to above.
-              #     * NAME:howl --> Equivalent to above.
-              #     * labels.env:* --> The instance has the label "env".
-              #     * labels.env:dev --> The instance has the label "env" and the value of
-              #                          the label contains the string "dev".
-              #     * name:howl labels.env:dev --> The instance's name contains "howl" and
-              #                                    it has the label "env" with its value
-              #                                    containing "dev".
+              #   * +name+
+              #     * +display_name+
+              #     * +labels.key+ where key is the name of a label
+              #
+              #     Some examples of using filters are:
+              #
+              #     * +name:*+ --> The instance has a name.
+              #     * +name:Howl+ --> The instance's name contains the string "howl".
+              #     * +name:HOWL+ --> Equivalent to above.
+              #     * +NAME:howl+ --> Equivalent to above.
+              #     * +labels.env:*+ --> The instance has the label "env".
+              #     * +labels.env:dev+ --> The instance has the label "env" and the value of
+              #       the label contains the string "dev".
+              #     * +name:howl labels.env:dev+ --> The instance's name contains "howl" and
+              #       it has the label "env" with its value
+              #       containing "dev".
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
@@ -424,12 +419,10 @@ module Google
               #   object.
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_parent = InstanceAdminClient.project_path("[PROJECT]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.project_path("[PROJECT]")
               #
               #   # Iterate over all results.
               #   instance_admin_client.list_instances(formatted_parent).each do |element|
@@ -449,11 +442,12 @@ module Google
                   page_size: nil,
                   filter: nil,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::ListInstancesRequest.new({
+                req = {
                   parent: parent,
                   page_size: page_size,
                   filter: filter
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::ListInstancesRequest)
                 @list_instances.call(req, options)
               end
 
@@ -468,25 +462,24 @@ module Google
               # @return [Google::Spanner::Admin::Instance::V1::Instance]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
-              #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_name = InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_name = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
               #   response = instance_admin_client.get_instance(formatted_name)
 
               def get_instance \
                   name,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::GetInstanceRequest.new({
+                req = {
                   name: name
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::GetInstanceRequest)
                 @get_instance.call(req, options)
               end
 
               # Creates an instance and begins preparing it to begin serving. The
-              # returned Long-running operation
+              # returned {Google::Longrunning::Operation long-running 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
@@ -494,17 +487,17 @@ module Google
               #
               # 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+.
+              # * 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.
+              # * 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:
+              #   Upon completion of the returned operation:
               #
               #   * Billing for all successfully-allocated resources begins (some types
               #     may have lower than the requested levels).
@@ -512,13 +505,13 @@ module Google
               #   * The instance's allocated resource levels are readable via the API.
               #   * The instance's state becomes +READY+.
               #
-              # The returned Long-running 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 field type is
-              # CreateInstanceMetadata.
-              # The Response field type is
-              # Instance, if successful.
+              #   The returned {Google::Longrunning::Operation long-running operation} will
+              #   have a name of the format +<instance_name>/operations/<operation_id>+ and
+              #   can be used to track creation of the instance.  The
+              #   {Google::Longrunning::Operation#metadata metadata} field type is
+              #   {Google::Spanner::Admin::Instance::V1::CreateInstanceMetadata CreateInstanceMetadata}.
+              #   The {Google::Longrunning::Operation#response response} field type is
+              #   {Google::Spanner::Admin::Instance::V1::Instance Instance}, if successful.
               #
               # @param parent [String]
               #   Required. The name of the project in which to create the instance. Values
@@ -527,24 +520,23 @@ module Google
               #   Required. The ID of the instance to create.  Valid identifiers are of the
               #   form +[a-z][-a-z0-9]*[a-z0-9]+ and must be between 6 and 30 characters in
               #   length.
-              # @param instance [Google::Spanner::Admin::Instance::V1::Instance]
+              # @param instance [Google::Spanner::Admin::Instance::V1::Instance | Hash]
               #   Required. The instance to create.  The name may be omitted, but if
               #   specified must be +<parent>/instances/<instance_id>+.
+              #   A hash of the same form as `Google::Spanner::Admin::Instance::V1::Instance`
+              #   can also be provided.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
               # @return [Google::Gax::Operation]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   Instance = Google::Spanner::Admin::Instance::V1::Instance
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_parent = InstanceAdminClient.project_path("[PROJECT]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.project_path("[PROJECT]")
               #   instance_id = ''
-              #   instance = Instance.new
+              #   instance = {}
               #
               #   # Register a callback during the method call.
               #   operation = instance_admin_client.create_instance(formatted_parent, instance_id, instance) do |op|
@@ -578,11 +570,12 @@ module Google
                   instance_id,
                   instance,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::CreateInstanceRequest.new({
+                req = {
                   parent: parent,
                   instance_id: instance_id,
                   instance: instance
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::CreateInstanceRequest)
                 operation = Google::Gax::Operation.new(
                   @create_instance.call(req, options),
                   @operations_client,
@@ -595,28 +588,28 @@ module Google
               end
 
               # Updates an instance, and begins allocating or releasing resources
-              # as requested. The returned Long-running
-              # operation can be used to track the
+              # 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.
+              # * 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, 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.
+              # * Cancelling the operation sets its metadata's
+              #   {Google::Spanner::Admin::Instance::V1::UpdateInstanceMetadata#cancel_time 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:
+              #   Upon completion of the returned operation:
               #
               #   * Billing begins for all successfully-allocated resources (some types
               #     may have lower than the requested levels).
@@ -624,40 +617,40 @@ module Google
               #     tables.
               #   * The instance's new resource levels are readable via the API.
               #
-              # The returned Long-running operation will
-              # have a name of the format +<instance_name>/operations/<operation_id>+ and
-              # can be used to track the instance modification.  The
-              # Metadata field type is
-              # UpdateInstanceMetadata.
-              # The Response field type is
-              # Instance, if successful.
+              #   The returned {Google::Longrunning::Operation long-running operation} will
+              #   have a name of the format +<instance_name>/operations/<operation_id>+ and
+              #   can be used to track the instance modification.  The
+              #   {Google::Longrunning::Operation#metadata metadata} field type is
+              #   {Google::Spanner::Admin::Instance::V1::UpdateInstanceMetadata UpdateInstanceMetadata}.
+              #   The {Google::Longrunning::Operation#response response} field type is
+              #   {Google::Spanner::Admin::Instance::V1::Instance Instance}, if successful.
               #
               # Authorization requires +spanner.instances.update+ permission on
-              # resource Name.
+              # resource {Google::Spanner::Admin::Instance::V1::Instance#name name}.
               #
-              # @param instance [Google::Spanner::Admin::Instance::V1::Instance]
+              # @param instance [Google::Spanner::Admin::Instance::V1::Instance | Hash]
               #   Required. The instance to update, which must always include the instance
               #   name.  Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
-              # @param field_mask [Google::Protobuf::FieldMask]
+              #   A hash of the same form as `Google::Spanner::Admin::Instance::V1::Instance`
+              #   can also be provided.
+              # @param field_mask [Google::Protobuf::FieldMask | Hash]
               #   Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.
               #   The field mask must always be specified; this prevents any future fields in
               #   [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
               #   about them.
+              #   A hash of the same form as `Google::Protobuf::FieldMask`
+              #   can also be provided.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
               # @return [Google::Gax::Operation]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
-              #
-              #   FieldMask = Google::Protobuf::FieldMask
-              #   Instance = Google::Spanner::Admin::Instance::V1::Instance
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   instance = Instance.new
-              #   field_mask = FieldMask.new
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   instance = {}
+              #   field_mask = {}
               #
               #   # Register a callback during the method call.
               #   operation = instance_admin_client.update_instance(instance, field_mask) do |op|
@@ -690,10 +683,11 @@ module Google
                   instance,
                   field_mask,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::UpdateInstanceRequest.new({
+                req = {
                   instance: instance,
                   field_mask: field_mask
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::UpdateInstanceRequest)
                 operation = Google::Gax::Operation.new(
                   @update_instance.call(req, options),
                   @operations_client,
@@ -709,13 +703,13 @@ module Google
               #
               # Immediately upon completion of the request:
               #
-              #   * Billing ceases for all of the instance's reserved resources.
+              # * 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.
+              # * The instance and *all of its databases* immediately and
+              #   irrevocably disappear from the API. All data in the databases
+              #   is permanently deleted.
               #
               # @param name [String]
               #   Required. The name of the instance to be deleted. Values are of the form
@@ -725,20 +719,19 @@ module Google
               #   retries, etc.
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_name = InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_name = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
               #   instance_admin_client.delete_instance(formatted_name)
 
               def delete_instance \
                   name,
                   options: nil
-                req = Google::Spanner::Admin::Instance::V1::DeleteInstanceRequest.new({
+                req = {
                   name: name
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::DeleteInstanceRequest)
                 @delete_instance.call(req, options)
                 nil
               end
@@ -747,41 +740,41 @@ module Google
               # existing policy.
               #
               # Authorization requires +spanner.instances.setIamPolicy+ on
-              # Resource.
+              # {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being specified.
               #   +resource+ is usually specified as a path. For example, a Project
               #   resource is specified as +projects/{project}+.
-              # @param policy [Google::Iam::V1::Policy]
+              # @param policy [Google::Iam::V1::Policy | Hash]
               #   REQUIRED: The complete policy to be applied to the +resource+. The size of
               #   the policy is limited to a few 10s of KB. An empty policy is a
               #   valid policy but certain Cloud Platform services (such as Projects)
               #   might reject them.
+              #   A hash of the same form as `Google::Iam::V1::Policy`
+              #   can also be provided.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
               # @return [Google::Iam::V1::Policy]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
-              #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #   Policy = Google::Iam::V1::Policy
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_resource = InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
-              #   policy = Policy.new
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_resource = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #   policy = {}
               #   response = instance_admin_client.set_iam_policy(formatted_resource, policy)
 
               def set_iam_policy \
                   resource,
                   policy,
                   options: nil
-                req = Google::Iam::V1::SetIamPolicyRequest.new({
+                req = {
                   resource: resource,
                   policy: policy
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Iam::V1::SetIamPolicyRequest)
                 @set_iam_policy.call(req, options)
               end
 
@@ -789,7 +782,7 @@ module Google
               # policy if an instance exists but does not have a policy set.
               #
               # Authorization requires +spanner.instances.getIamPolicy+ on
-              # Resource.
+              # {Google::Iam::V1::GetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being requested.
@@ -801,20 +794,19 @@ module Google
               # @return [Google::Iam::V1::Policy]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
-              #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_resource = InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_resource = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
               #   response = instance_admin_client.get_iam_policy(formatted_resource)
 
               def get_iam_policy \
                   resource,
                   options: nil
-                req = Google::Iam::V1::GetIamPolicyRequest.new({
+                req = {
                   resource: resource
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Iam::V1::GetIamPolicyRequest)
                 @get_iam_policy.call(req, options)
               end
 
@@ -833,19 +825,17 @@ module Google
               #   The set of permissions to check for the +resource+. Permissions with
               #   wildcards (such as '*' or 'storage.*') are not allowed. For more
               #   information see
-              #   {IAM Overview}[https://cloud.google.com/iam/docs/overview#permissions].
+              #   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
               # @return [Google::Iam::V1::TestIamPermissionsResponse]
               # @raise [Google::Gax::GaxError] if the RPC is aborted.
               # @example
-              #   require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
-              #
-              #   InstanceAdminClient = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient
+              #   require "google/cloud/spanner/admin/instance/v1"
               #
-              #   instance_admin_client = InstanceAdminClient.new
-              #   formatted_resource = InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #   instance_admin_client = Google::Cloud::Spanner::Admin::Instance::V1.new
+              #   formatted_resource = Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
               #   permissions = []
               #   response = instance_admin_client.test_iam_permissions(formatted_resource, permissions)
 
@@ -853,10 +843,11 @@ module Google
                   resource,
                   permissions,
                   options: nil
-                req = Google::Iam::V1::TestIamPermissionsRequest.new({
+                req = {
                   resource: resource,
                   permissions: permissions
-                }.delete_if { |_, v| v.nil? })
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Iam::V1::TestIamPermissionsRequest)
                 @test_iam_permissions.call(req, options)
               end
             end