google-apis-datapipelines_v1 0.2.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 136b198af712e3e7dc420bb43a35a82b6e87ff1a62605c82c8e69f33621562d6
4
- data.tar.gz: 506852d4b79ac5c4fa8323c960cda3e569e050444edd59ed4593efcbad600674
3
+ metadata.gz: 80d81a8e1398a93157445c4514dd56a349140ae6075b9c0260f55dd942f52468
4
+ data.tar.gz: 4d7e3274e699850a0339579f5eaa69186e183eb92fc8ebc9abf07add94f0bc3f
5
5
  SHA512:
6
- metadata.gz: 80b5647ef27f639b88dd12059749a3f981a33244ec2d00f9db45a2e81b84fb41fdb837c4244fc910aad2dce438f405421d50b88bf6b909740c80114f310126a0
7
- data.tar.gz: 7de9e304b12698f8aa145a50c22251af062a58be947ac057fa8a4fdbff304a6a02a57b950521951568e494d49ee49b4df83a7dd4d5a2a955ee12e1023a696f1e
6
+ metadata.gz: 7ef61e3f774eb0dd67b0abbf0a1c7138b1e9c8d996c9c49ae7984ff2e61d0968836498ed21c24ca0235ee5830b11f67d3af41c0719cef53f300b158213b25581
7
+ data.tar.gz: fa63556e5b50c416da6980cfd8ee7b5e5416f0e9d91ad8f5aa8dabc68815b3152afff20344e74fffdec7875e02f26028e072c60aa06fe49520c86d331ab0e9b6
data/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Release history for google-apis-datapipelines_v1
2
2
 
3
+ ### v0.5.0 (2022-03-30)
4
+
5
+ * Regenerated from discovery document revision 20220319
6
+
7
+ ### v0.4.0 (2022-01-13)
8
+
9
+ * Regenerated from discovery document revision 20220103
10
+ * Regenerated using generator version 0.4.1
11
+
12
+ ### v0.3.0 (2021-12-16)
13
+
14
+ * Regenerated from discovery document revision 20211203
15
+ * Unspecified changes
16
+
3
17
  ### v0.2.0 (2021-11-10)
4
18
 
5
19
  * Regenerated from discovery document revision 20211029
data/OVERVIEW.md CHANGED
@@ -51,7 +51,7 @@ require "google/apis/datapipelines_v1"
51
51
  client = Google::Apis::DatapipelinesV1::DatapipelinesService.new
52
52
 
53
53
  # Authenticate calls
54
- client.authentication = # ... use the googleauth gem to create credentials
54
+ client.authorization = # ... use the googleauth gem to create credentials
55
55
  ```
56
56
 
57
57
  See the class reference docs for information on the methods you can call from a client.
@@ -447,6 +447,33 @@ module Google
447
447
  end
448
448
  end
449
449
 
450
+ # Response message for ListJobs
451
+ class GoogleCloudDatapipelinesV1ListJobsResponse
452
+ include Google::Apis::Core::Hashable
453
+
454
+ # Results that were accessible to the caller. Results are always in descending
455
+ # order of job creation date.
456
+ # Corresponds to the JSON property `jobs`
457
+ # @return [Array<Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1Job>]
458
+ attr_accessor :jobs
459
+
460
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
461
+ # field is omitted, there are no subsequent pages.
462
+ # Corresponds to the JSON property `nextPageToken`
463
+ # @return [String]
464
+ attr_accessor :next_page_token
465
+
466
+ def initialize(**args)
467
+ update!(**args)
468
+ end
469
+
470
+ # Update properties of this object
471
+ def update!(**args)
472
+ @jobs = args[:jobs] if args.key?(:jobs)
473
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
474
+ end
475
+ end
476
+
450
477
  # Response message for ListPipelines.
451
478
  class GoogleCloudDatapipelinesV1ListPipelinesResponse
452
479
  include Google::Apis::Core::Hashable
@@ -474,8 +501,8 @@ module Google
474
501
  end
475
502
  end
476
503
 
477
- # The main pipeline entity and all the needed metadata to launch and manage
478
- # linked jobs.
504
+ # The main pipeline entity and all the necessary metadata for launching and
505
+ # managing linked jobs.
479
506
  class GoogleCloudDatapipelinesV1Pipeline
480
507
  include Google::Apis::Core::Hashable
481
508
 
@@ -506,13 +533,13 @@ module Google
506
533
  # pipelines/PIPELINE_ID`. * `PROJECT_ID` can contain letters ([A-Za-z]), numbers
