feat(spanner): update the api

#### spanner:v1

The following keys were added:
- schemas.ReadRequest.properties.lockHint.type (Total Keys: 1)
- schemas.ReadRequest.properties.orderBy.type (Total Keys: 1)

Author: yoshi-automation

docs/dyn/spanner_v1.projects.instanceConfigs.html

@@ -98,7 +98,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets information about a particular instance configuration.</p>
 <p class="toc_element">
   <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists the supported instance configurations for a given project.</p>
+<p class="firstline">Lists the supported instance configurations for a given project. Returns both Google managed configs and user managed configs.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next()</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
     &quot;leaderOptions&quot;: [ # Allowed values of the &quot;default_leader&quot; schema option for databases in instances that use this instance configuration.
       &quot;A String&quot;,
     ],
-    &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`.
+    &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. User instance config must start with `custom-`.
     &quot;optionalReplicas&quot;: [ # Output only. The available optional replicas to choose from for user managed configurations. Populated for Google managed configurations.
       {
         &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
@@ -143,7 +143,7 @@ <h3>Method Details</h3>
     ],
     &quot;quorumType&quot;: &quot;A String&quot;, # Output only. The `QuorumType` of the instance configuration.
     &quot;reconciling&quot;: True or False, # Output only. If true, the instance config is being created or updated. If false, there are no ongoing operations for the instance config.
-    &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties.
+    &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties. To create user managed configurations, input `replicas` must include all replicas in `replicas` of the `base_config` and include one or more replicas in the `optional_replicas` of the `base_config`.
       {
         &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
         &quot;location&quot;: &quot;A String&quot;, # The location of the serving resources, e.g., &quot;us-central1&quot;.
@@ -232,7 +232,7 @@ <h3>Method Details</h3>
   &quot;leaderOptions&quot;: [ # Allowed values of the &quot;default_leader&quot; schema option for databases in instances that use this instance configuration.
     &quot;A String&quot;,
   ],
-  &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`.
+  &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. User instance config must start with `custom-`.
   &quot;optionalReplicas&quot;: [ # Output only. The available optional replicas to choose from for user managed configurations. Populated for Google managed configurations.
     {
       &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
@@ -242,7 +242,7 @@ <h3>Method Details</h3>
   ],
   &quot;quorumType&quot;: &quot;A String&quot;, # Output only. The `QuorumType` of the instance configuration.
   &quot;reconciling&quot;: True or False, # Output only. If true, the instance config is being created or updated. If false, there are no ongoing operations for the instance config.
-  &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties.
+  &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties. To create user managed configurations, input `replicas` must include all replicas in `replicas` of the `base_config` and include one or more replicas in the `optional_replicas` of the `base_config`.
     {
       &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
       &quot;location&quot;: &quot;A String&quot;, # The location of the serving resources, e.g., &quot;us-central1&quot;.
@@ -256,7 +256,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists the supported instance configurations for a given project.
+  <pre>Lists the supported instance configurations for a given project. Returns both Google managed configs and user managed configs.
 
 Args:
   parent: string, Required. The name of the project for which a list of supported instance configurations is requested. Values are of the form `projects/`. (required)
@@ -284,7 +284,7 @@ <h3>Method Details</h3>
       &quot;leaderOptions&quot;: [ # Allowed values of the &quot;default_leader&quot; schema option for databases in instances that use this instance configuration.
         &quot;A String&quot;,
       ],
-      &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`.
+      &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. User instance config must start with `custom-`.
       &quot;optionalReplicas&quot;: [ # Output only. The available optional replicas to choose from for user managed configurations. Populated for Google managed configurations.
         {
           &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
@@ -294,7 +294,7 @@ <h3>Method Details</h3>
       ],
       &quot;quorumType&quot;: &quot;A String&quot;, # Output only. The `QuorumType` of the instance configuration.
       &quot;reconciling&quot;: True or False, # Output only. If true, the instance config is being created or updated. If false, there are no ongoing operations for the instance config.
-      &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties.
+      &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties. To create user managed configurations, input `replicas` must include all replicas in `replicas` of the `base_config` and include one or more replicas in the `optional_replicas` of the `base_config`.
         {
           &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
           &quot;location&quot;: &quot;A String&quot;, # The location of the serving resources, e.g., &quot;us-central1&quot;.
@@ -328,7 +328,7 @@ <h3>Method Details</h3>
   <pre>Updates an instance config. The returned long-running operation can be used to track the progress of updating the instance. If the named instance config does not exist, returns `NOT_FOUND`. Only user managed configurations can be updated. Immediately after the request returns: * The instance config&#x27;s reconciling field is set to true. While the operation is pending: * Cancelling the operation sets its metadata&#x27;s cancel_time. The operation is guaranteed to succeed at undoing all changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance config are rejected. * Reading the instance config via the API continues to give the pre-request values. Upon completion of the returned operation: * Creating instances using the instance configuration uses the new values. * The instance config&#x27;s new values are readable via the API. * The instance config&#x27;s reconciling field becomes false. The returned long-running operation will have a name of the format `/operations/` and can be used to track the instance config modification. The metadata field type is UpdateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.update` permission on the resource name.
 
 Args:
-  name: string, A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. (required)
+  name: string, A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. User instance config must start with `custom-`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -345,7 +345,7 @@ <h3>Method Details</h3>
     &quot;leaderOptions&quot;: [ # Allowed values of the &quot;default_leader&quot; schema option for databases in instances that use this instance configuration.
       &quot;A String&quot;,
     ],
-    &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`.
+    &quot;name&quot;: &quot;A String&quot;, # A unique identifier for the instance configuration. Values are of the form `projects//instanceConfigs/a-z*`. User instance config must start with `custom-`.
     &quot;optionalReplicas&quot;: [ # Output only. The available optional replicas to choose from for user managed configurations. Populated for Google managed configurations.
       {
         &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
@@ -355,7 +355,7 @@ <h3>Method Details</h3>
     ],
     &quot;quorumType&quot;: &quot;A String&quot;, # Output only. The `QuorumType` of the instance configuration.
     &quot;reconciling&quot;: True or False, # Output only. If true, the instance config is being created or updated. If false, there are no ongoing operations for the instance config.
-    &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties.
+    &quot;replicas&quot;: [ # The geographic placement of nodes in this instance configuration and their replication properties. To create user managed configurations, input `replicas` must include all replicas in `replicas` of the `base_config` and include one or more replicas in the `optional_replicas` of the `base_config`.
       {
         &quot;defaultLeaderLocation&quot;: True or False, # If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
         &quot;location&quot;: &quot;A String&quot;, # The location of the serving resources, e.g., &quot;us-central1&quot;.