google-cloud-data_catalog-lineage-v1 0.a → 0.2.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.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +149 -0
  4. data/README.md +144 -8
  5. data/lib/google/cloud/data_catalog/lineage/v1/lineage/client.rb +1971 -0
  6. data/lib/google/cloud/data_catalog/lineage/v1/lineage/credentials.rb +49 -0
  7. data/lib/google/cloud/data_catalog/lineage/v1/lineage/operations.rb +770 -0
  8. data/lib/google/cloud/data_catalog/lineage/v1/lineage/paths.rb +115 -0
  9. data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/client.rb +1549 -0
  10. data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/operations.rb +795 -0
  11. data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/service_stub.rb +1001 -0
  12. data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest.rb +58 -0
  13. data/lib/google/cloud/data_catalog/lineage/v1/lineage.rb +61 -0
  14. data/lib/google/cloud/data_catalog/lineage/v1/rest.rb +39 -0
  15. data/lib/google/cloud/data_catalog/lineage/v1/version.rb +7 -2
  16. data/lib/google/cloud/data_catalog/lineage/v1.rb +47 -0
  17. data/lib/google/cloud/datacatalog/lineage/v1/lineage_pb.rb +241 -0
  18. data/lib/google/cloud/datacatalog/lineage/v1/lineage_services_pb.rb +104 -0
  19. data/lib/google-cloud-data_catalog-lineage-v1.rb +21 -0
  20. data/proto_docs/README.md +4 -0
  21. data/proto_docs/google/api/client.rb +318 -0
  22. data/proto_docs/google/api/field_behavior.rb +71 -0
  23. data/proto_docs/google/api/launch_stage.rb +71 -0
  24. data/proto_docs/google/api/resource.rb +222 -0
  25. data/proto_docs/google/cloud/datacatalog/lineage/v1/lineage.rb +707 -0
  26. data/proto_docs/google/longrunning/operations.rb +164 -0
  27. data/proto_docs/google/protobuf/any.rb +141 -0
  28. data/proto_docs/google/protobuf/duration.rb +98 -0
  29. data/proto_docs/google/protobuf/empty.rb +34 -0
  30. data/proto_docs/google/protobuf/field_mask.rb +229 -0
  31. data/proto_docs/google/protobuf/struct.rb +96 -0
  32. data/proto_docs/google/protobuf/timestamp.rb +129 -0
  33. data/proto_docs/google/rpc/status.rb +48 -0
  34. metadata +192 -12
