feat: [file] Added REGIONAL tier support in the v1beta1 API

java-filestore/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.23.0</version>
+      <version>26.27.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -195,7 +195,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-filestore.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-filestore/1.25.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-filestore/1.31.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-filestore/google-cloud-filestore/src/main/java/com/google/cloud/filestore/v1/CloudFilestoreManagerClient.java

@@ -955,6 +955,98 @@ public final UnaryCallable<RestoreInstanceRequest, Operation> restoreInstanceCal
     return stub.restoreInstanceCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Revert an existing instance's file system to a specified snapshot.
+   *
+   * <p>Sample code:
+   *
+   * <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
+   * try (CloudFilestoreManagerClient cloudFilestoreManagerClient =
+   *     CloudFilestoreManagerClient.create()) {
+   *   RevertInstanceRequest request =
+   *       RevertInstanceRequest.newBuilder()
+   *           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
+   *           .setTargetSnapshotId("targetSnapshotId-2099459472")
+   *           .build();
+   *   Instance response = cloudFilestoreManagerClient.revertInstanceAsync(request).get();
+   * }
+   * }</pre>
+   *
+   * @param request The request object containing all of the parameters for the API call.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Instance, OperationMetadata> revertInstanceAsync(
+      RevertInstanceRequest request) {
+    return revertInstanceOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Revert an existing instance's file system to a specified snapshot.
+   *
+   * <p>Sample code:
+   *
+   * <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
+   * try (CloudFilestoreManagerClient cloudFilestoreManagerClient =
+   *     CloudFilestoreManagerClient.create()) {
+   *   RevertInstanceRequest request =
+   *       RevertInstanceRequest.newBuilder()
+   *           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
+   *           .setTargetSnapshotId("targetSnapshotId-2099459472")
+   *           .build();
+   *   OperationFuture<Instance, OperationMetadata> future =
+   *       cloudFilestoreManagerClient.revertInstanceOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Instance response = future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<RevertInstanceRequest, Instance, OperationMetadata>
+      revertInstanceOperationCallable() {
+    return stub.revertInstanceOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Revert an existing instance's file system to a specified snapshot.
+   *
+   * <p>Sample code:
+   *
+   * <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
+   * try (CloudFilestoreManagerClient cloudFilestoreManagerClient =
+   *     CloudFilestoreManagerClient.create()) {
+   *   RevertInstanceRequest request =
+   *       RevertInstanceRequest.newBuilder()
+   *           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
+   *           .setTargetSnapshotId("targetSnapshotId-2099459472")
+   *           .build();
+   *   ApiFuture<Operation> future =
+   *       cloudFilestoreManagerClient.revertInstanceCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<RevertInstanceRequest, Operation> revertInstanceCallable() {
+    return stub.revertInstanceCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an instance.

java-filestore/google-cloud-filestore/src/main/java/com/google/cloud/filestore/v1/CloudFilestoreManagerSettings.java

@@ -129,6 +129,18 @@ public UnaryCallSettings<RestoreInstanceRequest, Operation> restoreInstanceSetti
         .restoreInstanceOperationSettings();
   }
 
+  /** Returns the object with the settings used for calls to revertInstance. */
+  public UnaryCallSettings<RevertInstanceRequest, Operation> revertInstanceSettings() {
+    return ((CloudFilestoreManagerStubSettings) getStubSettings()).revertInstanceSettings();
+  }
+
+  /** Returns the object with the settings used for calls to revertInstance. */
+  public OperationCallSettings<RevertInstanceRequest, Instance, OperationMetadata>
+      revertInstanceOperationSettings() {
+    return ((CloudFilestoreManagerStubSettings) getStubSettings())
+        .revertInstanceOperationSettings();
+  }
+
   /** Returns the object with the settings used for calls to deleteInstance. */
   public UnaryCallSettings<DeleteInstanceRequest, Operation> deleteInstanceSettings() {
     return ((CloudFilestoreManagerStubSettings) getStubSettings()).deleteInstanceSettings();
@@ -393,6 +405,17 @@ public UnaryCallSettings.Builder<RestoreInstanceRequest, Operation> restoreInsta
       return getStubSettingsBuilder().restoreInstanceOperationSettings();
     }
 
+    /** Returns the builder for the settings used for calls to revertInstance. */
+    public UnaryCallSettings.Builder<RevertInstanceRequest, Operation> revertInstanceSettings() {
+      return getStubSettingsBuilder().revertInstanceSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to revertInstance. */
+    public OperationCallSettings.Builder<RevertInstanceRequest, Instance, OperationMetadata>
+        revertInstanceOperationSettings() {
+      return getStubSettingsBuilder().revertInstanceOperationSettings();
+    }
+
     /** Returns the builder for the settings used for calls to deleteInstance. */
     public UnaryCallSettings.Builder<DeleteInstanceRequest, Operation> deleteInstanceSettings() {
       return getStubSettingsBuilder().deleteInstanceSettings();

java-filestore/google-cloud-filestore/src/main/java/com/google/cloud/filestore/v1/gapic_metadata.json

@@ -49,6 +49,9 @@
             "RestoreInstance": {
               "methods": ["restoreInstanceAsync", "restoreInstanceOperationCallable", "restoreInstanceCallable"]
             },
+            "RevertInstance": {
+              "methods": ["revertInstanceAsync", "revertInstanceOperationCallable", "revertInstanceCallable"]
+            },
             "UpdateBackup": {
               "methods": ["updateBackupAsync", "updateBackupAsync", "updateBackupOperationCallable", "updateBackupCallable"]
             },

java-filestore/google-cloud-filestore/src/main/java/com/google/cloud/filestore/v1/stub/CloudFilestoreManagerStub.java

@@ -42,6 +42,7 @@
 import com.google.cloud.filestore.v1.ListSnapshotsRequest;
 import com.google.cloud.filestore.v1.ListSnapshotsResponse;
 import com.google.cloud.filestore.v1.RestoreInstanceRequest;
+import com.google.cloud.filestore.v1.RevertInstanceRequest;
 import com.google.cloud.filestore.v1.Snapshot;
 import com.google.cloud.filestore.v1.UpdateBackupRequest;
 import com.google.cloud.filestore.v1.UpdateInstanceRequest;
@@ -108,6 +109,15 @@ public UnaryCallable<RestoreInstanceRequest, Operation> restoreInstanceCallable(
     throw new UnsupportedOperationException("Not implemented: restoreInstanceCallable()");
   }
 
+  public OperationCallable<RevertInstanceRequest, Instance, OperationMetadata>
+      revertInstanceOperationCallable() {
+    throw new UnsupportedOperationException("Not implemented: revertInstanceOperationCallable()");
+  }
+
+  public UnaryCallable<RevertInstanceRequest, Operation> revertInstanceCallable() {
+    throw new UnsupportedOperationException("Not implemented: revertInstanceCallable()");
+  }
+
   public OperationCallable<DeleteInstanceRequest, Empty, OperationMetadata>
       deleteInstanceOperationCallable() {
     throw new UnsupportedOperationException("Not implemented: deleteInstanceOperationCallable()");

java-filestore/google-cloud-filestore/src/main/java/com/google/cloud/filestore/v1/stub/CloudFilestoreManagerStubSettings.java

@@ -68,6 +68,7 @@
 import com.google.cloud.filestore.v1.ListSnapshotsRequest;
 import com.google.cloud.filestore.v1.ListSnapshotsResponse;
 import com.google.cloud.filestore.v1.RestoreInstanceRequest;
+import com.google.cloud.filestore.v1.RevertInstanceRequest;
 import com.google.cloud.filestore.v1.Snapshot;
 import com.google.cloud.filestore.v1.UpdateBackupRequest;
 import com.google.cloud.filestore.v1.UpdateInstanceRequest;
@@ -141,6 +142,9 @@ public class CloudFilestoreManagerStubSettings
   private final UnaryCallSettings<RestoreInstanceRequest, Operation> restoreInstanceSettings;
   private final OperationCallSettings<RestoreInstanceRequest, Instance, OperationMetadata>
       restoreInstanceOperationSettings;
+  private final UnaryCallSettings<RevertInstanceRequest, Operation> revertInstanceSettings;
+  private final OperationCallSettings<RevertInstanceRequest, Instance, OperationMetadata>
+      revertInstanceOperationSettings;
   private final UnaryCallSettings<DeleteInstanceRequest, Operation> deleteInstanceSettings;
   private final OperationCallSettings<DeleteInstanceRequest, Empty, OperationMetadata>
       deleteInstanceOperationSettings;
@@ -373,6 +377,17 @@ public UnaryCallSettings<RestoreInstanceRequest, Operation> restoreInstanceSetti
     return restoreInstanceOperationSettings;
   }
 
+  /** Returns the object with the settings used for calls to revertInstance. */
+  public UnaryCallSettings<RevertInstanceRequest, Operation> revertInstanceSettings() {
+    return revertInstanceSettings;
+  }
+
+  /** Returns the object with the settings used for calls to revertInstance. */
+  public OperationCallSettings<RevertInstanceRequest, Instance, OperationMetadata>
+      revertInstanceOperationSettings() {
+    return revertInstanceOperationSettings;
+  }
+
   /** Returns the object with the settings used for calls to deleteInstance. */
   public UnaryCallSettings<DeleteInstanceRequest, Operation> deleteInstanceSettings() {
     return deleteInstanceSettings;
@@ -586,6 +601,8 @@ protected CloudFilestoreManagerStubSettings(Builder settingsBuilder) throws IOEx
     updateInstanceOperationSettings = settingsBuilder.updateInstanceOperationSettings().build();
     restoreInstanceSettings = settingsBuilder.restoreInstanceSettings().build();
     restoreInstanceOperationSettings = settingsBuilder.restoreInstanceOperationSettings().build();
+    revertInstanceSettings = settingsBuilder.revertInstanceSettings().build();
+    revertInstanceOperationSettings = settingsBuilder.revertInstanceOperationSettings().build();
     deleteInstanceSettings = settingsBuilder.deleteInstanceSettings().build();
     deleteInstanceOperationSettings = settingsBuilder.deleteInstanceOperationSettings().build();
     listSnapshotsSettings = settingsBuilder.listSnapshotsSettings().build();
@@ -626,6 +643,10 @@ public static class Builder
         restoreInstanceSettings;
     private final OperationCallSettings.Builder<RestoreInstanceRequest, Instance, OperationMetadata>
         restoreInstanceOperationSettings;
+    private final UnaryCallSettings.Builder<RevertInstanceRequest, Operation>
+        revertInstanceSettings;
+    private final OperationCallSettings.Builder<RevertInstanceRequest, Instance, OperationMetadata>
+        revertInstanceOperationSettings;
     private final UnaryCallSettings.Builder<DeleteInstanceRequest, Operation>
         deleteInstanceSettings;
     private final OperationCallSettings.Builder<DeleteInstanceRequest, Empty, OperationMetadata>
@@ -672,9 +693,9 @@ public static class Builder
           "no_retry_1_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
       definitions.put(
           "no_retry_2_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
+      definitions.put("no_retry_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
       definitions.put(
           "no_retry_3_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
-      definitions.put("no_retry_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
       RETRYABLE_CODE_DEFINITIONS = definitions.build();
     }
 
@@ -710,6 +731,8 @@ public static class Builder
               .setTotalTimeout(Duration.ofMillis(14400000L))
               .build();
       definitions.put("no_retry_2_params", settings);
+      settings = RetrySettings.newBuilder().setRpcTimeoutMultiplier(1.0).build();
+      definitions.put("no_retry_params", settings);
       settings =
           RetrySettings.newBuilder()
               .setInitialRpcTimeout(Duration.ofMillis(600000L))
@@ -718,8 +741,6 @@ public static class Builder
               .setTotalTimeout(Duration.ofMillis(600000L))
               .build();
       definitions.put("no_retry_3_params", settings);
-      settings = RetrySettings.newBuilder().setRpcTimeoutMultiplier(1.0).build();
-      definitions.put("no_retry_params", settings);
       RETRY_PARAM_DEFINITIONS = definitions.build();
     }
 
@@ -738,6 +759,8 @@ protected Builder(ClientContext clientContext) {
       updateInstanceOperationSettings = OperationCallSettings.newBuilder();
       restoreInstanceSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
       restoreInstanceOperationSettings = OperationCallSettings.newBuilder();
+      revertInstanceSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
+      revertInstanceOperationSettings = OperationCallSettings.newBuilder();
       deleteInstanceSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
       deleteInstanceOperationSettings = OperationCallSettings.newBuilder();
       listSnapshotsSettings = PagedCallSettings.newBuilder(LIST_SNAPSHOTS_PAGE_STR_FACT);
@@ -764,6 +787,7 @@ protected Builder(ClientContext clientContext) {
               createInstanceSettings,
               updateInstanceSettings,
               restoreInstanceSettings,
+              revertInstanceSettings,
               deleteInstanceSettings,
               listSnapshotsSettings,
               getSnapshotSettings,
@@ -789,6 +813,8 @@ protected Builder(CloudFilestoreManagerStubSettings settings) {
       updateInstanceOperationSettings = settings.updateInstanceOperationSettings.toBuilder();
       restoreInstanceSettings = settings.restoreInstanceSettings.toBuilder();
       restoreInstanceOperationSettings = settings.restoreInstanceOperationSettings.toBuilder();
+      revertInstanceSettings = settings.revertInstanceSettings.toBuilder();
+      revertInstanceOperationSettings = settings.revertInstanceOperationSettings.toBuilder();
       deleteInstanceSettings = settings.deleteInstanceSettings.toBuilder();
       deleteInstanceOperationSettings = settings.deleteInstanceOperationSettings.toBuilder();
       listSnapshotsSettings = settings.listSnapshotsSettings.toBuilder();
@@ -815,6 +841,7 @@ protected Builder(CloudFilestoreManagerStubSettings settings) {
               createInstanceSettings,
               updateInstanceSettings,
               restoreInstanceSettings,
+              revertInstanceSettings,
               deleteInstanceSettings,
               listSnapshotsSettings,
               getSnapshotSettings,
@@ -880,6 +907,11 @@ private static Builder initDefaults(Builder builder) {
           .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_1_codes"))
           .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_1_params"));
 
+      builder
+          .revertInstanceSettings()
+          .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_codes"))
+          .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_params"));
+
       builder
           .deleteInstanceSettings()
           .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_3_codes"))
@@ -1007,6 +1039,30 @@ private static Builder initDefaults(Builder builder) {
                       .setTotalTimeout(Duration.ofMillis(300000L))
                       .build()));
 
+      builder
+          .revertInstanceOperationSettings()
+          .setInitialCallSettings(
+              UnaryCallSettings
+                  .<RevertInstanceRequest, OperationSnapshot>newUnaryCallSettingsBuilder()
+                  .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_codes"))
+                  .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_params"))
+                  .build())
+          .setResponseTransformer(
+              ProtoOperationTransformers.ResponseTransformer.create(Instance.class))
+          .setMetadataTransformer(
+              ProtoOperationTransformers.MetadataTransformer.create(OperationMetadata.class))
+          .setPollingAlgorithm(
+              OperationTimedPollAlgorithm.create(
+                  RetrySettings.newBuilder()
+                      .setInitialRetryDelay(Duration.ofMillis(5000L))
+                      .setRetryDelayMultiplier(1.5)
+                      .setMaxRetryDelay(Duration.ofMillis(45000L))
+                      .setInitialRpcTimeout(Duration.ZERO)
+                      .setRpcTimeoutMultiplier(1.0)
+                      .setMaxRpcTimeout(Duration.ZERO)
+                      .setTotalTimeout(Duration.ofMillis(300000L))
+                      .build()));
+
       builder
           .deleteInstanceOperationSettings()
           .setInitialCallSettings(
@@ -1244,6 +1300,19 @@ public UnaryCallSettings.Builder<RestoreInstanceRequest, Operation> restoreInsta
       return restoreInstanceOperationSettings;
     }
 
+    /** Returns the builder for the settings used for calls to revertInstance. */
+    public UnaryCallSettings.Builder<RevertInstanceRequest, Operation> revertInstanceSettings() {
+      return revertInstanceSettings;
+    }
+
+    /** Returns the builder for the settings used for calls to revertInstance. */
+    @BetaApi(
+        "The surface for use by generated code is not stable yet and may change in the future.")
+    public OperationCallSettings.Builder<RevertInstanceRequest, Instance, OperationMetadata>
+        revertInstanceOperationSettings() {
+      return revertInstanceOperationSettings;
+    }
+
     /** Returns the builder for the settings used for calls to deleteInstance. */
     public UnaryCallSettings.Builder<DeleteInstanceRequest, Operation> deleteInstanceSettings() {
       return deleteInstanceSettings;