chore: Update generation configuration at Thu Sep 19 02:22:35 UTC 2024 (#11116)

* chore: generate libraries at Thu Sep 19 02:25:43 UTC 2024

Author: cloud-java-bot

generation_config.yaml

@@ -1,6 +1,6 @@
-gapic_generator_version: 2.44.0
-googleapis_commitish: a8f277295c12490d49c196b791e2101500864c30
-libraries_bom_version: 26.44.0
+gapic_generator_version: 2.45.0
+googleapis_commitish: 607c2ae82620153880a66898bcbf0a46d38d7d10
+libraries_bom_version: 26.46.0
 
 # the libraries are ordered with respect to library name, which is
 # java-{library.library_name} or java-{library.api-shortname} when

java-accessapproval/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.44.0</version>
+      <version>26.46.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -32,6 +32,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <groupId>com.google.cloud</groupId>
     <artifactId>google-cloud-accessapproval</artifactId>
   </dependency>
+</dependencies>
 ```
 
 If you are using Maven without the BOM, add this to your dependencies:
@@ -195,7 +196,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-accessapproval.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-accessapproval/2.48.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-accessapproval/2.50.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-accessapproval/google-cloud-accessapproval/src/main/java/com/google/cloud/accessapproval/v1/AccessApprovalAdminSettings.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 getApprovalRequest 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 getApprovalRequest:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -69,11 +71,22 @@
  *             .getApprovalRequestSettings()
  *             .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());
  * AccessApprovalAdminSettings accessApprovalAdminSettings =
  *     accessApprovalAdminSettingsBuilder.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 AccessApprovalAdminSettings extends ClientSettings<AccessApprovalAdminSettings> {

java-accessapproval/google-cloud-accessapproval/src/main/java/com/google/cloud/accessapproval/v1/stub/AccessApprovalStubSettings.java

@@ -83,7 +83,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 getApprovalRequest 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 getApprovalRequest:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -100,11 +102,22 @@
  *             .getApprovalRequestSettings()
  *             .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());
  * AccessApprovalStubSettings accessApprovalAdminSettings =
  *     accessApprovalAdminSettingsBuilder.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 AccessApprovalStubSettings extends StubSettings<AccessApprovalStubSettings> {
@@ -170,9 +183,7 @@ public String extractNextToken(ListApprovalRequestsResponse payload) {
             @Override
             public Iterable<ApprovalRequest> extractResources(
                 ListApprovalRequestsResponse payload) {
-              return payload.getApprovalRequestsList() == null
-                  ? ImmutableList.<ApprovalRequest>of()
-                  : payload.getApprovalRequestsList();
+              return payload.getApprovalRequestsList();
             }
           };
 

java-accessapproval/google-cloud-accessapproval/src/main/resources/META-INF/native-image/com.google.cloud.accessapproval.v1/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,

java-accessapproval/samples/snippets/generated/com/google/cloud/accessapproval/v1/accessapprovaladminsettings/getapprovalrequest/SyncGetApprovalRequest.java

@@ -41,7 +41,14 @@ public static void syncGetApprovalRequest() throws Exception {
                 .getApprovalRequestSettings()
                 .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());
     AccessApprovalAdminSettings accessApprovalAdminSettings =
         accessApprovalAdminSettingsBuilder.build();

java-accessapproval/samples/snippets/generated/com/google/cloud/accessapproval/v1/stub/accessapprovalstubsettings/getapprovalrequest/SyncGetApprovalRequest.java

@@ -41,7 +41,14 @@ public static void syncGetApprovalRequest() throws Exception {
                 .getApprovalRequestSettings()
                 .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());
     AccessApprovalStubSettings accessApprovalAdminSettings =
         accessApprovalAdminSettingsBuilder.build();

java-accesscontextmanager/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.44.0</version>
+      <version>26.46.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -32,6 +32,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <groupId>com.google.cloud</groupId>
     <artifactId>google-identity-accesscontextmanager</artifactId>
   </dependency>
+</dependencies>
 ```
 
 If you are using Maven without the BOM, add this to your dependencies:
@@ -195,7 +196,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-identity-accesscontextmanager.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-identity-accesscontextmanager/1.48.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-identity-accesscontextmanager/1.50.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-accesscontextmanager/google-identity-accesscontextmanager/src/main/java/com/google/identity/accesscontextmanager/v1/AccessContextManagerSettings.java

@@ -62,7 +62,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 getAccessPolicy 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 getAccessPolicy:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -79,11 +81,48 @@
  *             .getAccessPolicySettings()
  *             .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());
  * AccessContextManagerSettings accessContextManagerSettings =
  *     accessContextManagerSettingsBuilder.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 createAccessPolicy:
