@flyteorg/flyteidl 0.24.8 → 0.24.11

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.
@@ -1,690 +0,0 @@
1
- ######################
2
- Protocol Documentation
3
- ######################
4
-
5
-
6
-
7
-
8
- .. _ref_flyteidl/event/event.proto:
9
-
10
- flyteidl/event/event.proto
11
- ==================================================================
12
-
13
-
14
-
15
-
16
-
17
- .. _ref_flyteidl.event.DynamicWorkflowNodeMetadata:
18
-
19
- DynamicWorkflowNodeMetadata
20
- ------------------------------------------------------------------
21
-
22
- For dynamic workflow nodes we send information about the dynamic workflow definition that gets generated.
23
-
24
-
25
-
26
- .. csv-table:: DynamicWorkflowNodeMetadata type fields
27
- :header: "Field", "Type", "Label", "Description"
28
- :widths: auto
29
-
30
- "id", ":ref:`ref_flyteidl.core.Identifier`", "", "id represents the unique identifier of the workflow."
31
- "compiled_workflow", ":ref:`ref_flyteidl.core.CompiledWorkflowClosure`", "", "Represents the compiled representation of the embedded dynamic workflow."
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
- .. _ref_flyteidl.event.ExternalResourceInfo:
40
-
41
- ExternalResourceInfo
42
- ------------------------------------------------------------------
43
-
44
- This message contains metadata about external resources produced or used by a specific task execution.
45
-
46
-
47
-
48
- .. csv-table:: ExternalResourceInfo type fields
49
- :header: "Field", "Type", "Label", "Description"
50
- :widths: auto
51
-
52
- "external_id", ":ref:`ref_string`", "", "Identifier for an external resource created by this task execution, for example Qubole query ID or presto query ids."
53
- "index", ":ref:`ref_uint32`", "", "A unique index for the external resource with respect to all external resources for this task. Although the identifier may change between task reporting events or retries, this will remain the same to enable aggregating information from multiple reports."
54
- "retry_attempt", ":ref:`ref_uint32`", "", "Retry attempt number for this external resource, ie., 2 for the second attempt"
55
- "phase", ":ref:`ref_flyteidl.core.TaskExecution.Phase`", "", "Phase associated with the external resource"
56
- "cache_status", ":ref:`ref_flyteidl.core.CatalogCacheStatus`", "", "Captures the status of caching for this external resource execution."
57
- "logs", ":ref:`ref_flyteidl.core.TaskLog`", "repeated", "log information for the external resource execution"
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
- .. _ref_flyteidl.event.NodeExecutionEvent:
66
-
67
- NodeExecutionEvent
68
- ------------------------------------------------------------------
69
-
70
-
71
-
72
-
73
-
74
- .. csv-table:: NodeExecutionEvent type fields
75
- :header: "Field", "Type", "Label", "Description"
76
- :widths: auto
77
-
78
- "id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "Unique identifier for this node execution"
79
- "producer_id", ":ref:`ref_string`", "", "the id of the originator (Propeller) of the event"
80
- "phase", ":ref:`ref_flyteidl.core.NodeExecution.Phase`", "", ""
81
- "occurred_at", ":ref:`ref_google.protobuf.Timestamp`", "", "This timestamp represents when the original event occurred, it is generated by the executor of the node."
82
- "input_uri", ":ref:`ref_string`", "", ""
83
- "output_uri", ":ref:`ref_string`", "", "URL to the output of the execution, it encodes all the information including Cloud source provider. ie., s3://..."
84
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information for the execution"
85
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Raw output data produced by this node execution."
86
- "workflow_node_metadata", ":ref:`ref_flyteidl.event.WorkflowNodeMetadata`", "", ""
87
- "task_node_metadata", ":ref:`ref_flyteidl.event.TaskNodeMetadata`", "", ""
88
- "parent_task_metadata", ":ref:`ref_flyteidl.event.ParentTaskExecutionMetadata`", "", "[To be deprecated] Specifies which task (if any) launched this node."
89
- "parent_node_metadata", ":ref:`ref_flyteidl.event.ParentNodeExecutionMetadata`", "", "Specifies the parent node of the current node execution. Node executions at level zero will not have a parent node."
90
- "retry_group", ":ref:`ref_string`", "", "Retry group to indicate grouping of nodes by retries"
91
- "spec_node_id", ":ref:`ref_string`", "", "Identifier of the node in the original workflow/graph This maps to value of WorkflowTemplate.nodes[X].id"
92
- "node_name", ":ref:`ref_string`", "", "Friendly readable name for the node"
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
- .. _ref_flyteidl.event.ParentNodeExecutionMetadata:
101
-
102
- ParentNodeExecutionMetadata
103
- ------------------------------------------------------------------
104
-
105
-
106
-
107
-
108
-
109
- .. csv-table:: ParentNodeExecutionMetadata type fields
110
- :header: "Field", "Type", "Label", "Description"
111
- :widths: auto
112
-
113
- "node_id", ":ref:`ref_string`", "", "Unique identifier of the parent node id within the execution This is value of core.NodeExecutionIdentifier.node_id of the parent node"
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
- .. _ref_flyteidl.event.ParentTaskExecutionMetadata:
122
-
123
- ParentTaskExecutionMetadata
124
- ------------------------------------------------------------------
125
-
126
-
127
-
128
-
129
-
130
- .. csv-table:: ParentTaskExecutionMetadata type fields
131
- :header: "Field", "Type", "Label", "Description"
132
- :widths: auto
133
-
134
- "id", ":ref:`ref_flyteidl.core.TaskExecutionIdentifier`", "", ""
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
- .. _ref_flyteidl.event.ResourcePoolInfo:
143
-
144
- ResourcePoolInfo
145
- ------------------------------------------------------------------
146
-
147
- This message holds task execution metadata specific to resource allocation used to manage concurrent
148
- executions for a project namespace.
149
-
150
-
151
-
152
- .. csv-table:: ResourcePoolInfo type fields
153
- :header: "Field", "Type", "Label", "Description"
154
- :widths: auto
155
-
156
- "allocation_token", ":ref:`ref_string`", "", "Unique resource ID used to identify this execution when allocating a token."
157
- "namespace", ":ref:`ref_string`", "", "Namespace under which this task execution requested an allocation token."
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
- .. _ref_flyteidl.event.TaskExecutionEvent:
166
-
167
- TaskExecutionEvent
168
- ------------------------------------------------------------------
169
-
170
- Plugin specific execution event information. For tasks like Python, Hive, Spark, DynamicJob.
171
-
172
-
173
-
174
- .. csv-table:: TaskExecutionEvent type fields
175
- :header: "Field", "Type", "Label", "Description"
176
- :widths: auto
177
-
178
- "task_id", ":ref:`ref_flyteidl.core.Identifier`", "", "ID of the task. In combination with the retryAttempt this will indicate the task execution uniquely for a given parent node execution."
179
- "parent_node_execution_id", ":ref:`ref_flyteidl.core.NodeExecutionIdentifier`", "", "A task execution is always kicked off by a node execution, the event consumer will use the parent_id to relate the task to it's parent node execution"
180
- "retry_attempt", ":ref:`ref_uint32`", "", "retry attempt number for this task, ie., 2 for the second attempt"
181
- "phase", ":ref:`ref_flyteidl.core.TaskExecution.Phase`", "", "Phase associated with the event"
182
- "producer_id", ":ref:`ref_string`", "", "id of the process that sent this event, mainly for trace debugging"
183
- "logs", ":ref:`ref_flyteidl.core.TaskLog`", "repeated", "log information for the task execution"
184
- "occurred_at", ":ref:`ref_google.protobuf.Timestamp`", "", "This timestamp represents when the original event occurred, it is generated by the executor of the task."
185
- "input_uri", ":ref:`ref_string`", "", "URI of the input file, it encodes all the information including Cloud source provider. ie., s3://..."
186
- "output_uri", ":ref:`ref_string`", "", "URI to the output of the execution, it will be in a format that encodes all the information including Cloud source provider. ie., s3://..."
187
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information for the execution"
188
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Raw output data produced by this task execution."
189
- "custom_info", ":ref:`ref_google.protobuf.Struct`", "", "Custom data that the task plugin sends back. This is extensible to allow various plugins in the system."
190
- "phase_version", ":ref:`ref_uint32`", "", "Some phases, like RUNNING, can send multiple events with changed metadata (new logs, additional custom_info, etc) that should be recorded regardless of the lack of phase change. The version field should be incremented when metadata changes across the duration of an individual phase."
191
- "reason", ":ref:`ref_string`", "", "An optional explanation for the phase transition."
192
- "task_type", ":ref:`ref_string`", "", "A predefined yet extensible Task type identifier. If the task definition is already registered in flyte admin this type will be identical, but not all task executions necessarily use pre-registered definitions and this type is useful to render the task in the UI, filter task executions, etc."
193
- "metadata", ":ref:`ref_flyteidl.event.TaskExecutionMetadata`", "", "Metadata around how a task was executed."
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
- .. _ref_flyteidl.event.TaskExecutionMetadata:
202
-
203
- TaskExecutionMetadata
204
- ------------------------------------------------------------------
205
-
206
- Holds metadata around how a task was executed.
207
- As a task transitions across event phases during execution some attributes, such its generated name, generated external resources,
208
- and more may grow in size but not change necessarily based on the phase transition that sparked the event update.
209
- Metadata is a container for these attributes across the task execution lifecycle.
210
-
211
-
212
-
213
- .. csv-table:: TaskExecutionMetadata type fields
214
- :header: "Field", "Type", "Label", "Description"
215
- :widths: auto
216
-
217
- "generated_name", ":ref:`ref_string`", "", "Unique, generated name for this task execution used by the backend."
218
- "external_resources", ":ref:`ref_flyteidl.event.ExternalResourceInfo`", "repeated", "Additional data on external resources on other back-ends or platforms (e.g. Hive, Qubole, etc) launched by this task execution."
219
- "resource_pool_info", ":ref:`ref_flyteidl.event.ResourcePoolInfo`", "repeated", "Includes additional data on concurrent resource management used during execution.. This is a repeated field because a plugin can request multiple resource allocations during execution."
220
- "plugin_identifier", ":ref:`ref_string`", "", "The identifier of the plugin used to execute this task."
221
- "instance_class", ":ref:`ref_flyteidl.event.TaskExecutionMetadata.InstanceClass`", "", ""
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
- .. _ref_flyteidl.event.TaskNodeMetadata:
230
-
231
- TaskNodeMetadata
232
- ------------------------------------------------------------------
233
-
234
-
235
-
236
-
237
-
238
- .. csv-table:: TaskNodeMetadata type fields
239
- :header: "Field", "Type", "Label", "Description"
240
- :widths: auto
241
-
242
- "cache_status", ":ref:`ref_flyteidl.core.CatalogCacheStatus`", "", "Captures the status of caching for this execution."
243
- "catalog_key", ":ref:`ref_flyteidl.core.CatalogMetadata`", "", "This structure carries the catalog artifact information"
244
- "reservation_status", ":ref:`ref_flyteidl.core.CatalogReservation.Status`", "", "Captures the status of cache reservations for this execution."
245
- "dynamic_workflow", ":ref:`ref_flyteidl.event.DynamicWorkflowNodeMetadata`", "", "In the case this task launched a dynamic workflow we capture its structure here."
246
-
247
-
248
-
249
-
250
-
251
-
252
-
253
- .. _ref_flyteidl.event.WorkflowExecutionEvent:
254
-
255
- WorkflowExecutionEvent
256
- ------------------------------------------------------------------
257
-
258
-
259
-
260
-
261
-
262
- .. csv-table:: WorkflowExecutionEvent type fields
263
- :header: "Field", "Type", "Label", "Description"
264
- :widths: auto
265
-
266
- "execution_id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", "Workflow execution id"
267
- "producer_id", ":ref:`ref_string`", "", "the id of the originator (Propeller) of the event"
268
- "phase", ":ref:`ref_flyteidl.core.WorkflowExecution.Phase`", "", ""
269
- "occurred_at", ":ref:`ref_google.protobuf.Timestamp`", "", "This timestamp represents when the original event occurred, it is generated by the executor of the workflow."
270
- "output_uri", ":ref:`ref_string`", "", "URL to the output of the execution, it encodes all the information including Cloud source provider. ie., s3://..."
271
- "error", ":ref:`ref_flyteidl.core.ExecutionError`", "", "Error information for the execution"
272
- "output_data", ":ref:`ref_flyteidl.core.LiteralMap`", "", "Raw output data produced by this workflow execution."
273
-
274
-
275
-
276
-
277
-
278
-
279
-
280
- .. _ref_flyteidl.event.WorkflowNodeMetadata:
281
-
282
- WorkflowNodeMetadata
283
- ------------------------------------------------------------------
284
-
285
- For Workflow Nodes we need to send information about the workflow that's launched
286
-
287
-
288
-
289
- .. csv-table:: WorkflowNodeMetadata type fields
290
- :header: "Field", "Type", "Label", "Description"
291
- :widths: auto
292
-
293
- "execution_id", ":ref:`ref_flyteidl.core.WorkflowExecutionIdentifier`", "", ""
294
-
295
-
296
-
297
-
298
-
299
- <!-- end messages -->
300
-
301
-
302
-
303
- .. _ref_flyteidl.event.TaskExecutionMetadata.InstanceClass:
304
-
305
- TaskExecutionMetadata.InstanceClass
306
- ------------------------------------------------------------------
307
-
308
- Includes the broad category of machine used for this specific task execution.
309
-
310
- .. csv-table:: Enum TaskExecutionMetadata.InstanceClass values
311
- :header: "Name", "Number", "Description"
312
- :widths: auto
313
-
314
- "DEFAULT", "0", "The default instance class configured for the flyte application platform."
315
- "INTERRUPTIBLE", "1", "The instance class configured for interruptible tasks."
316
-
317
- <!-- end enums -->
318
-
319
- <!-- end HasExtensions -->
320
-
321
- <!-- end services -->
322
-
323
-
324
-
325
-
326
- .. _ref_google/protobuf/timestamp.proto:
327
-
328
- google/protobuf/timestamp.proto
329
- ==================================================================
330
-
331
-
332
-
333
-
334
-
335
- .. _ref_google.protobuf.Timestamp:
336
-
337
- Timestamp
338
- ------------------------------------------------------------------
339
-
340
- A Timestamp represents a point in time independent of any time zone or local
341
- calendar, encoded as a count of seconds and fractions of seconds at
342
- nanosecond resolution. The count is relative to an epoch at UTC midnight on
343
- January 1, 1970, in the proleptic Gregorian calendar which extends the
344
- Gregorian calendar backwards to year one.
345
-
346
- All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
347
- second table is needed for interpretation, using a [24-hour linear
348
- smear](https://developers.google.com/time/smear).
349
-
350
- The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
351
- restricting to that range, we ensure that we can convert to and from [RFC
352
- 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
353
-
354
- # Examples
355
-
356
- Example 1: Compute Timestamp from POSIX `time()`.
357
-
358
- Timestamp timestamp;
359
- timestamp.set_seconds(time(NULL));
360
- timestamp.set_nanos(0);
361
-
362
- Example 2: Compute Timestamp from POSIX `gettimeofday()`.
363
-
364
- struct timeval tv;
365
- gettimeofday(&tv, NULL);
366
-
367
- Timestamp timestamp;
368
- timestamp.set_seconds(tv.tv_sec);
369
- timestamp.set_nanos(tv.tv_usec * 1000);
370
-
371
- Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
372
-
373
- FILETIME ft;
374
- GetSystemTimeAsFileTime(&ft);
375
- UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
376
-
377
- // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
378
- // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
379
- Timestamp timestamp;
380
- timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
381
- timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
382
-
383
- Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
384
-
385
- long millis = System.currentTimeMillis();
386
-
387
- Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
388
- .setNanos((int) ((millis % 1000) * 1000000)).build();
389
-
390
-
391
- Example 5: Compute Timestamp from Java `Instant.now()`.
392
-
393
- Instant now = Instant.now();
394
-
395
- Timestamp timestamp =
396
- Timestamp.newBuilder().setSeconds(now.getEpochSecond())
397
- .setNanos(now.getNano()).build();
398
-
399
-
400
- Example 6: Compute Timestamp from current time in Python.
401
-
402
- timestamp = Timestamp()
403
- timestamp.GetCurrentTime()
404
-
405
- # JSON Mapping
406
-
407
- In JSON format, the Timestamp type is encoded as a string in the
408
- [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
409
- format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
410
- where {year} is always expressed using four digits while {month}, {day},
411
- {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
412
- seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
413
- are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
414
- is required. A proto3 JSON serializer should always use UTC (as indicated by
415
- "Z") when printing the Timestamp type and a proto3 JSON parser should be
416
- able to accept both UTC and other timezones (as indicated by an offset).
417
-
418
- For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
419
- 01:30 UTC on January 15, 2017.
420
-
421
- In JavaScript, one can convert a Date object to this format using the
422
- standard
423
- [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
424
- method. In Python, a standard `datetime.datetime` object can be converted
425
- to this format using
426
- [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
427
- the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
428
- the Joda Time's [`ISODateTimeFormat.dateTime()`](
429
- http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
430
- ) to obtain a formatter capable of generating timestamps in this format.
431
-
432
-
433
-
434
- .. csv-table:: Timestamp type fields
435
- :header: "Field", "Type", "Label", "Description"
436
- :widths: auto
437
-
438
- "seconds", ":ref:`ref_int64`", "", "Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive."
439
- "nanos", ":ref:`ref_int32`", "", "Non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be from 0 to 999,999,999 inclusive."
440
-
441
-
442
-
443
-
444
-
445
- <!-- end messages -->
446
-
447
- <!-- end enums -->
448
-
449
- <!-- end HasExtensions -->
450
-
451
- <!-- end services -->
452
-
453
-
454
-
455
-
456
- .. _ref_google/protobuf/duration.proto:
457
-
458
- google/protobuf/duration.proto
459
- ==================================================================
460
-
461
-
462
-
463
-
464
-
465
- .. _ref_google.protobuf.Duration:
466
-
467
- Duration
468
- ------------------------------------------------------------------
469
-
470
- A Duration represents a signed, fixed-length span of time represented
471
- as a count of seconds and fractions of seconds at nanosecond
472
- resolution. It is independent of any calendar and concepts like "day"
473
- or "month". It is related to Timestamp in that the difference between
474
- two Timestamp values is a Duration and it can be added or subtracted
475
- from a Timestamp. Range is approximately +-10,000 years.
476
-
477
- # Examples
478
-
479
- Example 1: Compute Duration from two Timestamps in pseudo code.
480
-
481
- Timestamp start = ...;
482
- Timestamp end = ...;
483
- Duration duration = ...;
484
-
485
- duration.seconds = end.seconds - start.seconds;
486
- duration.nanos = end.nanos - start.nanos;
487
-
488
- if (duration.seconds < 0 && duration.nanos > 0) {
489
- duration.seconds += 1;
490
- duration.nanos -= 1000000000;
491
- } else if (duration.seconds > 0 && duration.nanos < 0) {
492
- duration.seconds -= 1;
493
- duration.nanos += 1000000000;
494
- }
495
-
496
- Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
497
-
498
- Timestamp start = ...;
499
- Duration duration = ...;
500
- Timestamp end = ...;
501
-
502
- end.seconds = start.seconds + duration.seconds;
503
- end.nanos = start.nanos + duration.nanos;
504
-
505
- if (end.nanos < 0) {
506
- end.seconds -= 1;
507
- end.nanos += 1000000000;
508
- } else if (end.nanos >= 1000000000) {
509
- end.seconds += 1;
510
- end.nanos -= 1000000000;
511
- }
512
-
513
- Example 3: Compute Duration from datetime.timedelta in Python.
514
-
515
- td = datetime.timedelta(days=3, minutes=10)
516
- duration = Duration()
517
- duration.FromTimedelta(td)
518
-
519
- # JSON Mapping
520
-
521
- In JSON format, the Duration type is encoded as a string rather than an
522
- object, where the string ends in the suffix "s" (indicating seconds) and
523
- is preceded by the number of seconds, with nanoseconds expressed as
524
- fractional seconds. For example, 3 seconds with 0 nanoseconds should be
525
- encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
526
- be expressed in JSON format as "3.000000001s", and 3 seconds and 1
527
- microsecond should be expressed in JSON format as "3.000001s".
528
-
529
-
530
-
531
- .. csv-table:: Duration type fields
532
- :header: "Field", "Type", "Label", "Description"
533
- :widths: auto
534
-
535
- "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"
536
- "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."
537
-
538
-
539
-
540
-
541
-
542
- <!-- end messages -->
543
-
544
- <!-- end enums -->
545
-
546
- <!-- end HasExtensions -->
547
-
548
- <!-- end services -->
549
-
550
-
551
-
552
-
553
- .. _ref_google/protobuf/struct.proto:
554
-
555
- google/protobuf/struct.proto
556
- ==================================================================
557
-
558
-
559
-
560
-
561
-
562
- .. _ref_google.protobuf.ListValue:
563
-
564
- ListValue
565
- ------------------------------------------------------------------
566
-
567
- `ListValue` is a wrapper around a repeated field of values.
568
-
569
- The JSON representation for `ListValue` is JSON array.
570
-
571
-
572
-
573
- .. csv-table:: ListValue type fields
574
- :header: "Field", "Type", "Label", "Description"
575
- :widths: auto
576
-
577
- "values", ":ref:`ref_google.protobuf.Value`", "repeated", "Repeated field of dynamically typed values."
578
-
579
-
580
-
581
-
582
-
583
-
584
-
585
- .. _ref_google.protobuf.Struct:
586
-
587
- Struct
588
- ------------------------------------------------------------------
589
-
590
- `Struct` represents a structured data value, consisting of fields
591
- which map to dynamically typed values. In some languages, `Struct`
592
- might be supported by a native representation. For example, in
593
- scripting languages like JS a struct is represented as an
594
- object. The details of that representation are described together
595
- with the proto support for the language.
596
-
597
- The JSON representation for `Struct` is JSON object.
598
-
599
-
600
-
601
- .. csv-table:: Struct type fields
602
- :header: "Field", "Type", "Label", "Description"
603
- :widths: auto
604
-
605
- "fields", ":ref:`ref_google.protobuf.Struct.FieldsEntry`", "repeated", "Unordered map of dynamically typed values."
606
-
607
-
608
-
609
-
610
-
611
-
612
-
613
- .. _ref_google.protobuf.Struct.FieldsEntry:
614
-
615
- Struct.FieldsEntry
616
- ------------------------------------------------------------------
617
-
618
-
619
-
620
-
621
-
622
- .. csv-table:: Struct.FieldsEntry type fields
623
- :header: "Field", "Type", "Label", "Description"
624
- :widths: auto
625
-
626
- "key", ":ref:`ref_string`", "", ""
627
- "value", ":ref:`ref_google.protobuf.Value`", "", ""
628
-
629
-
630
-
631
-
632
-
633
-
634
-
635
- .. _ref_google.protobuf.Value:
636
-
637
- Value
638
- ------------------------------------------------------------------
639
-
640
- `Value` represents a dynamically typed value which can be either
641
- null, a number, a string, a boolean, a recursive struct value, or a
642
- list of values. A producer of value is expected to set one of these
643
- variants. Absence of any variant indicates an error.
644
-
645
- The JSON representation for `Value` is JSON value.
646
-
647
-
648
-
649
- .. csv-table:: Value type fields
650
- :header: "Field", "Type", "Label", "Description"
651
- :widths: auto
652
-
653
- "null_value", ":ref:`ref_google.protobuf.NullValue`", "", "Represents a null value."
654
- "number_value", ":ref:`ref_double`", "", "Represents a double value."
655
- "string_value", ":ref:`ref_string`", "", "Represents a string value."
656
- "bool_value", ":ref:`ref_bool`", "", "Represents a boolean value."
657
- "struct_value", ":ref:`ref_google.protobuf.Struct`", "", "Represents a structured value."
658
- "list_value", ":ref:`ref_google.protobuf.ListValue`", "", "Represents a repeated `Value`."
659
-
660
-
661
-
662
-
663
-
664
- <!-- end messages -->
665
-
666
-
667
-
668
- .. _ref_google.protobuf.NullValue:
669
-
670
- NullValue
671
- ------------------------------------------------------------------
672
-
673
- `NullValue` is a singleton enumeration to represent the null value for the
674
- `Value` type union.
675
-
676
- The JSON representation for `NullValue` is JSON `null`.
677
-
678
- .. csv-table:: Enum NullValue values
679
- :header: "Name", "Number", "Description"
680
- :widths: auto
681
-
682
- "NULL_VALUE", "0", "Null value."
683
-
684
- <!-- end enums -->
685
-
686
- <!-- end HasExtensions -->
687
-
688
- <!-- end services -->
689
-
690
-