507
534
  # ([0-9]), hyphens (-), colons (:), and periods (.). For more information, see [
508
535
  # Identifying projects](https://cloud.google.com/resource-manager/docs/creating-
509
- # managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID
536
+ # managing-projects#identifying_projects). * `LOCATION_ID` is the canonical ID
510
537
  # for the pipeline's location. The list of available locations can be obtained
511
- # by calling ListLocations. Note that the Data Pipelines service is not
512
- # available in all regions. It depends on Cloud Scheduler, an App Engine
513
- # application, so it's only available in [App Engine regions](https://cloud.
514
- # google.com/about/locations#region). * `PIPELINE_ID` is the ID of the pipeline.
515
- # Must be unique for the selected project and location.
538
+ # by calling `google.cloud.location.Locations.ListLocations`. Note that the Data
539
+ # Pipelines service is not available in all regions. It depends on Cloud
540
+ # Scheduler, an App Engine application, so it's only available in [App Engine
541
+ # regions](https://cloud.google.com/about/locations#region). * `PIPELINE_ID` is
542
+ # the ID of the pipeline. Must be unique for the selected project and location.
516
543
  # Corresponds to the JSON property `name`
517
544
  # @return [String]
518
545
  attr_accessor :name
@@ -847,8 +874,7 @@ module Google
847
874
  # A generic empty message that you can re-use to avoid defining duplicated empty
848
875
  # messages in your APIs. A typical example is to use it as the request or the
849
876
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
850
- # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
851
- # `Empty` is empty JSON object ````.
877
+ # protobuf.Empty) returns (google.protobuf.Empty); `
852
878
  class GoogleProtobufEmpty
853
879
  include Google::Apis::Core::Hashable
854
880
 
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module DatapipelinesV1
18
18
  # Version of the google-apis-datapipelines_v1 gem
19
- GEM_VERSION = "0.2.0"
19
+ GEM_VERSION = "0.5.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.4.0"
22
+ GENERATOR_VERSION = "0.4.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20211029"
25
+ REVISION = "20220319"
26
26
  end
27
27
  end
28
28
  end
@@ -64,6 +64,12 @@ module Google
64
64
  include Google::Apis::Core::JsonObjectSupport
65
65
  end
66
66
 
67
+ class GoogleCloudDatapipelinesV1ListJobsResponse
68
+ class Representation < Google::Apis::Core::JsonRepresentation; end
69
+
70
+ include Google::Apis::Core::JsonObjectSupport
71
+ end
72
+
67
73
  class GoogleCloudDatapipelinesV1ListPipelinesResponse
68
74
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
75
 
@@ -226,6 +232,15 @@ module Google
226
232
  end
227
233
  end
228
234
 
235
+ class GoogleCloudDatapipelinesV1ListJobsResponse
236
+ # @private
237
+ class Representation < Google::Apis::Core::JsonRepresentation
238
+ collection :jobs, as: 'jobs', class: Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1Job, decorator: Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1Job::Representation
239
+
240
+ property :next_page_token, as: 'nextPageToken'
241
+ end
242
+ end
243
+
229
244
  class GoogleCloudDatapipelinesV1ListPipelinesResponse
230
245
  # @private
231
246
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -50,8 +50,8 @@ module Google
50
50
  @batch_path = 'batch'
51
51
  end
52
52
 
53
- # Lists pipelines. Returns a "NOT_FOUND" error if the list is empty. Returns a "
54
- # FORBIDDEN" error if the caller doesn't have permission to access it.
53
+ # Lists pipelines. Returns a "FORBIDDEN" error if the caller doesn't have
54
+ # permission to access it.
55
55
  # @param [String] parent
