// Copyright 2024 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. // Code generated file. DO NOT EDIT. // Package datapipelines provides access to the Data pipelines API. // // For product documentation, see: https://cloud.google.com/dataflow/docs/guides/data-pipelines // // # Library status // // These client libraries are officially supported by Google. However, this // library is considered complete and is in maintenance mode. This means // that we will address critical bugs and security issues but will not add // any new features. // // When possible, we recommend using our newer // [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) // that are still actively being worked and iterated on. // // # Creating a client // // Usage example: // // import "google.golang.org/api/datapipelines/v1" // ... // ctx := context.Background() // datapipelinesService, err := datapipelines.NewService(ctx) // // In this example, Google Application Default Credentials are used for // authentication. For information on how to create and obtain Application // Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. // // # Other authentication options // // To use an API key for authentication (note: some APIs do not support API // keys), use [google.golang.org/api/option.WithAPIKey]: // // datapipelinesService, err := datapipelines.NewService(ctx, option.WithAPIKey("AIza...")) // // To use an OAuth token (e.g., a user token obtained via a three-legged OAuth // flow, use [google.golang.org/api/option.WithTokenSource]: // // config := &oauth2.Config{...} // // ... // token, err := config.Exchange(ctx, ...) // datapipelinesService, err := datapipelines.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) // // See [google.golang.org/api/option.ClientOption] for details on options. package datapipelines // import "google.golang.org/api/datapipelines/v1" import ( "bytes" "context" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "strconv" "strings" googleapi "google.golang.org/api/googleapi" internal "google.golang.org/api/internal" gensupport "google.golang.org/api/internal/gensupport" option "google.golang.org/api/option" internaloption "google.golang.org/api/option/internaloption" htransport "google.golang.org/api/transport/http" ) // Always reference these packages, just in case the auto-generated code // below doesn't. var _ = bytes.NewBuffer var _ = strconv.Itoa var _ = fmt.Sprintf var _ = json.NewDecoder var _ = io.Copy var _ = url.Parse var _ = gensupport.MarshalJSON var _ = googleapi.Version var _ = errors.New var _ = strings.Replace var _ = context.Canceled var _ = internaloption.WithDefaultEndpoint var _ = internal.Version const apiId = "datapipelines:v1" const apiName = "datapipelines" const apiVersion = "v1" const basePath = "https://datapipelines.googleapis.com/" const basePathTemplate = "https://datapipelines.UNIVERSE_DOMAIN/" const mtlsBasePath = "https://datapipelines.mtls.googleapis.com/" // OAuth2 scopes used by this API. const ( // See, edit, configure, and delete your Google Cloud data and see the email // address for your Google Account. CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" ) // NewService creates a new Service. func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { scopesOption := internaloption.WithDefaultScopes( "https://www.googleapis.com/auth/cloud-platform", ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) opts = append(opts, internaloption.WithDefaultEndpointTemplate(basePathTemplate)) opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) opts = append(opts, internaloption.EnableNewAuthLibrary()) client, endpoint, err := htransport.NewClient(ctx, opts...) if err != nil { return nil, err } s, err := New(client) if err != nil { return nil, err } if endpoint != "" { s.BasePath = endpoint } return s, nil } // New creates a new Service. It uses the provided http.Client for requests. // // Deprecated: please use NewService instead. // To provide a custom HTTP client, use option.WithHTTPClient. // If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. func New(client *http.Client) (*Service, error) { if client == nil { return nil, errors.New("client is nil") } s := &Service{client: client, BasePath: basePath} s.Projects = NewProjectsService(s) return s, nil } type Service struct { client *http.Client BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Projects *ProjectsService } func (s *Service) userAgent() string { if s.UserAgent == "" { return googleapi.UserAgent } return googleapi.UserAgent + " " + s.UserAgent } func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) return rs } type ProjectsService struct { s *Service Locations *ProjectsLocationsService } func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.Pipelines = NewProjectsLocationsPipelinesService(s) return rs } type ProjectsLocationsService struct { s *Service Pipelines *ProjectsLocationsPipelinesService } func NewProjectsLocationsPipelinesService(s *Service) *ProjectsLocationsPipelinesService { rs := &ProjectsLocationsPipelinesService{s: s} rs.Jobs = NewProjectsLocationsPipelinesJobsService(s) return rs } type ProjectsLocationsPipelinesService struct { s *Service Jobs *ProjectsLocationsPipelinesJobsService } func NewProjectsLocationsPipelinesJobsService(s *Service) *ProjectsLocationsPipelinesJobsService { rs := &ProjectsLocationsPipelinesJobsService{s: s} return rs } type ProjectsLocationsPipelinesJobsService struct { s *Service } // GoogleCloudDatapipelinesV1DataflowJobDetails: Pipeline job details specific // to the Dataflow API. This is encapsulated here to allow for more executors // to store their specific details separately. type GoogleCloudDatapipelinesV1DataflowJobDetails struct { // CurrentWorkers: Output only. The current number of workers used to run the // jobs. Only set to a value if the job is still running. CurrentWorkers int64 `json:"currentWorkers,omitempty"` // ResourceInfo: Cached version of all the metrics of interest for the job. // This value gets stored here when the job is terminated. As long as the job // is running, this field is populated from the Dataflow API. ResourceInfo map[string]float64 `json:"resourceInfo,omitempty"` // SdkVersion: Output only. The SDK version used to run the job. SdkVersion *GoogleCloudDatapipelinesV1SdkVersion `json:"sdkVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "CurrentWorkers") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CurrentWorkers") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1DataflowJobDetails) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1DataflowJobDetails return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1FlexTemplateRuntimeEnvironment: The environment // values to be set at runtime for a Flex Template. type GoogleCloudDatapipelinesV1FlexTemplateRuntimeEnvironment struct { // AdditionalExperiments: Additional experiment flags for the job. AdditionalExperiments []string `json:"additionalExperiments,omitempty"` // AdditionalUserLabels: Additional user labels to be specified for the job. // Keys and values must follow the restrictions specified in the labeling // restrictions // (https://cloud.google.com/compute/docs/labeling-resources#restrictions). An // object containing a list of key/value pairs. Example: `{ "name": "wrench", // "mass": "1kg", "count": "3" }`. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // EnableStreamingEngine: Whether to enable Streaming Engine for the job. EnableStreamingEngine bool `json:"enableStreamingEngine,omitempty"` // FlexrsGoal: Set FlexRS goal for the job. // https://cloud.google.com/dataflow/docs/guides/flexrs // // Possible values: // "FLEXRS_UNSPECIFIED" - Run in the default mode. // "FLEXRS_SPEED_OPTIMIZED" - Optimize for lower execution time. // "FLEXRS_COST_OPTIMIZED" - Optimize for lower cost. FlexrsGoal string `json:"flexrsGoal,omitempty"` // IpConfiguration: Configuration for VM IPs. // // Possible values: // "WORKER_IP_UNSPECIFIED" - The configuration is unknown, or unspecified. // "WORKER_IP_PUBLIC" - Workers should have public IP addresses. // "WORKER_IP_PRIVATE" - Workers should have private IP addresses. IpConfiguration string `json:"ipConfiguration,omitempty"` // KmsKeyName: Name for the Cloud KMS key for the job. Key format is: // projects//locations//keyRings//cryptoKeys/ KmsKeyName string `json:"kmsKeyName,omitempty"` // MachineType: The machine type to use for the job. Defaults to the value from // the template if not specified. MachineType string `json:"machineType,omitempty"` // MaxWorkers: The maximum number of Compute Engine instances to be made // available to your pipeline during execution, from 1 to 1000. MaxWorkers int64 `json:"maxWorkers,omitempty"` // Network: Network to which VMs will be assigned. If empty or unspecified, the // service will use the network "default". Network string `json:"network,omitempty"` // NumWorkers: The initial number of Compute Engine instances for the job. NumWorkers int64 `json:"numWorkers,omitempty"` // ServiceAccountEmail: The email address of the service account to run the job // as. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // Subnetwork: Subnetwork to which VMs will be assigned, if desired. You can // specify a subnetwork using either a complete URL or an abbreviated path. // Expected to be of the form // "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGIO // N/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the // subnetwork is located in a Shared VPC network, you must use the complete // URL. Subnetwork string `json:"subnetwork,omitempty"` // TempLocation: The Cloud Storage path to use for temporary files. Must be a // valid Cloud Storage URL, beginning with `gs://`. TempLocation string `json:"tempLocation,omitempty"` // WorkerRegion: The Compute Engine region // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which // worker processing should occur, e.g. "us-west1". Mutually exclusive with // worker_zone. If neither worker_region nor worker_zone is specified, defaults // to the control plane region. WorkerRegion string `json:"workerRegion,omitempty"` // WorkerZone: The Compute Engine zone // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which // worker processing should occur, e.g. "us-west1-a". Mutually exclusive with // worker_region. If neither worker_region nor worker_zone is specified, a zone // in the control plane region is chosen based on available capacity. If both // `worker_zone` and `zone` are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` // Zone: The Compute Engine availability zone // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) for // launching worker instances to run your pipeline. In the future, worker_zone // will take precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalExperiments") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AdditionalExperiments") to // include in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1FlexTemplateRuntimeEnvironment) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1FlexTemplateRuntimeEnvironment return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1Job: Definition of the job information maintained // by the pipeline. Fields in this entity are retrieved from the executor API // (e.g. Dataflow API). type GoogleCloudDatapipelinesV1Job struct { // CreateTime: Output only. The time of job creation. CreateTime string `json:"createTime,omitempty"` // DataflowJobDetails: All the details that are specific to a Dataflow job. DataflowJobDetails *GoogleCloudDatapipelinesV1DataflowJobDetails `json:"dataflowJobDetails,omitempty"` // EndTime: Output only. The time of job termination. This is absent if the job // is still running. EndTime string `json:"endTime,omitempty"` // Id: Output only. The internal ID for the job. Id string `json:"id,omitempty"` // Name: Required. The fully qualified resource name for the job. Name string `json:"name,omitempty"` // State: The current state of the job. // // Possible values: // "STATE_UNSPECIFIED" - The job state isn't specified. // "STATE_PENDING" - The job is waiting to start execution. // "STATE_RUNNING" - The job is executing. // "STATE_DONE" - The job has finished execution successfully. // "STATE_FAILED" - The job has finished execution with a failure. // "STATE_CANCELLED" - The job has been terminated upon user request. State string `json:"state,omitempty"` // Status: Status capturing any error code or message related to job creation // or execution. Status *GoogleRpcStatus `json:"status,omitempty"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CreateTime") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1Job) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1Job return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1LaunchFlexTemplateParameter: Launch Flex Template // parameter. type GoogleCloudDatapipelinesV1LaunchFlexTemplateParameter struct { // ContainerSpecGcsPath: Cloud Storage path to a file with a JSON-serialized // ContainerSpec as content. ContainerSpecGcsPath string `json:"containerSpecGcsPath,omitempty"` // Environment: The runtime environment for the Flex Template job. Environment *GoogleCloudDatapipelinesV1FlexTemplateRuntimeEnvironment `json:"environment,omitempty"` // JobName: Required. The job name to use for the created job. For an update // job request, the job name should be the same as the existing running job. JobName string `json:"jobName,omitempty"` // LaunchOptions: Launch options for this Flex Template job. This is a common // set of options across languages and templates. This should not be used to // pass job parameters. LaunchOptions map[string]string `json:"launchOptions,omitempty"` // Parameters: The parameters for the Flex Template. Example: // `{"num_workers":"5"}` Parameters map[string]string `json:"parameters,omitempty"` // TransformNameMappings: Use this to pass transform name mappings for // streaming update jobs. Example: // `{"oldTransformName":"newTransformName",...}` TransformNameMappings map[string]string `json:"transformNameMappings,omitempty"` // Update: Set this to true if you are sending a request to update a running // streaming job. When set, the job name should be the same as the running job. Update bool `json:"update,omitempty"` // ForceSendFields is a list of field names (e.g. "ContainerSpecGcsPath") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ContainerSpecGcsPath") to include // in API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1LaunchFlexTemplateParameter) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1LaunchFlexTemplateParameter return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1LaunchFlexTemplateRequest: A request to launch a // Dataflow job from a Flex Template. type GoogleCloudDatapipelinesV1LaunchFlexTemplateRequest struct { // LaunchParameter: Required. Parameter to launch a job from a Flex Template. LaunchParameter *GoogleCloudDatapipelinesV1LaunchFlexTemplateParameter `json:"launchParameter,omitempty"` // Location: Required. The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to // which to direct the request. For example, `us-central1`, `us-west1`. Location string `json:"location,omitempty"` // ProjectId: Required. The ID of the Cloud Platform project that the job // belongs to. ProjectId string `json:"projectId,omitempty"` // ValidateOnly: If true, the request is validated but not actually executed. // Defaults to false. ValidateOnly bool `json:"validateOnly,omitempty"` // ForceSendFields is a list of field names (e.g. "LaunchParameter") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "LaunchParameter") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1LaunchFlexTemplateRequest) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1LaunchFlexTemplateRequest return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1LaunchTemplateParameters: Parameters to provide to // the template being launched. type GoogleCloudDatapipelinesV1LaunchTemplateParameters struct { // Environment: The runtime environment for the job. Environment *GoogleCloudDatapipelinesV1RuntimeEnvironment `json:"environment,omitempty"` // JobName: Required. The job name to use for the created job. JobName string `json:"jobName,omitempty"` // Parameters: The runtime parameters to pass to the job. Parameters map[string]string `json:"parameters,omitempty"` // TransformNameMapping: Map of transform name prefixes of the job to be // replaced to the corresponding name prefixes of the new job. Only applicable // when updating a pipeline. TransformNameMapping map[string]string `json:"transformNameMapping,omitempty"` // Update: If set, replace the existing pipeline with the name specified by // jobName with this pipeline, preserving state. Update bool `json:"update,omitempty"` // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Environment") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1LaunchTemplateParameters) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1LaunchTemplateParameters return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1LaunchTemplateRequest: A request to launch a // template. type GoogleCloudDatapipelinesV1LaunchTemplateRequest struct { // GcsPath: A Cloud Storage path to the template from which to create the job. // Must be a valid Cloud Storage URL, beginning with 'gs://'. GcsPath string `json:"gcsPath,omitempty"` // LaunchParameters: The parameters of the template to launch. This should be // part of the body of the POST request. LaunchParameters *GoogleCloudDatapipelinesV1LaunchTemplateParameters `json:"launchParameters,omitempty"` // Location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to // which to direct the request. Location string `json:"location,omitempty"` // ProjectId: Required. The ID of the Cloud Platform project that the job // belongs to. ProjectId string `json:"projectId,omitempty"` // ValidateOnly: If true, the request is validated but not actually executed. // Defaults to false. ValidateOnly bool `json:"validateOnly,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsPath") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "GcsPath") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1LaunchTemplateRequest) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1LaunchTemplateRequest return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1ListJobsResponse: Response message for ListJobs type GoogleCloudDatapipelinesV1ListJobsResponse struct { // Jobs: Results that were accessible to the caller. Results are always in // descending order of job creation date. Jobs []*GoogleCloudDatapipelinesV1Job `json:"jobs,omitempty"` // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Jobs") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Jobs") to include in API requests // with the JSON null value. By default, fields with empty values are omitted // from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1ListJobsResponse) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1ListJobsResponse return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1ListPipelinesResponse: Response message for // ListPipelines. type GoogleCloudDatapipelinesV1ListPipelinesResponse struct { // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` // Pipelines: Results that matched the filter criteria and were accessible to // the caller. Results are always in descending order of pipeline creation // date. Pipelines []*GoogleCloudDatapipelinesV1Pipeline `json:"pipelines,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextPageToken") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1ListPipelinesResponse) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1ListPipelinesResponse return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1Pipeline: The main pipeline entity and all the // necessary metadata for launching and managing linked jobs. type GoogleCloudDatapipelinesV1Pipeline struct { // CreateTime: Output only. Immutable. The timestamp when the pipeline was // initially created. Set by the Data Pipelines service. CreateTime string `json:"createTime,omitempty"` // DisplayName: Required. The display name of the pipeline. It can contain only // letters ([A-Za-z]), numbers ([0-9]), hyphens (-), and underscores (_). DisplayName string `json:"displayName,omitempty"` // JobCount: Output only. Number of jobs. JobCount int64 `json:"jobCount,omitempty"` // LastUpdateTime: Output only. Immutable. The timestamp when the pipeline was // last modified. Set by the Data Pipelines service. LastUpdateTime string `json:"lastUpdateTime,omitempty"` // 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 // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#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 (https://cloud.google.com/about/locations#region). * `PIPELINE_ID` // is the ID of the pipeline. Must be unique for the selected project and // location. Name string `json:"name,omitempty"` // PipelineSources: Immutable. The sources of the pipeline (for example, // Dataplex). The keys and values are set by the corresponding sources during // pipeline creation. PipelineSources map[string]string `json:"pipelineSources,omitempty"` // ScheduleInfo: Internal scheduling information for a pipeline. If this // information is provided, periodic jobs will be created per the schedule. If // not, users are responsible for creating jobs externally. ScheduleInfo *GoogleCloudDatapipelinesV1ScheduleSpec `json:"scheduleInfo,omitempty"` // SchedulerServiceAccountEmail: Optional. A service account email to be used // with the Cloud Scheduler job. If not specified, the default compute engine // service account will be used. SchedulerServiceAccountEmail string `json:"schedulerServiceAccountEmail,omitempty"` // State: Required. The state of the pipeline. When the pipeline is created, // the state is set to 'PIPELINE_STATE_ACTIVE' by default. State changes can be // requested by setting the state to stopping, paused, or resuming. State // cannot be changed through UpdatePipeline requests. // // Possible values: // "STATE_UNSPECIFIED" - The pipeline state isn't specified. // "STATE_RESUMING" - The pipeline is getting started or resumed. When // finished, the pipeline state will be 'PIPELINE_STATE_ACTIVE'. // "STATE_ACTIVE" - The pipeline is actively running. // "STATE_STOPPING" - The pipeline is in the process of stopping. When // finished, the pipeline state will be 'PIPELINE_STATE_ARCHIVED'. // "STATE_ARCHIVED" - The pipeline has been stopped. This is a terminal state // and cannot be undone. // "STATE_PAUSED" - The pipeline is paused. This is a non-terminal state. // When the pipeline is paused, it will hold processing jobs, but can be // resumed later. For a batch pipeline, this means pausing the scheduler job. // For a streaming pipeline, creating a job snapshot to resume from will give // the same effect. State string `json:"state,omitempty"` // Type: Required. The type of the pipeline. This field affects the scheduling // of the pipeline and the type of metrics to show for the pipeline. // // Possible values: // "PIPELINE_TYPE_UNSPECIFIED" - The pipeline type isn't specified. // "PIPELINE_TYPE_BATCH" - A batch pipeline. It runs jobs on a specific // schedule, and each job will automatically terminate once execution is // finished. // "PIPELINE_TYPE_STREAMING" - A streaming pipeline. The underlying job is // continuously running until it is manually terminated by the user. This type // of pipeline doesn't have a schedule to run on, and the linked job gets // created when the pipeline is created. Type string `json:"type,omitempty"` // Workload: Workload information for creating new jobs. Workload *GoogleCloudDatapipelinesV1Workload `json:"workload,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CreateTime") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1Pipeline) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1Pipeline return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1RunPipelineRequest: Request message for // RunPipeline type GoogleCloudDatapipelinesV1RunPipelineRequest struct { } // GoogleCloudDatapipelinesV1RunPipelineResponse: Response message for // RunPipeline type GoogleCloudDatapipelinesV1RunPipelineResponse struct { // Job: Job that was created as part of RunPipeline operation. Job *GoogleCloudDatapipelinesV1Job `json:"job,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Job") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Job") to include in API requests // with the JSON null value. By default, fields with empty values are omitted // from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1RunPipelineResponse) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1RunPipelineResponse return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1RuntimeEnvironment: The environment values to set // at runtime. type GoogleCloudDatapipelinesV1RuntimeEnvironment struct { // AdditionalExperiments: Additional experiment flags for the job. AdditionalExperiments []string `json:"additionalExperiments,omitempty"` // AdditionalUserLabels: Additional user labels to be specified for the job. // Keys and values should follow the restrictions specified in the labeling // restrictions // (https://cloud.google.com/compute/docs/labeling-resources#restrictions) // page. An object containing a list of key/value pairs. Example: { "name": // "wrench", "mass": "1kg", "count": "3" }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // BypassTempDirValidation: Whether to bypass the safety checks for the job's // temporary directory. Use with caution. BypassTempDirValidation bool `json:"bypassTempDirValidation,omitempty"` // EnableStreamingEngine: Whether to enable Streaming Engine for the job. EnableStreamingEngine bool `json:"enableStreamingEngine,omitempty"` // IpConfiguration: Configuration for VM IPs. // // Possible values: // "WORKER_IP_UNSPECIFIED" - The configuration is unknown, or unspecified. // "WORKER_IP_PUBLIC" - Workers should have public IP addresses. // "WORKER_IP_PRIVATE" - Workers should have private IP addresses. IpConfiguration string `json:"ipConfiguration,omitempty"` // KmsKeyName: Name for the Cloud KMS key for the job. The key format is: // projects//locations//keyRings//cryptoKeys/ KmsKeyName string `json:"kmsKeyName,omitempty"` // MachineType: The machine type to use for the job. Defaults to the value from // the template if not specified. MachineType string `json:"machineType,omitempty"` // MaxWorkers: The maximum number of Compute Engine instances to be made // available to your pipeline during execution, from 1 to 1000. MaxWorkers int64 `json:"maxWorkers,omitempty"` // Network: Network to which VMs will be assigned. If empty or unspecified, the // service will use the network "default". Network string `json:"network,omitempty"` // NumWorkers: The initial number of Compute Engine instances for the job. NumWorkers int64 `json:"numWorkers,omitempty"` // ServiceAccountEmail: The email address of the service account to run the job // as. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // Subnetwork: Subnetwork to which VMs will be assigned, if desired. You can // specify a subnetwork using either a complete URL or an abbreviated path. // Expected to be of the form // "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGIO // N/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the // subnetwork is located in a Shared VPC network, you must use the complete // URL. Subnetwork string `json:"subnetwork,omitempty"` // TempLocation: The Cloud Storage path to use for temporary files. Must be a // valid Cloud Storage URL, beginning with `gs://`. TempLocation string `json:"tempLocation,omitempty"` // WorkerRegion: The Compute Engine region // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which // worker processing should occur, e.g. "us-west1". Mutually exclusive with // worker_zone. If neither worker_region nor worker_zone is specified, default // to the control plane's region. WorkerRegion string `json:"workerRegion,omitempty"` // WorkerZone: The Compute Engine zone // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which // worker processing should occur, e.g. "us-west1-a". Mutually exclusive with // worker_region. If neither worker_region nor worker_zone is specified, a zone // in the control plane's region is chosen based on available capacity. If both // `worker_zone` and `zone` are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` // Zone: The Compute Engine availability zone // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) for // launching worker instances to run your pipeline. In the future, worker_zone // will take precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalExperiments") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AdditionalExperiments") to // include in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1RuntimeEnvironment) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1RuntimeEnvironment return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1ScheduleSpec: Details of the schedule the pipeline // runs on. type GoogleCloudDatapipelinesV1ScheduleSpec struct { // NextJobTime: Output only. When the next Scheduler job is going to run. NextJobTime string `json:"nextJobTime,omitempty"` // Schedule: Unix-cron format of the schedule. This information is retrieved // from the linked Cloud Scheduler. Schedule string `json:"schedule,omitempty"` // TimeZone: Timezone ID. This matches the timezone IDs used by the Cloud // Scheduler API. If empty, UTC time is assumed. TimeZone string `json:"timeZone,omitempty"` // ForceSendFields is a list of field names (e.g. "NextJobTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextJobTime") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1ScheduleSpec) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1ScheduleSpec return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1SdkVersion: The version of the SDK used to run the // job. type GoogleCloudDatapipelinesV1SdkVersion struct { // SdkSupportStatus: The support status for this SDK version. // // Possible values: // "UNKNOWN" - Dataflow is unaware of this version. // "SUPPORTED" - This is a known version of an SDK, and is supported. // "STALE" - A newer version of the SDK exists, and an update is recommended. // "DEPRECATED" - This version of the SDK is deprecated and will eventually // be unsupported. // "UNSUPPORTED" - Support for this SDK version has ended and it should no // longer be used. SdkSupportStatus string `json:"sdkSupportStatus,omitempty"` // Version: The version of the SDK used to run the job. Version string `json:"version,omitempty"` // VersionDisplayName: A readable string describing the version of the SDK. VersionDisplayName string `json:"versionDisplayName,omitempty"` // ForceSendFields is a list of field names (e.g. "SdkSupportStatus") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "SdkSupportStatus") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1SdkVersion) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1SdkVersion return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleCloudDatapipelinesV1StopPipelineRequest: Request message for // StopPipeline. type GoogleCloudDatapipelinesV1StopPipelineRequest struct { } // GoogleCloudDatapipelinesV1Workload: Workload details for creating the // pipeline jobs. type GoogleCloudDatapipelinesV1Workload struct { // DataflowFlexTemplateRequest: Template information and additional parameters // needed to launch a Dataflow job using the flex launch API. DataflowFlexTemplateRequest *GoogleCloudDatapipelinesV1LaunchFlexTemplateRequest `json:"dataflowFlexTemplateRequest,omitempty"` // DataflowLaunchTemplateRequest: Template information and additional // parameters needed to launch a Dataflow job using the standard launch API. DataflowLaunchTemplateRequest *GoogleCloudDatapipelinesV1LaunchTemplateRequest `json:"dataflowLaunchTemplateRequest,omitempty"` // ForceSendFields is a list of field names (e.g. // "DataflowFlexTemplateRequest") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields // for more details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "DataflowFlexTemplateRequest") to // include in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleCloudDatapipelinesV1Workload) MarshalJSON() ([]byte, error) { type NoMethod GoogleCloudDatapipelinesV1Workload return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } // GoogleProtobufEmpty: A generic empty message that you can re-use to avoid // defining duplicated empty messages in your APIs. A typical example is to use // it as the request or the response type of an API method. For instance: // service Foo { rpc Bar(google.protobuf.Empty) returns // (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` } // GoogleRpcStatus: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs and RPC // APIs. It is used by gRPC (https://github.com/grpc). Each `Status` message // contains three pieces of data: error code, error message, and error details. // You can find out more about this error model and how to work with it in the // API Design Guide (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of google.rpc.Code. Code int64 `json:"code,omitempty"` // Details: A list of messages that carry the error details. There is a common // set of message types for APIs to use. Details []googleapi.RawMessage `json:"details,omitempty"` // Message: A developer-facing error message, which should be in English. Any // user-facing error message should be localized and sent in the // google.rpc.Status.details field, or localized by the client. Message string `json:"message,omitempty"` // ForceSendFields is a list of field names (e.g. "Code") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Code") to include in API requests // with the JSON null value. By default, fields with empty values are omitted // from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { type NoMethod GoogleRpcStatus return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } type ProjectsLocationsPipelinesCreateCall struct { s *Service parent string googleclouddatapipelinesv1pipeline *GoogleCloudDatapipelinesV1Pipeline urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Create: 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. // // - parent: The location name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID`. func (r *ProjectsLocationsPipelinesService) Create(parent string, googleclouddatapipelinesv1pipeline *GoogleCloudDatapipelinesV1Pipeline) *ProjectsLocationsPipelinesCreateCall { c := &ProjectsLocationsPipelinesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent c.googleclouddatapipelinesv1pipeline = googleclouddatapipelinesv1pipeline return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesCreateCall) Context(ctx context.Context) *ProjectsLocationsPipelinesCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddatapipelinesv1pipeline) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/pipelines") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.create" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1Pipeline.ServerResponse.Header or (if a response // was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1Pipeline, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1Pipeline{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Delete: Deletes a pipeline. If a scheduler job is attached to the pipeline, // it will be deleted. // // - name: The pipeline name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. func (r *ProjectsLocationsPipelinesService) Delete(name string) *ProjectsLocationsPipelinesDeleteCall { c := &ProjectsLocationsPipelinesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesDeleteCall) Context(ctx context.Context) *ProjectsLocationsPipelinesDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.delete" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified was // returned. func (c *ProjectsLocationsPipelinesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesGetCall struct { s *Service name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // Get: 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. // // - name: The pipeline name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. func (r *ProjectsLocationsPipelinesService) Get(name string) *ProjectsLocationsPipelinesGetCall { c := &ProjectsLocationsPipelinesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. func (c *ProjectsLocationsPipelinesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesGetCall) Context(ctx context.Context) *ProjectsLocationsPipelinesGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.get" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1Pipeline.ServerResponse.Header or (if a response // was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1Pipeline, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1Pipeline{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesListCall struct { s *Service parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Lists pipelines. Returns a "FORBIDDEN" error if the caller doesn't // have permission to access it. // // - parent: The location name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID`. func (r *ProjectsLocationsPipelinesService) List(parent string) *ProjectsLocationsPipelinesListCall { c := &ProjectsLocationsPipelinesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. If unspecified, all pipelines will be returned. // Multiple filters can be applied and must be comma separated. Fields eligible // for filtering are: + `type`: The type of the pipeline (streaming or batch). // Allowed values are `ALL`, `BATCH`, and `STREAMING`. + `status`: The activity // status of the pipeline. Allowed values are `ALL`, `ACTIVE`, `ARCHIVED`, and // `PAUSED`. For example, to limit results to active batch processing // pipelines: type:BATCH,status:ACTIVE func (c *ProjectsLocationsPipelinesListCall) Filter(filter string) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("filter", filter) return c } // PageSize sets the optional parameter "pageSize": The maximum number of // entities to return. The service may return fewer than this value, even if // there are additional pages. If unspecified, the max limit is yet to be // determined by the backend implementation. func (c *ProjectsLocationsPipelinesListCall) PageSize(pageSize int64) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received // from a previous `ListPipelines` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to // `ListPipelines` must match the call that provided the page token. func (c *ProjectsLocationsPipelinesListCall) PageToken(pageToken string) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. func (c *ProjectsLocationsPipelinesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesListCall) Context(ctx context.Context) *ProjectsLocationsPipelinesListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/pipelines") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.list" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1ListPipelinesResponse.ServerResponse.Header or // (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1ListPipelinesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1ListPipelinesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. func (c *ProjectsLocationsPipelinesListCall) Pages(ctx context.Context, f func(*GoogleCloudDatapipelinesV1ListPipelinesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { x, err := c.Do() if err != nil { return err } if err := f(x); err != nil { return err } if x.NextPageToken == "" { return nil } c.PageToken(x.NextPageToken) } } type ProjectsLocationsPipelinesPatchCall struct { s *Service name string googleclouddatapipelinesv1pipeline *GoogleCloudDatapipelinesV1Pipeline urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Patch: 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. // // - 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 // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#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 (https://cloud.google.com/about/locations#region). * `PIPELINE_ID` // is the ID of the pipeline. Must be unique for the selected project and // location. func (r *ProjectsLocationsPipelinesService) Patch(name string, googleclouddatapipelinesv1pipeline *GoogleCloudDatapipelinesV1Pipeline) *ProjectsLocationsPipelinesPatchCall { c := &ProjectsLocationsPipelinesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name c.googleclouddatapipelinesv1pipeline = googleclouddatapipelinesv1pipeline return c } // UpdateMask sets the optional parameter "updateMask": The list of fields to // be updated. func (c *ProjectsLocationsPipelinesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsPipelinesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesPatchCall) Context(ctx context.Context) *ProjectsLocationsPipelinesPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddatapipelinesv1pipeline) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.patch" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1Pipeline.ServerResponse.Header or (if a response // was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1Pipeline, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1Pipeline{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesRunCall struct { s *Service name string googleclouddatapipelinesv1runpipelinerequest *GoogleCloudDatapipelinesV1RunPipelineRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Run: 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. // // - name: The pipeline name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. func (r *ProjectsLocationsPipelinesService) Run(name string, googleclouddatapipelinesv1runpipelinerequest *GoogleCloudDatapipelinesV1RunPipelineRequest) *ProjectsLocationsPipelinesRunCall { c := &ProjectsLocationsPipelinesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name c.googleclouddatapipelinesv1runpipelinerequest = googleclouddatapipelinesv1runpipelinerequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesRunCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesRunCall) Context(ctx context.Context) *ProjectsLocationsPipelinesRunCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesRunCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesRunCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddatapipelinesv1runpipelinerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:run") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.run" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1RunPipelineResponse.ServerResponse.Header or (if // a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesRunCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1RunPipelineResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1RunPipelineResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesStopCall struct { s *Service name string googleclouddatapipelinesv1stoppipelinerequest *GoogleCloudDatapipelinesV1StopPipelineRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Stop: 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. // // - name: The pipeline name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. func (r *ProjectsLocationsPipelinesService) Stop(name string, googleclouddatapipelinesv1stoppipelinerequest *GoogleCloudDatapipelinesV1StopPipelineRequest) *ProjectsLocationsPipelinesStopCall { c := &ProjectsLocationsPipelinesStopCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name c.googleclouddatapipelinesv1stoppipelinerequest = googleclouddatapipelinesv1stoppipelinerequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesStopCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesStopCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesStopCall) Context(ctx context.Context) *ProjectsLocationsPipelinesStopCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesStopCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesStopCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddatapipelinesv1stoppipelinerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:stop") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.stop" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1Pipeline.ServerResponse.Header or (if a response // was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesStopCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1Pipeline, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1Pipeline{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } type ProjectsLocationsPipelinesJobsListCall struct { s *Service parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Lists jobs for a given pipeline. Throws a "FORBIDDEN" error if the // caller doesn't have permission to access it. // // - parent: The pipeline name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. func (r *ProjectsLocationsPipelinesJobsService) List(parent string) *ProjectsLocationsPipelinesJobsListCall { c := &ProjectsLocationsPipelinesJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // PageSize sets the optional parameter "pageSize": The maximum number of // entities to return. The service may return fewer than this value, even if // there are additional pages. If unspecified, the max limit will be determined // by the backend implementation. func (c *ProjectsLocationsPipelinesJobsListCall) PageSize(pageSize int64) *ProjectsLocationsPipelinesJobsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received // from a previous `ListJobs` call. Provide this to retrieve the subsequent // page. When paginating, all other parameters provided to `ListJobs` must // match the call that provided the page token. func (c *ProjectsLocationsPipelinesJobsListCall) PageToken(pageToken string) *ProjectsLocationsPipelinesJobsListCall { c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. func (c *ProjectsLocationsPipelinesJobsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesJobsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. func (c *ProjectsLocationsPipelinesJobsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesJobsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. func (c *ProjectsLocationsPipelinesJobsListCall) Context(ctx context.Context) *ProjectsLocationsPipelinesJobsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. func (c *ProjectsLocationsPipelinesJobsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsLocationsPipelinesJobsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "datapipelines.projects.locations.pipelines.jobs.list" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDatapipelinesV1ListJobsResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsLocationsPipelinesJobsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatapipelinesV1ListJobsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, gensupport.WrapError(&googleapi.Error{ Code: res.StatusCode, Header: res.Header, }) } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } ret := &GoogleCloudDatapipelinesV1ListJobsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. func (c *ProjectsLocationsPipelinesJobsListCall) Pages(ctx context.Context, f func(*GoogleCloudDatapipelinesV1ListJobsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { x, err := c.Do() if err != nil { return err } if err := f(x); err != nil { return err } if x.NextPageToken == "" { return nil } c.PageToken(x.NextPageToken) } }