2222import static com .google .cloud .bigtable .admin .v2 .BaseBigtableInstanceAdminClient .ListMaterializedViewsPagedResponse ;
2323
2424import com .google .api .core .ApiFunction ;
25- import com .google .api .core .InternalApi ;
2625import com .google .api .gax .core .GoogleCredentialsProvider ;
2726import com .google .api .gax .core .InstantiatingExecutorProvider ;
2827import com .google .api .gax .grpc .InstantiatingGrpcChannelProvider ;
9392import javax .annotation .Generated ;
9493
9594// AUTO-GENERATED DOCUMENTATION AND CLASS.
96- /** For internal use only. */
97- @ Generated ("by gapic-generator" )
98- @ InternalApi
95+ /**
96+ * Settings class to configure an instance of {@link BaseBigtableInstanceAdminClient}.
97+ *
98+ * <p>The default instance has everything set to sensible defaults:
99+ *
100+ * <ul>
101+ * <li>The default service address (bigtableadmin.googleapis.com) and default port (443) are used.
102+ * <li>Credentials are acquired automatically through Application Default Credentials.
103+ * <li>Retries are configured for idempotent methods but not for non-idempotent methods.
104+ * </ul>
105+ *
106+ * <p>The builder of this class is recursive, so contained classes are themselves builders. When
107+ * build() is called, the tree of builders is called to create the complete settings object.
108+ *
109+ * <p>For example, to set the
110+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
111+ * of getInstance:
112+ *
113+ * <pre>{@code
114+ * // This snippet has been automatically generated and should be regarded as a code template only.
115+ * // It will require modifications to work:
116+ * // - It may require correct/in-range values for request initialization.
117+ * // - It may require specifying regional endpoints when creating the service client as shown in
118+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
119+ * BaseBigtableInstanceAdminSettings.Builder baseBigtableInstanceAdminSettingsBuilder =
120+ * BaseBigtableInstanceAdminSettings.newBuilder();
121+ * baseBigtableInstanceAdminSettingsBuilder
122+ * .getInstanceSettings()
123+ * .setRetrySettings(
124+ * baseBigtableInstanceAdminSettingsBuilder
125+ * .getInstanceSettings()
126+ * .getRetrySettings()
127+ * .toBuilder()
128+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
129+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
130+ * .setMaxAttempts(5)
131+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
132+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
133+ * .setRetryDelayMultiplier(1.3)
134+ * .setRpcTimeoutMultiplier(1.5)
135+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
136+ * .build());
137+ * BaseBigtableInstanceAdminSettings baseBigtableInstanceAdminSettings =
138+ * baseBigtableInstanceAdminSettingsBuilder.build();
139+ * }</pre>
140+ *
141+ * Please refer to the [Client Side Retry
142+ * Guide](https://docs.cloud.google.com/java/docs/client-retries) for additional support in setting
143+ * retries.
144+ *
145+ * <p>To configure the RetrySettings of a Long Running Operation method, create an
146+ * OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
147+ * configure the RetrySettings for createInstance:
148+ *
149+ * <pre>{@code
150+ * // This snippet has been automatically generated and should be regarded as a code template only.
151+ * // It will require modifications to work:
152+ * // - It may require correct/in-range values for request initialization.
153+ * // - It may require specifying regional endpoints when creating the service client as shown in
154+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
155+ * BaseBigtableInstanceAdminSettings.Builder baseBigtableInstanceAdminSettingsBuilder =
156+ * BaseBigtableInstanceAdminSettings.newBuilder();
157+ * TimedRetryAlgorithm timedRetryAlgorithm =
158+ * OperationalTimedPollAlgorithm.create(
159+ * RetrySettings.newBuilder()
160+ * .setInitialRetryDelayDuration(Duration.ofMillis(500))
161+ * .setRetryDelayMultiplier(1.5)
162+ * .setMaxRetryDelayDuration(Duration.ofMillis(5000))
163+ * .setTotalTimeoutDuration(Duration.ofHours(24))
164+ * .build());
165+ * baseBigtableInstanceAdminSettingsBuilder
166+ * .createClusterOperationSettings()
167+ * .setPollingAlgorithm(timedRetryAlgorithm)
168+ * .build();
169+ * }</pre>
170+ */
171+ @ Generated ("by gapic-generator-java" )
99172public class BaseBigtableInstanceAdminSettings
100173 extends ClientSettings <BaseBigtableInstanceAdminSettings > {
101174
@@ -121,6 +194,11 @@ public UnaryCallSettings<ListInstancesRequest, ListInstancesResponse> listInstan
121194 return ((BigtableInstanceAdminStubSettings ) getStubSettings ()).listInstancesSettings ();
122195 }
123196
197+ /** Returns the object with the settings used for calls to updateInstance. */
198+ public UnaryCallSettings <Instance , Instance > updateInstanceSettings () {
199+ return ((BigtableInstanceAdminStubSettings ) getStubSettings ()).updateInstanceSettings ();
200+ }
201+
124202 /** Returns the object with the settings used for calls to partialUpdateInstance. */
125203 public UnaryCallSettings <PartialUpdateInstanceRequest , Operation >
126204 partialUpdateInstanceSettings () {
@@ -453,6 +531,11 @@ public UnaryCallSettings.Builder<GetInstanceRequest, Instance> getInstanceSettin
453531 return getStubSettingsBuilder ().listInstancesSettings ();
454532 }
455533
534+ /** Returns the builder for the settings used for calls to updateInstance. */
535+ public UnaryCallSettings .Builder <Instance , Instance > updateInstanceSettings () {
536+ return getStubSettingsBuilder ().updateInstanceSettings ();
537+ }
538+
456539 /** Returns the builder for the settings used for calls to partialUpdateInstance. */
457540 public UnaryCallSettings .Builder <PartialUpdateInstanceRequest , Operation >
458541 partialUpdateInstanceSettings () {
0 commit comments