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: * - *
- *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * cloudBuildClient.deleteBuildTrigger(projectId, triggerId);
- * }
- *
- *
- *
- * Note: close() needs to be called on the cloudBuildClient object to clean up resources such as + *
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(). * *
The surface of this class includes several types of Java methods for each of the API's @@ -113,30 +104,26 @@ * *
To customize credentials: * - *
- *
+ * {@code
* CloudBuildSettings cloudBuildSettings =
* CloudBuildSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
* .build();
- * CloudBuildClient cloudBuildClient =
- * CloudBuildClient.create(cloudBuildSettings);
- *
- *
+ * CloudBuildClient cloudBuildClient = CloudBuildClient.create(cloudBuildSettings);
+ * }
*
- * To customize the endpoint:
+ * To customize the endpoint: * - *
- *
+ * {@code
* CloudBuildSettings cloudBuildSettings =
* CloudBuildSettings.newBuilder().setEndpoint(myEndpoint).build();
- * CloudBuildClient cloudBuildClient =
- * CloudBuildClient.create(cloudBuildSettings);
- *
- *
+ * CloudBuildClient cloudBuildClient = CloudBuildClient.create(cloudBuildSettings);
+ * }
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets. */ -@Generated("by gapic-generator") @BetaApi +@Generated("by gapic-generator") public class CloudBuildClient implements BackgroundResource { private final CloudBuildSettings settings; private final CloudBuildStub stub; @@ -157,7 +144,7 @@ public static final CloudBuildClient create(CloudBuildSettings settings) throws /** * Constructs an instance of CloudBuildClient, using the given stub for making calls. This is for - * advanced usage - prefer to use CloudBuildSettings}. + * advanced usage - prefer using create(CloudBuildSettings). */ @BetaApi("A restructuring of stub classes is planned, so this may break in the future") public static final CloudBuildClient create(CloudBuildStub stub) { @@ -194,235 +181,21 @@ public CloudBuildStub getStub() { * Returns the OperationsClient 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 OperationsClient getOperationsClient() { return operationsClient; } - // AUTO-GENERATED DOCUMENTATION AND METHOD - /** - * Lists previously requested builds. - * - *
Previously requested builds may still be in-progress, or may have finished successfully or - * unsuccessfully. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String filter = "";
- * for (Build element : cloudBuildClient.listBuilds(projectId, filter).iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- * Previously requested builds may still be in-progress, or may have finished successfully or - * unsuccessfully. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildsRequest request = ListBuildsRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * for (Build element : cloudBuildClient.listBuilds(request).iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- * Previously requested builds may still be in-progress, or may have finished successfully or - * unsuccessfully. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildsRequest request = ListBuildsRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * ApiFuture<ListBuildsPagedResponse> future = cloudBuildClient.listBuildsPagedCallable().futureCall(request);
- * // Do something
- * for (Build element : future.get().iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- * Previously requested builds may still be in-progress, or may have finished successfully or - * unsuccessfully. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildsRequest request = ListBuildsRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * while (true) {
- * ListBuildsResponse response = cloudBuildClient.listBuildsCallable().call(request);
- * for (Build element : response.getBuildsList()) {
- * // doThingsWith(element);
- * }
- * String nextPageToken = response.getNextPageToken();
- * if (!Strings.isNullOrEmpty(nextPageToken)) {
- * request = request.toBuilder().setPageToken(nextPageToken).build();
- * } else {
- * break;
- * }
- * }
- * }
- * This API is experimental. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * cloudBuildClient.deleteBuildTrigger(projectId, triggerId);
- * }
- * This API is experimental. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * DeleteBuildTriggerRequest request = DeleteBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .build();
- * cloudBuildClient.deleteBuildTrigger(request);
- * }
- * This API is experimental. - * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * DeleteBuildTriggerRequest request = DeleteBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .build();
- * ApiFuture<Void> future = cloudBuildClient.deleteBuildTriggerCallable().futureCall(request);
- * // Do something
- * future.get();
- * }
- * 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: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * Build build = Build.newBuilder().build();
- * Build response = cloudBuildClient.createBuildAsync(projectId, build).get();
- * }
- * 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: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * Build build = Build.newBuilder().build();
- * CreateBuildRequest request = CreateBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setBuild(build)
- * .build();
- * Build response = cloudBuildClient.createBuildAsync(request).get();
- * }
- * Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * Build build = Build.newBuilder().build();
- * CreateBuildRequest request = CreateBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setBuild(build)
- * .build();
- * OperationFuture<Build, BuildOperationMetadata> future = cloudBuildClient.createBuildOperationCallable().futureCall(request);
- * // Do something
- * Build response = future.get();
- * }
- * Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * Build build = Build.newBuilder().build();
- * CreateBuildRequest request = CreateBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setBuild(build)
- * .build();
- * ApiFuture<Operation> future = cloudBuildClient.createBuildCallable().futureCall(request);
- * // Do something
- * Operation response = future.get();
- * }
- * The `Build` that is returned includes its status (such as `SUCCESS`, `FAILURE`, or * `WORKING`), and timing information. * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * Build response = cloudBuildClient.getBuild(projectId, id);
- * }
- * The `Build` that is returned includes its status (such as `SUCCESS`, `FAILURE`, or * `WORKING`), and timing information. * - *
Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * GetBuildRequest request = GetBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * Build response = cloudBuildClient.getBuild(request);
- * }
- * Sample code: - * - *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * GetBuildRequest request = GetBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * ApiFuture<Build> future = cloudBuildClient.getBuildCallable().futureCall(request);
- * // Do something
- * Build response = future.get();
- * }
- * Previously requested builds may still be in-progress, or may have finished successfully or + * unsuccessfully. + * + * @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 + */ + public final ListBuildsPagedResponse listBuilds(String projectId, String filter) { + ListBuildsRequest request = + ListBuildsRequest.newBuilder().setProjectId(projectId).setFilter(filter).build(); + return listBuilds(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists previously requested builds. + * + *
Previously requested builds may still be in-progress, or may have finished successfully or + * unsuccessfully. + * + * @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 + */ + public final ListBuildsPagedResponse listBuilds(ListBuildsRequest request) { + return listBuildsPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists previously requested builds. + * + *
Previously requested builds may still be in-progress, or may have finished successfully or + * unsuccessfully. * *
Sample code:
+ */
+ public final UnaryCallable Previously requested builds may still be in-progress, or may have finished successfully or
+ * unsuccessfully.
*
- * Sample code:
+ */
+ public final UnaryCallable Sample code:
- *
- * Sample code:
- *
- * For triggered builds:
*
- * * Triggered builds resolve to a precise revision; therefore a retry of a triggered build
- * will result in a build that uses the same revision.
+ * For non-triggered builds that specify `RepoSource`:
*
- * * If the original build built from the tip of a branch, the retried build will build
- * from the tip of that branch, which may not be the same revision as the original build. * If
- * the original build specified a commit sha or revision ID, the retried build will use the
- * identical source.
+ * For builds that specify `StorageSource`:
*
- * * If the original build pulled source from Google Cloud Storage without specifying the
- * generation of the object, the new build will use the current object, which may be different
- * from the original build source. * If the original build pulled source from Cloud Storage
- * and specified the generation of the object, the new build will attempt to use the same object,
- * which may or may not be available depending on the bucket's lifecycle management settings.
- *
- * Sample code:
- *
- * For triggered builds:
*
- * * Triggered builds resolve to a precise revision; therefore a retry of a triggered build
- * will result in a build that uses the same revision.
+ * For non-triggered builds that specify `RepoSource`:
*
- * * If the original build built from the tip of a branch, the retried build will build
- * from the tip of that branch, which may not be the same revision as the original build. * If
- * the original build specified a commit sha or revision ID, the retried build will use the
- * identical source.
+ * For builds that specify `StorageSource`:
*
- * * If the original build pulled source from Google Cloud Storage without specifying the
- * generation of the object, the new build will use the current object, which may be different
- * from the original build source. * If the original build pulled source from Cloud Storage
- * and specified the generation of the object, the new build will attempt to use the same object,
- * which may or may not be available depending on the bucket's lifecycle management settings.
- *
- * Sample code:
- *
- * For triggered builds:
*
- * * Triggered builds resolve to a precise revision; therefore a retry of a triggered build
- * will result in a build that uses the same revision.
+ * For non-triggered builds that specify `RepoSource`:
*
- * * If the original build built from the tip of a branch, the retried build will build
- * from the tip of that branch, which may not be the same revision as the original build. * If
- * the original build specified a commit sha or revision ID, the retried build will use the
- * identical source.
+ * For builds that specify `StorageSource`:
*
- * * If the original build pulled source from Google Cloud Storage without specifying the
- * generation of the object, the new build will use the current object, which may be different
- * from the original build source. * If the original build pulled source from Cloud Storage
- * and specified the generation of the object, the new build will attempt to use the same object,
- * which may or may not be available depending on the bucket's lifecycle management settings.
+ * Sample code:
- *
- * For triggered builds:
*
- * * Triggered builds resolve to a precise revision; therefore a retry of a triggered build
- * will result in a build that uses the same revision.
+ * For non-triggered builds that specify `RepoSource`:
*
- * * If the original build built from the tip of a branch, the retried build will build
- * from the tip of that branch, which may not be the same revision as the original build. * If
- * the original build specified a commit sha or revision ID, the retried build will use the
- * identical source.
+ * For builds that specify `StorageSource`:
*
- * * If the original build pulled source from Google Cloud Storage without specifying the
- * generation of the object, the new build will use the current object, which may be different
- * from the original build source. * If the original build pulled source from Cloud Storage
- * and specified the generation of the object, the new build will attempt to use the same object,
- * which may or may not be available depending on the bucket's lifecycle management settings.
+ * Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
+ *
+ * @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
+ */
+ public final void deleteBuildTrigger(String projectId, String triggerId) {
+ DeleteBuildTriggerRequest request =
+ DeleteBuildTriggerRequest.newBuilder()
+ .setProjectId(projectId)
+ .setTriggerId(triggerId)
+ .build();
+ deleteBuildTrigger(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes a `BuildTrigger` by its project ID and trigger ID.
+ *
+ * This API is experimental.
+ *
+ * @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
+ */
+ public final void deleteBuildTrigger(DeleteBuildTriggerRequest request) {
+ deleteBuildTriggerCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes a `BuildTrigger` by its project ID and trigger ID.
*
* This API is experimental.
*
* Sample code:
+ */
+ public final UnaryCallable This API is experimental.
*
* @param projectId Required. ID of the project that owns the trigger.
* @param triggerId Required. ID of the `BuildTrigger` to update.
@@ -1174,28 +751,12 @@ public final BuildTrigger updateBuildTrigger(
return updateBuildTrigger(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates a `BuildTrigger` by its project ID and trigger ID.
*
* This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * This API is experimental.
*
- * Sample code:
- *
- * This API is experimental.
*
* Sample code:
- *
- * 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 deleteBuildTrigger to 30 seconds:
+ * For example, to set the total timeout of getBuild to 30 seconds:
*
- * The interfaces provided are listed below, along with usage samples.
- *
- * ================ CloudBuildClient ================
+ * ======================= CloudBuildClient =======================
*
* Service Description: Creates and manages builds on Google Cloud Platform.
*
@@ -30,18 +28,8 @@
* of the build.
*
* Sample for CloudBuildClient:
- *
- * This class is for advanced usage and reflects the underlying API directly.
*/
@Generated("by gapic-generator")
-@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
public abstract class CloudBuildStub implements BackgroundResource {
- @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
public OperationsStub getOperationsStub() {
throw new UnsupportedOperationException("Not implemented: getOperationsStub()");
}
- public UnaryCallable 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 deleteBuildTrigger to 30 seconds:
+ * For example, to set the total timeout of getBuild to 30 seconds:
*
- * This class is for advanced usage.
*/
@Generated("by gapic-generator")
-@BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
public class GrpcCloudBuildCallableFactory implements GrpcStubCallableFactory {
+
@Override
public This class is for advanced usage and reflects the underlying API directly.
*/
-@Generated("by gapic-generator")
-@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
+@Generated("by gapic-generator-java")
public class GrpcCloudBuildStub extends CloudBuildStub {
-
- private static final MethodDescriptor
+ *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * Build response = cloudBuildClient.cancelBuild(projectId, id);
- * }
- *
- *
* @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
*/
@@ -648,31 +371,17 @@ public final Build cancelBuild(CancelBuildRequest request) {
return cancelBuildCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Cancels a build in progress.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * CancelBuildRequest request = CancelBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * Build response = cloudBuildClient.cancelBuild(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * CancelBuildRequest request = CancelBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * ApiFuture<Build> future = cloudBuildClient.cancelBuildCallable().futureCall(request);
- * // Do something
- * Build response = future.get();
- * }
- *
+ *
*
*
+ *
*
*
+ *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * 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
*/
- @BetaApi(
- "The surface for long-running operations is not stable yet and may change in the future.")
public final OperationFuture
+ *
*
*
+ *
*
*
+ *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * RetryBuildRequest request = RetryBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .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
*/
- @BetaApi(
- "The surface for long-running operations is not stable yet and may change in the future.")
public final OperationFuture
+ *
*
*
+ *
*
*
+ *
*
*
*/
- @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
public final OperationCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * RetryBuildRequest request = RetryBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * OperationFuture<Build, BuildOperationMetadata> future = cloudBuildClient.retryBuildOperationCallable().futureCall(request);
- * // Do something
- * Build response = future.get();
- * }
- *
+ *
*
*
+ *
*
*
+ *
*
*
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String id = "";
- * RetryBuildRequest request = RetryBuildRequest.newBuilder()
- * .setProjectId(projectId)
- * .setId(id)
- * .build();
- * ApiFuture<Operation> future = cloudBuildClient.retryBuildCallable().futureCall(request);
- * // Do something
- * Operation response = future.get();
- * }
- *
- *
* @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
@@ -895,26 +565,12 @@ public final BuildTrigger createBuildTrigger(String projectId, BuildTrigger trig
return createBuildTrigger(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new `BuildTrigger`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * BuildTrigger response = cloudBuildClient.createBuildTrigger(projectId, trigger);
- * }
- *
- *
* @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
*/
@@ -922,48 +578,24 @@ public final BuildTrigger createBuildTrigger(CreateBuildTriggerRequest request)
return createBuildTriggerCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new `BuildTrigger`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * CreateBuildTriggerRequest request = CreateBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTrigger(trigger)
- * .build();
- * BuildTrigger response = cloudBuildClient.createBuildTrigger(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * CreateBuildTriggerRequest request = CreateBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTrigger(trigger)
- * .build();
- * ApiFuture<BuildTrigger> future = cloudBuildClient.createBuildTriggerCallable().futureCall(request);
- * // Do something
- * BuildTrigger response = future.get();
- * }
- *
- *
* @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
@@ -974,26 +606,12 @@ public final BuildTrigger getBuildTrigger(String projectId, String triggerId) {
return getBuildTrigger(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns information about a `BuildTrigger`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * BuildTrigger response = cloudBuildClient.getBuildTrigger(projectId, triggerId);
- * }
- *
- *
* @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
*/
@@ -1001,49 +619,24 @@ public final BuildTrigger getBuildTrigger(GetBuildTriggerRequest request) {
return getBuildTriggerCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns information about a `BuildTrigger`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * GetBuildTriggerRequest request = GetBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .build();
- * BuildTrigger response = cloudBuildClient.getBuildTrigger(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * GetBuildTriggerRequest request = GetBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .build();
- * ApiFuture<BuildTrigger> future = cloudBuildClient.getBuildTriggerCallable().futureCall(request);
- * // Do something
- * BuildTrigger response = future.get();
- * }
- *
- *
* @param projectId Required. ID of the project for which to list BuildTriggers.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -1053,26 +646,12 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(String projectId)
return listBuildTriggers(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists existing `BuildTrigger`s.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * for (BuildTrigger element : cloudBuildClient.listBuildTriggers(projectId).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
*/
@@ -1080,83 +659,81 @@ public final ListBuildTriggersPagedResponse listBuildTriggers(ListBuildTriggersR
return listBuildTriggersPagedCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists existing `BuildTrigger`s.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildTriggersRequest request = ListBuildTriggersRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * for (BuildTrigger element : cloudBuildClient.listBuildTriggers(request).iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildTriggersRequest request = ListBuildTriggersRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * ApiFuture<ListBuildTriggersPagedResponse> future = cloudBuildClient.listBuildTriggersPagedCallable().futureCall(request);
- * // Do something
- * for (BuildTrigger element : future.get().iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * ListBuildTriggersRequest request = ListBuildTriggersRequest.newBuilder()
- * .setProjectId(projectId)
- * .build();
- * while (true) {
- * ListBuildTriggersResponse response = cloudBuildClient.listBuildTriggersCallable().call(request);
- * for (BuildTrigger element : response.getTriggersList()) {
- * // doThingsWith(element);
- * }
- * String nextPageToken = response.getNextPageToken();
- * if (!Strings.isNullOrEmpty(nextPageToken)) {
- * request = request.toBuilder().setPageToken(nextPageToken).build();
- * } else {
- * break;
- * }
- * }
- * }
- *
+ *
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * BuildTrigger response = cloudBuildClient.updateBuildTrigger(projectId, triggerId, trigger);
- * }
- *
- *
* @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
*/
@@ -1203,56 +764,27 @@ public final BuildTrigger updateBuildTrigger(UpdateBuildTriggerRequest request)
return updateBuildTriggerCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates a `BuildTrigger` by its project ID and trigger ID.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * UpdateBuildTriggerRequest request = UpdateBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .setTrigger(trigger)
- * .build();
- * BuildTrigger response = cloudBuildClient.updateBuildTrigger(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * BuildTrigger trigger = BuildTrigger.newBuilder().build();
- * UpdateBuildTriggerRequest request = UpdateBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .setTrigger(trigger)
- * .build();
- * ApiFuture<BuildTrigger> future = cloudBuildClient.updateBuildTriggerCallable().futureCall(request);
- * // Do something
- * BuildTrigger response = future.get();
- * }
- *
- *
* @param projectId Required. ID of the project.
* @param triggerId Required. ID of the trigger.
* @param source Required. Source to build against this trigger.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
- @BetaApi(
- "The surface for long-running operations is not stable yet and may change in the future.")
public final OperationFuture
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * RepoSource source = RepoSource.newBuilder().build();
- * Build response = cloudBuildClient.runBuildTriggerAsync(projectId, triggerId, source).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(
- "The surface for long-running operations is not stable yet and may change in the future.")
public final OperationFuture
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * RepoSource source = RepoSource.newBuilder().build();
- * RunBuildTriggerRequest request = RunBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .setSource(source)
- * .build();
- * Build response = cloudBuildClient.runBuildTriggerAsync(request).get();
- * }
- *
*/
- @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
public final OperationCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * RepoSource source = RepoSource.newBuilder().build();
- * RunBuildTriggerRequest request = RunBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .setSource(source)
- * .build();
- * OperationFuture<Build, BuildOperationMetadata> future = cloudBuildClient.runBuildTriggerOperationCallable().futureCall(request);
- * // Do something
- * Build response = future.get();
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * RepoSource source = RepoSource.newBuilder().build();
- * RunBuildTriggerRequest request = RunBuildTriggerRequest.newBuilder()
- * .setProjectId(projectId)
- * .setTriggerId(triggerId)
- * .setSource(source)
- * .build();
- * ApiFuture<Operation> future = cloudBuildClient.runBuildTriggerCallable().futureCall(request);
- * // Do something
- * Operation response = future.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
*/
@@ -1370,42 +842,24 @@ public final WorkerPool createWorkerPool(CreateWorkerPoolRequest request) {
return createWorkerPoolCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a `WorkerPool` to run the builds, and returns the new worker pool.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * CreateWorkerPoolRequest request = CreateWorkerPoolRequest.newBuilder().build();
- * WorkerPool response = cloudBuildClient.createWorkerPool(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * CreateWorkerPoolRequest request = CreateWorkerPoolRequest.newBuilder().build();
- * ApiFuture<WorkerPool> future = cloudBuildClient.createWorkerPoolCallable().futureCall(request);
- * // Do something
- * WorkerPool response = future.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
*/
@@ -1413,42 +867,24 @@ public final WorkerPool getWorkerPool(GetWorkerPoolRequest request) {
return getWorkerPoolCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns information about a `WorkerPool`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * GetWorkerPoolRequest request = GetWorkerPoolRequest.newBuilder().build();
- * WorkerPool response = cloudBuildClient.getWorkerPool(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * GetWorkerPoolRequest request = GetWorkerPoolRequest.newBuilder().build();
- * ApiFuture<WorkerPool> future = cloudBuildClient.getWorkerPoolCallable().futureCall(request);
- * // Do something
- * WorkerPool response = future.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
*/
@@ -1456,42 +892,24 @@ public final void deleteWorkerPool(DeleteWorkerPoolRequest request) {
deleteWorkerPoolCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a `WorkerPool` by its project ID and WorkerPool name.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * DeleteWorkerPoolRequest request = DeleteWorkerPoolRequest.newBuilder().build();
- * cloudBuildClient.deleteWorkerPool(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * DeleteWorkerPoolRequest request = DeleteWorkerPoolRequest.newBuilder().build();
- * ApiFuture<Void> future = cloudBuildClient.deleteWorkerPoolCallable().futureCall(request);
- * // Do something
- * future.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
*/
@@ -1499,42 +917,24 @@ public final WorkerPool updateWorkerPool(UpdateWorkerPoolRequest request) {
return updateWorkerPoolCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Update a `WorkerPool`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * UpdateWorkerPoolRequest request = UpdateWorkerPoolRequest.newBuilder().build();
- * WorkerPool response = cloudBuildClient.updateWorkerPool(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * UpdateWorkerPoolRequest request = UpdateWorkerPoolRequest.newBuilder().build();
- * ApiFuture<WorkerPool> future = cloudBuildClient.updateWorkerPoolCallable().futureCall(request);
- * // Do something
- * WorkerPool response = future.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
*/
@@ -1542,22 +942,13 @@ public final ListWorkerPoolsResponse listWorkerPools(ListWorkerPoolsRequest requ
return listWorkerPoolsCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* List project's `WorkerPools`.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * ListWorkerPoolsRequest request = ListWorkerPoolsRequest.newBuilder().build();
- * ListWorkerPoolsResponse response = cloudBuildClient.listWorkerPools(request);
- * }
- *
*/
public final UnaryCallable
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * ListWorkerPoolsRequest request = ListWorkerPoolsRequest.newBuilder().build();
- * ApiFuture<ListWorkerPoolsResponse> future = cloudBuildClient.listWorkerPoolsCallable().futureCall(request);
- * // Do something
- * ListWorkerPoolsResponse response = future.get();
- * }
- *
- *
+ * }
*/
-@Generated("by gapic-generator")
-@BetaApi
+@Generated("by gapic-generator-java")
public class CloudBuildSettings extends ClientSettings
- * CloudBuildSettings.Builder cloudBuildSettingsBuilder =
- * CloudBuildSettings.newBuilder();
+ *
- * {@code
+ * CloudBuildSettings.Builder cloudBuildSettingsBuilder = CloudBuildSettings.newBuilder();
* cloudBuildSettingsBuilder
- * .deleteBuildTriggerSettings()
+ * .getBuildSettings()
* .setRetrySettings(
- * cloudBuildSettingsBuilder.deleteBuildTriggerSettings().getRetrySettings().toBuilder()
+ * cloudBuildSettingsBuilder
+ * .getBuildSettings()
+ * .getRetrySettings()
+ * .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* CloudBuildSettings cloudBuildSettings = cloudBuildSettingsBuilder.build();
- *
- *
*/
-@Generated("by gapic-generator")
+@Generated("by gapic-generator-java")
package com.google.cloud.devtools.cloudbuild.v1;
import javax.annotation.Generated;
diff --git a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStub.java b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStub.java
index 64d7a9de..81bd9be6 100644
--- a/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStub.java
+++ b/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStub.java
@@ -5,7 +5,7 @@
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
- * https://www.apache.org/licenses/LICENSE-2.0
+ * https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
@@ -13,12 +13,12 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
+
package com.google.cloud.devtools.cloudbuild.v1.stub;
import static com.google.cloud.devtools.cloudbuild.v1.CloudBuildClient.ListBuildTriggersPagedResponse;
import static com.google.cloud.devtools.cloudbuild.v1.CloudBuildClient.ListBuildsPagedResponse;
-import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.UnaryCallable;
@@ -50,34 +50,19 @@
import com.google.protobuf.Empty;
import javax.annotation.Generated;
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
- * Base stub class for Cloud Build API.
+ * Base stub class for the CloudBuild service API.
*
*
- * try (CloudBuildClient cloudBuildClient = CloudBuildClient.create()) {
- * String projectId = "";
- * String triggerId = "";
- * cloudBuildClient.deleteBuildTrigger(projectId, triggerId);
- * }
- *
- *
- *
+ * }
*/
-@Generated("by gapic-generator")
@BetaApi
+@Generated("by gapic-generator-java")
public class CloudBuildStubSettings extends StubSettings
- * CloudBuildStubSettings.Builder cloudBuildSettingsBuilder =
- * CloudBuildStubSettings.newBuilder();
+ *
- * {@code
+ * CloudBuildStubSettings.Builder cloudBuildSettingsBuilder = CloudBuildStubSettings.newBuilder();
* cloudBuildSettingsBuilder
- * .deleteBuildTriggerSettings()
+ * .getBuildSettings()
* .setRetrySettings(
- * cloudBuildSettingsBuilder.deleteBuildTriggerSettings().getRetrySettings().toBuilder()
+ * cloudBuildSettingsBuilder
+ * .getBuildSettings()
+ * .getRetrySettings()
+ * .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* CloudBuildStubSettings cloudBuildSettings = cloudBuildSettingsBuilder.build();
- *