google-cloud-spanner 1.0.0 → 1.1.0

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

@@ -0,0 +1,35 @@
+# 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.
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Spanner
+      module Admin
+        module Instance
+          class Credentials < Google::Auth::Credentials
+            SCOPE = [
+              "https://www.googleapis.com/auth/cloud-platform",
+              "https://www.googleapis.com/auth/spanner.admin"
+            ].freeze
+            PATH_ENV_VARS = %w(SPANNER_ADMIN_INSTANCE_KEYFILE, GOOGLE_CLOUD_KEYFILE, GCLOUD_KEYFILE)
+            JSON_ENV_VARS = %w(SPANNER_ADMIN_INSTANCE_KEYFILE_JSON, GOOGLE_CLOUD_KEYFILE_JSON, GCLOUD_KEYFILE_JSON)
+            DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,5 +1,4 @@
-
-# Copyright 2016 Google Inc. All rights reserved.
+# 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.
@@ -13,5 +12,119 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-
 require "google/cloud/spanner/admin/instance/v1/instance_admin_client"
+
+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)
+        #
+        # ### 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
+            # rubocop:enable LineLength
+
+            ##
+            # 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.
+            #
+            # @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
+            #   or the specified config is missing data points.
+            # @param timeout [Numeric]
+            #   The default timeout, in seconds, for calls made through this client.
+            def self.new \
+                service_path: nil,
+                port: nil,
+                channel: nil,
+                chan_creds: nil,
+                updater_proc: nil,
+                credentials: nil,
+                scopes: nil,
+                client_config: nil,
+                timeout: nil,
+                lib_name: nil,
+                lib_version: nil
+              kwargs = {
+                service_path: service_path,
+                port: port,
+                channel: channel,
+                chan_creds: chan_creds,
+                updater_proc: updater_proc,
+                credentials: credentials,
+                scopes: scopes,
+                client_config: client_config,
+                timeout: timeout,
+                lib_name: lib_name,
+                lib_version: lib_version
+              }.select { |_, v| v != nil }
+              Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdminClient.new(**kwargs)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -45,7 +45,7 @@ module Google
       #     }
       #
       # For a description of IAM and its features, see the
-      # {IAM developer's guide}[https://cloud.google.com/iam].
+      # [IAM developer's guide](https://cloud.google.com/iam).
       # @!attribute [rw] version
       #   @return [Integer]
       #     Version of the +Policy+. The default version is 0.
@@ -80,23 +80,23 @@ module Google
       #     +members+ can have the following values:
       #
       #     * +allUsers+: A special identifier that represents anyone who is
-      #        on the internet; with or without a Google account.
+      #       on the internet; with or without a Google account.
       #
       #     * +allAuthenticatedUsers+: A special identifier that represents anyone
-      #        who is authenticated with a Google account or a service account.
+      #       who is authenticated with a Google account or a service account.
       #
       #     * +user:{emailid}+: An email address that represents a specific Google
-      #        account. For example, +alice@gmail.com+ or +joe@example.com+.
+      #       account. For example, +alice@gmail.com+ or +joe@example.com+.
       #
       #
       #     * +serviceAccount:{emailid}+: An email address that represents a service
-      #        account. For example, +my-other-app@appspot.gserviceaccount.com+.
+      #       account. For example, +my-other-app@appspot.gserviceaccount.com+.
       #
       #     * +group:{emailid}+: An email address that represents a Google group.
-      #        For example, +admins@example.com+.
+      #       For example, +admins@example.com+.
       #
       #     * +domain:{domain}+: A Google Apps domain name that represents all the
-      #        users of that domain. For example, +google.com+ or +example.com+.
+      #       users of that domain. For example, +google.com+ or +example.com+.
       class Binding; end
 
       # The difference delta between two policies.
@@ -136,4 +136,4 @@ module Google
       end
     end
   end
-end
+end

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

@@ -49,6 +49,16 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
+    #  Example 4: Pack and unpack a message in Go
+    #
+    #      foo := &pb.Foo{...}
+    #      any, err := ptypes.MarshalAny(foo)
+    #      ...
+    #      foo := &pb.Foo{}
+    #      if err := ptypes.UnmarshalAny(any, foo); err != nil {
+    #        ...
+    #      }
+    #
     # The pack methods provided by protobuf library will by default use
     # 'type.googleapis.com/full.type.name' as the type URL and the unpack
     # methods only use the fully qualified type name after the last '/'
