google-cloud-datastream 1.13.2__py3-none-any.whl

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 (44) hide show
  1. google/cloud/datastream/__init__.py +219 -0
  2. google/cloud/datastream/gapic_version.py +16 -0
  3. google/cloud/datastream/py.typed +2 -0
  4. google/cloud/datastream_v1/__init__.py +216 -0
  5. google/cloud/datastream_v1/gapic_metadata.json +418 -0
  6. google/cloud/datastream_v1/gapic_version.py +16 -0
  7. google/cloud/datastream_v1/py.typed +2 -0
  8. google/cloud/datastream_v1/services/__init__.py +15 -0
  9. google/cloud/datastream_v1/services/datastream/__init__.py +22 -0
  10. google/cloud/datastream_v1/services/datastream/async_client.py +3939 -0
  11. google/cloud/datastream_v1/services/datastream/client.py +4420 -0
  12. google/cloud/datastream_v1/services/datastream/pagers.py +977 -0
  13. google/cloud/datastream_v1/services/datastream/transports/__init__.py +36 -0
  14. google/cloud/datastream_v1/services/datastream/transports/base.py +639 -0
  15. google/cloud/datastream_v1/services/datastream/transports/grpc.py +1193 -0
  16. google/cloud/datastream_v1/services/datastream/transports/grpc_asyncio.py +1389 -0
  17. google/cloud/datastream_v1/services/datastream/transports/rest.py +6861 -0
  18. google/cloud/datastream_v1/services/datastream/transports/rest_base.py +1591 -0
  19. google/cloud/datastream_v1/types/__init__.py +208 -0
  20. google/cloud/datastream_v1/types/datastream.py +1491 -0
  21. google/cloud/datastream_v1/types/datastream_resources.py +2986 -0
  22. google/cloud/datastream_v1alpha1/__init__.py +156 -0
  23. google/cloud/datastream_v1alpha1/gapic_metadata.json +343 -0
  24. google/cloud/datastream_v1alpha1/gapic_version.py +16 -0
  25. google/cloud/datastream_v1alpha1/py.typed +2 -0
  26. google/cloud/datastream_v1alpha1/services/__init__.py +15 -0
  27. google/cloud/datastream_v1alpha1/services/datastream/__init__.py +22 -0
  28. google/cloud/datastream_v1alpha1/services/datastream/async_client.py +3018 -0
  29. google/cloud/datastream_v1alpha1/services/datastream/client.py +3458 -0
  30. google/cloud/datastream_v1alpha1/services/datastream/pagers.py +821 -0
  31. google/cloud/datastream_v1alpha1/services/datastream/transports/__init__.py +36 -0
  32. google/cloud/datastream_v1alpha1/services/datastream/transports/base.py +467 -0
  33. google/cloud/datastream_v1alpha1/services/datastream/transports/grpc.py +942 -0
  34. google/cloud/datastream_v1alpha1/services/datastream/transports/grpc_asyncio.py +1078 -0
  35. google/cloud/datastream_v1alpha1/services/datastream/transports/rest.py +4770 -0
  36. google/cloud/datastream_v1alpha1/services/datastream/transports/rest_base.py +1152 -0
  37. google/cloud/datastream_v1alpha1/types/__init__.py +148 -0
  38. google/cloud/datastream_v1alpha1/types/datastream.py +1230 -0
  39. google/cloud/datastream_v1alpha1/types/datastream_resources.py +1416 -0
  40. google_cloud_datastream-1.13.2.dist-info/LICENSE +202 -0
  41. google_cloud_datastream-1.13.2.dist-info/METADATA +229 -0
  42. google_cloud_datastream-1.13.2.dist-info/RECORD +44 -0
  43. google_cloud_datastream-1.13.2.dist-info/WHEEL +5 -0
  44. google_cloud_datastream-1.13.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,1230 @@
