chore: Update generation configuration at Mon Sep 16 02:26:47 UTC 2024 (

#2336) * chore: Update generation configuration at Fri Sep 6 15:18:33 UTC 2024 * chore: generate libraries at Fri Sep 6 15:19:00 UTC 2024 * restore recommended_package * chore: generate libraries at Fri Sep 6 15:29:00 UTC 2024 * chore: Update generation configuration at Sat Sep 7 02:18:55 UTC 2024 * chore: Update generation configuration at Sun Sep 8 02:24:26 UTC 2024 * chore: Update generation configuration at Tue Sep 10 02:21:43 UTC 2024 * chore: Update generation configuration at Tue Sep 10 19:31:11 UTC 2024 * chore: generate libraries at Tue Sep 10 19:31:36 UTC 2024 * chore: Update generation configuration at Wed Sep 11 02:20:51 UTC 2024 * chore: generate libraries at Wed Sep 11 02:21:17 UTC 2024 * chore: Update generation configuration at Thu Sep 12 02:21:25 UTC 2024 * chore: Update generation configuration at Fri Sep 13 02:22:02 UTC 2024 * chore: Update generation configuration at Sat Sep 14 02:20:20 UTC 2024 * chore: Update generation configuration at Mon Sep 16 02:26:47 UTC 2024 --------- Co-authored-by: Diego Marquez <[email protected]>
googleapis · Sep 16, 2024 · 291bd89 · 291bd89
1 parent 8556574
commit 291bd89
Show file tree

Hide file tree

Showing 304 changed files with 1,514 additions and 379 deletions.
diff --git a/.repo-metadata.json b/.repo-metadata.json
@@ -2,17 +2,20 @@
   "api_shortname": "bigtable",
   "name_pretty": "Cloud Bigtable",
   "product_documentation": "https://cloud.google.com/bigtable",
+  "api_description": "API for reading and writing the contents of Bigtables associated with a cloud project.",
   "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-bigtable/latest/history",
-  "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
   "release_level": "stable",
+  "transport": "grpc",
   "language": "java",
   "repo": "googleapis/java-bigtable",
   "repo_short": "java-bigtable",
   "distribution_name": "com.google.cloud:google-cloud-bigtable",
-  "codeowner_team": "@googleapis/api-bigtable @googleapis/api-bigtable-partners",
   "api_id": "bigtable.googleapis.com",
   "library_type": "GAPIC_COMBO",
-  "extra_versioned_modules": "google-cloud-bigtable-emulator,google-cloud-bigtable-emulator-core",
+  "requires_billing": true,
+  "codeowner_team": "@googleapis/api-bigtable @googleapis/api-bigtable-partners",
   "excluded_poms": "google-cloud-bigtable-bom",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
+  "extra_versioned_modules": "google-cloud-bigtable-emulator,google-cloud-bigtable-emulator-core",
   "recommended_package": "com.google.cloud.bigtable"
-}
+}
diff --git a/README.md b/README.md
@@ -80,7 +80,7 @@ The client application making API calls must be granted [authorization scopes][a
 ### Prerequisites
 
 You will need a [Google Cloud Platform Console][developer-console] project with the Cloud Bigtable [API enabled][enable-api].
-
+You will need to [enable billing][enable-billing] to use Google Cloud Bigtable.
 [Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
 [installing the Google Cloud Command Line Interface][cloud-cli] and running the following commands in command line:
 `gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
@@ -93,7 +93,7 @@ to add `google-cloud-bigtable` as a dependency in your code.
 ## About Cloud Bigtable
 
 
-[Cloud Bigtable][product-docs] 
+[Cloud Bigtable][product-docs] API for reading and writing the contents of Bigtables associated with a cloud project.
 
 See the [Cloud Bigtable client library docs][javadocs] to learn how to
 use this Cloud Bigtable Client Library.
@@ -449,6 +449,10 @@ Samples are in the [`samples/`](https://github.com/googleapis/java-bigtable/tree
 
 To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
 
+## Transport
+
+Cloud Bigtable uses gRPC for the transport layer.
+
 ## Supported Java Versions
 
 Java 8 or above is required for using this client.
@@ -553,7 +557,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [contributing]: https://github.com/googleapis/java-bigtable/blob/main/CONTRIBUTING.md
 [code-of-conduct]: https://github.com/googleapis/java-bigtable/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
 [license]: https://github.com/googleapis/java-bigtable/blob/main/LICENSE
-
+[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
 [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=bigtable.googleapis.com
 [libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png

diff --git a/generation_config.yaml b/generation_config.yaml
@@ -1,6 +1,6 @@
-gapic_generator_version: 2.44.0
-googleapis_commitish: c93b54fa3060c7185f6dc724f0f9ec0c12bc44fc
-libraries_bom_version: 26.44.0
+gapic_generator_version: 2.45.0
+googleapis_commitish: 65306b92f03408d6de03589bdf970b78f2e4055c
+libraries_bom_version: 26.45.0
 template_excludes:
   - .gitignore
   - .kokoro/presubmit/integration.cfg
@@ -32,6 +32,7 @@ libraries:
   library_type: GAPIC_COMBO
   extra_versioned_modules: google-cloud-bigtable-emulator,google-cloud-bigtable-emulator-core
   excluded_poms: google-cloud-bigtable-bom
+  recommended_package: com.google.cloud.bigtable
   GAPICs:
   - proto_path: google/bigtable/v2
   - proto_path: google/bigtable/admin/v2
diff --git a/.../main/java/com/google/cloud/bigtable/admin/v2/stub/BigtableInstanceAdminStubSettings.java b/.../main/java/com/google/cloud/bigtable/admin/v2/stub/BigtableInstanceAdminStubSettings.java
@@ -106,7 +106,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of getInstance to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of getInstance:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -123,11 +125,48 @@
  *             .getInstanceSettings()
  *             .getRetrySettings()
  *             .toBuilder()
- *             .setTotalTimeout(Duration.ofSeconds(30))
+ *             .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ *             .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ *             .setMaxAttempts(5)
+ *             .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ *             .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ *             .setRetryDelayMultiplier(1.3)
+ *             .setRpcTimeoutMultiplier(1.5)
+ *             .setTotalTimeoutDuration(Duration.ofSeconds(300))
  *             .build());
  * BigtableInstanceAdminStubSettings baseBigtableInstanceAdminSettings =
  *     baseBigtableInstanceAdminSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
+ *
+ * <p>To configure the RetrySettings of a Long Running Operation method, create an
+ * OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
+ * configure the RetrySettings for createInstance:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * BigtableInstanceAdminStubSettings.Builder baseBigtableInstanceAdminSettingsBuilder =
+ *     BigtableInstanceAdminStubSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ *     OperationalTimedPollAlgorithm.create(
+ *         RetrySettings.newBuilder()
+ *             .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ *             .setRetryDelayMultiplier(1.5)
+ *             .setMaxRetryDelay(Duration.ofMillis(5000))
+ *             .setTotalTimeoutDuration(Duration.ofHours(24))
+ *             .build());
+ * baseBigtableInstanceAdminSettingsBuilder
+ *     .createClusterOperationSettings()
+ *     .setPollingAlgorithm(timedRetryAlgorithm)
+ *     .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class BigtableInstanceAdminStubSettings
@@ -221,9 +260,7 @@ public String extractNextToken(ListAppProfilesResponse payload) {
 
             @Override
             public Iterable<AppProfile> extractResources(ListAppProfilesResponse payload) {
-              return payload.getAppProfilesList() == null
-                  ? ImmutableList.<AppProfile>of()
-                  : payload.getAppProfilesList();
+              return payload.getAppProfilesList();
             }
           };
 
@@ -258,9 +295,7 @@ public String extractNextToken(ListHotTabletsResponse payload) {
 
             @Override
             public Iterable<HotTablet> extractResources(ListHotTabletsResponse payload) {
-              return payload.getHotTabletsList() == null
-                  ? ImmutableList.<HotTablet>of()
-                  : payload.getHotTabletsList();
+              return payload.getHotTabletsList();
             }
           };
 

diff --git a/...src/main/java/com/google/cloud/bigtable/admin/v2/stub/BigtableTableAdminStubSettings.java b/...src/main/java/com/google/cloud/bigtable/admin/v2/stub/BigtableTableAdminStubSettings.java
@@ -124,7 +124,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of createTable to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of createTable:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -141,11 +143,48 @@
  *             .createTableSettings()
  *             .getRetrySettings()
  *             .toBuilder()
- *             .setTotalTimeout(Duration.ofSeconds(30))
+ *             .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ *             .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ *             .setMaxAttempts(5)
+ *             .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ *             .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ *             .setRetryDelayMultiplier(1.3)
+ *             .setRpcTimeoutMultiplier(1.5)
+ *             .setTotalTimeoutDuration(Duration.ofSeconds(300))
  *             .build());
  * BigtableTableAdminStubSettings baseBigtableTableAdminSettings =
  *     baseBigtableTableAdminSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
+ *
+ * <p>To configure the RetrySettings of a Long Running Operation method, create an
+ * OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
+ * configure the RetrySettings for createTableFromSnapshot:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * BigtableTableAdminStubSettings.Builder baseBigtableTableAdminSettingsBuilder =
+ *     BigtableTableAdminStubSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ *     OperationalTimedPollAlgorithm.create(
+ *         RetrySettings.newBuilder()
+ *             .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ *             .setRetryDelayMultiplier(1.5)
+ *             .setMaxRetryDelay(Duration.ofMillis(5000))
+ *             .setTotalTimeoutDuration(Duration.ofHours(24))
+ *             .build());
+ * baseBigtableTableAdminSettingsBuilder
+ *     .createClusterOperationSettings()
+ *     .setPollingAlgorithm(timedRetryAlgorithm)
+ *     .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class BigtableTableAdminStubSettings extends StubSettings<BigtableTableAdminStubSettings> {
@@ -255,9 +294,7 @@ public String extractNextToken(ListTablesResponse payload) {
 
             @Override
             public Iterable<Table> extractResources(ListTablesResponse payload) {
-              return payload.getTablesList() == null
-                  ? ImmutableList.<Table>of()
-                  : payload.getTablesList();
+              return payload.getTablesList();
             }
           };
 
@@ -295,9 +332,7 @@ public String extractNextToken(ListAuthorizedViewsResponse payload) {
 
             @Override
             public Iterable<AuthorizedView> extractResources(ListAuthorizedViewsResponse payload) {
-              return payload.getAuthorizedViewsList() == null
-                  ? ImmutableList.<AuthorizedView>of()
-                  : payload.getAuthorizedViewsList();
+              return payload.getAuthorizedViewsList();
             }
           };
 
@@ -331,9 +366,7 @@ public String extractNextToken(ListSnapshotsResponse payload) {
 
             @Override
             public Iterable<Snapshot> extractResources(ListSnapshotsResponse payload) {
-              return payload.getSnapshotsList() == null
-                  ? ImmutableList.<Snapshot>of()
-                  : payload.getSnapshotsList();
+              return payload.getSnapshotsList();
             }
           };
 
@@ -367,9 +400,7 @@ public String extractNextToken(ListBackupsResponse payload) {
 
             @Override
             public Iterable<Backup> extractResources(ListBackupsResponse payload) {
-              return payload.getBackupsList() == null
-                  ? ImmutableList.<Backup>of()
-                  : payload.getBackupsList();
+              return payload.getBackupsList();
             }
           };
 

diff --git a/...in/resources/META-INF/native-image/com.google.cloud.bigtable.admin.v2/reflect-config.json b/...in/resources/META-INF/native-image/com.google.cloud.bigtable.admin.v2/reflect-config.json
@@ -305,6 +305,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.api.PythonSettings$ExperimentalFeatures",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.api.PythonSettings$ExperimentalFeatures$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.api.ResourceDescriptor",
     "queryAllDeclaredConstructors": true,
@@ -440,6 +458,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.bigtable.admin.v2.AppProfile$MultiClusterRoutingUseAny$RowAffinity",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.bigtable.admin.v2.AppProfile$MultiClusterRoutingUseAny$RowAffinity$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.bigtable.admin.v2.AppProfile$Priority",
     "queryAllDeclaredConstructors": true,

diff --git a/...ain/resources/META-INF/native-image/com.google.cloud.bigtable.data.v2/reflect-config.json b/...ain/resources/META-INF/native-image/com.google.cloud.bigtable.data.v2/reflect-config.json
@@ -305,6 +305,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.api.PythonSettings$ExperimentalFeatures",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.api.PythonSettings$ExperimentalFeatures$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.api.ResourceDescriptor",
     "queryAllDeclaredConstructors": true,