@@ -77,7 +87,7 @@ module Google
     # If the embedded message type is well-known and has a custom JSON
     # representation, that representation will be embedded adding a field
     # +value+ which holds the custom JSON in addition to the +@type+
-    # field. Example (for message Google::Protobuf::Duration):
+    # field. Example (for message {Google::Protobuf::Duration}):
     #
     #     {
     #       "@type": "type.googleapis.com/google.protobuf.Duration",
@@ -96,7 +106,7 @@ module Google
     #       qualified name of the type (as in +path/google.protobuf.Duration+).
     #       The name should be in a canonical form (e.g., leading "." is
     #       not accepted).
-    #     * An HTTP GET on the URL must yield a Google::Protobuf::Type
+    #     * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
     #       value in binary format, or produce an error.
     #     * Applications are allowed to cache lookup results based on the
     #       URL, or have them precompiled into a binary to avoid any

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

@@ -16,22 +16,22 @@ module Google
   module Rpc
     # The +Status+ type defines a logical error model that is suitable for different
     # programming environments, including REST APIs and RPC APIs. It is used by
-    # {gRPC}[https://github.com/grpc]. The error model is designed to be:
+    # [gRPC](https://github.com/grpc). The error model is designed to be:
     #
-    # - Simple to use and understand for most users
-    # - Flexible enough to meet unexpected needs
+    # * Simple to use and understand for most users
+    # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
     # The +Status+ message contains three pieces of data: error code, error message,
     # and error details. The error code should be an enum value of
-    # Google::Rpc::Code, but it may accept additional error codes if needed.  The
+    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
     # error message should be a developer-facing English message that helps
     # developers *understand* and *resolve* the error. If a localized user-facing
     # error message is needed, put the localized message in the error details or
     # localize it in the client. The optional error details may contain arbitrary
     # information about the error. There is a predefined set of error detail types
-    # in the package +google.rpc+ which can be used for common error conditions.
+    # in the package +google.rpc+ that can be used for common error conditions.
     #
     # = Language mapping
     #
@@ -49,35 +49,35 @@ module Google
     #
     # Example uses of this error model include:
     #
-    # - Partial errors. If a service needs to return partial errors to the client,
-    #     it may embed the +Status+ in the normal response to indicate the partial
-    #     errors.
+    # * Partial errors. If a service needs to return partial errors to the client,
+    #   it may embed the +Status+ in the normal response to indicate the partial
+    #   errors.
     #
-    # - Workflow errors. A typical workflow has multiple steps. Each step may
-    #     have a +Status+ message for error reporting purpose.
+    # * Workflow errors. A typical workflow has multiple steps. Each step may
+    #   have a +Status+ message for error reporting.
     #
-    # - Batch operations. If a client uses batch request and batch response, the
-    #     +Status+ message should be used directly inside batch response, one for
-    #     each error sub-response.
+    # * Batch operations. If a client uses batch request and batch response, the
+    #   +Status+ message should be used directly inside batch response, one for
+    #   each error sub-response.
     #
-    # - Asynchronous operations. If an API call embeds asynchronous operation
-    #     results in its response, the status of those operations should be
-    #     represented directly using the +Status+ message.
+    # * Asynchronous operations. If an API call embeds asynchronous operation
+    #   results in its response, the status of those operations should be
+    #   represented directly using the +Status+ message.
     #
-    # - Logging. If some API errors are stored in logs, the message +Status+ could
-    #     be used directly after any stripping needed for security/privacy reasons.
+    # * Logging. If some API errors are stored in logs, the message +Status+ could
+    #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of Google::Rpc::Code.
+    #     The status code, which should be an enum value of {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     Google::Rpc::Status#details field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
-    #     A list of messages that carry the error details.  There will be a
-    #     common set of message types for APIs to use.
+    #     A list of messages that carry the error details.  There is a common set of
+    #     message types for APIs to use.
     class Status; end
   end
 end

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

