+ updateBackendServiceOperationCallable() {
+ return stub.updateBackendServiceOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1498,7 +1734,7 @@ public final Operation updateBackendService(UpdateBackendServiceHttpRequest requ
* .build();
* ApiFuture<Operation> future = backendServiceClient.updateBackendServiceCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServiceSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServiceSettings.java
index 2c3f31461c39..6bdb5bfa5099 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServiceSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServiceSettings.java
@@ -22,10 +22,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -49,13 +51,13 @@
*
* 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. For
- * example, to set the total timeout of addSignedUrlKeyBackendService to 30 seconds:
+ * example, to set the total timeout of getBackendService to 30 seconds:
*
*
*
* BackendServiceSettings.Builder backendServiceSettingsBuilder =
* BackendServiceSettings.newBuilder();
- * backendServiceSettingsBuilder.addSignedUrlKeyBackendServiceSettings().getRetrySettings().toBuilder()
+ * backendServiceSettingsBuilder.getBackendServiceSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* BackendServiceSettings backendServiceSettings = backendServiceSettingsBuilder.build();
*
@@ -70,6 +72,15 @@ public class BackendServiceSettings extends ClientSettings
+ addSignedUrlKeyBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings())
+ .addSignedUrlKeyBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to aggregatedListBackendServices. */
public PagedCallSettings<
AggregatedListBackendServicesHttpRequest,
@@ -85,6 +96,14 @@ public class BackendServiceSettings extends ClientSettings
+ deleteBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings()).deleteBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to deleteSignedUrlKeyBackendService. */
public UnaryCallSettings
deleteSignedUrlKeyBackendServiceSettings() {
@@ -92,6 +111,15 @@ public class BackendServiceSettings extends ClientSettings
+ deleteSignedUrlKeyBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings())
+ .deleteSignedUrlKeyBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getBackendService. */
public UnaryCallSettings
getBackendServiceSettings() {
@@ -110,6 +138,14 @@ public class BackendServiceSettings extends ClientSettings
+ insertBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings()).insertBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listBackendServices. */
public PagedCallSettings<
ListBackendServicesHttpRequest, BackendServiceList, ListBackendServicesPagedResponse>
@@ -123,6 +159,14 @@ public class BackendServiceSettings extends ClientSettings
+ patchBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings()).patchBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to setSecurityPolicyBackendService. */
public UnaryCallSettings
setSecurityPolicyBackendServiceSettings() {
@@ -130,12 +174,29 @@ public class BackendServiceSettings extends ClientSettings
+ setSecurityPolicyBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings())
+ .setSecurityPolicyBackendServiceOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to updateBackendService. */
public UnaryCallSettings
updateBackendServiceSettings() {
return ((BackendServiceStubSettings) getStubSettings()).updateBackendServiceSettings();
}
+ /** Returns the object with the settings used for calls to updateBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ updateBackendServiceOperationSettings() {
+ return ((BackendServiceStubSettings) getStubSettings()).updateBackendServiceOperationSettings();
+ }
+
public static final BackendServiceSettings create(BackendServiceStubSettings stub)
throws IOException {
return new BackendServiceSettings.Builder(stub.toBuilder()).build();
@@ -244,6 +305,15 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().addSignedUrlKeyBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to addSignedUrlKeyBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ AddSignedUrlKeyBackendServiceHttpRequest, EmptyMessage, Operation>
+ addSignedUrlKeyBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().addSignedUrlKeyBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to aggregatedListBackendServices. */
public PagedCallSettings.Builder<
AggregatedListBackendServicesHttpRequest,
@@ -259,12 +329,29 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to deleteBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().deleteBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to deleteSignedUrlKeyBackendService. */
public UnaryCallSettings.Builder
deleteSignedUrlKeyBackendServiceSettings() {
return getStubSettingsBuilder().deleteSignedUrlKeyBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to deleteSignedUrlKeyBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ DeleteSignedUrlKeyBackendServiceHttpRequest, EmptyMessage, Operation>
+ deleteSignedUrlKeyBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().deleteSignedUrlKeyBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getBackendService. */
public UnaryCallSettings.Builder
getBackendServiceSettings() {
@@ -283,6 +370,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to insertBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().insertBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listBackendServices. */
public PagedCallSettings.Builder<
ListBackendServicesHttpRequest, BackendServiceList, ListBackendServicesPagedResponse>
@@ -296,18 +391,43 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().patchBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to patchBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ patchBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().patchBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to setSecurityPolicyBackendService. */
public UnaryCallSettings.Builder
setSecurityPolicyBackendServiceSettings() {
return getStubSettingsBuilder().setSecurityPolicyBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to setSecurityPolicyBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ SetSecurityPolicyBackendServiceHttpRequest, EmptyMessage, Operation>
+ setSecurityPolicyBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().setSecurityPolicyBackendServiceOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to updateBackendService. */
public UnaryCallSettings.Builder
updateBackendServiceSettings() {
return getStubSettingsBuilder().updateBackendServiceSettings();
}
+ /** Returns the builder for the settings used for calls to updateBackendService. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ updateBackendServiceOperationSettings() {
+ return getStubSettingsBuilder().updateBackendServiceOperationSettings();
+ }
+
@Override
public BackendServiceSettings build() throws IOException {
return new BackendServiceSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskClient.java
index acad92e6aea4..de966bdc2323 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.DiskStub;
@@ -43,9 +46,7 @@
*
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
- * Boolean guestFlush = false;
- * Snapshot snapshotResource = Snapshot.newBuilder().build();
- * Operation response = diskClient.createSnapshotDisk(disk, guestFlush, snapshotResource);
+ * Disk response = diskClient.getDisk(disk);
* }
*
*
@@ -105,6 +106,7 @@
public class DiskClient implements BackgroundResource {
private final DiskSettings settings;
private final DiskStub stub;
+ private final ZoneOperationClient operationsClient;
/** Constructs an instance of DiskClient with default settings. */
public static final DiskClient create() throws IOException {
@@ -135,12 +137,14 @@ public static final DiskClient create(DiskStub stub) {
protected DiskClient(DiskSettings settings) throws IOException {
this.settings = settings;
this.stub = ((DiskStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = ZoneOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected DiskClient(DiskStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = ZoneOperationClient.create(this.stub.getOperationsStub());
}
public final DiskSettings getSettings() {
@@ -152,6 +156,16 @@ public DiskStub getStub() {
return stub;
}
+ /**
+ * Returns the ZoneOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final ZoneOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Retrieves an aggregated list of persistent disks.
@@ -301,7 +315,7 @@ public final AggregatedListDisksPagedResponse aggregatedListDisks(
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
* Boolean guestFlush = false;
* Snapshot snapshotResource = Snapshot.newBuilder().build();
- * Operation response = diskClient.createSnapshotDisk(disk, guestFlush, snapshotResource);
+ * diskClient.createSnapshotDiskAsync(disk, guestFlush, snapshotResource).get();
* }
*
*
@@ -311,8 +325,9 @@ public final AggregatedListDisksPagedResponse aggregatedListDisks(
* ==) (== resource_for v1.snapshots ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation createSnapshotDisk(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture createSnapshotDiskAsync(
ProjectZoneDiskName disk, Boolean guestFlush, Snapshot snapshotResource) {
CreateSnapshotDiskHttpRequest request =
@@ -321,7 +336,7 @@ public final Operation createSnapshotDisk(
.setGuestFlush(guestFlush)
.setSnapshotResource(snapshotResource)
.build();
- return createSnapshotDisk(request);
+ return createSnapshotDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -335,7 +350,7 @@ public final Operation createSnapshotDisk(
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
* Boolean guestFlush = false;
* Snapshot snapshotResource = Snapshot.newBuilder().build();
- * Operation response = diskClient.createSnapshotDisk(disk.toString(), guestFlush, snapshotResource);
+ * diskClient.createSnapshotDiskAsync(disk.toString(), guestFlush, snapshotResource).get();
* }
*
*
@@ -345,8 +360,9 @@ public final Operation createSnapshotDisk(
* ==) (== resource_for v1.snapshots ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation createSnapshotDisk(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture createSnapshotDiskAsync(
String disk, Boolean guestFlush, Snapshot snapshotResource) {
CreateSnapshotDiskHttpRequest request =
@@ -355,7 +371,7 @@ public final Operation createSnapshotDisk(
.setGuestFlush(guestFlush)
.setSnapshotResource(snapshotResource)
.build();
- return createSnapshotDisk(request);
+ return createSnapshotDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -374,16 +390,46 @@ public final Operation createSnapshotDisk(
* .setGuestFlush(guestFlush)
* .setSnapshotResource(snapshotResource)
* .build();
- * Operation response = diskClient.createSnapshotDisk(request);
+ * diskClient.createSnapshotDiskAsync(request).get();
* }
*
*
* @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
- public final Operation createSnapshotDisk(CreateSnapshotDiskHttpRequest request) {
- return createSnapshotDiskCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture createSnapshotDiskAsync(
+ CreateSnapshotDiskHttpRequest request) {
+ return createSnapshotDiskOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a snapshot of a specified persistent disk.
+ *
+ * Sample code:
+ *
+ *
+ * try (DiskClient diskClient = DiskClient.create()) {
+ * ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
+ * Boolean guestFlush = false;
+ * Snapshot snapshotResource = Snapshot.newBuilder().build();
+ * CreateSnapshotDiskHttpRequest request = CreateSnapshotDiskHttpRequest.newBuilder()
+ * .setDisk(disk.toString())
+ * .setGuestFlush(guestFlush)
+ * .setSnapshotResource(snapshotResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = diskClient.createSnapshotDiskOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ createSnapshotDiskOperationCallable() {
+ return stub.createSnapshotDiskOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -404,7 +450,7 @@ public final Operation createSnapshotDisk(CreateSnapshotDiskHttpRequest request)
* .build();
* ApiFuture<Operation> future = diskClient.createSnapshotDiskCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -425,19 +471,20 @@ public final Operation createSnapshotDisk(CreateSnapshotDiskHttpRequest request)
*
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
- * Operation response = diskClient.deleteDisk(disk);
+ * diskClient.deleteDiskAsync(disk).get();
* }
*
*
* @param disk Name of the persistent disk to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteDisk(ProjectZoneDiskName disk) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteDiskAsync(ProjectZoneDiskName disk) {
DeleteDiskHttpRequest request =
DeleteDiskHttpRequest.newBuilder().setDisk(disk == null ? null : disk.toString()).build();
- return deleteDisk(request);
+ return deleteDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -451,18 +498,19 @@ public final Operation deleteDisk(ProjectZoneDiskName disk) {
*
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
- * Operation response = diskClient.deleteDisk(disk.toString());
+ * diskClient.deleteDiskAsync(disk.toString()).get();
* }
*
*
* @param disk Name of the persistent disk to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteDisk(String disk) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteDiskAsync(String disk) {
DeleteDiskHttpRequest request = DeleteDiskHttpRequest.newBuilder().setDisk(disk).build();
- return deleteDisk(request);
+ return deleteDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -479,16 +527,44 @@ public final Operation deleteDisk(String disk) {
* DeleteDiskHttpRequest request = DeleteDiskHttpRequest.newBuilder()
* .setDisk(disk.toString())
* .build();
- * Operation response = diskClient.deleteDisk(request);
+ * diskClient.deleteDiskAsync(request).get();
* }
*
*
* @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
- public final Operation deleteDisk(DeleteDiskHttpRequest request) {
- return deleteDiskCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteDiskAsync(
+ DeleteDiskHttpRequest request) {
+ return deleteDiskOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified persistent disk. Deleting a disk removes its data permanently and is
+ * irreversible. However, deleting a disk does not delete any snapshots previously made from the
+ * disk. You must separately delete snapshots.
+ *
+ * Sample code:
+ *
+ *
+ * try (DiskClient diskClient = DiskClient.create()) {
+ * ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
+ * DeleteDiskHttpRequest request = DeleteDiskHttpRequest.newBuilder()
+ * .setDisk(disk.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = diskClient.deleteDiskOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteDiskOperationCallable() {
+ return stub.deleteDiskOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -507,7 +583,7 @@ public final Operation deleteDisk(DeleteDiskHttpRequest request) {
* .build();
* ApiFuture<Operation> future = diskClient.deleteDiskCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -728,7 +804,7 @@ public final UnaryCallable getIamPolicyDisk
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
* Disk diskResource = Disk.newBuilder().build();
- * Operation response = diskClient.insertDisk(zone, diskResource);
+ * diskClient.insertDiskAsync(zone, diskResource).get();
* }
*
*
@@ -737,15 +813,17 @@ public final UnaryCallable getIamPolicyDisk
* ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertDisk(ProjectZoneName zone, Disk diskResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertDiskAsync(
+ ProjectZoneName zone, Disk diskResource) {
InsertDiskHttpRequest request =
InsertDiskHttpRequest.newBuilder()
.setZone(zone == null ? null : zone.toString())
.setDiskResource(diskResource)
.build();
- return insertDisk(request);
+ return insertDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -761,7 +839,7 @@ public final Operation insertDisk(ProjectZoneName zone, Disk diskResource) {
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
* Disk diskResource = Disk.newBuilder().build();
- * Operation response = diskClient.insertDisk(zone.toString(), diskResource);
+ * diskClient.insertDiskAsync(zone.toString(), diskResource).get();
* }
*
*
@@ -770,12 +848,14 @@ public final Operation insertDisk(ProjectZoneName zone, Disk diskResource) {
* ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertDisk(String zone, Disk diskResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertDiskAsync(
+ String zone, Disk diskResource) {
InsertDiskHttpRequest request =
InsertDiskHttpRequest.newBuilder().setZone(zone).setDiskResource(diskResource).build();
- return insertDisk(request);
+ return insertDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -795,16 +875,47 @@ public final Operation insertDisk(String zone, Disk diskResource) {
* .setZone(zone.toString())
* .setDiskResource(diskResource)
* .build();
- * Operation response = diskClient.insertDisk(request);
+ * diskClient.insertDiskAsync(request).get();
* }
*
*
* @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
- public final Operation insertDisk(InsertDiskHttpRequest request) {
- return insertDiskCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertDiskAsync(
+ InsertDiskHttpRequest request) {
+ return insertDiskOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a persistent disk in the specified project using the data in the request. You can
+ * create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by
+ * omitting all properties. You can also create a disk that is larger than the default size by
+ * specifying the sizeGb property.
+ *
+ * Sample code:
+ *
+ *
+ * try (DiskClient diskClient = DiskClient.create()) {
+ * ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
+ * Disk diskResource = Disk.newBuilder().build();
+ * InsertDiskHttpRequest request = InsertDiskHttpRequest.newBuilder()
+ * .setZone(zone.toString())
+ * .setDiskResource(diskResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = diskClient.insertDiskOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertDiskOperationCallable() {
+ return stub.insertDiskOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -826,7 +937,7 @@ public final Operation insertDisk(InsertDiskHttpRequest request) {
* .build();
* ApiFuture<Operation> future = diskClient.insertDiskCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -978,7 +1089,7 @@ public final UnaryCallable listDisksCallable() {
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
* DisksResizeRequest disksResizeRequestResource = DisksResizeRequest.newBuilder().build();
- * Operation response = diskClient.resizeDisk(disk, disksResizeRequestResource);
+ * diskClient.resizeDiskAsync(disk, disksResizeRequestResource).get();
* }
*
*
@@ -986,8 +1097,9 @@ public final UnaryCallable listDisksCallable() {
* @param disksResizeRequestResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation resizeDisk(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture resizeDiskAsync(
ProjectZoneDiskName disk, DisksResizeRequest disksResizeRequestResource) {
ResizeDiskHttpRequest request =
@@ -995,7 +1107,7 @@ public final Operation resizeDisk(
.setDisk(disk == null ? null : disk.toString())
.setDisksResizeRequestResource(disksResizeRequestResource)
.build();
- return resizeDisk(request);
+ return resizeDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1008,7 +1120,7 @@ public final Operation resizeDisk(
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
* DisksResizeRequest disksResizeRequestResource = DisksResizeRequest.newBuilder().build();
- * Operation response = diskClient.resizeDisk(disk.toString(), disksResizeRequestResource);
+ * diskClient.resizeDiskAsync(disk.toString(), disksResizeRequestResource).get();
* }
*
*
@@ -1016,15 +1128,17 @@ public final Operation resizeDisk(
* @param disksResizeRequestResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation resizeDisk(String disk, DisksResizeRequest disksResizeRequestResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture resizeDiskAsync(
+ String disk, DisksResizeRequest disksResizeRequestResource) {
ResizeDiskHttpRequest request =
ResizeDiskHttpRequest.newBuilder()
.setDisk(disk)
.setDisksResizeRequestResource(disksResizeRequestResource)
.build();
- return resizeDisk(request);
+ return resizeDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1041,16 +1155,44 @@ public final Operation resizeDisk(String disk, DisksResizeRequest disksResizeReq
* .setDisk(disk.toString())
* .setDisksResizeRequestResource(disksResizeRequestResource)
* .build();
- * Operation response = diskClient.resizeDisk(request);
+ * diskClient.resizeDiskAsync(request).get();
* }
*
*
* @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
- public final Operation resizeDisk(ResizeDiskHttpRequest request) {
- return resizeDiskCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture resizeDiskAsync(
+ ResizeDiskHttpRequest request) {
+ return resizeDiskOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Resizes the specified persistent disk. You can only increase the size of the disk.
+ *
+ * Sample code:
+ *
+ *
+ * try (DiskClient diskClient = DiskClient.create()) {
+ * ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
+ * DisksResizeRequest disksResizeRequestResource = DisksResizeRequest.newBuilder().build();
+ * ResizeDiskHttpRequest request = ResizeDiskHttpRequest.newBuilder()
+ * .setDisk(disk.toString())
+ * .setDisksResizeRequestResource(disksResizeRequestResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = diskClient.resizeDiskOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ resizeDiskOperationCallable() {
+ return stub.resizeDiskOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1069,7 +1211,7 @@ public final Operation resizeDisk(ResizeDiskHttpRequest request) {
* .build();
* ApiFuture<Operation> future = diskClient.resizeDiskCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -1200,7 +1342,7 @@ public final UnaryCallable setIamPolicyDisk
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskResourceName resource = ProjectZoneDiskResourceName.of("[PROJECT]", "[ZONE]", "[RESOURCE]");
* ZoneSetLabelsRequest zoneSetLabelsRequestResource = ZoneSetLabelsRequest.newBuilder().build();
- * Operation response = diskClient.setLabelsDisk(resource, zoneSetLabelsRequestResource);
+ * diskClient.setLabelsDiskAsync(resource, zoneSetLabelsRequestResource).get();
* }
*
*
@@ -1208,8 +1350,9 @@ public final UnaryCallable setIamPolicyDisk
* @param zoneSetLabelsRequestResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setLabelsDisk(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setLabelsDiskAsync(
ProjectZoneDiskResourceName resource, ZoneSetLabelsRequest zoneSetLabelsRequestResource) {
SetLabelsDiskHttpRequest request =
@@ -1217,7 +1360,7 @@ public final Operation setLabelsDisk(
.setResource(resource == null ? null : resource.toString())
.setZoneSetLabelsRequestResource(zoneSetLabelsRequestResource)
.build();
- return setLabelsDisk(request);
+ return setLabelsDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1231,7 +1374,7 @@ public final Operation setLabelsDisk(
* try (DiskClient diskClient = DiskClient.create()) {
* ProjectZoneDiskResourceName resource = ProjectZoneDiskResourceName.of("[PROJECT]", "[ZONE]", "[RESOURCE]");
* ZoneSetLabelsRequest zoneSetLabelsRequestResource = ZoneSetLabelsRequest.newBuilder().build();
- * Operation response = diskClient.setLabelsDisk(resource.toString(), zoneSetLabelsRequestResource);
+ * diskClient.setLabelsDiskAsync(resource.toString(), zoneSetLabelsRequestResource).get();
* }
*
*
@@ -1239,8 +1382,9 @@ public final Operation setLabelsDisk(
* @param zoneSetLabelsRequestResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setLabelsDisk(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setLabelsDiskAsync(
String resource, ZoneSetLabelsRequest zoneSetLabelsRequestResource) {
SetLabelsDiskHttpRequest request =
@@ -1248,7 +1392,7 @@ public final Operation setLabelsDisk(
.setResource(resource)
.setZoneSetLabelsRequestResource(zoneSetLabelsRequestResource)
.build();
- return setLabelsDisk(request);
+ return setLabelsDiskAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1266,16 +1410,45 @@ public final Operation setLabelsDisk(
* .setResource(resource.toString())
* .setZoneSetLabelsRequestResource(zoneSetLabelsRequestResource)
* .build();
- * Operation response = diskClient.setLabelsDisk(request);
+ * diskClient.setLabelsDiskAsync(request).get();
* }
*
*
* @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
- public final Operation setLabelsDisk(SetLabelsDiskHttpRequest request) {
- return setLabelsDiskCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setLabelsDiskAsync(
+ SetLabelsDiskHttpRequest request) {
+ return setLabelsDiskOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Sets the labels on a disk. To learn more about labels, read the Labeling Resources
+ * documentation.
+ *
+ * Sample code:
+ *
+ *
+ * try (DiskClient diskClient = DiskClient.create()) {
+ * ProjectZoneDiskResourceName resource = ProjectZoneDiskResourceName.of("[PROJECT]", "[ZONE]", "[RESOURCE]");
+ * ZoneSetLabelsRequest zoneSetLabelsRequestResource = ZoneSetLabelsRequest.newBuilder().build();
+ * SetLabelsDiskHttpRequest request = SetLabelsDiskHttpRequest.newBuilder()
+ * .setResource(resource.toString())
+ * .setZoneSetLabelsRequestResource(zoneSetLabelsRequestResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = diskClient.setLabelsDiskOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ setLabelsDiskOperationCallable() {
+ return stub.setLabelsDiskOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -1295,7 +1468,7 @@ public final Operation setLabelsDisk(SetLabelsDiskHttpRequest request) {
* .build();
* ApiFuture<Operation> future = diskClient.setLabelsDiskCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskSettings.java
index d379ae074f9c..1199f58f497c 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskSettings.java
@@ -22,10 +22,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -49,13 +51,13 @@
*
* 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. For
- * example, to set the total timeout of createSnapshotDisk to 30 seconds:
+ * example, to set the total timeout of getDisk to 30 seconds:
*
*
*
* DiskSettings.Builder diskSettingsBuilder =
* DiskSettings.newBuilder();
- * diskSettingsBuilder.createSnapshotDiskSettings().getRetrySettings().toBuilder()
+ * diskSettingsBuilder.getDiskSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* DiskSettings diskSettings = diskSettingsBuilder.build();
*
@@ -76,11 +78,27 @@ public UnaryCallSettings createSnapsho
return ((DiskStubSettings) getStubSettings()).createSnapshotDiskSettings();
}
+ /** Returns the object with the settings used for calls to createSnapshotDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ createSnapshotDiskOperationSettings() {
+ return ((DiskStubSettings) getStubSettings()).createSnapshotDiskOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to deleteDisk. */
public UnaryCallSettings deleteDiskSettings() {
return ((DiskStubSettings) getStubSettings()).deleteDiskSettings();
}
+ /** Returns the object with the settings used for calls to deleteDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ deleteDiskOperationSettings() {
+ return ((DiskStubSettings) getStubSettings()).deleteDiskOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getDisk. */
public UnaryCallSettings getDiskSettings() {
return ((DiskStubSettings) getStubSettings()).getDiskSettings();
@@ -96,6 +114,14 @@ public UnaryCallSettings insertDiskSettings()
return ((DiskStubSettings) getStubSettings()).insertDiskSettings();
}
+ /** Returns the object with the settings used for calls to insertDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ insertDiskOperationSettings() {
+ return ((DiskStubSettings) getStubSettings()).insertDiskOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listDisks. */
public PagedCallSettings
listDisksSettings() {
@@ -107,6 +133,14 @@ public UnaryCallSettings resizeDiskSettings()
return ((DiskStubSettings) getStubSettings()).resizeDiskSettings();
}
+ /** Returns the object with the settings used for calls to resizeDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ resizeDiskOperationSettings() {
+ return ((DiskStubSettings) getStubSettings()).resizeDiskOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to setIamPolicyDisk. */
public UnaryCallSettings setIamPolicyDiskSettings() {
return ((DiskStubSettings) getStubSettings()).setIamPolicyDiskSettings();
@@ -117,6 +151,14 @@ public UnaryCallSettings setLabelsDiskSetti
return ((DiskStubSettings) getStubSettings()).setLabelsDiskSettings();
}
+ /** Returns the object with the settings used for calls to setLabelsDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ setLabelsDiskOperationSettings() {
+ return ((DiskStubSettings) getStubSettings()).setLabelsDiskOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to testIamPermissionsDisk. */
public UnaryCallSettings
testIamPermissionsDiskSettings() {
@@ -237,11 +279,27 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().createSnapshotDiskSettings();
}
+ /** Returns the builder for the settings used for calls to createSnapshotDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ createSnapshotDiskOperationSettings() {
+ return getStubSettingsBuilder().createSnapshotDiskOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to deleteDisk. */
public UnaryCallSettings.Builder deleteDiskSettings() {
return getStubSettingsBuilder().deleteDiskSettings();
}
+ /** Returns the builder for the settings used for calls to deleteDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteDiskOperationSettings() {
+ return getStubSettingsBuilder().deleteDiskOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getDisk. */
public UnaryCallSettings.Builder getDiskSettings() {
return getStubSettingsBuilder().getDiskSettings();
@@ -258,6 +316,14 @@ public UnaryCallSettings.Builder insertDiskSet
return getStubSettingsBuilder().insertDiskSettings();
}
+ /** Returns the builder for the settings used for calls to insertDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertDiskOperationSettings() {
+ return getStubSettingsBuilder().insertDiskOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listDisks. */
public PagedCallSettings.Builder
listDisksSettings() {
@@ -269,6 +335,14 @@ public UnaryCallSettings.Builder resizeDiskSet
return getStubSettingsBuilder().resizeDiskSettings();
}
+ /** Returns the builder for the settings used for calls to resizeDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ resizeDiskOperationSettings() {
+ return getStubSettingsBuilder().resizeDiskOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to setIamPolicyDisk. */
public UnaryCallSettings.Builder
setIamPolicyDiskSettings() {
@@ -280,6 +354,14 @@ public UnaryCallSettings.Builder setLabelsD
return getStubSettingsBuilder().setLabelsDiskSettings();
}
+ /** Returns the builder for the settings used for calls to setLabelsDisk. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ setLabelsDiskOperationSettings() {
+ return getStubSettingsBuilder().setLabelsDiskOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to testIamPermissionsDisk. */
public UnaryCallSettings.Builder
testIamPermissionsDiskSettings() {
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallClient.java
index 6bc1ca517763..f63c55a87760 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.FirewallStub;
@@ -43,7 +46,7 @@
*
* try (FirewallClient firewallClient = FirewallClient.create()) {
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
- * Operation response = firewallClient.deleteFirewall(firewall);
+ * Firewall response = firewallClient.getFirewall(firewall);
* }
*
*
@@ -103,6 +106,7 @@
public class FirewallClient implements BackgroundResource {
private final FirewallSettings settings;
private final FirewallStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of FirewallClient with default settings. */
public static final FirewallClient create() throws IOException {
@@ -133,12 +137,14 @@ public static final FirewallClient create(FirewallStub stub) {
protected FirewallClient(FirewallSettings settings) throws IOException {
this.settings = settings;
this.stub = ((FirewallStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected FirewallClient(FirewallStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final FirewallSettings getSettings() {
@@ -150,6 +156,16 @@ public FirewallStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified firewall.
@@ -159,21 +175,23 @@ public FirewallStub getStub() {
*
* try (FirewallClient firewallClient = FirewallClient.create()) {
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
- * Operation response = firewallClient.deleteFirewall(firewall);
+ * firewallClient.deleteFirewallAsync(firewall).get();
* }
*
*
* @param firewall Name of the firewall rule to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteFirewall(ProjectGlobalFirewallName firewall) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteFirewallAsync(
+ ProjectGlobalFirewallName firewall) {
DeleteFirewallHttpRequest request =
DeleteFirewallHttpRequest.newBuilder()
.setFirewall(firewall == null ? null : firewall.toString())
.build();
- return deleteFirewall(request);
+ return deleteFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -185,19 +203,20 @@ public final Operation deleteFirewall(ProjectGlobalFirewallName firewall) {
*
* try (FirewallClient firewallClient = FirewallClient.create()) {
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
- * Operation response = firewallClient.deleteFirewall(firewall.toString());
+ * firewallClient.deleteFirewallAsync(firewall.toString()).get();
* }
*
*
* @param firewall Name of the firewall rule to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteFirewall(String firewall) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteFirewallAsync(String firewall) {
DeleteFirewallHttpRequest request =
DeleteFirewallHttpRequest.newBuilder().setFirewall(firewall).build();
- return deleteFirewall(request);
+ return deleteFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -212,16 +231,42 @@ public final Operation deleteFirewall(String firewall) {
* DeleteFirewallHttpRequest request = DeleteFirewallHttpRequest.newBuilder()
* .setFirewall(firewall.toString())
* .build();
- * Operation response = firewallClient.deleteFirewall(request);
+ * firewallClient.deleteFirewallAsync(request).get();
* }
*
*
* @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
- public final Operation deleteFirewall(DeleteFirewallHttpRequest request) {
- return deleteFirewallCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteFirewallAsync(
+ DeleteFirewallHttpRequest request) {
+ return deleteFirewallOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified firewall.
+ *
+ * Sample code:
+ *
+ *
+ * try (FirewallClient firewallClient = FirewallClient.create()) {
+ * ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
+ * DeleteFirewallHttpRequest request = DeleteFirewallHttpRequest.newBuilder()
+ * .setFirewall(firewall.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = firewallClient.deleteFirewallOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteFirewallOperationCallable() {
+ return stub.deleteFirewallOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -238,7 +283,7 @@ public final Operation deleteFirewall(DeleteFirewallHttpRequest request) {
* .build();
* ApiFuture<Operation> future = firewallClient.deleteFirewallCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -354,7 +399,7 @@ public final UnaryCallable getFirewallCallable
* try (FirewallClient firewallClient = FirewallClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* Firewall firewallResource = Firewall.newBuilder().build();
- * Operation response = firewallClient.insertFirewall(project, firewallResource);
+ * firewallClient.insertFirewallAsync(project, firewallResource).get();
* }
*
*
@@ -362,15 +407,17 @@ public final UnaryCallable getFirewallCallable
* @param firewallResource Represents a Firewall resource.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertFirewall(ProjectName project, Firewall firewallResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertFirewallAsync(
+ ProjectName project, Firewall firewallResource) {
InsertFirewallHttpRequest request =
InsertFirewallHttpRequest.newBuilder()
.setProject(project == null ? null : project.toString())
.setFirewallResource(firewallResource)
.build();
- return insertFirewall(request);
+ return insertFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -383,7 +430,7 @@ public final Operation insertFirewall(ProjectName project, Firewall firewallReso
* try (FirewallClient firewallClient = FirewallClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* Firewall firewallResource = Firewall.newBuilder().build();
- * Operation response = firewallClient.insertFirewall(project.toString(), firewallResource);
+ * firewallClient.insertFirewallAsync(project.toString(), firewallResource).get();
* }
*
*
@@ -391,15 +438,17 @@ public final Operation insertFirewall(ProjectName project, Firewall firewallReso
* @param firewallResource Represents a Firewall resource.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertFirewall(String project, Firewall firewallResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertFirewallAsync(
+ String project, Firewall firewallResource) {
InsertFirewallHttpRequest request =
InsertFirewallHttpRequest.newBuilder()
.setProject(project)
.setFirewallResource(firewallResource)
.build();
- return insertFirewall(request);
+ return insertFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -416,16 +465,44 @@ public final Operation insertFirewall(String project, Firewall firewallResource)
* .setProject(project.toString())
* .setFirewallResource(firewallResource)
* .build();
- * Operation response = firewallClient.insertFirewall(request);
+ * firewallClient.insertFirewallAsync(request).get();
* }
*
*
* @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
- public final Operation insertFirewall(InsertFirewallHttpRequest request) {
- return insertFirewallCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertFirewallAsync(
+ InsertFirewallHttpRequest request) {
+ return insertFirewallOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a firewall rule in the specified project using the data included in the request.
+ *
+ * Sample code:
+ *
+ *
+ * try (FirewallClient firewallClient = FirewallClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * Firewall firewallResource = Firewall.newBuilder().build();
+ * InsertFirewallHttpRequest request = InsertFirewallHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setFirewallResource(firewallResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = firewallClient.insertFirewallOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertFirewallOperationCallable() {
+ return stub.insertFirewallOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -444,7 +521,7 @@ public final Operation insertFirewall(InsertFirewallHttpRequest request) {
* .build();
* ApiFuture<Operation> future = firewallClient.insertFirewallCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -601,7 +678,7 @@ public final UnaryCallable listFirewalls
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
* Firewall firewallResource = Firewall.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = firewallClient.patchFirewall(firewall, firewallResource, fieldMask);
+ * firewallClient.patchFirewallAsync(firewall, firewallResource, fieldMask).get();
* }
*
*
@@ -613,8 +690,9 @@ public final UnaryCallable listFirewalls
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchFirewall(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchFirewallAsync(
ProjectGlobalFirewallName firewall, Firewall firewallResource, List fieldMask) {
PatchFirewallHttpRequest request =
@@ -623,7 +701,7 @@ public final Operation patchFirewall(
.setFirewallResource(firewallResource)
.addAllFieldMask(fieldMask)
.build();
- return patchFirewall(request);
+ return patchFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -638,7 +716,7 @@ public final Operation patchFirewall(
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
* Firewall firewallResource = Firewall.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = firewallClient.patchFirewall(firewall.toString(), firewallResource, fieldMask);
+ * firewallClient.patchFirewallAsync(firewall.toString(), firewallResource, fieldMask).get();
* }
*
*
@@ -650,8 +728,9 @@ public final Operation patchFirewall(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchFirewall(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchFirewallAsync(
String firewall, Firewall firewallResource, List fieldMask) {
PatchFirewallHttpRequest request =
@@ -660,7 +739,7 @@ public final Operation patchFirewall(
.setFirewallResource(firewallResource)
.addAllFieldMask(fieldMask)
.build();
- return patchFirewall(request);
+ return patchFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -680,16 +759,47 @@ public final Operation patchFirewall(
* .setFirewallResource(firewallResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = firewallClient.patchFirewall(request);
+ * firewallClient.patchFirewallAsync(request).get();
* }
*
*
* @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
- public final Operation patchFirewall(PatchFirewallHttpRequest request) {
- return patchFirewallCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchFirewallAsync(
+ PatchFirewallHttpRequest request) {
+ return patchFirewallOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates the specified firewall rule with the data included in the request. This method supports
+ * PATCH semantics and uses the JSON merge patch format and processing rules.
+ *
+ * Sample code:
+ *
+ *
+ * try (FirewallClient firewallClient = FirewallClient.create()) {
+ * ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
+ * Firewall firewallResource = Firewall.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * PatchFirewallHttpRequest request = PatchFirewallHttpRequest.newBuilder()
+ * .setFirewall(firewall.toString())
+ * .setFirewallResource(firewallResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = firewallClient.patchFirewallOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ patchFirewallOperationCallable() {
+ return stub.patchFirewallOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -711,7 +821,7 @@ public final Operation patchFirewall(PatchFirewallHttpRequest request) {
* .build();
* ApiFuture<Operation> future = firewallClient.patchFirewallCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -733,7 +843,7 @@ public final UnaryCallable patchFirewallCal
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
* Firewall firewallResource = Firewall.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = firewallClient.updateFirewall(firewall, firewallResource, fieldMask);
+ * firewallClient.updateFirewallAsync(firewall, firewallResource, fieldMask).get();
* }
*
*
@@ -745,8 +855,9 @@ public final UnaryCallable patchFirewallCal
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateFirewall(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateFirewallAsync(
ProjectGlobalFirewallName firewall, Firewall firewallResource, List fieldMask) {
UpdateFirewallHttpRequest request =
@@ -755,7 +866,7 @@ public final Operation updateFirewall(
.setFirewallResource(firewallResource)
.addAllFieldMask(fieldMask)
.build();
- return updateFirewall(request);
+ return updateFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -771,7 +882,7 @@ public final Operation updateFirewall(
* ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
* Firewall firewallResource = Firewall.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = firewallClient.updateFirewall(firewall.toString(), firewallResource, fieldMask);
+ * firewallClient.updateFirewallAsync(firewall.toString(), firewallResource, fieldMask).get();
* }
*
*
@@ -783,8 +894,9 @@ public final Operation updateFirewall(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateFirewall(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateFirewallAsync(
String firewall, Firewall firewallResource, List fieldMask) {
UpdateFirewallHttpRequest request =
@@ -793,7 +905,7 @@ public final Operation updateFirewall(
.setFirewallResource(firewallResource)
.addAllFieldMask(fieldMask)
.build();
- return updateFirewall(request);
+ return updateFirewallAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -814,16 +926,48 @@ public final Operation updateFirewall(
* .setFirewallResource(firewallResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = firewallClient.updateFirewall(request);
+ * firewallClient.updateFirewallAsync(request).get();
* }
*
*
* @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
- public final Operation updateFirewall(UpdateFirewallHttpRequest request) {
- return updateFirewallCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateFirewallAsync(
+ UpdateFirewallHttpRequest request) {
+ return updateFirewallOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates the specified firewall rule with the data included in the request. The PUT method can
+ * only update the following fields of firewall rule: allowed, description, sourceRanges,
+ * sourceTags, targetTags.
+ *
+ * Sample code:
+ *
+ *
+ * try (FirewallClient firewallClient = FirewallClient.create()) {
+ * ProjectGlobalFirewallName firewall = ProjectGlobalFirewallName.of("[PROJECT]", "[FIREWALL]");
+ * Firewall firewallResource = Firewall.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * UpdateFirewallHttpRequest request = UpdateFirewallHttpRequest.newBuilder()
+ * .setFirewall(firewall.toString())
+ * .setFirewallResource(firewallResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = firewallClient.updateFirewallOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ updateFirewallOperationCallable() {
+ return stub.updateFirewallOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -846,7 +990,7 @@ public final Operation updateFirewall(UpdateFirewallHttpRequest request) {
* .build();
* ApiFuture<Operation> future = firewallClient.updateFirewallCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallSettings.java
index b5c7163a9e1b..abb4d5b0fa4f 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteFirewall to 30 seconds:
+ * example, to set the total timeout of getFirewall to 30 seconds:
*
*
*
* FirewallSettings.Builder firewallSettingsBuilder =
* FirewallSettings.newBuilder();
- * firewallSettingsBuilder.deleteFirewallSettings().getRetrySettings().toBuilder()
+ * firewallSettingsBuilder.getFirewallSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* FirewallSettings firewallSettings = firewallSettingsBuilder.build();
*
@@ -68,6 +70,14 @@ public UnaryCallSettings deleteFirewallSet
return ((FirewallStubSettings) getStubSettings()).deleteFirewallSettings();
}
+ /** Returns the object with the settings used for calls to deleteFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ deleteFirewallOperationSettings() {
+ return ((FirewallStubSettings) getStubSettings()).deleteFirewallOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getFirewall. */
public UnaryCallSettings getFirewallSettings() {
return ((FirewallStubSettings) getStubSettings()).getFirewallSettings();
@@ -78,6 +88,14 @@ public UnaryCallSettings insertFirewallSet
return ((FirewallStubSettings) getStubSettings()).insertFirewallSettings();
}
+ /** Returns the object with the settings used for calls to insertFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ insertFirewallOperationSettings() {
+ return ((FirewallStubSettings) getStubSettings()).insertFirewallOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listFirewalls. */
public PagedCallSettings
listFirewallsSettings() {
@@ -89,11 +107,27 @@ public UnaryCallSettings patchFirewallSetti
return ((FirewallStubSettings) getStubSettings()).patchFirewallSettings();
}
+ /** Returns the object with the settings used for calls to patchFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ patchFirewallOperationSettings() {
+ return ((FirewallStubSettings) getStubSettings()).patchFirewallOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to updateFirewall. */
public UnaryCallSettings updateFirewallSettings() {
return ((FirewallStubSettings) getStubSettings()).updateFirewallSettings();
}
+ /** Returns the object with the settings used for calls to updateFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ updateFirewallOperationSettings() {
+ return ((FirewallStubSettings) getStubSettings()).updateFirewallOperationSettings();
+ }
+
public static final FirewallSettings create(FirewallStubSettings stub) throws IOException {
return new FirewallSettings.Builder(stub.toBuilder()).build();
}
@@ -201,6 +235,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteFirewallSettings();
}
+ /** Returns the builder for the settings used for calls to deleteFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteFirewallOperationSettings() {
+ return getStubSettingsBuilder().deleteFirewallOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getFirewall. */
public UnaryCallSettings.Builder getFirewallSettings() {
return getStubSettingsBuilder().getFirewallSettings();
@@ -212,6 +254,14 @@ public UnaryCallSettings.Builder getFirewallSe
return getStubSettingsBuilder().insertFirewallSettings();
}
+ /** Returns the builder for the settings used for calls to insertFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertFirewallOperationSettings() {
+ return getStubSettingsBuilder().insertFirewallOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listFirewalls. */
public PagedCallSettings.Builder<
ListFirewallsHttpRequest, FirewallList, ListFirewallsPagedResponse>
@@ -224,12 +274,28 @@ public UnaryCallSettings.Builder patchFirew
return getStubSettingsBuilder().patchFirewallSettings();
}
+ /** Returns the builder for the settings used for calls to patchFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ patchFirewallOperationSettings() {
+ return getStubSettingsBuilder().patchFirewallOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to updateFirewall. */
public UnaryCallSettings.Builder
updateFirewallSettings() {
return getStubSettingsBuilder().updateFirewallSettings();
}
+ /** Returns the builder for the settings used for calls to updateFirewall. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ updateFirewallOperationSettings() {
+ return getStubSettingsBuilder().updateFirewallOperationSettings();
+ }
+
@Override
public FirewallSettings build() throws IOException {
return new FirewallSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleClient.java
index ba45653bc3ea..18ff46d57b03 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.ForwardingRuleStub;
@@ -43,7 +46,7 @@
*
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
- * Operation response = forwardingRuleClient.deleteForwardingRule(forwardingRule);
+ * ForwardingRule response = forwardingRuleClient.getForwardingRule(forwardingRule);
* }
*
*
@@ -103,6 +106,7 @@
public class ForwardingRuleClient implements BackgroundResource {
private final ForwardingRuleSettings settings;
private final ForwardingRuleStub stub;
+ private final RegionOperationClient operationsClient;
/** Constructs an instance of ForwardingRuleClient with default settings. */
public static final ForwardingRuleClient create() throws IOException {
@@ -135,12 +139,14 @@ public static final ForwardingRuleClient create(ForwardingRuleStub stub) {
protected ForwardingRuleClient(ForwardingRuleSettings settings) throws IOException {
this.settings = settings;
this.stub = ((ForwardingRuleStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = RegionOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected ForwardingRuleClient(ForwardingRuleStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = RegionOperationClient.create(this.stub.getOperationsStub());
}
public final ForwardingRuleSettings getSettings() {
@@ -152,6 +158,16 @@ public ForwardingRuleStub getStub() {
return stub;
}
+ /**
+ * Returns the RegionOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final RegionOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Retrieves an aggregated list of forwarding rules.
@@ -302,21 +318,23 @@ public final AggregatedListForwardingRulesPagedResponse aggregatedListForwarding
*
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
- * Operation response = forwardingRuleClient.deleteForwardingRule(forwardingRule);
+ * forwardingRuleClient.deleteForwardingRuleAsync(forwardingRule).get();
* }
*
*
* @param forwardingRule Name of the ForwardingRule resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteForwardingRule(ProjectRegionForwardingRuleName forwardingRule) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteForwardingRuleAsync(
+ ProjectRegionForwardingRuleName forwardingRule) {
DeleteForwardingRuleHttpRequest request =
DeleteForwardingRuleHttpRequest.newBuilder()
.setForwardingRule(forwardingRule == null ? null : forwardingRule.toString())
.build();
- return deleteForwardingRule(request);
+ return deleteForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -328,19 +346,21 @@ public final Operation deleteForwardingRule(ProjectRegionForwardingRuleName forw
*
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
- * Operation response = forwardingRuleClient.deleteForwardingRule(forwardingRule.toString());
+ * forwardingRuleClient.deleteForwardingRuleAsync(forwardingRule.toString()).get();
* }
*
*
* @param forwardingRule Name of the ForwardingRule resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteForwardingRule(String forwardingRule) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteForwardingRuleAsync(
+ String forwardingRule) {
DeleteForwardingRuleHttpRequest request =
DeleteForwardingRuleHttpRequest.newBuilder().setForwardingRule(forwardingRule).build();
- return deleteForwardingRule(request);
+ return deleteForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -355,16 +375,42 @@ public final Operation deleteForwardingRule(String forwardingRule) {
* DeleteForwardingRuleHttpRequest request = DeleteForwardingRuleHttpRequest.newBuilder()
* .setForwardingRule(forwardingRule.toString())
* .build();
- * Operation response = forwardingRuleClient.deleteForwardingRule(request);
+ * forwardingRuleClient.deleteForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation deleteForwardingRule(DeleteForwardingRuleHttpRequest request) {
- return deleteForwardingRuleCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteForwardingRuleAsync(
+ DeleteForwardingRuleHttpRequest request) {
+ return deleteForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified ForwardingRule resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
+ * ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
+ * DeleteForwardingRuleHttpRequest request = DeleteForwardingRuleHttpRequest.newBuilder()
+ * .setForwardingRule(forwardingRule.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = forwardingRuleClient.deleteForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteForwardingRuleOperationCallable() {
+ return stub.deleteForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -381,7 +427,7 @@ public final Operation deleteForwardingRule(DeleteForwardingRuleHttpRequest requ
* .build();
* ApiFuture<Operation> future = forwardingRuleClient.deleteForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -500,7 +546,7 @@ public final ForwardingRule getForwardingRule(GetForwardingRuleHttpRequest reque
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionName region = ProjectRegionName.of("[PROJECT]", "[REGION]");
* ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
- * Operation response = forwardingRuleClient.insertForwardingRule(region, forwardingRuleResource);
+ * forwardingRuleClient.insertForwardingRuleAsync(region, forwardingRuleResource).get();
* }
*
*
@@ -513,8 +559,9 @@ public final ForwardingRule getForwardingRule(GetForwardingRuleHttpRequest reque
* (== resource_for v1.regionForwardingRules ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertForwardingRuleAsync(
ProjectRegionName region, ForwardingRule forwardingRuleResource) {
InsertForwardingRuleHttpRequest request =
@@ -522,7 +569,7 @@ public final Operation insertForwardingRule(
.setRegion(region == null ? null : region.toString())
.setForwardingRuleResource(forwardingRuleResource)
.build();
- return insertForwardingRule(request);
+ return insertForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -536,7 +583,7 @@ public final Operation insertForwardingRule(
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionName region = ProjectRegionName.of("[PROJECT]", "[REGION]");
* ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
- * Operation response = forwardingRuleClient.insertForwardingRule(region.toString(), forwardingRuleResource);
+ * forwardingRuleClient.insertForwardingRuleAsync(region.toString(), forwardingRuleResource).get();
* }
*
*
@@ -549,8 +596,9 @@ public final Operation insertForwardingRule(
* (== resource_for v1.regionForwardingRules ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertForwardingRuleAsync(
String region, ForwardingRule forwardingRuleResource) {
InsertForwardingRuleHttpRequest request =
@@ -558,7 +606,7 @@ public final Operation insertForwardingRule(
.setRegion(region)
.setForwardingRuleResource(forwardingRuleResource)
.build();
- return insertForwardingRule(request);
+ return insertForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -576,16 +624,45 @@ public final Operation insertForwardingRule(
* .setRegion(region.toString())
* .setForwardingRuleResource(forwardingRuleResource)
* .build();
- * Operation response = forwardingRuleClient.insertForwardingRule(request);
+ * forwardingRuleClient.insertForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation insertForwardingRule(InsertForwardingRuleHttpRequest request) {
- return insertForwardingRuleCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertForwardingRuleAsync(
+ InsertForwardingRuleHttpRequest request) {
+ return insertForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a ForwardingRule resource in the specified project and region using the data included
+ * in the request.
+ *
+ * Sample code:
+ *
+ *
+ * try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
+ * ProjectRegionName region = ProjectRegionName.of("[PROJECT]", "[REGION]");
+ * ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
+ * InsertForwardingRuleHttpRequest request = InsertForwardingRuleHttpRequest.newBuilder()
+ * .setRegion(region.toString())
+ * .setForwardingRuleResource(forwardingRuleResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = forwardingRuleClient.insertForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertForwardingRuleOperationCallable() {
+ return stub.insertForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -605,7 +682,7 @@ public final Operation insertForwardingRule(InsertForwardingRuleHttpRequest requ
* .build();
* ApiFuture<Operation> future = forwardingRuleClient.insertForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -764,7 +841,7 @@ public final ListForwardingRulesPagedResponse listForwardingRules(
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
* TargetReference targetReferenceResource = TargetReference.newBuilder().build();
- * Operation response = forwardingRuleClient.setTargetForwardingRule(forwardingRule, targetReferenceResource);
+ * forwardingRuleClient.setTargetForwardingRuleAsync(forwardingRule, targetReferenceResource).get();
* }
*
*
@@ -772,8 +849,9 @@ public final ListForwardingRulesPagedResponse listForwardingRules(
* @param targetReferenceResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setTargetForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetForwardingRuleAsync(
ProjectRegionForwardingRuleName forwardingRule, TargetReference targetReferenceResource) {
SetTargetForwardingRuleHttpRequest request =
@@ -781,7 +859,7 @@ public final Operation setTargetForwardingRule(
.setForwardingRule(forwardingRule == null ? null : forwardingRule.toString())
.setTargetReferenceResource(targetReferenceResource)
.build();
- return setTargetForwardingRule(request);
+ return setTargetForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -795,7 +873,7 @@ public final Operation setTargetForwardingRule(
* try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
* ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
* TargetReference targetReferenceResource = TargetReference.newBuilder().build();
- * Operation response = forwardingRuleClient.setTargetForwardingRule(forwardingRule.toString(), targetReferenceResource);
+ * forwardingRuleClient.setTargetForwardingRuleAsync(forwardingRule.toString(), targetReferenceResource).get();
* }
*
*
@@ -803,8 +881,9 @@ public final Operation setTargetForwardingRule(
* @param targetReferenceResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setTargetForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetForwardingRuleAsync(
String forwardingRule, TargetReference targetReferenceResource) {
SetTargetForwardingRuleHttpRequest request =
@@ -812,7 +891,7 @@ public final Operation setTargetForwardingRule(
.setForwardingRule(forwardingRule)
.setTargetReferenceResource(targetReferenceResource)
.build();
- return setTargetForwardingRule(request);
+ return setTargetForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -830,16 +909,45 @@ public final Operation setTargetForwardingRule(
* .setForwardingRule(forwardingRule.toString())
* .setTargetReferenceResource(targetReferenceResource)
* .build();
- * Operation response = forwardingRuleClient.setTargetForwardingRule(request);
+ * forwardingRuleClient.setTargetForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation setTargetForwardingRule(SetTargetForwardingRuleHttpRequest request) {
- return setTargetForwardingRuleCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetForwardingRuleAsync(
+ SetTargetForwardingRuleHttpRequest request) {
+ return setTargetForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Changes target URL for forwarding rule. The new target should be of the same type as the old
+ * target.
+ *
+ * Sample code:
+ *
+ *
+ * try (ForwardingRuleClient forwardingRuleClient = ForwardingRuleClient.create()) {
+ * ProjectRegionForwardingRuleName forwardingRule = ProjectRegionForwardingRuleName.of("[PROJECT]", "[REGION]", "[FORWARDING_RULE]");
+ * TargetReference targetReferenceResource = TargetReference.newBuilder().build();
+ * SetTargetForwardingRuleHttpRequest request = SetTargetForwardingRuleHttpRequest.newBuilder()
+ * .setForwardingRule(forwardingRule.toString())
+ * .setTargetReferenceResource(targetReferenceResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = forwardingRuleClient.setTargetForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ setTargetForwardingRuleOperationCallable() {
+ return stub.setTargetForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -859,7 +967,7 @@ public final Operation setTargetForwardingRule(SetTargetForwardingRuleHttpReques
* .build();
* ApiFuture<Operation> future = forwardingRuleClient.setTargetForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleSettings.java
index 14f7413d3f60..007ca1c730ca 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRuleSettings.java
@@ -22,10 +22,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -49,13 +51,13 @@
*
* 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. For
- * example, to set the total timeout of deleteForwardingRule to 30 seconds:
+ * example, to set the total timeout of getForwardingRule to 30 seconds:
*
*
*
* ForwardingRuleSettings.Builder forwardingRuleSettingsBuilder =
* ForwardingRuleSettings.newBuilder();
- * forwardingRuleSettingsBuilder.deleteForwardingRuleSettings().getRetrySettings().toBuilder()
+ * forwardingRuleSettingsBuilder.getForwardingRuleSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* ForwardingRuleSettings forwardingRuleSettings = forwardingRuleSettingsBuilder.build();
*
@@ -79,6 +81,14 @@ public class ForwardingRuleSettings extends ClientSettings
+ deleteForwardingRuleOperationSettings() {
+ return ((ForwardingRuleStubSettings) getStubSettings()).deleteForwardingRuleOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getForwardingRule. */
public UnaryCallSettings
getForwardingRuleSettings() {
@@ -91,6 +101,14 @@ public class ForwardingRuleSettings extends ClientSettings
+ insertForwardingRuleOperationSettings() {
+ return ((ForwardingRuleStubSettings) getStubSettings()).insertForwardingRuleOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listForwardingRules. */
public PagedCallSettings<
ListForwardingRulesHttpRequest, ForwardingRuleList, ListForwardingRulesPagedResponse>
@@ -104,6 +122,15 @@ public class ForwardingRuleSettings extends ClientSettings
+ setTargetForwardingRuleOperationSettings() {
+ return ((ForwardingRuleStubSettings) getStubSettings())
+ .setTargetForwardingRuleOperationSettings();
+ }
+
public static final ForwardingRuleSettings create(ForwardingRuleStubSettings stub)
throws IOException {
return new ForwardingRuleSettings.Builder(stub.toBuilder()).build();
@@ -221,6 +248,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to deleteForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().deleteForwardingRuleOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getForwardingRule. */
public UnaryCallSettings.Builder
getForwardingRuleSettings() {
@@ -233,6 +268,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to insertForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().insertForwardingRuleOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listForwardingRules. */
public PagedCallSettings.Builder<
ListForwardingRulesHttpRequest, ForwardingRuleList, ListForwardingRulesPagedResponse>
@@ -246,6 +289,15 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().setTargetForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to setTargetForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ SetTargetForwardingRuleHttpRequest, EmptyMessage, Operation>
+ setTargetForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().setTargetForwardingRuleOperationSettings();
+ }
+
@Override
public ForwardingRuleSettings build() throws IOException {
return new ForwardingRuleSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressClient.java
index 9aa48d06041f..1783e026afe3 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.GlobalAddressStub;
@@ -43,7 +46,7 @@
*
* try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
* ProjectGlobalAddressName address = ProjectGlobalAddressName.of("[PROJECT]", "[ADDRESS]");
- * Operation response = globalAddressClient.deleteGlobalAddress(address);
+ * Address response = globalAddressClient.getGlobalAddress(address);
* }
*
*
@@ -103,6 +106,7 @@
public class GlobalAddressClient implements BackgroundResource {
private final GlobalAddressSettings settings;
private final GlobalAddressStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of GlobalAddressClient with default settings. */
public static final GlobalAddressClient create() throws IOException {
@@ -135,12 +139,14 @@ public static final GlobalAddressClient create(GlobalAddressStub stub) {
protected GlobalAddressClient(GlobalAddressSettings settings) throws IOException {
this.settings = settings;
this.stub = ((GlobalAddressStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected GlobalAddressClient(GlobalAddressStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final GlobalAddressSettings getSettings() {
@@ -152,6 +158,16 @@ public GlobalAddressStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified address resource.
@@ -161,21 +177,23 @@ public GlobalAddressStub getStub() {
*
* try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
* ProjectGlobalAddressName address = ProjectGlobalAddressName.of("[PROJECT]", "[ADDRESS]");
- * Operation response = globalAddressClient.deleteGlobalAddress(address);
+ * globalAddressClient.deleteGlobalAddressAsync(address).get();
* }
*
*
* @param address Name of the address resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteGlobalAddress(ProjectGlobalAddressName address) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalAddressAsync(
+ ProjectGlobalAddressName address) {
DeleteGlobalAddressHttpRequest request =
DeleteGlobalAddressHttpRequest.newBuilder()
.setAddress(address == null ? null : address.toString())
.build();
- return deleteGlobalAddress(request);
+ return deleteGlobalAddressAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -187,19 +205,20 @@ public final Operation deleteGlobalAddress(ProjectGlobalAddressName address) {
*
* try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
* ProjectGlobalAddressName address = ProjectGlobalAddressName.of("[PROJECT]", "[ADDRESS]");
- * Operation response = globalAddressClient.deleteGlobalAddress(address.toString());
+ * globalAddressClient.deleteGlobalAddressAsync(address.toString()).get();
* }
*
*
* @param address Name of the address resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteGlobalAddress(String address) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalAddressAsync(String address) {
DeleteGlobalAddressHttpRequest request =
DeleteGlobalAddressHttpRequest.newBuilder().setAddress(address).build();
- return deleteGlobalAddress(request);
+ return deleteGlobalAddressAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -214,16 +233,42 @@ public final Operation deleteGlobalAddress(String address) {
* DeleteGlobalAddressHttpRequest request = DeleteGlobalAddressHttpRequest.newBuilder()
* .setAddress(address.toString())
* .build();
- * Operation response = globalAddressClient.deleteGlobalAddress(request);
+ * globalAddressClient.deleteGlobalAddressAsync(request).get();
* }
*
*
* @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
- public final Operation deleteGlobalAddress(DeleteGlobalAddressHttpRequest request) {
- return deleteGlobalAddressCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalAddressAsync(
+ DeleteGlobalAddressHttpRequest request) {
+ return deleteGlobalAddressOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified address resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
+ * ProjectGlobalAddressName address = ProjectGlobalAddressName.of("[PROJECT]", "[ADDRESS]");
+ * DeleteGlobalAddressHttpRequest request = DeleteGlobalAddressHttpRequest.newBuilder()
+ * .setAddress(address.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = globalAddressClient.deleteGlobalAddressOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteGlobalAddressOperationCallable() {
+ return stub.deleteGlobalAddressOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -240,7 +285,7 @@ public final Operation deleteGlobalAddress(DeleteGlobalAddressHttpRequest reques
* .build();
* ApiFuture<Operation> future = globalAddressClient.deleteGlobalAddressCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -361,7 +406,7 @@ public final UnaryCallable getGlobalAddres
* try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* Address addressResource = Address.newBuilder().build();
- * Operation response = globalAddressClient.insertGlobalAddress(project, addressResource);
+ * globalAddressClient.insertGlobalAddressAsync(project, addressResource).get();
* }
*
*
@@ -371,15 +416,17 @@ public final UnaryCallable getGlobalAddres
* v1.globalAddresses ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertGlobalAddress(ProjectName project, Address addressResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalAddressAsync(
+ ProjectName project, Address addressResource) {
InsertGlobalAddressHttpRequest request =
InsertGlobalAddressHttpRequest.newBuilder()
.setProject(project == null ? null : project.toString())
.setAddressResource(addressResource)
.build();
- return insertGlobalAddress(request);
+ return insertGlobalAddressAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -392,7 +439,7 @@ public final Operation insertGlobalAddress(ProjectName project, Address addressR
* try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* Address addressResource = Address.newBuilder().build();
- * Operation response = globalAddressClient.insertGlobalAddress(project.toString(), addressResource);
+ * globalAddressClient.insertGlobalAddressAsync(project.toString(), addressResource).get();
* }
*
*
@@ -402,15 +449,17 @@ public final Operation insertGlobalAddress(ProjectName project, Address addressR
* v1.globalAddresses ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertGlobalAddress(String project, Address addressResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalAddressAsync(
+ String project, Address addressResource) {
InsertGlobalAddressHttpRequest request =
InsertGlobalAddressHttpRequest.newBuilder()
.setProject(project)
.setAddressResource(addressResource)
.build();
- return insertGlobalAddress(request);
+ return insertGlobalAddressAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -427,16 +476,44 @@ public final Operation insertGlobalAddress(String project, Address addressResour
* .setProject(project.toString())
* .setAddressResource(addressResource)
* .build();
- * Operation response = globalAddressClient.insertGlobalAddress(request);
+ * globalAddressClient.insertGlobalAddressAsync(request).get();
* }
*
*
* @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
- public final Operation insertGlobalAddress(InsertGlobalAddressHttpRequest request) {
- return insertGlobalAddressCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalAddressAsync(
+ InsertGlobalAddressHttpRequest request) {
+ return insertGlobalAddressOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates an address resource in the specified project using the data included in the request.
+ *
+ * Sample code:
+ *
+ *
+ * try (GlobalAddressClient globalAddressClient = GlobalAddressClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * Address addressResource = Address.newBuilder().build();
+ * InsertGlobalAddressHttpRequest request = InsertGlobalAddressHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setAddressResource(addressResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = globalAddressClient.insertGlobalAddressOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertGlobalAddressOperationCallable() {
+ return stub.insertGlobalAddressOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -455,7 +532,7 @@ public final Operation insertGlobalAddress(InsertGlobalAddressHttpRequest reques
* .build();
* ApiFuture<Operation> future = globalAddressClient.insertGlobalAddressCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressSettings.java
index 7539e81ce69a..dfff9be07efb 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteGlobalAddress to 30 seconds:
+ * example, to set the total timeout of getGlobalAddress to 30 seconds:
*
*
*
* GlobalAddressSettings.Builder globalAddressSettingsBuilder =
* GlobalAddressSettings.newBuilder();
- * globalAddressSettingsBuilder.deleteGlobalAddressSettings().getRetrySettings().toBuilder()
+ * globalAddressSettingsBuilder.getGlobalAddressSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* GlobalAddressSettings globalAddressSettings = globalAddressSettingsBuilder.build();
*
@@ -69,6 +71,14 @@ public class GlobalAddressSettings extends ClientSettings
return ((GlobalAddressStubSettings) getStubSettings()).deleteGlobalAddressSettings();
}
+ /** Returns the object with the settings used for calls to deleteGlobalAddress. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ deleteGlobalAddressOperationSettings() {
+ return ((GlobalAddressStubSettings) getStubSettings()).deleteGlobalAddressOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getGlobalAddress. */
public UnaryCallSettings getGlobalAddressSettings() {
return ((GlobalAddressStubSettings) getStubSettings()).getGlobalAddressSettings();
@@ -80,6 +90,14 @@ public UnaryCallSettings getGlobalAddressS
return ((GlobalAddressStubSettings) getStubSettings()).insertGlobalAddressSettings();
}
+ /** Returns the object with the settings used for calls to insertGlobalAddress. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ insertGlobalAddressOperationSettings() {
+ return ((GlobalAddressStubSettings) getStubSettings()).insertGlobalAddressOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listGlobalAddresses. */
public PagedCallSettings<
ListGlobalAddressesHttpRequest, AddressList, ListGlobalAddressesPagedResponse>
@@ -195,6 +213,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteGlobalAddressSettings();
}
+ /** Returns the builder for the settings used for calls to deleteGlobalAddress. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteGlobalAddressOperationSettings() {
+ return getStubSettingsBuilder().deleteGlobalAddressOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getGlobalAddress. */
public UnaryCallSettings.Builder
getGlobalAddressSettings() {
@@ -207,6 +233,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertGlobalAddressSettings();
}
+ /** Returns the builder for the settings used for calls to insertGlobalAddress. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertGlobalAddressOperationSettings() {
+ return getStubSettingsBuilder().insertGlobalAddressOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listGlobalAddresses. */
public PagedCallSettings.Builder<
ListGlobalAddressesHttpRequest, AddressList, ListGlobalAddressesPagedResponse>
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleClient.java
index 64156dde5424..e7543a904b64 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.GlobalForwardingRuleStub;
@@ -43,7 +46,7 @@
*
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
- * Operation response = globalForwardingRuleClient.deleteGlobalForwardingRule(forwardingRule);
+ * ForwardingRule response = globalForwardingRuleClient.getGlobalForwardingRule(forwardingRule);
* }
*
*
@@ -104,6 +107,7 @@
public class GlobalForwardingRuleClient implements BackgroundResource {
private final GlobalForwardingRuleSettings settings;
private final GlobalForwardingRuleStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of GlobalForwardingRuleClient with default settings. */
public static final GlobalForwardingRuleClient create() throws IOException {
@@ -136,12 +140,14 @@ public static final GlobalForwardingRuleClient create(GlobalForwardingRuleStub s
protected GlobalForwardingRuleClient(GlobalForwardingRuleSettings settings) throws IOException {
this.settings = settings;
this.stub = ((GlobalForwardingRuleStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected GlobalForwardingRuleClient(GlobalForwardingRuleStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final GlobalForwardingRuleSettings getSettings() {
@@ -153,6 +159,16 @@ public GlobalForwardingRuleStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified GlobalForwardingRule resource.
@@ -162,22 +178,23 @@ public GlobalForwardingRuleStub getStub() {
*
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
- * Operation response = globalForwardingRuleClient.deleteGlobalForwardingRule(forwardingRule);
+ * globalForwardingRuleClient.deleteGlobalForwardingRuleAsync(forwardingRule).get();
* }
*
*
* @param forwardingRule Name of the ForwardingRule resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalForwardingRuleAsync(
ProjectGlobalForwardingRuleName forwardingRule) {
DeleteGlobalForwardingRuleHttpRequest request =
DeleteGlobalForwardingRuleHttpRequest.newBuilder()
.setForwardingRule(forwardingRule == null ? null : forwardingRule.toString())
.build();
- return deleteGlobalForwardingRule(request);
+ return deleteGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -189,21 +206,23 @@ public final Operation deleteGlobalForwardingRule(
*
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
- * Operation response = globalForwardingRuleClient.deleteGlobalForwardingRule(forwardingRule.toString());
+ * globalForwardingRuleClient.deleteGlobalForwardingRuleAsync(forwardingRule.toString()).get();
* }
*
*
* @param forwardingRule Name of the ForwardingRule resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteGlobalForwardingRule(String forwardingRule) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalForwardingRuleAsync(
+ String forwardingRule) {
DeleteGlobalForwardingRuleHttpRequest request =
DeleteGlobalForwardingRuleHttpRequest.newBuilder()
.setForwardingRule(forwardingRule)
.build();
- return deleteGlobalForwardingRule(request);
+ return deleteGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -218,16 +237,42 @@ public final Operation deleteGlobalForwardingRule(String forwardingRule) {
* DeleteGlobalForwardingRuleHttpRequest request = DeleteGlobalForwardingRuleHttpRequest.newBuilder()
* .setForwardingRule(forwardingRule.toString())
* .build();
- * Operation response = globalForwardingRuleClient.deleteGlobalForwardingRule(request);
+ * globalForwardingRuleClient.deleteGlobalForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation deleteGlobalForwardingRule(DeleteGlobalForwardingRuleHttpRequest request) {
- return deleteGlobalForwardingRuleCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteGlobalForwardingRuleAsync(
+ DeleteGlobalForwardingRuleHttpRequest request) {
+ return deleteGlobalForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified GlobalForwardingRule resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
+ * ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
+ * DeleteGlobalForwardingRuleHttpRequest request = DeleteGlobalForwardingRuleHttpRequest.newBuilder()
+ * .setForwardingRule(forwardingRule.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = globalForwardingRuleClient.deleteGlobalForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteGlobalForwardingRuleOperationCallable() {
+ return stub.deleteGlobalForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -244,7 +289,7 @@ public final Operation deleteGlobalForwardingRule(DeleteGlobalForwardingRuleHttp
* .build();
* ApiFuture<Operation> future = globalForwardingRuleClient.deleteGlobalForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -368,7 +413,7 @@ public final ForwardingRule getGlobalForwardingRule(GetGlobalForwardingRuleHttpR
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
- * Operation response = globalForwardingRuleClient.insertGlobalForwardingRule(project, forwardingRuleResource);
+ * globalForwardingRuleClient.insertGlobalForwardingRuleAsync(project, forwardingRuleResource).get();
* }
*
*
@@ -381,8 +426,9 @@ public final ForwardingRule getGlobalForwardingRule(GetGlobalForwardingRuleHttpR
* (== resource_for v1.regionForwardingRules ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalForwardingRuleAsync(
ProjectName project, ForwardingRule forwardingRuleResource) {
InsertGlobalForwardingRuleHttpRequest request =
@@ -390,7 +436,7 @@ public final Operation insertGlobalForwardingRule(
.setProject(project == null ? null : project.toString())
.setForwardingRuleResource(forwardingRuleResource)
.build();
- return insertGlobalForwardingRule(request);
+ return insertGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -404,7 +450,7 @@ public final Operation insertGlobalForwardingRule(
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
- * Operation response = globalForwardingRuleClient.insertGlobalForwardingRule(project.toString(), forwardingRuleResource);
+ * globalForwardingRuleClient.insertGlobalForwardingRuleAsync(project.toString(), forwardingRuleResource).get();
* }
*
*
@@ -417,8 +463,9 @@ public final Operation insertGlobalForwardingRule(
* (== resource_for v1.regionForwardingRules ==)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalForwardingRuleAsync(
String project, ForwardingRule forwardingRuleResource) {
InsertGlobalForwardingRuleHttpRequest request =
@@ -426,7 +473,7 @@ public final Operation insertGlobalForwardingRule(
.setProject(project)
.setForwardingRuleResource(forwardingRuleResource)
.build();
- return insertGlobalForwardingRule(request);
+ return insertGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -444,16 +491,45 @@ public final Operation insertGlobalForwardingRule(
* .setProject(project.toString())
* .setForwardingRuleResource(forwardingRuleResource)
* .build();
- * Operation response = globalForwardingRuleClient.insertGlobalForwardingRule(request);
+ * globalForwardingRuleClient.insertGlobalForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation insertGlobalForwardingRule(InsertGlobalForwardingRuleHttpRequest request) {
- return insertGlobalForwardingRuleCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertGlobalForwardingRuleAsync(
+ InsertGlobalForwardingRuleHttpRequest request) {
+ return insertGlobalForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a GlobalForwardingRule resource in the specified project using the data included in the
+ * request.
+ *
+ * Sample code:
+ *
+ *
+ * try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * ForwardingRule forwardingRuleResource = ForwardingRule.newBuilder().build();
+ * InsertGlobalForwardingRuleHttpRequest request = InsertGlobalForwardingRuleHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setForwardingRuleResource(forwardingRuleResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = globalForwardingRuleClient.insertGlobalForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertGlobalForwardingRuleOperationCallable() {
+ return stub.insertGlobalForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -473,7 +549,7 @@ public final Operation insertGlobalForwardingRule(InsertGlobalForwardingRuleHttp
* .build();
* ApiFuture<Operation> future = globalForwardingRuleClient.insertGlobalForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -634,7 +710,7 @@ public final ListGlobalForwardingRulesPagedResponse listGlobalForwardingRules(
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
* TargetReference targetReferenceResource = TargetReference.newBuilder().build();
- * Operation response = globalForwardingRuleClient.setTargetGlobalForwardingRule(forwardingRule, targetReferenceResource);
+ * globalForwardingRuleClient.setTargetGlobalForwardingRuleAsync(forwardingRule, targetReferenceResource).get();
* }
*
*
@@ -642,8 +718,9 @@ public final ListGlobalForwardingRulesPagedResponse listGlobalForwardingRules(
* @param targetReferenceResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setTargetGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetGlobalForwardingRuleAsync(
ProjectGlobalForwardingRuleName forwardingRule, TargetReference targetReferenceResource) {
SetTargetGlobalForwardingRuleHttpRequest request =
@@ -651,7 +728,7 @@ public final Operation setTargetGlobalForwardingRule(
.setForwardingRule(forwardingRule == null ? null : forwardingRule.toString())
.setTargetReferenceResource(targetReferenceResource)
.build();
- return setTargetGlobalForwardingRule(request);
+ return setTargetGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -665,7 +742,7 @@ public final Operation setTargetGlobalForwardingRule(
* try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
* ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
* TargetReference targetReferenceResource = TargetReference.newBuilder().build();
- * Operation response = globalForwardingRuleClient.setTargetGlobalForwardingRule(forwardingRule.toString(), targetReferenceResource);
+ * globalForwardingRuleClient.setTargetGlobalForwardingRuleAsync(forwardingRule.toString(), targetReferenceResource).get();
* }
*
*
@@ -673,8 +750,9 @@ public final Operation setTargetGlobalForwardingRule(
* @param targetReferenceResource
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation setTargetGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetGlobalForwardingRuleAsync(
String forwardingRule, TargetReference targetReferenceResource) {
SetTargetGlobalForwardingRuleHttpRequest request =
@@ -682,7 +760,7 @@ public final Operation setTargetGlobalForwardingRule(
.setForwardingRule(forwardingRule)
.setTargetReferenceResource(targetReferenceResource)
.build();
- return setTargetGlobalForwardingRule(request);
+ return setTargetGlobalForwardingRuleAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -700,17 +778,45 @@ public final Operation setTargetGlobalForwardingRule(
* .setForwardingRule(forwardingRule.toString())
* .setTargetReferenceResource(targetReferenceResource)
* .build();
- * Operation response = globalForwardingRuleClient.setTargetGlobalForwardingRule(request);
+ * globalForwardingRuleClient.setTargetGlobalForwardingRuleAsync(request).get();
* }
*
*
* @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
- public final Operation setTargetGlobalForwardingRule(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture setTargetGlobalForwardingRuleAsync(
SetTargetGlobalForwardingRuleHttpRequest request) {
- return setTargetGlobalForwardingRuleCallable().call(request);
+ return setTargetGlobalForwardingRuleOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Changes target URL for the GlobalForwardingRule resource. The new target should be of the same
+ * type as the old target.
+ *
+ * Sample code:
+ *
+ *
+ * try (GlobalForwardingRuleClient globalForwardingRuleClient = GlobalForwardingRuleClient.create()) {
+ * ProjectGlobalForwardingRuleName forwardingRule = ProjectGlobalForwardingRuleName.of("[PROJECT]", "[FORWARDING_RULE]");
+ * TargetReference targetReferenceResource = TargetReference.newBuilder().build();
+ * SetTargetGlobalForwardingRuleHttpRequest request = SetTargetGlobalForwardingRuleHttpRequest.newBuilder()
+ * .setForwardingRule(forwardingRule.toString())
+ * .setTargetReferenceResource(targetReferenceResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = globalForwardingRuleClient.setTargetGlobalForwardingRuleOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ setTargetGlobalForwardingRuleOperationCallable() {
+ return stub.setTargetGlobalForwardingRuleOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -730,7 +836,7 @@ public final Operation setTargetGlobalForwardingRule(
* .build();
* ApiFuture<Operation> future = globalForwardingRuleClient.setTargetGlobalForwardingRuleCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleSettings.java
index acec8173719d..3f79d7d5dcac 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRuleSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteGlobalForwardingRule to 30 seconds:
+ * example, to set the total timeout of getGlobalForwardingRule to 30 seconds:
*
*
*
* GlobalForwardingRuleSettings.Builder globalForwardingRuleSettingsBuilder =
* GlobalForwardingRuleSettings.newBuilder();
- * globalForwardingRuleSettingsBuilder.deleteGlobalForwardingRuleSettings().getRetrySettings().toBuilder()
+ * globalForwardingRuleSettingsBuilder.getGlobalForwardingRuleSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* GlobalForwardingRuleSettings globalForwardingRuleSettings = globalForwardingRuleSettingsBuilder.build();
*
@@ -70,6 +72,15 @@ public class GlobalForwardingRuleSettings extends ClientSettings
+ deleteGlobalForwardingRuleOperationSettings() {
+ return ((GlobalForwardingRuleStubSettings) getStubSettings())
+ .deleteGlobalForwardingRuleOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getGlobalForwardingRule. */
public UnaryCallSettings
getGlobalForwardingRuleSettings() {
@@ -83,6 +94,15 @@ public class GlobalForwardingRuleSettings extends ClientSettings
+ insertGlobalForwardingRuleOperationSettings() {
+ return ((GlobalForwardingRuleStubSettings) getStubSettings())
+ .insertGlobalForwardingRuleOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listGlobalForwardingRules. */
public PagedCallSettings<
ListGlobalForwardingRulesHttpRequest,
@@ -100,6 +120,15 @@ public class GlobalForwardingRuleSettings extends ClientSettings
+ setTargetGlobalForwardingRuleOperationSettings() {
+ return ((GlobalForwardingRuleStubSettings) getStubSettings())
+ .setTargetGlobalForwardingRuleOperationSettings();
+ }
+
public static final GlobalForwardingRuleSettings create(GlobalForwardingRuleStubSettings stub)
throws IOException {
return new GlobalForwardingRuleSettings.Builder(stub.toBuilder()).build();
@@ -209,6 +238,15 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteGlobalForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to deleteGlobalForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ DeleteGlobalForwardingRuleHttpRequest, EmptyMessage, Operation>
+ deleteGlobalForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().deleteGlobalForwardingRuleOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getGlobalForwardingRule. */
public UnaryCallSettings.Builder
getGlobalForwardingRuleSettings() {
@@ -221,6 +259,15 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertGlobalForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to insertGlobalForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ InsertGlobalForwardingRuleHttpRequest, EmptyMessage, Operation>
+ insertGlobalForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().insertGlobalForwardingRuleOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listGlobalForwardingRules. */
public PagedCallSettings.Builder<
ListGlobalForwardingRulesHttpRequest,
@@ -236,6 +283,15 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().setTargetGlobalForwardingRuleSettings();
}
+ /** Returns the builder for the settings used for calls to setTargetGlobalForwardingRule. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder<
+ SetTargetGlobalForwardingRuleHttpRequest, EmptyMessage, Operation>
+ setTargetGlobalForwardingRuleOperationSettings() {
+ return getStubSettingsBuilder().setTargetGlobalForwardingRuleOperationSettings();
+ }
+
@Override
public GlobalForwardingRuleSettings build() throws IOException {
return new GlobalForwardingRuleSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationClient.java
index cf3ff11bfbfe..1f8c5af1629d 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationClient.java
@@ -20,6 +20,7 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
@@ -387,7 +388,7 @@ public final void deleteGlobalOperation(DeleteGlobalOperationHttpRequest request
*
*/
@BetaApi
- public final UnaryCallable
+ public final UnaryCallable
deleteGlobalOperationCallable() {
return stub.deleteGlobalOperationCallable();
}
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationSettings.java
index 51772546798b..09ec9aacfd53 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationSettings.java
@@ -22,6 +22,7 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
@@ -75,7 +76,8 @@ public class GlobalOperationSettings extends ClientSettings deleteGlobalOperationSettings() {
+ public UnaryCallSettings
+ deleteGlobalOperationSettings() {
return ((GlobalOperationStubSettings) getStubSettings()).deleteGlobalOperationSettings();
}
@@ -203,7 +205,7 @@ public Builder applyToAllUnaryMethods(
}
/** Returns the builder for the settings used for calls to deleteGlobalOperation. */
- public UnaryCallSettings.Builder
+ public UnaryCallSettings.Builder
deleteGlobalOperationSettings() {
return getStubSettingsBuilder().deleteGlobalOperationSettings();
}
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckClient.java
index 0eaa5d6ed784..04edf93c2b4f 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.HealthCheckStub;
@@ -43,7 +46,7 @@
*
* try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
- * Operation response = healthCheckClient.deleteHealthCheck(healthCheck);
+ * HealthCheck response = healthCheckClient.getHealthCheck(healthCheck);
* }
*
*
@@ -103,6 +106,7 @@
public class HealthCheckClient implements BackgroundResource {
private final HealthCheckSettings settings;
private final HealthCheckStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of HealthCheckClient with default settings. */
public static final HealthCheckClient create() throws IOException {
@@ -134,12 +138,14 @@ public static final HealthCheckClient create(HealthCheckStub stub) {
protected HealthCheckClient(HealthCheckSettings settings) throws IOException {
this.settings = settings;
this.stub = ((HealthCheckStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected HealthCheckClient(HealthCheckStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final HealthCheckSettings getSettings() {
@@ -151,6 +157,16 @@ public HealthCheckStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified HealthCheck resource.
@@ -160,21 +176,23 @@ public HealthCheckStub getStub() {
*
* try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
- * Operation response = healthCheckClient.deleteHealthCheck(healthCheck);
+ * healthCheckClient.deleteHealthCheckAsync(healthCheck).get();
* }
*
*
* @param healthCheck Name of the HealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHealthCheck(ProjectGlobalHealthCheckName healthCheck) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHealthCheckAsync(
+ ProjectGlobalHealthCheckName healthCheck) {
DeleteHealthCheckHttpRequest request =
DeleteHealthCheckHttpRequest.newBuilder()
.setHealthCheck(healthCheck == null ? null : healthCheck.toString())
.build();
- return deleteHealthCheck(request);
+ return deleteHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -186,19 +204,20 @@ public final Operation deleteHealthCheck(ProjectGlobalHealthCheckName healthChec
*
* try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
- * Operation response = healthCheckClient.deleteHealthCheck(healthCheck.toString());
+ * healthCheckClient.deleteHealthCheckAsync(healthCheck.toString()).get();
* }
*
*
* @param healthCheck Name of the HealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHealthCheck(String healthCheck) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHealthCheckAsync(String healthCheck) {
DeleteHealthCheckHttpRequest request =
DeleteHealthCheckHttpRequest.newBuilder().setHealthCheck(healthCheck).build();
- return deleteHealthCheck(request);
+ return deleteHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -213,16 +232,42 @@ public final Operation deleteHealthCheck(String healthCheck) {
* DeleteHealthCheckHttpRequest request = DeleteHealthCheckHttpRequest.newBuilder()
* .setHealthCheck(healthCheck.toString())
* .build();
- * Operation response = healthCheckClient.deleteHealthCheck(request);
+ * healthCheckClient.deleteHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation deleteHealthCheck(DeleteHealthCheckHttpRequest request) {
- return deleteHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHealthCheckAsync(
+ DeleteHealthCheckHttpRequest request) {
+ return deleteHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified HealthCheck resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
+ * ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
+ * DeleteHealthCheckHttpRequest request = DeleteHealthCheckHttpRequest.newBuilder()
+ * .setHealthCheck(healthCheck.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = healthCheckClient.deleteHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteHealthCheckOperationCallable() {
+ return stub.deleteHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -239,7 +284,7 @@ public final Operation deleteHealthCheck(DeleteHealthCheckHttpRequest request) {
* .build();
* ApiFuture<Operation> future = healthCheckClient.deleteHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -359,7 +404,7 @@ public final UnaryCallable getHealthChec
* try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
- * Operation response = healthCheckClient.insertHealthCheck(project, healthCheckResource);
+ * healthCheckClient.insertHealthCheckAsync(project, healthCheckResource).get();
* }
*
*
@@ -369,15 +414,17 @@ public final UnaryCallable getHealthChec
* protocols.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHealthCheck(ProjectName project, HealthCheck healthCheckResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHealthCheckAsync(
+ ProjectName project, HealthCheck healthCheckResource) {
InsertHealthCheckHttpRequest request =
InsertHealthCheckHttpRequest.newBuilder()
.setProject(project == null ? null : project.toString())
.setHealthCheckResource(healthCheckResource)
.build();
- return insertHealthCheck(request);
+ return insertHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -390,7 +437,7 @@ public final Operation insertHealthCheck(ProjectName project, HealthCheck health
* try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
- * Operation response = healthCheckClient.insertHealthCheck(project.toString(), healthCheckResource);
+ * healthCheckClient.insertHealthCheckAsync(project.toString(), healthCheckResource).get();
* }
*
*
@@ -400,15 +447,17 @@ public final Operation insertHealthCheck(ProjectName project, HealthCheck health
* protocols.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHealthCheck(String project, HealthCheck healthCheckResource) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHealthCheckAsync(
+ String project, HealthCheck healthCheckResource) {
InsertHealthCheckHttpRequest request =
InsertHealthCheckHttpRequest.newBuilder()
.setProject(project)
.setHealthCheckResource(healthCheckResource)
.build();
- return insertHealthCheck(request);
+ return insertHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -425,16 +474,44 @@ public final Operation insertHealthCheck(String project, HealthCheck healthCheck
* .setProject(project.toString())
* .setHealthCheckResource(healthCheckResource)
* .build();
- * Operation response = healthCheckClient.insertHealthCheck(request);
+ * healthCheckClient.insertHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation insertHealthCheck(InsertHealthCheckHttpRequest request) {
- return insertHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHealthCheckAsync(
+ InsertHealthCheckHttpRequest request) {
+ return insertHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a HealthCheck resource in the specified project using the data included in the request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
+ * InsertHealthCheckHttpRequest request = InsertHealthCheckHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setHealthCheckResource(healthCheckResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = healthCheckClient.insertHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertHealthCheckOperationCallable() {
+ return stub.insertHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -453,7 +530,7 @@ public final Operation insertHealthCheck(InsertHealthCheckHttpRequest request) {
* .build();
* ApiFuture<Operation> future = healthCheckClient.insertHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -611,7 +688,7 @@ public final ListHealthChecksPagedResponse listHealthChecks(ListHealthChecksHttp
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = healthCheckClient.patchHealthCheck(healthCheck, healthCheckResource, fieldMask);
+ * healthCheckClient.patchHealthCheckAsync(healthCheck, healthCheckResource, fieldMask).get();
* }
*
*
@@ -625,8 +702,9 @@ public final ListHealthChecksPagedResponse listHealthChecks(ListHealthChecksHttp
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHealthCheckAsync(
ProjectGlobalHealthCheckName healthCheck,
HealthCheck healthCheckResource,
List fieldMask) {
@@ -637,7 +715,7 @@ public final Operation patchHealthCheck(
.setHealthCheckResource(healthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHealthCheck(request);
+ return patchHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -652,7 +730,7 @@ public final Operation patchHealthCheck(
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = healthCheckClient.patchHealthCheck(healthCheck.toString(), healthCheckResource, fieldMask);
+ * healthCheckClient.patchHealthCheckAsync(healthCheck.toString(), healthCheckResource, fieldMask).get();
* }
*
*
@@ -666,8 +744,9 @@ public final Operation patchHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHealthCheckAsync(
String healthCheck, HealthCheck healthCheckResource, List fieldMask) {
PatchHealthCheckHttpRequest request =
@@ -676,7 +755,7 @@ public final Operation patchHealthCheck(
.setHealthCheckResource(healthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHealthCheck(request);
+ return patchHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -696,16 +775,47 @@ public final Operation patchHealthCheck(
* .setHealthCheckResource(healthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = healthCheckClient.patchHealthCheck(request);
+ * healthCheckClient.patchHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation patchHealthCheck(PatchHealthCheckHttpRequest request) {
- return patchHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHealthCheckAsync(
+ PatchHealthCheckHttpRequest request) {
+ return patchHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HealthCheck resource in the specified project using the data included in the request.
+ * This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ *
+ * Sample code:
+ *
+ *
+ * try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
+ * ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
+ * HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * PatchHealthCheckHttpRequest request = PatchHealthCheckHttpRequest.newBuilder()
+ * .setHealthCheck(healthCheck.toString())
+ * .setHealthCheckResource(healthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = healthCheckClient.patchHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ patchHealthCheckOperationCallable() {
+ return stub.patchHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -727,7 +837,7 @@ public final Operation patchHealthCheck(PatchHealthCheckHttpRequest request) {
* .build();
* ApiFuture<Operation> future = healthCheckClient.patchHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -747,7 +857,7 @@ public final UnaryCallable patchHealthCh
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = healthCheckClient.updateHealthCheck(healthCheck, healthCheckResource, fieldMask);
+ * healthCheckClient.updateHealthCheckAsync(healthCheck, healthCheckResource, fieldMask).get();
* }
*
*
@@ -761,8 +871,9 @@ public final UnaryCallable patchHealthCh
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHealthCheckAsync(
ProjectGlobalHealthCheckName healthCheck,
HealthCheck healthCheckResource,
List fieldMask) {
@@ -773,7 +884,7 @@ public final Operation updateHealthCheck(
.setHealthCheckResource(healthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHealthCheck(request);
+ return updateHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -787,7 +898,7 @@ public final Operation updateHealthCheck(
* ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
* HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = healthCheckClient.updateHealthCheck(healthCheck.toString(), healthCheckResource, fieldMask);
+ * healthCheckClient.updateHealthCheckAsync(healthCheck.toString(), healthCheckResource, fieldMask).get();
* }
*
*
@@ -801,8 +912,9 @@ public final Operation updateHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHealthCheckAsync(
String healthCheck, HealthCheck healthCheckResource, List fieldMask) {
UpdateHealthCheckHttpRequest request =
@@ -811,7 +923,7 @@ public final Operation updateHealthCheck(
.setHealthCheckResource(healthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHealthCheck(request);
+ return updateHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -830,16 +942,46 @@ public final Operation updateHealthCheck(
* .setHealthCheckResource(healthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = healthCheckClient.updateHealthCheck(request);
+ * healthCheckClient.updateHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation updateHealthCheck(UpdateHealthCheckHttpRequest request) {
- return updateHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHealthCheckAsync(
+ UpdateHealthCheckHttpRequest request) {
+ return updateHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HealthCheck resource in the specified project using the data included in the request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HealthCheckClient healthCheckClient = HealthCheckClient.create()) {
+ * ProjectGlobalHealthCheckName healthCheck = ProjectGlobalHealthCheckName.of("[PROJECT]", "[HEALTH_CHECK]");
+ * HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * UpdateHealthCheckHttpRequest request = UpdateHealthCheckHttpRequest.newBuilder()
+ * .setHealthCheck(healthCheck.toString())
+ * .setHealthCheckResource(healthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = healthCheckClient.updateHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ updateHealthCheckOperationCallable() {
+ return stub.updateHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -860,7 +1002,7 @@ public final Operation updateHealthCheck(UpdateHealthCheckHttpRequest request) {
* .build();
* ApiFuture<Operation> future = healthCheckClient.updateHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckSettings.java
index f10e60d3cff0..9b53d4674629 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthCheckSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteHealthCheck to 30 seconds:
+ * example, to set the total timeout of getHealthCheck to 30 seconds:
*
*
*
* HealthCheckSettings.Builder healthCheckSettingsBuilder =
* HealthCheckSettings.newBuilder();
- * healthCheckSettingsBuilder.deleteHealthCheckSettings().getRetrySettings().toBuilder()
+ * healthCheckSettingsBuilder.getHealthCheckSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* HealthCheckSettings healthCheckSettings = healthCheckSettingsBuilder.build();
*
@@ -68,6 +70,14 @@ public UnaryCallSettings deleteHealthCh
return ((HealthCheckStubSettings) getStubSettings()).deleteHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to deleteHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ deleteHealthCheckOperationSettings() {
+ return ((HealthCheckStubSettings) getStubSettings()).deleteHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getHealthCheck. */
public UnaryCallSettings getHealthCheckSettings() {
return ((HealthCheckStubSettings) getStubSettings()).getHealthCheckSettings();
@@ -78,6 +88,14 @@ public UnaryCallSettings insertHealthCh
return ((HealthCheckStubSettings) getStubSettings()).insertHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to insertHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ insertHealthCheckOperationSettings() {
+ return ((HealthCheckStubSettings) getStubSettings()).insertHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listHealthChecks. */
public PagedCallSettings<
ListHealthChecksHttpRequest, HealthCheckList, ListHealthChecksPagedResponse>
@@ -90,11 +108,27 @@ public UnaryCallSettings patchHealthChec
return ((HealthCheckStubSettings) getStubSettings()).patchHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to patchHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ patchHealthCheckOperationSettings() {
+ return ((HealthCheckStubSettings) getStubSettings()).patchHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to updateHealthCheck. */
public UnaryCallSettings updateHealthCheckSettings() {
return ((HealthCheckStubSettings) getStubSettings()).updateHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to updateHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ updateHealthCheckOperationSettings() {
+ return ((HealthCheckStubSettings) getStubSettings()).updateHealthCheckOperationSettings();
+ }
+
public static final HealthCheckSettings create(HealthCheckStubSettings stub) throws IOException {
return new HealthCheckSettings.Builder(stub.toBuilder()).build();
}
@@ -202,6 +236,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to deleteHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().deleteHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getHealthCheck. */
public UnaryCallSettings.Builder
getHealthCheckSettings() {
@@ -214,6 +256,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to insertHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().insertHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listHealthChecks. */
public PagedCallSettings.Builder<
ListHealthChecksHttpRequest, HealthCheckList, ListHealthChecksPagedResponse>
@@ -227,12 +277,28 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().patchHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to patchHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ patchHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().patchHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to updateHealthCheck. */
public UnaryCallSettings.Builder
updateHealthCheckSettings() {
return getStubSettingsBuilder().updateHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to updateHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ updateHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().updateHealthCheckOperationSettings();
+ }
+
@Override
public HealthCheckSettings build() throws IOException {
return new HealthCheckSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckClient.java
index dd2f1223f2f2..b514566de3e5 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.HttpHealthCheckStub;
@@ -43,7 +46,7 @@
*
* try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
- * Operation response = httpHealthCheckClient.deleteHttpHealthCheck(httpHealthCheck);
+ * HttpHealthCheck2 response = httpHealthCheckClient.getHttpHealthCheck(httpHealthCheck);
* }
*
*
@@ -104,6 +107,7 @@
public class HttpHealthCheckClient implements BackgroundResource {
private final HttpHealthCheckSettings settings;
private final HttpHealthCheckStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of HttpHealthCheckClient with default settings. */
public static final HttpHealthCheckClient create() throws IOException {
@@ -136,12 +140,14 @@ public static final HttpHealthCheckClient create(HttpHealthCheckStub stub) {
protected HttpHealthCheckClient(HttpHealthCheckSettings settings) throws IOException {
this.settings = settings;
this.stub = ((HttpHealthCheckStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected HttpHealthCheckClient(HttpHealthCheckStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final HttpHealthCheckSettings getSettings() {
@@ -153,6 +159,16 @@ public HttpHealthCheckStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified HttpHealthCheck resource.
@@ -162,21 +178,23 @@ public HttpHealthCheckStub getStub() {
*
* try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
- * Operation response = httpHealthCheckClient.deleteHttpHealthCheck(httpHealthCheck);
+ * httpHealthCheckClient.deleteHttpHealthCheckAsync(httpHealthCheck).get();
* }
*
*
* @param httpHealthCheck Name of the HttpHealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHttpHealthCheck(ProjectGlobalHttpHealthCheckName httpHealthCheck) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpHealthCheckAsync(
+ ProjectGlobalHttpHealthCheckName httpHealthCheck) {
DeleteHttpHealthCheckHttpRequest request =
DeleteHttpHealthCheckHttpRequest.newBuilder()
.setHttpHealthCheck(httpHealthCheck == null ? null : httpHealthCheck.toString())
.build();
- return deleteHttpHealthCheck(request);
+ return deleteHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -188,19 +206,21 @@ public final Operation deleteHttpHealthCheck(ProjectGlobalHttpHealthCheckName ht
*
* try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
- * Operation response = httpHealthCheckClient.deleteHttpHealthCheck(httpHealthCheck.toString());
+ * httpHealthCheckClient.deleteHttpHealthCheckAsync(httpHealthCheck.toString()).get();
* }
*
*
* @param httpHealthCheck Name of the HttpHealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHttpHealthCheck(String httpHealthCheck) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpHealthCheckAsync(
+ String httpHealthCheck) {
DeleteHttpHealthCheckHttpRequest request =
DeleteHttpHealthCheckHttpRequest.newBuilder().setHttpHealthCheck(httpHealthCheck).build();
- return deleteHttpHealthCheck(request);
+ return deleteHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -215,16 +235,42 @@ public final Operation deleteHttpHealthCheck(String httpHealthCheck) {
* DeleteHttpHealthCheckHttpRequest request = DeleteHttpHealthCheckHttpRequest.newBuilder()
* .setHttpHealthCheck(httpHealthCheck.toString())
* .build();
- * Operation response = httpHealthCheckClient.deleteHttpHealthCheck(request);
+ * httpHealthCheckClient.deleteHttpHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation deleteHttpHealthCheck(DeleteHttpHealthCheckHttpRequest request) {
- return deleteHttpHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpHealthCheckAsync(
+ DeleteHttpHealthCheckHttpRequest request) {
+ return deleteHttpHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified HttpHealthCheck resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
+ * ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
+ * DeleteHttpHealthCheckHttpRequest request = DeleteHttpHealthCheckHttpRequest.newBuilder()
+ * .setHttpHealthCheck(httpHealthCheck.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpHealthCheckClient.deleteHttpHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteHttpHealthCheckOperationCallable() {
+ return stub.deleteHttpHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -241,7 +287,7 @@ public final Operation deleteHttpHealthCheck(DeleteHttpHealthCheckHttpRequest re
* .build();
* ApiFuture<Operation> future = httpHealthCheckClient.deleteHttpHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -365,7 +411,7 @@ public final HttpHealthCheck2 getHttpHealthCheck(GetHttpHealthCheckHttpRequest r
* try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
- * Operation response = httpHealthCheckClient.insertHttpHealthCheck(project, httpHealthCheckResource);
+ * httpHealthCheckClient.insertHttpHealthCheckAsync(project, httpHealthCheckResource).get();
* }
*
*
@@ -374,8 +420,9 @@ public final HttpHealthCheck2 getHttpHealthCheck(GetHttpHealthCheckHttpRequest r
* for how individual instances should be checked for health, via HTTP.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpHealthCheckAsync(
ProjectName project, HttpHealthCheck2 httpHealthCheckResource) {
InsertHttpHealthCheckHttpRequest request =
@@ -383,7 +430,7 @@ public final Operation insertHttpHealthCheck(
.setProject(project == null ? null : project.toString())
.setHttpHealthCheckResource(httpHealthCheckResource)
.build();
- return insertHttpHealthCheck(request);
+ return insertHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -397,7 +444,7 @@ public final Operation insertHttpHealthCheck(
* try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
- * Operation response = httpHealthCheckClient.insertHttpHealthCheck(project.toString(), httpHealthCheckResource);
+ * httpHealthCheckClient.insertHttpHealthCheckAsync(project.toString(), httpHealthCheckResource).get();
* }
*
*
@@ -406,8 +453,9 @@ public final Operation insertHttpHealthCheck(
* for how individual instances should be checked for health, via HTTP.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpHealthCheckAsync(
String project, HttpHealthCheck2 httpHealthCheckResource) {
InsertHttpHealthCheckHttpRequest request =
@@ -415,7 +463,7 @@ public final Operation insertHttpHealthCheck(
.setProject(project)
.setHttpHealthCheckResource(httpHealthCheckResource)
.build();
- return insertHttpHealthCheck(request);
+ return insertHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -433,16 +481,45 @@ public final Operation insertHttpHealthCheck(
* .setProject(project.toString())
* .setHttpHealthCheckResource(httpHealthCheckResource)
* .build();
- * Operation response = httpHealthCheckClient.insertHttpHealthCheck(request);
+ * httpHealthCheckClient.insertHttpHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation insertHttpHealthCheck(InsertHttpHealthCheckHttpRequest request) {
- return insertHttpHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpHealthCheckAsync(
+ InsertHttpHealthCheckHttpRequest request) {
+ return insertHttpHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a HttpHealthCheck resource in the specified project using the data included in the
+ * request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
+ * InsertHttpHealthCheckHttpRequest request = InsertHttpHealthCheckHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setHttpHealthCheckResource(httpHealthCheckResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpHealthCheckClient.insertHttpHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertHttpHealthCheckOperationCallable() {
+ return stub.insertHttpHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -462,7 +539,7 @@ public final Operation insertHttpHealthCheck(InsertHttpHealthCheckHttpRequest re
* .build();
* ApiFuture<Operation> future = httpHealthCheckClient.insertHttpHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -623,7 +700,7 @@ public final ListHttpHealthChecksPagedResponse listHttpHealthChecks(
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpHealthCheckClient.patchHttpHealthCheck(httpHealthCheck, httpHealthCheckResource, fieldMask);
+ * httpHealthCheckClient.patchHttpHealthCheckAsync(httpHealthCheck, httpHealthCheckResource, fieldMask).get();
* }
*
*
@@ -636,8 +713,9 @@ public final ListHttpHealthChecksPagedResponse listHttpHealthChecks(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpHealthCheckAsync(
ProjectGlobalHttpHealthCheckName httpHealthCheck,
HttpHealthCheck2 httpHealthCheckResource,
List fieldMask) {
@@ -648,7 +726,7 @@ public final Operation patchHttpHealthCheck(
.setHttpHealthCheckResource(httpHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHttpHealthCheck(request);
+ return patchHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -664,7 +742,7 @@ public final Operation patchHttpHealthCheck(
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpHealthCheckClient.patchHttpHealthCheck(httpHealthCheck.toString(), httpHealthCheckResource, fieldMask);
+ * httpHealthCheckClient.patchHttpHealthCheckAsync(httpHealthCheck.toString(), httpHealthCheckResource, fieldMask).get();
* }
*
*
@@ -677,8 +755,9 @@ public final Operation patchHttpHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpHealthCheckAsync(
String httpHealthCheck, HttpHealthCheck2 httpHealthCheckResource, List fieldMask) {
PatchHttpHealthCheckHttpRequest request =
@@ -687,7 +766,7 @@ public final Operation patchHttpHealthCheck(
.setHttpHealthCheckResource(httpHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHttpHealthCheck(request);
+ return patchHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -708,16 +787,48 @@ public final Operation patchHttpHealthCheck(
* .setHttpHealthCheckResource(httpHealthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = httpHealthCheckClient.patchHttpHealthCheck(request);
+ * httpHealthCheckClient.patchHttpHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation patchHttpHealthCheck(PatchHttpHealthCheckHttpRequest request) {
- return patchHttpHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpHealthCheckAsync(
+ PatchHttpHealthCheckHttpRequest request) {
+ return patchHttpHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HttpHealthCheck resource in the specified project using the data included in the
+ * request. This method supports PATCH semantics and uses the JSON merge patch format and
+ * processing rules.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
+ * ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
+ * HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * PatchHttpHealthCheckHttpRequest request = PatchHttpHealthCheckHttpRequest.newBuilder()
+ * .setHttpHealthCheck(httpHealthCheck.toString())
+ * .setHttpHealthCheckResource(httpHealthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpHealthCheckClient.patchHttpHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ patchHttpHealthCheckOperationCallable() {
+ return stub.patchHttpHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -740,7 +851,7 @@ public final Operation patchHttpHealthCheck(PatchHttpHealthCheckHttpRequest requ
* .build();
* ApiFuture<Operation> future = httpHealthCheckClient.patchHttpHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -762,7 +873,7 @@ public final Operation patchHttpHealthCheck(PatchHttpHealthCheckHttpRequest requ
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpHealthCheckClient.updateHttpHealthCheck(httpHealthCheck, httpHealthCheckResource, fieldMask);
+ * httpHealthCheckClient.updateHttpHealthCheckAsync(httpHealthCheck, httpHealthCheckResource, fieldMask).get();
* }
*
*
@@ -775,8 +886,9 @@ public final Operation patchHttpHealthCheck(PatchHttpHealthCheckHttpRequest requ
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpHealthCheckAsync(
ProjectGlobalHttpHealthCheckName httpHealthCheck,
HttpHealthCheck2 httpHealthCheckResource,
List fieldMask) {
@@ -787,7 +899,7 @@ public final Operation updateHttpHealthCheck(
.setHttpHealthCheckResource(httpHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHttpHealthCheck(request);
+ return updateHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -802,7 +914,7 @@ public final Operation updateHttpHealthCheck(
* ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
* HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpHealthCheckClient.updateHttpHealthCheck(httpHealthCheck.toString(), httpHealthCheckResource, fieldMask);
+ * httpHealthCheckClient.updateHttpHealthCheckAsync(httpHealthCheck.toString(), httpHealthCheckResource, fieldMask).get();
* }
*
*
@@ -815,8 +927,9 @@ public final Operation updateHttpHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHttpHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpHealthCheckAsync(
String httpHealthCheck, HttpHealthCheck2 httpHealthCheckResource, List fieldMask) {
UpdateHttpHealthCheckHttpRequest request =
@@ -825,7 +938,7 @@ public final Operation updateHttpHealthCheck(
.setHttpHealthCheckResource(httpHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHttpHealthCheck(request);
+ return updateHttpHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -845,16 +958,47 @@ public final Operation updateHttpHealthCheck(
* .setHttpHealthCheckResource(httpHealthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = httpHealthCheckClient.updateHttpHealthCheck(request);
+ * httpHealthCheckClient.updateHttpHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation updateHttpHealthCheck(UpdateHttpHealthCheckHttpRequest request) {
- return updateHttpHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpHealthCheckAsync(
+ UpdateHttpHealthCheckHttpRequest request) {
+ return updateHttpHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HttpHealthCheck resource in the specified project using the data included in the
+ * request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpHealthCheckClient httpHealthCheckClient = HttpHealthCheckClient.create()) {
+ * ProjectGlobalHttpHealthCheckName httpHealthCheck = ProjectGlobalHttpHealthCheckName.of("[PROJECT]", "[HTTP_HEALTH_CHECK]");
+ * HttpHealthCheck2 httpHealthCheckResource = HttpHealthCheck2.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * UpdateHttpHealthCheckHttpRequest request = UpdateHttpHealthCheckHttpRequest.newBuilder()
+ * .setHttpHealthCheck(httpHealthCheck.toString())
+ * .setHttpHealthCheckResource(httpHealthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpHealthCheckClient.updateHttpHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ updateHttpHealthCheckOperationCallable() {
+ return stub.updateHttpHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -876,7 +1020,7 @@ public final Operation updateHttpHealthCheck(UpdateHttpHealthCheckHttpRequest re
* .build();
* ApiFuture<Operation> future = httpHealthCheckClient.updateHttpHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckSettings.java
index f352d44fd012..d3c72cd9e928 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpHealthCheckSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteHttpHealthCheck to 30 seconds:
+ * example, to set the total timeout of getHttpHealthCheck to 30 seconds:
*
*
*
* HttpHealthCheckSettings.Builder httpHealthCheckSettingsBuilder =
* HttpHealthCheckSettings.newBuilder();
- * httpHealthCheckSettingsBuilder.deleteHttpHealthCheckSettings().getRetrySettings().toBuilder()
+ * httpHealthCheckSettingsBuilder.getHttpHealthCheckSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* HttpHealthCheckSettings httpHealthCheckSettings = httpHealthCheckSettingsBuilder.build();
*
@@ -69,6 +71,15 @@ public class HttpHealthCheckSettings extends ClientSettings
+ deleteHttpHealthCheckOperationSettings() {
+ return ((HttpHealthCheckStubSettings) getStubSettings())
+ .deleteHttpHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getHttpHealthCheck. */
public UnaryCallSettings
getHttpHealthCheckSettings() {
@@ -81,6 +92,15 @@ public class HttpHealthCheckSettings extends ClientSettings
+ insertHttpHealthCheckOperationSettings() {
+ return ((HttpHealthCheckStubSettings) getStubSettings())
+ .insertHttpHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listHttpHealthChecks. */
public PagedCallSettings<
ListHttpHealthChecksHttpRequest, HttpHealthCheckList, ListHttpHealthChecksPagedResponse>
@@ -94,12 +114,30 @@ public class HttpHealthCheckSettings extends ClientSettings
+ patchHttpHealthCheckOperationSettings() {
+ return ((HttpHealthCheckStubSettings) getStubSettings())
+ .patchHttpHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to updateHttpHealthCheck. */
public UnaryCallSettings
updateHttpHealthCheckSettings() {
return ((HttpHealthCheckStubSettings) getStubSettings()).updateHttpHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to updateHttpHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings
+ updateHttpHealthCheckOperationSettings() {
+ return ((HttpHealthCheckStubSettings) getStubSettings())
+ .updateHttpHealthCheckOperationSettings();
+ }
+
public static final HttpHealthCheckSettings create(HttpHealthCheckStubSettings stub)
throws IOException {
return new HttpHealthCheckSettings.Builder(stub.toBuilder()).build();
@@ -208,6 +246,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().deleteHttpHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to deleteHttpHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ deleteHttpHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().deleteHttpHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to getHttpHealthCheck. */
public UnaryCallSettings.Builder
getHttpHealthCheckSettings() {
@@ -220,6 +266,14 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().insertHttpHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to insertHttpHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ insertHttpHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().insertHttpHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to listHttpHealthChecks. */
public PagedCallSettings.Builder<
ListHttpHealthChecksHttpRequest, HttpHealthCheckList, ListHttpHealthChecksPagedResponse>
@@ -233,12 +287,28 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().patchHttpHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to patchHttpHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ patchHttpHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().patchHttpHealthCheckOperationSettings();
+ }
+
/** Returns the builder for the settings used for calls to updateHttpHealthCheck. */
public UnaryCallSettings.Builder
updateHttpHealthCheckSettings() {
return getStubSettingsBuilder().updateHttpHealthCheckSettings();
}
+ /** Returns the builder for the settings used for calls to updateHttpHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings.Builder
+ updateHttpHealthCheckOperationSettings() {
+ return getStubSettingsBuilder().updateHttpHealthCheckOperationSettings();
+ }
+
@Override
public HttpHealthCheckSettings build() throws IOException {
return new HttpHealthCheckSettings(this);
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckClient.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckClient.java
index 7fcf330f460b..ed2f564546eb 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckClient.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckClient.java
@@ -20,9 +20,12 @@
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.EmptyMessage;
+import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.compute.v1.stub.HttpsHealthCheckStub;
@@ -43,7 +46,7 @@
*
* try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
- * Operation response = httpsHealthCheckClient.deleteHttpsHealthCheck(httpsHealthCheck);
+ * HttpsHealthCheck2 response = httpsHealthCheckClient.getHttpsHealthCheck(httpsHealthCheck);
* }
*
*
@@ -104,6 +107,7 @@
public class HttpsHealthCheckClient implements BackgroundResource {
private final HttpsHealthCheckSettings settings;
private final HttpsHealthCheckStub stub;
+ private final GlobalOperationClient operationsClient;
/** Constructs an instance of HttpsHealthCheckClient with default settings. */
public static final HttpsHealthCheckClient create() throws IOException {
@@ -136,12 +140,14 @@ public static final HttpsHealthCheckClient create(HttpsHealthCheckStub stub) {
protected HttpsHealthCheckClient(HttpsHealthCheckSettings settings) throws IOException {
this.settings = settings;
this.stub = ((HttpsHealthCheckStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
protected HttpsHealthCheckClient(HttpsHealthCheckStub stub) {
this.settings = null;
this.stub = stub;
+ this.operationsClient = GlobalOperationClient.create(this.stub.getOperationsStub());
}
public final HttpsHealthCheckSettings getSettings() {
@@ -153,6 +159,16 @@ public HttpsHealthCheckStub getStub() {
return stub;
}
+ /**
+ * Returns the GlobalOperationClient that can be used to query the status of a long-running
+ * operation returned by another API method call.
+ */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final GlobalOperationClient getOperationsClient() {
+ return operationsClient;
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes the specified HttpsHealthCheck resource.
@@ -162,22 +178,23 @@ public HttpsHealthCheckStub getStub() {
*
* try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
- * Operation response = httpsHealthCheckClient.deleteHttpsHealthCheck(httpsHealthCheck);
+ * httpsHealthCheckClient.deleteHttpsHealthCheckAsync(httpsHealthCheck).get();
* }
*
*
* @param httpsHealthCheck Name of the HttpsHealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpsHealthCheckAsync(
ProjectGlobalHttpsHealthCheckName httpsHealthCheck) {
DeleteHttpsHealthCheckHttpRequest request =
DeleteHttpsHealthCheckHttpRequest.newBuilder()
.setHttpsHealthCheck(httpsHealthCheck == null ? null : httpsHealthCheck.toString())
.build();
- return deleteHttpsHealthCheck(request);
+ return deleteHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -189,21 +206,23 @@ public final Operation deleteHttpsHealthCheck(
*
* try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
- * Operation response = httpsHealthCheckClient.deleteHttpsHealthCheck(httpsHealthCheck.toString());
+ * httpsHealthCheckClient.deleteHttpsHealthCheckAsync(httpsHealthCheck.toString()).get();
* }
*
*
* @param httpsHealthCheck Name of the HttpsHealthCheck resource to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation deleteHttpsHealthCheck(String httpsHealthCheck) {
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpsHealthCheckAsync(
+ String httpsHealthCheck) {
DeleteHttpsHealthCheckHttpRequest request =
DeleteHttpsHealthCheckHttpRequest.newBuilder()
.setHttpsHealthCheck(httpsHealthCheck)
.build();
- return deleteHttpsHealthCheck(request);
+ return deleteHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -218,16 +237,42 @@ public final Operation deleteHttpsHealthCheck(String httpsHealthCheck) {
* DeleteHttpsHealthCheckHttpRequest request = DeleteHttpsHealthCheckHttpRequest.newBuilder()
* .setHttpsHealthCheck(httpsHealthCheck.toString())
* .build();
- * Operation response = httpsHealthCheckClient.deleteHttpsHealthCheck(request);
+ * httpsHealthCheckClient.deleteHttpsHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation deleteHttpsHealthCheck(DeleteHttpsHealthCheckHttpRequest request) {
- return deleteHttpsHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture deleteHttpsHealthCheckAsync(
+ DeleteHttpsHealthCheckHttpRequest request) {
+ return deleteHttpsHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Deletes the specified HttpsHealthCheck resource.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
+ * ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
+ * DeleteHttpsHealthCheckHttpRequest request = DeleteHttpsHealthCheckHttpRequest.newBuilder()
+ * .setHttpsHealthCheck(httpsHealthCheck.toString())
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpsHealthCheckClient.deleteHttpsHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ deleteHttpsHealthCheckOperationCallable() {
+ return stub.deleteHttpsHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -244,7 +289,7 @@ public final Operation deleteHttpsHealthCheck(DeleteHttpsHealthCheckHttpRequest
* .build();
* ApiFuture<Operation> future = httpsHealthCheckClient.deleteHttpsHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -368,7 +413,7 @@ public final HttpsHealthCheck2 getHttpsHealthCheck(GetHttpsHealthCheckHttpReques
* try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
- * Operation response = httpsHealthCheckClient.insertHttpsHealthCheck(project, httpsHealthCheckResource);
+ * httpsHealthCheckClient.insertHttpsHealthCheckAsync(project, httpsHealthCheckResource).get();
* }
*
*
@@ -377,8 +422,9 @@ public final HttpsHealthCheck2 getHttpsHealthCheck(GetHttpsHealthCheckHttpReques
* for how individual instances should be checked for health, via HTTPS.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpsHealthCheckAsync(
ProjectName project, HttpsHealthCheck2 httpsHealthCheckResource) {
InsertHttpsHealthCheckHttpRequest request =
@@ -386,7 +432,7 @@ public final Operation insertHttpsHealthCheck(
.setProject(project == null ? null : project.toString())
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.build();
- return insertHttpsHealthCheck(request);
+ return insertHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -400,7 +446,7 @@ public final Operation insertHttpsHealthCheck(
* try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
* ProjectName project = ProjectName.of("[PROJECT]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
- * Operation response = httpsHealthCheckClient.insertHttpsHealthCheck(project.toString(), httpsHealthCheckResource);
+ * httpsHealthCheckClient.insertHttpsHealthCheckAsync(project.toString(), httpsHealthCheckResource).get();
* }
*
*
@@ -409,8 +455,9 @@ public final Operation insertHttpsHealthCheck(
* for how individual instances should be checked for health, via HTTPS.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation insertHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpsHealthCheckAsync(
String project, HttpsHealthCheck2 httpsHealthCheckResource) {
InsertHttpsHealthCheckHttpRequest request =
@@ -418,7 +465,7 @@ public final Operation insertHttpsHealthCheck(
.setProject(project)
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.build();
- return insertHttpsHealthCheck(request);
+ return insertHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -436,16 +483,45 @@ public final Operation insertHttpsHealthCheck(
* .setProject(project.toString())
* .setHttpsHealthCheckResource(httpsHealthCheckResource)
* .build();
- * Operation response = httpsHealthCheckClient.insertHttpsHealthCheck(request);
+ * httpsHealthCheckClient.insertHttpsHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation insertHttpsHealthCheck(InsertHttpsHealthCheckHttpRequest request) {
- return insertHttpsHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture insertHttpsHealthCheckAsync(
+ InsertHttpsHealthCheckHttpRequest request) {
+ return insertHttpsHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Creates a HttpsHealthCheck resource in the specified project using the data included in the
+ * request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
+ * ProjectName project = ProjectName.of("[PROJECT]");
+ * HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
+ * InsertHttpsHealthCheckHttpRequest request = InsertHttpsHealthCheckHttpRequest.newBuilder()
+ * .setProject(project.toString())
+ * .setHttpsHealthCheckResource(httpsHealthCheckResource)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpsHealthCheckClient.insertHttpsHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ insertHttpsHealthCheckOperationCallable() {
+ return stub.insertHttpsHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -465,7 +541,7 @@ public final Operation insertHttpsHealthCheck(InsertHttpsHealthCheckHttpRequest
* .build();
* ApiFuture<Operation> future = httpsHealthCheckClient.insertHttpsHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -626,7 +702,7 @@ public final ListHttpsHealthChecksPagedResponse listHttpsHealthChecks(
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpsHealthCheckClient.patchHttpsHealthCheck(httpsHealthCheck, httpsHealthCheckResource, fieldMask);
+ * httpsHealthCheckClient.patchHttpsHealthCheckAsync(httpsHealthCheck, httpsHealthCheckResource, fieldMask).get();
* }
*
*
@@ -639,8 +715,9 @@ public final ListHttpsHealthChecksPagedResponse listHttpsHealthChecks(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpsHealthCheckAsync(
ProjectGlobalHttpsHealthCheckName httpsHealthCheck,
HttpsHealthCheck2 httpsHealthCheckResource,
List fieldMask) {
@@ -651,7 +728,7 @@ public final Operation patchHttpsHealthCheck(
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHttpsHealthCheck(request);
+ return patchHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -667,7 +744,7 @@ public final Operation patchHttpsHealthCheck(
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpsHealthCheckClient.patchHttpsHealthCheck(httpsHealthCheck.toString(), httpsHealthCheckResource, fieldMask);
+ * httpsHealthCheckClient.patchHttpsHealthCheckAsync(httpsHealthCheck.toString(), httpsHealthCheckResource, fieldMask).get();
* }
*
*
@@ -680,8 +757,9 @@ public final Operation patchHttpsHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation patchHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpsHealthCheckAsync(
String httpsHealthCheck, HttpsHealthCheck2 httpsHealthCheckResource, List fieldMask) {
PatchHttpsHealthCheckHttpRequest request =
@@ -690,7 +768,7 @@ public final Operation patchHttpsHealthCheck(
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return patchHttpsHealthCheck(request);
+ return patchHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -711,16 +789,48 @@ public final Operation patchHttpsHealthCheck(
* .setHttpsHealthCheckResource(httpsHealthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = httpsHealthCheckClient.patchHttpsHealthCheck(request);
+ * httpsHealthCheckClient.patchHttpsHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation patchHttpsHealthCheck(PatchHttpsHealthCheckHttpRequest request) {
- return patchHttpsHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture patchHttpsHealthCheckAsync(
+ PatchHttpsHealthCheckHttpRequest request) {
+ return patchHttpsHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HttpsHealthCheck resource in the specified project using the data included in the
+ * request. This method supports PATCH semantics and uses the JSON merge patch format and
+ * processing rules.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
+ * ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
+ * HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * PatchHttpsHealthCheckHttpRequest request = PatchHttpsHealthCheckHttpRequest.newBuilder()
+ * .setHttpsHealthCheck(httpsHealthCheck.toString())
+ * .setHttpsHealthCheckResource(httpsHealthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpsHealthCheckClient.patchHttpsHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ patchHttpsHealthCheckOperationCallable() {
+ return stub.patchHttpsHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -743,7 +853,7 @@ public final Operation patchHttpsHealthCheck(PatchHttpsHealthCheckHttpRequest re
* .build();
* ApiFuture<Operation> future = httpsHealthCheckClient.patchHttpsHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
@@ -765,7 +875,7 @@ public final Operation patchHttpsHealthCheck(PatchHttpsHealthCheckHttpRequest re
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpsHealthCheckClient.updateHttpsHealthCheck(httpsHealthCheck, httpsHealthCheckResource, fieldMask);
+ * httpsHealthCheckClient.updateHttpsHealthCheckAsync(httpsHealthCheck, httpsHealthCheckResource, fieldMask).get();
* }
*
*
@@ -778,8 +888,9 @@ public final Operation patchHttpsHealthCheck(PatchHttpsHealthCheckHttpRequest re
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpsHealthCheckAsync(
ProjectGlobalHttpsHealthCheckName httpsHealthCheck,
HttpsHealthCheck2 httpsHealthCheckResource,
List fieldMask) {
@@ -790,7 +901,7 @@ public final Operation updateHttpsHealthCheck(
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHttpsHealthCheck(request);
+ return updateHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -805,7 +916,7 @@ public final Operation updateHttpsHealthCheck(
* ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
* HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
* List<String> fieldMask = new ArrayList<>();
- * Operation response = httpsHealthCheckClient.updateHttpsHealthCheck(httpsHealthCheck.toString(), httpsHealthCheckResource, fieldMask);
+ * httpsHealthCheckClient.updateHttpsHealthCheckAsync(httpsHealthCheck.toString(), httpsHealthCheckResource, fieldMask).get();
* }
*
*
@@ -818,8 +929,9 @@ public final Operation updateHttpsHealthCheck(
* not have a fieldmask, then only non-empty fields will be serialized.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi
- public final Operation updateHttpsHealthCheck(
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpsHealthCheckAsync(
String httpsHealthCheck, HttpsHealthCheck2 httpsHealthCheckResource, List fieldMask) {
UpdateHttpsHealthCheckHttpRequest request =
@@ -828,7 +940,7 @@ public final Operation updateHttpsHealthCheck(
.setHttpsHealthCheckResource(httpsHealthCheckResource)
.addAllFieldMask(fieldMask)
.build();
- return updateHttpsHealthCheck(request);
+ return updateHttpsHealthCheckAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -848,16 +960,47 @@ public final Operation updateHttpsHealthCheck(
* .setHttpsHealthCheckResource(httpsHealthCheckResource)
* .addAllFieldMask(fieldMask)
* .build();
- * Operation response = httpsHealthCheckClient.updateHttpsHealthCheck(request);
+ * httpsHealthCheckClient.updateHttpsHealthCheckAsync(request).get();
* }
*
*
* @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
- public final Operation updateHttpsHealthCheck(UpdateHttpsHealthCheckHttpRequest request) {
- return updateHttpsHealthCheckCallable().call(request);
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public final OperationFuture updateHttpsHealthCheckAsync(
+ UpdateHttpsHealthCheckHttpRequest request) {
+ return updateHttpsHealthCheckOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD
+ /**
+ * Updates a HttpsHealthCheck resource in the specified project using the data included in the
+ * request.
+ *
+ * Sample code:
+ *
+ *
+ * try (HttpsHealthCheckClient httpsHealthCheckClient = HttpsHealthCheckClient.create()) {
+ * ProjectGlobalHttpsHealthCheckName httpsHealthCheck = ProjectGlobalHttpsHealthCheckName.of("[PROJECT]", "[HTTPS_HEALTH_CHECK]");
+ * HttpsHealthCheck2 httpsHealthCheckResource = HttpsHealthCheck2.newBuilder().build();
+ * List<String> fieldMask = new ArrayList<>();
+ * UpdateHttpsHealthCheckHttpRequest request = UpdateHttpsHealthCheckHttpRequest.newBuilder()
+ * .setHttpsHealthCheck(httpsHealthCheck.toString())
+ * .setHttpsHealthCheckResource(httpsHealthCheckResource)
+ * .addAllFieldMask(fieldMask)
+ * .build();
+ * OperationFuture<EmptyMessage, Operation> future = httpsHealthCheckClient.updateHttpsHealthCheckOperationCallable().futureCall(request);
+ * // Do something
+ * future.get();
+ * }
+ *
+ */
+ @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
+ public final OperationCallable
+ updateHttpsHealthCheckOperationCallable() {
+ return stub.updateHttpsHealthCheckOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD
@@ -879,7 +1022,7 @@ public final Operation updateHttpsHealthCheck(UpdateHttpsHealthCheckHttpRequest
* .build();
* ApiFuture<Operation> future = httpsHealthCheckClient.updateHttpsHealthCheckCallable().futureCall(request);
* // Do something
- * Operation response = future.get();
+ * future.get();
* }
*
*/
diff --git a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckSettings.java b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckSettings.java
index 9451ef907783..2990b4ab6402 100644
--- a/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckSettings.java
+++ b/google-cloud-clients/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HttpsHealthCheckSettings.java
@@ -21,10 +21,12 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.httpjson.EmptyMessage;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
@@ -48,13 +50,13 @@
*
* 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. For
- * example, to set the total timeout of deleteHttpsHealthCheck to 30 seconds:
+ * example, to set the total timeout of getHttpsHealthCheck to 30 seconds:
*
*
*
* HttpsHealthCheckSettings.Builder httpsHealthCheckSettingsBuilder =
* HttpsHealthCheckSettings.newBuilder();
- * httpsHealthCheckSettingsBuilder.deleteHttpsHealthCheckSettings().getRetrySettings().toBuilder()
+ * httpsHealthCheckSettingsBuilder.getHttpsHealthCheckSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30));
* HttpsHealthCheckSettings httpsHealthCheckSettings = httpsHealthCheckSettingsBuilder.build();
*
@@ -69,6 +71,15 @@ public class HttpsHealthCheckSettings extends ClientSettings
+ deleteHttpsHealthCheckOperationSettings() {
+ return ((HttpsHealthCheckStubSettings) getStubSettings())
+ .deleteHttpsHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to getHttpsHealthCheck. */
public UnaryCallSettings
getHttpsHealthCheckSettings() {
@@ -81,6 +92,15 @@ public class HttpsHealthCheckSettings extends ClientSettings
+ insertHttpsHealthCheckOperationSettings() {
+ return ((HttpsHealthCheckStubSettings) getStubSettings())
+ .insertHttpsHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to listHttpsHealthChecks. */
public PagedCallSettings<
ListHttpsHealthChecksHttpRequest,
@@ -96,12 +116,30 @@ public class HttpsHealthCheckSettings extends ClientSettings
+ patchHttpsHealthCheckOperationSettings() {
+ return ((HttpsHealthCheckStubSettings) getStubSettings())
+ .patchHttpsHealthCheckOperationSettings();
+ }
+
/** Returns the object with the settings used for calls to updateHttpsHealthCheck. */
public UnaryCallSettings
updateHttpsHealthCheckSettings() {
return ((HttpsHealthCheckStubSettings) getStubSettings()).updateHttpsHealthCheckSettings();
}
+ /** Returns the object with the settings used for calls to updateHttpsHealthCheck. */
+ @BetaApi(
+ "The surface for long-running operations is not stable yet and may change in the future.")
+ public OperationCallSettings