google-cloud-bigtable 1.1.0 → 1.2.0

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json

@@ -73,7 +73,7 @@
           "retry_params_name": "non_idempotent_params"
         },
         "ModifyColumnFamilies": {
-          "timeout_millis": 60000,
+          "timeout_millis": 300000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "non_idempotent_heavy_params"
         },

data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_instance_admin.rb

@@ -20,38 +20,38 @@ module Google
         # Request message for BigtableInstanceAdmin.CreateInstance.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the project in which to create the new instance.
-        #     Values are of the form `projects/<project>`.
+        #     Required. The unique name of the project in which to create the new instance.
+        #     Values are of the form `projects/{project}`.
         # @!attribute [rw] instance_id
         #   @return [String]
-        #     The ID to be used when referring to the new instance within its project,
+        #     Required. The ID to be used when referring to the new instance within its project,
         #     e.g., just `myinstance` rather than
         #     `projects/myproject/instances/myinstance`.
         # @!attribute [rw] instance
         #   @return [Google::Bigtable::Admin::V2::Instance]
-        #     The instance to create.
+        #     Required. The instance to create.
         #     Fields marked `OutputOnly` must be left blank.
         # @!attribute [rw] clusters
         #   @return [Hash{String => Google::Bigtable::Admin::V2::Cluster}]
-        #     The clusters to be created within the instance, mapped by desired
+        #     Required. The clusters to be created within the instance, mapped by desired
         #     cluster ID, e.g., just `mycluster` rather than
         #     `projects/myproject/instances/myinstance/clusters/mycluster`.
         #     Fields marked `OutputOnly` must be left blank.
-        #     Currently, at most two clusters can be specified.
+        #     Currently, at most four clusters can be specified.
         class CreateInstanceRequest; end
 
         # Request message for BigtableInstanceAdmin.GetInstance.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the requested instance. Values are of the form
-        #     `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the requested instance. Values are of the form
+        #     `projects/{project}/instances/{instance}`.
         class GetInstanceRequest; end
 
         # Request message for BigtableInstanceAdmin.ListInstances.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the project for which a list of instances is requested.
-        #     Values are of the form `projects/<project>`.
+        #     Required. The unique name of the project for which a list of instances is requested.
+        #     Values are of the form `projects/{project}`.
         # @!attribute [rw] page_token
         #   @return [String]
         #     DEPRECATED: This field is unused and ignored.
@@ -77,50 +77,50 @@ module Google
         # Request message for BigtableInstanceAdmin.PartialUpdateInstance.
         # @!attribute [rw] instance
         #   @return [Google::Bigtable::Admin::V2::Instance]
-        #     The Instance which will (partially) replace the current value.
+        #     Required. The Instance which will (partially) replace the current value.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     The subset of Instance fields which should be replaced.
+        #     Required. The subset of Instance fields which should be replaced.
         #     Must be explicitly set.
         class PartialUpdateInstanceRequest; end
 
         # Request message for BigtableInstanceAdmin.DeleteInstance.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the instance to be deleted.
-        #     Values are of the form `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the instance to be deleted.
+        #     Values are of the form `projects/{project}/instances/{instance}`.
         class DeleteInstanceRequest; end
 
         # Request message for BigtableInstanceAdmin.CreateCluster.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance in which to create the new cluster.
+        #     Required. The unique name of the instance in which to create the new cluster.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>`.
+        #     `projects/{project}/instances/{instance}`.
         # @!attribute [rw] cluster_id
         #   @return [String]
-        #     The ID to be used when referring to the new cluster within its instance,
+        #     Required. The ID to be used when referring to the new cluster within its instance,
         #     e.g., just `mycluster` rather than
         #     `projects/myproject/instances/myinstance/clusters/mycluster`.
         # @!attribute [rw] cluster
         #   @return [Google::Bigtable::Admin::V2::Cluster]
-        #     The cluster to be created.
+        #     Required. The cluster to be created.
         #     Fields marked `OutputOnly` must be left blank.
         class CreateClusterRequest; end
 
         # Request message for BigtableInstanceAdmin.GetCluster.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the requested cluster. Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>`.
+        #     Required. The unique name of the requested cluster. Values are of the form
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}`.
         class GetClusterRequest; end
 
         # Request message for BigtableInstanceAdmin.ListClusters.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance for which a list of clusters is requested.
-        #     Values are of the form `projects/<project>/instances/<instance>`.
-        #     Use `<instance> = '-'` to list Clusters for all Instances in a project,
+        #     Required. The unique name of the instance for which a list of clusters is requested.
+        #     Values are of the form `projects/{project}/instances/{instance}`.
+        #     Use `{instance} = '-'` to list Clusters for all Instances in a project,
         #     e.g., `projects/myproject/instances/-`.
         # @!attribute [rw] page_token
         #   @return [String]
@@ -146,8 +146,8 @@ module Google
         # Request message for BigtableInstanceAdmin.DeleteCluster.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the cluster to be deleted. Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>`.
