feat: [compute] Update Compute Engine API to revision 20230711 (#836)

java-compute/README.md

@@ -260,7 +260,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-compute.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-compute/1.31.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-compute/1.32.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-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSecurityPoliciesClient.java

@@ -701,7 +701,7 @@ public final UnaryCallable<ListRegionSecurityPoliciesRequest, SecurityPolicyList
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -747,7 +747,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -786,7 +786,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -823,7 +823,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *

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

@@ -923,6 +923,150 @@ public final UnaryCallable<ListResourcePoliciesRequest, ResourcePolicyList> list
     return stub.listCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Modify the specified resource policy.
+   *
+   * <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 (ResourcePoliciesClient resourcePoliciesClient = ResourcePoliciesClient.create()) {
+   *   String project = "project-309310695";
+   *   String region = "region-934795532";
+   *   String resourcePolicy = "resourcePolicy-130903328";
+   *   ResourcePolicy resourcePolicyResource = ResourcePolicy.newBuilder().build();
+   *   Operation response =
+   *       resourcePoliciesClient
+   *           .patchAsync(project, region, resourcePolicy, resourcePolicyResource)
+   *           .get();
+   * }
+   * }</pre>
+   *
+   * @param project Project ID for this request.
+   * @param region Name of the region for this request.
+   * @param resourcePolicy Id of the resource policy to patch.
+   * @param resourcePolicyResource The body resource for this request
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Operation, Operation> patchAsync(
+      String project, String region, String resourcePolicy, ResourcePolicy resourcePolicyResource) {
+    PatchResourcePolicyRequest request =
+        PatchResourcePolicyRequest.newBuilder()
+            .setProject(project)
+            .setRegion(region)
+            .setResourcePolicy(resourcePolicy)
+            .setResourcePolicyResource(resourcePolicyResource)
+            .build();
+    return patchAsync(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Modify the specified resource policy.
+   *
+   * <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 (ResourcePoliciesClient resourcePoliciesClient = ResourcePoliciesClient.create()) {
+   *   PatchResourcePolicyRequest request =
+   *       PatchResourcePolicyRequest.newBuilder()
+   *           .setProject("project-309310695")
+   *           .setRegion("region-934795532")
+   *           .setRequestId("requestId693933066")
+   *           .setResourcePolicy("resourcePolicy-130903328")
+   *           .setResourcePolicyResource(ResourcePolicy.newBuilder().build())
+   *           .setUpdateMask("updateMask-296147115")
+   *           .build();
+   *   Operation response = resourcePoliciesClient.patchAsync(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> patchAsync(
+      PatchResourcePolicyRequest request) {
+    return patchOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Modify the specified resource policy.
+   *
+   * <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 (ResourcePoliciesClient resourcePoliciesClient = ResourcePoliciesClient.create()) {
+   *   PatchResourcePolicyRequest request =
+   *       PatchResourcePolicyRequest.newBuilder()
+   *           .setProject("project-309310695")
+   *           .setRegion("region-934795532")
+   *           .setRequestId("requestId693933066")
+   *           .setResourcePolicy("resourcePolicy-130903328")
+   *           .setResourcePolicyResource(ResourcePolicy.newBuilder().build())
+   *           .setUpdateMask("updateMask-296147115")
+   *           .build();
+   *   OperationFuture<Operation, Operation> future =
+   *       resourcePoliciesClient.patchOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<PatchResourcePolicyRequest, Operation, Operation>
+      patchOperationCallable() {
+    return stub.patchOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Modify the specified resource policy.
+   *
+   * <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 (ResourcePoliciesClient resourcePoliciesClient = ResourcePoliciesClient.create()) {
+   *   PatchResourcePolicyRequest request =
+   *       PatchResourcePolicyRequest.newBuilder()
+   *           .setProject("project-309310695")
+   *           .setRegion("region-934795532")
+   *           .setRequestId("requestId693933066")
+   *           .setResourcePolicy("resourcePolicy-130903328")
+   *           .setResourcePolicyResource(ResourcePolicy.newBuilder().build())
+   *           .setUpdateMask("updateMask-296147115")
+   *           .build();
+   *   ApiFuture<Operation> future = resourcePoliciesClient.patchCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<PatchResourcePolicyRequest, Operation> patchCallable() {
+    return stub.patchCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Sets the access control policy on the specified resource. Replaces any existing policy.

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

@@ -123,6 +123,17 @@ public UnaryCallSettings<InsertResourcePolicyRequest, Operation> insertSettings(
     return ((ResourcePoliciesStubSettings) getStubSettings()).listSettings();
   }
 
+  /** Returns the object with the settings used for calls to patch. */
+  public UnaryCallSettings<PatchResourcePolicyRequest, Operation> patchSettings() {
+    return ((ResourcePoliciesStubSettings) getStubSettings()).patchSettings();
+  }
+
+  /** Returns the object with the settings used for calls to patch. */
+  public OperationCallSettings<PatchResourcePolicyRequest, Operation, Operation>
+      patchOperationSettings() {
+    return ((ResourcePoliciesStubSettings) getStubSettings()).patchOperationSettings();
+  }
+
   /** Returns the object with the settings used for calls to setIamPolicy. */
   public UnaryCallSettings<SetIamPolicyResourcePolicyRequest, Policy> setIamPolicySettings() {
     return ((ResourcePoliciesStubSettings) getStubSettings()).setIamPolicySettings();
@@ -281,6 +292,17 @@ public UnaryCallSettings.Builder<InsertResourcePolicyRequest, Operation> insertS
       return getStubSettingsBuilder().listSettings();
     }
 
+    /** Returns the builder for the settings used for calls to patch. */
+    public UnaryCallSettings.Builder<PatchResourcePolicyRequest, Operation> patchSettings() {
+      return getStubSettingsBuilder().patchSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to patch. */
+    public OperationCallSettings.Builder<PatchResourcePolicyRequest, Operation, Operation>
+        patchOperationSettings() {
+      return getStubSettingsBuilder().patchOperationSettings();
+    }
+
     /** Returns the builder for the settings used for calls to setIamPolicy. */
     public UnaryCallSettings.Builder<SetIamPolicyResourcePolicyRequest, Policy>
         setIamPolicySettings() {

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

@@ -1136,7 +1136,7 @@ public final UnaryCallable<ListSecurityPoliciesRequest, SecurityPolicyList> list
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -1176,7 +1176,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -1213,7 +1213,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -1248,7 +1248,7 @@ public final OperationFuture<Operation, Operation> patchAsync(
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Patches the specified policy with the data included in the request. To clear fields in the
-   * rule, leave the fields empty and specify them in the updateMask. This cannot be used to be
+   * policy, leave the fields empty and specify them in the updateMask. This cannot be used to be
    * update the rules in the policy. Please use the per rule methods like addRule, patchRule, and
    * removeRule instead.
    *
@@ -1280,7 +1280,8 @@ public final UnaryCallable<PatchSecurityPolicyRequest, Operation> patchCallable(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Patches a rule at the specified priority.
+   * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty
+   * and specify them in the updateMask.
    *
    * <p>Sample code:
    *
@@ -1319,7 +1320,8 @@ public final OperationFuture<Operation, Operation> patchRuleAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Patches a rule at the specified priority.
+   * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty
+   * and specify them in the updateMask.
    *
    * <p>Sample code:
    *
@@ -1354,7 +1356,8 @@ public final OperationFuture<Operation, Operation> patchRuleAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Patches a rule at the specified priority.
+   * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty
+   * and specify them in the updateMask.
    *
    * <p>Sample code:
    *
@@ -1387,7 +1390,8 @@ public final OperationFuture<Operation, Operation> patchRuleAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Patches a rule at the specified priority.
+   * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty
+   * and specify them in the updateMask.
    *
    * <p>Sample code:
    *

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

@@ -2239,6 +2239,9 @@
             "List": {
               "methods": ["list", "list", "listPagedCallable", "listCallable"]
             },
+            "Patch": {
+              "methods": ["patchAsync", "patchAsync", "patchOperationCallable", "patchCallable"]
+            },
             "SetIamPolicy": {
               "methods": ["setIamPolicy", "setIamPolicy", "setIamPolicyCallable"]
             },