diff --git a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java index b1b18c72..79b81c85 100644 --- a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java +++ b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java @@ -76,6 +76,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+ *   String projectId = "projectId-894832108";
+ *   String id = "id3355";
+ *   Build response = cloudBuildClient.getBuild(projectId, id);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CloudBuildClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -191,6 +199,16 @@ public final OperationsClient getOperationsClient() { *

This method returns a long-running `Operation`, which includes the build ID. Pass the build * ID to `GetBuild` to determine the build status (such as `SUCCESS` or `FAILURE`). * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   Build build = Build.newBuilder().build();
+   *   Build response = cloudBuildClient.createBuildAsync(projectId, build).get();
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param build Required. Build resource to create. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -209,6 +227,20 @@ public final OperationFuture createBuildAsync( *

This method returns a long-running `Operation`, which includes the build ID. Pass the build * ID to `GetBuild` to determine the build status (such as `SUCCESS` or `FAILURE`). * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateBuildRequest request =
+   *       CreateBuildRequest.newBuilder()
+   *           .setParent(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setBuild(Build.newBuilder().build())
+   *           .build();
+   *   Build response = cloudBuildClient.createBuildAsync(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 */ @@ -225,6 +257,21 @@ public final OperationFuture createBuildAsync( * ID to `GetBuild` to determine the build status (such as `SUCCESS` or `FAILURE`). * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateBuildRequest request =
+   *       CreateBuildRequest.newBuilder()
+   *           .setParent(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setBuild(Build.newBuilder().build())
+   *           .build();
+   *   OperationFuture future =
+   *       cloudBuildClient.createBuildOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Build response = future.get();
+   * }
+   * }
*/ public final OperationCallable createBuildOperationCallable() { @@ -239,6 +286,20 @@ public final OperationFuture createBuildAsync( * ID to `GetBuild` to determine the build status (such as `SUCCESS` or `FAILURE`). * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateBuildRequest request =
+   *       CreateBuildRequest.newBuilder()
+   *           .setParent(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setBuild(Build.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.createBuildCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createBuildCallable() { return stub.createBuildCallable(); @@ -251,6 +312,16 @@ public final UnaryCallable createBuildCallable() *

The `Build` that is returned includes its status (such as `SUCCESS`, `FAILURE`, or * `WORKING`), and timing information. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String id = "id3355";
+   *   Build response = cloudBuildClient.getBuild(projectId, id);
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param id Required. ID of the build. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -268,6 +339,20 @@ public final Build getBuild(String projectId, String id) { *

The `Build` that is returned includes its status (such as `SUCCESS`, `FAILURE`, or * `WORKING`), and timing information. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetBuildRequest request =
+   *       GetBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   Build response = cloudBuildClient.getBuild(request);
+   * }
+   * }
+ * * @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 */ @@ -283,6 +368,20 @@ public final Build getBuild(GetBuildRequest request) { * `WORKING`), and timing information. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetBuildRequest request =
+   *       GetBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.getBuildCallable().futureCall(request);
+   *   // Do something.
+   *   Build response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getBuildCallable() { return stub.getBuildCallable(); @@ -295,6 +394,18 @@ public final UnaryCallable getBuildCallable() { *

Previously requested builds may still be in-progress, or may have finished successfully or * unsuccessfully. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String filter = "filter-1274492040";
+   *   for (Build element : cloudBuildClient.listBuilds(projectId, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param filter The raw filter text to constrain the results. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -312,6 +423,24 @@ public final ListBuildsPagedResponse listBuilds(String projectId, String filter) *

Previously requested builds may still be in-progress, or may have finished successfully or * unsuccessfully. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListBuildsRequest request =
+   *       ListBuildsRequest.newBuilder()
+   *           .setParent(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .build();
+   *   for (Build element : cloudBuildClient.listBuilds(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -327,6 +456,24 @@ public final ListBuildsPagedResponse listBuilds(ListBuildsRequest request) { * unsuccessfully. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListBuildsRequest request =
+   *       ListBuildsRequest.newBuilder()
+   *           .setParent(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.listBuildsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Build element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listBuildsPagedCallable() { return stub.listBuildsPagedCallable(); @@ -340,6 +487,23 @@ public final UnaryCallable listBuild * unsuccessfully. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   while (true) {
+   *     ListBuildsResponse response = cloudBuildClient.listBuildsCallable().call(request);
+   *     for (Build element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listBuildsCallable() { return stub.listBuildsCallable(); @@ -349,6 +513,16 @@ public final UnaryCallable listBuildsCall /** * Cancels a build in progress. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String id = "id3355";
+   *   Build response = cloudBuildClient.cancelBuild(projectId, id);
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param id Required. ID of the build. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -363,6 +537,20 @@ public final Build cancelBuild(String projectId, String id) { /** * Cancels a build in progress. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CancelBuildRequest request =
+   *       CancelBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   Build response = cloudBuildClient.cancelBuild(request);
+   * }
+   * }
+ * * @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 */ @@ -375,6 +563,20 @@ public final Build cancelBuild(CancelBuildRequest request) { * Cancels a build in progress. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CancelBuildRequest request =
+   *       CancelBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.cancelBuildCallable().futureCall(request);
+   *   // Do something.
+   *   Build response = future.get();
+   * }
+   * }
*/ public final UnaryCallable cancelBuildCallable() { return stub.cancelBuildCallable(); @@ -414,6 +616,16 @@ public final UnaryCallable cancelBuildCallable() { * available depending on the bucket's lifecycle management settings. * * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String id = "id3355";
+   *   Build response = cloudBuildClient.retryBuildAsync(projectId, id).get();
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param id Required. Build ID of the original build. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -459,6 +671,20 @@ public final OperationFuture retryBuildAsync( * available depending on the bucket's lifecycle management settings. * * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RetryBuildRequest request =
+   *       RetryBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   Build response = cloudBuildClient.retryBuildAsync(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 */ @@ -502,6 +728,21 @@ public final OperationFuture retryBuildAsync( * * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RetryBuildRequest request =
+   *       RetryBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   OperationFuture future =
+   *       cloudBuildClient.retryBuildOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Build response = future.get();
+   * }
+   * }
*/ public final OperationCallable retryBuildOperationCallable() { @@ -543,6 +784,20 @@ public final OperationFuture retryBuildAsync( * * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RetryBuildRequest request =
+   *       RetryBuildRequest.newBuilder()
+   *           .setName(BuildName.ofProjectBuildName("[PROJECT]", "[BUILD]").toString())
+   *           .setProjectId("projectId-894832108")
+   *           .setId("id3355")
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.retryBuildCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable retryBuildCallable() { return stub.retryBuildCallable(); @@ -554,6 +809,16 @@ public final UnaryCallable retryBuildCallable() { * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   BuildTrigger trigger = BuildTrigger.newBuilder().build();
+   *   BuildTrigger response = cloudBuildClient.createBuildTrigger(projectId, trigger);
+   * }
+   * }
+ * * @param projectId Required. ID of the project for which to configure automatic builds. * @param trigger Required. `BuildTrigger` to create. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -570,6 +835,19 @@ public final BuildTrigger createBuildTrigger(String projectId, BuildTrigger trig * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateBuildTriggerRequest request =
+   *       CreateBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTrigger(BuildTrigger.newBuilder().build())
+   *           .build();
+   *   BuildTrigger response = cloudBuildClient.createBuildTrigger(request);
+   * }
+   * }
+ * * @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 */ @@ -584,6 +862,20 @@ public final BuildTrigger createBuildTrigger(CreateBuildTriggerRequest request) *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateBuildTriggerRequest request =
+   *       CreateBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTrigger(BuildTrigger.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.createBuildTriggerCallable().futureCall(request);
+   *   // Do something.
+   *   BuildTrigger response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createBuildTriggerCallable() { return stub.createBuildTriggerCallable(); @@ -595,6 +887,16 @@ public final UnaryCallable createBuildT * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String triggerId = "triggerId-648752909";
+   *   BuildTrigger response = cloudBuildClient.getBuildTrigger(projectId, triggerId);
+   * }
+   * }
+ * * @param projectId Required. ID of the project that owns the trigger. * @param triggerId Required. Identifier (`id` or `name`) of the `BuildTrigger` to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -611,6 +913,19 @@ public final BuildTrigger getBuildTrigger(String projectId, String triggerId) { * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetBuildTriggerRequest request =
+   *       GetBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .build();
+   *   BuildTrigger response = cloudBuildClient.getBuildTrigger(request);
+   * }
+   * }
+ * * @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 */ @@ -625,6 +940,20 @@ public final BuildTrigger getBuildTrigger(GetBuildTriggerRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetBuildTriggerRequest request =
+   *       GetBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.getBuildTriggerCallable().futureCall(request);
+   *   // Do something.
+   *   BuildTrigger response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getBuildTriggerCallable() { return stub.getBuildTriggerCallable(); @@ -636,6 +965,17 @@ public final UnaryCallable getBuildTrigger * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   for (BuildTrigger element : cloudBuildClient.listBuildTriggers(projectId).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param projectId Required. ID of the project for which to list BuildTriggers. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -651,6 +991,22 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(String projectId) * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListBuildTriggersRequest request =
+   *       ListBuildTriggersRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (BuildTrigger element : cloudBuildClient.listBuildTriggers(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @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 */ @@ -665,6 +1021,23 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(ListBuildTriggersR *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListBuildTriggersRequest request =
+   *       ListBuildTriggersRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.listBuildTriggersPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (BuildTrigger element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listBuildTriggersPagedCallable() { @@ -678,6 +1051,24 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(ListBuildTriggersR *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   while (true) {
+   *     ListBuildTriggersResponse response =
+   *         cloudBuildClient.listBuildTriggersCallable().call(request);
+   *     for (BuildTrigger element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listBuildTriggersCallable() { @@ -690,6 +1081,16 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(ListBuildTriggersR * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String triggerId = "triggerId-648752909";
+   *   cloudBuildClient.deleteBuildTrigger(projectId, triggerId);
+   * }
+   * }
+ * * @param projectId Required. ID of the project that owns the trigger. * @param triggerId Required. ID of the `BuildTrigger` to delete. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -709,6 +1110,19 @@ public final void deleteBuildTrigger(String projectId, String triggerId) { * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   DeleteBuildTriggerRequest request =
+   *       DeleteBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .build();
+   *   cloudBuildClient.deleteBuildTrigger(request);
+   * }
+   * }
+ * * @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 */ @@ -723,6 +1137,19 @@ public final void deleteBuildTrigger(DeleteBuildTriggerRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   DeleteBuildTriggerRequest request =
+   *       DeleteBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.deleteBuildTriggerCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteBuildTriggerCallable() { return stub.deleteBuildTriggerCallable(); @@ -734,6 +1161,17 @@ public final UnaryCallable deleteBuildTriggerC * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String triggerId = "triggerId-648752909";
+   *   BuildTrigger trigger = BuildTrigger.newBuilder().build();
+   *   BuildTrigger response = cloudBuildClient.updateBuildTrigger(projectId, triggerId, trigger);
+   * }
+   * }
+ * * @param projectId Required. ID of the project that owns the trigger. * @param triggerId Required. ID of the `BuildTrigger` to update. * @param trigger Required. `BuildTrigger` to update. @@ -756,6 +1194,20 @@ public final BuildTrigger updateBuildTrigger( * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   UpdateBuildTriggerRequest request =
+   *       UpdateBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .setTrigger(BuildTrigger.newBuilder().build())
+   *           .build();
+   *   BuildTrigger response = cloudBuildClient.updateBuildTrigger(request);
+   * }
+   * }
+ * * @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 */ @@ -770,6 +1222,21 @@ public final BuildTrigger updateBuildTrigger(UpdateBuildTriggerRequest request) *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   UpdateBuildTriggerRequest request =
+   *       UpdateBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .setTrigger(BuildTrigger.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.updateBuildTriggerCallable().futureCall(request);
+   *   // Do something.
+   *   BuildTrigger response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateBuildTriggerCallable() { return stub.updateBuildTriggerCallable(); @@ -779,6 +1246,17 @@ public final UnaryCallable updateBuildT /** * Runs a `BuildTrigger` at a particular source revision. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   String projectId = "projectId-894832108";
+   *   String triggerId = "triggerId-648752909";
+   *   RepoSource source = RepoSource.newBuilder().build();
+   *   Build response = cloudBuildClient.runBuildTriggerAsync(projectId, triggerId, source).get();
+   * }
+   * }
+ * * @param projectId Required. ID of the project. * @param triggerId Required. ID of the trigger. * @param source Required. Source to build against this trigger. @@ -799,6 +1277,20 @@ public final OperationFuture runBuildTriggerAsync /** * Runs a `BuildTrigger` at a particular source revision. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RunBuildTriggerRequest request =
+   *       RunBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .setSource(RepoSource.newBuilder().build())
+   *           .build();
+   *   Build response = cloudBuildClient.runBuildTriggerAsync(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 */ @@ -812,6 +1304,21 @@ public final OperationFuture runBuildTriggerAsync * Runs a `BuildTrigger` at a particular source revision. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RunBuildTriggerRequest request =
+   *       RunBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .setSource(RepoSource.newBuilder().build())
+   *           .build();
+   *   OperationFuture future =
+   *       cloudBuildClient.runBuildTriggerOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Build response = future.get();
+   * }
+   * }
*/ public final OperationCallable runBuildTriggerOperationCallable() { @@ -823,6 +1330,20 @@ public final OperationFuture runBuildTriggerAsync * Runs a `BuildTrigger` at a particular source revision. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   RunBuildTriggerRequest request =
+   *       RunBuildTriggerRequest.newBuilder()
+   *           .setProjectId("projectId-894832108")
+   *           .setTriggerId("triggerId-648752909")
+   *           .setSource(RepoSource.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = cloudBuildClient.runBuildTriggerCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable runBuildTriggerCallable() { return stub.runBuildTriggerCallable(); @@ -834,6 +1355,19 @@ public final UnaryCallable runBuildTriggerCal * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateWorkerPoolRequest request =
+   *       CreateWorkerPoolRequest.newBuilder()
+   *           .setParent("parent-995424086")
+   *           .setWorkerPool(WorkerPool.newBuilder().build())
+   *           .build();
+   *   WorkerPool response = cloudBuildClient.createWorkerPool(request);
+   * }
+   * }
+ * * @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 */ @@ -848,6 +1382,20 @@ public final WorkerPool createWorkerPool(CreateWorkerPoolRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   CreateWorkerPoolRequest request =
+   *       CreateWorkerPoolRequest.newBuilder()
+   *           .setParent("parent-995424086")
+   *           .setWorkerPool(WorkerPool.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.createWorkerPoolCallable().futureCall(request);
+   *   // Do something.
+   *   WorkerPool response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createWorkerPoolCallable() { return stub.createWorkerPoolCallable(); @@ -859,6 +1407,16 @@ public final UnaryCallable createWorkerPool * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetWorkerPoolRequest request =
+   *       GetWorkerPoolRequest.newBuilder().setName("name3373707").build();
+   *   WorkerPool response = cloudBuildClient.getWorkerPool(request);
+   * }
+   * }
+ * * @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 */ @@ -873,6 +1431,16 @@ public final WorkerPool getWorkerPool(GetWorkerPoolRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   GetWorkerPoolRequest request =
+   *       GetWorkerPoolRequest.newBuilder().setName("name3373707").build();
+   *   ApiFuture future = cloudBuildClient.getWorkerPoolCallable().futureCall(request);
+   *   // Do something.
+   *   WorkerPool response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getWorkerPoolCallable() { return stub.getWorkerPoolCallable(); @@ -884,6 +1452,16 @@ public final UnaryCallable getWorkerPoolCallab * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   DeleteWorkerPoolRequest request =
+   *       DeleteWorkerPoolRequest.newBuilder().setName("name3373707").build();
+   *   cloudBuildClient.deleteWorkerPool(request);
+   * }
+   * }
+ * * @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 */ @@ -898,6 +1476,16 @@ public final void deleteWorkerPool(DeleteWorkerPoolRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   DeleteWorkerPoolRequest request =
+   *       DeleteWorkerPoolRequest.newBuilder().setName("name3373707").build();
+   *   ApiFuture future = cloudBuildClient.deleteWorkerPoolCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteWorkerPoolCallable() { return stub.deleteWorkerPoolCallable(); @@ -909,6 +1497,19 @@ public final UnaryCallable deleteWorkerPoolCalla * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   UpdateWorkerPoolRequest request =
+   *       UpdateWorkerPoolRequest.newBuilder()
+   *           .setName("name3373707")
+   *           .setWorkerPool(WorkerPool.newBuilder().build())
+   *           .build();
+   *   WorkerPool response = cloudBuildClient.updateWorkerPool(request);
+   * }
+   * }
+ * * @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 */ @@ -923,6 +1524,20 @@ public final WorkerPool updateWorkerPool(UpdateWorkerPoolRequest request) { *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   UpdateWorkerPoolRequest request =
+   *       UpdateWorkerPoolRequest.newBuilder()
+   *           .setName("name3373707")
+   *           .setWorkerPool(WorkerPool.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       cloudBuildClient.updateWorkerPoolCallable().futureCall(request);
+   *   // Do something.
+   *   WorkerPool response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateWorkerPoolCallable() { return stub.updateWorkerPoolCallable(); @@ -934,6 +1549,16 @@ public final UnaryCallable updateWorkerPool * *

This API is experimental. * + *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListWorkerPoolsRequest request =
+   *       ListWorkerPoolsRequest.newBuilder().setParent("parent-995424086").build();
+   *   ListWorkerPoolsResponse response = cloudBuildClient.listWorkerPools(request);
+   * }
+   * }
+ * * @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 */ @@ -948,6 +1573,17 @@ public final ListWorkerPoolsResponse listWorkerPools(ListWorkerPoolsRequest requ *

This API is experimental. * *

Sample code: + * + *

{@code
+   * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+   *   ListWorkerPoolsRequest request =
+   *       ListWorkerPoolsRequest.newBuilder().setParent("parent-995424086").build();
+   *   ApiFuture future =
+   *       cloudBuildClient.listWorkerPoolsCallable().futureCall(request);
+   *   // Do something.
+   *   ListWorkerPoolsResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable listWorkerPoolsCallable() { diff --git a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/package-info.java b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/package-info.java index ef5a18bc..6dab9194 100644 --- a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/package-info.java +++ b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/package-info.java @@ -28,6 +28,14 @@ * of the build. * *

Sample for CloudBuildClient: + * + *

{@code
+ * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
+ *   String projectId = "projectId-894832108";
+ *   String id = "id3355";
+ *   Build response = cloudBuildClient.getBuild(projectId, id);
+ * }
+ * }
*/ @Generated("by gapic-generator-java") package com.google.cloud.devtools.cloudbuild.v1; diff --git a/synth.metadata b/synth.metadata index d9a9c736..12dc81b9 100644 --- a/synth.metadata +++ b/synth.metadata @@ -11,15 +11,15 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-cloudbuild.git", - "sha": "257ca7c299b27cb4ee1ef7199d35efb7edd49d58" + "sha": "70ff34260eb83249f1444d1f54e4fd726efe3622" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "91e206bcfeaf8948ea03fe3cb1b7616108496cd3", - "internalRef": "350949863" + "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb", + "internalRef": "356341083" } }, {