feat: [compute] Update Compute Engine API to revision 20240130 (#881) (#10349)

* feat: Update Compute Engine API to revision 20240130 (#881)

Source-Link: googleapis/googleapis@6953fd7

Source-Link: https://github.com/googleapis/googleapis-gen/commit/5ba472f79245e420049c60f0c324e44578f272a3
Copy-Tag: eyJwIjoiamF2YS1jb21wdXRlLy5Pd2xCb3QueWFtbCIsImgiOiI1YmE0NzJmNzkyNDVlNDIwMDQ5YzYwZjBjMzI0ZTQ0NTc4ZjI3MmEzIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendBucketsClient.java

@@ -1394,7 +1394,7 @@ public final UnaryCallable<PatchBackendBucketRequest, Operation> patchCallable()
    * }</pre>
    *
    * @param project Project ID for this request.
-   * @param backendBucket Name of the BackendService resource to which the security policy should be
+   * @param backendBucket Name of the BackendBucket resource to which the security policy should be
    *     set. The name should conform to RFC1035.
    * @param securityPolicyReferenceResource The body resource for this request
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails

java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupManagersClient.java

@@ -280,7 +280,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> ListManagedInstances</td>
- *      <td><p> Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.</td>
+ *      <td><p> Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -2339,9 +2339,8 @@ public final ListErrorsPagedResponse listErrors(ListErrorsInstanceGroupManagersR
    * currentAction, which indicates the action that the managed instance group is performing on the
    * instance. For example, if the group is still creating an instance, the currentAction is
    * CREATING. If a previous action failed, the list displays the errors for that failed action. The
-   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only in
-   * the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only if
+   * the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2387,9 +2386,8 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * currentAction, which indicates the action that the managed instance group is performing on the
    * instance. For example, if the group is still creating an instance, the currentAction is
    * CREATING. If a previous action failed, the list displays the errors for that failed action. The
-   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only in
-   * the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only if
+   * the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2433,9 +2431,8 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * currentAction, which indicates the action that the managed instance group is performing on the
    * instance. For example, if the group is still creating an instance, the currentAction is
    * CREATING. If a previous action failed, the list displays the errors for that failed action. The
-   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only in
-   * the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only if
+   * the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2479,9 +2476,8 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * currentAction, which indicates the action that the managed instance group is performing on the
    * instance. For example, if the group is still creating an instance, the currentAction is
    * CREATING. If a previous action failed, the list displays the errors for that failed action. The
-   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only in
-   * the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * orderBy query parameter is not supported. The `pageToken` query parameter is supported only if
+   * the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *

java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesClient.java

@@ -403,6 +403,25 @@
  *       </td>
  *    </tr>
  *    <tr>
+ *      <td><p> PerformMaintenance</td>
+ *      <td><p> Perform a manual maintenance on the instance.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li><p> performMaintenanceAsync(PerformMaintenanceInstanceRequest request)
+ *      </ul>
+ *      <p>Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.</p>
+ *      <ul>
+ *           <li><p> performMaintenanceAsync(String project, String zone, String instance)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li><p> performMaintenanceOperationCallable()
+ *           <li><p> performMaintenanceCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
  *      <td><p> RemoveResourcePolicies</td>
  *      <td><p> Removes resource policies from an instance.</td>
  *      <td>
@@ -3355,6 +3374,140 @@ public final ListReferrersPagedResponse listReferrers(ListReferrersInstancesRequ
     return stub.listReferrersCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Perform a manual maintenance on the instance.
+   *
+   * <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 (InstancesClient instancesClient = InstancesClient.create()) {
+   *   String project = "project-309310695";
+   *   String zone = "zone3744684";
+   *   String instance = "instance555127957";
+   *   Operation response = instancesClient.performMaintenanceAsync(project, zone, instance).get();
+   * }
+   * }</pre>
+   *
+   * @param project Project ID for this request.
+   * @param zone The name of the zone for this request.
+   * @param instance Name of the instance scoping this request.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Operation, Operation> performMaintenanceAsync(
+      String project, String zone, String instance) {
+    PerformMaintenanceInstanceRequest request =
+        PerformMaintenanceInstanceRequest.newBuilder()
+            .setProject(project)
+            .setZone(zone)
+            .setInstance(instance)
+            .build();
+    return performMaintenanceAsync(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Perform a manual maintenance on the instance.
+   *
+   * <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 (InstancesClient instancesClient = InstancesClient.create()) {
+   *   PerformMaintenanceInstanceRequest request =
+   *       PerformMaintenanceInstanceRequest.newBuilder()
+   *           .setInstance("instance555127957")
+   *           .setProject("project-309310695")
+   *           .setRequestId("requestId693933066")
+   *           .setZone("zone3744684")
+   *           .build();
+   *   Operation response = instancesClient.performMaintenanceAsync(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
+   */
+  @BetaApi(
+      "The surface for long-running operations is not stable yet and may change in the future.")
+  public final OperationFuture<Operation, Operation> performMaintenanceAsync(
+      PerformMaintenanceInstanceRequest request) {
+    return performMaintenanceOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Perform a manual maintenance on the instance.
+   *
+   * <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 (InstancesClient instancesClient = InstancesClient.create()) {
+   *   PerformMaintenanceInstanceRequest request =
+   *       PerformMaintenanceInstanceRequest.newBuilder()
+   *           .setInstance("instance555127957")
+   *           .setProject("project-309310695")
+   *           .setRequestId("requestId693933066")
+   *           .setZone("zone3744684")
+   *           .build();
+   *   OperationFuture<Operation, Operation> future =
+   *       instancesClient.performMaintenanceOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<PerformMaintenanceInstanceRequest, Operation, Operation>
+      performMaintenanceOperationCallable() {
+    return stub.performMaintenanceOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Perform a manual maintenance on the instance.
+   *
+   * <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 (InstancesClient instancesClient = InstancesClient.create()) {
+   *   PerformMaintenanceInstanceRequest request =
+   *       PerformMaintenanceInstanceRequest.newBuilder()
+   *           .setInstance("instance555127957")
+   *           .setProject("project-309310695")
+   *           .setRequestId("requestId693933066")
+   *           .setZone("zone3744684")
+   *           .build();
+   *   ApiFuture<Operation> future =
+   *       instancesClient.performMaintenanceCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<PerformMaintenanceInstanceRequest, Operation>
+      performMaintenanceCallable() {
+    return stub.performMaintenanceCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Removes resource policies from an instance.
@@ -5970,6 +6123,7 @@ public final OperationFuture<Operation, Operation> simulateMaintenanceEventAsync
    *           .setInstance("instance555127957")
    *           .setProject("project-309310695")
    *           .setRequestId("requestId693933066")
+   *           .setWithExtendedNotifications(true)
    *           .setZone("zone3744684")
    *           .build();
    *   Operation response = instancesClient.simulateMaintenanceEventAsync(request).get();
@@ -6005,6 +6159,7 @@ public final OperationFuture<Operation, Operation> simulateMaintenanceEventAsync
    *           .setInstance("instance555127957")
    *           .setProject("project-309310695")
    *           .setRequestId("requestId693933066")
+   *           .setWithExtendedNotifications(true)
    *           .setZone("zone3744684")
    *           .build();
    *   OperationFuture<Operation, Operation> future =
@@ -6038,6 +6193,7 @@ public final OperationFuture<Operation, Operation> simulateMaintenanceEventAsync
    *           .setInstance("instance555127957")
    *           .setProject("project-309310695")
    *           .setRequestId("requestId693933066")
+   *           .setWithExtendedNotifications(true)
    *           .setZone("zone3744684")
    *           .build();
    *   ApiFuture<Operation> future =

java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesSettings.java

@@ -225,6 +225,18 @@ public PagedCallSettings<ListInstancesRequest, InstanceList, ListPagedResponse>
     return ((InstancesStubSettings) getStubSettings()).listReferrersSettings();
   }
 
+  /** Returns the object with the settings used for calls to performMaintenance. */
+  public UnaryCallSettings<PerformMaintenanceInstanceRequest, Operation>
+      performMaintenanceSettings() {
+    return ((InstancesStubSettings) getStubSettings()).performMaintenanceSettings();
+  }
+
+  /** Returns the object with the settings used for calls to performMaintenance. */
+  public OperationCallSettings<PerformMaintenanceInstanceRequest, Operation, Operation>
+      performMaintenanceOperationSettings() {
+    return ((InstancesStubSettings) getStubSettings()).performMaintenanceOperationSettings();
+  }
+
   /** Returns the object with the settings used for calls to removeResourcePolicies. */
   public UnaryCallSettings<RemoveResourcePoliciesInstanceRequest, Operation>
       removeResourcePoliciesSettings() {
@@ -795,6 +807,18 @@ public UnaryCallSettings.Builder<InsertInstanceRequest, Operation> insertSetting
       return getStubSettingsBuilder().listReferrersSettings();
     }
 
+    /** Returns the builder for the settings used for calls to performMaintenance. */
+    public UnaryCallSettings.Builder<PerformMaintenanceInstanceRequest, Operation>
+        performMaintenanceSettings() {
+      return getStubSettingsBuilder().performMaintenanceSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to performMaintenance. */
+    public OperationCallSettings.Builder<PerformMaintenanceInstanceRequest, Operation, Operation>
+        performMaintenanceOperationSettings() {
+      return getStubSettingsBuilder().performMaintenanceOperationSettings();
+    }
+
     /** Returns the builder for the settings used for calls to removeResourcePolicies. */
     public UnaryCallSettings.Builder<RemoveResourcePoliciesInstanceRequest, Operation>
         removeResourcePoliciesSettings() {

java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupManagersClient.java

@@ -260,7 +260,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> ListManagedInstances</td>
- *      <td><p> Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.</td>
+ *      <td><p> Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -2165,8 +2165,7 @@ public final ListErrorsPagedResponse listErrors(
    * Lists the instances in the managed instance group and instances that are scheduled to be
    * created. The list includes any current actions that the group has scheduled for its instances.
    * The orderBy query parameter is not supported. The `pageToken` query parameter is supported only
-   * in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2211,8 +2210,7 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * Lists the instances in the managed instance group and instances that are scheduled to be
    * created. The list includes any current actions that the group has scheduled for its instances.
    * The orderBy query parameter is not supported. The `pageToken` query parameter is supported only
-   * in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2255,8 +2253,7 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * Lists the instances in the managed instance group and instances that are scheduled to be
    * created. The list includes any current actions that the group has scheduled for its instances.
    * The orderBy query parameter is not supported. The `pageToken` query parameter is supported only
-   * in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *
@@ -2299,8 +2296,7 @@ public final ListManagedInstancesPagedResponse listManagedInstances(
    * Lists the instances in the managed instance group and instances that are scheduled to be
    * created. The list includes any current actions that the group has scheduled for its instances.
    * The orderBy query parameter is not supported. The `pageToken` query parameter is supported only
-   * in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to
-   * `PAGINATED`.
+   * if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
    *
    * <p>Sample code:
    *