google-cloud-data_catalog-lineage-v1 0.a → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
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