@@ -16,6 +16,17 @@ module Google
   module Spanner
     module Admin
       module Instance
+        ##
+        # # Cloud Spanner Instance Admin API Contents
+        #
+        # | Class | Description |
+        # | ----- | ----------- |
+        # | [InstanceAdminClient][] |  |
+        # | [Data Types][] | Data types for Google::Cloud::Spanner::Admin::Instance::V1 |
+        #
+        # [InstanceAdminClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-spanner-admin-instance/latest/google/spanner/admin/instance/v1/instanceadminclient
+        # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-spanner-admin-instance/latest/google/spanner/admin/instance/v1/datatypes
+        #
         module V1
           # A possible configuration for a Cloud Spanner instance. Configurations
           # define the geographic placement of nodes and their replication.
@@ -40,21 +51,25 @@ module Google
           #   @return [String]
           #     Required. The name of the instance's configuration. Values are of the form
           #     +projects/<project>/instanceConfigs/<configuration>+. See
-          #     also InstanceConfig and
-          #     ListInstanceConfigs.
+          #     also {Google::Spanner::Admin::Instance::V1::InstanceConfig InstanceConfig} and
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
           # @!attribute [rw] display_name
           #   @return [String]
           #     Required. The descriptive name for this instance as it appears in UIs.
           #     Must be unique per project and between 4 and 30 characters in length.
           # @!attribute [rw] node_count
           #   @return [Integer]
-          #     Required. The number of nodes allocated to this instance.
+          #     Required. The number of nodes allocated to this instance. This may be zero
+          #     in API responses for instances that are not yet in state +READY+.
+          #
+          #     See [the documentation](https://cloud.google.com/spanner/docs/instances#node_count)
+          #     for more information about nodes.
           # @!attribute [rw] state
           #   @return [Google::Spanner::Admin::Instance::V1::Instance::State]
           #     Output only. The current instance state. For
-          #     CreateInstance, the state must be
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}, the state must be
           #     either omitted or set to +CREATING+. For
-          #     UpdateInstance, the state must be
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}, the state must be
           #     either omitted or set to +READY+.
           # @!attribute [rw] labels
           #   @return [Hash{String => String}]
@@ -65,11 +80,11 @@ module Google
           #     And they can be used as arguments to policy management rules (e.g. route,
           #     firewall, load balancing, etc.).
           #
-          #      * Label keys must be between 1 and 63 characters long and must conform to
-          #        the following regular expression: +{a-z}[https://cloud.google.com[-a-z0-9]*[a-z0-9]]?+.
-          #      * Label values must be between 0 and 63 characters long and must conform
-          #        to the regular expression +({a-z}[https://cloud.google.com[-a-z0-9]*[a-z0-9]]?)?+.
-          #      * No more than 64 labels can be associated with a given resource.
+          #     * Label keys must be between 1 and 63 characters long and must conform to
+          #       the following regular expression: +[a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?+.
+          #     * Label values must be between 0 and 63 characters long and must conform
+          #       to the regular expression +([a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?)?+.
+          #     * No more than 64 labels can be associated with a given resource.
           #
           #     See https://goo.gl/xmQnxf for more information on and examples of labels.
           #
@@ -96,7 +111,7 @@ module Google
             end
           end
 
-          # The request for ListInstanceConfigs.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
           # @!attribute [rw] parent
           #   @return [String]
           #     Required. The name of the project for which a list of supported instance
@@ -109,37 +124,37 @@ module Google
           # @!attribute [rw] page_token
           #   @return [String]
           #     If non-empty, +page_token+ should contain a
-          #     Next_page_token
-          #     from a previous ListInstanceConfigsResponse.
+          #     {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse#next_page_token next_page_token}
+          #     from a previous {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse ListInstanceConfigsResponse}.
           class ListInstanceConfigsRequest; end
 
-          # The response for ListInstanceConfigs.
+          # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
           # @!attribute [rw] instance_configs
           #   @return [Array<Google::Spanner::Admin::Instance::V1::InstanceConfig>]
           #     The list of requested instance configurations.
           # @!attribute [rw] next_page_token
           #   @return [String]
           #     +next_page_token+ can be sent in a subsequent
