class ProjectsLocationsPipelines extends Resource (View source)

The "pipelines" collection of methods.

Typical usage is:

 $datapipelinesService = new Google\Service\Datapipelines(...);
 $pipelines = $datapipelinesService->projects_locations_pipelines;

Methods

create(string $parent, GoogleCloudDatapipelinesV1Pipeline $postBody, array $optParams = [])

Creates a pipeline. For a batch pipeline, you can pass scheduler information.

delete(string $name, array $optParams = [])

Deletes a pipeline. If a scheduler job is attached to the pipeline, it will be deleted. (pipelines.delete)

get(string $name, array $optParams = [])

Looks up a single pipeline. Returns a "NOT_FOUND" error if no such pipeline exists. Returns a "FORBIDDEN" error if the caller doesn't have permission to access it. (pipelines.get)

listProjectsLocationsPipelines(string $parent, array $optParams = [])

Lists pipelines. Returns a "FORBIDDEN" error if the caller doesn't have permission to access it. (pipelines.listProjectsLocationsPipelines)

patch(string $name, GoogleCloudDatapipelinesV1Pipeline $postBody, array $optParams = [])

Updates a pipeline. If successful, the updated Pipeline is returned. Returns NOT_FOUND if the pipeline doesn't exist. If UpdatePipeline does not return successfully, you can retry the UpdatePipeline request until you receive a successful response. (pipelines.patch)

run(string $name, GoogleCloudDatapipelinesV1RunPipelineRequest $postBody, array $optParams = [])

Creates a job for the specified pipeline directly. You can use this method when the internal scheduler is not configured and you want to trigger the job directly or through an external system. Returns a "NOT_FOUND" error if the pipeline doesn't exist. Returns a "FORBIDDEN" error if the user doesn't have permission to access the pipeline or run jobs for the pipeline.

stop(string $name, GoogleCloudDatapipelinesV1StopPipelineRequest $postBody, array $optParams = [])

Freezes pipeline execution permanently. If there's a corresponding scheduler entry, it's deleted, and the pipeline state is changed to "ARCHIVED".

Details

GoogleCloudDatapipelinesV1Pipeline create(string $parent, GoogleCloudDatapipelinesV1Pipeline $postBody, array $optParams = [])

Creates a pipeline. For a batch pipeline, you can pass scheduler information.

Data Pipelines uses the scheduler information to create an internal scheduler that runs jobs periodically. If the internal scheduler is not configured, you can use RunPipeline to run jobs. (pipelines.create)

Parameters

string $parent

Required. The location name. For example: projects/PROJECT_ID/locations/LOCATION_ID.

GoogleCloudDatapipelinesV1Pipeline $postBody
array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1Pipeline

Exceptions

Exception

GoogleProtobufEmpty delete(string $name, array $optParams = [])

Deletes a pipeline. If a scheduler job is attached to the pipeline, it will be deleted. (pipelines.delete)

Parameters

string $name

Required. The pipeline name. For example: projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID.

array $optParams

Optional parameters.

Return Value

GoogleProtobufEmpty

Exceptions

Exception

GoogleCloudDatapipelinesV1Pipeline get(string $name, array $optParams = [])

Looks up a single pipeline. Returns a "NOT_FOUND" error if no such pipeline exists. Returns a "FORBIDDEN" error if the caller doesn't have permission to access it. (pipelines.get)

Parameters

string $name

Required. The pipeline name. For example: projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID.

array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1Pipeline

Exceptions

Exception

GoogleCloudDatapipelinesV1ListPipelinesResponse listProjectsLocationsPipelines(string $parent, array $optParams = [])

Lists pipelines. Returns a "FORBIDDEN" error if the caller doesn't have permission to access it. (pipelines.listProjectsLocationsPipelines)

Parameters

string $parent

Required. The location name. For example: projects/PROJECT_ID/locations/LOCATION_ID.

array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1ListPipelinesResponse

Exceptions

Exception

GoogleCloudDatapipelinesV1Pipeline patch(string $name, GoogleCloudDatapipelinesV1Pipeline $postBody, array $optParams = [])

Updates a pipeline. If successful, the updated Pipeline is returned. Returns NOT_FOUND if the pipeline doesn't exist. If UpdatePipeline does not return successfully, you can retry the UpdatePipeline request until you receive a successful response. (pipelines.patch)

Parameters

string $name

The pipeline name. For example: projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID. PROJECT_ID can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), and periods (.). For more information, see Identifying projects. LOCATION_ID is the canonical ID for the pipeline's location. The list of available locations can be obtained by calling google.cloud.location.Locations.ListLocations. Note that the Data Pipelines service is not available in all regions. It depends on Cloud Scheduler, an App Engine application, so it's only available in App Engine regions. * PIPELINE_ID is the ID of the pipeline. Must be unique for the selected project and location.

GoogleCloudDatapipelinesV1Pipeline $postBody
array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1Pipeline

Exceptions

Exception

GoogleCloudDatapipelinesV1RunPipelineResponse run(string $name, GoogleCloudDatapipelinesV1RunPipelineRequest $postBody, array $optParams = [])

Creates a job for the specified pipeline directly. You can use this method when the internal scheduler is not configured and you want to trigger the job directly or through an external system. Returns a "NOT_FOUND" error if the pipeline doesn't exist. Returns a "FORBIDDEN" error if the user doesn't have permission to access the pipeline or run jobs for the pipeline.

(pipelines.run)

Parameters

string $name

Required. The pipeline name. For example: projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID.

GoogleCloudDatapipelinesV1RunPipelineRequest $postBody
array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1RunPipelineResponse

Exceptions

Exception

GoogleCloudDatapipelinesV1Pipeline stop(string $name, GoogleCloudDatapipelinesV1StopPipelineRequest $postBody, array $optParams = [])

Freezes pipeline execution permanently. If there's a corresponding scheduler entry, it's deleted, and the pipeline state is changed to "ARCHIVED".

However, pipeline metadata is retained. (pipelines.stop)

Parameters

string $name

Required. The pipeline name. For example: projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID.

GoogleCloudDatapipelinesV1StopPipelineRequest $postBody
array $optParams

Optional parameters.

Return Value

GoogleCloudDatapipelinesV1Pipeline

Exceptions

Exception