@@ -0,0 +1,707 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module DataCatalog
23
+ module Lineage
24
+ module V1
25
+ # A process is the definition of a data transformation operation.
26
+ # @!attribute [rw] name
27
+ # @return [::String]
28
+ # Immutable. The resource name of the lineage process. Format:
29
+ # `projects/{project}/locations/{location}/processes/{process}`.
30
+ # Can be specified or auto-assigned.
31
+ # \\{process} must be not longer than 200 characters and only
32
+ # contain characters in a set: `a-zA-Z0-9_-:.`
33
+ # @!attribute [rw] display_name
34
+ # @return [::String]
35
+ # Optional. A human-readable name you can set to display in a user interface.
36
+ # Must be not longer than 200 characters and only contain UTF-8 letters
37
+ # or numbers, spaces or characters like `_-:&.`
38
+ # @!attribute [rw] attributes
39
+ # @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
40
+ # Optional. The attributes of the process. Can be anything, for example,
41
+ # "author". Up to 100 attributes are allowed.
42
+ # @!attribute [rw] origin
43
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Origin]
44
+ # Optional. The origin of this process and its runs and lineage events.
45
+ class Process
46
+ include ::Google::Protobuf::MessageExts
47
+ extend ::Google::Protobuf::MessageExts::ClassMethods
48
+
49
+ # @!attribute [rw] key
50
+ # @return [::String]
51
+ # @!attribute [rw] value
52
+ # @return [::Google::Protobuf::Value]
53
+ class AttributesEntry
54
+ include ::Google::Protobuf::MessageExts
55
+ extend ::Google::Protobuf::MessageExts::ClassMethods
56
+ end
57
+ end
58
+
59
+ # A lineage run represents an execution of a process that creates
60
+ # lineage events.
61
+ # @!attribute [rw] name
62
+ # @return [::String]
63
+ # Immutable. The resource name of the run. Format:
64
+ # `projects/{project}/locations/{location}/processes/{process}/runs/{run}`.
65
+ # Can be specified or auto-assigned.
66
+ # \\{run} must be not longer than 200 characters and only
67
+ # contain characters in a set: `a-zA-Z0-9_-:.`
68
+ # @!attribute [rw] display_name
69
+ # @return [::String]
70
+ # Optional. A human-readable name you can set to display in a user interface.
71
+ # Must be not longer than 1024 characters and only contain UTF-8 letters
72
+ # or numbers, spaces or characters like `_-:&.`
73
+ # @!attribute [rw] attributes
74
+ # @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
75
+ # Optional. The attributes of the run. Can be anything, for example, a string
76
+ # with an SQL request. Up to 100 attributes are allowed.
77
+ # @!attribute [rw] start_time
78
+ # @return [::Google::Protobuf::Timestamp]
79
+ # Required. The timestamp of the start of the run.
80
+ # @!attribute [rw] end_time
81
+ # @return [::Google::Protobuf::Timestamp]
82
+ # Optional. The timestamp of the end of the run.
83
+ # @!attribute [rw] state
84
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Run::State]
85
+ # Required. The state of the run.
86
+ class Run
87
+ include ::Google::Protobuf::MessageExts
88
+ extend ::Google::Protobuf::MessageExts::ClassMethods
89
+
90
+ # @!attribute [rw] key
91
+ # @return [::String]
92
+ # @!attribute [rw] value
93
+ # @return [::Google::Protobuf::Value]
94
+ class AttributesEntry
95
+ include ::Google::Protobuf::MessageExts
96
+ extend ::Google::Protobuf::MessageExts::ClassMethods
97
+ end
98
+
99
+ # The current state of the run.
100
+ module State
101
+ # The state is unknown. The true state may be any of the below or a
102
+ # different state that is not supported here explicitly.
103
+ UNKNOWN = 0
104
+
105
+ # The run is still executing.
106
+ STARTED = 1
107
+
108
+ # The run completed.
109
+ COMPLETED = 2
110
+
111
+ # The run failed.
112
+ FAILED = 3
113
+
114
+ # The run aborted.
115
+ ABORTED = 4
116
+ end
117
+ end
118
+
119
+ # A lineage event represents an operation on assets. Within the operation, the
120
+ # data flows from the source to the target defined in the links field.
121
+ # @!attribute [rw] name
122
+ # @return [::String]
123
+ # Immutable. The resource name of the lineage event.
124
+ # Format:
125
+ # `projects/{project}/locations/{location}/processes/{process}/runs/{run}/lineageEvents/{lineage_event}`.
126
+ # Can be specified or auto-assigned.
127
+ # \\{lineage_event} must be not longer than 200 characters and only
128
+ # contain characters in a set: `a-zA-Z0-9_-:.`
129
+ # @!attribute [rw] links
130
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::EventLink>]
131
+ # Optional. List of source-target pairs. Can't contain more than 100 tuples.
132
+ # @!attribute [rw] start_time
133
+ # @return [::Google::Protobuf::Timestamp]
134
+ # Optional. The beginning of the transformation which resulted in this
135
+ # lineage event. For streaming scenarios, it should be the beginning of the
136
+ # period from which the lineage is being reported.
137
+ # @!attribute [rw] end_time
138
+ # @return [::Google::Protobuf::Timestamp]
139
+ # Optional. The end of the transformation which resulted in this lineage
140
+ # event. For streaming scenarios, it should be the end of the period from
141
+ # which the lineage is being reported.
142
+ class LineageEvent
143
+ include ::Google::Protobuf::MessageExts
144
+ extend ::Google::Protobuf::MessageExts::ClassMethods
145
+ end
146
+
147
+ # A lineage between source and target entities.
148
+ # @!attribute [rw] source
149
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
150
+ # Required. Reference to the source entity
151
+ # @!attribute [rw] target
152
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
153
+ # Required. Reference to the target entity
154
+ class EventLink
155
+ include ::Google::Protobuf::MessageExts
156
+ extend ::Google::Protobuf::MessageExts::ClassMethods
157
+ end
158
+
159
+ # The soft reference to everything you can attach a lineage event to.
160
+ # @!attribute [rw] fully_qualified_name
161
+ # @return [::String]
162
+ # Required. Fully Qualified Name of the entity. Useful for referencing
163
+ # entities that aren't represented as GCP resources, for example, tables in
164
+ # Dataproc Metastore API.
165
+ #
166
+ # Examples:
167
+ #
168
+ # * `bigquery:dataset.project_id.dataset_id`
169
+ # * `bigquery:table.project_id.dataset_id.table_id`
170
+ # * `pubsub:project_id.topic_id`
171
+ # * `dataproc_metastore:projectId.locationId.instanceId.databaseId.tableId`
172
+ class EntityReference
173
+ include ::Google::Protobuf::MessageExts
174
+ extend ::Google::Protobuf::MessageExts::ClassMethods
175
+ end
176
+
177
+ # Metadata describing the operation.
178
+ # @!attribute [r] state
179
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::OperationMetadata::State]
180
+ # Output only. The current operation state.
181
+ # @!attribute [r] operation_type
182
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::OperationMetadata::Type]
183
+ # Output only. The type of the operation being performed.
184
+ # @!attribute [r] resource
185
+ # @return [::String]
186
+ # Output only. The [relative name]
187
+ # (https://cloud.google.com//apis/design/resource_names#relative_resource_name)
188
+ # of the resource being operated on.
189
+ # @!attribute [r] resource_uuid
190
+ # @return [::String]
191
+ # Output only. The UUID of the resource being operated on.
192
+ # @!attribute [r] create_time
193
+ # @return [::Google::Protobuf::Timestamp]
194
+ # Output only. The timestamp of the operation submission to the server.
195
+ # @!attribute [r] end_time
196
+ # @return [::Google::Protobuf::Timestamp]
197
+ # Output only. The timestamp of the operation termination, regardless of its
198
+ # success. This field is unset if the operation is still ongoing.
199
+ class OperationMetadata
200
+ include ::Google::Protobuf::MessageExts
201
+ extend ::Google::Protobuf::MessageExts::ClassMethods
202
+
203
+ # An enum with the state of the operation.
204
+ module State
205
+ # Unused.
206
+ STATE_UNSPECIFIED = 0
207
+
208
+ # The operation has been created but is not yet started.
209
+ PENDING = 1
210
+
211
+ # The operation is underway.
212
+ RUNNING = 2
213
+
214
+ # The operation completed successfully.
215
+ SUCCEEDED = 3
216
+
217
+ # The operation is no longer running and did not succeed.
218
+ FAILED = 4
219
+ end
220
+
221
+ # Type of the long running operation.
222
+ module Type
223
+ # Unused.
224
+ TYPE_UNSPECIFIED = 0
225
+
226
+ # The resource deletion operation.
227
+ DELETE = 1
228
+ end
229
+ end
230
+
231
+ # Request message for
232
+ # [CreateProcess][google.cloud.datacatalog.lineage.v1.CreateProcess].
233
+ # @!attribute [rw] parent
234
+ # @return [::String]
235
+ # Required. The name of the project and its location that should own the
236
+ # process.
237
+ # @!attribute [rw] process
238
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Process]
239
+ # Required. The process to create.
240
+ # @!attribute [rw] request_id
241
+ # @return [::String]
242
+ # A unique identifier for this request. Restricted to 36 ASCII characters.
243
+ # A random UUID is recommended. This request is idempotent only if a
244
+ # `request_id` is provided.
245
+ class CreateProcessRequest
246
+ include ::Google::Protobuf::MessageExts
247
+ extend ::Google::Protobuf::MessageExts::ClassMethods
248
+ end
249
+
250
+ # Request message for
251
+ # [UpdateProcess][google.cloud.datacatalog.lineage.v1.UpdateProcess].
252
+ # @!attribute [rw] process
253
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Process]
254
+ # Required. The lineage process to update.
255
+ #
256
+ # The process's `name` field is used to identify the process to update.
257
+ # @!attribute [rw] update_mask
258
+ # @return [::Google::Protobuf::FieldMask]
259
+ # The list of fields to update. Currently not used. The whole message is
260
+ # updated.
261
+ # @!attribute [rw] allow_missing
262
+ # @return [::Boolean]
263
+ # If set to true and the process is not found, the request inserts it.
264
+ class UpdateProcessRequest
265
+ include ::Google::Protobuf::MessageExts
266
+ extend ::Google::Protobuf::MessageExts::ClassMethods
267
+ end
268
+
269
+ # Request message for
270
+ # [GetProcess][google.cloud.datacatalog.lineage.v1.GetProcess].
271
+ # @!attribute [rw] name
272
+ # @return [::String]
273
+ # Required. The name of the process to get.
274
+ class GetProcessRequest
275
+ include ::Google::Protobuf::MessageExts
276
+ extend ::Google::Protobuf::MessageExts::ClassMethods
277
+ end
278
+
279
+ # Request message for
280
+ # [ListProcesses][google.cloud.datacatalog.lineage.v1.ListProcesses].
281
+ # @!attribute [rw] parent
282
+ # @return [::String]
283
+ # Required. The name of the project and its location that owns this
284
+ # collection of processes.
285
+ # @!attribute [rw] page_size
286
+ # @return [::Integer]
287
+ # The maximum number of processes to return. The service may return
288
+ # fewer than this value. If unspecified, at most 50 processes are
289
+ # returned. The maximum value is 100; values greater than 100 are cut to
290
+ # 100.
291
+ # @!attribute [rw] page_token
292
+ # @return [::String]
293
+ # The page token received from a previous `ListProcesses` call. Specify
294
+ # it to get the next page.
295
+ #
296
+ # When paginating, all other parameters specified in this call must
297
+ # match the parameters of the call that provided the page token.
298
+ class ListProcessesRequest
299
+ include ::Google::Protobuf::MessageExts
300
+ extend ::Google::Protobuf::MessageExts::ClassMethods
301
+ end
302
+
303
+ # Response message for
304
+ # [ListProcesses][google.cloud.datacatalog.lineage.v1.ListProcesses].
305
+ # @!attribute [rw] processes
306
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Process>]
307
+ # The processes from the specified project and location.
308
+ # @!attribute [rw] next_page_token
309
+ # @return [::String]
310
+ # The token to specify as `page_token` in the next call to get the next page.
311
+ # If this field is omitted, there are no subsequent pages.
312
+ class ListProcessesResponse
313
+ include ::Google::Protobuf::MessageExts
314
+ extend ::Google::Protobuf::MessageExts::ClassMethods
315
+ end
316
+
317
+ # Request message for
318
+ # [DeleteProcess][google.cloud.datacatalog.lineage.v1.DeleteProcess].
319
+ # @!attribute [rw] name
320
+ # @return [::String]
321
+ # Required. The name of the process to delete.
322
+ # @!attribute [rw] allow_missing
323
+ # @return [::Boolean]
324
+ # If set to true and the process is not found, the request
325
+ # succeeds but the server doesn't perform any actions.
326
+ class DeleteProcessRequest
327
+ include ::Google::Protobuf::MessageExts
328
+ extend ::Google::Protobuf::MessageExts::ClassMethods
329
+ end
330
+
331
+ # Request message for
332
+ # [CreateRun][google.cloud.datacatalog.lineage.v1.CreateRun].
333
+ # @!attribute [rw] parent
334
+ # @return [::String]
335
+ # Required. The name of the process that should own the run.
336
+ # @!attribute [rw] run
337
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Run]
338
+ # Required. The run to create.
339
+ # @!attribute [rw] request_id
340
+ # @return [::String]
341
+ # A unique identifier for this request. Restricted to 36 ASCII characters.
342
+ # A random UUID is recommended. This request is idempotent only if a
343
+ # `request_id` is provided.
344
+ class CreateRunRequest
345
+ include ::Google::Protobuf::MessageExts
346
+ extend ::Google::Protobuf::MessageExts::ClassMethods
347
+ end
348
+
349
+ # Request message for
350
+ # [UpdateRun][google.cloud.datacatalog.lineage.v1.UpdateRun].
351
+ # @!attribute [rw] run
352
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Run]
353
+ # Required. The lineage run to update.
354
+ #
355
+ # The run's `name` field is used to identify the run to update.
356
+ #
357
+ # Format:
358
+ # `projects/{project}/locations/{location}/processes/{process}/runs/{run}`.
359
+ # @!attribute [rw] update_mask
360
+ # @return [::Google::Protobuf::FieldMask]
361
+ # The list of fields to update. Currently not used. The whole message is
362
+ # updated.
363
+ class UpdateRunRequest
364
+ include ::Google::Protobuf::MessageExts
365
+ extend ::Google::Protobuf::MessageExts::ClassMethods
366
+ end
367
+
368
+ # Request message for
369
+ # [GetRun][google.cloud.datacatalog.lineage.v1.GetRun].
370
+ # @!attribute [rw] name
371
+ # @return [::String]
372
+ # Required. The name of the run to get.
373
+ class GetRunRequest
374
+ include ::Google::Protobuf::MessageExts
375
+ extend ::Google::Protobuf::MessageExts::ClassMethods
376
+ end
377
+
378
+ # Request message for
379
+ # [ListRuns][google.cloud.datacatalog.lineage.v1.ListRuns].
380
+ # @!attribute [rw] parent
381
+ # @return [::String]
382
+ # Required. The name of process that owns this collection of runs.
383
+ # @!attribute [rw] page_size
384
+ # @return [::Integer]
385
+ # The maximum number of runs to return. The service may return
386
+ # fewer than this value. If unspecified, at most 50 runs are
387
+ # returned. The maximum value is 100; values greater than 100 are cut to
388
+ # 100.
389
+ # @!attribute [rw] page_token
390
+ # @return [::String]
391
+ # The page token received from a previous `ListRuns` call. Specify
392
+ # it to get the next page.
393
+ #
394
+ # When paginating, all other parameters specified in this call must
395
+ # match the parameters of the call that provided the page token.
396
+ class ListRunsRequest
397
+ include ::Google::Protobuf::MessageExts
398
+ extend ::Google::Protobuf::MessageExts::ClassMethods
399
+ end
400
+
401
+ # Response message for
402
+ # [ListRuns][google.cloud.datacatalog.lineage.v1.ListRuns].
403
+ # @!attribute [rw] runs
404
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Run>]
405
+ # The runs from the specified project and location.
406
+ # @!attribute [rw] next_page_token
407
+ # @return [::String]
408
+ # The token to specify as `page_token` in the next call to get the next page.
409
+ # If this field is omitted, there are no subsequent pages.
410
+ class ListRunsResponse
411
+ include ::Google::Protobuf::MessageExts
412
+ extend ::Google::Protobuf::MessageExts::ClassMethods
413
+ end
414
+
415
+ # Request message for
416
+ # [DeleteRun][google.cloud.datacatalog.lineage.v1.DeleteRun].
417
+ # @!attribute [rw] name
418
+ # @return [::String]
419
+ # Required. The name of the run to delete.
420
+ # @!attribute [rw] allow_missing
421
+ # @return [::Boolean]
422
+ # If set to true and the run is not found, the request
423
+ # succeeds but the server doesn't perform any actions.
424
+ class DeleteRunRequest
425
+ include ::Google::Protobuf::MessageExts
426
+ extend ::Google::Protobuf::MessageExts::ClassMethods
427
+ end
428
+
429
+ # Request message for
430
+ # [CreateLineageEvent][google.cloud.datacatalog.lineage.v1.CreateLineageEvent].
431
+ # @!attribute [rw] parent
432
+ # @return [::String]
433
+ # Required. The name of the run that should own the lineage event.
434
+ # @!attribute [rw] lineage_event
435
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::LineageEvent]
436
+ # Required. The lineage event to create.
437
+ # @!attribute [rw] request_id
438
+ # @return [::String]
439
+ # A unique identifier for this request. Restricted to 36 ASCII characters.
440
+ # A random UUID is recommended. This request is idempotent only if a
441
+ # `request_id` is provided.
442
+ class CreateLineageEventRequest
443
+ include ::Google::Protobuf::MessageExts
444
+ extend ::Google::Protobuf::MessageExts::ClassMethods
445
+ end
446
+
447
+ # Request message for
448
+ # [GetLineageEvent][google.cloud.datacatalog.lineage.v1.GetLineageEvent].
449
+ # @!attribute [rw] name
450
+ # @return [::String]
451
+ # Required. The name of the lineage event to get.
452
+ class GetLineageEventRequest
453
+ include ::Google::Protobuf::MessageExts
454
+ extend ::Google::Protobuf::MessageExts::ClassMethods
455
+ end
456
+
457
+ # Request message for
458
+ # [ListLineageEvents][google.cloud.datacatalog.lineage.v1.ListLineageEvents].
459
+ # @!attribute [rw] parent
460
+ # @return [::String]
461
+ # Required. The name of the run that owns the collection of lineage events to
462
+ # get.
463
+ # @!attribute [rw] page_size
464
+ # @return [::Integer]
465
+ # The maximum number of lineage events to return.
466
+ #
467
+ # The service may return fewer events than this value.
468
+ # If unspecified, at most 50 events are returned. The maximum value is 100;
469
+ # values greater than 100 are cut to 100.
470
+ # @!attribute [rw] page_token
471
+ # @return [::String]
472
+ # The page token received from a previous `ListLineageEvents` call. Specify
473
+ # it to get the next page.
474
+ #
475
+ # When paginating, all other parameters specified in this call must
476
+ # match the parameters of the call that provided the page token.
477
+ class ListLineageEventsRequest
478
+ include ::Google::Protobuf::MessageExts
479
+ extend ::Google::Protobuf::MessageExts::ClassMethods
480
+ end
481
+
482
+ # Response message for
483
+ # [ListLineageEvents][google.cloud.datacatalog.lineage.v1.ListLineageEvents].
484
+ # @!attribute [rw] lineage_events
485
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::LineageEvent>]
486
+ # Lineage events from the specified project and location.
487
+ # @!attribute [rw] next_page_token
488
+ # @return [::String]
489
+ # The token to specify as `page_token` in the next call to get the next page.
490
+ # If this field is omitted, there are no subsequent pages.
491
+ class ListLineageEventsResponse
492
+ include ::Google::Protobuf::MessageExts
493
+ extend ::Google::Protobuf::MessageExts::ClassMethods
494
+ end
495
+
496
+ # Request message for
497
+ # [DeleteLineageEvent][google.cloud.datacatalog.lineage.v1.DeleteLineageEvent].
498
+ # @!attribute [rw] name
499
+ # @return [::String]
500
+ # Required. The name of the lineage event to delete.
501
+ # @!attribute [rw] allow_missing
502
+ # @return [::Boolean]
503
+ # If set to true and the lineage event is not found, the request
504
+ # succeeds but the server doesn't perform any actions.
505
+ class DeleteLineageEventRequest
506
+ include ::Google::Protobuf::MessageExts
507
+ extend ::Google::Protobuf::MessageExts::ClassMethods
508
+ end
509
+
510
+ # Request message for
511
+ # {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#search_links SearchLinks}.
512
+ # @!attribute [rw] parent
513
+ # @return [::String]
514
+ # Required. The project and location you want search in.
515
+ # @!attribute [rw] source
516
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
517
+ # Optional. Send asset information in the **source** field to retrieve all
518
+ # links that lead from the specified asset to downstream assets.
519
+ # @!attribute [rw] target
520
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
521
+ # Optional. Send asset information in the **target** field to retrieve all
522
+ # links that lead from upstream assets to the specified asset.
523
+ # @!attribute [rw] page_size
524
+ # @return [::Integer]
525
+ # Optional. The maximum number of links to return in a single page of the
526
+ # response. A page may contain fewer links than this value. If unspecified,
527
+ # at most 10 links are returned.
528
+ #
529
+ # Maximum value is 100; values greater than 100 are reduced to 100.
530
+ # @!attribute [rw] page_token
531
+ # @return [::String]
532
+ # Optional. The page token received from a previous `SearchLinksRequest`
533
+ # call. Use it to get the next page.
534
+ #
535
+ # When requesting subsequent pages of a response, remember that
536
+ # all parameters must match the values you provided
537
+ # in the original request.
538
+ class SearchLinksRequest
539
+ include ::Google::Protobuf::MessageExts
540
+ extend ::Google::Protobuf::MessageExts::ClassMethods
541
+ end
542
+
543
+ # Response message for
544
+ # {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#search_links SearchLinks}.
545
+ # @!attribute [rw] links
546
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Link>]
547
+ # The list of links for a given asset. Can be empty if the asset has no
548
+ # relations of requested type (source or target).
549
+ # @!attribute [rw] next_page_token
550
+ # @return [::String]
551
+ # The token to specify as `page_token` in the subsequent call to get the next
552
+ # page. Omitted if there are no more pages in the response.
553
+ class SearchLinksResponse
554
+ include ::Google::Protobuf::MessageExts
555
+ extend ::Google::Protobuf::MessageExts::ClassMethods
556
+ end
557
+
558
+ # Links represent the data flow between **source** (upstream)
559
+ # and **target** (downstream) assets in transformation pipelines.
560
+ #
561
+ # Links are created when LineageEvents record data transformation between
562
+ # related assets.
563
+ # @!attribute [r] name
564
+ # @return [::String]
565
+ # Output only. Immutable. The name of the link. Format:
566
+ # `projects/{project}/locations/{location}/links/{link}`.
567
+ # @!attribute [rw] source
568
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
569
+ # The pointer to the entity that is the **source** of this link.
570
+ # @!attribute [rw] target
571
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
572
+ # The pointer to the entity that is the **target** of this link.
573
+ # @!attribute [rw] start_time
574
+ # @return [::Google::Protobuf::Timestamp]
575
+ # The start of the first event establishing this link.
576
+ # @!attribute [rw] end_time
577
+ # @return [::Google::Protobuf::Timestamp]
578
+ # The end of the last event establishing this link.
579
+ class Link
580
+ include ::Google::Protobuf::MessageExts
581
+ extend ::Google::Protobuf::MessageExts::ClassMethods
582
+ end
583
+
584
+ # Request message for
585
+ # {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#batch_search_link_processes BatchSearchLinkProcesses}.
586
+ # @!attribute [rw] parent
587
+ # @return [::String]
588
+ # Required. The project and location where you want to search.
589
+ # @!attribute [rw] links
590
+ # @return [::Array<::String>]
591
+ # Required. An array of links to check for their associated LineageProcesses.
592
+ #
593
+ # The maximum number of items in this array is 100.
594
+ # If the request contains more than 100 links, it returns the
595
+ # `INVALID_ARGUMENT` error.
596
+ #
597
+ # Format: `projects/{project}/locations/{location}/links/{link}`.
598
+ # @!attribute [rw] page_size
599
+ # @return [::Integer]
600
+ # The maximum number of processes to return in a single page of the response.
601
+ # A page may contain fewer results than this value.
602
+ # @!attribute [rw] page_token
603
+ # @return [::String]
604
+ # The page token received from a previous `BatchSearchLinkProcesses` call.
605
+ # Use it to get the next page.
606
+ #
607
+ # When requesting subsequent pages of a response, remember that
608
+ # all parameters must match the values you provided
609
+ # in the original request.
610
+ class BatchSearchLinkProcessesRequest
611
+ include ::Google::Protobuf::MessageExts
612
+ extend ::Google::Protobuf::MessageExts::ClassMethods
613
+ end
614
+
615
+ # Response message for
616
+ # {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#batch_search_link_processes BatchSearchLinkProcesses}.
617
+ # @!attribute [rw] process_links
618
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::ProcessLinks>]
619
+ # An array of processes associated with the specified links.
620
+ # @!attribute [rw] next_page_token
621
+ # @return [::String]
622
+ # The token to specify as `page_token` in the subsequent call to get the next
623
+ # page. Omitted if there are no more pages in the response.
624
+ class BatchSearchLinkProcessesResponse
625
+ include ::Google::Protobuf::MessageExts
626
+ extend ::Google::Protobuf::MessageExts::ClassMethods
627
+ end
628
+
629
+ # Links associated with a specific process.
630
+ # @!attribute [rw] process
631
+ # @return [::String]
632
+ # The process name in the format of
633
+ # `projects/{project}/locations/{location}/processes/{process}`.
634
+ # @!attribute [rw] links
635
+ # @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::ProcessLinkInfo>]
636
+ # An array containing link details objects of the links provided in
637
+ # the original request.
638
+ #
639
+ # A single process can result in creating multiple links.
640
+ # If any of the links you provide in the request are created by
641
+ # the same process, they all are included in this array.
642
+ class ProcessLinks
643
+ include ::Google::Protobuf::MessageExts
644
+ extend ::Google::Protobuf::MessageExts::ClassMethods
645
+ end
646
+
647
+ # Link details.
648
+ # @!attribute [rw] link
649
+ # @return [::String]
650
+ # The name of the link in the format of
651
+ # `projects/{project}/locations/{location}/links/{link}`.
652
+ # @!attribute [rw] start_time
653
+ # @return [::Google::Protobuf::Timestamp]
654
+ # The start of the first event establishing this link-process tuple.
655
+ # @!attribute [rw] end_time
656
+ # @return [::Google::Protobuf::Timestamp]
657
+ # The end of the last event establishing this link-process tuple.
658
+ class ProcessLinkInfo
659
+ include ::Google::Protobuf::MessageExts
660
+ extend ::Google::Protobuf::MessageExts::ClassMethods
661
+ end
662
+
663
+ # Origin of a process.
664
+ # @!attribute [rw] source_type
665
+ # @return [::Google::Cloud::DataCatalog::Lineage::V1::Origin::SourceType]
666
+ # Type of the source.
667
+ # @!attribute [rw] name
668
+ # @return [::String]
669
+ # If the source_type isn't CUSTOM, the value of this field should be a GCP
670
+ # resource name of the system, which reports lineage. The project and
671
+ # location parts of the resource name must match the project and location of
672
+ # the lineage resource being created. Examples:
673
+ #
674
+ # - `{source_type: COMPOSER, name:
675
+ # "projects/foo/locations/us/environments/bar"}`
676
+ # - `{source_type: BIGQUERY, name: "projects/foo/locations/eu"}`
677
+ # - `{source_type: CUSTOM, name: "myCustomIntegration"}`
678
+ class Origin
679
+ include ::Google::Protobuf::MessageExts
680
+ extend ::Google::Protobuf::MessageExts::ClassMethods
681
+
682
+ # Type of the source of a process.
683
+ module SourceType
684
+ # Source is Unspecified
685
+ SOURCE_TYPE_UNSPECIFIED = 0
686
+
687
+ # A custom source
688
+ CUSTOM = 1
689
+
690
+ # BigQuery
691
+ BIGQUERY = 2
692
+
693
+ # Data Fusion
694
+ DATA_FUSION = 3
695
+
696
+ # Composer
697
+ COMPOSER = 4
698
+
699
+ # Looker Studio
700
+ LOOKER_STUDIO = 5
701
+ end
702
+ end
703
+ end
704
+ end
705
+ end
706
+ end
707
+ end