+        #     Required. The unique name of the cluster to be deleted. Values are of the form
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}`.
         class DeleteClusterRequest; end
 
         # The metadata for the Operation returned by CreateInstance.
@@ -201,17 +201,17 @@ module Google
         # Request message for BigtableInstanceAdmin.CreateAppProfile.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance in which to create the new app profile.
+        #     Required. The unique name of the instance in which to create the new app profile.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>`.
+        #     `projects/{project}/instances/{instance}`.
         # @!attribute [rw] app_profile_id
         #   @return [String]
-        #     The ID to be used when referring to the new app profile within its
+        #     Required. The ID to be used when referring to the new app profile within its
         #     instance, e.g., just `myprofile` rather than
         #     `projects/myproject/instances/myinstance/appProfiles/myprofile`.
         # @!attribute [rw] app_profile
         #   @return [Google::Bigtable::Admin::V2::AppProfile]
-        #     The app profile to be created.
+        #     Required. The app profile to be created.
         #     Fields marked `OutputOnly` will be ignored.
         # @!attribute [rw] ignore_warnings
         #   @return [true, false]
@@ -221,22 +221,29 @@ module Google
         # Request message for BigtableInstanceAdmin.GetAppProfile.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the requested app profile. Values are of the form
-        #     `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+        #     Required. The unique name of the requested app profile. Values are of the form
+        #     `projects/{project}/instances/{instance}/appProfiles/{app_profile}`.
         class GetAppProfileRequest; end
 
         # Request message for BigtableInstanceAdmin.ListAppProfiles.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance for which a list of app profiles is
+        #     Required. The unique name of the instance for which a list of app profiles is
         #     requested. Values are of the form
-        #     `projects/<project>/instances/<instance>`.
-        #     Use `<instance> = '-'` to list AppProfiles for all Instances in a project,
+        #     `projects/{project}/instances/{instance}`.
+        #     Use `{instance} = '-'` to list AppProfiles for all Instances in a project,
         #     e.g., `projects/myproject/instances/-`.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     Maximum number of results per page.
-        #     CURRENTLY UNIMPLEMENTED AND IGNORED.
+        #
+        #     A page_size of zero lets the server choose the number of items to return.
+        #     A page_size which is strictly positive will return at most that many items.
+        #     A negative page_size will cause an error.
+        #
+        #     Following the first request, subsequent paginated calls are not required
+        #     to pass a page_size. If a page_size is set in subsequent calls, it must
+        #     match the page_size given in the first request.
         # @!attribute [rw] page_token
         #   @return [String]
         #     The value of `next_page_token` returned by a previous call.
@@ -262,10 +269,10 @@ module Google
         # Request message for BigtableInstanceAdmin.UpdateAppProfile.
         # @!attribute [rw] app_profile
         #   @return [Google::Bigtable::Admin::V2::AppProfile]
-        #     The app profile which will (partially) replace the current value.
+        #     Required. The app profile which will (partially) replace the current value.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     The subset of app profile fields which should be replaced.
+        #     Required. The subset of app profile fields which should be replaced.
         #     If unset, all fields will be replaced.
         # @!attribute [rw] ignore_warnings
         #   @return [true, false]
@@ -275,8 +282,8 @@ module Google
         # Request message for BigtableInstanceAdmin.DeleteAppProfile.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the app profile to be deleted. Values are of the form
-        #     `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+        #     Required. The unique name of the app profile to be deleted. Values are of the form
+        #     `projects/{project}/instances/{instance}/appProfiles/{app_profile}`.
         # @!attribute [rw] ignore_warnings
         #   @return [true, false]
         #     If true, ignore safety checks when deleting the app profile.

data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_table_admin.rb

@@ -21,15 +21,16 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::CreateTable}
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance in which to create the table.
-        #     Values are of the form `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the instance in which to create the table.
+        #     Values are of the form `projects/{project}/instances/{instance}`.
         # @!attribute [rw] table_id
         #   @return [String]
-        #     The name by which the new table should be referred to within the parent
-        #     instance, e.g., `foobar` rather than `<parent>/tables/foobar`.
+        #     Required. The name by which the new table should be referred to within the parent
+        #     instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
+        #     Maximum 50 characters.
         # @!attribute [rw] table
         #   @return [Google::Bigtable::Admin::V2::Table]
-        #     The Table to create.
+        #     Required. The Table to create.
         # @!attribute [rw] initial_splits
         #   @return [Array<Google::Bigtable::Admin::V2::CreateTableRequest::Split>]
         #     The optional list of row keys that will be used to initially split the