56
56
  # Required. The location name. For example: `projects/PROJECT_ID/locations/
57
57
  # LOCATION_ID`.
@@ -60,11 +60,9 @@ module Google
60
60
  # pipelines will be returned. Multiple filters can be applied and must be comma
61
61
  # separated. Fields eligible for filtering are: + `type`: The type of the
62
62
  # pipeline (streaming or batch). Allowed values are `ALL`, `BATCH`, and `
63
- # STREAMING`. + `executor_type`: The type of pipeline execution layer. This is
64
- # always Dataflow for now, but more executors may be added later. Allowed values
65
- # are `ALL` and `DATAFLOW`. + `status`: The activity status of the pipeline.
66
- # Allowed values are `ALL`, `ACTIVE`, `ARCHIVED`, and `PAUSED`. For example, to
67
- # limit results to active batch processing pipelines: type:BATCH,status:ACTIVE
63
+ # STREAMING`. + `status`: The activity status of the pipeline. Allowed values
64
+ # are `ALL`, `ACTIVE`, `ARCHIVED`, and `PAUSED`. For example, to limit results
65
+ # to active batch processing pipelines: type:BATCH,status:ACTIVE
68
66
  # @param [Fixnum] page_size
69
67
  # The maximum number of entities to return. The service may return fewer than
70
68
  # this value, even if there are additional pages. If unspecified, the max limit
@@ -176,7 +174,7 @@ module Google
176
174
  # exists. Returns a "FORBIDDEN" error if the caller doesn't have permission to
177
175
  # access it.
178
176
  # @param [String] name
179
- # Required. The pipeeline name. For example: `projects/PROJECT_ID/locations/
177
+ # Required. The pipeline name. For example: `projects/PROJECT_ID/locations/
180
178
  # LOCATION_ID/pipelines/PIPELINE_ID`.
181
179
  # @param [String] fields
182
180
  # Selector specifying which fields to include in a partial response.
@@ -205,8 +203,8 @@ module Google
205
203
  execute_or_queue_command(command, &block)
206
204
  end
207
205
 
208
- # Updates a pipeline. If successful, the updated [Pipeline] is returned. Returns
209
- # `NOT_FOUND` if the pipeline doesn't exist. If UpdatePipeline does not return
206
+ # Updates a pipeline. If successful, the updated Pipeline is returned. Returns `
207
+ # NOT_FOUND` if the pipeline doesn't exist. If UpdatePipeline does not return
210
208
  # successfully, you can retry the UpdatePipeline request until you receive a
211
209
  # successful response.
212
210
  # @param [String] name
@@ -214,13 +212,13 @@ module Google
214
212
  # pipelines/PIPELINE_ID`. * `PROJECT_ID` can contain letters ([A-Za-z]), numbers
215
213
  # ([0-9]), hyphens (-), colons (:), and periods (.). For more information, see [
216
214
  # Identifying projects](https://cloud.google.com/resource-manager/docs/creating-
217
- # managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID
215
+ # managing-projects#identifying_projects). * `LOCATION_ID` is the canonical ID
218
216
  # for the pipeline's location. The list of available locations can be obtained
219
- # by calling ListLocations. Note that the Data Pipelines service is not
220
- # available in all regions. It depends on Cloud Scheduler, an App Engine
221
- # application, so it's only available in [App Engine regions](https://cloud.
222
- # google.com/about/locations#region). * `PIPELINE_ID` is the ID of the pipeline.
223
- # Must be unique for the selected project and location.
217
+ # by calling `google.cloud.location.Locations.ListLocations`. Note that the Data
218
+ # Pipelines service is not available in all regions. It depends on Cloud
219
+ # Scheduler, an App Engine application, so it's only available in [App Engine
220
+ # regions](https://cloud.google.com/about/locations#region). * `PIPELINE_ID` is
221
+ # the ID of the pipeline. Must be unique for the selected project and location.
224
222
  # @param [Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1Pipeline] google_cloud_datapipelines_v1_pipeline_object