1
+ # -*- coding: utf-8 -*-
2
+ # Copyright 2024 Google LLC
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+ #
16
+ from __future__ import annotations
17
+
18
+ from typing import MutableMapping, MutableSequence
19
+
20
+ from google.protobuf import field_mask_pb2 # type: ignore
21
+ from google.protobuf import timestamp_pb2 # type: ignore
22
+ import proto # type: ignore
23
+
24
+ from google.cloud.datastream_v1alpha1.types import datastream_resources
25
+
26
+ __protobuf__ = proto.module(
27
+ package="google.cloud.datastream.v1alpha1",
28
+ manifest={
29
+ "DiscoverConnectionProfileRequest",
30
+ "DiscoverConnectionProfileResponse",
31
+ "FetchStaticIpsRequest",
32
+ "FetchStaticIpsResponse",
33
+ "FetchErrorsRequest",
34
+ "FetchErrorsResponse",
35
+ "ListConnectionProfilesRequest",
36
+ "ListConnectionProfilesResponse",
37
+ "GetConnectionProfileRequest",
38
+ "CreateConnectionProfileRequest",
39
+ "UpdateConnectionProfileRequest",
40
+ "DeleteConnectionProfileRequest",
41
+ "ListStreamsRequest",
42
+ "ListStreamsResponse",
43
+ "GetStreamRequest",
44
+ "CreateStreamRequest",
45
+ "UpdateStreamRequest",
46
+ "DeleteStreamRequest",
47
+ "OperationMetadata",
48
+ "CreatePrivateConnectionRequest",
49
+ "ListPrivateConnectionsRequest",
50
+ "ListPrivateConnectionsResponse",
51
+ "DeletePrivateConnectionRequest",
52
+ "GetPrivateConnectionRequest",
53
+ "CreateRouteRequest",
54
+ "ListRoutesRequest",
55
+ "ListRoutesResponse",
56
+ "DeleteRouteRequest",
57
+ "GetRouteRequest",
58
+ },
59
+ )
60
+
61
+
62
+ class DiscoverConnectionProfileRequest(proto.Message):
63
+ r"""Request message for 'discover' ConnectionProfile request.
64
+
65
+ This message has `oneof`_ fields (mutually exclusive fields).
66
+ For each oneof, at most one member field can be set at the same time.
67
+ Setting any member of the oneof automatically clears all other
68
+ members.
69
+
70
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
71
+
72
+ Attributes:
73
+ parent (str):
74
+ Required. The parent resource of the ConnectionProfile type.
75
+ Must be in the format ``projects/*/locations/*``.
76
+ connection_profile (google.cloud.datastream_v1alpha1.types.ConnectionProfile):
77
+ An ad-hoc ConnectionProfile configuration.
78
+
79
+ This field is a member of `oneof`_ ``target``.
80
+ connection_profile_name (str):
81
+ A reference to an existing ConnectionProfile.
82
+
83
+ This field is a member of `oneof`_ ``target``.
84
+ recursive (bool):
85
+ Whether to retrieve the full hierarchy of
86
+ data objects (TRUE) or only the current level
87
+ (FALSE).
88
+
89
+ This field is a member of `oneof`_ ``depth``.
90
+ recursion_depth (int):
91
+ The number of hierarchy levels below the
92
+ current level to be retrieved.
93
+
94
+ This field is a member of `oneof`_ ``depth``.
95
+ oracle_rdbms (google.cloud.datastream_v1alpha1.types.OracleRdbms):
96
+ Oracle RDBMS to enrich with child data
97
+ objects and metadata.
98
+
99
+ This field is a member of `oneof`_ ``data_object``.
100
+ mysql_rdbms (google.cloud.datastream_v1alpha1.types.MysqlRdbms):
101
+ MySQL RDBMS to enrich with child data objects
102
+ and metadata.
103
+
104
+ This field is a member of `oneof`_ ``data_object``.
105
+ """
106
+
107
+ parent: str = proto.Field(
108
+ proto.STRING,
109
+ number=1,
110
+ )
111
+ connection_profile: datastream_resources.ConnectionProfile = proto.Field(
112
+ proto.MESSAGE,
113
+ number=200,
114
+ oneof="target",
115
+ message=datastream_resources.ConnectionProfile,
116
+ )
117
+ connection_profile_name: str = proto.Field(
118
+ proto.STRING,
119
+ number=201,
120
+ oneof="target",
121
+ )
122
+ recursive: bool = proto.Field(
123
+ proto.BOOL,
124
+ number=3,
125
+ oneof="depth",
126
+ )
127
+ recursion_depth: int = proto.Field(
128
+ proto.INT32,
129
+ number=4,
130
+ oneof="depth",
131
+ )
132
+ oracle_rdbms: datastream_resources.OracleRdbms = proto.Field(
133
+ proto.MESSAGE,
134
+ number=100,
135
+ oneof="data_object",
136
+ message=datastream_resources.OracleRdbms,
137
+ )
138
+ mysql_rdbms: datastream_resources.MysqlRdbms = proto.Field(
139
+ proto.MESSAGE,
140
+ number=101,
141
+ oneof="data_object",
142
+ message=datastream_resources.MysqlRdbms,
143
+ )
144
+
145
+
146
+ class DiscoverConnectionProfileResponse(proto.Message):
147
+ r"""
148
+
149
+ This message has `oneof`_ fields (mutually exclusive fields).
150
+ For each oneof, at most one member field can be set at the same time.
151
+ Setting any member of the oneof automatically clears all other
152
+ members.
153
+
154
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
155
+
156
+ Attributes:
157
+ oracle_rdbms (google.cloud.datastream_v1alpha1.types.OracleRdbms):
158
+ Enriched Oracle RDBMS object.
159
+
160
+ This field is a member of `oneof`_ ``data_object``.
161
+ mysql_rdbms (google.cloud.datastream_v1alpha1.types.MysqlRdbms):
162
+ Enriched MySQL RDBMS object.
163
+
164
+ This field is a member of `oneof`_ ``data_object``.
165
+ """
166
+
167
+ oracle_rdbms: datastream_resources.OracleRdbms = proto.Field(
168
+ proto.MESSAGE,
169
+ number=100,
170
+ oneof="data_object",
171
+ message=datastream_resources.OracleRdbms,
172
+ )
173
+ mysql_rdbms: datastream_resources.MysqlRdbms = proto.Field(
174
+ proto.MESSAGE,
175
+ number=101,
176
+ oneof="data_object",
177
+ message=datastream_resources.MysqlRdbms,
178
+ )
179
+
180
+
181
+ class FetchStaticIpsRequest(proto.Message):
182
+ r"""Request message for 'FetchStaticIps' request.
183
+
184
+ Attributes:
185
+ name (str):
186
+ Required. The name resource of the Response type. Must be in
187
+ the format ``projects/*/locations/*``.
188
+ page_size (int):
189
+ Maximum number of Ips to return, will likely
190
+ not be specified.
191
+ page_token (str):
192
+ A page token, received from a previous ``ListStaticIps``
193
+ call. will likely not be specified.
194
+ """
195
+
196
+ name: str = proto.Field(
197
+ proto.STRING,
198
+ number=1,
199
+ )
200
+ page_size: int = proto.Field(
201
+ proto.INT32,
202
+ number=2,
203
+ )
204
+ page_token: str = proto.Field(
205
+ proto.STRING,
206
+ number=3,
207
+ )
208
+
209
+
210
+ class FetchStaticIpsResponse(proto.Message):
211
+ r"""Response message for a 'FetchStaticIps' response.
212
+
213
+ Attributes:
214
+ static_ips (MutableSequence[str]):
215
+ list of static ips by account
216
+ next_page_token (str):
217
+ A token that can be sent as ``page_token`` to retrieve the
218
+ next page. If this field is omitted, there are no subsequent
219
+ pages.
220
+ """
221
+
222
+ @property
223
+ def raw_page(self):
224
+ return self
225
+
226
+ static_ips: MutableSequence[str] = proto.RepeatedField(
227
+ proto.STRING,
228
+ number=1,
229
+ )
230
+ next_page_token: str = proto.Field(
231
+ proto.STRING,
232
+ number=2,
233
+ )
234
+
235
+
236
+ class FetchErrorsRequest(proto.Message):
237
+ r"""Request message for 'FetchErrors' request.
238
+
239
+ Attributes:
240
+ stream (str):
241
+ Name of the Stream resource for which to
242
+ fetch any errors.
243
+ """
244
+
245
+ stream: str = proto.Field(
246
+ proto.STRING,
247
+ number=1,
248
+ )
249
+
250
+
251
+ class FetchErrorsResponse(proto.Message):
252
+ r"""Response message for a 'FetchErrors' response.
253
+
254
+ Attributes:
255
+ errors (MutableSequence[google.cloud.datastream_v1alpha1.types.Error]):
256
+ The list of errors on the Stream.
257
+ """
258
+
259
+ errors: MutableSequence[datastream_resources.Error] = proto.RepeatedField(
260
+ proto.MESSAGE,
261
+ number=1,
262
+ message=datastream_resources.Error,
263
+ )
264
+
265
+
266
+ class ListConnectionProfilesRequest(proto.Message):
267
+ r"""
268
+
269
+ Attributes:
270
+ parent (str):
271
+ Required. The parent that owns the collection
272
+ of connection profiles.
273
+ page_size (int):
274
+ Maximum number of connection profiles to
275
+ return. If unspecified, at most 50 connection
276
+ profiles will be returned. The maximum value is
277
+ 1000; values above 1000 will be coerced to 1000.
278
+ page_token (str):
279
+ Page token received from a previous
280
+ ``ListConnectionProfiles`` call. Provide this to retrieve
281
+ the subsequent page.
282
+
283
+ When paginating, all other parameters provided to
284
+ ``ListConnectionProfiles`` must match the call that provided
285
+ the page token.
286
+ filter (str):
287
+ Filter request.
288
+ order_by (str):
289
+ Order by fields for the result.
290
+ """
291
+
292
+ parent: str = proto.Field(
293
+ proto.STRING,
294
+ number=1,
295
+ )
296
+ page_size: int = proto.Field(
297
+ proto.INT32,
298
+ number=2,
299
+ )
300
+ page_token: str = proto.Field(
301
+ proto.STRING,
302
+ number=3,
303
+ )
304
+ filter: str = proto.Field(
305
+ proto.STRING,
306
+ number=4,
307
+ )
308
+ order_by: str = proto.Field(
309
+ proto.STRING,
310
+ number=5,
311
+ )
312
+
313
+
314
+ class ListConnectionProfilesResponse(proto.Message):
315
+ r"""
316
+
317
+ Attributes:
318
+ connection_profiles (MutableSequence[google.cloud.datastream_v1alpha1.types.ConnectionProfile]):
319
+ List of connection profiles.
320
+ next_page_token (str):
321
+ A token, which can be sent as ``page_token`` to retrieve the
322
+ next page. If this field is omitted, there are no subsequent
323
+ pages.
324
+ unreachable (MutableSequence[str]):
325
+ Locations that could not be reached.
326
+ """
327
+
328
+ @property
329
+ def raw_page(self):
330
+ return self
331
+
332
+ connection_profiles: MutableSequence[
333
+ datastream_resources.ConnectionProfile
334
+ ] = proto.RepeatedField(
335
+ proto.MESSAGE,
336
+ number=1,
337
+ message=datastream_resources.ConnectionProfile,
338
+ )
339
+ next_page_token: str = proto.Field(
340
+ proto.STRING,
341
+ number=2,
342
+ )
343
+ unreachable: MutableSequence[str] = proto.RepeatedField(
344
+ proto.STRING,
345
+ number=3,
346
+ )
347
+
348
+
349
+ class GetConnectionProfileRequest(proto.Message):
350
+ r"""
351
+
352
+ Attributes:
353
+ name (str):
354
+ Required. The name of the connection profile
355
+ resource to get.
356
+ """
357
+
358
+ name: str = proto.Field(
359
+ proto.STRING,
360
+ number=1,
361
+ )
362
+
363
+
364
+ class CreateConnectionProfileRequest(proto.Message):
365
+ r"""
366
+
367
+ Attributes:
368
+ parent (str):
369
+ Required. The parent that owns the collection
370
+ of ConnectionProfiles.
371
+ connection_profile_id (str):
372
+ Required. The connection profile identifier.
373
+ connection_profile (google.cloud.datastream_v1alpha1.types.ConnectionProfile):
374
+ Required. The connection profile resource to
375
+ create.
376
+ request_id (str):
377
+ Optional. A request ID to identify requests.
378
+ Specify a unique request ID so that if you must
379
+ retry your request, the server will know to
380
+ ignore the request if it has already been
381
+ completed. The server will guarantee that for at
382
+ least 60 minutes since the first request.
383
+
384
+ For example, consider a situation where you make
385
+ an initial request and the request times out. If
386
+ you make the request again with the same request
387
+ ID, the server can check if original operation
388
+ with the same request ID was received, and if
389
+ so, will ignore the second request. This
390
+ prevents clients from accidentally creating
391
+ duplicate commitments.
392
+
393
+ The request ID must be a valid UUID with the
394
+ exception that zero UUID is not supported
395
+ (00000000-0000-0000-0000-000000000000).
396
+ """
397
+
398
+ parent: str = proto.Field(
399
+ proto.STRING,
400
+ number=1,
401
+ )
402
+ connection_profile_id: str = proto.Field(
403
+ proto.STRING,
404
+ number=2,
405
+ )
406
+ connection_profile: datastream_resources.ConnectionProfile = proto.Field(
407
+ proto.MESSAGE,
408
+ number=3,
409
+ message=datastream_resources.ConnectionProfile,
410
+ )
411
+ request_id: str = proto.Field(
412
+ proto.STRING,
413
+ number=4,
414
+ )
415
+
416
+
417
+ class UpdateConnectionProfileRequest(proto.Message):
418
+ r"""
419
+
420
+ Attributes:
421
+ update_mask (google.protobuf.field_mask_pb2.FieldMask):
422
+ Optional. Field mask is used to specify the fields to be
423
+ overwritten in the ConnectionProfile resource by the update.
424
+ The fields specified in the update_mask are relative to the
425
+ resource, not the full request. A field will be overwritten
426
+ if it is in the mask. If the user does not provide a mask
427
+ then all fields will be overwritten.
428
+ connection_profile (google.cloud.datastream_v1alpha1.types.ConnectionProfile):
429
+ Required. The ConnectionProfile to update.
430
+ request_id (str):
431
+ Optional. A request ID to identify requests.
432
+ Specify a unique request ID so that if you must
433
+ retry your request, the server will know to
434
+ ignore the request if it has already been
435
+ completed. The server will guarantee that for at
436
+ least 60 minutes since the first request.
437
+
438
+ For example, consider a situation where you make
439
+ an initial request and the request times out. If
440
+ you make the request again with the same request
441
+ ID, the server can check if original operation
442
+ with the same request ID was received, and if
443
+ so, will ignore the second request. This
444
+ prevents clients from accidentally creating
445
+ duplicate commitments.
446
+
447
+ The request ID must be a valid UUID with the
448
+ exception that zero UUID is not supported
449
+ (00000000-0000-0000-0000-000000000000).
450
+ """
451
+
452
+ update_mask: field_mask_pb2.FieldMask = proto.Field(
453
+ proto.MESSAGE,
454
+ number=1,
455
+ message=field_mask_pb2.FieldMask,
456
+ )
457
+ connection_profile: datastream_resources.ConnectionProfile = proto.Field(
458
+ proto.MESSAGE,
459
+ number=2,
460
+ message=datastream_resources.ConnectionProfile,
461
+ )
462
+ request_id: str = proto.Field(
463
+ proto.STRING,
464
+ number=3,
465
+ )
466
+
467
+
468
+ class DeleteConnectionProfileRequest(proto.Message):
469
+ r"""
470
+
471
+ Attributes:
472
+ name (str):
473
+ Required. The name of the connection profile
474
+ resource to delete.
475
+ request_id (str):
476
+ Optional. A request ID to identify requests.
477
+ Specify a unique request ID so that if you must
478
+ retry your request, the server will know to
479
+ ignore the request if it has already been
480
+ completed. The server will guarantee that for at
481
+ least 60 minutes after the first request.
482
+
483
+ For example, consider a situation where you make
484
+ an initial request and the request times out. If
485
+ you make the request again with the same request
486
+ ID, the server can check if original operation
487
+ with the same request ID was received, and if
488
+ so, will ignore the second request. This
489
+ prevents clients from accidentally creating
490
+ duplicate commitments.
491
+
492
+ The request ID must be a valid UUID with the
493
+ exception that zero UUID is not supported
494
+ (00000000-0000-0000-0000-000000000000).
495
+ """
496
+
497
+ name: str = proto.Field(
498
+ proto.STRING,
499
+ number=1,
500
+ )
501
+ request_id: str = proto.Field(
502
+ proto.STRING,
503
+ number=2,
504
+ )
505
+
506
+
507
+ class ListStreamsRequest(proto.Message):
508
+ r"""
509
+
510
+ Attributes:
511
+ parent (str):
512
+ Required. The parent that owns the collection
513
+ of streams.
514
+ page_size (int):
515
+ Maximum number of streams to return.
516
+ If unspecified, at most 50 streams will be
517
+ returned. The maximum value is 1000; values
518
+ above 1000 will be coerced to 1000.
519
+ page_token (str):
520
+ Page token received from a previous ``ListStreams`` call.
521
+ Provide this to retrieve the subsequent page.
522
+
523
+ When paginating, all other parameters provided to
524
+ ``ListStreams`` must match the call that provided the page
525
+ token.
526
+ filter (str):
527
+ Filter request.
528
+ order_by (str):
529
+ Order by fields for the result.
530
+ """
531
+
532
+ parent: str = proto.Field(
533
+ proto.STRING,
534
+ number=1,
535
+ )
536
+ page_size: int = proto.Field(
537
+ proto.INT32,
538
+ number=2,
539
+ )
540
+ page_token: str = proto.Field(
541
+ proto.STRING,
542
+ number=3,
543
+ )
544
+ filter: str = proto.Field(
545
+ proto.STRING,
546
+ number=4,
547
+ )
548
+ order_by: str = proto.Field(
549
+ proto.STRING,
550
+ number=5,
551
+ )
552
+
553
+
554
+ class ListStreamsResponse(proto.Message):
555
+ r"""
556
+
557
+ Attributes:
558
+ streams (MutableSequence[google.cloud.datastream_v1alpha1.types.Stream]):
559
+ List of streams
560
+ next_page_token (str):
561
+ A token, which can be sent as ``page_token`` to retrieve the
562
+ next page. If this field is omitted, there are no subsequent
563
+ pages.
564
+ unreachable (MutableSequence[str]):
565
+ Locations that could not be reached.
566
+ """
567
+
568
+ @property
569
+ def raw_page(self):
570
+ return self
571
+
572
+ streams: MutableSequence[datastream_resources.Stream] = proto.RepeatedField(
573
+ proto.MESSAGE,
574
+ number=1,
575
+ message=datastream_resources.Stream,
576
+ )
577
+ next_page_token: str = proto.Field(
578
+ proto.STRING,
579
+ number=2,
580
+ )
581
+ unreachable: MutableSequence[str] = proto.RepeatedField(
582
+ proto.STRING,
583
+ number=3,
584
+ )
585
+
586
+
587
+ class GetStreamRequest(proto.Message):
588
+ r"""
589
+
590
+ Attributes:
591
+ name (str):
592
+ Required. The name of the stream resource to
593
+ get.
594
+ """
595
+
596
+ name: str = proto.Field(
597
+ proto.STRING,
598
+ number=1,
599
+ )
600
+
601
+
602
+ class CreateStreamRequest(proto.Message):
603
+ r"""
604
+
605
+ Attributes:
606
+ parent (str):
607
+ Required. The parent that owns the collection
608
+ of streams.
609
+ stream_id (str):
610
+ Required. The stream identifier.
611
+ stream (google.cloud.datastream_v1alpha1.types.Stream):
612
+ Required. The stream resource to create.
613
+ request_id (str):
614
+ Optional. A request ID to identify requests.
615
+ Specify a unique request ID so that if you must
616
+ retry your request, the server will know to
617
+ ignore the request if it has already been
618
+ completed. The server will guarantee that for at
619
+ least 60 minutes since the first request.
620
+
621
+ For example, consider a situation where you make
622
+ an initial request and the request times out. If
623
+ you make the request again with the same request
624
+ ID, the server can check if original operation
625
+ with the same request ID was received, and if
626
+ so, will ignore the second request. This
627
+ prevents clients from accidentally creating
628
+ duplicate commitments.
629
+
630
+ The request ID must be a valid UUID with the
631
+ exception that zero UUID is not supported
632
+ (00000000-0000-0000-0000-000000000000).
633
+ validate_only (bool):
634
+ Optional. Only validate the stream, but do
635
+ not create any resources. The default is false.
636
+ force (bool):
637
+ Optional. Create the stream without
638
+ validating it.
639
+ """
640
+
641
+ parent: str = proto.Field(
642
+ proto.STRING,
643
+ number=1,
644
+ )
645
+ stream_id: str = proto.Field(
646
+ proto.STRING,
647
+ number=2,
648
+ )
649
+ stream: datastream_resources.Stream = proto.Field(
650
+ proto.MESSAGE,
651
+ number=3,
652
+ message=datastream_resources.Stream,
653
+ )
654
+ request_id: str = proto.Field(
655
+ proto.STRING,
656
+ number=4,
657
+ )
658
+ validate_only: bool = proto.Field(
659
+ proto.BOOL,
660
+ number=5,
661
+ )
662
+ force: bool = proto.Field(
663
+ proto.BOOL,
664
+ number=6,
665
+ )
666
+
667
+
668
+ class UpdateStreamRequest(proto.Message):
669
+ r"""
670
+
671
+ Attributes:
672
+ update_mask (google.protobuf.field_mask_pb2.FieldMask):
673
+ Optional. Field mask is used to specify the fields to be
674
+ overwritten in the stream resource by the update. The fields
675
+ specified in the update_mask are relative to the resource,
676
+ not the full request. A field will be overwritten if it is
677
+ in the mask. If the user does not provide a mask then all
678
+ fields will be overwritten.
679
+ stream (google.cloud.datastream_v1alpha1.types.Stream):
680
+ Required. The stream resource to update.
681
+ request_id (str):
682
+ Optional. A request ID to identify requests.
683
+ Specify a unique request ID so that if you must
684
+ retry your request, the server will know to
685
+ ignore the request if it has already been
686
+ completed. The server will guarantee that for at
687
+ least 60 minutes since the first request.
688
+
689
+ For example, consider a situation where you make
690
+ an initial request and the request times out. If
691
+ you make the request again with the same request
692
+ ID, the server can check if original operation
693
+ with the same request ID was received, and if
694
+ so, will ignore the second request. This
695
+ prevents clients from accidentally creating
696
+ duplicate commitments.
697
+
698
+ The request ID must be a valid UUID with the
699
+ exception that zero UUID is not supported
700
+ (00000000-0000-0000-0000-000000000000).
701
+ validate_only (bool):
702
+ Optional. Only validate the stream with the
703
+ changes, without actually updating it. The
704
+ default is false.
705
+ force (bool):
706
+ Optional. Execute the update without
707
+ validating it.
708
+ """
709
+
710
+ update_mask: field_mask_pb2.FieldMask = proto.Field(
711
+ proto.MESSAGE,
712
+ number=1,
713
+ message=field_mask_pb2.FieldMask,
714
+ )
715
+ stream: datastream_resources.Stream = proto.Field(
716
+ proto.MESSAGE,
717
+ number=2,
718
+ message=datastream_resources.Stream,
719
+ )
720
+ request_id: str = proto.Field(
721
+ proto.STRING,
722
+ number=3,
723
+ )
724
+ validate_only: bool = proto.Field(
725
+ proto.BOOL,
726
+ number=4,
727
+ )
728
+ force: bool = proto.Field(
729
+ proto.BOOL,
730
+ number=5,
731
+ )
732
+
733
+
734
+ class DeleteStreamRequest(proto.Message):
735
+ r"""
736
+
737
+ Attributes:
738
+ name (str):
739
+ Required. The name of the stream resource to
740
+ delete.
741
+ request_id (str):
742
+ Optional. A request ID to identify requests.
743
+ Specify a unique request ID so that if you must
744
+ retry your request, the server will know to
745
+ ignore the request if it has already been
746
+ completed. The server will guarantee that for at
747
+ least 60 minutes after the first request.
748
+
749
+ For example, consider a situation where you make
750
+ an initial request and the request times out. If
751
+ you make the request again with the same request
752
+ ID, the server can check if original operation
753
+ with the same request ID was received, and if
754
+ so, will ignore the second request. This
755
+ prevents clients from accidentally creating
756
+ duplicate commitments.
757
+
758
+ The request ID must be a valid UUID with the
759
+ exception that zero UUID is not supported
760
+ (00000000-0000-0000-0000-000000000000).
761
+ """
762
+
763
+ name: str = proto.Field(
764
+ proto.STRING,
765
+ number=1,
766
+ )
767
+ request_id: str = proto.Field(
768
+ proto.STRING,
769
+ number=2,
770
+ )
771
+
772
+
773
+ class OperationMetadata(proto.Message):
774
+ r"""Represents the metadata of the long-running operation.
775
+
776
+ Attributes:
777
+ create_time (google.protobuf.timestamp_pb2.Timestamp):
778
+ Output only. The time the operation was
779
+ created.
780
+ end_time (google.protobuf.timestamp_pb2.Timestamp):
781
+ Output only. The time the operation finished
782
+ running.
783
+ target (str):
784
+ Output only. Server-defined resource path for
785
+ the target of the operation.
786
+ verb (str):
787
+ Output only. Name of the verb executed by the
788
+ operation.
789
+ status_message (str):
790
+ Output only. Human-readable status of the
791
+ operation, if any.
792
+ requested_cancellation (bool):
793
+ Output only. Identifies whether the user has requested
794
+ cancellation of the operation. Operations that have
795
+ successfully been cancelled have [Operation.error][] value
796
+ with a [google.rpc.Status.code][google.rpc.Status.code] of
797
+ 1, corresponding to ``Code.CANCELLED``.
798
+ api_version (str):
799
+ Output only. API version used to start the
800
+ operation.
801
+ validation_result (google.cloud.datastream_v1alpha1.types.ValidationResult):
802
+ Output only. Results of executed validations
803
+ if there are any.
804
+ """
805
+
806
+ create_time: timestamp_pb2.Timestamp = proto.Field(
807
+ proto.MESSAGE,
808
+ number=1,
809
+ message=timestamp_pb2.Timestamp,
810
+ )
811
+ end_time: timestamp_pb2.Timestamp = proto.Field(
812
+ proto.MESSAGE,
813
+ number=2,
814
+ message=timestamp_pb2.Timestamp,
815
+ )
816
+ target: str = proto.Field(
817
+ proto.STRING,
818
+ number=3,
819
+ )
820
+ verb: str = proto.Field(
821
+ proto.STRING,
822
+ number=4,
823
+ )
824
+ status_message: str = proto.Field(
825
+ proto.STRING,
826
+ number=5,
827
+ )
828
+ requested_cancellation: bool = proto.Field(
829
+ proto.BOOL,
830
+ number=6,
831
+ )
832
+ api_version: str = proto.Field(
833
+ proto.STRING,
834
+ number=7,
835
+ )
836
+ validation_result: datastream_resources.ValidationResult = proto.Field(
837
+ proto.MESSAGE,
838
+ number=8,
839
+ message=datastream_resources.ValidationResult,
840
+ )
841
+
842
+
843
+ class CreatePrivateConnectionRequest(proto.Message):
844
+ r"""
845
+
846
+ Attributes:
847
+ parent (str):
848
+ Required. The parent that owns the collection
849
+ of PrivateConnections.
850
+ private_connection_id (str):
851
+ Required. The private connectivity
852
+ identifier.
853
+ private_connection (google.cloud.datastream_v1alpha1.types.PrivateConnection):
854
+ Required. The Private Connectivity resource
855
+ to create.
856
+ request_id (str):
857
+ Optional. A request ID to identify requests.
858
+ Specify a unique request ID so that if you must
859
+ retry your request, the server will know to
860
+ ignore the request if it has already been
861
+ completed. The server will guarantee that for at
862
+ least 60 minutes since the first request.
863
+
864
+ For example, consider a situation where you make
865
+ an initial request and the request times out. If
866
+ you make the request again with the same request
867
+ ID, the server can check if original operation
868
+ with the same request ID was received, and if
869
+ so, will ignore the second request. This
870
+ prevents clients from accidentally creating
871
+ duplicate commitments.
872
+
873
+ The request ID must be a valid UUID with the
874
+ exception that zero UUID is not supported
875
+ (00000000-0000-0000-0000-000000000000).
876
+ """
877
+
878
+ parent: str = proto.Field(
879
+ proto.STRING,
880
+ number=1,
881
+ )
882
+ private_connection_id: str = proto.Field(
883
+ proto.STRING,
884
+ number=2,
885
+ )
886
+ private_connection: datastream_resources.PrivateConnection = proto.Field(
887
+ proto.MESSAGE,
888
+ number=3,
889
+ message=datastream_resources.PrivateConnection,
890
+ )
891
+ request_id: str = proto.Field(
892
+ proto.STRING,
893
+ number=4,
894
+ )
895
+
896
+
897
+ class ListPrivateConnectionsRequest(proto.Message):
898
+ r"""
899
+
900
+ Attributes:
901
+ parent (str):
902
+ Required. The parent that owns the collection
903
+ of private connectivity configurations.
904
+ page_size (int):
905
+ Maximum number of private connectivity
906
+ configurations to return. If unspecified, at
907
+ most 50 private connectivity configurations that
908
+ will be returned. The maximum value is 1000;
909
+ values above 1000 will be coerced to 1000.
910
+ page_token (str):
911
+ Page token received from a previous
912
+ ``ListPrivateConnections`` call. Provide this to retrieve
913
+ the subsequent page.
914
+
915
+ When paginating, all other parameters provided to
916
+ ``ListPrivateConnections`` must match the call that provided
917
+ the page token.
918
+ filter (str):
919
+ Filter request.
920
+ order_by (str):
921
+ Order by fields for the result.
922
+ """
923
+
924
+ parent: str = proto.Field(
925
+ proto.STRING,
926
+ number=1,
927
+ )
928
+ page_size: int = proto.Field(
929
+ proto.INT32,
930
+ number=2,
931
+ )
932
+ page_token: str = proto.Field(
933
+ proto.STRING,
934
+ number=3,
935
+ )
936
+ filter: str = proto.Field(
937
+ proto.STRING,
938
+ number=4,
939
+ )
940
+ order_by: str = proto.Field(
941
+ proto.STRING,
942
+ number=5,
943
+ )
944
+
945
+
946
+ class ListPrivateConnectionsResponse(proto.Message):
947
+ r"""
948
+
949
+ Attributes:
950
+ private_connections (MutableSequence[google.cloud.datastream_v1alpha1.types.PrivateConnection]):
951
+ List of private connectivity configurations.
952
+ next_page_token (str):
953
+ A token, which can be sent as ``page_token`` to retrieve the
954
+ next page. If this field is omitted, there are no subsequent
955
+ pages.
956
+ unreachable (MutableSequence[str]):
957
+ Locations that could not be reached.
958
+ """
959
+
960
+ @property
961
+ def raw_page(self):
962
+ return self
963
+
964
+ private_connections: MutableSequence[
965
+ datastream_resources.PrivateConnection
966
+ ] = proto.RepeatedField(
967
+ proto.MESSAGE,
968
+ number=1,
969
+ message=datastream_resources.PrivateConnection,
970
+ )
971
+ next_page_token: str = proto.Field(
972
+ proto.STRING,
973
+ number=2,
974
+ )
975
+ unreachable: MutableSequence[str] = proto.RepeatedField(
976
+ proto.STRING,
977
+ number=3,
978
+ )
979
+
980
+
981
+ class DeletePrivateConnectionRequest(proto.Message):
982
+ r"""
983
+
984
+ Attributes:
985
+ name (str):
986
+ Required. The name of the private
987
+ connectivity configuration to delete.
988
+ request_id (str):
989
+ Optional. A request ID to identify requests.
990
+ Specify a unique request ID so that if you must
991
+ retry your request, the server will know to
992
+ ignore the request if it has already been
993
+ completed. The server will guarantee that for at
994
+ least 60 minutes after the first request.
995
+
996
+ For example, consider a situation where you make
997
+ an initial request and the request times out. If
998
+ you make the request again with the same request
999
+ ID, the server can check if original operation
1000
+ with the same request ID was received, and if
1001
+ so, will ignore the second request. This
1002
+ prevents clients from accidentally creating
1003
+ duplicate commitments.
1004
+
1005
+ The request ID must be a valid UUID with the
1006
+ exception that zero UUID is not supported
1007
+ (00000000-0000-0000-0000-000000000000).
1008
+ force (bool):
1009
+ Optional. If set to true, any child routes
1010
+ that belong to this PrivateConnection will also
1011
+ be deleted.
1012
+ """
1013
+
1014
+ name: str = proto.Field(
1015
+ proto.STRING,
1016
+ number=1,
1017
+ )
1018
+ request_id: str = proto.Field(
1019
+ proto.STRING,
1020
+ number=2,
1021
+ )
1022
+ force: bool = proto.Field(
1023
+ proto.BOOL,
1024
+ number=3,
1025
+ )
1026
+
1027
+
1028
+ class GetPrivateConnectionRequest(proto.Message):
1029
+ r"""
1030
+
1031
+ Attributes:
1032
+ name (str):
1033
+ Required. The name of the private
1034
+ connectivity configuration to get.
1035
+ """
1036
+
1037
+ name: str = proto.Field(
1038
+ proto.STRING,
1039
+ number=1,
1040
+ )
1041
+
1042
+
1043
+ class CreateRouteRequest(proto.Message):
1044
+ r"""route creation request
1045
+
1046
+ Attributes:
1047
+ parent (str):
1048
+ Required. The parent that owns the collection
1049
+ of Routes.
1050
+ route_id (str):
1051
+ Required. The Route identifier.
1052
+ route (google.cloud.datastream_v1alpha1.types.Route):
1053
+ Required. The Route resource to create.
1054
+ request_id (str):
1055
+ Optional. A request ID to identify requests.
1056
+ Specify a unique request ID so that if you must
1057
+ retry your request, the server will know to
1058
+ ignore the request if it has already been
1059
+ completed. The server will guarantee that for at
1060
+ least 60 minutes since the first request.
1061
+
1062
+ For example, consider a situation where you make
1063
+ an initial request and the request times out. If
1064
+ you make the request again with the same request
1065
+ ID, the server can check if original operation
1066
+ with the same request ID was received, and if
1067
+ so, will ignore the second request. This
1068
+ prevents clients from accidentally creating
1069
+ duplicate commitments.
1070
+
1071
+ The request ID must be a valid UUID with the
1072
+ exception that zero UUID is not supported
1073
+ (00000000-0000-0000-0000-000000000000).
1074
+ """
1075
+
1076
+ parent: str = proto.Field(
1077
+ proto.STRING,
1078
+ number=1,
1079
+ )
1080
+ route_id: str = proto.Field(
1081
+ proto.STRING,
1082
+ number=2,
1083
+ )
1084
+ route: datastream_resources.Route = proto.Field(
1085
+ proto.MESSAGE,
1086
+ number=3,
1087
+ message=datastream_resources.Route,
1088
+ )
1089
+ request_id: str = proto.Field(
1090
+ proto.STRING,
1091
+ number=4,
1092
+ )
1093
+
1094
+
1095
+ class ListRoutesRequest(proto.Message):
1096
+ r"""route list request
1097
+
1098
+ Attributes:
1099
+ parent (str):
1100
+ Required. The parent that owns the collection
1101
+ of Routess.
1102
+ page_size (int):
1103
+ Maximum number of Routes to return. The
1104
+ service may return fewer than this value. If
1105
+ unspecified, at most 50 Routes will be returned.
1106
+ The maximum value is 1000; values above 1000
1107
+ will be coerced to 1000.
1108
+ page_token (str):
1109
+ Page token received from a previous ``ListRoutes`` call.
1110
+ Provide this to retrieve the subsequent page.
1111
+
1112
+ When paginating, all other parameters provided to
1113
+ ``ListRoutes`` must match the call that provided the page
1114
+ token.
1115
+ filter (str):
1116
+ Filter request.
1117
+ order_by (str):
1118
+ Order by fields for the result.
1119
+ """
1120
+
1121
+ parent: str = proto.Field(
1122
+ proto.STRING,
1123
+ number=1,
1124
+ )
1125
+ page_size: int = proto.Field(
1126
+ proto.INT32,
1127
+ number=2,
1128
+ )
1129
+ page_token: str = proto.Field(
1130
+ proto.STRING,
1131
+ number=3,
1132
+ )
1133
+ filter: str = proto.Field(
1134
+ proto.STRING,
1135
+ number=4,
1136
+ )
1137
+ order_by: str = proto.Field(
1138
+ proto.STRING,
1139
+ number=5,
1140
+ )
1141
+
1142
+
1143
+ class ListRoutesResponse(proto.Message):
1144
+ r"""route list response
1145
+
1146
+ Attributes:
1147
+ routes (MutableSequence[google.cloud.datastream_v1alpha1.types.Route]):
1148
+ List of Routes.
1149
+ next_page_token (str):
1150
+ A token, which can be sent as ``page_token`` to retrieve the
1151
+ next page. If this field is omitted, there are no subsequent
1152
+ pages.
1153
+ unreachable (MutableSequence[str]):
1154
+ Locations that could not be reached.
1155
+ """
1156
+
1157
+ @property
1158
+ def raw_page(self):
1159
+ return self
1160
+
1161
+ routes: MutableSequence[datastream_resources.Route] = proto.RepeatedField(
1162
+ proto.MESSAGE,
1163
+ number=1,
1164
+ message=datastream_resources.Route,
1165
+ )
1166
+ next_page_token: str = proto.Field(
1167
+ proto.STRING,
1168
+ number=2,
1169
+ )
1170
+ unreachable: MutableSequence[str] = proto.RepeatedField(
1171
+ proto.STRING,
1172
+ number=3,
1173
+ )
1174
+
1175
+
1176
+ class DeleteRouteRequest(proto.Message):
1177
+ r"""route deletion request
1178
+
1179
+ Attributes:
1180
+ name (str):
1181
+ Required. The name of the Route resource to
1182
+ delete.
1183
+ request_id (str):
1184
+ Optional. A request ID to identify requests.
1185
+ Specify a unique request ID so that if you must
1186
+ retry your request, the server will know to
1187
+ ignore the request if it has already been
1188
+ completed. The server will guarantee that for at
1189
+ least 60 minutes after the first request.
1190
+
1191
+ For example, consider a situation where you make
1192
+ an initial request and the request times out. If
1193
+ you make the request again with the same request
1194
+ ID, the server can check if original operation
1195
+ with the same request ID was received, and if
1196
+ so, will ignore the second request. This
1197
+ prevents clients from accidentally creating
1198
+ duplicate commitments.
1199
+
1200
+ The request ID must be a valid UUID with the
1201
+ exception that zero UUID is not supported
1202
+ (00000000-0000-0000-0000-000000000000).
1203
+ """
1204
+
1205
+ name: str = proto.Field(
1206
+ proto.STRING,
1207
+ number=1,
1208
+ )
1209
+ request_id: str = proto.Field(
1210
+ proto.STRING,
1211
+ number=2,
1212
+ )
1213
+
1214
+
1215
+ class GetRouteRequest(proto.Message):
1216
+ r"""route get request
1217
+
1218
+ Attributes:
1219
+ name (str):
1220
+ Required. The name of the Route resource to
1221
+ get.
1222
+ """
1223
+
1224
+ name: str = proto.Field(
1225
+ proto.STRING,
1226
+ number=1,
1227
+ )
1228
+
1229
+
1230
+ __all__ = tuple(sorted(__protobuf__.manifest))