-          #     ListInstanceConfigs call to
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs} call to
           #     fetch more of the matching instance configurations.
           class ListInstanceConfigsResponse; end
 
           # The request for
-          # GetInstanceConfigRequest.
+          # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstanceConfig GetInstanceConfigRequest}.
           # @!attribute [rw] name
           #   @return [String]
           #     Required. The name of the requested instance configuration. Values are of
           #     the form +projects/<project>/instanceConfigs/<config>+.
           class GetInstanceConfigRequest; end
 
-          # The request for GetInstance.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstance GetInstance}.
           # @!attribute [rw] name
           #   @return [String]
           #     Required. The name of the requested instance. Values are of the form
           #     +projects/<project>/instances/<instance>+.
           class GetInstanceRequest; end
 
-          # The request for CreateInstance.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
           # @!attribute [rw] parent
           #   @return [String]
           #     Required. The name of the project in which to create the instance. Values
@@ -155,7 +170,7 @@ module Google
           #     specified must be +<parent>/instances/<instance_id>+.
           class CreateInstanceRequest; end
 
-          # The request for ListInstances.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
           # @!attribute [rw] parent
           #   @return [String]
           #     Required. The name of the project for which a list of instances is
@@ -167,43 +182,43 @@ module Google
           # @!attribute [rw] page_token
           #   @return [String]
           #     If non-empty, +page_token+ should contain a
-          #     Next_page_token from a
-          #     previous ListInstancesResponse.
+          #     {Google::Spanner::Admin::Instance::V1::ListInstancesResponse#next_page_token next_page_token} from a
+          #     previous {Google::Spanner::Admin::Instance::V1::ListInstancesResponse ListInstancesResponse}.
           # @!attribute [rw] filter
           #   @return [String]
           #     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
+          #     * +name+
+          #       * +display_name+
+          #       * +labels.key+ where key is the name of a label
           #
-          #     Some examples of using filters are:
+          #       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:*+ --> 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".
           class ListInstancesRequest; end
 
-          # The response for ListInstances.
+          # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
           # @!attribute [rw] instances
           #   @return [Array<Google::Spanner::Admin::Instance::V1::Instance>]
           #     The list of requested instances.
           # @!attribute [rw] next_page_token
           #   @return [String]
           #     +next_page_token+ can be sent in a subsequent
-          #     ListInstances call to fetch more
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances} call to fetch more
           #     of the matching instances.
           class ListInstancesResponse; end
 
-          # The request for UpdateInstance.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
           # @!attribute [rw] instance
           #   @return [Google::Spanner::Admin::Instance::V1::Instance]
           #     Required. The instance to update, which must always include the instance
@@ -216,7 +231,7 @@ module Google
           #     about them.
           class UpdateInstanceRequest; end
 
-          # The request for DeleteInstance.
+          # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::DeleteInstance DeleteInstance}.
           # @!attribute [rw] name
           #   @return [String]
           #     Required. The name of the instance to be deleted. Values are of the form
@@ -224,14 +239,14 @@ module Google
           class DeleteInstanceRequest; end
 
           # Metadata type for the operation returned by
-          # CreateInstance.
+          # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
           # @!attribute [rw] instance
           #   @return [Google::Spanner::Admin::Instance::V1::Instance]
           #     The instance being created.
           # @!attribute [rw] start_time
           #   @return [Google::Protobuf::Timestamp]
           #     The time at which the
-          #     CreateInstance request was
+          #     {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance} request was
           #     received.
           # @!attribute [rw] cancel_time
           #   @return [Google::Protobuf::Timestamp]
@@ -244,13 +259,13 @@ module Google
           class CreateInstanceMetadata; end
 
           # Metadata type for the operation returned by
-          # UpdateInstance.
+          # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
           # @!attribute [rw] instance
           #   @return [Google::Spanner::Admin::Instance::V1::Instance]
           #     The desired end state of the update.
           # @!attribute [rw] start_time
           #   @return [Google::Protobuf::Timestamp]
-          #     The time at which UpdateInstance
+          #     The time at which {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}
           #     request was received.
           # @!attribute [rw] cancel_time
           #   @return [Google::Protobuf::Timestamp]