+ *
+ * <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
+ * AccessContextManagerSettings.Builder accessContextManagerSettingsBuilder =
+ *     AccessContextManagerSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ *     OperationalTimedPollAlgorithm.create(
+ *         RetrySettings.newBuilder()
+ *             .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ *             .setRetryDelayMultiplier(1.5)
+ *             .setMaxRetryDelay(Duration.ofMillis(5000))
+ *             .setTotalTimeoutDuration(Duration.ofHours(24))
+ *             .build());
+ * accessContextManagerSettingsBuilder
+ *     .createClusterOperationSettings()
+ *     .setPollingAlgorithm(timedRetryAlgorithm)
+ *     .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class AccessContextManagerSettings extends ClientSettings<AccessContextManagerSettings> {

java-accesscontextmanager/google-identity-accesscontextmanager/src/main/java/com/google/identity/accesscontextmanager/v1/stub/AccessContextManagerStubSettings.java

@@ -118,7 +118,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 getAccessPolicy 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 getAccessPolicy:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -135,11 +137,48 @@
  *             .getAccessPolicySettings()
  *             .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());
  * AccessContextManagerStubSettings accessContextManagerSettings =
  *     accessContextManagerSettingsBuilder.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 createAccessPolicy:
+ *
+ * <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
+ * AccessContextManagerStubSettings.Builder accessContextManagerSettingsBuilder =
+ *     AccessContextManagerStubSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ *     OperationalTimedPollAlgorithm.create(
+ *         RetrySettings.newBuilder()
+ *             .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ *             .setRetryDelayMultiplier(1.5)
+ *             .setMaxRetryDelay(Duration.ofMillis(5000))
+ *             .setTotalTimeoutDuration(Duration.ofHours(24))
+ *             .build());
+ * accessContextManagerSettingsBuilder
+ *     .createClusterOperationSettings()
+ *     .setPollingAlgorithm(timedRetryAlgorithm)
+ *     .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class AccessContextManagerStubSettings
@@ -288,9 +327,7 @@ public String extractNextToken(ListAccessPoliciesResponse payload) {
 
             @Override
             public Iterable<AccessPolicy> extractResources(ListAccessPoliciesResponse payload) {
-              return payload.getAccessPoliciesList() == null
-                  ? ImmutableList.<AccessPolicy>of()
-                  : payload.getAccessPoliciesList();
+              return payload.getAccessPoliciesList();
             }
           };
 
@@ -328,9 +365,7 @@ public String extractNextToken(ListAccessLevelsResponse payload) {
 
             @Override
             public Iterable<AccessLevel> extractResources(ListAccessLevelsResponse payload) {
-              return payload.getAccessLevelsList() == null
-                  ? ImmutableList.<AccessLevel>of()
-                  : payload.getAccessLevelsList();
+              return payload.getAccessLevelsList();
             }
           };
 
@@ -369,9 +404,7 @@ public String extractNextToken(ListServicePerimetersResponse payload) {
             @Override
             public Iterable<ServicePerimeter> extractResources(
                 ListServicePerimetersResponse payload) {
-              return payload.getServicePerimetersList() == null
-                  ? ImmutableList.<ServicePerimeter>of()
-                  : payload.getServicePerimetersList();
+              return payload.getServicePerimetersList();
             }
           };
 
@@ -416,9 +449,7 @@ public String extractNextToken(ListGcpUserAccessBindingsResponse payload) {
             @Override
             public Iterable<GcpUserAccessBinding> extractResources(
                 ListGcpUserAccessBindingsResponse payload) {
-              return payload.getGcpUserAccessBindingsList() == null
-                  ? ImmutableList.<GcpUserAccessBinding>of()
-                  : payload.getGcpUserAccessBindingsList();
+              return payload.getGcpUserAccessBindingsList();
             }
           };