feat(v1beta2): added ApplySoftwareUpdate API (#302)

This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/a01a320a-2662-4e30-b5a2-0411c0536c65/targets

- [ ] To automatically regenerate this PR, check this box.

PiperOrigin-RevId: 356380191
Source-Link: googleapis/googleapis@84cf54e

docs: various clarifications, new documentation for ApplySoftwareUpdate
chore: update proto annotations

google-cloud-memcache/src/main/java/com/google/cloud/memcache/v1beta2/CloudMemcacheSettings.java

@@ -138,6 +138,17 @@ public UnaryCallSettings<ApplyParametersRequest, Operation> applyParametersSetti
     return ((CloudMemcacheStubSettings) getStubSettings()).applyParametersOperationSettings();
   }
 
+  /** Returns the object with the settings used for calls to applySoftwareUpdate. */
+  public UnaryCallSettings<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateSettings() {
+    return ((CloudMemcacheStubSettings) getStubSettings()).applySoftwareUpdateSettings();
+  }
+
+  /** Returns the object with the settings used for calls to applySoftwareUpdate. */
+  public OperationCallSettings<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationSettings() {
+    return ((CloudMemcacheStubSettings) getStubSettings()).applySoftwareUpdateOperationSettings();
+  }
+
   public static final CloudMemcacheSettings create(CloudMemcacheStubSettings stub)
       throws IOException {
     return new CloudMemcacheSettings.Builder(stub.toBuilder()).build();
@@ -304,6 +315,18 @@ public UnaryCallSettings.Builder<ApplyParametersRequest, Operation> applyParamet
       return getStubSettingsBuilder().applyParametersOperationSettings();
     }
 
