@flyteorg/flyteidl 1.16.0 → 2.0.0-test1

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 (87) hide show
  1. package/package.json +6 -9
  2. package/LICENSE +0 -202
  3. package/NOTICE +0 -4
  4. package/README.md +0 -14
  5. package/gen/pb-js/flyteidl.d.ts +0 -28307
  6. package/gen/pb-js/flyteidl.js +0 -66636
  7. package/protos/buf.lock +0 -18
  8. package/protos/buf.yaml +0 -12
  9. package/protos/docs/admin/admin.rst +0 -4623
  10. package/protos/docs/admin/index.rst +0 -13
  11. package/protos/docs/contributing.md +0 -68
  12. package/protos/docs/core/core.rst +0 -3952
  13. package/protos/docs/core/index.rst +0 -15
  14. package/protos/docs/datacatalog/datacatalog.rst +0 -1313
  15. package/protos/docs/datacatalog/index.rst +0 -16
  16. package/protos/docs/event/event.rst +0 -726
  17. package/protos/docs/event/index.rst +0 -27
  18. package/protos/docs/plugins/index.rst +0 -14
  19. package/protos/docs/plugins/plugins.rst +0 -780
  20. package/protos/docs/restructuredtext.tmpl +0 -129
  21. package/protos/docs/service/index.rst +0 -13
  22. package/protos/docs/service/service.rst +0 -543
  23. package/protos/docs/withoutscalar_restructuredtext.tmpl +0 -105
  24. package/protos/docs_index.rst +0 -19
  25. package/protos/flyteidl/admin/agent.proto +0 -309
  26. package/protos/flyteidl/admin/cluster_assignment.proto +0 -11
  27. package/protos/flyteidl/admin/common.proto +0 -337
  28. package/protos/flyteidl/admin/description_entity.proto +0 -95
  29. package/protos/flyteidl/admin/event.proto +0 -70
  30. package/protos/flyteidl/admin/execution.proto +0 -436
  31. package/protos/flyteidl/admin/launch_plan.proto +0 -231
  32. package/protos/flyteidl/admin/matchable_resource.proto +0 -194
  33. package/protos/flyteidl/admin/node_execution.proto +0 -248
  34. package/protos/flyteidl/admin/notification.proto +0 -27
  35. package/protos/flyteidl/admin/project.proto +0 -132
  36. package/protos/flyteidl/admin/project_attributes.proto +0 -69
  37. package/protos/flyteidl/admin/project_domain_attributes.proto +0 -80
  38. package/protos/flyteidl/admin/schedule.proto +0 -43
  39. package/protos/flyteidl/admin/signal.proto +0 -86
  40. package/protos/flyteidl/admin/task.proto +0 -71
  41. package/protos/flyteidl/admin/task_execution.proto +0 -171
  42. package/protos/flyteidl/admin/version.proto +0 -27
  43. package/protos/flyteidl/admin/workflow.proto +0 -92
  44. package/protos/flyteidl/admin/workflow_attributes.proto +0 -89
  45. package/protos/flyteidl/cacheservice/cacheservice.proto +0 -143
  46. package/protos/flyteidl/core/artifact_id.proto +0 -112
  47. package/protos/flyteidl/core/catalog.proto +0 -63
  48. package/protos/flyteidl/core/compiler.proto +0 -64
  49. package/protos/flyteidl/core/condition.proto +0 -63
  50. package/protos/flyteidl/core/dynamic_job.proto +0 -32
  51. package/protos/flyteidl/core/errors.proto +0 -42
  52. package/protos/flyteidl/core/execution.proto +0 -156
  53. package/protos/flyteidl/core/execution_envs.proto +0 -45
  54. package/protos/flyteidl/core/identifier.proto +0 -80
  55. package/protos/flyteidl/core/interface.proto +0 -64
  56. package/protos/flyteidl/core/literals.proto +0 -205
  57. package/protos/flyteidl/core/metrics.proto +0 -50
  58. package/protos/flyteidl/core/security.proto +0 -135
  59. package/protos/flyteidl/core/tasks.proto +0 -392
  60. package/protos/flyteidl/core/types.proto +0 -208
  61. package/protos/flyteidl/core/workflow.proto +0 -361
  62. package/protos/flyteidl/core/workflow_closure.proto +0 -18
  63. package/protos/flyteidl/datacatalog/datacatalog.proto +0 -420
  64. package/protos/flyteidl/event/cloudevents.proto +0 -81
  65. package/protos/flyteidl/event/event.proto +0 -347
  66. package/protos/flyteidl/plugins/array_job.proto +0 -30
  67. package/protos/flyteidl/plugins/common.proto +0 -27
  68. package/protos/flyteidl/plugins/dask.proto +0 -41
  69. package/protos/flyteidl/plugins/kubeflow/common.proto +0 -28
  70. package/protos/flyteidl/plugins/kubeflow/mpi.proto +0 -47
  71. package/protos/flyteidl/plugins/kubeflow/pytorch.proto +0 -53
  72. package/protos/flyteidl/plugins/kubeflow/tensorflow.proto +0 -46
  73. package/protos/flyteidl/plugins/mpi.proto +0 -20
  74. package/protos/flyteidl/plugins/presto.proto +0 -14
  75. package/protos/flyteidl/plugins/pytorch.proto +0 -25
  76. package/protos/flyteidl/plugins/qubole.proto +0 -26
  77. package/protos/flyteidl/plugins/ray.proto +0 -59
  78. package/protos/flyteidl/plugins/spark.proto +0 -42
  79. package/protos/flyteidl/plugins/tensorflow.proto +0 -18
  80. package/protos/flyteidl/plugins/waitable.proto +0 -15
  81. package/protos/flyteidl/service/admin.proto +0 -668
  82. package/protos/flyteidl/service/agent.proto +0 -79
  83. package/protos/flyteidl/service/auth.proto +0 -94
  84. package/protos/flyteidl/service/dataproxy.proto +0 -205
  85. package/protos/flyteidl/service/external_plugin_service.proto +0 -79
  86. package/protos/flyteidl/service/identity.proto +0 -51
  87. package/protos/flyteidl/service/signal.proto +0 -55