225
223
  # @param [String] update_mask
226
224
  # The list of fields to be updated.
@@ -257,7 +255,7 @@ module Google
257
255
  # Creates a job for the specified pipeline directly. You can use this method
258
256
  # when the internal scheduler is not configured and you want to trigger the job
259
257
  # directly or through an external system. Returns a "NOT_FOUND" error if the
260
- # pipeline doesn't exist. Returns a "FOBIDDEN" error if the user doesn't have
258
+ # pipeline doesn't exist. Returns a "FORBIDDEN" error if the user doesn't have
261
259
  # permission to access the pipeline or run jobs for the pipeline.
262
260
  # @param [String] name
263
261
  # Required. The pipeline name. For example: `projects/PROJECT_ID/locations/
@@ -294,8 +292,7 @@ module Google
294
292
 
295
293
  # Freezes pipeline execution permanently. If there's a corresponding scheduler
296
294
  # entry, it's deleted, and the pipeline state is changed to "ARCHIVED". However,
297
- # pipeline metadata is retained. Upon success, the pipeline state is updated to
298
- # ARCHIVED.
295
+ # pipeline metadata is retained.
299
296
  # @param [String] name
300
297
  # Required. The pipeline name. For example: `projects/PROJECT_ID/locations/
301
298
  # LOCATION_ID/pipelines/PIPELINE_ID`.
@@ -328,6 +325,48 @@ module Google
328
325
  command.query['quotaUser'] = quota_user unless quota_user.nil?
329
326
  execute_or_queue_command(command, &block)
330
327
  end
328
+
329
+ # Lists jobs for a given pipeline. Throws a "FORBIDDEN" error if the caller
330
+ # doesn't have permission to access it.
331
+ # @param [String] parent
332
+ # Required. The pipeline name. For example: `projects/PROJECT_ID/locations/
333
+ # LOCATION_ID/pipelines/PIPELINE_ID`.
334
+ # @param [Fixnum] page_size
335
+ # The maximum number of entities to return. The service may return fewer than
336
+ # this value, even if there are additional pages. If unspecified, the max limit
337
+ # will be determined by the backend implementation.
338
+ # @param [String] page_token
339
+ # A page token, received from a previous `ListJobs` call. Provide this to
340
+ # retrieve the subsequent page. When paginating, all other parameters provided
341
+ # to `ListJobs` must match the call that provided the page token.
342
+ # @param [String] fields
343
+ # Selector specifying which fields to include in a partial response.
344
+ # @param [String] quota_user
345
+ # Available to use for quota purposes for server-side applications. Can be any
346
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
347
+ # @param [Google::Apis::RequestOptions] options
348
+ # Request-specific options
349
+ #
350
+ # @yield [result, err] Result & error if block supplied
351
+ # @yieldparam result [Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1ListJobsResponse] parsed result object
352
+ # @yieldparam err [StandardError] error object if request failed
353
+ #
354
+ # @return [Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1ListJobsResponse]
355
+ #
356
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
357
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
358
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
359
+ def list_project_location_pipeline_jobs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
360
+ command = make_simple_command(:get, 'v1/{+parent}/jobs', options)
361
+ command.response_representation = Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1ListJobsResponse::Representation
362
+ command.response_class = Google::Apis::DatapipelinesV1::GoogleCloudDatapipelinesV1ListJobsResponse
363
+ command.params['parent'] = parent unless parent.nil?
364
+ command.query['pageSize'] = page_size unless page_size.nil?
365
+ command.query['pageToken'] = page_token unless page_token.nil?
366
+ command.query['fields'] = fields unless fields.nil?
367
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
368
+ execute_or_queue_command(command, &block)
369
+ end
331
370
 
332
371
  protected
333
372
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-datapipelines_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-11-15 00:00:00.000000000 Z
11
+ date: 2022-04-04 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datapipelines_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-datapipelines_v1/v0.2.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-datapipelines_v1/v0.5.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datapipelines_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.2.17
78
+ rubygems_version: 3.3.5
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Data pipelines API V1