@@ -65,27 +66,27 @@ module Google
         # for production use. It is not subject to any SLA or deprecation policy.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance in which to create the table.
-        #     Values are of the form `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the instance in which to create the table.
+        #     Values are of the form `projects/{project}/instances/{instance}`.
         # @!attribute [rw] table_id
         #   @return [String]
-        #     The name by which the new table should be referred to within the parent
-        #     instance, e.g., `foobar` rather than `<parent>/tables/foobar`.
+        #     Required. The name by which the new table should be referred to within the parent
+        #     instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
         # @!attribute [rw] source_snapshot
         #   @return [String]
-        #     The unique name of the snapshot from which to restore the table. The
+        #     Required. The unique name of the snapshot from which to restore the table. The
         #     snapshot and the table must be in the same instance.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`.
         class CreateTableFromSnapshotRequest; end
 
         # Request message for
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::DropRowRange}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the table on which to drop a range of rows.
+        #     Required. The unique name of the table on which to drop a range of rows.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         # @!attribute [rw] row_key_prefix
         #   @return [String]
         #     Delete all rows that start with this row key prefix. Prefix cannot be
@@ -99,16 +100,23 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::ListTables}
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the instance for which tables should be listed.
-        #     Values are of the form `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the instance for which tables should be listed.
+        #     Values are of the form `projects/{project}/instances/{instance}`.
         # @!attribute [rw] view
         #   @return [Google::Bigtable::Admin::V2::Table::View]
         #     The view to be applied to the returned tables' fields.
-        #     Defaults to `NAME_ONLY` if unspecified; no others are currently supported.
+        #     Only NAME_ONLY view (default) and REPLICATION_VIEW are supported.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     Maximum number of results per page.
-        #     CURRENTLY UNIMPLEMENTED AND IGNORED.
+        #
+        #     A page_size of zero lets the server choose the number of items to return.
+        #     A page_size which is strictly positive will return at most that many items.
+        #     A negative page_size will cause an error.
+        #
+        #     Following the first request, subsequent paginated calls are not required
+        #     to pass a page_size. If a page_size is set in subsequent calls, it must
+        #     match the page_size given in the first request.
         # @!attribute [rw] page_token
         #   @return [String]
         #     The value of `next_page_token` returned by a previous call.
@@ -130,9 +138,9 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::GetTable}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the requested table.
+        #     Required. The unique name of the requested table.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         # @!attribute [rw] view
         #   @return [Google::Bigtable::Admin::V2::Table::View]
         #     The view to be applied to the returned table's fields.
@@ -143,21 +151,21 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::DeleteTable}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the table to be deleted.
+        #     Required. The unique name of the table to be deleted.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         class DeleteTableRequest; end
 
         # Request message for
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::ModifyColumnFamilies}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the table whose families should be modified.
+        #     Required. The unique name of the table whose families should be modified.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         # @!attribute [rw] modifications
         #   @return [Array<Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification>]
-        #     Modifications to be atomically applied to the specified table's families.
+        #     Required. Modifications to be atomically applied to the specified table's families.
         #     Entries are applied in order, meaning that earlier modifications can be
         #     masked by later ones (in the case of repeated updates to the same family,
         #     for example).
@@ -185,9 +193,9 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::GenerateConsistencyToken}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the Table for which to create a consistency token.
+        #     Required. The unique name of the Table for which to create a consistency token.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         class GenerateConsistencyTokenRequest; end
 
         # Response message for
@@ -201,12 +209,12 @@ module Google
         # {Google::Bigtable::Admin::V2::BigtableTableAdmin::CheckConsistency}
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the Table for which to check replication consistency.
+        #     Required. The unique name of the Table for which to check replication consistency.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         # @!attribute [rw] consistency_token
         #   @return [String]
-        #     The token created using GenerateConsistencyToken for the Table.
+        #     Required. The token created using GenerateConsistencyToken for the Table.
         class CheckConsistencyRequest; end
 
         # Response message for
@@ -228,18 +236,18 @@ module Google
         #   @return [String]
         #     The unique name of the table to have the snapshot taken.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/tables/<table>`.
+        #     `projects/{project}/instances/{instance}/tables/{table}`.
         # @!attribute [rw] cluster
         #   @return [String]
         #     The name of the cluster where the snapshot will be created in.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}`.
         # @!attribute [rw] snapshot_id
         #   @return [String]
         #     The ID by which the new snapshot should be referred to within the parent
         #     cluster, e.g., `mysnapshot` of the form: `[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
         #     rather than
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/mysnapshot`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/mysnapshot`.
         # @!attribute [rw] ttl
         #   @return [Google::Protobuf::Duration]
         #     The amount of time that the new snapshot can stay active after it is
@@ -260,9 +268,9 @@ module Google
         # for production use. It is not subject to any SLA or deprecation policy.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the requested snapshot.