@@ -1,4623 +0,0 @@
1
- ######################
2
- Protocol Documentation
3
- ######################
4
-
5
-
6
-
7
-
8
- .. _ref_flyteidl/admin/cluster_assignment.proto:
9
-
10
- flyteidl/admin/cluster_assignment.proto
11
- ==================================================================
12
-
13
-
14
-
15
-
16
-
17
- .. _ref_flyteidl.admin.ClusterAssignment:
18
-
19
- ClusterAssignment
20
- ------------------------------------------------------------------
21
-
22
- Encapsulates specifications for routing an execution onto a specific cluster.
23
-
24
-
25
-
26
- .. csv-table:: ClusterAssignment type fields
27
- :header: "Field", "Type", "Label", "Description"
28
- :widths: auto
29
-
30
- "cluster_pool_name", ":ref:`ref_string`", "", ""
31
-
32
-
33
-
34
-
35
-
36
-
37
- ..
38
- end messages
39
-
40
-
41
- ..
42
- end enums
43
-
44
-
45
- ..
46
- end HasExtensions
47
-
48
-
49
- ..
50
- end services
51
-
52
-
53
-
54
-
55
- .. _ref_flyteidl/admin/common.proto:
56
-
57
- flyteidl/admin/common.proto
58
- ==================================================================
59
-
60
-
61
-
62
-
63
-
64
- .. _ref_flyteidl.admin.Annotations:
65
-
66
- Annotations
67
- ------------------------------------------------------------------
68
-
69
- Annotation values to be applied to an execution resource.
70
- In the future a mode (e.g. OVERRIDE, APPEND, etc) can be defined
71
- to specify how to merge annotations defined at registration and execution time.
72
-
73
-
74
-
75
- .. csv-table:: Annotations type fields
76
- :header: "Field", "Type", "Label", "Description"
77
- :widths: auto
78
-
79
- "values", ":ref:`ref_flyteidl.admin.Annotations.ValuesEntry`", "repeated", "Map of custom annotations to be applied to the execution resource."
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
- .. _ref_flyteidl.admin.Annotations.ValuesEntry:
88
-
89
- Annotations.ValuesEntry
90
- ------------------------------------------------------------------
91
-
92
-
93
-
94
-
95
-
96
- .. csv-table:: Annotations.ValuesEntry type fields
97
- :header: "Field", "Type", "Label", "Description"
98
- :widths: auto
99
-
100
- "key", ":ref:`ref_string`", "", ""
101
- "value", ":ref:`ref_string`", "", ""
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
- .. _ref_flyteidl.admin.AuthRole:
110
-
111
- AuthRole
112
- ------------------------------------------------------------------
113
-
114
- Defines permissions associated with executions created by this launch plan spec.
115
- Use either of these roles when they have permissions required by your workflow execution.
116
- Deprecated.
117
-
118
-
119
-
120
- .. csv-table:: AuthRole type fields
121
- :header: "Field", "Type", "Label", "Description"
122
- :widths: auto
123
-
124
- "assumable_iam_role", ":ref:`ref_string`", "", "Defines an optional iam role which will be used for tasks run in executions created with this launch plan."
125
- "kubernetes_service_account", ":ref:`ref_string`", "", "Defines an optional kubernetes service account which will be used for tasks run in executions created with this launch plan."
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
- .. _ref_flyteidl.admin.EmailNotification:
134
-
135
- EmailNotification
136
- ------------------------------------------------------------------
137
-
138
- Defines an email notification specification.
139
-
140
-
141
-
142
- .. csv-table:: EmailNotification type fields
143
- :header: "Field", "Type", "Label", "Description"
144
- :widths: auto
145
-
146
- "recipients_email", ":ref:`ref_string`", "repeated", "The list of email addresses recipients for this notification. +required"
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
- .. _ref_flyteidl.admin.Labels:
155
-
156
- Labels
157
- ------------------------------------------------------------------
158
-
159
- Label values to be applied to an execution resource.
160
- In the future a mode (e.g. OVERRIDE, APPEND, etc) can be defined
161
- to specify how to merge labels defined at registration and execution time.
162
-
163
-
164
-
165
- .. csv-table:: Labels type fields
166
- :header: "Field", "Type", "Label", "Description"
167
- :widths: auto
168
-
169
- "values", ":ref:`ref_flyteidl.admin.Labels.ValuesEntry`", "repeated", "Map of custom labels to be applied to the execution resource."
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
- .. _ref_flyteidl.admin.Labels.ValuesEntry:
178
-
179
- Labels.ValuesEntry
180
- ------------------------------------------------------------------
181
-
182
-
183
-
184
-
185
-
186
- .. csv-table:: Labels.ValuesEntry type fields
187
- :header: "Field", "Type", "Label", "Description"
188
- :widths: auto
189
-
190
- "key", ":ref:`ref_string`", "", ""
191
- "value", ":ref:`ref_string`", "", ""
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
- .. _ref_flyteidl.admin.NamedEntity:
200
-
201
- NamedEntity
202
- ------------------------------------------------------------------
203
-
204
- Encapsulates information common to a NamedEntity, a Flyte resource such as a task,
205
- workflow or launch plan. A NamedEntity is exclusively identified by its resource type
206
- and identifier.
207
-
208
-
209
-
210
- .. csv-table:: NamedEntity type fields
211
- :header: "Field", "Type", "Label", "Description"
212
- :widths: auto
213
-
214
- "resource_type", ":ref:`ref_flyteidl.core.ResourceType`", "", "Resource type of the named entity. One of Task, Workflow or LaunchPlan."
215
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", ""
216
- "metadata", ":ref:`ref_flyteidl.admin.NamedEntityMetadata`", "", "Additional metadata around a named entity."
217
-
218
-
219
-
220
-
221
-
222
-
223
-
224
- .. _ref_flyteidl.admin.NamedEntityGetRequest:
225
-
226
- NamedEntityGetRequest
227
- ------------------------------------------------------------------
228
-
229
- A request to retrieve the metadata associated with a NamedEntityIdentifier
230
-
231
-
232
-
233
- .. csv-table:: NamedEntityGetRequest type fields
234
- :header: "Field", "Type", "Label", "Description"
235
- :widths: auto
236
-
237
- "resource_type", ":ref:`ref_flyteidl.core.ResourceType`", "", "Resource type of the metadata to get. One of Task, Workflow or LaunchPlan. +required"
238
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", "The identifier for the named entity for which to fetch metadata. +required"
239
-
240
-
241
-
242
-
243
-
244
-
245
-
246
- .. _ref_flyteidl.admin.NamedEntityIdentifier:
247
-
248
- NamedEntityIdentifier
249
- ------------------------------------------------------------------
250
-
251
- Encapsulation of fields that identifies a Flyte resource.
252
- A Flyte resource can be a task, workflow or launch plan.
253
- A resource can internally have multiple versions and is uniquely identified
254
- by project, domain, and name.
255
-
256
-
257
-
258
- .. csv-table:: NamedEntityIdentifier type fields
259
- :header: "Field", "Type", "Label", "Description"
260
- :widths: auto
261
-
262
- "project", ":ref:`ref_string`", "", "Name of the project the resource belongs to."
263
- "domain", ":ref:`ref_string`", "", "Name of the domain the resource belongs to. A domain can be considered as a subset within a specific project."
264
- "name", ":ref:`ref_string`", "", "User provided value for the resource. The combination of project + domain + name uniquely identifies the resource. +optional - in certain contexts - like 'List API', 'Launch plans'"
265
-
266
-
267
-
268
-
269
-
270
-
271
-
272
- .. _ref_flyteidl.admin.NamedEntityIdentifierList:
273
-
274
- NamedEntityIdentifierList
275
- ------------------------------------------------------------------
276
-
277
- Represents a list of NamedEntityIdentifiers.
278
-
279
-
280
-
281
- .. csv-table:: NamedEntityIdentifierList type fields
282
- :header: "Field", "Type", "Label", "Description"
283
- :widths: auto
284
-
285
- "entities", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "repeated", "A list of identifiers."
286
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
287
-
288
-
289
-
290
-
291
-
292
-
293
-
294
- .. _ref_flyteidl.admin.NamedEntityIdentifierListRequest:
295
-
296
- NamedEntityIdentifierListRequest
297
- ------------------------------------------------------------------
298
-
299
- Represents a request structure to list NamedEntityIdentifiers.
300
-
301
-
302
-
303
- .. csv-table:: NamedEntityIdentifierListRequest type fields
304
- :header: "Field", "Type", "Label", "Description"
305
- :widths: auto
306
-
307
- "project", ":ref:`ref_string`", "", "Name of the project that contains the identifiers. +required"
308
- "domain", ":ref:`ref_string`", "", "Name of the domain the identifiers belongs to within the project. +required"
309
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
310
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. +optional"
311
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Specifies how listed entities should be sorted in the response. +optional"
312
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. +optional"
313
-
314
-
315
-
316
-
317
-
318
-
319
-
320
- .. _ref_flyteidl.admin.NamedEntityList:
321
-
322
- NamedEntityList
323
- ------------------------------------------------------------------
324
-
325
- Represents a list of NamedEntityIdentifiers.
326
-
327
-
328
-
329
- .. csv-table:: NamedEntityList type fields
330
- :header: "Field", "Type", "Label", "Description"
331
- :widths: auto
332
-
333
- "entities", ":ref:`ref_flyteidl.admin.NamedEntity`", "repeated", "A list of NamedEntity objects"
334
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
335
-
336
-
337
-
338
-
339
-
340
-
341
-
342
- .. _ref_flyteidl.admin.NamedEntityListRequest:
343
-
344
- NamedEntityListRequest
345
- ------------------------------------------------------------------
346
-
347
- Represents a request structure to list NamedEntity objects
348
-
349
-
350
-
351
- .. csv-table:: NamedEntityListRequest type fields
352
- :header: "Field", "Type", "Label", "Description"
353
- :widths: auto
354
-
355
- "resource_type", ":ref:`ref_flyteidl.core.ResourceType`", "", "Resource type of the metadata to query. One of Task, Workflow or LaunchPlan. +required"
356
- "project", ":ref:`ref_string`", "", "Name of the project that contains the identifiers. +required"
357
- "domain", ":ref:`ref_string`", "", "Name of the domain the identifiers belongs to within the project."
358
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned."
359
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. +optional"
360
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Specifies how listed entities should be sorted in the response. +optional"
361
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. +optional"
362
-
363
-
364
-
365
-
366
-
367
-
368
-
369
- .. _ref_flyteidl.admin.NamedEntityMetadata:
370
-
371
- NamedEntityMetadata
372
- ------------------------------------------------------------------
373
-
374
- Additional metadata around a named entity.
375
-
376
-
377
-
378
- .. csv-table:: NamedEntityMetadata type fields
379
- :header: "Field", "Type", "Label", "Description"
380
- :widths: auto
381
-
382
- "description", ":ref:`ref_string`", "", "Common description across all versions of the entity +optional"
383
- "state", ":ref:`ref_flyteidl.admin.NamedEntityState`", "", "Shared state across all version of the entity At this point in time, only workflow entities can have their state archived."
384
-
385
-
386
-
387
-
388
-
389
-
390
-
391
- .. _ref_flyteidl.admin.NamedEntityUpdateRequest:
392
-
393
- NamedEntityUpdateRequest
394
- ------------------------------------------------------------------
395
-
396
- Request to set the referenced named entity state to the configured value.
397
-
398
-
399
-
400
- .. csv-table:: NamedEntityUpdateRequest type fields
401
- :header: "Field", "Type", "Label", "Description"
402
- :widths: auto
403
-
404
- "resource_type", ":ref:`ref_flyteidl.core.ResourceType`", "", "Resource type of the metadata to update +required"
405
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", "Identifier of the metadata to update +required"
406
- "metadata", ":ref:`ref_flyteidl.admin.NamedEntityMetadata`", "", "Metadata object to set as the new value +required"
407
-
408
-
409
-
410
-
411
-
412
-
413
-
414
- .. _ref_flyteidl.admin.NamedEntityUpdateResponse:
415
-
416
- NamedEntityUpdateResponse
417
- ------------------------------------------------------------------
418
-
419
- Purposefully empty, may be populated in the future.
420
-
421
-
422
-
423
-
424
-
425
-
426
-
427
-
428
- .. _ref_flyteidl.admin.Notification:
429
-
430
- Notification
431
- ------------------------------------------------------------------
432
-
433
- Represents a structure for notifications based on execution status.
434
- The notification content is configured within flyte admin but can be templatized.
435
- Future iterations could expose configuring notifications with custom content.
436
-
437
-
438
-
439
- .. csv-table:: Notification type fields
440
- :header: "Field", "Type", "Label", "Description"
441
- :widths: auto
442
-
443
- "phases", ":ref:`ref_flyteidl.core.WorkflowExecution.Phase`", "repeated", "A list of phases to which users can associate the notifications to. +required"
444
- "email", ":ref:`ref_flyteidl.admin.EmailNotification`", "", ""
445
- "pager_duty", ":ref:`ref_flyteidl.admin.PagerDutyNotification`", "", ""
446
- "slack", ":ref:`ref_flyteidl.admin.SlackNotification`", "", ""
447
-
448
-
449
-
450
-
451
-
452
-
453
-
454
- .. _ref_flyteidl.admin.ObjectGetRequest:
455
-
456
- ObjectGetRequest
457
- ------------------------------------------------------------------
458
-
459
- Shared request structure to fetch a single resource.
460
- Resources include: Task, Workflow, LaunchPlan
461
-
462
-
463
-
464
- .. csv-table:: ObjectGetRequest type fields
465
- :header: "Field", "Type", "Label", "Description"
466
- :widths: auto
467
-
468
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "Indicates a unique version of resource. +required"
469
-
470
-
471
-
472
-
473
-
474
-
475
-
476
- .. _ref_flyteidl.admin.PagerDutyNotification:
477
-
478
- PagerDutyNotification
479
- ------------------------------------------------------------------
480
-
481
- Defines a pager duty notification specification.
482
-
483
-
484
-
485
- .. csv-table:: PagerDutyNotification type fields
486
- :header: "Field", "Type", "Label", "Description"
487
- :widths: auto
488
-
489
- "recipients_email", ":ref:`ref_string`", "repeated", "Currently, PagerDuty notifications leverage email to trigger a notification. +required"
490
-
491
-
492
-
493
-
494
-
495
-
496
-
497
- .. _ref_flyteidl.admin.RawOutputDataConfig:
498
-
499
- RawOutputDataConfig
500
- ------------------------------------------------------------------
501
-
502
- Encapsulates user settings pertaining to offloaded data (i.e. Blobs, Schema, query data, etc.).
503
- See https://github.com/flyteorg/flyte/issues/211 for more background information.
504
-
505
-
506
-
507
- .. csv-table:: RawOutputDataConfig type fields
508
- :header: "Field", "Type", "Label", "Description"
509
- :widths: auto
510
-
511
- "output_location_prefix", ":ref:`ref_string`", "", "Prefix for where offloaded data from user workflows will be written e.g. s3://bucket/key or s3://bucket/"
512
-
513
-
514
-
515
-
516
-
517
-
518
-
519
- .. _ref_flyteidl.admin.ResourceListRequest:
520
-
521
- ResourceListRequest
522
- ------------------------------------------------------------------
523
-
524
- Shared request structure to retrieve a list of resources.
525
- Resources include: Task, Workflow, LaunchPlan
526
-
527
-
528
-
529
- .. csv-table:: ResourceListRequest type fields
530
- :header: "Field", "Type", "Label", "Description"
531
- :widths: auto
532
-
533
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", "id represents the unique identifier of the resource. +required"
534
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
535
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, this server-provided token can be used to fetch the next page in a query. +optional"
536
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
537
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
538
-
539
-
540
-
541
-
542
-
543
-
544
-
545
- .. _ref_flyteidl.admin.SlackNotification:
546
-
547
- SlackNotification
548
- ------------------------------------------------------------------
549
-
550
- Defines a slack notification specification.
551
-
552
-
553
-
554
- .. csv-table:: SlackNotification type fields
555
- :header: "Field", "Type", "Label", "Description"
556
- :widths: auto
557
-
558
- "recipients_email", ":ref:`ref_string`", "repeated", "Currently, Slack notifications leverage email to trigger a notification. +required"
559
-
560
-
561
-
562
-
563
-
564
-
565
-
566
- .. _ref_flyteidl.admin.Sort:
567
-
568
- Sort
569
- ------------------------------------------------------------------
570
-
571
- Specifies sort ordering in a list request.
572
-
573
-
574
-
575
- .. csv-table:: Sort type fields
576
- :header: "Field", "Type", "Label", "Description"
577
- :widths: auto
578
-
579
- "key", ":ref:`ref_string`", "", "Indicates an attribute to sort the response values. +required"
580
- "direction", ":ref:`ref_flyteidl.admin.Sort.Direction`", "", "Indicates the direction to apply sort key for response values. +optional"
581
-
582
-
583
-
584
-
585
-
586
-
587
-
588
- .. _ref_flyteidl.admin.UrlBlob:
589
-
590
- UrlBlob
591
- ------------------------------------------------------------------
592
-
593
- Represents a string url and associated metadata used throughout the platform.
594
-
595
-
596
-
597
- .. csv-table:: UrlBlob type fields
598
- :header: "Field", "Type", "Label", "Description"
599
- :widths: auto
600
-
601
- "url", ":ref:`ref_string`", "", "Actual url value."
602
- "bytes", ":ref:`ref_int64`", "", "Represents the size of the file accessible at the above url."
603
-
604
-
605
-
606
-
607
-
608
-
609
- ..
610
- end messages
611
-
612
-
613
-
614
- .. _ref_flyteidl.admin.NamedEntityState:
615
-
616
- NamedEntityState
617
- ------------------------------------------------------------------
618
-
619
- The status of the named entity is used to control its visibility in the UI.
620
-
621
- .. csv-table:: Enum NamedEntityState values
622
- :header: "Name", "Number", "Description"
623
- :widths: auto
624
-
625
- "NAMED_ENTITY_ACTIVE", "0", "By default, all named entities are considered active and under development."
626
- "NAMED_ENTITY_ARCHIVED", "1", "Archived named entities are no longer visible in the UI."
627
- "SYSTEM_GENERATED", "2", "System generated entities that aren't explicitly created or managed by a user."
628
-
629
-
630
-
631
- .. _ref_flyteidl.admin.Sort.Direction:
632
-
633
- Sort.Direction
634
- ------------------------------------------------------------------
635
-
636
-
637
-
638
- .. csv-table:: Enum Sort.Direction values
639
- :header: "Name", "Number", "Description"
640
- :widths: auto
641
-
642
- "DESCENDING", "0", "By default, fields are sorted in descending order."
643
- "ASCENDING", "1", ""
644
-
645
-
646
- ..
647
- end enums
648
-
649
-
650
- ..
651
- end HasExtensions
652
-
653
-
654
- ..
655
- end services
656
-
657
-
658
-
659
-
660
- .. _ref_flyteidl/admin/description_entity.proto:
661
-
662
- flyteidl/admin/description_entity.proto
663
- ==================================================================
664
-
665
-
666
-
667
-
668
-
669
- .. _ref_flyteidl.admin.Description:
670
-
671
- Description
672
- ------------------------------------------------------------------
673
-
674
- Full user description with formatting preserved. This can be rendered
675
- by clients, such as the console or command line tools with in-tact
676
- formatting.
677
-
678
-
679
-
680
- .. csv-table:: Description type fields
681
- :header: "Field", "Type", "Label", "Description"
682
- :widths: auto
683
-
684
- "value", ":ref:`ref_string`", "", "long description - no more than 4KB"
685
- "uri", ":ref:`ref_string`", "", "if the description sizes exceed some threshold we can offload the entire description proto altogether to an external data store, like S3 rather than store inline in the db"
686
- "format", ":ref:`ref_flyteidl.admin.DescriptionFormat`", "", "Format of the long description"
687
- "icon_link", ":ref:`ref_string`", "", "Optional link to an icon for the entity"
688
-
689
-
690
-
691
-
692
-
693
-
694
-
695
- .. _ref_flyteidl.admin.DescriptionEntity:
696
-
697
- DescriptionEntity
698
- ------------------------------------------------------------------
699
-
700
- DescriptionEntity contains detailed description for the task/workflow.
701
- Documentation could provide insight into the algorithms, business use case, etc.
702
-
703
-
704
-
705
- .. csv-table:: DescriptionEntity type fields
706
- :header: "Field", "Type", "Label", "Description"
707
- :widths: auto
708
-
709
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the description entity."
710
- "short_description", ":ref:`ref_string`", "", "One-liner overview of the entity."
711
- "long_description", ":ref:`ref_flyteidl.admin.Description`", "", "Full user description with formatting preserved."
712
- "source_code", ":ref:`ref_flyteidl.admin.SourceCode`", "", "Optional link to source code used to define this entity."
713
- "tags", ":ref:`ref_string`", "repeated", "User-specified tags. These are arbitrary and can be used for searching filtering and discovering tasks."
714
-
715
-
716
-
717
-
718
-
719
-
720
-
721
- .. _ref_flyteidl.admin.DescriptionEntityList:
722
-
723
- DescriptionEntityList
724
- ------------------------------------------------------------------
725
-
726
- Represents a list of DescriptionEntities returned from the admin.
727
- See :ref:`ref_flyteidl.admin.DescriptionEntity` for more details
728
-
729
-
730
-
731
- .. csv-table:: DescriptionEntityList type fields
732
- :header: "Field", "Type", "Label", "Description"
733
- :widths: auto
734
-
735
- "descriptionEntities", ":ref:`ref_flyteidl.admin.DescriptionEntity`", "repeated", "A list of DescriptionEntities returned based on the request."
736
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
737
-
738
-
739
-
740
-
741
-
742
-
743
-
744
- .. _ref_flyteidl.admin.DescriptionEntityListRequest:
745
-
746
- DescriptionEntityListRequest
747
- ------------------------------------------------------------------
748
-
749
- Represents a request structure to retrieve a list of DescriptionEntities.
750
- See :ref:`ref_flyteidl.admin.DescriptionEntity` for more details
751
-
752
-
753
-
754
- .. csv-table:: DescriptionEntityListRequest type fields
755
- :header: "Field", "Type", "Label", "Description"
756
- :widths: auto
757
-
758
- "resource_type", ":ref:`ref_flyteidl.core.ResourceType`", "", "Identifies the specific type of resource that this identifier corresponds to."
759
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", "The identifier for the description entity. +required"
760
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
761
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. +optional"
762
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
763
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering for returned list. +optional"
764
-
765
-
766
-
767
-
768
-
769
-
770
-
771
- .. _ref_flyteidl.admin.SourceCode:
772
-
773
- SourceCode
774
- ------------------------------------------------------------------
775
-
776
- Link to source code used to define this entity
777
-
778
-
779
-
780
- .. csv-table:: SourceCode type fields
781
- :header: "Field", "Type", "Label", "Description"
782
- :widths: auto
783
-
784
- "link", ":ref:`ref_string`", "", ""
785
-
786
-
787
-
788
-
789
-
790
-
791
- ..
792
- end messages
793
-
794
-
795
-
796
- .. _ref_flyteidl.admin.DescriptionFormat:
797
-
798
- DescriptionFormat
799
- ------------------------------------------------------------------
800
-
801
- The format of the long description
802
-
803
- .. csv-table:: Enum DescriptionFormat values
804
- :header: "Name", "Number", "Description"
805
- :widths: auto
806
-
807
- "DESCRIPTION_FORMAT_UNKNOWN", "0", ""
808
- "DESCRIPTION_FORMAT_MARKDOWN", "1", ""
809
- "DESCRIPTION_FORMAT_HTML", "2", ""
810
- "DESCRIPTION_FORMAT_RST", "3", "python default documentation - comments is rst"
811
-
812
-
813
- ..
814
- end enums
815
-
816
-
817
- ..
818
- end HasExtensions
819
-
820
-
821
- ..
822
- end services
823
-
824
-
825
-
826
-
827
- .. _ref_flyteidl/admin/event.proto:
828
-
829
- flyteidl/admin/event.proto
830
- ==================================================================
831
-
832
-
833
-
834
-
835
-
836
- .. _ref_flyteidl.admin.EventErrorAlreadyInTerminalState:
837
-
838
- EventErrorAlreadyInTerminalState
839
- ------------------------------------------------------------------
840
-
841
- Indicates that a sent event was not used to update execution state due to
842
- the referenced execution already being terminated (and therefore ineligible
843
- for further state transitions).
844
-
845
-
846
-
847
- .. csv-table:: EventErrorAlreadyInTerminalState type fields
848
- :header: "Field", "Type", "Label", "Description"
849
- :widths: auto
850
-
851
- "current_phase", ":ref:`ref_string`", "", "+required"
852
-
853
-
854
-
855
-
856
-
857
-
858
-
859
- .. _ref_flyteidl.admin.EventErrorIncompatibleCluster:
860
-
861
- EventErrorIncompatibleCluster
862
- ------------------------------------------------------------------
863
-
864
- Indicates an event was rejected because it came from a different cluster than
865
- is on record as running the execution.
866
-
867
-
868
-
869
- .. csv-table:: EventErrorIncompatibleCluster type fields
870
- :header: "Field", "Type", "Label", "Description"
871
- :widths: auto
872
-
873
- "cluster", ":ref:`ref_string`", "", "The cluster which has been recorded as processing the execution. +required"
874
-
875
-
876
-
877
-
878
-
879
-
880
-
881
- .. _ref_flyteidl.admin.EventFailureReason:
882
-
883
- EventFailureReason
884
- ------------------------------------------------------------------
885
-
886
- Indicates why a sent event was not used to update execution.
887
-
888
-
889
-
890
- .. csv-table:: EventFailureReason type fields
891
- :header: "Field", "Type", "Label", "Description"
892
- :widths: auto
893
-
894
- "already_in_terminal_state", ":ref:`ref_flyteidl.admin.EventErrorAlreadyInTerminalState`", "", ""
895
- "incompatible_cluster", ":ref:`ref_flyteidl.admin.EventErrorIncompatibleCluster`", "", ""
896
-
897
-
898
-
899
-
900
-
901
-
902
-
903
- .. _ref_flyteidl.admin.NodeExecutionEventRequest:
904
-
905
- NodeExecutionEventRequest
906
- ------------------------------------------------------------------
907
-
908
- Request to send a notification that a node execution event has occurred.
909
-
910
-
911
-
912
- .. csv-table:: NodeExecutionEventRequest type fields
913
- :header: "Field", "Type", "Label", "Description"
914
- :widths: auto
915
-
916
- "request_id", ":ref:`ref_string`", "", "Unique ID for this request that can be traced between services"
917
- "event", ":ref:`ref_flyteidl.event.NodeExecutionEvent`", "", "Details about the event that occurred."
918
-
919
-
920
-
921
-
922
-
923
-
924
-
925
- .. _ref_flyteidl.admin.NodeExecutionEventResponse:
926
-
927
- NodeExecutionEventResponse
928
- ------------------------------------------------------------------
929
-
930
- Purposefully empty, may be populated in the future.
931
-
932
-
933
-
934
-
935
-
936
-
937
-
938
-
939
- .. _ref_flyteidl.admin.TaskExecutionEventRequest:
940
-
941
- TaskExecutionEventRequest
942
- ------------------------------------------------------------------
943
-
944
- Request to send a notification that a task execution event has occurred.
945
-
946
-
947
-
948
- .. csv-table:: TaskExecutionEventRequest type fields
949
- :header: "Field", "Type", "Label", "Description"
950
- :widths: auto
951
-
952
- "request_id", ":ref:`ref_string`", "", "Unique ID for this request that can be traced between services"
953
- "event", ":ref:`ref_flyteidl.event.TaskExecutionEvent`", "", "Details about the event that occurred."
954
-
955
-
956
-
957
-
958
-
959
-
960
-
961
- .. _ref_flyteidl.admin.TaskExecutionEventResponse:
962
-
963
- TaskExecutionEventResponse
964
- ------------------------------------------------------------------
965
-
966
- Purposefully empty, may be populated in the future.
967
-
968
-
969
-
970
-
971
-
972
-
973
-
974
-
975
- .. _ref_flyteidl.admin.WorkflowExecutionEventRequest:
976
-
977
- WorkflowExecutionEventRequest
978
- ------------------------------------------------------------------
979
-
980
- Request to send a notification that a workflow execution event has occurred.
981
-
982
-
983
-
984
- .. csv-table:: WorkflowExecutionEventRequest type fields
985
- :header: "Field", "Type", "Label", "Description"
986
- :widths: auto
987
-
988
- "request_id", ":ref:`ref_string`", "", "Unique ID for this request that can be traced between services"
989
- "event", ":ref:`ref_flyteidl.event.WorkflowExecutionEvent`", "", "Details about the event that occurred."
990
-
991
-
992
-
993
-
994
-
995
-
996
-
997
- .. _ref_flyteidl.admin.WorkflowExecutionEventResponse:
998
-
999
- WorkflowExecutionEventResponse
1000
- ------------------------------------------------------------------
1001
-
1002
- Purposefully empty, may be populated in the future.
1003
-
1004
-
1005
-
1006
-
1007
-
1008
-
1009
-
1010
- ..
1011
- end messages
1012
-
1013
-
1014
- ..
1015
- end enums
1016
-
1017
-
1018
- ..
1019
- end HasExtensions
1020
-
1021
-
1022
- ..
1023
- end services
1024
-
1025
-
1026
-
1027
-
1028
- .. _ref_flyteidl/admin/execution.proto:
1029
-
1030
- flyteidl/admin/execution.proto
1031
- ==================================================================
1032
-
1033
-
1034
-
1035
-
1036
-
1037
- .. _ref_flyteidl.admin.AbortMetadata:
1038
-
1039
- AbortMetadata
1040
- ------------------------------------------------------------------
1041
-
1042
- Specifies metadata around an aborted workflow execution.
1043
-
1044
-
1045
-
1046
- .. csv-table:: AbortMetadata type fields
1047
- :header: "Field", "Type", "Label", "Description"
1048
- :widths: auto
1049
-
1050
- "cause", ":ref:`ref_string`", "", "In the case of a user-specified abort, this will pass along the user-supplied cause."
1051
- "principal", ":ref:`ref_string`", "", "Identifies the entity (if any) responsible for terminating the execution"
1052
-
1053
-
1054
-
1055
-
1056
-
1057
-
1058
-
1059
- .. _ref_flyteidl.admin.Execution:
1060
-
1061
- Execution
1062
- ------------------------------------------------------------------
1063
-
1064
- A workflow execution represents an instantiated workflow, including all inputs and additional
1065
- metadata as well as computed results included state, outputs, and duration-based attributes.
1066
- Used as a response object used in Get and List execution requests.
1067
-
1068
-
1069
-
1070
- .. csv-table:: Execution type fields
1071
- :header: "Field", "Type", "Label", "Description"
1072
- :widths: auto
1073
-
1074
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Unique identifier of the workflow execution."
1075
- "spec", ":ref:`ref_flyteidl.admin.ExecutionSpec`", "", "User-provided configuration and inputs for launching the execution."
1076
- "closure", ":ref:`ref_flyteidl.admin.ExecutionClosure`", "", "Execution results."
1077
-
1078
-
1079
-
1080
-
1081
-
1082
-
1083
-
1084
- .. _ref_flyteidl.admin.ExecutionClosure:
1085
-
1086
- ExecutionClosure
1087
- ------------------------------------------------------------------
1088
-
1089
- Encapsulates the results of the Execution
1090
-
1091
-
1092
-
1093
- .. csv-table:: ExecutionClosure type fields
1094
- :header: "Field", "Type", "Label", "Description"
1095
- :widths: auto
1096
-
1097
- "outputs", ":ref:`ref_flyteidl.admin.LiteralMapBlob`", "", "**Deprecated.** Output URI in the case of a successful execution. DEPRECATED. Use GetExecutionData to fetch output data instead."
1098
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information in the case of a failed execution."
1099
- "abort_cause", ":ref:`ref_string`", "", "**Deprecated.** In the case of a user-specified abort, this will pass along the user-supplied cause."
1100
- "abort_metadata", ":ref:`ref_flyteidl.admin.AbortMetadata`", "", "In the case of a user-specified abort, this will pass along the user and their supplied cause."
1101
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Raw output data produced by this execution. DEPRECATED. Use GetExecutionData to fetch output data instead."
1102
- "computed_inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Inputs computed and passed for execution. computed_inputs depends on inputs in ExecutionSpec, fixed and default inputs in launch plan"
1103
- "phase", ":ref:`ref_flyteidl.core.WorkflowExecution.Phase`", "", "Most recent recorded phase for the execution."
1104
- "started_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Reported time at which the execution began running."
1105
- "duration", ":ref:`ref_google.protobuf.Duration`", "", "The amount of time the execution spent running."
1106
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Reported time at which the execution was created."
1107
- "updated_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Reported time at which the execution was last updated."
1108
- "notifications", ":ref:`ref_flyteidl.admin.Notification`", "repeated", "The notification settings to use after merging the CreateExecutionRequest and the launch plan notification settings. An execution launched with notifications will always prefer that definition to notifications defined statically in a launch plan."
1109
- "workflow_id", ":ref:`ref_flyteidl.core.Identifier`", "", "Identifies the workflow definition for this execution."
1110
- "state_change_details", ":ref:`ref_flyteidl.admin.ExecutionStateChangeDetails`", "", "Provides the details of the last stage change"
1111
-
1112
-
1113
-
1114
-
1115
-
1116
-
1117
-
1118
- .. _ref_flyteidl.admin.ExecutionCreateRequest:
1119
-
1120
- ExecutionCreateRequest
1121
- ------------------------------------------------------------------
1122
-
1123
- Request to launch an execution with the given project, domain and optionally-assigned name.
1124
-
1125
-
1126
-
1127
- .. csv-table:: ExecutionCreateRequest type fields
1128
- :header: "Field", "Type", "Label", "Description"
1129
- :widths: auto
1130
-
1131
- "project", ":ref:`ref_string`", "", "Name of the project the execution belongs to. +required"
1132
- "domain", ":ref:`ref_string`", "", "Name of the domain the execution belongs to. A domain can be considered as a subset within a specific project. +required"
1133
- "name", ":ref:`ref_string`", "", "User provided value for the resource. If none is provided the system will generate a unique string. +optional"
1134
- "spec", ":ref:`ref_flyteidl.admin.ExecutionSpec`", "", "Additional fields necessary to launch the execution. +optional"
1135
- "inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "The inputs required to start the execution. All required inputs must be included in this map. If not required and not provided, defaults apply. +optional"
1136
-
1137
-
1138
-
1139
-
1140
-
1141
-
1142
-
1143
- .. _ref_flyteidl.admin.ExecutionCreateResponse:
1144
-
1145
- ExecutionCreateResponse
1146
- ------------------------------------------------------------------
1147
-
1148
- The unique identifier for a successfully created execution.
1149
- If the name was *not* specified in the create request, this identifier will include a generated name.
1150
-
1151
-
1152
-
1153
- .. csv-table:: ExecutionCreateResponse type fields
1154
- :header: "Field", "Type", "Label", "Description"
1155
- :widths: auto
1156
-
1157
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", ""
1158
-
1159
-
1160
-
1161
-
1162
-
1163
-
1164
-
1165
- .. _ref_flyteidl.admin.ExecutionList:
1166
-
1167
- ExecutionList
1168
- ------------------------------------------------------------------
1169
-
1170
- Used as a response for request to list executions.
1171
- See :ref:`ref_flyteidl.admin.Execution` for more details
1172
-
1173
-
1174
-
1175
- .. csv-table:: ExecutionList type fields
1176
- :header: "Field", "Type", "Label", "Description"
1177
- :widths: auto
1178
-
1179
- "executions", ":ref:`ref_flyteidl.admin.Execution`", "repeated", ""
1180
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
1181
-
1182
-
1183
-
1184
-
1185
-
1186
-
1187
-
1188
- .. _ref_flyteidl.admin.ExecutionMetadata:
1189
-
1190
- ExecutionMetadata
1191
- ------------------------------------------------------------------
1192
-
1193
- Represents attributes about an execution which are not required to launch the execution but are useful to record.
1194
- These attributes are assigned at launch time and do not change.
1195
-
1196
-
1197
-
1198
- .. csv-table:: ExecutionMetadata type fields
1199
- :header: "Field", "Type", "Label", "Description"
1200
- :widths: auto
1201
-
1202
- "mode", ":ref:`ref_flyteidl.admin.ExecutionMetadata.ExecutionMode`", "", ""
1203
- "principal", ":ref:`ref_string`", "", "Identifier of the entity that triggered this execution. For systems using back-end authentication any value set here will be discarded in favor of the authenticated user context."
1204
- "nesting", ":ref:`ref_uint32`", "", "Indicates the nestedness of this execution. If a user launches a workflow execution, the default nesting is 0. If this execution further launches a workflow (child workflow), the nesting level is incremented by 0 => 1 Generally, if workflow at nesting level k launches a workflow then the child workflow will have nesting = k + 1."
1205
- "scheduled_at", ":ref:`ref_google.protobuf.Timestamp`", "", "For scheduled executions, the requested time for execution for this specific schedule invocation."
1206
- "parent_node_execution", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "Which subworkflow node (if any) launched this execution"
1207
- "reference_execution", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Optional, a reference workflow execution related to this execution. In the case of a relaunch, this references the original workflow execution."
1208
- "system_metadata", ":ref:`ref_flyteidl.admin.SystemMetadata`", "", "Optional, platform-specific metadata about the execution. In this the future this may be gated behind an ACL or some sort of authorization."
1209
-
1210
-
1211
-
1212
-
1213
-
1214
-
1215
-
1216
- .. _ref_flyteidl.admin.ExecutionRecoverRequest:
1217
-
1218
- ExecutionRecoverRequest
1219
- ------------------------------------------------------------------
1220
-
1221
- Request to recover the referenced execution.
1222
-
1223
-
1224
-
1225
- .. csv-table:: ExecutionRecoverRequest type fields
1226
- :header: "Field", "Type", "Label", "Description"
1227
- :widths: auto
1228
-
1229
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Identifier of the workflow execution to recover."
1230
- "name", ":ref:`ref_string`", "", "User provided value for the recovered execution. If none is provided the system will generate a unique string. +optional"
1231
- "metadata", ":ref:`ref_flyteidl.admin.ExecutionMetadata`", "", "Additional metadata which will be used to overwrite any metadata in the reference execution when triggering a recovery execution."
1232
-
1233
-
1234
-
1235
-
1236
-
1237
-
1238
-
1239
- .. _ref_flyteidl.admin.ExecutionRelaunchRequest:
1240
-
1241
- ExecutionRelaunchRequest
1242
- ------------------------------------------------------------------
1243
-
1244
- Request to relaunch the referenced execution.
1245
-
1246
-
1247
-
1248
- .. csv-table:: ExecutionRelaunchRequest type fields
1249
- :header: "Field", "Type", "Label", "Description"
1250
- :widths: auto
1251
-
1252
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Identifier of the workflow execution to relaunch. +required"
1253
- "name", ":ref:`ref_string`", "", "User provided value for the relaunched execution. If none is provided the system will generate a unique string. +optional"
1254
- "overwrite_cache", ":ref:`ref_bool`", "", "Allows for all cached values of a workflow and its tasks to be overwritten for a single execution. If enabled, all calculations are performed even if cached results would be available, overwriting the stored data once execution finishes successfully."
1255
-
1256
-
1257
-
1258
-
1259
-
1260
-
1261
-
1262
- .. _ref_flyteidl.admin.ExecutionSpec:
1263
-
1264
- ExecutionSpec
1265
- ------------------------------------------------------------------
1266
-
1267
- An ExecutionSpec encompasses all data used to launch this execution. The Spec does not change over the lifetime
1268
- of an execution as it progresses across phase changes.
1269
-
1270
-
1271
-
1272
- .. csv-table:: ExecutionSpec type fields
1273
- :header: "Field", "Type", "Label", "Description"
1274
- :widths: auto
1275
-
1276
- "launch_plan", ":ref:`ref_flyteidl.core.Identifier`", "", "Launch plan to be executed"
1277
- "inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Input values to be passed for the execution"
1278
- "metadata", ":ref:`ref_flyteidl.admin.ExecutionMetadata`", "", "Metadata for the execution"
1279
- "notifications", ":ref:`ref_flyteidl.admin.NotificationList`", "", "List of notifications based on Execution status transitions When this list is not empty it is used rather than any notifications defined in the referenced launch plan. When this list is empty, the notifications defined for the launch plan will be applied."
1280
- "disable_all", ":ref:`ref_bool`", "", "This should be set to true if all notifications are intended to be disabled for this execution."
1281
- "labels", ":ref:`ref_flyteidl.admin.Labels`", "", "Labels to apply to the execution resource."
1282
- "annotations", ":ref:`ref_flyteidl.admin.Annotations`", "", "Annotations to apply to the execution resource."
1283
- "security_context", ":ref:`ref_flyteidl.core.SecurityContext`", "", "Optional: security context override to apply this execution."
1284
- "auth_role", ":ref:`ref_flyteidl.admin.AuthRole`", "", "**Deprecated.** Optional: auth override to apply this execution."
1285
- "quality_of_service", ":ref:`ref_flyteidl.core.QualityOfService`", "", "Indicates the runtime priority of the execution."
1286
- "max_parallelism", ":ref:`ref_int32`", "", "Controls the maximum number of task nodes that can be run in parallel for the entire workflow. This is useful to achieve fairness. Note: MapTasks are regarded as one unit, and parallelism/concurrency of MapTasks is independent from this."
1287
- "raw_output_data_config", ":ref:`ref_flyteidl.admin.RawOutputDataConfig`", "", "User setting to configure where to store offloaded data (i.e. Blobs, structured datasets, query data, etc.). This should be a prefix like s3://my-bucket/my-data"
1288
- "cluster_assignment", ":ref:`ref_flyteidl.admin.ClusterAssignment`", "", "Controls how to select an available cluster on which this execution should run."
1289
- "interruptible", ":ref:`ref_google.protobuf.BoolValue`", "", "Allows for the interruptible flag of a workflow to be overwritten for a single execution. Omitting this field uses the workflow's value as a default. As we need to distinguish between the field not being provided and its default value false, we have to use a wrapper around the bool field."
1290
- "overwrite_cache", ":ref:`ref_bool`", "", "Allows for all cached values of a workflow and its tasks to be overwritten for a single execution. If enabled, all calculations are performed even if cached results would be available, overwriting the stored data once execution finishes successfully."
1291
-
1292
-
1293
-
1294
-
1295
-
1296
-
1297
-
1298
- .. _ref_flyteidl.admin.ExecutionStateChangeDetails:
1299
-
1300
- ExecutionStateChangeDetails
1301
- ------------------------------------------------------------------
1302
-
1303
-
1304
-
1305
-
1306
-
1307
- .. csv-table:: ExecutionStateChangeDetails type fields
1308
- :header: "Field", "Type", "Label", "Description"
1309
- :widths: auto
1310
-
1311
- "state", ":ref:`ref_flyteidl.admin.ExecutionState`", "", "The state of the execution is used to control its visibility in the UI/CLI."
1312
- "occurred_at", ":ref:`ref_google.protobuf.Timestamp`", "", "This timestamp represents when the state changed."
1313
- "principal", ":ref:`ref_string`", "", "Identifies the entity (if any) responsible for causing the state change of the execution"
1314
-
1315
-
1316
-
1317
-
1318
-
1319
-
1320
-
1321
- .. _ref_flyteidl.admin.ExecutionTerminateRequest:
1322
-
1323
- ExecutionTerminateRequest
1324
- ------------------------------------------------------------------
1325
-
1326
- Request to terminate an in-progress execution. This action is irreversible.
1327
- If an execution is already terminated, this request will simply be a no-op.
1328
- This request will fail if it references a non-existent execution.
1329
- If the request succeeds the phase "ABORTED" will be recorded for the termination
1330
- with the optional cause added to the output_result.
1331
-
1332
-
1333
-
1334
- .. csv-table:: ExecutionTerminateRequest type fields
1335
- :header: "Field", "Type", "Label", "Description"
1336
- :widths: auto
1337
-
1338
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Uniquely identifies the individual workflow execution to be terminated."
1339
- "cause", ":ref:`ref_string`", "", "Optional reason for aborting."
1340
-
1341
-
1342
-
1343
-
1344
-
1345
-
1346
-
1347
- .. _ref_flyteidl.admin.ExecutionTerminateResponse:
1348
-
1349
- ExecutionTerminateResponse
1350
- ------------------------------------------------------------------
1351
-
1352
- Purposefully empty, may be populated in the future.
1353
-
1354
-
1355
-
1356
-
1357
-
1358
-
1359
-
1360
-
1361
- .. _ref_flyteidl.admin.ExecutionUpdateRequest:
1362
-
1363
- ExecutionUpdateRequest
1364
- ------------------------------------------------------------------
1365
-
1366
-
1367
-
1368
-
1369
-
1370
- .. csv-table:: ExecutionUpdateRequest type fields
1371
- :header: "Field", "Type", "Label", "Description"
1372
- :widths: auto
1373
-
1374
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Identifier of the execution to update"
1375
- "state", ":ref:`ref_flyteidl.admin.ExecutionState`", "", "State to set as the new value active/archive"
1376
-
1377
-
1378
-
1379
-
1380
-
1381
-
1382
-
1383
- .. _ref_flyteidl.admin.ExecutionUpdateResponse:
1384
-
1385
- ExecutionUpdateResponse
1386
- ------------------------------------------------------------------
1387
-
1388
-
1389
-
1390
-
1391
-
1392
-
1393
-
1394
-
1395
-
1396
-
1397
- .. _ref_flyteidl.admin.LiteralMapBlob:
1398
-
1399
- LiteralMapBlob
1400
- ------------------------------------------------------------------
1401
-
1402
- Input/output data can represented by actual values or a link to where values are stored
1403
-
1404
-
1405
-
1406
- .. csv-table:: LiteralMapBlob type fields
1407
- :header: "Field", "Type", "Label", "Description"
1408
- :widths: auto
1409
-
1410
- "values", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Data in LiteralMap format"
1411
- "uri", ":ref:`ref_string`", "", "In the event that the map is too large, we return a uri to the data"
1412
-
1413
-
1414
-
1415
-
1416
-
1417
-
1418
-
1419
- .. _ref_flyteidl.admin.NotificationList:
1420
-
1421
- NotificationList
1422
- ------------------------------------------------------------------
1423
-
1424
-
1425
-
1426
-
1427
-
1428
- .. csv-table:: NotificationList type fields
1429
- :header: "Field", "Type", "Label", "Description"
1430
- :widths: auto
1431
-
1432
- "notifications", ":ref:`ref_flyteidl.admin.Notification`", "repeated", ""
1433
-
1434
-
1435
-
1436
-
1437
-
1438
-
1439
-
1440
- .. _ref_flyteidl.admin.SystemMetadata:
1441
-
1442
- SystemMetadata
1443
- ------------------------------------------------------------------
1444
-
1445
- Represents system, rather than user-facing, metadata about an execution.
1446
-
1447
-
1448
-
1449
- .. csv-table:: SystemMetadata type fields
1450
- :header: "Field", "Type", "Label", "Description"
1451
- :widths: auto
1452
-
1453
- "execution_cluster", ":ref:`ref_string`", "", "Which execution cluster this execution ran on."
1454
-
1455
-
1456
-
1457
-
1458
-
1459
-
1460
-
1461
- .. _ref_flyteidl.admin.WorkflowExecutionGetDataRequest:
1462
-
1463
- WorkflowExecutionGetDataRequest
1464
- ------------------------------------------------------------------
1465
-
1466
- Request structure to fetch inputs, output and other data produced by an execution.
1467
- By default this data is not returned inline in :ref:`ref_flyteidl.admin.WorkflowExecutionGetRequest`
1468
-
1469
-
1470
-
1471
- .. csv-table:: WorkflowExecutionGetDataRequest type fields
1472
- :header: "Field", "Type", "Label", "Description"
1473
- :widths: auto
1474
-
1475
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "The identifier of the execution for which to fetch inputs and outputs."
1476
-
1477
-
1478
-
1479
-
1480
-
1481
-
1482
-
1483
- .. _ref_flyteidl.admin.WorkflowExecutionGetDataResponse:
1484
-
1485
- WorkflowExecutionGetDataResponse
1486
- ------------------------------------------------------------------
1487
-
1488
- Response structure for WorkflowExecutionGetDataRequest which contains inputs and outputs for an execution.
1489
-
1490
-
1491
-
1492
- .. csv-table:: WorkflowExecutionGetDataResponse type fields
1493
- :header: "Field", "Type", "Label", "Description"
1494
- :widths: auto
1495
-
1496
- "outputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of execution outputs. Deprecated: Please use full_outputs instead."
1497
- "inputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of execution inputs. Deprecated: Please use full_inputs instead."
1498
- "full_inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_inputs will only be populated if they are under a configured size threshold."
1499
- "full_outputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_outputs will only be populated if they are under a configured size threshold."
1500
-
1501
-
1502
-
1503
-
1504
-
1505
-
1506
-
1507
- .. _ref_flyteidl.admin.WorkflowExecutionGetRequest:
1508
-
1509
- WorkflowExecutionGetRequest
1510
- ------------------------------------------------------------------
1511
-
1512
- A message used to fetch a single workflow execution entity.
1513
- See :ref:`ref_flyteidl.admin.Execution` for more details
1514
-
1515
-
1516
-
1517
- .. csv-table:: WorkflowExecutionGetRequest type fields
1518
- :header: "Field", "Type", "Label", "Description"
1519
- :widths: auto
1520
-
1521
- "id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Uniquely identifies an individual workflow execution."
1522
-
1523
-
1524
-
1525
-
1526
-
1527
-
1528
- ..
1529
- end messages
1530
-
1531
-
1532
-
1533
- .. _ref_flyteidl.admin.ExecutionMetadata.ExecutionMode:
1534
-
1535
- ExecutionMetadata.ExecutionMode
1536
- ------------------------------------------------------------------
1537
-
1538
- The method by which this execution was launched.
1539
-
1540
- .. csv-table:: Enum ExecutionMetadata.ExecutionMode values
1541
- :header: "Name", "Number", "Description"
1542
- :widths: auto
1543
-
1544
- "MANUAL", "0", "The default execution mode, MANUAL implies that an execution was launched by an individual."
1545
- "SCHEDULED", "1", "A schedule triggered this execution launch."
1546
- "SYSTEM", "2", "A system process was responsible for launching this execution rather an individual."
1547
- "RELAUNCH", "3", "This execution was launched with identical inputs as a previous execution."
1548
- "CHILD_WORKFLOW", "4", "This execution was triggered by another execution."
1549
- "RECOVERED", "5", "This execution was recovered from another execution."
1550
-
1551
-
1552
-
1553
- .. _ref_flyteidl.admin.ExecutionState:
1554
-
1555
- ExecutionState
1556
- ------------------------------------------------------------------
1557
-
1558
- The state of the execution is used to control its visibility in the UI/CLI.
1559
-
1560
- .. csv-table:: Enum ExecutionState values
1561
- :header: "Name", "Number", "Description"
1562
- :widths: auto
1563
-
1564
- "EXECUTION_ACTIVE", "0", "By default, all executions are considered active."
1565
- "EXECUTION_ARCHIVED", "1", "Archived executions are no longer visible in the UI."
1566
-
1567
-
1568
- ..
1569
- end enums
1570
-
1571
-
1572
- ..
1573
- end HasExtensions
1574
-
1575
-
1576
- ..
1577
- end services
1578
-
1579
-
1580
-
1581
-
1582
- .. _ref_flyteidl/admin/launch_plan.proto:
1583
-
1584
- flyteidl/admin/launch_plan.proto
1585
- ==================================================================
1586
-
1587
-
1588
-
1589
-
1590
-
1591
- .. _ref_flyteidl.admin.ActiveLaunchPlanListRequest:
1592
-
1593
- ActiveLaunchPlanListRequest
1594
- ------------------------------------------------------------------
1595
-
1596
- Represents a request structure to list active launch plans within a project/domain.
1597
- See :ref:`ref_flyteidl.admin.LaunchPlan` for more details
1598
-
1599
-
1600
-
1601
- .. csv-table:: ActiveLaunchPlanListRequest type fields
1602
- :header: "Field", "Type", "Label", "Description"
1603
- :widths: auto
1604
-
1605
- "project", ":ref:`ref_string`", "", "Name of the project that contains the identifiers. +required."
1606
- "domain", ":ref:`ref_string`", "", "Name of the domain the identifiers belongs to within the project. +required."
1607
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required."
1608
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. +optional"
1609
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
1610
-
1611
-
1612
-
1613
-
1614
-
1615
-
1616
-
1617
- .. _ref_flyteidl.admin.ActiveLaunchPlanRequest:
1618
-
1619
- ActiveLaunchPlanRequest
1620
- ------------------------------------------------------------------
1621
-
1622
- Represents a request struct for finding an active launch plan for a given NamedEntityIdentifier
1623
- See :ref:`ref_flyteidl.admin.LaunchPlan` for more details
1624
-
1625
-
1626
-
1627
- .. csv-table:: ActiveLaunchPlanRequest type fields
1628
- :header: "Field", "Type", "Label", "Description"
1629
- :widths: auto
1630
-
1631
- "id", ":ref:`ref_flyteidl.admin.NamedEntityIdentifier`", "", "+required."
1632
-
1633
-
1634
-
1635
-
1636
-
1637
-
1638
-
1639
- .. _ref_flyteidl.admin.Auth:
1640
-
1641
- Auth
1642
- ------------------------------------------------------------------
1643
-
1644
- Defines permissions associated with executions created by this launch plan spec.
1645
- Use either of these roles when they have permissions required by your workflow execution.
1646
- Deprecated.
1647
-
1648
-
1649
-
1650
- .. csv-table:: Auth type fields
1651
- :header: "Field", "Type", "Label", "Description"
1652
- :widths: auto
1653
-
1654
- "assumable_iam_role", ":ref:`ref_string`", "", "Defines an optional iam role which will be used for tasks run in executions created with this launch plan."
1655
- "kubernetes_service_account", ":ref:`ref_string`", "", "Defines an optional kubernetes service account which will be used for tasks run in executions created with this launch plan."
1656
-
1657
-
1658
-
1659
-
1660
-
1661
-
1662
-
1663
- .. _ref_flyteidl.admin.LaunchPlan:
1664
-
1665
- LaunchPlan
1666
- ------------------------------------------------------------------
1667
-
1668
- A LaunchPlan provides the capability to templatize workflow executions.
1669
- Launch plans simplify associating one or more schedules, inputs and notifications with your workflows.
1670
- Launch plans can be shared and used to trigger executions with predefined inputs even when a workflow
1671
- definition doesn't necessarily have a default value for said input.
1672
-
1673
-
1674
-
1675
- .. csv-table:: LaunchPlan type fields
1676
- :header: "Field", "Type", "Label", "Description"
1677
- :widths: auto
1678
-
1679
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "Uniquely identifies a launch plan entity."
1680
- "spec", ":ref:`ref_flyteidl.admin.LaunchPlanSpec`", "", "User-provided launch plan details, including reference workflow, inputs and other metadata."
1681
- "closure", ":ref:`ref_flyteidl.admin.LaunchPlanClosure`", "", "Values computed by the flyte platform after launch plan registration."
1682
-
1683
-
1684
-
1685
-
1686
-
1687
-
1688
-
1689
- .. _ref_flyteidl.admin.LaunchPlanClosure:
1690
-
1691
- LaunchPlanClosure
1692
- ------------------------------------------------------------------
1693
-
1694
- Values computed by the flyte platform after launch plan registration.
1695
- These include expected_inputs required to be present in a CreateExecutionRequest
1696
- to launch the reference workflow as well timestamp values associated with the launch plan.
1697
-
1698
-
1699
-
1700
- .. csv-table:: LaunchPlanClosure type fields
1701
- :header: "Field", "Type", "Label", "Description"
1702
- :widths: auto
1703
-
1704
- "state", ":ref:`ref_flyteidl.admin.LaunchPlanState`", "", "Indicate the Launch plan state."
1705
- "expected_inputs", ":ref:`ref_flyteidl.core.ParameterMap`", "", "Indicates the set of inputs expected when creating an execution with the Launch plan"
1706
- "expected_outputs", ":ref:`ref_flyteidl.core.VariableMap`", "", "Indicates the set of outputs expected to be produced by creating an execution with the Launch plan"
1707
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the launch plan was created."
1708
- "updated_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the launch plan was last updated."
1709
-
1710
-
1711
-
1712
-
1713
-
1714
-
1715
-
1716
- .. _ref_flyteidl.admin.LaunchPlanCreateRequest:
1717
-
1718
- LaunchPlanCreateRequest
1719
- ------------------------------------------------------------------
1720
-
1721
- Request to register a launch plan. The included LaunchPlanSpec may have a complete or incomplete set of inputs required
1722
- to launch a workflow execution. By default all launch plans are registered in state INACTIVE. If you wish to
1723
- set the state to ACTIVE, you must submit a LaunchPlanUpdateRequest, after you have successfully created a launch plan.
1724
-
1725
-
1726
-
1727
- .. csv-table:: LaunchPlanCreateRequest type fields
1728
- :header: "Field", "Type", "Label", "Description"
1729
- :widths: auto
1730
-
1731
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "Uniquely identifies a launch plan entity."
1732
- "spec", ":ref:`ref_flyteidl.admin.LaunchPlanSpec`", "", "User-provided launch plan details, including reference workflow, inputs and other metadata."
1733
-
1734
-
1735
-
1736
-
1737
-
1738
-
1739
-
1740
- .. _ref_flyteidl.admin.LaunchPlanCreateResponse:
1741
-
1742
- LaunchPlanCreateResponse
1743
- ------------------------------------------------------------------
1744
-
1745
- Purposefully empty, may be populated in the future.
1746
-
1747
-
1748
-
1749
-
1750
-
1751
-
1752
-
1753
-
1754
- .. _ref_flyteidl.admin.LaunchPlanList:
1755
-
1756
- LaunchPlanList
1757
- ------------------------------------------------------------------
1758
-
1759
- Response object for list launch plan requests.
1760
- See :ref:`ref_flyteidl.admin.LaunchPlan` for more details
1761
-
1762
-
1763
-
1764
- .. csv-table:: LaunchPlanList type fields
1765
- :header: "Field", "Type", "Label", "Description"
1766
- :widths: auto
1767
-
1768
- "launch_plans", ":ref:`ref_flyteidl.admin.LaunchPlan`", "repeated", ""
1769
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
1770
-
1771
-
1772
-
1773
-
1774
-
1775
-
1776
-
1777
- .. _ref_flyteidl.admin.LaunchPlanMetadata:
1778
-
1779
- LaunchPlanMetadata
1780
- ------------------------------------------------------------------
1781
-
1782
- Additional launch plan attributes included in the LaunchPlanSpec not strictly required to launch
1783
- the reference workflow.
1784
-
1785
-
1786
-
1787
- .. csv-table:: LaunchPlanMetadata type fields
1788
- :header: "Field", "Type", "Label", "Description"
1789
- :widths: auto
1790
-
1791
- "schedule", ":ref:`ref_flyteidl.admin.Schedule`", "", "Schedule to execute the Launch Plan"
1792
- "notifications", ":ref:`ref_flyteidl.admin.Notification`", "repeated", "List of notifications based on Execution status transitions"
1793
-
1794
-
1795
-
1796
-
1797
-
1798
-
1799
-
1800
- .. _ref_flyteidl.admin.LaunchPlanSpec:
1801
-
1802
- LaunchPlanSpec
1803
- ------------------------------------------------------------------
1804
-
1805
- User-provided launch plan definition and configuration values.
1806
-
1807
-
1808
-
1809
- .. csv-table:: LaunchPlanSpec type fields
1810
- :header: "Field", "Type", "Label", "Description"
1811
- :widths: auto
1812
-
1813
- "workflow_id", ":ref:`ref_flyteidl.core.Identifier`", "", "Reference to the Workflow template that the launch plan references"
1814
- "entity_metadata", ":ref:`ref_flyteidl.admin.LaunchPlanMetadata`", "", "Metadata for the Launch Plan"
1815
- "default_inputs", ":ref:`ref_flyteidl.core.ParameterMap`", "", "Input values to be passed for the execution. These can be overridden when an execution is created with this launch plan."
1816
- "fixed_inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Fixed, non-overridable inputs for the Launch Plan. These can not be overridden when an execution is created with this launch plan."
1817
- "role", ":ref:`ref_string`", "", "**Deprecated.** String to indicate the role to use to execute the workflow underneath"
1818
- "labels", ":ref:`ref_flyteidl.admin.Labels`", "", "Custom labels to be applied to the execution resource."
1819
- "annotations", ":ref:`ref_flyteidl.admin.Annotations`", "", "Custom annotations to be applied to the execution resource."
1820
- "auth", ":ref:`ref_flyteidl.admin.Auth`", "", "**Deprecated.** Indicates the permission associated with workflow executions triggered with this launch plan."
1821
- "auth_role", ":ref:`ref_flyteidl.admin.AuthRole`", "", "**Deprecated.** "
1822
- "security_context", ":ref:`ref_flyteidl.core.SecurityContext`", "", "Indicates security context for permissions triggered with this launch plan"
1823
- "quality_of_service", ":ref:`ref_flyteidl.core.QualityOfService`", "", "Indicates the runtime priority of the execution."
1824
- "raw_output_data_config", ":ref:`ref_flyteidl.admin.RawOutputDataConfig`", "", "Encapsulates user settings pertaining to offloaded data (i.e. Blobs, Schema, query data, etc.)."
1825
- "max_parallelism", ":ref:`ref_int32`", "", "Controls the maximum number of tasknodes that can be run in parallel for the entire workflow. This is useful to achieve fairness. Note: MapTasks are regarded as one unit, and parallelism/concurrency of MapTasks is independent from this."
1826
- "interruptible", ":ref:`ref_google.protobuf.BoolValue`", "", "Allows for the interruptible flag of a workflow to be overwritten for a single execution. Omitting this field uses the workflow's value as a default. As we need to distinguish between the field not being provided and its default value false, we have to use a wrapper around the bool field."
1827
- "overwrite_cache", ":ref:`ref_bool`", "", "Allows for all cached values of a workflow and its tasks to be overwritten for a single execution. If enabled, all calculations are performed even if cached results would be available, overwriting the stored data once execution finishes successfully."
1828
-
1829
-
1830
-
1831
-
1832
-
1833
-
1834
-
1835
- .. _ref_flyteidl.admin.LaunchPlanUpdateRequest:
1836
-
1837
- LaunchPlanUpdateRequest
1838
- ------------------------------------------------------------------
1839
-
1840
- Request to set the referenced launch plan state to the configured value.
1841
- See :ref:`ref_flyteidl.admin.LaunchPlan` for more details
1842
-
1843
-
1844
-
1845
- .. csv-table:: LaunchPlanUpdateRequest type fields
1846
- :header: "Field", "Type", "Label", "Description"
1847
- :widths: auto
1848
-
1849
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "Identifier of launch plan for which to change state. +required."
1850
- "state", ":ref:`ref_flyteidl.admin.LaunchPlanState`", "", "Desired state to apply to the launch plan. +required."
1851
-
1852
-
1853
-
1854
-
1855
-
1856
-
1857
-
1858
- .. _ref_flyteidl.admin.LaunchPlanUpdateResponse:
1859
-
1860
- LaunchPlanUpdateResponse
1861
- ------------------------------------------------------------------
1862
-
1863
- Purposefully empty, may be populated in the future.
1864
-
1865
-
1866
-
1867
-
1868
-
1869
-
1870
-
1871
- ..
1872
- end messages
1873
-
1874
-
1875
-
1876
- .. _ref_flyteidl.admin.LaunchPlanState:
1877
-
1878
- LaunchPlanState
1879
- ------------------------------------------------------------------
1880
-
1881
- By default any launch plan regardless of state can be used to launch a workflow execution.
1882
- However, at most one version of a launch plan
1883
- (e.g. a NamedEntityIdentifier set of shared project, domain and name values) can be
1884
- active at a time in regards to *schedules*. That is, at most one schedule in a NamedEntityIdentifier
1885
- group will be observed and trigger executions at a defined cadence.
1886
-
1887
- .. csv-table:: Enum LaunchPlanState values
1888
- :header: "Name", "Number", "Description"
1889
- :widths: auto
1890
-
1891
- "INACTIVE", "0", ""
1892
- "ACTIVE", "1", ""
1893
-
1894
-
1895
- ..
1896
- end enums
1897
-
1898
-
1899
- ..
1900
- end HasExtensions
1901
-
1902
-
1903
- ..
1904
- end services
1905
-
1906
-
1907
-
1908
-
1909
- .. _ref_flyteidl/admin/matchable_resource.proto:
1910
-
1911
- flyteidl/admin/matchable_resource.proto
1912
- ==================================================================
1913
-
1914
-
1915
-
1916
-
1917
-
1918
- .. _ref_flyteidl.admin.ClusterResourceAttributes:
1919
-
1920
- ClusterResourceAttributes
1921
- ------------------------------------------------------------------
1922
-
1923
-
1924
-
1925
-
1926
-
1927
- .. csv-table:: ClusterResourceAttributes type fields
1928
- :header: "Field", "Type", "Label", "Description"
1929
- :widths: auto
1930
-
1931
- "attributes", ":ref:`ref_flyteidl.admin.ClusterResourceAttributes.AttributesEntry`", "repeated", "Custom resource attributes which will be applied in cluster resource creation (e.g. quotas). Map keys are the *case-sensitive* names of variables in templatized resource files. Map values should be the custom values which get substituted during resource creation."
1932
-
1933
-
1934
-
1935
-
1936
-
1937
-
1938
-
1939
- .. _ref_flyteidl.admin.ClusterResourceAttributes.AttributesEntry:
1940
-
1941
- ClusterResourceAttributes.AttributesEntry
1942
- ------------------------------------------------------------------
1943
-
1944
-
1945
-
1946
-
1947
-
1948
- .. csv-table:: ClusterResourceAttributes.AttributesEntry type fields
1949
- :header: "Field", "Type", "Label", "Description"
1950
- :widths: auto
1951
-
1952
- "key", ":ref:`ref_string`", "", ""
1953
- "value", ":ref:`ref_string`", "", ""
1954
-
1955
-
1956
-
1957
-
1958
-
1959
-
1960
-
1961
- .. _ref_flyteidl.admin.ExecutionClusterLabel:
1962
-
1963
- ExecutionClusterLabel
1964
- ------------------------------------------------------------------
1965
-
1966
-
1967
-
1968
-
1969
-
1970
- .. csv-table:: ExecutionClusterLabel type fields
1971
- :header: "Field", "Type", "Label", "Description"
1972
- :widths: auto
1973
-
1974
- "value", ":ref:`ref_string`", "", "Label value to determine where the execution will be run"
1975
-
1976
-
1977
-
1978
-
1979
-
1980
-
1981
-
1982
- .. _ref_flyteidl.admin.ExecutionQueueAttributes:
1983
-
1984
- ExecutionQueueAttributes
1985
- ------------------------------------------------------------------
1986
-
1987
-
1988
-
1989
-
1990
-
1991
- .. csv-table:: ExecutionQueueAttributes type fields
1992
- :header: "Field", "Type", "Label", "Description"
1993
- :widths: auto
1994
-
1995
- "tags", ":ref:`ref_string`", "repeated", "Tags used for assigning execution queues for tasks defined within this project."
1996
-
1997
-
1998
-
1999
-
2000
-
2001
-
2002
-
2003
- .. _ref_flyteidl.admin.ListMatchableAttributesRequest:
2004
-
2005
- ListMatchableAttributesRequest
2006
- ------------------------------------------------------------------
2007
-
2008
- Request all matching resource attributes for a resource type.
2009
- See :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration` for more details
2010
-
2011
-
2012
-
2013
- .. csv-table:: ListMatchableAttributesRequest type fields
2014
- :header: "Field", "Type", "Label", "Description"
2015
- :widths: auto
2016
-
2017
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "+required"
2018
-
2019
-
2020
-
2021
-
2022
-
2023
-
2024
-
2025
- .. _ref_flyteidl.admin.ListMatchableAttributesResponse:
2026
-
2027
- ListMatchableAttributesResponse
2028
- ------------------------------------------------------------------
2029
-
2030
- Response for a request for all matching resource attributes for a resource type.
2031
- See :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration` for more details
2032
-
2033
-
2034
-
2035
- .. csv-table:: ListMatchableAttributesResponse type fields
2036
- :header: "Field", "Type", "Label", "Description"
2037
- :widths: auto
2038
-
2039
- "configurations", ":ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`", "repeated", ""
2040
-
2041
-
2042
-
2043
-
2044
-
2045
-
2046
-
2047
- .. _ref_flyteidl.admin.MatchableAttributesConfiguration:
2048
-
2049
- MatchableAttributesConfiguration
2050
- ------------------------------------------------------------------
2051
-
2052
- Represents a custom set of attributes applied for either a domain; a domain and project; or
2053
- domain, project and workflow name.
2054
- These are used to override system level defaults for kubernetes cluster resource management,
2055
- default execution values, and more all across different levels of specificity.
2056
-
2057
-
2058
-
2059
- .. csv-table:: MatchableAttributesConfiguration type fields
2060
- :header: "Field", "Type", "Label", "Description"
2061
- :widths: auto
2062
-
2063
- "attributes", ":ref:`ref_flyteidl.admin.MatchingAttributes`", "", ""
2064
- "domain", ":ref:`ref_string`", "", ""
2065
- "project", ":ref:`ref_string`", "", ""
2066
- "workflow", ":ref:`ref_string`", "", ""
2067
- "launch_plan", ":ref:`ref_string`", "", ""
2068
-
2069
-
2070
-
2071
-
2072
-
2073
-
2074
-
2075
- .. _ref_flyteidl.admin.MatchingAttributes:
2076
-
2077
- MatchingAttributes
2078
- ------------------------------------------------------------------
2079
-
2080
- Generic container for encapsulating all types of the above attributes messages.
2081
-
2082
-
2083
-
2084
- .. csv-table:: MatchingAttributes type fields
2085
- :header: "Field", "Type", "Label", "Description"
2086
- :widths: auto
2087
-
2088
- "task_resource_attributes", ":ref:`ref_flyteidl.admin.TaskResourceAttributes`", "", ""
2089
- "cluster_resource_attributes", ":ref:`ref_flyteidl.admin.ClusterResourceAttributes`", "", ""
2090
- "execution_queue_attributes", ":ref:`ref_flyteidl.admin.ExecutionQueueAttributes`", "", ""
2091
- "execution_cluster_label", ":ref:`ref_flyteidl.admin.ExecutionClusterLabel`", "", ""
2092
- "quality_of_service", ":ref:`ref_flyteidl.core.QualityOfService`", "", ""
2093
- "plugin_overrides", ":ref:`ref_flyteidl.admin.PluginOverrides`", "", ""
2094
- "workflow_execution_config", ":ref:`ref_flyteidl.admin.WorkflowExecutionConfig`", "", ""
2095
- "cluster_assignment", ":ref:`ref_flyteidl.admin.ClusterAssignment`", "", ""
2096
-
2097
-
2098
-
2099
-
2100
-
2101
-
2102
-
2103
- .. _ref_flyteidl.admin.PluginOverride:
2104
-
2105
- PluginOverride
2106
- ------------------------------------------------------------------
2107
-
2108
- This MatchableAttribute configures selecting alternate plugin implementations for a given task type.
2109
- In addition to an override implementation a selection of fallbacks can be provided or other modes
2110
- for handling cases where the desired plugin override is not enabled in a given Flyte deployment.
2111
-
2112
-
2113
-
2114
- .. csv-table:: PluginOverride type fields
2115
- :header: "Field", "Type", "Label", "Description"
2116
- :widths: auto
2117
-
2118
- "task_type", ":ref:`ref_string`", "", "A predefined yet extensible Task type identifier."
2119
- "plugin_id", ":ref:`ref_string`", "repeated", "A set of plugin ids which should handle tasks of this type instead of the default registered plugin. The list will be tried in order until a plugin is found with that id."
2120
- "missing_plugin_behavior", ":ref:`ref_flyteidl.admin.PluginOverride.MissingPluginBehavior`", "", "Defines the behavior when no plugin from the plugin_id list is not found."
2121
-
2122
-
2123
-
2124
-
2125
-
2126
-
2127
-
2128
- .. _ref_flyteidl.admin.PluginOverrides:
2129
-
2130
- PluginOverrides
2131
- ------------------------------------------------------------------
2132
-
2133
-
2134
-
2135
-
2136
-
2137
- .. csv-table:: PluginOverrides type fields
2138
- :header: "Field", "Type", "Label", "Description"
2139
- :widths: auto
2140
-
2141
- "overrides", ":ref:`ref_flyteidl.admin.PluginOverride`", "repeated", ""
2142
-
2143
-
2144
-
2145
-
2146
-
2147
-
2148
-
2149
- .. _ref_flyteidl.admin.TaskResourceAttributes:
2150
-
2151
- TaskResourceAttributes
2152
- ------------------------------------------------------------------
2153
-
2154
- Defines task resource defaults and limits that will be applied at task registration.
2155
-
2156
-
2157
-
2158
- .. csv-table:: TaskResourceAttributes type fields
2159
- :header: "Field", "Type", "Label", "Description"
2160
- :widths: auto
2161
-
2162
- "defaults", ":ref:`ref_flyteidl.admin.TaskResourceSpec`", "", ""
2163
- "limits", ":ref:`ref_flyteidl.admin.TaskResourceSpec`", "", ""
2164
-
2165
-
2166
-
2167
-
2168
-
2169
-
2170
-
2171
- .. _ref_flyteidl.admin.TaskResourceSpec:
2172
-
2173
- TaskResourceSpec
2174
- ------------------------------------------------------------------
2175
-
2176
- Defines a set of overridable task resource attributes set during task registration.
2177
-
2178
-
2179
-
2180
- .. csv-table:: TaskResourceSpec type fields
2181
- :header: "Field", "Type", "Label", "Description"
2182
- :widths: auto
2183
-
2184
- "cpu", ":ref:`ref_string`", "", ""
2185
- "gpu", ":ref:`ref_string`", "", ""
2186
- "memory", ":ref:`ref_string`", "", ""
2187
- "storage", ":ref:`ref_string`", "", ""
2188
- "ephemeral_storage", ":ref:`ref_string`", "", ""
2189
-
2190
-
2191
-
2192
-
2193
-
2194
-
2195
-
2196
- .. _ref_flyteidl.admin.WorkflowExecutionConfig:
2197
-
2198
- WorkflowExecutionConfig
2199
- ------------------------------------------------------------------
2200
-
2201
- Adds defaults for customizable workflow-execution specifications and overrides.
2202
-
2203
-
2204
-
2205
- .. csv-table:: WorkflowExecutionConfig type fields
2206
- :header: "Field", "Type", "Label", "Description"
2207
- :widths: auto
2208
-
2209
- "max_parallelism", ":ref:`ref_int32`", "", "Can be used to control the number of parallel nodes to run within the workflow. This is useful to achieve fairness."
2210
- "security_context", ":ref:`ref_flyteidl.core.SecurityContext`", "", "Indicates security context permissions for executions triggered with this matchable attribute."
2211
- "raw_output_data_config", ":ref:`ref_flyteidl.admin.RawOutputDataConfig`", "", "Encapsulates user settings pertaining to offloaded data (i.e. Blobs, Schema, query data, etc.)."
2212
- "labels", ":ref:`ref_flyteidl.admin.Labels`", "", "Custom labels to be applied to a triggered execution resource."
2213
- "annotations", ":ref:`ref_flyteidl.admin.Annotations`", "", "Custom annotations to be applied to a triggered execution resource."
2214
- "interruptible", ":ref:`ref_google.protobuf.BoolValue`", "", "Allows for the interruptible flag of a workflow to be overwritten for a single execution. Omitting this field uses the workflow's value as a default. As we need to distinguish between the field not being provided and its default value false, we have to use a wrapper around the bool field."
2215
- "overwrite_cache", ":ref:`ref_bool`", "", "Allows for all cached values of a workflow and its tasks to be overwritten for a single execution. If enabled, all calculations are performed even if cached results would be available, overwriting the stored data once execution finishes successfully."
2216
-
2217
-
2218
-
2219
-
2220
-
2221
-
2222
- ..
2223
- end messages
2224
-
2225
-
2226
-
2227
- .. _ref_flyteidl.admin.MatchableResource:
2228
-
2229
- MatchableResource
2230
- ------------------------------------------------------------------
2231
-
2232
- Defines a resource that can be configured by customizable Project-, ProjectDomain- or WorkflowAttributes
2233
- based on matching tags.
2234
-
2235
- .. csv-table:: Enum MatchableResource values
2236
- :header: "Name", "Number", "Description"
2237
- :widths: auto
2238
-
2239
- "TASK_RESOURCE", "0", "Applies to customizable task resource requests and limits."
2240
- "CLUSTER_RESOURCE", "1", "Applies to configuring templated kubernetes cluster resources."
2241
- "EXECUTION_QUEUE", "2", "Configures task and dynamic task execution queue assignment."
2242
- "EXECUTION_CLUSTER_LABEL", "3", "Configures the K8s cluster label to be used for execution to be run"
2243
- "QUALITY_OF_SERVICE_SPECIFICATION", "4", "Configures default quality of service when undefined in an execution spec."
2244
- "PLUGIN_OVERRIDE", "5", "Selects configurable plugin implementation behavior for a given task type."
2245
- "WORKFLOW_EXECUTION_CONFIG", "6", "Adds defaults for customizable workflow-execution specifications and overrides."
2246
- "CLUSTER_ASSIGNMENT", "7", "Controls how to select an available cluster on which this execution should run."
2247
-
2248
-
2249
-
2250
- .. _ref_flyteidl.admin.PluginOverride.MissingPluginBehavior:
2251
-
2252
- PluginOverride.MissingPluginBehavior
2253
- ------------------------------------------------------------------
2254
-
2255
-
2256
-
2257
- .. csv-table:: Enum PluginOverride.MissingPluginBehavior values
2258
- :header: "Name", "Number", "Description"
2259
- :widths: auto
2260
-
2261
- "FAIL", "0", "By default, if this plugin is not enabled for a Flyte deployment then execution will fail."
2262
- "USE_DEFAULT", "1", "Uses the system-configured default implementation."
2263
-
2264
-
2265
- ..
2266
- end enums
2267
-
2268
-
2269
- ..
2270
- end HasExtensions
2271
-
2272
-
2273
- ..
2274
- end services
2275
-
2276
-
2277
-
2278
-
2279
- .. _ref_flyteidl/admin/node_execution.proto:
2280
-
2281
- flyteidl/admin/node_execution.proto
2282
- ==================================================================
2283
-
2284
-
2285
-
2286
-
2287
-
2288
- .. _ref_flyteidl.admin.DynamicWorkflowNodeMetadata:
2289
-
2290
- DynamicWorkflowNodeMetadata
2291
- ------------------------------------------------------------------
2292
-
2293
- For dynamic workflow nodes we capture information about the dynamic workflow definition that gets generated.
2294
-
2295
-
2296
-
2297
- .. csv-table:: DynamicWorkflowNodeMetadata type fields
2298
- :header: "Field", "Type", "Label", "Description"
2299
- :widths: auto
2300
-
2301
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the workflow."
2302
- "compiled_workflow", ":ref:`ref_flyteidl.core.CompiledWorkflowClosure`", "", "Represents the compiled representation of the embedded dynamic workflow."
2303
-
2304
-
2305
-
2306
-
2307
-
2308
-
2309
-
2310
- .. _ref_flyteidl.admin.NodeExecution:
2311
-
2312
- NodeExecution
2313
- ------------------------------------------------------------------
2314
-
2315
- Encapsulates all details for a single node execution entity.
2316
- A node represents a component in the overall workflow graph. A node launch a task, multiple tasks, an entire nested
2317
- sub-workflow, or even a separate child-workflow execution.
2318
- The same task can be called repeatedly in a single workflow but each node is unique.
2319
-
2320
-
2321
-
2322
- .. csv-table:: NodeExecution type fields
2323
- :header: "Field", "Type", "Label", "Description"
2324
- :widths: auto
2325
-
2326
- "id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "Uniquely identifies an individual node execution."
2327
- "input_uri", ":ref:`ref_string`", "", "Path to remote data store where input blob is stored."
2328
- "closure", ":ref:`ref_flyteidl.admin.NodeExecutionClosure`", "", "Computed results associated with this node execution."
2329
- "metadata", ":ref:`ref_flyteidl.admin.NodeExecutionMetaData`", "", "Metadata for Node Execution"
2330
-
2331
-
2332
-
2333
-
2334
-
2335
-
2336
-
2337
- .. _ref_flyteidl.admin.NodeExecutionClosure:
2338
-
2339
- NodeExecutionClosure
2340
- ------------------------------------------------------------------
2341
-
2342
- Container for node execution details and results.
2343
-
2344
-
2345
-
2346
- .. csv-table:: NodeExecutionClosure type fields
2347
- :header: "Field", "Type", "Label", "Description"
2348
- :widths: auto
2349
-
2350
- "output_uri", ":ref:`ref_string`", "", "**Deprecated.** Links to a remotely stored, serialized core.LiteralMap of node execution outputs. DEPRECATED. Use GetNodeExecutionData to fetch output data instead."
2351
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information for the Node"
2352
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Raw output data produced by this node execution. DEPRECATED. Use GetNodeExecutionData to fetch output data instead."
2353
- "phase", ":ref:`ref_flyteidl.core.NodeExecution.Phase`", "", "The last recorded phase for this node execution."
2354
- "started_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the node execution began running."
2355
- "duration", ":ref:`ref_google.protobuf.Duration`", "", "The amount of time the node execution spent running."
2356
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the node execution was created."
2357
- "updated_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the node execution was last updated."
2358
- "workflow_node_metadata", ":ref:`ref_flyteidl.admin.WorkflowNodeMetadata`", "", ""
2359
- "task_node_metadata", ":ref:`ref_flyteidl.admin.TaskNodeMetadata`", "", ""
2360
- "deck_uri", ":ref:`ref_string`", "", "String location uniquely identifying where the deck HTML file is. NativeUrl specifies the url in the format of the configured storage provider (e.g. s3://my-bucket/randomstring/suffix.tar)"
2361
-
2362
-
2363
-
2364
-
2365
-
2366
-
2367
-
2368
- .. _ref_flyteidl.admin.NodeExecutionForTaskListRequest:
2369
-
2370
- NodeExecutionForTaskListRequest
2371
- ------------------------------------------------------------------
2372
-
2373
- Represents a request structure to retrieve a list of node execution entities launched by a specific task.
2374
- This can arise when a task yields a subworkflow.
2375
-
2376
-
2377
-
2378
- .. csv-table:: NodeExecutionForTaskListRequest type fields
2379
- :header: "Field", "Type", "Label", "Description"
2380
- :widths: auto
2381
-
2382
- "task_execution_id", ":ref:`ref_flyteidl.core.TaskExecutionIdentifier`", "", "Indicates the node execution to filter by. +required"
2383
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
2384
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the, server-provided token can be used to fetch the next page in a query. +optional"
2385
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
2386
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
2387
-
2388
-
2389
-
2390
-
2391
-
2392
-
2393
-
2394
- .. _ref_flyteidl.admin.NodeExecutionGetDataRequest:
2395
-
2396
- NodeExecutionGetDataRequest
2397
- ------------------------------------------------------------------
2398
-
2399
- Request structure to fetch inputs and output for a node execution.
2400
- By default, these are not returned in :ref:`ref_flyteidl.admin.NodeExecutionGetRequest`
2401
-
2402
-
2403
-
2404
- .. csv-table:: NodeExecutionGetDataRequest type fields
2405
- :header: "Field", "Type", "Label", "Description"
2406
- :widths: auto
2407
-
2408
- "id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "The identifier of the node execution for which to fetch inputs and outputs."
2409
-
2410
-
2411
-
2412
-
2413
-
2414
-
2415
-
2416
- .. _ref_flyteidl.admin.NodeExecutionGetDataResponse:
2417
-
2418
- NodeExecutionGetDataResponse
2419
- ------------------------------------------------------------------
2420
-
2421
- Response structure for NodeExecutionGetDataRequest which contains inputs and outputs for a node execution.
2422
-
2423
-
2424
-
2425
- .. csv-table:: NodeExecutionGetDataResponse type fields
2426
- :header: "Field", "Type", "Label", "Description"
2427
- :widths: auto
2428
-
2429
- "inputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of node execution inputs. Deprecated: Please use full_inputs instead."
2430
- "outputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of node execution outputs. Deprecated: Please use full_outputs instead."
2431
- "full_inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_inputs will only be populated if they are under a configured size threshold."
2432
- "full_outputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_outputs will only be populated if they are under a configured size threshold."
2433
- "dynamic_workflow", ":ref:`ref_flyteidl.admin.DynamicWorkflowNodeMetadata`", "", "Optional Workflow closure for a dynamically generated workflow, in the case this node yields a dynamic workflow we return its structure here."
2434
-
2435
-
2436
-
2437
-
2438
-
2439
-
2440
-
2441
- .. _ref_flyteidl.admin.NodeExecutionGetRequest:
2442
-
2443
- NodeExecutionGetRequest
2444
- ------------------------------------------------------------------
2445
-
2446
- A message used to fetch a single node execution entity.
2447
- See :ref:`ref_flyteidl.admin.NodeExecution` for more details
2448
-
2449
-
2450
-
2451
- .. csv-table:: NodeExecutionGetRequest type fields
2452
- :header: "Field", "Type", "Label", "Description"
2453
- :widths: auto
2454
-
2455
- "id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "Uniquely identifies an individual node execution. +required"
2456
-
2457
-
2458
-
2459
-
2460
-
2461
-
2462
-
2463
- .. _ref_flyteidl.admin.NodeExecutionList:
2464
-
2465
- NodeExecutionList
2466
- ------------------------------------------------------------------
2467
-
2468
- Request structure to retrieve a list of node execution entities.
2469
- See :ref:`ref_flyteidl.admin.NodeExecution` for more details
2470
-
2471
-
2472
-
2473
- .. csv-table:: NodeExecutionList type fields
2474
- :header: "Field", "Type", "Label", "Description"
2475
- :widths: auto
2476
-
2477
- "node_executions", ":ref:`ref_flyteidl.admin.NodeExecution`", "repeated", ""
2478
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
2479
-
2480
-
2481
-
2482
-
2483
-
2484
-
2485
-
2486
- .. _ref_flyteidl.admin.NodeExecutionListRequest:
2487
-
2488
- NodeExecutionListRequest
2489
- ------------------------------------------------------------------
2490
-
2491
- Represents a request structure to retrieve a list of node execution entities.
2492
- See :ref:`ref_flyteidl.admin.NodeExecution` for more details
2493
-
2494
-
2495
-
2496
- .. csv-table:: NodeExecutionListRequest type fields
2497
- :header: "Field", "Type", "Label", "Description"
2498
- :widths: auto
2499
-
2500
- "workflow_execution_id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Indicates the workflow execution to filter by. +required"
2501
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
2502
- "token", ":ref:`ref_string`", "", ""
2503
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
2504
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
2505
- "unique_parent_id", ":ref:`ref_string`", "", "Unique identifier of the parent node in the execution +optional"
2506
-
2507
-
2508
-
2509
-
2510
-
2511
-
2512
-
2513
- .. _ref_flyteidl.admin.NodeExecutionMetaData:
2514
-
2515
- NodeExecutionMetaData
2516
- ------------------------------------------------------------------
2517
-
2518
- Represents additional attributes related to a Node Execution
2519
-
2520
-
2521
-
2522
- .. csv-table:: NodeExecutionMetaData type fields
2523
- :header: "Field", "Type", "Label", "Description"
2524
- :widths: auto
2525
-
2526
- "retry_group", ":ref:`ref_string`", "", "Node executions are grouped depending on retries of the parent Retry group is unique within the context of a parent node."
2527
- "is_parent_node", ":ref:`ref_bool`", "", "Boolean flag indicating if the node has child nodes under it This can be true when a node contains a dynamic workflow which then produces child nodes."
2528
- "spec_node_id", ":ref:`ref_string`", "", "Node id of the node in the original workflow This maps to value of WorkflowTemplate.nodes[X].id"
2529
- "is_dynamic", ":ref:`ref_bool`", "", "Boolean flag indicating if the node has contains a dynamic workflow which then produces child nodes. This is to distinguish between subworkflows and dynamic workflows which can both have is_parent_node as true."
2530
-
2531
-
2532
-
2533
-
2534
-
2535
-
2536
-
2537
- .. _ref_flyteidl.admin.TaskNodeMetadata:
2538
-
2539
- TaskNodeMetadata
2540
- ------------------------------------------------------------------
2541
-
2542
- Metadata for the case in which the node is a TaskNode
2543
-
2544
-
2545
-
2546
- .. csv-table:: TaskNodeMetadata type fields
2547
- :header: "Field", "Type", "Label", "Description"
2548
- :widths: auto
2549
-
2550
- "cache_status", ":ref:`ref_flyteidl.core.CatalogCacheStatus`", "", "Captures the status of caching for this execution."
2551
- "catalog_key", ":ref:`ref_flyteidl.core.CatalogMetadata`", "", "This structure carries the catalog artifact information"
2552
- "checkpoint_uri", ":ref:`ref_string`", "", "The latest checkpoint location"
2553
-
2554
-
2555
-
2556
-
2557
-
2558
-
2559
-
2560
- .. _ref_flyteidl.admin.WorkflowNodeMetadata:
2561
-
2562
- WorkflowNodeMetadata
2563
- ------------------------------------------------------------------
2564
-
2565
- Metadata for a WorkflowNode
2566
-
2567
-
2568
-
2569
- .. csv-table:: WorkflowNodeMetadata type fields
2570
- :header: "Field", "Type", "Label", "Description"
2571
- :widths: auto
2572
-
2573
- "executionId", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "The identifier for a workflow execution launched by a node."
2574
-
2575
-
2576
-
2577
-
2578
-
2579
-
2580
- ..
2581
- end messages
2582
-
2583
-
2584
- ..
2585
- end enums
2586
-
2587
-
2588
- ..
2589
- end HasExtensions
2590
-
2591
-
2592
- ..
2593
- end services
2594
-
2595
-
2596
-
2597
-
2598
- .. _ref_flyteidl/admin/notification.proto:
2599
-
2600
- flyteidl/admin/notification.proto
2601
- ==================================================================
2602
-
2603
-
2604
-
2605
-
2606
-
2607
- .. _ref_flyteidl.admin.EmailMessage:
2608
-
2609
- EmailMessage
2610
- ------------------------------------------------------------------
2611
-
2612
- Represents the Email object that is sent to a publisher/subscriber
2613
- to forward the notification.
2614
- Note: This is internal to Admin and doesn't need to be exposed to other components.
2615
-
2616
-
2617
-
2618
- .. csv-table:: EmailMessage type fields
2619
- :header: "Field", "Type", "Label", "Description"
2620
- :widths: auto
2621
-
2622
- "recipients_email", ":ref:`ref_string`", "repeated", "The list of email addresses to receive an email with the content populated in the other fields. Currently, each email recipient will receive its own email. This populates the TO field."
2623
- "sender_email", ":ref:`ref_string`", "", "The email of the sender. This populates the FROM field."
2624
- "subject_line", ":ref:`ref_string`", "", "The content of the subject line. This populates the SUBJECT field."
2625
- "body", ":ref:`ref_string`", "", "The content of the email body. This populates the BODY field."
2626
-
2627
-
2628
-
2629
-
2630
-
2631
-
2632
- ..
2633
- end messages
2634
-
2635
-
2636
- ..
2637
- end enums
2638
-
2639
-
2640
- ..
2641
- end HasExtensions
2642
-
2643
-
2644
- ..
2645
- end services
2646
-
2647
-
2648
-
2649
-
2650
- .. _ref_flyteidl/admin/project.proto:
2651
-
2652
- flyteidl/admin/project.proto
2653
- ==================================================================
2654
-
2655
-
2656
-
2657
-
2658
-
2659
- .. _ref_flyteidl.admin.Domain:
2660
-
2661
- Domain
2662
- ------------------------------------------------------------------
2663
-
2664
- Namespace within a project commonly used to differentiate between different service instances.
2665
- e.g. "production", "development", etc.
2666
-
2667
-
2668
-
2669
- .. csv-table:: Domain type fields
2670
- :header: "Field", "Type", "Label", "Description"
2671
- :widths: auto
2672
-
2673
- "id", ":ref:`ref_string`", "", "Globally unique domain name."
2674
- "name", ":ref:`ref_string`", "", "Display name."
2675
-
2676
-
2677
-
2678
-
2679
-
2680
-
2681
-
2682
- .. _ref_flyteidl.admin.Project:
2683
-
2684
- Project
2685
- ------------------------------------------------------------------
2686
-
2687
- Top-level namespace used to classify different entities like workflows and executions.
2688
-
2689
-
2690
-
2691
- .. csv-table:: Project type fields
2692
- :header: "Field", "Type", "Label", "Description"
2693
- :widths: auto
2694
-
2695
- "id", ":ref:`ref_string`", "", "Globally unique project name."
2696
- "name", ":ref:`ref_string`", "", "Display name."
2697
- "domains", ":ref:`ref_flyteidl.admin.Domain`", "repeated", ""
2698
- "description", ":ref:`ref_string`", "", ""
2699
- "labels", ":ref:`ref_flyteidl.admin.Labels`", "", "Leverage Labels from flyteidl.admin.common.proto to tag projects with ownership information."
2700
- "state", ":ref:`ref_flyteidl.admin.Project.ProjectState`", "", ""
2701
-
2702
-
2703
-
2704
-
2705
-
2706
-
2707
-
2708
- .. _ref_flyteidl.admin.ProjectListRequest:
2709
-
2710
- ProjectListRequest
2711
- ------------------------------------------------------------------
2712
-
2713
- Request to retrieve a list of projects matching specified filters.
2714
- See :ref:`ref_flyteidl.admin.Project` for more details
2715
-
2716
-
2717
-
2718
- .. csv-table:: ProjectListRequest type fields
2719
- :header: "Field", "Type", "Label", "Description"
2720
- :widths: auto
2721
-
2722
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of projects to be returned. +required"
2723
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, this server-provided token can be used to fetch the next page in a query. +optional"
2724
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
2725
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
2726
-
2727
-
2728
-
2729
-
2730
-
2731
-
2732
-
2733
- .. _ref_flyteidl.admin.ProjectRegisterRequest:
2734
-
2735
- ProjectRegisterRequest
2736
- ------------------------------------------------------------------
2737
-
2738
- Adds a new user-project within the Flyte deployment.
2739
- See :ref:`ref_flyteidl.admin.Project` for more details
2740
-
2741
-
2742
-
2743
- .. csv-table:: ProjectRegisterRequest type fields
2744
- :header: "Field", "Type", "Label", "Description"
2745
- :widths: auto
2746
-
2747
- "project", ":ref:`ref_flyteidl.admin.Project`", "", "+required"
2748
-
2749
-
2750
-
2751
-
2752
-
2753
-
2754
-
2755
- .. _ref_flyteidl.admin.ProjectRegisterResponse:
2756
-
2757
- ProjectRegisterResponse
2758
- ------------------------------------------------------------------
2759
-
2760
- Purposefully empty, may be updated in the future.
2761
-
2762
-
2763
-
2764
-
2765
-
2766
-
2767
-
2768
-
2769
- .. _ref_flyteidl.admin.ProjectUpdateResponse:
2770
-
2771
- ProjectUpdateResponse
2772
- ------------------------------------------------------------------
2773
-
2774
- Purposefully empty, may be updated in the future.
2775
-
2776
-
2777
-
2778
-
2779
-
2780
-
2781
-
2782
-
2783
- .. _ref_flyteidl.admin.Projects:
2784
-
2785
- Projects
2786
- ------------------------------------------------------------------
2787
-
2788
- Represents a list of projects.
2789
- See :ref:`ref_flyteidl.admin.Project` for more details
2790
-
2791
-
2792
-
2793
- .. csv-table:: Projects type fields
2794
- :header: "Field", "Type", "Label", "Description"
2795
- :widths: auto
2796
-
2797
- "projects", ":ref:`ref_flyteidl.admin.Project`", "repeated", ""
2798
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
2799
-
2800
-
2801
-
2802
-
2803
-
2804
-
2805
- ..
2806
- end messages
2807
-
2808
-
2809
-
2810
- .. _ref_flyteidl.admin.Project.ProjectState:
2811
-
2812
- Project.ProjectState
2813
- ------------------------------------------------------------------
2814
-
2815
- The state of the project is used to control its visibility in the UI and validity.
2816
-
2817
- .. csv-table:: Enum Project.ProjectState values
2818
- :header: "Name", "Number", "Description"
2819
- :widths: auto
2820
-
2821
- "ACTIVE", "0", "By default, all projects are considered active."
2822
- "ARCHIVED", "1", "Archived projects are no longer visible in the UI and no longer valid."
2823
- "SYSTEM_GENERATED", "2", "System generated projects that aren't explicitly created or managed by a user."
2824
-
2825
-
2826
- ..
2827
- end enums
2828
-
2829
-
2830
- ..
2831
- end HasExtensions
2832
-
2833
-
2834
- ..
2835
- end services
2836
-
2837
-
2838
-
2839
-
2840
- .. _ref_flyteidl/admin/project_attributes.proto:
2841
-
2842
- flyteidl/admin/project_attributes.proto
2843
- ==================================================================
2844
-
2845
-
2846
-
2847
-
2848
-
2849
- .. _ref_flyteidl.admin.ProjectAttributes:
2850
-
2851
- ProjectAttributes
2852
- ------------------------------------------------------------------
2853
-
2854
- Defines a set of custom matching attributes at the project level.
2855
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
2856
-
2857
-
2858
-
2859
- .. csv-table:: ProjectAttributes type fields
2860
- :header: "Field", "Type", "Label", "Description"
2861
- :widths: auto
2862
-
2863
- "project", ":ref:`ref_string`", "", "Unique project id for which this set of attributes will be applied."
2864
- "matching_attributes", ":ref:`ref_flyteidl.admin.MatchingAttributes`", "", ""
2865
-
2866
-
2867
-
2868
-
2869
-
2870
-
2871
-
2872
- .. _ref_flyteidl.admin.ProjectAttributesDeleteRequest:
2873
-
2874
- ProjectAttributesDeleteRequest
2875
- ------------------------------------------------------------------
2876
-
2877
- Request to delete a set matchable project level attribute override.
2878
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
2879
-
2880
-
2881
-
2882
- .. csv-table:: ProjectAttributesDeleteRequest type fields
2883
- :header: "Field", "Type", "Label", "Description"
2884
- :widths: auto
2885
-
2886
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
2887
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to delete. +required"
2888
-
2889
-
2890
-
2891
-
2892
-
2893
-
2894
-
2895
- .. _ref_flyteidl.admin.ProjectAttributesDeleteResponse:
2896
-
2897
- ProjectAttributesDeleteResponse
2898
- ------------------------------------------------------------------
2899
-
2900
- Purposefully empty, may be populated in the future.
2901
-
2902
-
2903
-
2904
-
2905
-
2906
-
2907
-
2908
-
2909
- .. _ref_flyteidl.admin.ProjectAttributesGetRequest:
2910
-
2911
- ProjectAttributesGetRequest
2912
- ------------------------------------------------------------------
2913
-
2914
- Request to get an individual project level attribute override.
2915
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
2916
-
2917
-
2918
-
2919
- .. csv-table:: ProjectAttributesGetRequest type fields
2920
- :header: "Field", "Type", "Label", "Description"
2921
- :widths: auto
2922
-
2923
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
2924
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to return. +required"
2925
-
2926
-
2927
-
2928
-
2929
-
2930
-
2931
-
2932
- .. _ref_flyteidl.admin.ProjectAttributesGetResponse:
2933
-
2934
- ProjectAttributesGetResponse
2935
- ------------------------------------------------------------------
2936
-
2937
- Response to get an individual project level attribute override.
2938
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
2939
-
2940
-
2941
-
2942
- .. csv-table:: ProjectAttributesGetResponse type fields
2943
- :header: "Field", "Type", "Label", "Description"
2944
- :widths: auto
2945
-
2946
- "attributes", ":ref:`ref_flyteidl.admin.ProjectAttributes`", "", ""
2947
-
2948
-
2949
-
2950
-
2951
-
2952
-
2953
-
2954
- .. _ref_flyteidl.admin.ProjectAttributesUpdateRequest:
2955
-
2956
- ProjectAttributesUpdateRequest
2957
- ------------------------------------------------------------------
2958
-
2959
- Sets custom attributes for a project
2960
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
2961
-
2962
-
2963
-
2964
- .. csv-table:: ProjectAttributesUpdateRequest type fields
2965
- :header: "Field", "Type", "Label", "Description"
2966
- :widths: auto
2967
-
2968
- "attributes", ":ref:`ref_flyteidl.admin.ProjectAttributes`", "", "+required"
2969
-
2970
-
2971
-
2972
-
2973
-
2974
-
2975
-
2976
- .. _ref_flyteidl.admin.ProjectAttributesUpdateResponse:
2977
-
2978
- ProjectAttributesUpdateResponse
2979
- ------------------------------------------------------------------
2980
-
2981
- Purposefully empty, may be populated in the future.
2982
-
2983
-
2984
-
2985
-
2986
-
2987
-
2988
-
2989
- ..
2990
- end messages
2991
-
2992
-
2993
- ..
2994
- end enums
2995
-
2996
-
2997
- ..
2998
- end HasExtensions
2999
-
3000
-
3001
- ..
3002
- end services
3003
-
3004
-
3005
-
3006
-
3007
- .. _ref_flyteidl/admin/project_domain_attributes.proto:
3008
-
3009
- flyteidl/admin/project_domain_attributes.proto
3010
- ==================================================================
3011
-
3012
-
3013
-
3014
-
3015
-
3016
- .. _ref_flyteidl.admin.ProjectDomainAttributes:
3017
-
3018
- ProjectDomainAttributes
3019
- ------------------------------------------------------------------
3020
-
3021
- Defines a set of custom matching attributes which defines resource defaults for a project and domain.
3022
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
3023
-
3024
-
3025
-
3026
- .. csv-table:: ProjectDomainAttributes type fields
3027
- :header: "Field", "Type", "Label", "Description"
3028
- :widths: auto
3029
-
3030
- "project", ":ref:`ref_string`", "", "Unique project id for which this set of attributes will be applied."
3031
- "domain", ":ref:`ref_string`", "", "Unique domain id for which this set of attributes will be applied."
3032
- "matching_attributes", ":ref:`ref_flyteidl.admin.MatchingAttributes`", "", ""
3033
-
3034
-
3035
-
3036
-
3037
-
3038
-
3039
-
3040
- .. _ref_flyteidl.admin.ProjectDomainAttributesDeleteRequest:
3041
-
3042
- ProjectDomainAttributesDeleteRequest
3043
- ------------------------------------------------------------------
3044
-
3045
- Request to delete a set matchable project domain attribute override.
3046
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
3047
-
3048
-
3049
-
3050
- .. csv-table:: ProjectDomainAttributesDeleteRequest type fields
3051
- :header: "Field", "Type", "Label", "Description"
3052
- :widths: auto
3053
-
3054
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
3055
- "domain", ":ref:`ref_string`", "", "Unique domain id which this set of attributes references. +required"
3056
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to delete. +required"
3057
-
3058
-
3059
-
3060
-
3061
-
3062
-
3063
-
3064
- .. _ref_flyteidl.admin.ProjectDomainAttributesDeleteResponse:
3065
-
3066
- ProjectDomainAttributesDeleteResponse
3067
- ------------------------------------------------------------------
3068
-
3069
- Purposefully empty, may be populated in the future.
3070
-
3071
-
3072
-
3073
-
3074
-
3075
-
3076
-
3077
-
3078
- .. _ref_flyteidl.admin.ProjectDomainAttributesGetRequest:
3079
-
3080
- ProjectDomainAttributesGetRequest
3081
- ------------------------------------------------------------------
3082
-
3083
- Request to get an individual project domain attribute override.
3084
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
3085
-
3086
-
3087
-
3088
- .. csv-table:: ProjectDomainAttributesGetRequest type fields
3089
- :header: "Field", "Type", "Label", "Description"
3090
- :widths: auto
3091
-
3092
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
3093
- "domain", ":ref:`ref_string`", "", "Unique domain id which this set of attributes references. +required"
3094
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to return. +required"
3095
-
3096
-
3097
-
3098
-
3099
-
3100
-
3101
-
3102
- .. _ref_flyteidl.admin.ProjectDomainAttributesGetResponse:
3103
-
3104
- ProjectDomainAttributesGetResponse
3105
- ------------------------------------------------------------------
3106
-
3107
- Response to get an individual project domain attribute override.
3108
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
3109
-
3110
-
3111
-
3112
- .. csv-table:: ProjectDomainAttributesGetResponse type fields
3113
- :header: "Field", "Type", "Label", "Description"
3114
- :widths: auto
3115
-
3116
- "attributes", ":ref:`ref_flyteidl.admin.ProjectDomainAttributes`", "", ""
3117
-
3118
-
3119
-
3120
-
3121
-
3122
-
3123
-
3124
- .. _ref_flyteidl.admin.ProjectDomainAttributesUpdateRequest:
3125
-
3126
- ProjectDomainAttributesUpdateRequest
3127
- ------------------------------------------------------------------
3128
-
3129
- Sets custom attributes for a project-domain combination.
3130
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
3131
-
3132
-
3133
-
3134
- .. csv-table:: ProjectDomainAttributesUpdateRequest type fields
3135
- :header: "Field", "Type", "Label", "Description"
3136
- :widths: auto
3137
-
3138
- "attributes", ":ref:`ref_flyteidl.admin.ProjectDomainAttributes`", "", "+required"
3139
-
3140
-
3141
-
3142
-
3143
-
3144
-
3145
-
3146
- .. _ref_flyteidl.admin.ProjectDomainAttributesUpdateResponse:
3147
-
3148
- ProjectDomainAttributesUpdateResponse
3149
- ------------------------------------------------------------------
3150
-
3151
- Purposefully empty, may be populated in the future.
3152
-
3153
-
3154
-
3155
-
3156
-
3157
-
3158
-
3159
- ..
3160
- end messages
3161
-
3162
-
3163
- ..
3164
- end enums
3165
-
3166
-
3167
- ..
3168
- end HasExtensions
3169
-
3170
-
3171
- ..
3172
- end services
3173
-
3174
-
3175
-
3176
-
3177
- .. _ref_flyteidl/admin/schedule.proto:
3178
-
3179
- flyteidl/admin/schedule.proto
3180
- ==================================================================
3181
-
3182
-
3183
-
3184
-
3185
-
3186
- .. _ref_flyteidl.admin.CronSchedule:
3187
-
3188
- CronSchedule
3189
- ------------------------------------------------------------------
3190
-
3191
- Options for schedules to run according to a cron expression.
3192
-
3193
-
3194
-
3195
- .. csv-table:: CronSchedule type fields
3196
- :header: "Field", "Type", "Label", "Description"
3197
- :widths: auto
3198
-
3199
- "schedule", ":ref:`ref_string`", "", "Standard/default cron implementation as described by https://en.wikipedia.org/wiki/Cron#CRON_expression; Also supports nonstandard predefined scheduling definitions as described by https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions except @reboot"
3200
- "offset", ":ref:`ref_string`", "", "ISO 8601 duration as described by https://en.wikipedia.org/wiki/ISO_8601#Durations"
3201
-
3202
-
3203
-
3204
-
3205
-
3206
-
3207
-
3208
- .. _ref_flyteidl.admin.FixedRate:
3209
-
3210
- FixedRate
3211
- ------------------------------------------------------------------
3212
-
3213
- Option for schedules run at a certain frequency e.g. every 2 minutes.
3214
-
3215
-
3216
-
3217
- .. csv-table:: FixedRate type fields
3218
- :header: "Field", "Type", "Label", "Description"
3219
- :widths: auto
3220
-
3221
- "value", ":ref:`ref_uint32`", "", ""
3222
- "unit", ":ref:`ref_flyteidl.admin.FixedRateUnit`", "", ""
3223
-
3224
-
3225
-
3226
-
3227
-
3228
-
3229
-
3230
- .. _ref_flyteidl.admin.Schedule:
3231
-
3232
- Schedule
3233
- ------------------------------------------------------------------
3234
-
3235
- Defines complete set of information required to trigger an execution on a schedule.
3236
-
3237
-
3238
-
3239
- .. csv-table:: Schedule type fields
3240
- :header: "Field", "Type", "Label", "Description"
3241
- :widths: auto
3242
-
3243
- "cron_expression", ":ref:`ref_string`", "", "**Deprecated.** Uses AWS syntax: Minutes Hours Day-of-month Month Day-of-week Year e.g. for a schedule that runs every 15 minutes: 0/15 * * * ? *"
3244
- "rate", ":ref:`ref_flyteidl.admin.FixedRate`", "", ""
3245
- "cron_schedule", ":ref:`ref_flyteidl.admin.CronSchedule`", "", ""
3246
- "kickoff_time_input_arg", ":ref:`ref_string`", "", "Name of the input variable that the kickoff time will be supplied to when the workflow is kicked off."
3247
-
3248
-
3249
-
3250
-
3251
-
3252
-
3253
- ..
3254
- end messages
3255
-
3256
-
3257
-
3258
- .. _ref_flyteidl.admin.FixedRateUnit:
3259
-
3260
- FixedRateUnit
3261
- ------------------------------------------------------------------
3262
-
3263
- Represents a frequency at which to run a schedule.
3264
-
3265
- .. csv-table:: Enum FixedRateUnit values
3266
- :header: "Name", "Number", "Description"
3267
- :widths: auto
3268
-
3269
- "MINUTE", "0", ""
3270
- "HOUR", "1", ""
3271
- "DAY", "2", ""
3272
-
3273
-
3274
- ..
3275
- end enums
3276
-
3277
-
3278
- ..
3279
- end HasExtensions
3280
-
3281
-
3282
- ..
3283
- end services
3284
-
3285
-
3286
-
3287
-
3288
- .. _ref_flyteidl/admin/signal.proto:
3289
-
3290
- flyteidl/admin/signal.proto
3291
- ==================================================================
3292
-
3293
-
3294
-
3295
-
3296
-
3297
- .. _ref_flyteidl.admin.Signal:
3298
-
3299
- Signal
3300
- ------------------------------------------------------------------
3301
-
3302
- Signal encapsulates a unique identifier, associated metadata, and a value for a single Flyte
3303
- signal. Signals may exist either without a set value (representing a signal request) or with a
3304
- populated value (indicating the signal has been given).
3305
-
3306
-
3307
-
3308
- .. csv-table:: Signal type fields
3309
- :header: "Field", "Type", "Label", "Description"
3310
- :widths: auto
3311
-
3312
- "id", ":ref:`ref_flyteidl.core.SignalIdentifier`", "", "A unique identifier for the requested signal."
3313
- "type", ":ref:`ref_flyteidl.core.LiteralType`", "", "A type denoting the required value type for this signal."
3314
- "value", ":ref:`ref_flyteidl.core.Literal`", "", "The value of the signal. This is only available if the signal has been "set" and must match the defined the type."
3315
-
3316
-
3317
-
3318
-
3319
-
3320
-
3321
-
3322
- .. _ref_flyteidl.admin.SignalGetOrCreateRequest:
3323
-
3324
- SignalGetOrCreateRequest
3325
- ------------------------------------------------------------------
3326
-
3327
- SignalGetOrCreateRequest represents a request structure to retrieve or create a signal.
3328
- See :ref:`ref_flyteidl.admin.Signal` for more details
3329
-
3330
-
3331
-
3332
- .. csv-table:: SignalGetOrCreateRequest type fields
3333
- :header: "Field", "Type", "Label", "Description"
3334
- :widths: auto
3335
-
3336
- "id", ":ref:`ref_flyteidl.core.SignalIdentifier`", "", "A unique identifier for the requested signal."
3337
- "type", ":ref:`ref_flyteidl.core.LiteralType`", "", "A type denoting the required value type for this signal."
3338
-
3339
-
3340
-
3341
-
3342
-
3343
-
3344
-
3345
- .. _ref_flyteidl.admin.SignalList:
3346
-
3347
- SignalList
3348
- ------------------------------------------------------------------
3349
-
3350
- SignalList represents collection of signals along with the token of the last result.
3351
- See :ref:`ref_flyteidl.admin.Signal` for more details
3352
-
3353
-
3354
-
3355
- .. csv-table:: SignalList type fields
3356
- :header: "Field", "Type", "Label", "Description"
3357
- :widths: auto
3358
-
3359
- "signals", ":ref:`ref_flyteidl.admin.Signal`", "repeated", "A list of signals matching the input filters."
3360
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
3361
-
3362
-
3363
-
3364
-
3365
-
3366
-
3367
-
3368
- .. _ref_flyteidl.admin.SignalListRequest:
3369
-
3370
- SignalListRequest
3371
- ------------------------------------------------------------------
3372
-
3373
- SignalListRequest represents a request structure to retrieve a collection of signals.
3374
- See :ref:`ref_flyteidl.admin.Signal` for more details
3375
-
3376
-
3377
-
3378
- .. csv-table:: SignalListRequest type fields
3379
- :header: "Field", "Type", "Label", "Description"
3380
- :widths: auto
3381
-
3382
- "workflow_execution_id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Indicates the workflow execution to filter by. +required"
3383
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
3384
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the, server-provided token can be used to fetch the next page in a query. +optional"
3385
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. +optional"
3386
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering. +optional"
3387
-
3388
-
3389
-
3390
-
3391
-
3392
-
3393
-
3394
- .. _ref_flyteidl.admin.SignalSetRequest:
3395
-
3396
- SignalSetRequest
3397
- ------------------------------------------------------------------
3398
-
3399
- SignalSetRequest represents a request structure to set the value on a signal. Setting a signal
3400
- effetively satisfies the signal condition within a Flyte workflow.
3401
- See :ref:`ref_flyteidl.admin.Signal` for more details
3402
-
3403
-
3404
-
3405
- .. csv-table:: SignalSetRequest type fields
3406
- :header: "Field", "Type", "Label", "Description"
3407
- :widths: auto
3408
-
3409
- "id", ":ref:`ref_flyteidl.core.SignalIdentifier`", "", "A unique identifier for the requested signal."
3410
- "value", ":ref:`ref_flyteidl.core.Literal`", "", "The value of this signal, must match the defining signal type."
3411
-
3412
-
3413
-
3414
-
3415
-
3416
-
3417
-
3418
- .. _ref_flyteidl.admin.SignalSetResponse:
3419
-
3420
- SignalSetResponse
3421
- ------------------------------------------------------------------
3422
-
3423
- SignalSetResponse represents a response structure if signal setting succeeds.
3424
-
3425
- Purposefully empty, may be populated in the future.
3426
-
3427
-
3428
-
3429
-
3430
-
3431
-
3432
-
3433
- ..
3434
- end messages
3435
-
3436
-
3437
- ..
3438
- end enums
3439
-
3440
-
3441
- ..
3442
- end HasExtensions
3443
-
3444
-
3445
- ..
3446
- end services
3447
-
3448
-
3449
-
3450
-
3451
- .. _ref_flyteidl/admin/task.proto:
3452
-
3453
- flyteidl/admin/task.proto
3454
- ==================================================================
3455
-
3456
-
3457
-
3458
-
3459
-
3460
- .. _ref_flyteidl.admin.Task:
3461
-
3462
- Task
3463
- ------------------------------------------------------------------
3464
-
3465
- Flyte workflows are composed of many ordered tasks. That is small, reusable, self-contained logical blocks
3466
- arranged to process workflow inputs and produce a deterministic set of outputs.
3467
- Tasks can come in many varieties tuned for specialized behavior.
3468
-
3469
-
3470
-
3471
- .. csv-table:: Task type fields
3472
- :header: "Field", "Type", "Label", "Description"
3473
- :widths: auto
3474
-
3475
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the task."
3476
- "closure", ":ref:`ref_flyteidl.admin.TaskClosure`", "", "closure encapsulates all the fields that maps to a compiled version of the task."
3477
- "short_description", ":ref:`ref_string`", "", "One-liner overview of the entity."
3478
-
3479
-
3480
-
3481
-
3482
-
3483
-
3484
-
3485
- .. _ref_flyteidl.admin.TaskClosure:
3486
-
3487
- TaskClosure
3488
- ------------------------------------------------------------------
3489
-
3490
- Compute task attributes which include values derived from the TaskSpec, as well as plugin-specific data
3491
- and task metadata.
3492
-
3493
-
3494
-
3495
- .. csv-table:: TaskClosure type fields
3496
- :header: "Field", "Type", "Label", "Description"
3497
- :widths: auto
3498
-
3499
- "compiled_task", ":ref:`ref_flyteidl.core.CompiledTask`", "", "Represents the compiled representation of the task from the specification provided."
3500
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the task was created."
3501
-
3502
-
3503
-
3504
-
3505
-
3506
-
3507
-
3508
- .. _ref_flyteidl.admin.TaskCreateRequest:
3509
-
3510
- TaskCreateRequest
3511
- ------------------------------------------------------------------
3512
-
3513
- Represents a request structure to create a revision of a task.
3514
- See :ref:`ref_flyteidl.admin.Task` for more details
3515
-
3516
-
3517
-
3518
- .. csv-table:: TaskCreateRequest type fields
3519
- :header: "Field", "Type", "Label", "Description"
3520
- :widths: auto
3521
-
3522
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the task. +required"
3523
- "spec", ":ref:`ref_flyteidl.admin.TaskSpec`", "", "Represents the specification for task. +required"
3524
-
3525
-
3526
-
3527
-
3528
-
3529
-
3530
-
3531
- .. _ref_flyteidl.admin.TaskCreateResponse:
3532
-
3533
- TaskCreateResponse
3534
- ------------------------------------------------------------------
3535
-
3536
- Represents a response structure if task creation succeeds.
3537
-
3538
- Purposefully empty, may be populated in the future.
3539
-
3540
-
3541
-
3542
-
3543
-
3544
-
3545
-
3546
-
3547
- .. _ref_flyteidl.admin.TaskList:
3548
-
3549
- TaskList
3550
- ------------------------------------------------------------------
3551
-
3552
- Represents a list of tasks returned from the admin.
3553
- See :ref:`ref_flyteidl.admin.Task` for more details
3554
-
3555
-
3556
-
3557
- .. csv-table:: TaskList type fields
3558
- :header: "Field", "Type", "Label", "Description"
3559
- :widths: auto
3560
-
3561
- "tasks", ":ref:`ref_flyteidl.admin.Task`", "repeated", "A list of tasks returned based on the request."
3562
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
3563
-
3564
-
3565
-
3566
-
3567
-
3568
-
3569
-
3570
- .. _ref_flyteidl.admin.TaskSpec:
3571
-
3572
- TaskSpec
3573
- ------------------------------------------------------------------
3574
-
3575
- Represents a structure that encapsulates the user-configured specification of the task.
3576
-
3577
-
3578
-
3579
- .. csv-table:: TaskSpec type fields
3580
- :header: "Field", "Type", "Label", "Description"
3581
- :widths: auto
3582
-
3583
- "template", ":ref:`ref_flyteidl.core.TaskTemplate`", "", "Template of the task that encapsulates all the metadata of the task."
3584
- "description", ":ref:`ref_flyteidl.admin.DescriptionEntity`", "", "Represents the specification for description entity."
3585
-
3586
-
3587
-
3588
-
3589
-
3590
-
3591
- ..
3592
- end messages
3593
-
3594
-
3595
- ..
3596
- end enums
3597
-
3598
-
3599
- ..
3600
- end HasExtensions
3601
-
3602
-
3603
- ..
3604
- end services
3605
-
3606
-
3607
-
3608
-
3609
- .. _ref_flyteidl/admin/task_execution.proto:
3610
-
3611
- flyteidl/admin/task_execution.proto
3612
- ==================================================================
3613
-
3614
-
3615
-
3616
-
3617
-
3618
- .. _ref_flyteidl.admin.TaskExecution:
3619
-
3620
- TaskExecution
3621
- ------------------------------------------------------------------
3622
-
3623
- Encapsulates all details for a single task execution entity.
3624
- A task execution represents an instantiated task, including all inputs and additional
3625
- metadata as well as computed results included state, outputs, and duration-based attributes.
3626
-
3627
-
3628
-
3629
- .. csv-table:: TaskExecution type fields
3630
- :header: "Field", "Type", "Label", "Description"
3631
- :widths: auto
3632
-
3633
- "id", ":ref:`ref_flyteidl.core.TaskExecutionIdentifier`", "", "Unique identifier for the task execution."
3634
- "input_uri", ":ref:`ref_string`", "", "Path to remote data store where input blob is stored."
3635
- "closure", ":ref:`ref_flyteidl.admin.TaskExecutionClosure`", "", "Task execution details and results."
3636
- "is_parent", ":ref:`ref_bool`", "", "Whether this task spawned nodes."
3637
-
3638
-
3639
-
3640
-
3641
-
3642
-
3643
-
3644
- .. _ref_flyteidl.admin.TaskExecutionClosure:
3645
-
3646
- TaskExecutionClosure
3647
- ------------------------------------------------------------------
3648
-
3649
- Container for task execution details and results.
3650
-
3651
-
3652
-
3653
- .. csv-table:: TaskExecutionClosure type fields
3654
- :header: "Field", "Type", "Label", "Description"
3655
- :widths: auto
3656
-
3657
- "output_uri", ":ref:`ref_string`", "", "**Deprecated.** Path to remote data store where output blob is stored if the execution succeeded (and produced outputs). DEPRECATED. Use GetTaskExecutionData to fetch output data instead."
3658
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information for the task execution. Populated if the execution failed."
3659
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "**Deprecated.** Raw output data produced by this task execution. DEPRECATED. Use GetTaskExecutionData to fetch output data instead."
3660
- "phase", ":ref:`ref_flyteidl.core.TaskExecution.Phase`", "", "The last recorded phase for this task execution."
3661
- "logs", ":ref:`ref_flyteidl.core.TaskLog`", "repeated", "Detailed log information output by the task execution."
3662
- "started_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the task execution began running."
3663
- "duration", ":ref:`ref_google.protobuf.Duration`", "", "The amount of time the task execution spent running."
3664
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the task execution was created."
3665
- "updated_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the task execution was last updated."
3666
- "custom_info", ":ref:`ref_google.protobuf.Struct`", "", "Custom data specific to the task plugin."
3667
- "reason", ":ref:`ref_string`", "", "If there is an explanation for the most recent phase transition, the reason will capture it."
3668
- "task_type", ":ref:`ref_string`", "", "A predefined yet extensible Task type identifier."
3669
- "metadata", ":ref:`ref_flyteidl.event.TaskExecutionMetadata`", "", "Metadata around how a task was executed."
3670
- "event_version", ":ref:`ref_int32`", "", "The event version is used to indicate versioned changes in how data is maintained using this proto message. For example, event_verison > 0 means that maps tasks logs use the TaskExecutionMetadata ExternalResourceInfo fields for each subtask rather than the TaskLog in this message."
3671
-
3672
-
3673
-
3674
-
3675
-
3676
-
3677
-
3678
- .. _ref_flyteidl.admin.TaskExecutionGetDataRequest:
3679
-
3680
- TaskExecutionGetDataRequest
3681
- ------------------------------------------------------------------
3682
-
3683
- Request structure to fetch inputs and output for a task execution.
3684
- By default this data is not returned inline in :ref:`ref_flyteidl.admin.TaskExecutionGetRequest`
3685
-
3686
-
3687
-
3688
- .. csv-table:: TaskExecutionGetDataRequest type fields
3689
- :header: "Field", "Type", "Label", "Description"
3690
- :widths: auto
3691
-
3692
- "id", ":ref:`ref_flyteidl.core.TaskExecutionIdentifier`", "", "The identifier of the task execution for which to fetch inputs and outputs. +required"
3693
-
3694
-
3695
-
3696
-
3697
-
3698
-
3699
-
3700
- .. _ref_flyteidl.admin.TaskExecutionGetDataResponse:
3701
-
3702
- TaskExecutionGetDataResponse
3703
- ------------------------------------------------------------------
3704
-
3705
- Response structure for TaskExecutionGetDataRequest which contains inputs and outputs for a task execution.
3706
-
3707
-
3708
-
3709
- .. csv-table:: TaskExecutionGetDataResponse type fields
3710
- :header: "Field", "Type", "Label", "Description"
3711
- :widths: auto
3712
-
3713
- "inputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of task execution inputs. Deprecated: Please use full_inputs instead."
3714
- "outputs", ":ref:`ref_flyteidl.admin.UrlBlob`", "", "**Deprecated.** Signed url to fetch a core.LiteralMap of task execution outputs. Deprecated: Please use full_outputs instead."
3715
- "full_inputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_inputs will only be populated if they are under a configured size threshold."
3716
- "full_outputs", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Full_outputs will only be populated if they are under a configured size threshold."
3717
-
3718
-
3719
-
3720
-
3721
-
3722
-
3723
-
3724
- .. _ref_flyteidl.admin.TaskExecutionGetRequest:
3725
-
3726
- TaskExecutionGetRequest
3727
- ------------------------------------------------------------------
3728
-
3729
- A message used to fetch a single task execution entity.
3730
- See :ref:`ref_flyteidl.admin.TaskExecution` for more details
3731
-
3732
-
3733
-
3734
- .. csv-table:: TaskExecutionGetRequest type fields
3735
- :header: "Field", "Type", "Label", "Description"
3736
- :widths: auto
3737
-
3738
- "id", ":ref:`ref_flyteidl.core.TaskExecutionIdentifier`", "", "Unique identifier for the task execution. +required"
3739
-
3740
-
3741
-
3742
-
3743
-
3744
-
3745
-
3746
- .. _ref_flyteidl.admin.TaskExecutionList:
3747
-
3748
- TaskExecutionList
3749
- ------------------------------------------------------------------
3750
-
3751
- Response structure for a query to list of task execution entities.
3752
- See :ref:`ref_flyteidl.admin.TaskExecution` for more details
3753
-
3754
-
3755
-
3756
- .. csv-table:: TaskExecutionList type fields
3757
- :header: "Field", "Type", "Label", "Description"
3758
- :widths: auto
3759
-
3760
- "task_executions", ":ref:`ref_flyteidl.admin.TaskExecution`", "repeated", ""
3761
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
3762
-
3763
-
3764
-
3765
-
3766
-
3767
-
3768
-
3769
- .. _ref_flyteidl.admin.TaskExecutionListRequest:
3770
-
3771
- TaskExecutionListRequest
3772
- ------------------------------------------------------------------
3773
-
3774
- Represents a request structure to retrieve a list of task execution entities yielded by a specific node execution.
3775
- See :ref:`ref_flyteidl.admin.TaskExecution` for more details
3776
-
3777
-
3778
-
3779
- .. csv-table:: TaskExecutionListRequest type fields
3780
- :header: "Field", "Type", "Label", "Description"
3781
- :widths: auto
3782
-
3783
- "node_execution_id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "Indicates the node execution to filter by. +required"
3784
- "limit", ":ref:`ref_uint32`", "", "Indicates the number of resources to be returned. +required"
3785
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. +optional"
3786
- "filters", ":ref:`ref_string`", "", "Indicates a list of filters passed as string. More info on constructing filters : <Link> +optional"
3787
- "sort_by", ":ref:`ref_flyteidl.admin.Sort`", "", "Sort ordering for returned list. +optional"
3788
-
3789
-
3790
-
3791
-
3792
-
3793
-
3794
- ..
3795
- end messages
3796
-
3797
-
3798
- ..
3799
- end enums
3800
-
3801
-
3802
- ..
3803
- end HasExtensions
3804
-
3805
-
3806
- ..
3807
- end services
3808
-
3809
-
3810
-
3811
-
3812
- .. _ref_flyteidl/admin/version.proto:
3813
-
3814
- flyteidl/admin/version.proto
3815
- ==================================================================
3816
-
3817
-
3818
-
3819
-
3820
-
3821
- .. _ref_flyteidl.admin.GetVersionRequest:
3822
-
3823
- GetVersionRequest
3824
- ------------------------------------------------------------------
3825
-
3826
- Empty request for GetVersion
3827
-
3828
-
3829
-
3830
-
3831
-
3832
-
3833
-
3834
-
3835
- .. _ref_flyteidl.admin.GetVersionResponse:
3836
-
3837
- GetVersionResponse
3838
- ------------------------------------------------------------------
3839
-
3840
- Response for the GetVersion API
3841
-
3842
-
3843
-
3844
- .. csv-table:: GetVersionResponse type fields
3845
- :header: "Field", "Type", "Label", "Description"
3846
- :widths: auto
3847
-
3848
- "control_plane_version", ":ref:`ref_flyteidl.admin.Version`", "", "The control plane version information. FlyteAdmin and related components form the control plane of Flyte"
3849
-
3850
-
3851
-
3852
-
3853
-
3854
-
3855
-
3856
- .. _ref_flyteidl.admin.Version:
3857
-
3858
- Version
3859
- ------------------------------------------------------------------
3860
-
3861
- Provides Version information for a component
3862
-
3863
-
3864
-
3865
- .. csv-table:: Version type fields
3866
- :header: "Field", "Type", "Label", "Description"
3867
- :widths: auto
3868
-
3869
- "Build", ":ref:`ref_string`", "", "Specifies the GIT sha of the build"
3870
- "Version", ":ref:`ref_string`", "", "Version for the build, should follow a semver"
3871
- "BuildTime", ":ref:`ref_string`", "", "Build timestamp"
3872
-
3873
-
3874
-
3875
-
3876
-
3877
-
3878
- ..
3879
- end messages
3880
-
3881
-
3882
- ..
3883
- end enums
3884
-
3885
-
3886
- ..
3887
- end HasExtensions
3888
-
3889
-
3890
- ..
3891
- end services
3892
-
3893
-
3894
-
3895
-
3896
- .. _ref_flyteidl/admin/workflow.proto:
3897
-
3898
- flyteidl/admin/workflow.proto
3899
- ==================================================================
3900
-
3901
-
3902
-
3903
-
3904
-
3905
- .. _ref_flyteidl.admin.CreateWorkflowFailureReason:
3906
-
3907
- CreateWorkflowFailureReason
3908
- ------------------------------------------------------------------
3909
-
3910
- When a CreateWorkflowRequest fails due to matching id
3911
-
3912
-
3913
-
3914
- .. csv-table:: CreateWorkflowFailureReason type fields
3915
- :header: "Field", "Type", "Label", "Description"
3916
- :widths: auto
3917
-
3918
- "exists_different_structure", ":ref:`ref_flyteidl.admin.WorkflowErrorExistsDifferentStructure`", "", ""
3919
- "exists_identical_structure", ":ref:`ref_flyteidl.admin.WorkflowErrorExistsIdenticalStructure`", "", ""
3920
-
3921
-
3922
-
3923
-
3924
-
3925
-
3926
-
3927
- .. _ref_flyteidl.admin.Workflow:
3928
-
3929
- Workflow
3930
- ------------------------------------------------------------------
3931
-
3932
- Represents the workflow structure stored in the Admin
3933
- A workflow is created by ordering tasks and associating outputs to inputs
3934
- in order to produce a directed-acyclic execution graph.
3935
-
3936
-
3937
-
3938
- .. csv-table:: Workflow type fields
3939
- :header: "Field", "Type", "Label", "Description"
3940
- :widths: auto
3941
-
3942
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the workflow."
3943
- "closure", ":ref:`ref_flyteidl.admin.WorkflowClosure`", "", "closure encapsulates all the fields that maps to a compiled version of the workflow."
3944
- "short_description", ":ref:`ref_string`", "", "One-liner overview of the entity."
3945
-
3946
-
3947
-
3948
-
3949
-
3950
-
3951
-
3952
- .. _ref_flyteidl.admin.WorkflowClosure:
3953
-
3954
- WorkflowClosure
3955
- ------------------------------------------------------------------
3956
-
3957
- A container holding the compiled workflow produced from the WorkflowSpec and additional metadata.
3958
-
3959
-
3960
-
3961
- .. csv-table:: WorkflowClosure type fields
3962
- :header: "Field", "Type", "Label", "Description"
3963
- :widths: auto
3964
-
3965
- "compiled_workflow", ":ref:`ref_flyteidl.core.CompiledWorkflowClosure`", "", "Represents the compiled representation of the workflow from the specification provided."
3966
- "created_at", ":ref:`ref_google.protobuf.Timestamp`", "", "Time at which the workflow was created."
3967
-
3968
-
3969
-
3970
-
3971
-
3972
-
3973
-
3974
- .. _ref_flyteidl.admin.WorkflowCreateRequest:
3975
-
3976
- WorkflowCreateRequest
3977
- ------------------------------------------------------------------
3978
-
3979
- Represents a request structure to create a revision of a workflow.
3980
- See :ref:`ref_flyteidl.admin.Workflow` for more details
3981
-
3982
-
3983
-
3984
- .. csv-table:: WorkflowCreateRequest type fields
3985
- :header: "Field", "Type", "Label", "Description"
3986
- :widths: auto
3987
-
3988
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the workflow. +required"
3989
- "spec", ":ref:`ref_flyteidl.admin.WorkflowSpec`", "", "Represents the specification for workflow. +required"
3990
-
3991
-
3992
-
3993
-
3994
-
3995
-
3996
-
3997
- .. _ref_flyteidl.admin.WorkflowCreateResponse:
3998
-
3999
- WorkflowCreateResponse
4000
- ------------------------------------------------------------------
4001
-
4002
- Purposefully empty, may be populated in the future.
4003
-
4004
-
4005
-
4006
-
4007
-
4008
-
4009
-
4010
-
4011
- .. _ref_flyteidl.admin.WorkflowErrorExistsDifferentStructure:
4012
-
4013
- WorkflowErrorExistsDifferentStructure
4014
- ------------------------------------------------------------------
4015
-
4016
- The workflow id is already used and the structure is different
4017
-
4018
-
4019
-
4020
- .. csv-table:: WorkflowErrorExistsDifferentStructure type fields
4021
- :header: "Field", "Type", "Label", "Description"
4022
- :widths: auto
4023
-
4024
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", ""
4025
-
4026
-
4027
-
4028
-
4029
-
4030
-
4031
-
4032
- .. _ref_flyteidl.admin.WorkflowErrorExistsIdenticalStructure:
4033
-
4034
- WorkflowErrorExistsIdenticalStructure
4035
- ------------------------------------------------------------------
4036
-
4037
- The workflow id is already used with an identical sctructure
4038
-
4039
-
4040
-
4041
- .. csv-table:: WorkflowErrorExistsIdenticalStructure type fields
4042
- :header: "Field", "Type", "Label", "Description"
4043
- :widths: auto
4044
-
4045
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", ""
4046
-
4047
-
4048
-
4049
-
4050
-
4051
-
4052
-
4053
- .. _ref_flyteidl.admin.WorkflowList:
4054
-
4055
- WorkflowList
4056
- ------------------------------------------------------------------
4057
-
4058
- Represents a list of workflows returned from the admin.
4059
- See :ref:`ref_flyteidl.admin.Workflow` for more details
4060
-
4061
-
4062
-
4063
- .. csv-table:: WorkflowList type fields
4064
- :header: "Field", "Type", "Label", "Description"
4065
- :widths: auto
4066
-
4067
- "workflows", ":ref:`ref_flyteidl.admin.Workflow`", "repeated", "A list of workflows returned based on the request."
4068
- "token", ":ref:`ref_string`", "", "In the case of multiple pages of results, the server-provided token can be used to fetch the next page in a query. If there are no more results, this value will be empty."
4069
-
4070
-
4071
-
4072
-
4073
-
4074
-
4075
-
4076
- .. _ref_flyteidl.admin.WorkflowSpec:
4077
-
4078
- WorkflowSpec
4079
- ------------------------------------------------------------------
4080
-
4081
- Represents a structure that encapsulates the specification of the workflow.
4082
-
4083
-
4084
-
4085
- .. csv-table:: WorkflowSpec type fields
4086
- :header: "Field", "Type", "Label", "Description"
4087
- :widths: auto
4088
-
4089
- "template", ":ref:`ref_flyteidl.core.WorkflowTemplate`", "", "Template of the task that encapsulates all the metadata of the workflow."
4090
- "sub_workflows", ":ref:`ref_flyteidl.core.WorkflowTemplate`", "repeated", "Workflows that are embedded into other workflows need to be passed alongside the parent workflow to the propeller compiler (since the compiler doesn't have any knowledge of other workflows - ie, it doesn't reach out to Admin to see other registered workflows). In fact, subworkflows do not even need to be registered."
4091
- "description", ":ref:`ref_flyteidl.admin.DescriptionEntity`", "", "Represents the specification for description entity."
4092
-
4093
-
4094
-
4095
-
4096
-
4097
-
4098
- ..
4099
- end messages
4100
-
4101
-
4102
- ..
4103
- end enums
4104
-
4105
-
4106
- ..
4107
- end HasExtensions
4108
-
4109
-
4110
- ..
4111
- end services
4112
-
4113
-
4114
-
4115
-
4116
- .. _ref_flyteidl/admin/workflow_attributes.proto:
4117
-
4118
- flyteidl/admin/workflow_attributes.proto
4119
- ==================================================================
4120
-
4121
-
4122
-
4123
-
4124
-
4125
- .. _ref_flyteidl.admin.WorkflowAttributes:
4126
-
4127
- WorkflowAttributes
4128
- ------------------------------------------------------------------
4129
-
4130
- Defines a set of custom matching attributes which defines resource defaults for a project, domain and workflow.
4131
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
4132
-
4133
-
4134
-
4135
- .. csv-table:: WorkflowAttributes type fields
4136
- :header: "Field", "Type", "Label", "Description"
4137
- :widths: auto
4138
-
4139
- "project", ":ref:`ref_string`", "", "Unique project id for which this set of attributes will be applied."
4140
- "domain", ":ref:`ref_string`", "", "Unique domain id for which this set of attributes will be applied."
4141
- "workflow", ":ref:`ref_string`", "", "Workflow name for which this set of attributes will be applied."
4142
- "matching_attributes", ":ref:`ref_flyteidl.admin.MatchingAttributes`", "", ""
4143
-
4144
-
4145
-
4146
-
4147
-
4148
-
4149
-
4150
- .. _ref_flyteidl.admin.WorkflowAttributesDeleteRequest:
4151
-
4152
- WorkflowAttributesDeleteRequest
4153
- ------------------------------------------------------------------
4154
-
4155
- Request to delete a set matchable workflow attribute override.
4156
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
4157
-
4158
-
4159
-
4160
- .. csv-table:: WorkflowAttributesDeleteRequest type fields
4161
- :header: "Field", "Type", "Label", "Description"
4162
- :widths: auto
4163
-
4164
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
4165
- "domain", ":ref:`ref_string`", "", "Unique domain id which this set of attributes references. +required"
4166
- "workflow", ":ref:`ref_string`", "", "Workflow name which this set of attributes references. +required"
4167
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to delete. +required"
4168
-
4169
-
4170
-
4171
-
4172
-
4173
-
4174
-
4175
- .. _ref_flyteidl.admin.WorkflowAttributesDeleteResponse:
4176
-
4177
- WorkflowAttributesDeleteResponse
4178
- ------------------------------------------------------------------
4179
-
4180
- Purposefully empty, may be populated in the future.
4181
-
4182
-
4183
-
4184
-
4185
-
4186
-
4187
-
4188
-
4189
- .. _ref_flyteidl.admin.WorkflowAttributesGetRequest:
4190
-
4191
- WorkflowAttributesGetRequest
4192
- ------------------------------------------------------------------
4193
-
4194
- Request to get an individual workflow attribute override.
4195
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
4196
-
4197
-
4198
-
4199
- .. csv-table:: WorkflowAttributesGetRequest type fields
4200
- :header: "Field", "Type", "Label", "Description"
4201
- :widths: auto
4202
-
4203
- "project", ":ref:`ref_string`", "", "Unique project id which this set of attributes references. +required"
4204
- "domain", ":ref:`ref_string`", "", "Unique domain id which this set of attributes references. +required"
4205
- "workflow", ":ref:`ref_string`", "", "Workflow name which this set of attributes references. +required"
4206
- "resource_type", ":ref:`ref_flyteidl.admin.MatchableResource`", "", "Which type of matchable attributes to return. +required"
4207
-
4208
-
4209
-
4210
-
4211
-
4212
-
4213
-
4214
- .. _ref_flyteidl.admin.WorkflowAttributesGetResponse:
4215
-
4216
- WorkflowAttributesGetResponse
4217
- ------------------------------------------------------------------
4218
-
4219
- Response to get an individual workflow attribute override.
4220
-
4221
-
4222
-
4223
- .. csv-table:: WorkflowAttributesGetResponse type fields
4224
- :header: "Field", "Type", "Label", "Description"
4225
- :widths: auto
4226
-
4227
- "attributes", ":ref:`ref_flyteidl.admin.WorkflowAttributes`", "", ""
4228
-
4229
-
4230
-
4231
-
4232
-
4233
-
4234
-
4235
- .. _ref_flyteidl.admin.WorkflowAttributesUpdateRequest:
4236
-
4237
- WorkflowAttributesUpdateRequest
4238
- ------------------------------------------------------------------
4239
-
4240
- Sets custom attributes for a project, domain and workflow combination.
4241
- For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
4242
-
4243
-
4244
-
4245
- .. csv-table:: WorkflowAttributesUpdateRequest type fields
4246
- :header: "Field", "Type", "Label", "Description"
4247
- :widths: auto
4248
-
4249
- "attributes", ":ref:`ref_flyteidl.admin.WorkflowAttributes`", "", ""
4250
-
4251
-
4252
-
4253
-
4254
-
4255
-
4256
-
4257
- .. _ref_flyteidl.admin.WorkflowAttributesUpdateResponse:
4258
-
4259
- WorkflowAttributesUpdateResponse
4260
- ------------------------------------------------------------------
4261
-
4262
- Purposefully empty, may be populated in the future.
4263
-
4264
-
4265
-
4266
-
4267
-
4268
-
4269
-
4270
- ..
4271
- end messages
4272
-
4273
-
4274
- ..
4275
- end enums
4276
-
4277
-
4278
- ..
4279
- end HasExtensions
4280
-
4281
-
4282
- ..
4283
- end services
4284
-
4285
-
4286
-
4287
-
4288
- .. _ref_google/protobuf/duration.proto:
4289
-
4290
- google/protobuf/duration.proto
4291
- ==================================================================
4292
-
4293
-
4294
-
4295
-
4296
-
4297
- .. _ref_google.protobuf.Duration:
4298
-
4299
- Duration
4300
- ------------------------------------------------------------------
4301
-
4302
- A Duration represents a signed, fixed-length span of time represented
4303
- as a count of seconds and fractions of seconds at nanosecond
4304
- resolution. It is independent of any calendar and concepts like "day"
4305
- or "month". It is related to Timestamp in that the difference between
4306
- two Timestamp values is a Duration and it can be added or subtracted
4307
- from a Timestamp. Range is approximately +-10,000 years.
4308
-
4309
- # Examples
4310
-
4311
- Example 1: Compute Duration from two Timestamps in pseudo code.
4312
-
4313
- Timestamp start = ...;
4314
- Timestamp end = ...;
4315
- Duration duration = ...;
4316
-
4317
- duration.seconds = end.seconds - start.seconds;
4318
- duration.nanos = end.nanos - start.nanos;
4319
-
4320
- if (duration.seconds < 0 && duration.nanos > 0) {
4321
- duration.seconds += 1;
4322
- duration.nanos -= 1000000000;
4323
- } else if (duration.seconds > 0 && duration.nanos < 0) {
4324
- duration.seconds -= 1;
4325
- duration.nanos += 1000000000;
4326
- }
4327
-
4328
- Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
4329
-
4330
- Timestamp start = ...;
4331
- Duration duration = ...;
4332
- Timestamp end = ...;
4333
-
4334
- end.seconds = start.seconds + duration.seconds;
4335
- end.nanos = start.nanos + duration.nanos;
4336
-
4337
- if (end.nanos < 0) {
4338
- end.seconds -= 1;
4339
- end.nanos += 1000000000;
4340
- } else if (end.nanos >= 1000000000) {
4341
- end.seconds += 1;
4342
- end.nanos -= 1000000000;
4343
- }
4344
-
4345
- Example 3: Compute Duration from datetime.timedelta in Python.
4346
-
4347
- td = datetime.timedelta(days=3, minutes=10)
4348
- duration = Duration()
4349
- duration.FromTimedelta(td)
4350
-
4351
- # JSON Mapping
4352
-
4353
- In JSON format, the Duration type is encoded as a string rather than an
4354
- object, where the string ends in the suffix "s" (indicating seconds) and
4355
- is preceded by the number of seconds, with nanoseconds expressed as
4356
- fractional seconds. For example, 3 seconds with 0 nanoseconds should be
4357
- encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
4358
- be expressed in JSON format as "3.000000001s", and 3 seconds and 1
4359
- microsecond should be expressed in JSON format as "3.000001s".
4360
-
4361
-
4362
-
4363
- .. csv-table:: Duration type fields
4364
- :header: "Field", "Type", "Label", "Description"
4365
- :widths: auto
4366
-
4367
- "seconds", ":ref:`ref_int64`", "", "Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years"
4368
- "nanos", ":ref:`ref_int32`", "", "Signed fractions of a second at nanosecond resolution of the span of time. Durations less than one second are represented with a 0 `seconds` field and a positive or negative `nanos` field. For durations of one second or more, a non-zero value for the `nanos` field must be of the same sign as the `seconds` field. Must be from -999,999,999 to +999,999,999 inclusive."
4369
-
4370
-
4371
-
4372
-
4373
-
4374
-
4375
- ..
4376
- end messages
4377
-
4378
-
4379
- ..
4380
- end enums
4381
-
4382
-
4383
- ..
4384
- end HasExtensions
4385
-
4386
-
4387
- ..
4388
- end services
4389
-
4390
-
4391
-
4392
-
4393
- .. _ref_google/protobuf/wrappers.proto:
4394
-
4395
- google/protobuf/wrappers.proto
4396
- ==================================================================
4397
-
4398
-
4399
-
4400
-
4401
-
4402
- .. _ref_google.protobuf.BoolValue:
4403
-
4404
- BoolValue
4405
- ------------------------------------------------------------------
4406
-
4407
- Wrapper message for `bool`.
4408
-
4409
- The JSON representation for `BoolValue` is JSON `true` and `false`.
4410
-
4411
-
4412
-
4413
- .. csv-table:: BoolValue type fields
4414
- :header: "Field", "Type", "Label", "Description"
4415
- :widths: auto
4416
-
4417
- "value", ":ref:`ref_bool`", "", "The bool value."
4418
-
4419
-
4420
-
4421
-
4422
-
4423
-
4424
-
4425
- .. _ref_google.protobuf.BytesValue:
4426
-
4427
- BytesValue
4428
- ------------------------------------------------------------------
4429
-
4430
- Wrapper message for `bytes`.
4431
-
4432
- The JSON representation for `BytesValue` is JSON string.
4433
-
4434
-
4435
-
4436
- .. csv-table:: BytesValue type fields
4437
- :header: "Field", "Type", "Label", "Description"
4438
- :widths: auto
4439
-
4440
- "value", ":ref:`ref_bytes`", "", "The bytes value."
4441
-
4442
-
4443
-
4444
-
4445
-
4446
-
4447
-
4448
- .. _ref_google.protobuf.DoubleValue:
4449
-
4450
- DoubleValue
4451
- ------------------------------------------------------------------
4452
-
4453
- Wrapper message for `double`.
4454
-
4455
- The JSON representation for `DoubleValue` is JSON number.
4456
-
4457
-
4458
-
4459
- .. csv-table:: DoubleValue type fields
4460
- :header: "Field", "Type", "Label", "Description"
4461
- :widths: auto
4462
-
4463
- "value", ":ref:`ref_double`", "", "The double value."
4464
-
4465
-
4466
-
4467
-
4468
-
4469
-
4470
-
4471
- .. _ref_google.protobuf.FloatValue:
4472
-
4473
- FloatValue
4474
- ------------------------------------------------------------------
4475
-
4476
- Wrapper message for `float`.
4477
-
4478
- The JSON representation for `FloatValue` is JSON number.
4479
-
4480
-
4481
-
4482
- .. csv-table:: FloatValue type fields
4483
- :header: "Field", "Type", "Label", "Description"
4484
- :widths: auto
4485
-
4486
- "value", ":ref:`ref_float`", "", "The float value."
4487
-
4488
-
4489
-
4490
-
4491
-
4492
-
4493
-
4494
- .. _ref_google.protobuf.Int32Value:
4495
-
4496
- Int32Value
4497
- ------------------------------------------------------------------
4498
-
4499
- Wrapper message for `int32`.
4500
-
4501
- The JSON representation for `Int32Value` is JSON number.
4502
-
4503
-
4504
-
4505
- .. csv-table:: Int32Value type fields
4506
- :header: "Field", "Type", "Label", "Description"
4507
- :widths: auto
4508
-
4509
- "value", ":ref:`ref_int32`", "", "The int32 value."
4510
-
4511
-
4512
-
4513
-
4514
-
4515
-
4516
-
4517
- .. _ref_google.protobuf.Int64Value:
4518
-
4519
- Int64Value
4520
- ------------------------------------------------------------------
4521
-
4522
- Wrapper message for `int64`.
4523
-
4524
- The JSON representation for `Int64Value` is JSON string.
4525
-
4526
-
4527
-
4528
- .. csv-table:: Int64Value type fields
4529
- :header: "Field", "Type", "Label", "Description"
4530
- :widths: auto
4531
-
4532
- "value", ":ref:`ref_int64`", "", "The int64 value."
4533
-
4534
-
4535
-
4536
-
4537
-
4538
-
4539
-
4540
- .. _ref_google.protobuf.StringValue:
4541
-
4542
- StringValue
4543
- ------------------------------------------------------------------
4544
-
4545
- Wrapper message for `string`.
4546
-
4547
- The JSON representation for `StringValue` is JSON string.
4548
-
4549
-
4550
-
4551
- .. csv-table:: StringValue type fields
4552
- :header: "Field", "Type", "Label", "Description"
4553
- :widths: auto
4554
-
4555
- "value", ":ref:`ref_string`", "", "The string value."
4556
-
4557
-
4558
-
4559
-
4560
-
4561
-
4562
-
4563
- .. _ref_google.protobuf.UInt32Value:
4564
-
4565
- UInt32Value
4566
- ------------------------------------------------------------------
4567
-
4568
- Wrapper message for `uint32`.
4569
-
4570
- The JSON representation for `UInt32Value` is JSON number.
4571
-
4572
-
4573
-
4574
- .. csv-table:: UInt32Value type fields
4575
- :header: "Field", "Type", "Label", "Description"
4576
- :widths: auto
4577
-
4578
- "value", ":ref:`ref_uint32`", "", "The uint32 value."
4579
-
4580
-
4581
-
4582
-
4583
-
4584
-
4585
-
4586
- .. _ref_google.protobuf.UInt64Value:
4587
-
4588
- UInt64Value
4589
- ------------------------------------------------------------------
4590
-
4591
- Wrapper message for `uint64`.
4592
-
4593
- The JSON representation for `UInt64Value` is JSON string.
4594
-
4595
-
4596
-
4597
- .. csv-table:: UInt64Value type fields
4598
- :header: "Field", "Type", "Label", "Description"
4599
- :widths: auto
4600
-
4601
- "value", ":ref:`ref_uint64`", "", "The uint64 value."
4602
-
4603
-
4604
-
4605
-
4606
-
4607
-
4608
- ..
4609
- end messages
4610
-
4611
-
4612
- ..
4613
- end enums
4614
-
4615
-
4616
- ..
4617
- end HasExtensions
4618
-
4619
-
4620
- ..
4621
- end services
4622
-
4623
-