chore: Update generation configuration at Wed Sep 11 02:19:33 UTC 2024 (#2701)

* chore: Update generation configuration at Wed Sep 11 02:19:33 UTC 2024 * chore: generate libraries at Wed Sep 11 02:20:01 UTC 2024

Author: cloud-java-bot

gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageSettings.java

@@ -59,7 +59,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 deleteBucket 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 deleteBucket:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -75,10 +77,21 @@
  * .deleteBucketSettings()
  * .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());
  * StorageSettings storageSettings = storageSettingsBuilder.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.
  */
 @Generated("by gapic-generator-java")
 public class StorageSettings extends ClientSettings<StorageSettings> {

gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/stub/StorageStubSettings.java

@@ -121,7 +121,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 deleteBucket 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 deleteBucket:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -137,10 +139,21 @@
  * .deleteBucketSettings()
  * .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());
  * StorageStubSettings storageSettings = storageSettingsBuilder.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.
  */
 @Generated("by gapic-generator-java")
 public class StorageStubSettings extends StubSettings<StorageStubSettings> {
@@ -237,9 +250,7 @@ public String extractNextToken(ListBucketsResponse payload) {
 
  @Override
  public Iterable<Bucket> extractResources(ListBucketsResponse payload) {
- return payload.getBucketsList() == null
- ? ImmutableList.<Bucket>of()
- : payload.getBucketsList();
+ return payload.getBucketsList();
  }
  };
 
@@ -282,9 +293,7 @@ public String extractNextToken(ListNotificationConfigsResponse payload) {
  @Override
  public Iterable<NotificationConfig> extractResources(
  ListNotificationConfigsResponse payload) {
- return payload.getNotificationConfigsList() == null
- ? ImmutableList.<NotificationConfig>of()
- : payload.getNotificationConfigsList();
+ return payload.getNotificationConfigsList();
  }
  };
 
@@ -318,9 +327,7 @@ public String extractNextToken(ListObjectsResponse payload) {
 
  @Override
  public Iterable<Object> extractResources(ListObjectsResponse payload) {
- return payload.getObjectsList() == null
- ? ImmutableList.<Object>of()
- : payload.getObjectsList();
+ return payload.getObjectsList();
  }
  };
 
@@ -355,9 +362,7 @@ public String extractNextToken(ListHmacKeysResponse payload) {
 
  @Override
  public Iterable<HmacKeyMetadata> extractResources(ListHmacKeysResponse payload) {
- return payload.getHmacKeysList() == null
- ? ImmutableList.<HmacKeyMetadata>of()
- : payload.getHmacKeysList();
+ return payload.getHmacKeysList();
  }
  };
 

generation_config.yaml

@@ -1,5 +1,5 @@
-gapic_generator_version: 2.44.0
-googleapis_commitish: b83ceb6200f3af1dfab314583622452f4e514231
+gapic_generator_version: 2.45.0
+googleapis_commitish: cbf696d38a963c5ab333f85fc9a910b5698ad415
 libraries_bom_version: 26.45.0
 libraries:
  - api_shortname: storage

google-cloud-storage-control/src/main/java/com/google/storage/control/v2/StorageControlSettings.java

@@ -52,7 +52,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 createFolder 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 createFolder:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -69,10 +71,47 @@
  * .createFolderSettings()
  * .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());
  * StorageControlSettings storageControlSettings = storageControlSettingsBuilder.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 renameFolder:
+ *
+ * <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
+ * StorageControlSettings.Builder storageControlSettingsBuilder =
+ * StorageControlSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ * OperationalTimedPollAlgorithm.create(
+ * RetrySettings.newBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ * .setRetryDelayMultiplier(1.5)
+ * .setMaxRetryDelay(Duration.ofMillis(5000))
+ * .setTotalTimeoutDuration(Duration.ofHours(24))
+ * .build());
+ * storageControlSettingsBuilder
+ * .createClusterOperationSettings()
+ * .setPollingAlgorithm(timedRetryAlgorithm)
+ * .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class StorageControlSettings extends ClientSettings<StorageControlSettings> {

google-cloud-storage-control/src/main/java/com/google/storage/control/v2/stub/StorageControlStubSettings.java

@@ -87,7 +87,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 createFolder 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 createFolder:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -104,10 +106,47 @@
  * .createFolderSettings()
  * .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());
  * StorageControlStubSettings storageControlSettings = storageControlSettingsBuilder.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 renameFolder:
+ *
+ * <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
+ * StorageControlStubSettings.Builder storageControlSettingsBuilder =
+ * StorageControlStubSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ * OperationalTimedPollAlgorithm.create(
+ * RetrySettings.newBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ * .setRetryDelayMultiplier(1.5)
+ * .setMaxRetryDelay(Duration.ofMillis(5000))
+ * .setTotalTimeoutDuration(Duration.ofHours(24))
+ * .build());
+ * storageControlSettingsBuilder
+ * .createClusterOperationSettings()
+ * .setPollingAlgorithm(timedRetryAlgorithm)
+ * .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class StorageControlStubSettings extends StubSettings<StorageControlStubSettings> {
@@ -168,9 +207,7 @@ public String extractNextToken(ListFoldersResponse payload) {
 
  @Override
  public Iterable<Folder> extractResources(ListFoldersResponse payload) {
- return payload.getFoldersList() == null
- ? ImmutableList.<Folder>of()
- : payload.getFoldersList();
+ return payload.getFoldersList();
  }
  };
 
@@ -208,9 +245,7 @@ public String extractNextToken(ListManagedFoldersResponse payload) {
 
  @Override
  public Iterable<ManagedFolder> extractResources(ListManagedFoldersResponse payload) {
- return payload.getManagedFoldersList() == null
- ? ImmutableList.<ManagedFolder>of()
- : payload.getManagedFoldersList();
+ return payload.getManagedFoldersList();
  }
  };