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
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+ * Process process = Process.newBuilder().build();
+ * Process response = lineageClient.createProcess(parent, process);
+ * }
+ * }
+ *
+ * Note: close() needs to be called on the LineageClient 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 + * methods: + * + *
See the individual methods for example code. + * + *
Many parameters require resource names to be formatted in a particular way. To assist with + * these names, this class includes a format method for each type of name, and additionally a parse + * method to extract the individual identifiers contained within names that are returned. + * + *
This class can be customized by passing in a custom instance of LineageSettings to create(). + * For example: + * + *
To customize credentials: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * LineageSettings lineageSettings =
+ * LineageSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * LineageClient lineageClient = LineageClient.create(lineageSettings);
+ * }
+ *
+ * To customize the endpoint: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * LineageSettings lineageSettings = LineageSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * LineageClient lineageClient = LineageClient.create(lineageSettings);
+ * }
+ *
+ * To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over + * the wire: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * LineageSettings lineageSettings = LineageSettings.newHttpJsonBuilder().build();
+ * LineageClient lineageClient = LineageClient.create(lineageSettings);
+ * }
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets. + */ +@Generated("by gapic-generator-java") +public class LineageClient implements BackgroundResource { + private final LineageSettings settings; + private final LineageStub stub; + private final OperationsClient httpJsonOperationsClient; + private final com.google.longrunning.OperationsClient operationsClient; + + /** Constructs an instance of LineageClient with default settings. */ + public static final LineageClient create() throws IOException { + return create(LineageSettings.newBuilder().build()); + } + + /** + * Constructs an instance of LineageClient, using the given settings. The channels are created + * based on the settings passed in, or defaults for any settings that are not set. + */ + public static final LineageClient create(LineageSettings settings) throws IOException { + return new LineageClient(settings); + } + + /** + * Constructs an instance of LineageClient, using the given stub for making calls. This is for + * advanced usage - prefer using create(LineageSettings). + */ + public static final LineageClient create(LineageStub stub) { + return new LineageClient(stub); + } + + /** + * Constructs an instance of LineageClient, using the given settings. This is protected so that it + * is easy to make a subclass, but otherwise, the static factory methods should be preferred. + */ + protected LineageClient(LineageSettings settings) throws IOException { + this.settings = settings; + this.stub = ((LineageStubSettings) settings.getStubSettings()).createStub(); + this.operationsClient = + com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub()); + this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub()); + } + + protected LineageClient(LineageStub stub) { + this.settings = null; + this.stub = stub; + this.operationsClient = + com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub()); + this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub()); + } + + public final LineageSettings getSettings() { + return settings; + } + + public LineageStub getStub() { + return stub; + } + + /** + * Returns the OperationsClient that can be used to query the status of a long-running operation + * returned by another API method call. + */ + public final com.google.longrunning.OperationsClient getOperationsClient() { + return operationsClient; + } + + /** + * Returns the OperationsClient that can be used to query the status of a long-running operation + * returned by another API method call. + */ + @BetaApi + public final OperationsClient getHttpJsonOperationsClient() { + return httpJsonOperationsClient; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Creates a new process. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+ * Process process = Process.newBuilder().build();
+ * Process response = lineageClient.createProcess(parent, process);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project and its location that should own the process.
+ * @param process Required. The process to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Process createProcess(LocationName parent, Process process) {
+ CreateProcessRequest request =
+ CreateProcessRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .setProcess(process)
+ .build();
+ return createProcess(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+ * Process process = Process.newBuilder().build();
+ * Process response = lineageClient.createProcess(parent, process);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project and its location that should own the process.
+ * @param process Required. The process to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Process createProcess(String parent, Process process) {
+ CreateProcessRequest request =
+ CreateProcessRequest.newBuilder().setParent(parent).setProcess(process).build();
+ return createProcess(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateProcessRequest request =
+ * CreateProcessRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setProcess(Process.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * Process response = lineageClient.createProcess(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
+ */
+ public final Process createProcess(CreateProcessRequest request) {
+ return createProcessCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateProcessRequest request =
+ * CreateProcessRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setProcess(Process.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * ApiFuture future = lineageClient.createProcessCallable().futureCall(request);
+ * // Do something.
+ * Process response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * Process process = Process.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Process response = lineageClient.updateProcess(process, updateMask);
+ * }
+ * }
+ *
+ * @param process Required. The lineage process to update.
+ * The process's `name` field is used to identify the process to update. + * @param updateMask The list of fields to update. Currently not used. The whole message is + * updated. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Process updateProcess(Process process, FieldMask updateMask) { + UpdateProcessRequest request = + UpdateProcessRequest.newBuilder().setProcess(process).setUpdateMask(updateMask).build(); + return updateProcess(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Updates a process. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * UpdateProcessRequest request =
+ * UpdateProcessRequest.newBuilder()
+ * .setProcess(Process.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .setAllowMissing(true)
+ * .build();
+ * Process response = lineageClient.updateProcess(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
+ */
+ public final Process updateProcess(UpdateProcessRequest request) {
+ return updateProcessCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * UpdateProcessRequest request =
+ * UpdateProcessRequest.newBuilder()
+ * .setProcess(Process.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .setAllowMissing(true)
+ * .build();
+ * ApiFuture future = lineageClient.updateProcessCallable().futureCall(request);
+ * // Do something.
+ * Process response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ProcessName name = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]");
+ * Process response = lineageClient.getProcess(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the process to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Process getProcess(ProcessName name) {
+ GetProcessRequest request =
+ GetProcessRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getProcess(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString();
+ * Process response = lineageClient.getProcess(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the process to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Process getProcess(String name) {
+ GetProcessRequest request = GetProcessRequest.newBuilder().setName(name).build();
+ return getProcess(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetProcessRequest request =
+ * GetProcessRequest.newBuilder()
+ * .setName(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .build();
+ * Process response = lineageClient.getProcess(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
+ */
+ public final Process getProcess(GetProcessRequest request) {
+ return getProcessCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified process.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetProcessRequest request =
+ * GetProcessRequest.newBuilder()
+ * .setName(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .build();
+ * ApiFuture future = lineageClient.getProcessCallable().futureCall(request);
+ * // Do something.
+ * Process response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+ * for (Process element : lineageClient.listProcesses(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project and its location that owns this collection of
+ * processes.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListProcessesPagedResponse listProcesses(LocationName parent) {
+ ListProcessesRequest request =
+ ListProcessesRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listProcesses(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * List processes in the given project and location. List order is descending by insertion time.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+ * for (Process element : lineageClient.listProcesses(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project and its location that owns this collection of
+ * processes.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListProcessesPagedResponse listProcesses(String parent) {
+ ListProcessesRequest request = ListProcessesRequest.newBuilder().setParent(parent).build();
+ return listProcesses(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * List processes in the given project and location. List order is descending by insertion time.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListProcessesRequest request =
+ * ListProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Process element : lineageClient.listProcesses(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
+ */
+ public final ListProcessesPagedResponse listProcesses(ListProcessesRequest request) {
+ return listProcessesPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * List processes in the given project and location. List order is descending by insertion time.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListProcessesRequest request =
+ * ListProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future = lineageClient.listProcessesPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Process element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListProcessesRequest request =
+ * ListProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListProcessesResponse response = lineageClient.listProcessesCallable().call(request);
+ * for (Process element : response.getProcessesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ProcessName name = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]");
+ * lineageClient.deleteProcessAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The name of the process to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString();
+ * lineageClient.deleteProcessAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The name of the process to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteProcessRequest request =
+ * DeleteProcessRequest.newBuilder()
+ * .setName(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * lineageClient.deleteProcessAsync(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
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteProcessRequest request =
+ * DeleteProcessRequest.newBuilder()
+ * .setName(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * OperationFuture future =
+ * lineageClient.deleteProcessOperationCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final OperationCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteProcessRequest request =
+ * DeleteProcessRequest.newBuilder()
+ * .setName(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * ApiFuture future = lineageClient.deleteProcessCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ProcessName parent = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]");
+ * Run run = Run.newBuilder().build();
+ * Run response = lineageClient.createRun(parent, run);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the process that should own the run.
+ * @param run Required. The run to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Run createRun(ProcessName parent, Run run) {
+ CreateRunRequest request =
+ CreateRunRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .setRun(run)
+ .build();
+ return createRun(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString();
+ * Run run = Run.newBuilder().build();
+ * Run response = lineageClient.createRun(parent, run);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the process that should own the run.
+ * @param run Required. The run to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Run createRun(String parent, Run run) {
+ CreateRunRequest request = CreateRunRequest.newBuilder().setParent(parent).setRun(run).build();
+ return createRun(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateRunRequest request =
+ * CreateRunRequest.newBuilder()
+ * .setParent(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setRun(Run.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * Run response = lineageClient.createRun(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
+ */
+ public final Run createRun(CreateRunRequest request) {
+ return createRunCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateRunRequest request =
+ * CreateRunRequest.newBuilder()
+ * .setParent(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setRun(Run.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * ApiFuture future = lineageClient.createRunCallable().futureCall(request);
+ * // Do something.
+ * Run response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * Run run = Run.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Run response = lineageClient.updateRun(run, updateMask);
+ * }
+ * }
+ *
+ * @param run Required. The lineage run to update.
+ * The run's `name` field is used to identify the run to update. + *
Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}`. + * @param updateMask The list of fields to update. Currently not used. The whole message is + * updated. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Run updateRun(Run run, FieldMask updateMask) { + UpdateRunRequest request = + UpdateRunRequest.newBuilder().setRun(run).setUpdateMask(updateMask).build(); + return updateRun(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Updates a run. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * UpdateRunRequest request =
+ * UpdateRunRequest.newBuilder()
+ * .setRun(Run.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * Run response = lineageClient.updateRun(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
+ */
+ public final Run updateRun(UpdateRunRequest request) {
+ return updateRunCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * UpdateRunRequest request =
+ * UpdateRunRequest.newBuilder()
+ * .setRun(Run.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture future = lineageClient.updateRunCallable().futureCall(request);
+ * // Do something.
+ * Run response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * RunName name = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]");
+ * Run response = lineageClient.getRun(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the run to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Run getRun(RunName name) {
+ GetRunRequest request =
+ GetRunRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getRun(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString();
+ * Run response = lineageClient.getRun(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the run to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Run getRun(String name) {
+ GetRunRequest request = GetRunRequest.newBuilder().setName(name).build();
+ return getRun(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetRunRequest request =
+ * GetRunRequest.newBuilder()
+ * .setName(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .build();
+ * Run response = lineageClient.getRun(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
+ */
+ public final Run getRun(GetRunRequest request) {
+ return getRunCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the details of the specified run.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetRunRequest request =
+ * GetRunRequest.newBuilder()
+ * .setName(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .build();
+ * ApiFuture future = lineageClient.getRunCallable().futureCall(request);
+ * // Do something.
+ * Run response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ProcessName parent = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]");
+ * for (Run element : lineageClient.listRuns(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of process that owns this collection of runs.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListRunsPagedResponse listRuns(ProcessName parent) {
+ ListRunsRequest request =
+ ListRunsRequest.newBuilder().setParent(parent == null ? null : parent.toString()).build();
+ return listRuns(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists runs in the given project and location. List order is descending by `start_time`.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString();
+ * for (Run element : lineageClient.listRuns(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of process that owns this collection of runs.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListRunsPagedResponse listRuns(String parent) {
+ ListRunsRequest request = ListRunsRequest.newBuilder().setParent(parent).build();
+ return listRuns(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists runs in the given project and location. List order is descending by `start_time`.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListRunsRequest request =
+ * ListRunsRequest.newBuilder()
+ * .setParent(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Run element : lineageClient.listRuns(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
+ */
+ public final ListRunsPagedResponse listRuns(ListRunsRequest request) {
+ return listRunsPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists runs in the given project and location. List order is descending by `start_time`.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListRunsRequest request =
+ * ListRunsRequest.newBuilder()
+ * .setParent(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future = lineageClient.listRunsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Run element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListRunsRequest request =
+ * ListRunsRequest.newBuilder()
+ * .setParent(ProcessName.of("[PROJECT]", "[LOCATION]", "[PROCESS]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListRunsResponse response = lineageClient.listRunsCallable().call(request);
+ * for (Run element : response.getRunsList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * RunName name = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]");
+ * lineageClient.deleteRunAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The name of the run to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString();
+ * lineageClient.deleteRunAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The name of the run to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteRunRequest request =
+ * DeleteRunRequest.newBuilder()
+ * .setName(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * lineageClient.deleteRunAsync(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
+ */
+ public final OperationFutureSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteRunRequest request =
+ * DeleteRunRequest.newBuilder()
+ * .setName(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * OperationFuture future =
+ * lineageClient.deleteRunOperationCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final OperationCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteRunRequest request =
+ * DeleteRunRequest.newBuilder()
+ * .setName(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setAllowMissing(true)
+ * .build();
+ * ApiFuture future = lineageClient.deleteRunCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * RunName parent = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]");
+ * LineageEvent lineageEvent = LineageEvent.newBuilder().build();
+ * LineageEvent response = lineageClient.createLineageEvent(parent, lineageEvent);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the run that should own the lineage event.
+ * @param lineageEvent Required. The lineage event to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final LineageEvent createLineageEvent(RunName parent, LineageEvent lineageEvent) {
+ CreateLineageEventRequest request =
+ CreateLineageEventRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .setLineageEvent(lineageEvent)
+ .build();
+ return createLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString();
+ * LineageEvent lineageEvent = LineageEvent.newBuilder().build();
+ * LineageEvent response = lineageClient.createLineageEvent(parent, lineageEvent);
+ * }
+ * }
+ *
+ * @param parent Required. The name of the run that should own the lineage event.
+ * @param lineageEvent Required. The lineage event to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final LineageEvent createLineageEvent(String parent, LineageEvent lineageEvent) {
+ CreateLineageEventRequest request =
+ CreateLineageEventRequest.newBuilder()
+ .setParent(parent)
+ .setLineageEvent(lineageEvent)
+ .build();
+ return createLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateLineageEventRequest request =
+ * CreateLineageEventRequest.newBuilder()
+ * .setParent(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setLineageEvent(LineageEvent.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * LineageEvent response = lineageClient.createLineageEvent(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
+ */
+ public final LineageEvent createLineageEvent(CreateLineageEventRequest request) {
+ return createLineageEventCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * CreateLineageEventRequest request =
+ * CreateLineageEventRequest.newBuilder()
+ * .setParent(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setLineageEvent(LineageEvent.newBuilder().build())
+ * .setRequestId("requestId693933066")
+ * .build();
+ * ApiFuture future =
+ * lineageClient.createLineageEventCallable().futureCall(request);
+ * // Do something.
+ * LineageEvent response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LineageEventName name =
+ * LineageEventName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]");
+ * LineageEvent response = lineageClient.getLineageEvent(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the lineage event to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final LineageEvent getLineageEvent(LineageEventName name) {
+ GetLineageEventRequest request =
+ GetLineageEventRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets details of a specified lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name =
+ * LineageEventName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString();
+ * LineageEvent response = lineageClient.getLineageEvent(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the lineage event to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final LineageEvent getLineageEvent(String name) {
+ GetLineageEventRequest request = GetLineageEventRequest.newBuilder().setName(name).build();
+ return getLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets details of a specified lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetLineageEventRequest request =
+ * GetLineageEventRequest.newBuilder()
+ * .setName(
+ * LineageEventName.of(
+ * "[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString())
+ * .build();
+ * LineageEvent response = lineageClient.getLineageEvent(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
+ */
+ public final LineageEvent getLineageEvent(GetLineageEventRequest request) {
+ return getLineageEventCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets details of a specified lineage event.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * GetLineageEventRequest request =
+ * GetLineageEventRequest.newBuilder()
+ * .setName(
+ * LineageEventName.of(
+ * "[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString())
+ * .build();
+ * ApiFuture future = lineageClient.getLineageEventCallable().futureCall(request);
+ * // Do something.
+ * LineageEvent response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * RunName parent = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]");
+ * for (LineageEvent element : lineageClient.listLineageEvents(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of the run that owns the collection of lineage events to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListLineageEventsPagedResponse listLineageEvents(RunName parent) {
+ ListLineageEventsRequest request =
+ ListLineageEventsRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listLineageEvents(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists lineage events in the given project and location. The list order is not defined.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String parent = RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString();
+ * for (LineageEvent element : lineageClient.listLineageEvents(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The name of the run that owns the collection of lineage events to get.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListLineageEventsPagedResponse listLineageEvents(String parent) {
+ ListLineageEventsRequest request =
+ ListLineageEventsRequest.newBuilder().setParent(parent).build();
+ return listLineageEvents(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists lineage events in the given project and location. The list order is not defined.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListLineageEventsRequest request =
+ * ListLineageEventsRequest.newBuilder()
+ * .setParent(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (LineageEvent element : lineageClient.listLineageEvents(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
+ */
+ public final ListLineageEventsPagedResponse listLineageEvents(ListLineageEventsRequest request) {
+ return listLineageEventsPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists lineage events in the given project and location. The list order is not defined.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListLineageEventsRequest request =
+ * ListLineageEventsRequest.newBuilder()
+ * .setParent(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * lineageClient.listLineageEventsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (LineageEvent element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * ListLineageEventsRequest request =
+ * ListLineageEventsRequest.newBuilder()
+ * .setParent(RunName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListLineageEventsResponse response =
+ * lineageClient.listLineageEventsCallable().call(request);
+ * for (LineageEvent element : response.getLineageEventsList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableSample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LineageEventName name =
+ * LineageEventName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]");
+ * lineageClient.deleteLineageEvent(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the lineage event to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteLineageEvent(LineageEventName name) {
+ DeleteLineageEventRequest request =
+ DeleteLineageEventRequest.newBuilder()
+ .setName(name == null ? null : name.toString())
+ .build();
+ deleteLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the lineage event with the specified name.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * String name =
+ * LineageEventName.of("[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString();
+ * lineageClient.deleteLineageEvent(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the lineage event to delete.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteLineageEvent(String name) {
+ DeleteLineageEventRequest request =
+ DeleteLineageEventRequest.newBuilder().setName(name).build();
+ deleteLineageEvent(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the lineage event with the specified name.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteLineageEventRequest request =
+ * DeleteLineageEventRequest.newBuilder()
+ * .setName(
+ * LineageEventName.of(
+ * "[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString())
+ * .setAllowMissing(true)
+ * .build();
+ * lineageClient.deleteLineageEvent(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
+ */
+ public final void deleteLineageEvent(DeleteLineageEventRequest request) {
+ deleteLineageEventCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the lineage event with the specified name.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * DeleteLineageEventRequest request =
+ * DeleteLineageEventRequest.newBuilder()
+ * .setName(
+ * LineageEventName.of(
+ * "[PROJECT]", "[LOCATION]", "[PROCESS]", "[RUN]", "[LINEAGE_EVENT]")
+ * .toString())
+ * .setAllowMissing(true)
+ * .build();
+ * ApiFuture future = lineageClient.deleteLineageEventCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableYou can retrieve links in every project where you have the `datalineage.events.get` + * permission. The project provided in the URL is used for Billing and Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * SearchLinksRequest request =
+ * SearchLinksRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Link element : lineageClient.searchLinks(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
+ */
+ public final SearchLinksPagedResponse searchLinks(SearchLinksRequest request) {
+ return searchLinksPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Retrieve a list of links connected to a specific asset. Links represent the data flow between
+ * **source** (upstream) and **target** (downstream) assets in
+ * transformation pipelines. Links are stored in the same project as the Lineage Events that
+ * create them.
+ *
+ * You can retrieve links in every project where you have the `datalineage.events.get` + * permission. The project provided in the URL is used for Billing and Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * SearchLinksRequest request =
+ * SearchLinksRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future = lineageClient.searchLinksPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Link element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableYou can retrieve links in every project where you have the `datalineage.events.get` + * permission. The project provided in the URL is used for Billing and Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * SearchLinksRequest request =
+ * SearchLinksRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * SearchLinksResponse response = lineageClient.searchLinksCallable().call(request);
+ * for (Link element : response.getLinksList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableIf you have specific link names, you can use this method to verify which LineageProcesses + * contribute to creating those links. See the + * [SearchLinks][google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks] method for more + * information on how to retrieve link name. + * + *
You can retrieve the LineageProcess information in every project where you have the + * `datalineage.events.get` permission. The project provided in the URL is used for Billing and + * Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * BatchSearchLinkProcessesRequest request =
+ * BatchSearchLinkProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .addAllLinks(new ArrayList())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (ProcessLinks element : lineageClient.batchSearchLinkProcesses(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
+ */
+ public final BatchSearchLinkProcessesPagedResponse batchSearchLinkProcesses(
+ BatchSearchLinkProcessesRequest request) {
+ return batchSearchLinkProcessesPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Retrieve information about LineageProcesses associated with specific links. LineageProcesses
+ * are transformation pipelines that result in data flowing from **source** to
+ * **target** assets. Links between assets represent this operation.
+ *
+ * If you have specific link names, you can use this method to verify which LineageProcesses + * contribute to creating those links. See the + * [SearchLinks][google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks] method for more + * information on how to retrieve link name. + * + *
You can retrieve the LineageProcess information in every project where you have the + * `datalineage.events.get` permission. The project provided in the URL is used for Billing and + * Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * BatchSearchLinkProcessesRequest request =
+ * BatchSearchLinkProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .addAllLinks(new ArrayList())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * lineageClient.batchSearchLinkProcessesPagedCallable().futureCall(request);
+ * // Do something.
+ * for (ProcessLinks element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableIf you have specific link names, you can use this method to verify which LineageProcesses + * contribute to creating those links. See the + * [SearchLinks][google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks] method for more + * information on how to retrieve link name. + * + *
You can retrieve the LineageProcess information in every project where you have the + * `datalineage.events.get` permission. The project provided in the URL is used for Billing and + * Quota. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * BatchSearchLinkProcessesRequest request =
+ * BatchSearchLinkProcessesRequest.newBuilder()
+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+ * .addAllLinks(new ArrayList())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * BatchSearchLinkProcessesResponse response =
+ * lineageClient.batchSearchLinkProcessesCallable().call(request);
+ * for (ProcessLinks element : response.getProcessLinksList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallableThe default instance has everything set to sensible defaults: + * + *
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 createProcess to 30 seconds: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * LineageSettings.Builder lineageSettingsBuilder = LineageSettings.newBuilder();
+ * lineageSettingsBuilder
+ * .createProcessSettings()
+ * .setRetrySettings(
+ * lineageSettingsBuilder
+ * .createProcessSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * LineageSettings lineageSettings = lineageSettingsBuilder.build();
+ * }
+ */
+@Generated("by gapic-generator-java")
+public class LineageSettings extends ClientSettingsNote: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction The interfaces provided are listed below, along with usage samples.
+ *
+ * ======================= LineageClient =======================
+ *
+ * Service Description: Lineage is used to track data flows between assets over time. You can
+ * create [LineageEvents][google.cloud.datacatalog.lineage.v1.LineageEvent] to record lineage
+ * between multiple sources and a single target, for example, when table data is based on data from
+ * multiple tables.
+ *
+ * Sample for LineageClient:
+ *
+ * This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcLineageCallableFactory implements GrpcStubCallableFactory {
+
+ @Override
+ public This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcLineageStub extends LineageStub {
+ private static final MethodDescriptor{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (LineageClient lineageClient = LineageClient.create()) {
+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+ * Process process = Process.newBuilder().build();
+ * Process response = lineageClient.createProcess(parent, process);
+ * }
+ * }
+ */
+@Generated("by gapic-generator-java")
+package com.google.cloud.datacatalog.lineage.v1;
+
+import javax.annotation.Generated;
diff --git a/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/GrpcLineageCallableFactory.java b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/GrpcLineageCallableFactory.java
new file mode 100644
index 000000000000..03e4af1d6a05
--- /dev/null
+++ b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/GrpcLineageCallableFactory.java
@@ -0,0 +1,113 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.datacatalog.lineage.v1.stub;
+
+import com.google.api.gax.grpc.GrpcCallSettings;
+import com.google.api.gax.grpc.GrpcCallableFactory;
+import com.google.api.gax.grpc.GrpcStubCallableFactory;
+import com.google.api.gax.rpc.BatchingCallSettings;
+import com.google.api.gax.rpc.BidiStreamingCallable;
+import com.google.api.gax.rpc.ClientContext;
+import com.google.api.gax.rpc.ClientStreamingCallable;
+import com.google.api.gax.rpc.OperationCallSettings;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.PagedCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallable;
+import com.google.api.gax.rpc.StreamingCallSettings;
+import com.google.api.gax.rpc.UnaryCallSettings;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * gRPC callable factory implementation for the Lineage service API.
+ *
+ *