+    /** Returns the builder for the settings used for calls to applySoftwareUpdate. */
+    public UnaryCallSettings.Builder<ApplySoftwareUpdateRequest, Operation>
+        applySoftwareUpdateSettings() {
+      return getStubSettingsBuilder().applySoftwareUpdateSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to applySoftwareUpdate. */
+    public OperationCallSettings.Builder<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+        applySoftwareUpdateOperationSettings() {
+      return getStubSettingsBuilder().applySoftwareUpdateOperationSettings();
+    }
+
     @Override
     public CloudMemcacheSettings build() throws IOException {
       return new CloudMemcacheSettings(this);

google-cloud-memcache/src/main/java/com/google/cloud/memcache/v1beta2/package-info.java

@@ -33,7 +33,7 @@
  *       `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
  * </ul>
  *
- * <p>Note that location_id must be refering to a GCP `region`; for example:
+ * <p>Note that location_id must be a GCP `region`; for example:
  *
  * <ul>
  *   <li>`projects/my-memcached-project/locations/us-central1/instances/my-memcached`

google-cloud-memcache/src/main/java/com/google/cloud/memcache/v1beta2/stub/CloudMemcacheStub.java

@@ -23,6 +23,7 @@
 import com.google.api.gax.rpc.OperationCallable;
 import com.google.api.gax.rpc.UnaryCallable;
 import com.google.cloud.memcache.v1beta2.ApplyParametersRequest;
+import com.google.cloud.memcache.v1beta2.ApplySoftwareUpdateRequest;
 import com.google.cloud.memcache.v1beta2.CreateInstanceRequest;
 import com.google.cloud.memcache.v1beta2.DeleteInstanceRequest;
 import com.google.cloud.memcache.v1beta2.GetInstanceRequest;
@@ -109,6 +110,16 @@ public UnaryCallable<ApplyParametersRequest, Operation> applyParametersCallable(
     throw new UnsupportedOperationException("Not implemented: applyParametersCallable()");
   }
 
+  public OperationCallable<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: applySoftwareUpdateOperationCallable()");
+  }
+
+  public UnaryCallable<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateCallable() {
+    throw new UnsupportedOperationException("Not implemented: applySoftwareUpdateCallable()");
+  }
+
   @Override
   public abstract void close();
 }

google-cloud-memcache/src/main/java/com/google/cloud/memcache/v1beta2/stub/CloudMemcacheStubSettings.java

@@ -45,6 +45,7 @@
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.api.gax.rpc.UnaryCallable;
 import com.google.cloud.memcache.v1beta2.ApplyParametersRequest;
+import com.google.cloud.memcache.v1beta2.ApplySoftwareUpdateRequest;
 import com.google.cloud.memcache.v1beta2.CreateInstanceRequest;
 import com.google.cloud.memcache.v1beta2.DeleteInstanceRequest;
 import com.google.cloud.memcache.v1beta2.GetInstanceRequest;
@@ -123,6 +124,10 @@ public class CloudMemcacheStubSettings extends StubSettings<CloudMemcacheStubSet
   private final UnaryCallSettings<ApplyParametersRequest, Operation> applyParametersSettings;
   private final OperationCallSettings<ApplyParametersRequest, Instance, OperationMetadata>
       applyParametersOperationSettings;
+  private final UnaryCallSettings<ApplySoftwareUpdateRequest, Operation>
+      applySoftwareUpdateSettings;
+  private final OperationCallSettings<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationSettings;
 
   private static final PagedListDescriptor<ListInstancesRequest, ListInstancesResponse, Instance>
       LIST_INSTANCES_PAGE_STR_DESC =
@@ -243,6 +248,17 @@ public UnaryCallSettings<ApplyParametersRequest, Operation> applyParametersSetti
     return applyParametersOperationSettings;
   }
 
+  /** Returns the object with the settings used for calls to applySoftwareUpdate. */
+  public UnaryCallSettings<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateSettings() {
+    return applySoftwareUpdateSettings;
+  }
+
+  /** Returns the object with the settings used for calls to applySoftwareUpdate. */
+  public OperationCallSettings<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationSettings() {
+    return applySoftwareUpdateOperationSettings;
+  }
+
   @BetaApi("A restructuring of stub classes is planned, so this may break in the future")
   public CloudMemcacheStub createStub() throws IOException {
     if (getTransportChannelProvider()
@@ -324,6 +340,9 @@ protected CloudMemcacheStubSettings(Builder settingsBuilder) throws IOException
     deleteInstanceOperationSettings = settingsBuilder.deleteInstanceOperationSettings().build();
     applyParametersSettings = settingsBuilder.applyParametersSettings().build();
     applyParametersOperationSettings = settingsBuilder.applyParametersOperationSettings().build();
+    applySoftwareUpdateSettings = settingsBuilder.applySoftwareUpdateSettings().build();
+    applySoftwareUpdateOperationSettings =
+        settingsBuilder.applySoftwareUpdateOperationSettings().build();
   }
 
   /** Builder for CloudMemcacheStubSettings. */
@@ -354,6 +373,11 @@ public static class Builder extends StubSettings.Builder<CloudMemcacheStubSettin
         applyParametersSettings;
     private final OperationCallSettings.Builder<ApplyParametersRequest, Instance, OperationMetadata>
         applyParametersOperationSettings;
+    private final UnaryCallSettings.Builder<ApplySoftwareUpdateRequest, Operation>
+        applySoftwareUpdateSettings;
+    private final OperationCallSettings.Builder<
+            ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+        applySoftwareUpdateOperationSettings;
     private static final ImmutableMap<String, ImmutableSet<StatusCode.Code>>
         RETRYABLE_CODE_DEFINITIONS;
 
@@ -400,6 +424,8 @@ protected Builder(ClientContext clientContext) {
       deleteInstanceOperationSettings = OperationCallSettings.newBuilder();
       applyParametersSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
       applyParametersOperationSettings = OperationCallSettings.newBuilder();
+      applySoftwareUpdateSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
+      applySoftwareUpdateOperationSettings = OperationCallSettings.newBuilder();
 
       unaryMethodSettingsBuilders =
           ImmutableList.<UnaryCallSettings.Builder<?, ?>>of(
@@ -409,7 +435,8 @@ protected Builder(ClientContext clientContext) {
               updateInstanceSettings,
               updateParametersSettings,
               deleteInstanceSettings,
-              applyParametersSettings);
+              applyParametersSettings,
+              applySoftwareUpdateSettings);
       initDefaults(this);
     }
 
@@ -428,6 +455,9 @@ protected Builder(CloudMemcacheStubSettings settings) {
       deleteInstanceOperationSettings = settings.deleteInstanceOperationSettings.toBuilder();
       applyParametersSettings = settings.applyParametersSettings.toBuilder();
       applyParametersOperationSettings = settings.applyParametersOperationSettings.toBuilder();
+      applySoftwareUpdateSettings = settings.applySoftwareUpdateSettings.toBuilder();
+      applySoftwareUpdateOperationSettings =
+          settings.applySoftwareUpdateOperationSettings.toBuilder();
 
       unaryMethodSettingsBuilders =
           ImmutableList.<UnaryCallSettings.Builder<?, ?>>of(
@@ -437,7 +467,8 @@ protected Builder(CloudMemcacheStubSettings settings) {
               updateInstanceSettings,
               updateParametersSettings,
               deleteInstanceSettings,
-              applyParametersSettings);
+              applyParametersSettings,
+              applySoftwareUpdateSettings);
     }
 
     private static Builder createDefault() {
@@ -487,6 +518,11 @@ private static Builder initDefaults(Builder builder) {
           .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_0_codes"))
           .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_0_params"));
 
+      builder
+          .applySoftwareUpdateSettings()
+          .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_0_codes"))
+          .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_0_params"));
+
       builder
           .createInstanceOperationSettings()
           .setInitialCallSettings(
@@ -607,6 +643,30 @@ private static Builder initDefaults(Builder builder) {
                       .setTotalTimeout(Duration.ofMillis(300000L))
                       .build()));
 
+      builder
+          .applySoftwareUpdateOperationSettings()
+          .setInitialCallSettings(
+              UnaryCallSettings
+                  .<ApplySoftwareUpdateRequest, OperationSnapshot>newUnaryCallSettingsBuilder()
+                  .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("no_retry_0_codes"))
+                  .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("no_retry_0_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()));
+
       return builder;
     }
 
@@ -704,6 +764,20 @@ public UnaryCallSettings.Builder<ApplyParametersRequest, Operation> applyParamet
       return applyParametersOperationSettings;
     }
 
+    /** Returns the builder for the settings used for calls to applySoftwareUpdate. */
+    public UnaryCallSettings.Builder<ApplySoftwareUpdateRequest, Operation>
+        applySoftwareUpdateSettings() {
+      return applySoftwareUpdateSettings;
+    }
+
+    /** Returns the builder for the settings used for calls to applySoftwareUpdate. */
+    @BetaApi(
+        "The surface for use by generated code is not stable yet and may change in the future.")
+    public OperationCallSettings.Builder<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+        applySoftwareUpdateOperationSettings() {
+      return applySoftwareUpdateOperationSettings;
+    }
+
     @Override
     public CloudMemcacheStubSettings build() throws IOException {
       return new CloudMemcacheStubSettings(this);

google-cloud-memcache/src/main/java/com/google/cloud/memcache/v1beta2/stub/GrpcCloudMemcacheStub.java

@@ -28,6 +28,7 @@
 import com.google.api.gax.rpc.RequestParamsExtractor;
 import com.google.api.gax.rpc.UnaryCallable;
 import com.google.cloud.memcache.v1beta2.ApplyParametersRequest;
+import com.google.cloud.memcache.v1beta2.ApplySoftwareUpdateRequest;
 import com.google.cloud.memcache.v1beta2.CreateInstanceRequest;
 import com.google.cloud.memcache.v1beta2.DeleteInstanceRequest;
 import com.google.cloud.memcache.v1beta2.GetInstanceRequest;
@@ -126,6 +127,16 @@ public class GrpcCloudMemcacheStub extends CloudMemcacheStub {
               .setResponseMarshaller(ProtoUtils.marshaller(Operation.getDefaultInstance()))
               .build();
 
+  private static final MethodDescriptor<ApplySoftwareUpdateRequest, Operation>
+      applySoftwareUpdateMethodDescriptor =
+          MethodDescriptor.<ApplySoftwareUpdateRequest, Operation>newBuilder()
+              .setType(MethodDescriptor.MethodType.UNARY)
+              .setFullMethodName("google.cloud.memcache.v1beta2.CloudMemcache/ApplySoftwareUpdate")
+              .setRequestMarshaller(
+                  ProtoUtils.marshaller(ApplySoftwareUpdateRequest.getDefaultInstance()))
+              .setResponseMarshaller(ProtoUtils.marshaller(Operation.getDefaultInstance()))
+              .build();
+
   private final UnaryCallable<ListInstancesRequest, ListInstancesResponse> listInstancesCallable;
   private final UnaryCallable<ListInstancesRequest, ListInstancesPagedResponse>
       listInstancesPagedCallable;
@@ -145,6 +156,9 @@ public class GrpcCloudMemcacheStub extends CloudMemcacheStub {
   private final UnaryCallable<ApplyParametersRequest, Operation> applyParametersCallable;
   private final OperationCallable<ApplyParametersRequest, Instance, OperationMetadata>
       applyParametersOperationCallable;
+  private final UnaryCallable<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateCallable;
+  private final OperationCallable<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationCallable;
 
   private final BackgroundResource backgroundResources;
   private final GrpcOperationsStub operationsStub;
@@ -279,6 +293,19 @@ public Map<String, String> extract(ApplyParametersRequest request) {
                   }
                 })
             .build();
+    GrpcCallSettings<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateTransportSettings =
+        GrpcCallSettings.<ApplySoftwareUpdateRequest, Operation>newBuilder()
+            .setMethodDescriptor(applySoftwareUpdateMethodDescriptor)
+            .setParamsExtractor(
+                new RequestParamsExtractor<ApplySoftwareUpdateRequest>() {
+                  @Override
+                  public Map<String, String> extract(ApplySoftwareUpdateRequest request) {
+                    ImmutableMap.Builder<String, String> params = ImmutableMap.builder();
+                    params.put("instance", String.valueOf(request.getInstance()));
+                    return params.build();
+                  }
+                })
+            .build();
 
     this.listInstancesCallable =
         callableFactory.createUnaryCallable(
@@ -334,6 +361,17 @@ public Map<String, String> extract(ApplyParametersRequest request) {
             settings.applyParametersOperationSettings(),
             clientContext,
             operationsStub);
+    this.applySoftwareUpdateCallable =
+        callableFactory.createUnaryCallable(
+            applySoftwareUpdateTransportSettings,
+            settings.applySoftwareUpdateSettings(),
+            clientContext);
+    this.applySoftwareUpdateOperationCallable =
+        callableFactory.createOperationCallable(
+            applySoftwareUpdateTransportSettings,
+            settings.applySoftwareUpdateOperationSettings(),
+            clientContext,
+            operationsStub);
 
     this.backgroundResources =
         new BackgroundResourceAggregation(clientContext.getBackgroundResources());
@@ -401,6 +439,15 @@ public UnaryCallable<ApplyParametersRequest, Operation> applyParametersCallable(
     return applyParametersOperationCallable;
   }
 
+  public UnaryCallable<ApplySoftwareUpdateRequest, Operation> applySoftwareUpdateCallable() {
+    return applySoftwareUpdateCallable;
+  }
+
+  public OperationCallable<ApplySoftwareUpdateRequest, Instance, OperationMetadata>
+      applySoftwareUpdateOperationCallable() {
+    return applySoftwareUpdateOperationCallable;
+  }
+
   @Override
   public final void close() {
     shutdown();