@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,27 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
-
5
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
6
-
7
- // Represents the Email object that is sent to a publisher/subscriber
8
- // to forward the notification.
9
- // Note: This is internal to Admin and doesn't need to be exposed to other components.
10
- message EmailMessage {
11
- // The list of email addresses to receive an email with the content populated in the other fields.
12
- // Currently, each email recipient will receive its own email.
13
- // This populates the TO field.
14
- repeated string recipients_email = 1;
15
-
16
- // The email of the sender.
17
- // This populates the FROM field.
18
- string sender_email = 2;
19
-
20
- // The content of the subject line.
21
- // This populates the SUBJECT field.
22
- string subject_line = 3;
23
-
24
- // The content of the email body.
25
- // This populates the BODY field.
26
- string body = 4;
27
- }
@@ -1,132 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
-
7
- import "flyteidl/admin/common.proto";
8
-
9
- // Empty request for GetDomain
10
- message GetDomainRequest {}
11
-
12
- // Namespace within a project commonly used to differentiate between different service instances.
13
- // e.g. "production", "development", etc.
14
- message Domain {
15
- // Globally unique domain name.
16
- string id = 1;
17
-
18
- // Display name.
19
- string name = 2;
20
- }
21
-
22
- // Represents a list of domains.
23
- message GetDomainsResponse {
24
- repeated Domain domains = 1;
25
- }
26
-
27
- // Top-level namespace used to classify different entities like workflows and executions.
28
- message Project {
29
- // Globally unique project name.
30
- string id = 1;
31
-
32
- // Display name.
33
- string name = 2;
34
-
35
- repeated Domain domains = 3;
36
-
37
- string description = 4;
38
-
39
- // Leverage Labels from flyteidl.admin.common.proto to
40
- // tag projects with ownership information.
41
- Labels labels = 5;
42
-
43
- // The state of the project is used to control its visibility in the UI and validity.
44
- enum ProjectState {
45
- // By default, all projects are considered active.
46
- ACTIVE = 0;
47
-
48
- // Archived projects are no longer visible in the UI and no longer valid.
49
- ARCHIVED = 1;
50
-
51
- // System generated projects that aren't explicitly created or managed by a user.
52
- SYSTEM_GENERATED = 2;
53
-
54
- // System archived projects that aren't explicitly archived by a user.
55
- SYSTEM_ARCHIVED = 3;
56
- }
57
- ProjectState state = 6;
58
-
59
- // Optional, org key applied to the resource.
60
- string org = 7;
61
- }
62
-
63
- // Represents a list of projects.
64
- // See :ref:`ref_flyteidl.admin.Project` for more details
65
- message Projects {
66
- repeated Project projects = 1;
67
-
68
- // In the case of multiple pages of results, the server-provided token can be used to fetch the next page
69
- // in a query. If there are no more results, this value will be empty.
70
- string token = 2;
71
- }
72
-
73
- // Request to retrieve a list of projects matching specified filters.
74
- // See :ref:`ref_flyteidl.admin.Project` for more details
75
- message ProjectListRequest {
76
- // Indicates the number of projects to be returned.
77
- // +required
78
- uint32 limit = 1;
79
-
80
- // In the case of multiple pages of results, this server-provided token can be used to fetch the next page
81
- // in a query.
82
- // +optional
83
- string token = 2;
84
-
85
- // Indicates a list of filters passed as string.
86
- // More info on constructing filters : <Link>
87
- // +optional
88
- string filters = 3;
89
-
90
- // Sort ordering.
91
- // +optional
92
- Sort sort_by = 4;
93
-
94
- // Optional, org filter applied to list project requests.
95
- string org = 5;
96
- }
97
-
98
- // Adds a new user-project within the Flyte deployment.
99
- // See :ref:`ref_flyteidl.admin.Project` for more details
100
- message ProjectRegisterRequest {
101
- // +required
102
- Project project = 1;
103
- }
104
-
105
- // Purposefully empty, may be updated in the future.
106
- message ProjectRegisterResponse {
107
- }
108
-
109
- // Purposefully empty, may be updated in the future.
110
- message ProjectUpdateResponse {
111
- }
112
-
113
- message ProjectGetRequest {
114
- // Indicates a unique project.
115
- // +required
116
- string id = 1;
117
-
118
- // Optional, org key applied to the resource.
119
- string org = 2;
120
- }
121
-
122
-
123
- // Error returned for inactive projects
124
- message InactiveProject {
125
- // Indicates a unique project.
126
- // +required
127
- string id = 1;
128
-
129
- // Optional, org key applied to the resource.
130
- string org = 2;
131
- }
132
-
@@ -1,69 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- import "flyteidl/admin/matchable_resource.proto";
7
-
8
- // Defines a set of custom matching attributes at the project level.
9
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
10
- message ProjectAttributes {
11
- // Unique project id for which this set of attributes will be applied.
12
- string project = 1;
13
-
14
- MatchingAttributes matching_attributes = 2;
15
-
16
- // Optional, org key applied to the project.
17
- string org = 3;
18
- }
19
-
20
- // Sets custom attributes for a project
21
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
22
- message ProjectAttributesUpdateRequest {
23
- // +required
24
- ProjectAttributes attributes = 1;
25
- }
26
-
27
- // Purposefully empty, may be populated in the future.
28
- message ProjectAttributesUpdateResponse {
29
- }
30
-
31
- // Request to get an individual project level attribute override.
32
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
33
- message ProjectAttributesGetRequest {
34
- // Unique project id which this set of attributes references.
35
- // +required
36
- string project = 1;
37
-
38
- // Which type of matchable attributes to return.
39
- // +required
40
- MatchableResource resource_type = 2;
41
-
42
- // Optional, org key applied to the project.
43
- string org = 3;
44
- }
45
-
46
- // Response to get an individual project level attribute override.
47
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
48
- message ProjectAttributesGetResponse {
49
- ProjectAttributes attributes = 1;
50
- }
51
-
52
- // Request to delete a set matchable project level attribute override.
53
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
54
- message ProjectAttributesDeleteRequest {
55
- // Unique project id which this set of attributes references.
56
- // +required
57
- string project = 1;
58
-
59
- // Which type of matchable attributes to delete.
60
- // +required
61
- MatchableResource resource_type = 2;
62
-
63
- // Optional, org key applied to the project.
64
- string org = 3;
65
- }
66
-
67
- // Purposefully empty, may be populated in the future.
68
- message ProjectAttributesDeleteResponse {
69
- }
@@ -1,80 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- import "flyteidl/admin/matchable_resource.proto";
7
-
8
- // Defines a set of custom matching attributes which defines resource defaults for a project and domain.
9
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
10
- message ProjectDomainAttributes {
11
- // Unique project id for which this set of attributes will be applied.
12
- string project = 1;
13
-
14
- // Unique domain id for which this set of attributes will be applied.
15
- string domain = 2;
16
-
17
- MatchingAttributes matching_attributes = 3;
18
-
19
- // Optional, org key applied to the attributes.
20
- string org = 4;
21
- }
22
-
23
- // Sets custom attributes for a project-domain combination.
24
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
25
- message ProjectDomainAttributesUpdateRequest {
26
- // +required
27
- ProjectDomainAttributes attributes = 1;
28
- }
29
-
30
- // Purposefully empty, may be populated in the future.
31
- message ProjectDomainAttributesUpdateResponse {
32
- }
33
-
34
- // Request to get an individual project domain attribute override.
35
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
36
- message ProjectDomainAttributesGetRequest {
37
- // Unique project id which this set of attributes references.
38
- // +required
39
- string project = 1;
40
-
41
- // Unique domain id which this set of attributes references.
42
- // +required
43
- string domain = 2;
44
-
45
- // Which type of matchable attributes to return.
46
- // +required
47
- MatchableResource resource_type = 3;
48
-
49
- // Optional, org key applied to the attributes.
50
- string org = 4;
51
- }
52
-
53
- // Response to get an individual project domain attribute override.
54
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
55
- message ProjectDomainAttributesGetResponse {
56
- ProjectDomainAttributes attributes = 1;
57
- }
58
-
59
- // Request to delete a set matchable project domain attribute override.
60
- // For more info on matchable attributes, see :ref:`ref_flyteidl.admin.MatchableAttributesConfiguration`
61
- message ProjectDomainAttributesDeleteRequest {
62
- // Unique project id which this set of attributes references.
63
- // +required
64
- string project = 1;
65
-
66
- // Unique domain id which this set of attributes references.
67
- // +required
68
- string domain = 2;
69
-
70
- // Which type of matchable attributes to delete.
71
- // +required
72
- MatchableResource resource_type = 3;
73
-
74
- // Optional, org key applied to the attributes.
75
- string org = 4;
76
- }
77
-
78
- // Purposefully empty, may be populated in the future.
79
- message ProjectDomainAttributesDeleteResponse {
80
- }
@@ -1,43 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- // Represents a frequency at which to run a schedule.
7
- enum FixedRateUnit {
8
- MINUTE = 0;
9
- HOUR = 1;
10
- DAY = 2;
11
- }
12
-
13
- // Option for schedules run at a certain frequency e.g. every 2 minutes.
14
- message FixedRate {
15
- uint32 value = 1;
16
- FixedRateUnit unit = 2;
17
- }
18
-
19
- // Options for schedules to run according to a cron expression.
20
- message CronSchedule {
21
- // Standard/default cron implementation as described by https://en.wikipedia.org/wiki/Cron#CRON_expression;
22
- // Also supports nonstandard predefined scheduling definitions
23
- // as described by https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions
24
- // except @reboot
25
- string schedule = 1;
26
- // ISO 8601 duration as described by https://en.wikipedia.org/wiki/ISO_8601#Durations
27
- string offset = 2;
28
- }
29
-
30
- // Defines complete set of information required to trigger an execution on a schedule.
31
- message Schedule {
32
-
33
- oneof ScheduleExpression {
34
- // Uses AWS syntax: Minutes Hours Day-of-month Month Day-of-week Year
35
- // e.g. for a schedule that runs every 15 minutes: 0/15 * * * ? *
36
- string cron_expression = 1 [deprecated=true];
37
- FixedRate rate = 2;
38
- CronSchedule cron_schedule = 4;
39
- }
40
-
41
- // Name of the input variable that the kickoff time will be supplied to when the workflow is kicked off.
42
- string kickoff_time_input_arg = 3;
43
- }
@@ -1,86 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- import "flyteidl/admin/common.proto";
7
- import "flyteidl/core/identifier.proto";
8
- import "flyteidl/core/literals.proto";
9
- import "flyteidl/core/types.proto";
10
-
11
- // SignalGetOrCreateRequest represents a request structure to retrieve or create a signal.
12
- // See :ref:`ref_flyteidl.admin.Signal` for more details
13
- message SignalGetOrCreateRequest {
14
- // A unique identifier for the requested signal.
15
- core.SignalIdentifier id = 1;
16
-
17
- // A type denoting the required value type for this signal.
18
- core.LiteralType type = 2;
19
- }
20
-
21
- // SignalListRequest represents a request structure to retrieve a collection of signals.
22
- // See :ref:`ref_flyteidl.admin.Signal` for more details
23
- message SignalListRequest {
24
- // Indicates the workflow execution to filter by.
25
- // +required
26
- core.WorkflowExecutionIdentifier workflow_execution_id = 1;
27
-
28
- // Indicates the number of resources to be returned.
29
- // +required
30
- uint32 limit = 2;
31
-
32
- // In the case of multiple pages of results, the, server-provided token can be used to fetch the next page
33
- // in a query.
34
- // +optional
35
- string token = 3;
36
-
37
- // Indicates a list of filters passed as string.
38
- // +optional
39
- string filters = 4;
40
-
41
- // Sort ordering.
42
- // +optional
43
- Sort sort_by = 5;
44
- }
45
-
46
- // SignalList represents collection of signals along with the token of the last result.
47
- // See :ref:`ref_flyteidl.admin.Signal` for more details
48
- message SignalList {
49
- // A list of signals matching the input filters.
50
- repeated Signal signals = 1;
51
-
52
- // In the case of multiple pages of results, the server-provided token can be used to fetch the next page
53
- // in a query. If there are no more results, this value will be empty.
54
- string token = 2;
55
- }
56
-
57
- // SignalSetRequest represents a request structure to set the value on a signal. Setting a signal
58
- // effetively satisfies the signal condition within a Flyte workflow.
59
- // See :ref:`ref_flyteidl.admin.Signal` for more details
60
- message SignalSetRequest {
61
- // A unique identifier for the requested signal.
62
- core.SignalIdentifier id = 1;
63
-
64
- // The value of this signal, must match the defining signal type.
65
- core.Literal value = 2;
66
- }
67
-
68
- // SignalSetResponse represents a response structure if signal setting succeeds.
69
- message SignalSetResponse {
70
- // Purposefully empty, may be populated in the future.
71
- }
72
-
73
- // Signal encapsulates a unique identifier, associated metadata, and a value for a single Flyte
74
- // signal. Signals may exist either without a set value (representing a signal request) or with a
75
- // populated value (indicating the signal has been given).
76
- message Signal {
77
- // A unique identifier for the requested signal.
78
- core.SignalIdentifier id = 1;
79
-
80
- // A type denoting the required value type for this signal.
81
- core.LiteralType type = 2;
82
-
83
- // The value of the signal. This is only available if the signal has been "set" and must match
84
- // the defined the type.
85
- core.Literal value = 3;
86
- }
@@ -1,71 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- import "flyteidl/core/identifier.proto";
7
- import "flyteidl/core/tasks.proto";
8
- import "flyteidl/core/compiler.proto";
9
- import "flyteidl/admin/description_entity.proto";
10
- import "google/protobuf/timestamp.proto";
11
-
12
- // Represents a request structure to create a revision of a task.
13
- // See :ref:`ref_flyteidl.admin.Task` for more details
14
- message TaskCreateRequest {
15
- // id represents the unique identifier of the task.
16
- // +required
17
- core.Identifier id = 1;
18
-
19
- // Represents the specification for task.
20
- // +required
21
- TaskSpec spec = 2;
22
- }
23
-
24
- // Represents a response structure if task creation succeeds.
25
- message TaskCreateResponse {
26
- // Purposefully empty, may be populated in the future.
27
- }
28
-
29
- // Flyte workflows are composed of many ordered tasks. That is small, reusable, self-contained logical blocks
30
- // arranged to process workflow inputs and produce a deterministic set of outputs.
31
- // Tasks can come in many varieties tuned for specialized behavior.
32
- message Task {
33
- // id represents the unique identifier of the task.
34
- core.Identifier id = 1;
35
-
36
- // closure encapsulates all the fields that maps to a compiled version of the task.
37
- TaskClosure closure = 2;
38
-
39
- // One-liner overview of the entity.
40
- string short_description = 3;
41
- }
42
-
43
- // Represents a list of tasks returned from the admin.
44
- // See :ref:`ref_flyteidl.admin.Task` for more details
45
- message TaskList {
46
- // A list of tasks returned based on the request.
47
- repeated Task tasks = 1;
48
-
49
- // In the case of multiple pages of results, the server-provided token can be used to fetch the next page
50
- // in a query. If there are no more results, this value will be empty.
51
- string token = 2;
52
- }
53
-
54
- // Represents a structure that encapsulates the user-configured specification of the task.
55
- message TaskSpec {
56
- // Template of the task that encapsulates all the metadata of the task.
57
- core.TaskTemplate template = 1;
58
-
59
- // Represents the specification for description entity.
60
- DescriptionEntity description = 2;
61
- }
62
-
63
- // Compute task attributes which include values derived from the TaskSpec, as well as plugin-specific data
64
- // and task metadata.
65
- message TaskClosure {
66
- // Represents the compiled representation of the task from the specification provided.
67
- core.CompiledTask compiled_task = 1;
68
-
69
- // Time at which the task was created.
70
- google.protobuf.Timestamp created_at = 2;
71
- }
@@ -1,171 +0,0 @@
1
- syntax = "proto3";
2
-
3
- package flyteidl.admin;
4
- option go_package = "github.com/flyteorg/flyte/flyteidl/gen/pb-go/flyteidl/admin";
5
-
6
- import "flyteidl/admin/common.proto";
7
- import "flyteidl/core/execution.proto";
8
- import "flyteidl/core/identifier.proto";
9
- import "flyteidl/core/literals.proto";
10
- import "flyteidl/event/event.proto";
11
- import "google/protobuf/timestamp.proto";
12
- import "google/protobuf/duration.proto";
13
- import "google/protobuf/struct.proto";
14
-
15
- // A message used to fetch a single task execution entity.
16
- // See :ref:`ref_flyteidl.admin.TaskExecution` for more details
17
- message TaskExecutionGetRequest {
18
- // Unique identifier for the task execution.
19
- // +required
20
- core.TaskExecutionIdentifier id = 1;
21
- }
22
-
23
- // Represents a request structure to retrieve a list of task execution entities yielded by a specific node execution.
24
- // See :ref:`ref_flyteidl.admin.TaskExecution` for more details
25
- message TaskExecutionListRequest {
26
- // Indicates the node execution to filter by.
27
- // +required
28
- core.NodeExecutionIdentifier node_execution_id = 1;
29
-
30
- // Indicates the number of resources to be returned.
31
- // +required
32
- uint32 limit = 2;
33
-
34
- // In the case of multiple pages of results, the server-provided token can be used to fetch the next page
35
- // in a query.
36
- // +optional
37
- string token = 3;
38
-
39
- // Indicates a list of filters passed as string.
40
- // More info on constructing filters : <Link>
41
- // +optional
42
- string filters = 4;
43
-
44
- // Sort ordering for returned list.
45
- // +optional
46
- Sort sort_by = 5;
47
- }
48
-
49
- // Encapsulates all details for a single task execution entity.
50
- // A task execution represents an instantiated task, including all inputs and additional
51
- // metadata as well as computed results included state, outputs, and duration-based attributes.
52
- message TaskExecution {
53
- // Unique identifier for the task execution.
54
- core.TaskExecutionIdentifier id = 1;
55
-
56
- // Path to remote data store where input blob is stored.
57
- string input_uri = 2;
58
-
59
- // Task execution details and results.
60
- TaskExecutionClosure closure = 3;
61
-
62
- // Whether this task spawned nodes.
63
- bool is_parent = 4;
64
- }
65
-
66
- // Response structure for a query to list of task execution entities.
67
- // See :ref:`ref_flyteidl.admin.TaskExecution` for more details
68
- message TaskExecutionList {
69
- repeated TaskExecution task_executions = 1;
70
-
71
- // In the case of multiple pages of results, the server-provided token can be used to fetch the next page
72
- // in a query. If there are no more results, this value will be empty.
73
- string token = 2;
74
- }
75
-
76
- // Container for task execution details and results.
77
- message TaskExecutionClosure {
78
- oneof output_result {
79
- // Path to remote data store where output blob is stored if the execution succeeded (and produced outputs).
80
- // DEPRECATED. Use GetTaskExecutionData to fetch output data instead.
81
- string output_uri = 1 [deprecated = true];
82
-
83
- // Error information for the task execution. Populated if the execution failed.
84
- core.ExecutionError error = 2;
85
-
86
- // Raw output data produced by this task execution.
87
- // DEPRECATED. Use GetTaskExecutionData to fetch output data instead.
88
- core.LiteralMap output_data = 12 [deprecated = true];
89
- }
90
-
91
- // The last recorded phase for this task execution.
92
- core.TaskExecution.Phase phase = 3;
93
-
94
- // Detailed log information output by the task execution.
95
- repeated core.TaskLog logs = 4;
96
-
97
- // Time at which the task execution began running.
98
- google.protobuf.Timestamp started_at = 5;
99
-
100
- // The amount of time the task execution spent running.
101
- google.protobuf.Duration duration = 6;
102
-
103
- // Time at which the task execution was created.
104
- google.protobuf.Timestamp created_at = 7;
105
-
106
- // Time at which the task execution was last updated.
107
- google.protobuf.Timestamp updated_at = 8;
108
-
109
- // Custom data specific to the task plugin.
110
- google.protobuf.Struct custom_info = 9;
111
-
112
- // If there is an explanation for the most recent phase transition, the reason will capture it.
113
- string reason = 10;
114
-
115
- // A predefined yet extensible Task type identifier.
116
- string task_type = 11;
117
-
118
- // Metadata around how a task was executed.
119
- event.TaskExecutionMetadata metadata = 16;
120
-
121
- // The event version is used to indicate versioned changes in how data is maintained using this
122
- // proto message. For example, event_verison > 0 means that maps tasks logs use the
123
- // TaskExecutionMetadata ExternalResourceInfo fields for each subtask rather than the TaskLog
124
- // in this message.
125
- int32 event_version = 17;
126
-
127
- // A time-series of the phase transition or update explanations. This, when compared to storing a singular reason
128
- // as previously done, is much more valuable in visualizing and understanding historical evaluations.
129
- repeated Reason reasons = 18;
130
-
131
- // Contains metadata required to identify logs related to this task execution
132
- core.LogContext log_context = 19;
133
- }
134
-
135
- // Reason is a single message annotated with a timestamp to indicate the instant the reason occurred.
136
- message Reason {
137
- // occurred_at is the timestamp indicating the instant that this reason happened.
138
- google.protobuf.Timestamp occurred_at = 1;
139
-
140
- // message is the explanation for the most recent phase transition or status update.
141
- string message = 2;
142
- }
143
-
144
- // Request structure to fetch inputs and output for a task execution.
145
- // By default this data is not returned inline in :ref:`ref_flyteidl.admin.TaskExecutionGetRequest`
146
- message TaskExecutionGetDataRequest {
147
- // The identifier of the task execution for which to fetch inputs and outputs.
148
- // +required
149
- core.TaskExecutionIdentifier id = 1;
150
- }
151
-
152
- // Response structure for TaskExecutionGetDataRequest which contains inputs and outputs for a task execution.
153
- message TaskExecutionGetDataResponse {
154
- // Signed url to fetch a core.LiteralMap of task execution inputs.
155
- // Deprecated: Please use full_inputs instead.
156
- UrlBlob inputs = 1 [deprecated = true];
157
-
158
- // Signed url to fetch a core.LiteralMap of task execution outputs.
159
- // Deprecated: Please use full_outputs instead.
160
- UrlBlob outputs = 2 [deprecated = true];
161
-
162
- // Full_inputs will only be populated if they are under a configured size threshold.
163
- core.LiteralMap full_inputs = 3;
164
-
165
- // Full_outputs will only be populated if they are under a configured size threshold.
166
- core.LiteralMap full_outputs = 4;
167
-
168
- // flyte tiny url to fetch a core.LiteralMap of task execution's IO
169
- // Deck will be empty for task
170
- FlyteURLs flyte_urls = 5;
171
- }