+        #     Required. The unique name of the requested snapshot.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`.
         class GetSnapshotRequest; end
 
         # Request message for
@@ -274,11 +282,11 @@ module Google
         # for production use. It is not subject to any SLA or deprecation policy.
         # @!attribute [rw] parent
         #   @return [String]
-        #     The unique name of the cluster for which snapshots should be listed.
+        #     Required. The unique name of the cluster for which snapshots should be listed.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>`.
-        #     Use `<cluster> = '-'` to list snapshots for all clusters in an instance,
-        #     e.g., `projects/<project>/instances/<instance>/clusters/-`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}`.
+        #     Use `{cluster} = '-'` to list snapshots for all clusters in an instance,
+        #     e.g., `projects/{project}/instances/{instance}/clusters/-`.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     The maximum number of snapshots to return per page.
@@ -314,9 +322,9 @@ module Google
         # for production use. It is not subject to any SLA or deprecation policy.
         # @!attribute [rw] name
         #   @return [String]
-        #     The unique name of the snapshot to be deleted.
+        #     Required. The unique name of the snapshot to be deleted.
         #     Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+        #     `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`.
         class DeleteSnapshotRequest; end
 
         # The metadata for the Operation returned by SnapshotTable.

data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/instance.rb

@@ -19,16 +19,15 @@ module Google
       module V2
         # A collection of Bigtable {Google::Bigtable::Admin::V2::Table Tables} and
         # the resources that serve them.
-        # All tables in an instance are served from a single
-        # {Google::Bigtable::Admin::V2::Cluster Cluster}.
+        # All tables in an instance are served from all
+        # {Google::Bigtable::Admin::V2::Cluster Clusters} in the instance.
         # @!attribute [rw] name
         #   @return [String]
-        #     (`OutputOnly`)
         #     The unique name of the instance. Values are of the form
-        #     `projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
+        #     `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
         # @!attribute [rw] display_name
         #   @return [String]
-        #     The descriptive name for this instance as it appears in UIs.
+        #     Required. The descriptive name for this instance as it appears in UIs.
         #     Can be changed at any time, but should be kept globally unique
         #     to avoid confusion.
         # @!attribute [rw] state
@@ -93,23 +92,21 @@ module Google
         # {Google::Bigtable::Admin::V2::Instance Instance}.
         # @!attribute [rw] name
         #   @return [String]
-        #     (`OutputOnly`)
         #     The unique name of the cluster. Values are of the form
-        #     `projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*`.
+        #     `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
         # @!attribute [rw] location
         #   @return [String]
         #     (`CreationOnly`)
         #     The location where this cluster's nodes and storage reside. For best
         #     performance, clients should be located as close as possible to this
         #     cluster. Currently only zones are supported, so values should be of the
-        #     form `projects/<project>/locations/<zone>`.
+        #     form `projects/{project}/locations/{zone}`.
         # @!attribute [rw] state
         #   @return [Google::Bigtable::Admin::V2::Cluster::State]
-        #     (`OutputOnly`)
         #     The current state of the cluster.
         # @!attribute [rw] serve_nodes
         #   @return [Integer]
-        #     The number of nodes allocated to this cluster. More nodes enable higher
+        #     Required. The number of nodes allocated to this cluster. More nodes enable higher
         #     throughput and more consistent performance.
         # @!attribute [rw] default_storage_type
         #   @return [Google::Bigtable::Admin::V2::StorageType]
@@ -165,19 +162,20 @@ module Google
         #     Optional long form description of the use case for this AppProfile.
         # @!attribute [rw] multi_cluster_routing_use_any
         #   @return [Google::Bigtable::Admin::V2::AppProfile::MultiClusterRoutingUseAny]
-        #     Use a multi-cluster routing policy that may pick any cluster.
+        #     Use a multi-cluster routing policy.
         # @!attribute [rw] single_cluster_routing
         #   @return [Google::Bigtable::Admin::V2::AppProfile::SingleClusterRouting]
         #     Use a single-cluster routing policy.
         class AppProfile
-          # Read/write requests may be routed to any cluster in the instance, and will
-          # fail over to another cluster in the event of transient errors or delays.
-          # Choosing this option sacrifices read-your-writes consistency to improve
-          # availability.
+          # Read/write requests are routed to the nearest cluster in the instance, and
+          # will fail over to the nearest cluster that is available in the event of
+          # transient errors or delays. Clusters in a region are considered
+          # equidistant. Choosing this option sacrifices read-your-writes consistency
+          # to improve availability.
           class MultiClusterRoutingUseAny; end
 
           # Unconditionally routes all read/write requests to a specific cluster.
-          # This option preserves read-your-writes consistency, but does not improve
+          # This option preserves read-your-writes consistency but does not improve
           # availability.
           # @!attribute [rw] cluster_id
           #   @return [String]