@maxim_mazurok/gapi.client.dataflow-v1b3 0.1.20260302 → 0.2.20260302

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 (2) hide show
  1. package/index.d.ts +451 -186
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -56,7 +56,12 @@ declare namespace gapi.client {
56
56
  /** A message describing why the system decided to adjust the current number of workers, why it failed, or why the system decided to not make any changes to the number of workers. */
57
57
  description?: StructuredMessage;
58
58
  /** The type of autoscaling event to report. */
59
- eventType?: string;
59
+ eventType?:
60
+ | 'TYPE_UNKNOWN'
61
+ | 'TARGET_NUM_WORKERS_CHANGED'
62
+ | 'CURRENT_NUM_WORKERS_CHANGED'
63
+ | 'ACTUATION_FAILURE'
64
+ | 'NO_CHANGE';
60
65
  /** The target number of workers the worker pool wants to resize to use. */
61
66
  targetNumWorkers?: string;
62
67
  /** The time this event was emitted to indicate a new target or current num_workers value. */
@@ -66,7 +71,10 @@ declare namespace gapi.client {
66
71
  }
67
72
  interface AutoscalingSettings {
68
73
  /** The algorithm to use for autoscaling. */
69
- algorithm?: string;
74
+ algorithm?:
75
+ | 'AUTOSCALING_ALGORITHM_UNKNOWN'
76
+ | 'AUTOSCALING_ALGORITHM_NONE'
77
+ | 'AUTOSCALING_ALGORITHM_BASIC';
70
78
  /** The maximum number of workers to cap scaling at. */
71
79
  maxNumWorkers?: number;
72
80
  }
@@ -170,11 +178,29 @@ declare namespace gapi.client {
170
178
  /** Human-readable description of the counter semantics. */
171
179
  description?: string;
172
180
  /** Counter aggregation kind. */
173
- kind?: string;
181
+ kind?:
182
+ | 'INVALID'
183
+ | 'SUM'
184
+ | 'MAX'
185
+ | 'MIN'
186
+ | 'MEAN'
187
+ | 'OR'
188
+ | 'AND'
189
+ | 'SET'
190
+ | 'DISTRIBUTION'
191
+ | 'LATEST_VALUE';
174
192
  /** A string referring to the unit type. */
175
193
  otherUnits?: string;
176
194
  /** System defined Units, see above enum. */
177
- standardUnits?: string;
195
+ standardUnits?:
196
+ | 'BYTES'
197
+ | 'BYTES_PER_SEC'
198
+ | 'MILLISECONDS'
199
+ | 'MICROSECONDS'
200
+ | 'NANOSECONDS'
201
+ | 'TIMESTAMP_MSEC'
202
+ | 'TIMESTAMP_USEC'
203
+ | 'TIMESTAMP_NSEC';
178
204
  }
179
205
  interface CounterStructuredName {
180
206
  /** Name of the optimized step being executed by the workers. */
@@ -186,7 +212,7 @@ declare namespace gapi.client {
186
212
  /** Counter name. Not necessarily globally-unique, but unique within the context of the other fields. Required. */
187
213
  name?: string;
188
214
  /** One of the standard Origins defined above. */
189
- origin?: string;
215
+ origin?: 'SYSTEM' | 'USER';
190
216
  /** The step name requesting an operation, such as GBK. I.e. the ParDo causing a read/write from shuffle to occur, or a read from side inputs. */
191
217
  originalRequestingStepName?: string;
192
218
  /** System generated name of the original step in the user's graph, before optimization. */
@@ -194,7 +220,7 @@ declare namespace gapi.client {
194
220
  /** A string containing a more specific namespace of the counter's origin. */
195
221
  originNamespace?: string;
196
222
  /** Portion of this counter, either key or value. */
197
- portion?: string;
223
+ portion?: 'ALL' | 'KEY' | 'VALUE';
198
224
  /** ID of a particular worker. */
199
225
  workerId?: string;
200
226
  }
@@ -286,7 +312,11 @@ declare namespace gapi.client {
286
312
  }
287
313
  interface DataSamplingConfig {
288
314
  /** List of given sampling behaviors to enable. For example, specifying behaviors = [ALWAYS_ON] samples in-flight elements but does not sample exceptions. Can be used to specify multiple behaviors like, behaviors = [ALWAYS_ON, EXCEPTIONS] for specifying periodic sampling and exception sampling. If DISABLED is in the list, then sampling will be disabled and ignore the other given behaviors. Ordering does not matter. */
289
- behaviors?: string[];
315
+ behaviors?:
316
+ | 'DATA_SAMPLING_BEHAVIOR_UNSPECIFIED'
317
+ | 'DISABLED'
318
+ | 'ALWAYS_ON'
319
+ | 'EXCEPTIONS'[];
290
320
  }
291
321
  interface DataSamplingReport {
292
322
  /** Optional. Delta of bytes written to file from previous report. */
@@ -319,7 +349,11 @@ declare namespace gapi.client {
319
349
  interface DeleteSnapshotResponse {}
320
350
  interface DerivedSource {
321
351
  /** What source to base the produced source on (if any). */
322
- derivationMode?: string;
352
+ derivationMode?:
353
+ | 'SOURCE_DERIVATION_MODE_UNKNOWN'
354
+ | 'SOURCE_DERIVATION_MODE_INDEPENDENT'
355
+ | 'SOURCE_DERIVATION_MODE_CHILD_OF_CURRENT'
356
+ | 'SOURCE_DERIVATION_MODE_SIBLING_OF_CURRENT';
323
357
  /** Specification of the source. */
324
358
  source?: Source;
325
359
  }
@@ -387,7 +421,10 @@ declare namespace gapi.client {
387
421
  /** The list of experiments to enable. This field should be used for SDK related experiments and not for service related experiments. The proper field for service related experiments is service_options. */
388
422
  experiments?: string[];
389
423
  /** Optional. Which Flexible Resource Scheduling mode to run in. */
390
- flexResourceSchedulingGoal?: string;
424
+ flexResourceSchedulingGoal?:
425
+ | 'FLEXRS_UNSPECIFIED'
426
+ | 'FLEXRS_SPEED_OPTIMIZED'
427
+ | 'FLEXRS_COST_OPTIMIZED';
391
428
  /** Experimental settings. */
392
429
  internalExperiments?: {[P in string]: any};
393
430
  /** The Cloud Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way. */
@@ -399,9 +436,12 @@ declare namespace gapi.client {
399
436
  /** Optional. The list of service options to enable. This field should be used for service related experiments only. These experiments, when graduating to GA, should be replaced by dedicated fields or become default (i.e. always on). */
400
437
  serviceOptions?: string[];
401
438
  /** Output only. The shuffle mode used for the job. */
402
- shuffleMode?: string;
439
+ shuffleMode?: 'SHUFFLE_MODE_UNSPECIFIED' | 'VM_BASED' | 'SERVICE_BASED';
403
440
  /** Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes). */
404
- streamingMode?: string;
441
+ streamingMode?:
442
+ | 'STREAMING_MODE_UNSPECIFIED'
443
+ | 'STREAMING_MODE_EXACTLY_ONCE'
444
+ | 'STREAMING_MODE_AT_LEAST_ONCE';
405
445
  /** The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object} */
406
446
  tempStoragePrefix?: string;
407
447
  /** Optional. True when any worker pool that uses public IPs is present. */
@@ -425,7 +465,22 @@ declare namespace gapi.client {
425
465
  /** The name of the execution stage. */
426
466
  executionStageName?: string;
427
467
  /** Executions stage states allow the same set of values as JobState. */
428
- executionStageState?: string;
468
+ executionStageState?:
469
+ | 'JOB_STATE_UNKNOWN'
470
+ | 'JOB_STATE_STOPPED'
471
+ | 'JOB_STATE_RUNNING'
472
+ | 'JOB_STATE_DONE'
473
+ | 'JOB_STATE_FAILED'
474
+ | 'JOB_STATE_CANCELLED'
475
+ | 'JOB_STATE_UPDATED'
476
+ | 'JOB_STATE_DRAINING'
477
+ | 'JOB_STATE_DRAINED'
478
+ | 'JOB_STATE_PENDING'
479
+ | 'JOB_STATE_CANCELLING'
480
+ | 'JOB_STATE_QUEUED'
481
+ | 'JOB_STATE_RESOURCE_CLEANING_UP'
482
+ | 'JOB_STATE_PAUSING'
483
+ | 'JOB_STATE_PAUSED';
429
484
  }
430
485
  interface ExecutionStageSummary {
431
486
  /** Collections produced and consumed by component transforms of this stage. */
@@ -437,7 +492,16 @@ declare namespace gapi.client {
437
492
  /** Input sources for this stage. */
438
493
  inputSource?: StageSource[];
439
494
  /** Type of transform this stage is executing. */
440
- kind?: string;
495
+ kind?:
496
+ | 'UNKNOWN_KIND'
497
+ | 'PAR_DO_KIND'
498
+ | 'GROUP_BY_KEY_KIND'
499
+ | 'FLATTEN_KIND'
500
+ | 'READ_KIND'
501
+ | 'WRITE_KIND'
502
+ | 'CONSTANT_KIND'
503
+ | 'SINGLETON_KIND'
504
+ | 'SHUFFLE_KIND';
441
505
  /** Dataflow service generated name for this stage. */
442
506
  name?: string;
443
507
  /** Output sources for this stage. */
@@ -465,7 +529,10 @@ declare namespace gapi.client {
465
529
  /** Additional user labels to be specified for the job. Keys and values must follow the restrictions specified in the [labeling restrictions](https://cloud.google.com/compute/docs/labeling-resources#restrictions) page. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" }. */
466
530
  additionalUserLabels?: {[P in string]: string};
467
531
  /** The algorithm to use for autoscaling */
468
- autoscalingAlgorithm?: string;
532
+ autoscalingAlgorithm?:
533
+ | 'AUTOSCALING_ALGORITHM_UNKNOWN'
534
+ | 'AUTOSCALING_ALGORITHM_NONE'
535
+ | 'AUTOSCALING_ALGORITHM_BASIC';
469
536
  /** Worker disk size, in gigabytes. */
470
537
  diskSizeGb?: number;
471
538
  /** If true, when processing time is spent almost entirely on garbage collection (GC), saves a heap dump before ending the thread or process. If false, ends the thread or process without saving a heap dump. Does not save a heap dump when the Java Virtual Machine (JVM) has an out of memory error during processing. The location of the heap file is either echoed back to the user, or the user is given the opportunity to download the heap file. */
@@ -475,9 +542,15 @@ declare namespace gapi.client {
475
542
  /** Whether to enable Streaming Engine for the job. */
476
543
  enableStreamingEngine?: boolean;
477
544
  /** Set FlexRS goal for the job. https://cloud.google.com/dataflow/docs/guides/flexrs */
478
- flexrsGoal?: string;
545
+ flexrsGoal?:
546
+ | 'FLEXRS_UNSPECIFIED'
547
+ | 'FLEXRS_SPEED_OPTIMIZED'
548
+ | 'FLEXRS_COST_OPTIMIZED';
479
549
  /** Configuration for VM IPs. */
480
- ipConfiguration?: string;
550
+ ipConfiguration?:
551
+ | 'WORKER_IP_UNSPECIFIED'
552
+ | 'WORKER_IP_PUBLIC'
553
+ | 'WORKER_IP_PRIVATE';
481
554
  /** Name for the Cloud KMS key for the job. Key format is: projects//locations//keyRings//cryptoKeys/ */
482
555
  kmsKeyName?: string;
483
556
  /** The machine type to use for launching the job. The default is n1-standard-1. */
@@ -499,7 +572,10 @@ declare namespace gapi.client {
499
572
  /** The Cloud Storage path for staging local files. Must be a valid Cloud Storage URL, beginning with `gs://`. */
500
573
  stagingLocation?: string;
501
574
  /** Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes). */
502
- streamingMode?: string;
575
+ streamingMode?:
576
+ | 'STREAMING_MODE_UNSPECIFIED'
577
+ | 'STREAMING_MODE_EXACTLY_ONCE'
578
+ | 'STREAMING_MODE_AT_LEAST_ONCE';
503
579
  /** Subnetwork to which VMs will be assigned, if desired. You can specify a subnetwork using either a complete URL or an abbreviated path. Expected to be of the form "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. */
504
580
  subnetwork?: string;
505
581
  /** The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`. */
@@ -541,7 +617,7 @@ declare namespace gapi.client {
541
617
  /** The status of the get template request. Any problems with the request will be indicated in the error_details. */
542
618
  status?: Status;
543
619
  /** Template Type. */
544
- templateType?: string;
620
+ templateType?: 'UNKNOWN' | 'LEGACY' | 'FLEX';
545
621
  }
546
622
  interface GetWorkerStacktracesRequest {
547
623
  /** The end time for the stacktrace query. The returned stacktraces will be a recent stack trace at or shortly before this time. */
@@ -633,7 +709,22 @@ declare namespace gapi.client {
633
709
  /** The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service. */
634
710
  createTime?: string;
635
711
  /** The current state of the job. Jobs are created in the `JOB_STATE_STOPPED` state unless otherwise specified. A job in the `JOB_STATE_RUNNING` state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made. This field might be mutated by the Dataflow service; callers cannot mutate it. */
636
- currentState?: string;
712
+ currentState?:
713
+ | 'JOB_STATE_UNKNOWN'
714
+ | 'JOB_STATE_STOPPED'
715
+ | 'JOB_STATE_RUNNING'
716
+ | 'JOB_STATE_DONE'
717
+ | 'JOB_STATE_FAILED'
718
+ | 'JOB_STATE_CANCELLED'
719
+ | 'JOB_STATE_UPDATED'
720
+ | 'JOB_STATE_DRAINING'
721
+ | 'JOB_STATE_DRAINED'
722
+ | 'JOB_STATE_PENDING'
723
+ | 'JOB_STATE_CANCELLING'
724
+ | 'JOB_STATE_QUEUED'
725
+ | 'JOB_STATE_RESOURCE_CLEANING_UP'
726
+ | 'JOB_STATE_PAUSING'
727
+ | 'JOB_STATE_PAUSED';
637
728
  /** The timestamp associated with the current state. */
638
729
  currentStateTime?: string;
639
730
  /** Optional. The environment for the job. */
@@ -661,7 +752,22 @@ declare namespace gapi.client {
661
752
  /** If this job is an update of an existing job, this field is the job ID of the job it replaced. When sending a `CreateJobRequest`, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job. */
662
753
  replaceJobId?: string;
663
754
  /** The job's requested state. Applies to `UpdateJob` requests. Set `requested_state` with `UpdateJob` requests to switch between the states `JOB_STATE_STOPPED` and `JOB_STATE_RUNNING`. You can also use `UpdateJob` requests to change a job's state from `JOB_STATE_RUNNING` to `JOB_STATE_CANCELLED`, `JOB_STATE_DONE`, or `JOB_STATE_DRAINED`. These states irrevocably terminate the job if it hasn't already reached a terminal state. This field has no effect on `CreateJob` requests. */
664
- requestedState?: string;
755
+ requestedState?:
756
+ | 'JOB_STATE_UNKNOWN'
757
+ | 'JOB_STATE_STOPPED'
758
+ | 'JOB_STATE_RUNNING'
759
+ | 'JOB_STATE_DONE'
760
+ | 'JOB_STATE_FAILED'
761
+ | 'JOB_STATE_CANCELLED'
762
+ | 'JOB_STATE_UPDATED'
763
+ | 'JOB_STATE_DRAINING'
764
+ | 'JOB_STATE_DRAINED'
765
+ | 'JOB_STATE_PENDING'
766
+ | 'JOB_STATE_CANCELLING'
767
+ | 'JOB_STATE_QUEUED'
768
+ | 'JOB_STATE_RESOURCE_CLEANING_UP'
769
+ | 'JOB_STATE_PAUSING'
770
+ | 'JOB_STATE_PAUSED';
665
771
  /** This field may ONLY be modified at runtime using the projects.jobs.update method to adjust job behavior. This field has no effect when specified at job creation. */
666
772
  runtimeUpdatableParams?: RuntimeUpdatableParams;
667
773
  /** Output only. Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests. */
@@ -683,7 +789,7 @@ declare namespace gapi.client {
683
789
  /** Optional. The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job. */
684
790
  transformNameMapping?: {[P in string]: string};
685
791
  /** Optional. The type of Dataflow job. */
686
- type?: string;
792
+ type?: 'JOB_TYPE_UNKNOWN' | 'JOB_TYPE_BATCH' | 'JOB_TYPE_STREAMING';
687
793
  }
688
794
  interface JobExecutionDetails {
689
795
  /** If present, this response does not contain all requested tasks. To obtain the next page of results, repeat the request with page_token set to this value. */
@@ -703,7 +809,13 @@ declare namespace gapi.client {
703
809
  /** Deprecated. */
704
810
  id?: string;
705
811
  /** Importance level of the message. */
706
- messageImportance?: string;
812
+ messageImportance?:
813
+ | 'JOB_MESSAGE_IMPORTANCE_UNKNOWN'
814
+ | 'JOB_MESSAGE_DEBUG'
815
+ | 'JOB_MESSAGE_DETAILED'
816
+ | 'JOB_MESSAGE_BASIC'
817
+ | 'JOB_MESSAGE_WARNING'
818
+ | 'JOB_MESSAGE_ERROR';
707
819
  /** The text of the message. */
708
820
  messageText?: string;
709
821
  /** The timestamp of the message. */
@@ -935,7 +1047,17 @@ declare namespace gapi.client {
935
1047
  }
936
1048
  interface NameAndKind {
937
1049
  /** Counter aggregation kind. */
938
- kind?: string;
1050
+ kind?:
1051
+ | 'INVALID'
1052
+ | 'SUM'
1053
+ | 'MAX'
1054
+ | 'MIN'
1055
+ | 'MEAN'
1056
+ | 'OR'
1057
+ | 'AND'
1058
+ | 'SET'
1059
+ | 'DISTRIBUTION'
1060
+ | 'LATEST_VALUE';
939
1061
  /** Name of the counter. */
940
1062
  name?: string;
941
1063
  }
@@ -1001,7 +1123,30 @@ declare namespace gapi.client {
1001
1123
  /** Required. The name of the parameter. */
1002
1124
  name?: string;
1003
1125
  /** Optional. The type of the parameter. Used for selecting input picker. */
1004
- paramType?: string;
1126
+ paramType?:
1127
+ | 'DEFAULT'
1128
+ | 'TEXT'
1129
+ | 'GCS_READ_BUCKET'
1130
+ | 'GCS_WRITE_BUCKET'
1131
+ | 'GCS_READ_FILE'
1132
+ | 'GCS_WRITE_FILE'
1133
+ | 'GCS_READ_FOLDER'
1134
+ | 'GCS_WRITE_FOLDER'
1135
+ | 'PUBSUB_TOPIC'
1136
+ | 'PUBSUB_SUBSCRIPTION'
1137
+ | 'BIGQUERY_TABLE'
1138
+ | 'JAVASCRIPT_UDF_FILE'
1139
+ | 'SERVICE_ACCOUNT'
1140
+ | 'MACHINE_TYPE'
1141
+ | 'KMS_KEY_NAME'
1142
+ | 'WORKER_REGION'
1143
+ | 'WORKER_ZONE'
1144
+ | 'BOOLEAN'
1145
+ | 'ENUM'
1146
+ | 'NUMBER'
1147
+ | 'KAFKA_TOPIC'
1148
+ | 'KAFKA_READ_TOPIC'
1149
+ | 'KAFKA_WRITE_TOPIC';
1005
1150
  /** Optional. Specifies the name of the parent parameter. Used in conjunction with 'parent_trigger_values' to make this parameter conditional (will only be rendered conditionally). Should be mappable to a ParameterMetadata.name field. */
1006
1151
  parentName?: string;
1007
1152
  /** Optional. The value(s) of the 'parent_name' parameter which will trigger this parameter to be shown. If left empty, ANY non-empty value in parent_name will trigger this parameter to be shown. Only considered when this parameter is conditional (when 'parent_name' has been provided). */
@@ -1178,7 +1323,10 @@ declare namespace gapi.client {
1178
1323
  /** Optional. Whether to enable Streaming Engine for the job. */
1179
1324
  enableStreamingEngine?: boolean;
1180
1325
  /** Optional. Configuration for VM IPs. */
1181
- ipConfiguration?: string;
1326
+ ipConfiguration?:
1327
+ | 'WORKER_IP_UNSPECIFIED'
1328
+ | 'WORKER_IP_PUBLIC'
1329
+ | 'WORKER_IP_PRIVATE';
1182
1330
  /** Optional. Name for the Cloud KMS key for the job. Key format is: projects//locations//keyRings//cryptoKeys/ */
1183
1331
  kmsKeyName?: string;
1184
1332
  /** Optional. The machine type to use for the job. Defaults to the value from the template if not specified. */
@@ -1192,7 +1340,10 @@ declare namespace gapi.client {
1192
1340
  /** Optional. The email address of the service account to run the job as. */
1193
1341
  serviceAccountEmail?: string;
1194
1342
  /** Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes). */
1195
- streamingMode?: string;
1343
+ streamingMode?:
1344
+ | 'STREAMING_MODE_UNSPECIFIED'
1345
+ | 'STREAMING_MODE_EXACTLY_ONCE'
1346
+ | 'STREAMING_MODE_AT_LEAST_ONCE';
1196
1347
  /** Optional. Subnetwork to which VMs will be assigned, if desired. You can specify a subnetwork using either a complete URL or an abbreviated path. Expected to be of the form "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. */
1197
1348
  subnetwork?: string;
1198
1349
  /** Required. The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`. */
@@ -1230,9 +1381,9 @@ declare namespace gapi.client {
1230
1381
  }
1231
1382
  interface SdkBug {
1232
1383
  /** Output only. How severe the SDK bug is. */
1233
- severity?: string;
1384
+ severity?: 'SEVERITY_UNSPECIFIED' | 'NOTICE' | 'WARNING' | 'SEVERE';
1234
1385
  /** Output only. Describes the impact of this SDK bug. */
1235
- type?: string;
1386
+ type?: 'TYPE_UNSPECIFIED' | 'GENERAL' | 'PERFORMANCE' | 'DATALOSS';
1236
1387
  /** Output only. Link to more information on the bug. */
1237
1388
  uri?: string;
1238
1389
  }
@@ -1248,7 +1399,7 @@ declare namespace gapi.client {
1248
1399
  }
1249
1400
  interface SDKInfo {
1250
1401
  /** Required. The SDK Language. */
1251
- language?: string;
1402
+ language?: 'UNKNOWN' | 'JAVA' | 'PYTHON' | 'GO' | 'YAML';
1252
1403
  /** Optional. The SDK version. */
1253
1404
  version?: string;
1254
1405
  }
@@ -1256,7 +1407,12 @@ declare namespace gapi.client {
1256
1407
  /** Output only. Known bugs found in this SDK version. */
1257
1408
  bugs?: SdkBug[];
1258
1409
  /** The support status for this SDK version. */
1259
- sdkSupportStatus?: string;
1410
+ sdkSupportStatus?:
1411
+ | 'UNKNOWN'
1412
+ | 'SUPPORTED'
1413
+ | 'STALE'
1414
+ | 'DEPRECATED'
1415
+ | 'UNSUPPORTED';
1260
1416
  /** The version of the SDK used to run the job. */
1261
1417
  version?: string;
1262
1418
  /** A readable string describing the version of the SDK. */
@@ -1268,7 +1424,12 @@ declare namespace gapi.client {
1268
1424
  /** The encoded debug information. */
1269
1425
  data?: string;
1270
1426
  /** Format for the data field above (id=5). */
1271
- dataFormat?: string;
1427
+ dataFormat?:
1428
+ | 'DATA_FORMAT_UNSPECIFIED'
1429
+ | 'RAW'
1430
+ | 'JSON'
1431
+ | 'ZLIB'
1432
+ | 'BROTLI';
1272
1433
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the job specified by job_id. */
1273
1434
  location?: string;
1274
1435
  /** The worker id, i.e., VM hostname. */
@@ -1347,7 +1508,13 @@ declare namespace gapi.client {
1347
1508
  /** The job this snapshot was created from. */
1348
1509
  sourceJobId?: string;
1349
1510
  /** State of the snapshot. */
1350
- state?: string;
1511
+ state?:
1512
+ | 'UNKNOWN_SNAPSHOT_STATE'
1513
+ | 'PENDING'
1514
+ | 'RUNNING'
1515
+ | 'READY'
1516
+ | 'FAILED'
1517
+ | 'DELETED';
1351
1518
  /** The time after which this snapshot will be automatically deleted. */
1352
1519
  ttl?: string;
1353
1520
  }
@@ -1435,13 +1602,20 @@ declare namespace gapi.client {
1435
1602
  /** If outcome is SPLITTING_HAPPENED, then this is a list of bundles into which the source was split. Otherwise this field is ignored. This list can be empty, which means the source represents an empty input. */
1436
1603
  bundles?: DerivedSource[];
1437
1604
  /** Indicates whether splitting happened and produced a list of bundles. If this is USE_CURRENT_SOURCE_AS_IS, the current source should be processed "as is" without splitting. "bundles" is ignored in this case. If this is SPLITTING_HAPPENED, then "bundles" contains a list of bundles into which the source was split. */
1438
- outcome?: string;
1605
+ outcome?:
1606
+ | 'SOURCE_SPLIT_OUTCOME_UNKNOWN'
1607
+ | 'SOURCE_SPLIT_OUTCOME_USE_CURRENT'
1608
+ | 'SOURCE_SPLIT_OUTCOME_SPLITTING_HAPPENED';
1439
1609
  /** DEPRECATED in favor of bundles. */
1440
1610
  shards?: SourceSplitShard[];
1441
1611
  }
1442
1612
  interface SourceSplitShard {
1443
1613
  /** DEPRECATED */
1444
- derivationMode?: string;
1614
+ derivationMode?:
1615
+ | 'SOURCE_DERIVATION_MODE_UNKNOWN'
1616
+ | 'SOURCE_DERIVATION_MODE_INDEPENDENT'
1617
+ | 'SOURCE_DERIVATION_MODE_CHILD_OF_CURRENT'
1618
+ | 'SOURCE_DERIVATION_MODE_SIBLING_OF_CURRENT';
1445
1619
  /** DEPRECATED */
1446
1620
  source?: Source;
1447
1621
  }
@@ -1499,7 +1673,13 @@ declare namespace gapi.client {
1499
1673
  /** Start time of this stage. */
1500
1674
  startTime?: string;
1501
1675
  /** State of this stage. */
1502
- state?: string;
1676
+ state?:
1677
+ | 'EXECUTION_STATE_UNKNOWN'
1678
+ | 'EXECUTION_STATE_NOT_STARTED'
1679
+ | 'EXECUTION_STATE_RUNNING'
1680
+ | 'EXECUTION_STATE_SUCCEEDED'
1681
+ | 'EXECUTION_STATE_FAILED'
1682
+ | 'EXECUTION_STATE_CANCELLED';
1503
1683
  /** Straggler summary for this stage. */
1504
1684
  stragglerSummary?: StragglerSummary;
1505
1685
  }
@@ -1579,7 +1759,10 @@ declare namespace gapi.client {
1579
1759
  /** Describes the set of data disks this task should apply to. */
1580
1760
  dataDisks?: MountedDataDisk[];
1581
1761
  /** A type of streaming computation task. */
1582
- taskType?: string;
1762
+ taskType?:
1763
+ | 'STREAMING_COMPUTATION_TASK_UNKNOWN'
1764
+ | 'STREAMING_COMPUTATION_TASK_STOP'
1765
+ | 'STREAMING_COMPUTATION_TASK_START';
1583
1766
  }
1584
1767
  interface StreamingConfigTask {
1585
1768
  /** Chunk size for commit streams from the harness to windmill. */
@@ -1778,7 +1961,16 @@ declare namespace gapi.client {
1778
1961
  /** User names for all collection inputs to this transform. */
1779
1962
  inputCollectionName?: string[];
1780
1963
  /** Type of transform. */
1781
- kind?: string;
1964
+ kind?:
1965
+ | 'UNKNOWN_KIND'
1966
+ | 'PAR_DO_KIND'
1967
+ | 'GROUP_BY_KEY_KIND'
1968
+ | 'FLATTEN_KIND'
1969
+ | 'READ_KIND'
1970
+ | 'WRITE_KIND'
1971
+ | 'CONSTANT_KIND'
1972
+ | 'SINGLETON_KIND'
1973
+ | 'SHUFFLE_KIND';
1782
1974
  /** User provided name for this transform instance. */
1783
1975
  name?: string;
1784
1976
  /** User names for all collection outputs to this transform. */
@@ -1814,7 +2006,15 @@ declare namespace gapi.client {
1814
2006
  /** The start time of this container. All events will report this so that events can be grouped together across container/VM restarts. */
1815
2007
  containerStartTime?: string;
1816
2008
  /** The event being reported. */
1817
- event?: string;
2009
+ event?:
2010
+ | 'UNKNOWN_EVENT'
2011
+ | 'OS_START'
2012
+ | 'CONTAINER_START'
2013
+ | 'NETWORK_UP'
2014
+ | 'STAGING_FILES_DOWNLOAD_START'
2015
+ | 'STAGING_FILES_DOWNLOAD_FINISH'
2016
+ | 'SDK_INSTALL_START'
2017
+ | 'SDK_INSTALL_FINISH';
1818
2018
  /** Other stats that can accompany an event. E.g. { "downloaded_bytes" : "123456" } */
1819
2019
  metadata?: {[P in string]: string};
1820
2020
  }
@@ -1866,7 +2066,11 @@ declare namespace gapi.client {
1866
2066
  /** Data disks that are used by a VM in this workflow. */
1867
2067
  dataDisks?: Disk[];
1868
2068
  /** The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. */
1869
- defaultPackageSet?: string;
2069
+ defaultPackageSet?:
2070
+ | 'DEFAULT_PACKAGE_SET_UNKNOWN'
2071
+ | 'DEFAULT_PACKAGE_SET_NONE'
2072
+ | 'DEFAULT_PACKAGE_SET_JAVA'
2073
+ | 'DEFAULT_PACKAGE_SET_PYTHON';
1870
2074
  /** Optional. IOPS provisioned for the root disk for VMs. */
1871
2075
  diskProvisionedIops?: string;
1872
2076
  /** Optional. Throughput provisioned for the root disk for VMs. */
@@ -1878,7 +2082,10 @@ declare namespace gapi.client {
1878
2082
  /** Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. */
1879
2083
  diskType?: string;
1880
2084
  /** Configuration for VM IPs. */
1881
- ipConfiguration?: string;
2085
+ ipConfiguration?:
2086
+ | 'WORKER_IP_UNSPECIFIED'
2087
+ | 'WORKER_IP_PUBLIC'
2088
+ | 'WORKER_IP_PRIVATE';
1882
2089
  /** The kind of the worker pool; currently only `harness` and `shuffle` are supported. */
1883
2090
  kind?: string;
1884
2091
  /** Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default. */
@@ -1904,7 +2111,11 @@ declare namespace gapi.client {
1904
2111
  /** Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field. */
1905
2112
  taskrunnerSettings?: TaskRunnerSettings;
1906
2113
  /** Sets the policy for determining when to turndown worker pool. Allowed values are: `TEARDOWN_ALWAYS`, `TEARDOWN_ON_SUCCESS`, and `TEARDOWN_NEVER`. `TEARDOWN_ALWAYS` means workers are always torn down regardless of whether the job succeeds. `TEARDOWN_ON_SUCCESS` means workers are torn down if the job succeeds. `TEARDOWN_NEVER` means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the `TEARDOWN_ALWAYS` policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default. */
1907
- teardownPolicy?: string;
2114
+ teardownPolicy?:
2115
+ | 'TEARDOWN_POLICY_UNKNOWN'
2116
+ | 'TEARDOWN_ALWAYS'
2117
+ | 'TEARDOWN_ON_SUCCESS'
2118
+ | 'TEARDOWN_NEVER';
1908
2119
  /** Required. Docker container image that executes the Cloud Dataflow worker harness, residing in Google Container Registry. Deprecated for the Fn API path. Use sdk_harness_container_images instead. */
1909
2120
  workerHarnessContainerImage?: string;
1910
2121
  /** Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default. */
@@ -1981,7 +2192,13 @@ declare namespace gapi.client {
1981
2192
  /** Start time of this work item attempt. */
1982
2193
  startTime?: string;
1983
2194
  /** State of this work item. */
1984
- state?: string;
2195
+ state?:
2196
+ | 'EXECUTION_STATE_UNKNOWN'
2197
+ | 'EXECUTION_STATE_NOT_STARTED'
2198
+ | 'EXECUTION_STATE_RUNNING'
2199
+ | 'EXECUTION_STATE_SUCCEEDED'
2200
+ | 'EXECUTION_STATE_FAILED'
2201
+ | 'EXECUTION_STATE_CANCELLED';
1985
2202
  /** Information about straggler detections for this work item. */
1986
2203
  stragglerInfo?: StragglerInfo;
1987
2204
  /** Name of this work item. */
@@ -2049,11 +2266,11 @@ declare namespace gapi.client {
2049
2266
  /** Get encoded debug configuration for component. Not cacheable. */
2050
2267
  getConfig(request: {
2051
2268
  /** V1 error format. */
2052
- '$.xgafv'?: string;
2269
+ '$.xgafv'?: '1' | '2';
2053
2270
  /** OAuth access token. */
2054
2271
  access_token?: string;
2055
2272
  /** Data format for response. */
2056
- alt?: string;
2273
+ alt?: 'json' | 'media' | 'proto';
2057
2274
  /** JSONP */
2058
2275
  callback?: string;
2059
2276
  /** Selector specifying which fields to include in a partial response. */
@@ -2080,11 +2297,11 @@ declare namespace gapi.client {
2080
2297
  getConfig(
2081
2298
  request: {
2082
2299
  /** V1 error format. */
2083
- '$.xgafv'?: string;
2300
+ '$.xgafv'?: '1' | '2';
2084
2301
  /** OAuth access token. */
2085
2302
  access_token?: string;
2086
2303
  /** Data format for response. */
2087
- alt?: string;
2304
+ alt?: 'json' | 'media' | 'proto';
2088
2305
  /** JSONP */
2089
2306
  callback?: string;
2090
2307
  /** Selector specifying which fields to include in a partial response. */
@@ -2111,11 +2328,11 @@ declare namespace gapi.client {
2111
2328
  /** Send encoded debug capture data for component. */
2112
2329
  sendCapture(request: {
2113
2330
  /** V1 error format. */
2114
- '$.xgafv'?: string;
2331
+ '$.xgafv'?: '1' | '2';
2115
2332
  /** OAuth access token. */
2116
2333
  access_token?: string;
2117
2334
  /** Data format for response. */
2118
- alt?: string;
2335
+ alt?: 'json' | 'media' | 'proto';
2119
2336
  /** JSONP */
2120
2337
  callback?: string;
2121
2338
  /** Selector specifying which fields to include in a partial response. */
@@ -2142,11 +2359,11 @@ declare namespace gapi.client {
2142
2359
  sendCapture(
2143
2360
  request: {
2144
2361
  /** V1 error format. */
2145
- '$.xgafv'?: string;
2362
+ '$.xgafv'?: '1' | '2';
2146
2363
  /** OAuth access token. */
2147
2364
  access_token?: string;
2148
2365
  /** Data format for response. */
2149
- alt?: string;
2366
+ alt?: 'json' | 'media' | 'proto';
2150
2367
  /** JSONP */
2151
2368
  callback?: string;
2152
2369
  /** Selector specifying which fields to include in a partial response. */
@@ -2175,11 +2392,11 @@ declare namespace gapi.client {
2175
2392
  /** Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`. */
2176
2393
  list(request?: {
2177
2394
  /** V1 error format. */
2178
- '$.xgafv'?: string;
2395
+ '$.xgafv'?: '1' | '2';
2179
2396
  /** OAuth access token. */
2180
2397
  access_token?: string;
2181
2398
  /** Data format for response. */
2182
- alt?: string;
2399
+ alt?: 'json' | 'media' | 'proto';
2183
2400
  /** JSONP */
2184
2401
  callback?: string;
2185
2402
  /** Return only messages with timestamps < end_time. The default is now (i.e. return up to the latest messages available). */
@@ -2193,7 +2410,13 @@ declare namespace gapi.client {
2193
2410
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the job specified by job_id. */
2194
2411
  location?: string;
2195
2412
  /** Filter to only get messages with importance >= level */
2196
- minimumImportance?: string;
2413
+ minimumImportance?:
2414
+ | 'JOB_MESSAGE_IMPORTANCE_UNKNOWN'
2415
+ | 'JOB_MESSAGE_DEBUG'
2416
+ | 'JOB_MESSAGE_DETAILED'
2417
+ | 'JOB_MESSAGE_BASIC'
2418
+ | 'JOB_MESSAGE_WARNING'
2419
+ | 'JOB_MESSAGE_ERROR';
2197
2420
  /** OAuth 2.0 token for the current user. */
2198
2421
  oauth_token?: string;
2199
2422
  /** If specified, determines the maximum number of messages to return. If unspecified, the service may choose an appropriate default, or may return an arbitrarily large number of results. */
@@ -2218,11 +2441,11 @@ declare namespace gapi.client {
2218
2441
  /** Leases a dataflow WorkItem to run. */
2219
2442
  lease(request: {
2220
2443
  /** V1 error format. */
2221
- '$.xgafv'?: string;
2444
+ '$.xgafv'?: '1' | '2';
2222
2445
  /** OAuth access token. */
2223
2446
  access_token?: string;
2224
2447
  /** Data format for response. */
2225
- alt?: string;
2448
+ alt?: 'json' | 'media' | 'proto';
2226
2449
  /** JSONP */
2227
2450
  callback?: string;
2228
2451
  /** Selector specifying which fields to include in a partial response. */
@@ -2249,11 +2472,11 @@ declare namespace gapi.client {
2249
2472
  lease(
2250
2473
  request: {
2251
2474
  /** V1 error format. */
2252
- '$.xgafv'?: string;
2475
+ '$.xgafv'?: '1' | '2';
2253
2476
  /** OAuth access token. */
2254
2477
  access_token?: string;
2255
2478
  /** Data format for response. */
2256
- alt?: string;
2479
+ alt?: 'json' | 'media' | 'proto';
2257
2480
  /** JSONP */
2258
2481
  callback?: string;
2259
2482
  /** Selector specifying which fields to include in a partial response. */
@@ -2280,11 +2503,11 @@ declare namespace gapi.client {
2280
2503
  /** Reports the status of dataflow WorkItems leased by a worker. */
2281
2504
  reportStatus(request: {
2282
2505
  /** V1 error format. */
2283
- '$.xgafv'?: string;
2506
+ '$.xgafv'?: '1' | '2';
2284
2507
  /** OAuth access token. */
2285
2508
  access_token?: string;
2286
2509
  /** Data format for response. */
2287
- alt?: string;
2510
+ alt?: 'json' | 'media' | 'proto';
2288
2511
  /** JSONP */
2289
2512
  callback?: string;
2290
2513
  /** Selector specifying which fields to include in a partial response. */
@@ -2311,11 +2534,11 @@ declare namespace gapi.client {
2311
2534
  reportStatus(
2312
2535
  request: {
2313
2536
  /** V1 error format. */
2314
- '$.xgafv'?: string;
2537
+ '$.xgafv'?: '1' | '2';
2315
2538
  /** OAuth access token. */
2316
2539
  access_token?: string;
2317
2540
  /** Data format for response. */
2318
- alt?: string;
2541
+ alt?: 'json' | 'media' | 'proto';
2319
2542
  /** JSONP */
2320
2543
  callback?: string;
2321
2544
  /** Selector specifying which fields to include in a partial response. */
@@ -2344,17 +2567,17 @@ declare namespace gapi.client {
2344
2567
  /** List the jobs of a project across all regions. **Note:** This method doesn't support filtering the list of jobs by name. */
2345
2568
  aggregated(request?: {
2346
2569
  /** V1 error format. */
2347
- '$.xgafv'?: string;
2570
+ '$.xgafv'?: '1' | '2';
2348
2571
  /** OAuth access token. */
2349
2572
  access_token?: string;
2350
2573
  /** Data format for response. */
2351
- alt?: string;
2574
+ alt?: 'json' | 'media' | 'proto';
2352
2575
  /** JSONP */
2353
2576
  callback?: string;
2354
2577
  /** Selector specifying which fields to include in a partial response. */
2355
2578
  fields?: string;
2356
2579
  /** The kind of filter to use. */
2357
- filter?: string;
2580
+ filter?: 'UNKNOWN' | 'ALL' | 'TERMINATED' | 'ACTIVE';
2358
2581
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
2359
2582
  key?: string;
2360
2583
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job. */
@@ -2378,16 +2601,20 @@ declare namespace gapi.client {
2378
2601
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
2379
2602
  uploadType?: string;
2380
2603
  /** Deprecated. ListJobs always returns summaries now. Use GetJob for other JobViews. */
2381
- view?: string;
2604
+ view?:
2605
+ | 'JOB_VIEW_UNKNOWN'
2606
+ | 'JOB_VIEW_SUMMARY'
2607
+ | 'JOB_VIEW_ALL'
2608
+ | 'JOB_VIEW_DESCRIPTION';
2382
2609
  }): Request<ListJobsResponse>;
2383
2610
  /** Creates a Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API. */
2384
2611
  create(request: {
2385
2612
  /** V1 error format. */
2386
- '$.xgafv'?: string;
2613
+ '$.xgafv'?: '1' | '2';
2387
2614
  /** OAuth access token. */
2388
2615
  access_token?: string;
2389
2616
  /** Data format for response. */
2390
- alt?: string;
2617
+ alt?: 'json' | 'media' | 'proto';
2391
2618
  /** JSONP */
2392
2619
  callback?: string;
2393
2620
  /** Selector specifying which fields to include in a partial response. */
@@ -2411,18 +2638,22 @@ declare namespace gapi.client {
2411
2638
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
2412
2639
  uploadType?: string;
2413
2640
  /** The level of information requested in response. */
2414
- view?: string;
2641
+ view?:
2642
+ | 'JOB_VIEW_UNKNOWN'
2643
+ | 'JOB_VIEW_SUMMARY'
2644
+ | 'JOB_VIEW_ALL'
2645
+ | 'JOB_VIEW_DESCRIPTION';
2415
2646
  /** Request body */
2416
2647
  resource: Job;
2417
2648
  }): Request<Job>;
2418
2649
  create(
2419
2650
  request: {
2420
2651
  /** V1 error format. */
2421
- '$.xgafv'?: string;
2652
+ '$.xgafv'?: '1' | '2';
2422
2653
  /** OAuth access token. */
2423
2654
  access_token?: string;
2424
2655
  /** Data format for response. */
2425
- alt?: string;
2656
+ alt?: 'json' | 'media' | 'proto';
2426
2657
  /** JSONP */
2427
2658
  callback?: string;
2428
2659
  /** Selector specifying which fields to include in a partial response. */
@@ -2446,18 +2677,22 @@ declare namespace gapi.client {
2446
2677
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
2447
2678
  uploadType?: string;
2448
2679
  /** The level of information requested in response. */
2449
- view?: string;
2680
+ view?:
2681
+ | 'JOB_VIEW_UNKNOWN'
2682
+ | 'JOB_VIEW_SUMMARY'
2683
+ | 'JOB_VIEW_ALL'
2684
+ | 'JOB_VIEW_DESCRIPTION';
2450
2685
  },
2451
2686
  body: Job,
2452
2687
  ): Request<Job>;
2453
2688
  /** Gets the state of the specified Cloud Dataflow job. To get the state of a job, we recommend using `projects.locations.jobs.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.get` is not recommended, as you can only get the state of jobs that are running in `us-central1`. */
2454
2689
  get(request?: {
2455
2690
  /** V1 error format. */
2456
- '$.xgafv'?: string;
2691
+ '$.xgafv'?: '1' | '2';
2457
2692
  /** OAuth access token. */
2458
2693
  access_token?: string;
2459
2694
  /** Data format for response. */
2460
- alt?: string;
2695
+ alt?: 'json' | 'media' | 'proto';
2461
2696
  /** JSONP */
2462
2697
  callback?: string;
2463
2698
  /** Selector specifying which fields to include in a partial response. */
@@ -2481,16 +2716,20 @@ declare namespace gapi.client {
2481
2716
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
2482
2717
  uploadType?: string;
2483
2718
  /** The level of information requested in response. */
2484
- view?: string;
2719
+ view?:
2720
+ | 'JOB_VIEW_UNKNOWN'
2721
+ | 'JOB_VIEW_SUMMARY'
2722
+ | 'JOB_VIEW_ALL'
2723
+ | 'JOB_VIEW_DESCRIPTION';
2485
2724
  }): Request<Job>;
2486
2725
  /** Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.getMetrics` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.getMetrics` is not recommended, as you can only request the status of jobs that are running in `us-central1`. */
2487
2726
  getMetrics(request?: {
2488
2727
  /** V1 error format. */
2489
- '$.xgafv'?: string;
2728
+ '$.xgafv'?: '1' | '2';
2490
2729
  /** OAuth access token. */
2491
2730
  access_token?: string;
2492
2731
  /** Data format for response. */
2493
- alt?: string;
2732
+ alt?: 'json' | 'media' | 'proto';
2494
2733
  /** JSONP */
2495
2734
  callback?: string;
2496
2735
  /** Selector specifying which fields to include in a partial response. */
@@ -2519,17 +2758,17 @@ declare namespace gapi.client {
2519
2758
  /** List the jobs of a project. To list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, because you can only get the list of jobs that are running in `us-central1`. `projects.locations.jobs.list` and `projects.jobs.list` support filtering the list of jobs by name. Filtering by name isn't supported by `projects.jobs.aggregated`. */
2520
2759
  list(request?: {
2521
2760
  /** V1 error format. */
2522
- '$.xgafv'?: string;
2761
+ '$.xgafv'?: '1' | '2';
2523
2762
  /** OAuth access token. */
2524
2763
  access_token?: string;
2525
2764
  /** Data format for response. */
2526
- alt?: string;
2765
+ alt?: 'json' | 'media' | 'proto';
2527
2766
  /** JSONP */
2528
2767
  callback?: string;
2529
2768
  /** Selector specifying which fields to include in a partial response. */
2530
2769
  fields?: string;
2531
2770
  /** The kind of filter to use. */
2532
- filter?: string;
2771
+ filter?: 'UNKNOWN' | 'ALL' | 'TERMINATED' | 'ACTIVE';
2533
2772
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
2534
2773
  key?: string;
2535
2774
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job. */
@@ -2553,16 +2792,20 @@ declare namespace gapi.client {
2553
2792
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
2554
2793
  uploadType?: string;
2555
2794
  /** Deprecated. ListJobs always returns summaries now. Use GetJob for other JobViews. */
2556
- view?: string;
2795
+ view?:
2796
+ | 'JOB_VIEW_UNKNOWN'
2797
+ | 'JOB_VIEW_SUMMARY'
2798
+ | 'JOB_VIEW_ALL'
2799
+ | 'JOB_VIEW_DESCRIPTION';
2557
2800
  }): Request<ListJobsResponse>;
2558
2801
  /** Snapshot the state of a streaming job. */
2559
2802
  snapshot(request: {
2560
2803
  /** V1 error format. */
2561
- '$.xgafv'?: string;
2804
+ '$.xgafv'?: '1' | '2';
2562
2805
  /** OAuth access token. */
2563
2806
  access_token?: string;
2564
2807
  /** Data format for response. */
2565
- alt?: string;
2808
+ alt?: 'json' | 'media' | 'proto';
2566
2809
  /** JSONP */
2567
2810
  callback?: string;
2568
2811
  /** Selector specifying which fields to include in a partial response. */
@@ -2589,11 +2832,11 @@ declare namespace gapi.client {
2589
2832
  snapshot(
2590
2833
  request: {
2591
2834
  /** V1 error format. */
2592
- '$.xgafv'?: string;
2835
+ '$.xgafv'?: '1' | '2';
2593
2836
  /** OAuth access token. */
2594
2837
  access_token?: string;
2595
2838
  /** Data format for response. */
2596
- alt?: string;
2839
+ alt?: 'json' | 'media' | 'proto';
2597
2840
  /** JSONP */
2598
2841
  callback?: string;
2599
2842
  /** Selector specifying which fields to include in a partial response. */
@@ -2620,11 +2863,11 @@ declare namespace gapi.client {
2620
2863
  /** Updates the state of an existing Cloud Dataflow job. To update the state of an existing job, we recommend using `projects.locations.jobs.update` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.update` is not recommended, as you can only update the state of jobs that are running in `us-central1`. */
2621
2864
  update(request: {
2622
2865
  /** V1 error format. */
2623
- '$.xgafv'?: string;
2866
+ '$.xgafv'?: '1' | '2';
2624
2867
  /** OAuth access token. */
2625
2868
  access_token?: string;
2626
2869
  /** Data format for response. */
2627
- alt?: string;
2870
+ alt?: 'json' | 'media' | 'proto';
2628
2871
  /** JSONP */
2629
2872
  callback?: string;
2630
2873
  /** Selector specifying which fields to include in a partial response. */
@@ -2655,11 +2898,11 @@ declare namespace gapi.client {
2655
2898
  update(
2656
2899
  request: {
2657
2900
  /** V1 error format. */
2658
- '$.xgafv'?: string;
2901
+ '$.xgafv'?: '1' | '2';
2659
2902
  /** OAuth access token. */
2660
2903
  access_token?: string;
2661
2904
  /** Data format for response. */
2662
- alt?: string;
2905
+ alt?: 'json' | 'media' | 'proto';
2663
2906
  /** JSONP */
2664
2907
  callback?: string;
2665
2908
  /** Selector specifying which fields to include in a partial response. */
@@ -2695,11 +2938,11 @@ declare namespace gapi.client {
2695
2938
  /** Launch a job with a FlexTemplate. */
2696
2939
  launch(request: {
2697
2940
  /** V1 error format. */
2698
- '$.xgafv'?: string;
2941
+ '$.xgafv'?: '1' | '2';
2699
2942
  /** OAuth access token. */
2700
2943
  access_token?: string;
2701
2944
  /** Data format for response. */
2702
- alt?: string;
2945
+ alt?: 'json' | 'media' | 'proto';
2703
2946
  /** JSONP */
2704
2947
  callback?: string;
2705
2948
  /** Selector specifying which fields to include in a partial response. */
@@ -2726,11 +2969,11 @@ declare namespace gapi.client {
2726
2969
  launch(
2727
2970
  request: {
2728
2971
  /** V1 error format. */
2729
- '$.xgafv'?: string;
2972
+ '$.xgafv'?: '1' | '2';
2730
2973
  /** OAuth access token. */
2731
2974
  access_token?: string;
2732
2975
  /** Data format for response. */
2733
- alt?: string;
2976
+ alt?: 'json' | 'media' | 'proto';
2734
2977
  /** JSONP */
2735
2978
  callback?: string;
2736
2979
  /** Selector specifying which fields to include in a partial response. */
@@ -2759,11 +3002,11 @@ declare namespace gapi.client {
2759
3002
  /** Get encoded debug configuration for component. Not cacheable. */
2760
3003
  getConfig(request: {
2761
3004
  /** V1 error format. */
2762
- '$.xgafv'?: string;
3005
+ '$.xgafv'?: '1' | '2';
2763
3006
  /** OAuth access token. */
2764
3007
  access_token?: string;
2765
3008
  /** Data format for response. */
2766
- alt?: string;
3009
+ alt?: 'json' | 'media' | 'proto';
2767
3010
  /** JSONP */
2768
3011
  callback?: string;
2769
3012
  /** Selector specifying which fields to include in a partial response. */
@@ -2792,11 +3035,11 @@ declare namespace gapi.client {
2792
3035
  getConfig(
2793
3036
  request: {
2794
3037
  /** V1 error format. */
2795
- '$.xgafv'?: string;
3038
+ '$.xgafv'?: '1' | '2';
2796
3039
  /** OAuth access token. */
2797
3040
  access_token?: string;
2798
3041
  /** Data format for response. */
2799
- alt?: string;
3042
+ alt?: 'json' | 'media' | 'proto';
2800
3043
  /** JSONP */
2801
3044
  callback?: string;
2802
3045
  /** Selector specifying which fields to include in a partial response. */
@@ -2825,11 +3068,11 @@ declare namespace gapi.client {
2825
3068
  /** Get worker stacktraces from debug capture. */
2826
3069
  getWorkerStacktraces(request: {
2827
3070
  /** V1 error format. */
2828
- '$.xgafv'?: string;
3071
+ '$.xgafv'?: '1' | '2';
2829
3072
  /** OAuth access token. */
2830
3073
  access_token?: string;
2831
3074
  /** Data format for response. */
2832
- alt?: string;
3075
+ alt?: 'json' | 'media' | 'proto';
2833
3076
  /** JSONP */
2834
3077
  callback?: string;
2835
3078
  /** Selector specifying which fields to include in a partial response. */
@@ -2858,11 +3101,11 @@ declare namespace gapi.client {
2858
3101
  getWorkerStacktraces(
2859
3102
  request: {
2860
3103
  /** V1 error format. */
2861
- '$.xgafv'?: string;
3104
+ '$.xgafv'?: '1' | '2';
2862
3105
  /** OAuth access token. */
2863
3106
  access_token?: string;
2864
3107
  /** Data format for response. */
2865
- alt?: string;
3108
+ alt?: 'json' | 'media' | 'proto';
2866
3109
  /** JSONP */
2867
3110
  callback?: string;
2868
3111
  /** Selector specifying which fields to include in a partial response. */
@@ -2891,11 +3134,11 @@ declare namespace gapi.client {
2891
3134
  /** Send encoded debug capture data for component. */
2892
3135
  sendCapture(request: {
2893
3136
  /** V1 error format. */
2894
- '$.xgafv'?: string;
3137
+ '$.xgafv'?: '1' | '2';
2895
3138
  /** OAuth access token. */
2896
3139
  access_token?: string;
2897
3140
  /** Data format for response. */
2898
- alt?: string;
3141
+ alt?: 'json' | 'media' | 'proto';
2899
3142
  /** JSONP */
2900
3143
  callback?: string;
2901
3144
  /** Selector specifying which fields to include in a partial response. */
@@ -2924,11 +3167,11 @@ declare namespace gapi.client {
2924
3167
  sendCapture(
2925
3168
  request: {
2926
3169
  /** V1 error format. */
2927
- '$.xgafv'?: string;
3170
+ '$.xgafv'?: '1' | '2';
2928
3171
  /** OAuth access token. */
2929
3172
  access_token?: string;
2930
3173
  /** Data format for response. */
2931
- alt?: string;
3174
+ alt?: 'json' | 'media' | 'proto';
2932
3175
  /** JSONP */
2933
3176
  callback?: string;
2934
3177
  /** Selector specifying which fields to include in a partial response. */
@@ -2959,11 +3202,11 @@ declare namespace gapi.client {
2959
3202
  /** Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`. */
2960
3203
  list(request?: {
2961
3204
  /** V1 error format. */
2962
- '$.xgafv'?: string;
3205
+ '$.xgafv'?: '1' | '2';
2963
3206
  /** OAuth access token. */
2964
3207
  access_token?: string;
2965
3208
  /** Data format for response. */
2966
- alt?: string;
3209
+ alt?: 'json' | 'media' | 'proto';
2967
3210
  /** JSONP */
2968
3211
  callback?: string;
2969
3212
  /** Return only messages with timestamps < end_time. The default is now (i.e. return up to the latest messages available). */
@@ -2977,7 +3220,13 @@ declare namespace gapi.client {
2977
3220
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the job specified by job_id. */
2978
3221
  location: string;
2979
3222
  /** Filter to only get messages with importance >= level */
2980
- minimumImportance?: string;
3223
+ minimumImportance?:
3224
+ | 'JOB_MESSAGE_IMPORTANCE_UNKNOWN'
3225
+ | 'JOB_MESSAGE_DEBUG'
3226
+ | 'JOB_MESSAGE_DETAILED'
3227
+ | 'JOB_MESSAGE_BASIC'
3228
+ | 'JOB_MESSAGE_WARNING'
3229
+ | 'JOB_MESSAGE_ERROR';
2981
3230
  /** OAuth 2.0 token for the current user. */
2982
3231
  oauth_token?: string;
2983
3232
  /** If specified, determines the maximum number of messages to return. If unspecified, the service may choose an appropriate default, or may return an arbitrarily large number of results. */
@@ -3002,11 +3251,11 @@ declare namespace gapi.client {
3002
3251
  /** Lists snapshots. */
3003
3252
  list(request?: {
3004
3253
  /** V1 error format. */
3005
- '$.xgafv'?: string;
3254
+ '$.xgafv'?: '1' | '2';
3006
3255
  /** OAuth access token. */
3007
3256
  access_token?: string;
3008
3257
  /** Data format for response. */
3009
- alt?: string;
3258
+ alt?: 'json' | 'media' | 'proto';
3010
3259
  /** JSONP */
3011
3260
  callback?: string;
3012
3261
  /** Selector specifying which fields to include in a partial response. */
@@ -3035,11 +3284,11 @@ declare namespace gapi.client {
3035
3284
  /** Request detailed information about the execution status of a stage of the job. EXPERIMENTAL. This API is subject to change or removal without notice. */
3036
3285
  getExecutionDetails(request?: {
3037
3286
  /** V1 error format. */
3038
- '$.xgafv'?: string;
3287
+ '$.xgafv'?: '1' | '2';
3039
3288
  /** OAuth access token. */
3040
3289
  access_token?: string;
3041
3290
  /** Data format for response. */
3042
- alt?: string;
3291
+ alt?: 'json' | 'media' | 'proto';
3043
3292
  /** JSONP */
3044
3293
  callback?: string;
3045
3294
  /** Upper time bound of work items to include, by start time. */
@@ -3078,11 +3327,11 @@ declare namespace gapi.client {
3078
3327
  /** Leases a dataflow WorkItem to run. */
3079
3328
  lease(request: {
3080
3329
  /** V1 error format. */
3081
- '$.xgafv'?: string;
3330
+ '$.xgafv'?: '1' | '2';
3082
3331
  /** OAuth access token. */
3083
3332
  access_token?: string;
3084
3333
  /** Data format for response. */
3085
- alt?: string;
3334
+ alt?: 'json' | 'media' | 'proto';
3086
3335
  /** JSONP */
3087
3336
  callback?: string;
3088
3337
  /** Selector specifying which fields to include in a partial response. */
@@ -3111,11 +3360,11 @@ declare namespace gapi.client {
3111
3360
  lease(
3112
3361
  request: {
3113
3362
  /** V1 error format. */
3114
- '$.xgafv'?: string;
3363
+ '$.xgafv'?: '1' | '2';
3115
3364
  /** OAuth access token. */
3116
3365
  access_token?: string;
3117
3366
  /** Data format for response. */
3118
- alt?: string;
3367
+ alt?: 'json' | 'media' | 'proto';
3119
3368
  /** JSONP */
3120
3369
  callback?: string;
3121
3370
  /** Selector specifying which fields to include in a partial response. */
@@ -3144,11 +3393,11 @@ declare namespace gapi.client {
3144
3393
  /** Reports the status of dataflow WorkItems leased by a worker. */
3145
3394
  reportStatus(request: {
3146
3395
  /** V1 error format. */
3147
- '$.xgafv'?: string;
3396
+ '$.xgafv'?: '1' | '2';
3148
3397
  /** OAuth access token. */
3149
3398
  access_token?: string;
3150
3399
  /** Data format for response. */
3151
- alt?: string;
3400
+ alt?: 'json' | 'media' | 'proto';
3152
3401
  /** JSONP */
3153
3402
  callback?: string;
3154
3403
  /** Selector specifying which fields to include in a partial response. */
@@ -3177,11 +3426,11 @@ declare namespace gapi.client {
3177
3426
  reportStatus(
3178
3427
  request: {
3179
3428
  /** V1 error format. */
3180
- '$.xgafv'?: string;
3429
+ '$.xgafv'?: '1' | '2';
3181
3430
  /** OAuth access token. */
3182
3431
  access_token?: string;
3183
3432
  /** Data format for response. */
3184
- alt?: string;
3433
+ alt?: 'json' | 'media' | 'proto';
3185
3434
  /** JSONP */
3186
3435
  callback?: string;
3187
3436
  /** Selector specifying which fields to include in a partial response. */
@@ -3212,11 +3461,11 @@ declare namespace gapi.client {
3212
3461
  /** Creates a Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API. */
3213
3462
  create(request: {
3214
3463
  /** V1 error format. */
3215
- '$.xgafv'?: string;
3464
+ '$.xgafv'?: '1' | '2';
3216
3465
  /** OAuth access token. */
3217
3466
  access_token?: string;
3218
3467
  /** Data format for response. */
3219
- alt?: string;
3468
+ alt?: 'json' | 'media' | 'proto';
3220
3469
  /** JSONP */
3221
3470
  callback?: string;
3222
3471
  /** Selector specifying which fields to include in a partial response. */
@@ -3240,18 +3489,22 @@ declare namespace gapi.client {
3240
3489
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3241
3490
  uploadType?: string;
3242
3491
  /** The level of information requested in response. */
3243
- view?: string;
3492
+ view?:
3493
+ | 'JOB_VIEW_UNKNOWN'
3494
+ | 'JOB_VIEW_SUMMARY'
3495
+ | 'JOB_VIEW_ALL'
3496
+ | 'JOB_VIEW_DESCRIPTION';
3244
3497
  /** Request body */
3245
3498
  resource: Job;
3246
3499
  }): Request<Job>;
3247
3500
  create(
3248
3501
  request: {
3249
3502
  /** V1 error format. */
3250
- '$.xgafv'?: string;
3503
+ '$.xgafv'?: '1' | '2';
3251
3504
  /** OAuth access token. */
3252
3505
  access_token?: string;
3253
3506
  /** Data format for response. */
3254
- alt?: string;
3507
+ alt?: 'json' | 'media' | 'proto';
3255
3508
  /** JSONP */
3256
3509
  callback?: string;
3257
3510
  /** Selector specifying which fields to include in a partial response. */
@@ -3275,18 +3528,22 @@ declare namespace gapi.client {
3275
3528
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3276
3529
  uploadType?: string;
3277
3530
  /** The level of information requested in response. */
3278
- view?: string;
3531
+ view?:
3532
+ | 'JOB_VIEW_UNKNOWN'
3533
+ | 'JOB_VIEW_SUMMARY'
3534
+ | 'JOB_VIEW_ALL'
3535
+ | 'JOB_VIEW_DESCRIPTION';
3279
3536
  },
3280
3537
  body: Job,
3281
3538
  ): Request<Job>;
3282
3539
  /** Gets the state of the specified Cloud Dataflow job. To get the state of a job, we recommend using `projects.locations.jobs.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.get` is not recommended, as you can only get the state of jobs that are running in `us-central1`. */
3283
3540
  get(request?: {
3284
3541
  /** V1 error format. */
3285
- '$.xgafv'?: string;
3542
+ '$.xgafv'?: '1' | '2';
3286
3543
  /** OAuth access token. */
3287
3544
  access_token?: string;
3288
3545
  /** Data format for response. */
3289
- alt?: string;
3546
+ alt?: 'json' | 'media' | 'proto';
3290
3547
  /** JSONP */
3291
3548
  callback?: string;
3292
3549
  /** Selector specifying which fields to include in a partial response. */
@@ -3310,16 +3567,20 @@ declare namespace gapi.client {
3310
3567
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3311
3568
  uploadType?: string;
3312
3569
  /** The level of information requested in response. */
3313
- view?: string;
3570
+ view?:
3571
+ | 'JOB_VIEW_UNKNOWN'
3572
+ | 'JOB_VIEW_SUMMARY'
3573
+ | 'JOB_VIEW_ALL'
3574
+ | 'JOB_VIEW_DESCRIPTION';
3314
3575
  }): Request<Job>;
3315
3576
  /** Request detailed information about the execution status of the job. EXPERIMENTAL. This API is subject to change or removal without notice. */
3316
3577
  getExecutionDetails(request?: {
3317
3578
  /** V1 error format. */
3318
- '$.xgafv'?: string;
3579
+ '$.xgafv'?: '1' | '2';
3319
3580
  /** OAuth access token. */
3320
3581
  access_token?: string;
3321
3582
  /** Data format for response. */
3322
- alt?: string;
3583
+ alt?: 'json' | 'media' | 'proto';
3323
3584
  /** JSONP */
3324
3585
  callback?: string;
3325
3586
  /** Selector specifying which fields to include in a partial response. */
@@ -3350,11 +3611,11 @@ declare namespace gapi.client {
3350
3611
  /** Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.getMetrics` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.getMetrics` is not recommended, as you can only request the status of jobs that are running in `us-central1`. */
3351
3612
  getMetrics(request?: {
3352
3613
  /** V1 error format. */
3353
- '$.xgafv'?: string;
3614
+ '$.xgafv'?: '1' | '2';
3354
3615
  /** OAuth access token. */
3355
3616
  access_token?: string;
3356
3617
  /** Data format for response. */
3357
- alt?: string;
3618
+ alt?: 'json' | 'media' | 'proto';
3358
3619
  /** JSONP */
3359
3620
  callback?: string;
3360
3621
  /** Selector specifying which fields to include in a partial response. */
@@ -3383,17 +3644,17 @@ declare namespace gapi.client {
3383
3644
  /** List the jobs of a project. To list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, because you can only get the list of jobs that are running in `us-central1`. `projects.locations.jobs.list` and `projects.jobs.list` support filtering the list of jobs by name. Filtering by name isn't supported by `projects.jobs.aggregated`. */
3384
3645
  list(request?: {
3385
3646
  /** V1 error format. */
3386
- '$.xgafv'?: string;
3647
+ '$.xgafv'?: '1' | '2';
3387
3648
  /** OAuth access token. */
3388
3649
  access_token?: string;
3389
3650
  /** Data format for response. */
3390
- alt?: string;
3651
+ alt?: 'json' | 'media' | 'proto';
3391
3652
  /** JSONP */
3392
3653
  callback?: string;
3393
3654
  /** Selector specifying which fields to include in a partial response. */
3394
3655
  fields?: string;
3395
3656
  /** The kind of filter to use. */
3396
- filter?: string;
3657
+ filter?: 'UNKNOWN' | 'ALL' | 'TERMINATED' | 'ACTIVE';
3397
3658
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
3398
3659
  key?: string;
3399
3660
  /** The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains this job. */
@@ -3417,16 +3678,20 @@ declare namespace gapi.client {
3417
3678
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3418
3679
  uploadType?: string;
3419
3680
  /** Deprecated. ListJobs always returns summaries now. Use GetJob for other JobViews. */
3420
- view?: string;
3681
+ view?:
3682
+ | 'JOB_VIEW_UNKNOWN'
3683
+ | 'JOB_VIEW_SUMMARY'
3684
+ | 'JOB_VIEW_ALL'
3685
+ | 'JOB_VIEW_DESCRIPTION';
3421
3686
  }): Request<ListJobsResponse>;
3422
3687
  /** Snapshot the state of a streaming job. */
3423
3688
  snapshot(request: {
3424
3689
  /** V1 error format. */
3425
- '$.xgafv'?: string;
3690
+ '$.xgafv'?: '1' | '2';
3426
3691
  /** OAuth access token. */
3427
3692
  access_token?: string;
3428
3693
  /** Data format for response. */
3429
- alt?: string;
3694
+ alt?: 'json' | 'media' | 'proto';
3430
3695
  /** JSONP */
3431
3696
  callback?: string;
3432
3697
  /** Selector specifying which fields to include in a partial response. */
@@ -3455,11 +3720,11 @@ declare namespace gapi.client {
3455
3720
  snapshot(
3456
3721
  request: {
3457
3722
  /** V1 error format. */
3458
- '$.xgafv'?: string;
3723
+ '$.xgafv'?: '1' | '2';
3459
3724
  /** OAuth access token. */
3460
3725
  access_token?: string;
3461
3726
  /** Data format for response. */
3462
- alt?: string;
3727
+ alt?: 'json' | 'media' | 'proto';
3463
3728
  /** JSONP */
3464
3729
  callback?: string;
3465
3730
  /** Selector specifying which fields to include in a partial response. */
@@ -3488,11 +3753,11 @@ declare namespace gapi.client {
3488
3753
  /** Updates the state of an existing Cloud Dataflow job. To update the state of an existing job, we recommend using `projects.locations.jobs.update` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.update` is not recommended, as you can only update the state of jobs that are running in `us-central1`. */
3489
3754
  update(request: {
3490
3755
  /** V1 error format. */
3491
- '$.xgafv'?: string;
3756
+ '$.xgafv'?: '1' | '2';
3492
3757
  /** OAuth access token. */
3493
3758
  access_token?: string;
3494
3759
  /** Data format for response. */
3495
- alt?: string;
3760
+ alt?: 'json' | 'media' | 'proto';
3496
3761
  /** JSONP */
3497
3762
  callback?: string;
3498
3763
  /** Selector specifying which fields to include in a partial response. */
@@ -3523,11 +3788,11 @@ declare namespace gapi.client {
3523
3788
  update(
3524
3789
  request: {
3525
3790
  /** V1 error format. */
3526
- '$.xgafv'?: string;
3791
+ '$.xgafv'?: '1' | '2';
3527
3792
  /** OAuth access token. */
3528
3793
  access_token?: string;
3529
3794
  /** Data format for response. */
3530
- alt?: string;
3795
+ alt?: 'json' | 'media' | 'proto';
3531
3796
  /** JSONP */
3532
3797
  callback?: string;
3533
3798
  /** Selector specifying which fields to include in a partial response. */
@@ -3565,11 +3830,11 @@ declare namespace gapi.client {
3565
3830
  /** Deletes a snapshot. */
3566
3831
  delete(request?: {
3567
3832
  /** V1 error format. */
3568
- '$.xgafv'?: string;
3833
+ '$.xgafv'?: '1' | '2';
3569
3834
  /** OAuth access token. */
3570
3835
  access_token?: string;
3571
3836
  /** Data format for response. */
3572
- alt?: string;
3837
+ alt?: 'json' | 'media' | 'proto';
3573
3838
  /** JSONP */
3574
3839
  callback?: string;
3575
3840
  /** Selector specifying which fields to include in a partial response. */
@@ -3596,11 +3861,11 @@ declare namespace gapi.client {
3596
3861
  /** Gets information about a snapshot. */
3597
3862
  get(request?: {
3598
3863
  /** V1 error format. */
3599
- '$.xgafv'?: string;
3864
+ '$.xgafv'?: '1' | '2';
3600
3865
  /** OAuth access token. */
3601
3866
  access_token?: string;
3602
3867
  /** Data format for response. */
3603
- alt?: string;
3868
+ alt?: 'json' | 'media' | 'proto';
3604
3869
  /** JSONP */
3605
3870
  callback?: string;
3606
3871
  /** Selector specifying which fields to include in a partial response. */
@@ -3627,11 +3892,11 @@ declare namespace gapi.client {
3627
3892
  /** Lists snapshots. */
3628
3893
  list(request?: {
3629
3894
  /** V1 error format. */
3630
- '$.xgafv'?: string;
3895
+ '$.xgafv'?: '1' | '2';
3631
3896
  /** OAuth access token. */
3632
3897
  access_token?: string;
3633
3898
  /** Data format for response. */
3634
- alt?: string;
3899
+ alt?: 'json' | 'media' | 'proto';
3635
3900
  /** JSONP */
3636
3901
  callback?: string;
3637
3902
  /** Selector specifying which fields to include in a partial response. */
@@ -3660,11 +3925,11 @@ declare namespace gapi.client {
3660
3925
  /** Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`. */
3661
3926
  create(request: {
3662
3927
  /** V1 error format. */
3663
- '$.xgafv'?: string;
3928
+ '$.xgafv'?: '1' | '2';
3664
3929
  /** OAuth access token. */
3665
3930
  access_token?: string;
3666
3931
  /** Data format for response. */
3667
- alt?: string;
3932
+ alt?: 'json' | 'media' | 'proto';
3668
3933
  /** JSONP */
3669
3934
  callback?: string;
3670
3935
  /** Selector specifying which fields to include in a partial response. */
@@ -3691,11 +3956,11 @@ declare namespace gapi.client {
3691
3956
  create(
3692
3957
  request: {
3693
3958
  /** V1 error format. */
3694
- '$.xgafv'?: string;
3959
+ '$.xgafv'?: '1' | '2';
3695
3960
  /** OAuth access token. */
3696
3961
  access_token?: string;
3697
3962
  /** Data format for response. */
3698
- alt?: string;
3963
+ alt?: 'json' | 'media' | 'proto';
3699
3964
  /** JSONP */
3700
3965
  callback?: string;
3701
3966
  /** Selector specifying which fields to include in a partial response. */
@@ -3722,11 +3987,11 @@ declare namespace gapi.client {
3722
3987
  /** Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved. */
3723
3988
  get(request?: {
3724
3989
  /** V1 error format. */
3725
- '$.xgafv'?: string;
3990
+ '$.xgafv'?: '1' | '2';
3726
3991
  /** OAuth access token. */
3727
3992
  access_token?: string;
3728
3993
  /** Data format for response. */
3729
- alt?: string;
3994
+ alt?: 'json' | 'media' | 'proto';
3730
3995
  /** JSONP */
3731
3996
  callback?: string;
3732
3997
  /** Selector specifying which fields to include in a partial response. */
@@ -3750,16 +4015,16 @@ declare namespace gapi.client {
3750
4015
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3751
4016
  uploadType?: string;
3752
4017
  /** The view to retrieve. Defaults to METADATA_ONLY. */
3753
- view?: string;
4018
+ view?: 'METADATA_ONLY';
3754
4019
  }): Request<GetTemplateResponse>;
3755
4020
  /** Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`. */
3756
4021
  launch(request: {
3757
4022
  /** V1 error format. */
3758
- '$.xgafv'?: string;
4023
+ '$.xgafv'?: '1' | '2';
3759
4024
  /** OAuth access token. */
3760
4025
  access_token?: string;
3761
4026
  /** Data format for response. */
3762
- alt?: string;
4027
+ alt?: 'json' | 'media' | 'proto';
3763
4028
  /** JSONP */
3764
4029
  callback?: string;
3765
4030
  /** Path to the dynamic template specification file on Cloud Storage. The file must be a JSON serialized `DynamicTemplateFileSpec` object. */
@@ -3794,11 +4059,11 @@ declare namespace gapi.client {
3794
4059
  launch(
3795
4060
  request: {
3796
4061
  /** V1 error format. */
3797
- '$.xgafv'?: string;
4062
+ '$.xgafv'?: '1' | '2';
3798
4063
  /** OAuth access token. */
3799
4064
  access_token?: string;
3800
4065
  /** Data format for response. */
3801
- alt?: string;
4066
+ alt?: 'json' | 'media' | 'proto';
3802
4067
  /** JSONP */
3803
4068
  callback?: string;
3804
4069
  /** Path to the dynamic template specification file on Cloud Storage. The file must be a JSON serialized `DynamicTemplateFileSpec` object. */
@@ -3835,11 +4100,11 @@ declare namespace gapi.client {
3835
4100
  /** Send a worker_message to the service. */
3836
4101
  workerMessages(request: {
3837
4102
  /** V1 error format. */
3838
- '$.xgafv'?: string;
4103
+ '$.xgafv'?: '1' | '2';
3839
4104
  /** OAuth access token. */
3840
4105
  access_token?: string;
3841
4106
  /** Data format for response. */
3842
- alt?: string;
4107
+ alt?: 'json' | 'media' | 'proto';
3843
4108
  /** JSONP */
3844
4109
  callback?: string;
3845
4110
  /** Selector specifying which fields to include in a partial response. */
@@ -3866,11 +4131,11 @@ declare namespace gapi.client {
3866
4131
  workerMessages(
3867
4132
  request: {
3868
4133
  /** V1 error format. */
3869
- '$.xgafv'?: string;
4134
+ '$.xgafv'?: '1' | '2';
3870
4135
  /** OAuth access token. */
3871
4136
  access_token?: string;
3872
4137
  /** Data format for response. */
3873
- alt?: string;
4138
+ alt?: 'json' | 'media' | 'proto';
3874
4139
  /** JSONP */
3875
4140
  callback?: string;
3876
4141
  /** Selector specifying which fields to include in a partial response. */
@@ -3903,11 +4168,11 @@ declare namespace gapi.client {
3903
4168
  /** Gets information about a snapshot. */
3904
4169
  get(request?: {
3905
4170
  /** V1 error format. */
3906
- '$.xgafv'?: string;
4171
+ '$.xgafv'?: '1' | '2';
3907
4172
  /** OAuth access token. */
3908
4173
  access_token?: string;
3909
4174
  /** Data format for response. */
3910
- alt?: string;
4175
+ alt?: 'json' | 'media' | 'proto';
3911
4176
  /** JSONP */
3912
4177
  callback?: string;
3913
4178
  /** Selector specifying which fields to include in a partial response. */
@@ -3934,11 +4199,11 @@ declare namespace gapi.client {
3934
4199
  /** Lists snapshots. */
3935
4200
  list(request?: {
3936
4201
  /** V1 error format. */
3937
- '$.xgafv'?: string;
4202
+ '$.xgafv'?: '1' | '2';
3938
4203
  /** OAuth access token. */
3939
4204
  access_token?: string;
3940
4205
  /** Data format for response. */
3941
- alt?: string;
4206
+ alt?: 'json' | 'media' | 'proto';
3942
4207
  /** JSONP */
3943
4208
  callback?: string;
3944
4209
  /** Selector specifying which fields to include in a partial response. */
@@ -3967,11 +4232,11 @@ declare namespace gapi.client {
3967
4232
  /** Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`. */
3968
4233
  create(request: {
3969
4234
  /** V1 error format. */
3970
- '$.xgafv'?: string;
4235
+ '$.xgafv'?: '1' | '2';
3971
4236
  /** OAuth access token. */
3972
4237
  access_token?: string;
3973
4238
  /** Data format for response. */
3974
- alt?: string;
4239
+ alt?: 'json' | 'media' | 'proto';
3975
4240
  /** JSONP */
3976
4241
  callback?: string;
3977
4242
  /** Selector specifying which fields to include in a partial response. */
@@ -3996,11 +4261,11 @@ declare namespace gapi.client {
3996
4261
  create(
3997
4262
  request: {
3998
4263
  /** V1 error format. */
3999
- '$.xgafv'?: string;
4264
+ '$.xgafv'?: '1' | '2';
4000
4265
  /** OAuth access token. */
4001
4266
  access_token?: string;
4002
4267
  /** Data format for response. */
4003
- alt?: string;
4268
+ alt?: 'json' | 'media' | 'proto';
4004
4269
  /** JSONP */
4005
4270
  callback?: string;
4006
4271
  /** Selector specifying which fields to include in a partial response. */
@@ -4025,11 +4290,11 @@ declare namespace gapi.client {
4025
4290
  /** Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved. */
4026
4291
  get(request?: {
4027
4292
  /** V1 error format. */
4028
- '$.xgafv'?: string;
4293
+ '$.xgafv'?: '1' | '2';
4029
4294
  /** OAuth access token. */
4030
4295
  access_token?: string;
4031
4296
  /** Data format for response. */
4032
- alt?: string;
4297
+ alt?: 'json' | 'media' | 'proto';
4033
4298
  /** JSONP */
4034
4299
  callback?: string;
4035
4300
  /** Selector specifying which fields to include in a partial response. */
@@ -4053,16 +4318,16 @@ declare namespace gapi.client {
4053
4318
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
4054
4319
  uploadType?: string;
4055
4320
  /** The view to retrieve. Defaults to METADATA_ONLY. */
4056
- view?: string;
4321
+ view?: 'METADATA_ONLY';
4057
4322
  }): Request<GetTemplateResponse>;
4058
4323
  /** Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`. */
4059
4324
  launch(request: {
4060
4325
  /** V1 error format. */
4061
- '$.xgafv'?: string;
4326
+ '$.xgafv'?: '1' | '2';
4062
4327
  /** OAuth access token. */
4063
4328
  access_token?: string;
4064
4329
  /** Data format for response. */
4065
- alt?: string;
4330
+ alt?: 'json' | 'media' | 'proto';
4066
4331
  /** JSONP */
4067
4332
  callback?: string;
4068
4333
  /** Path to the dynamic template specification file on Cloud Storage. The file must be a JSON serialized `DynamicTemplateFileSpec` object. */
@@ -4097,11 +4362,11 @@ declare namespace gapi.client {
4097
4362
  launch(
4098
4363
  request: {
4099
4364
  /** V1 error format. */
4100
- '$.xgafv'?: string;
4365
+ '$.xgafv'?: '1' | '2';
4101
4366
  /** OAuth access token. */
4102
4367
  access_token?: string;
4103
4368
  /** Data format for response. */
4104
- alt?: string;
4369
+ alt?: 'json' | 'media' | 'proto';
4105
4370
  /** JSONP */
4106
4371
  callback?: string;
4107
4372
  /** Path to the dynamic template specification file on Cloud Storage. The file must be a JSON serialized `DynamicTemplateFileSpec` object. */
@@ -4138,11 +4403,11 @@ declare namespace gapi.client {
4138
4403
  /** Deletes a snapshot. */
4139
4404
  deleteSnapshots(request?: {
4140
4405
  /** V1 error format. */
4141
- '$.xgafv'?: string;
4406
+ '$.xgafv'?: '1' | '2';
4142
4407
  /** OAuth access token. */
4143
4408
  access_token?: string;
4144
4409
  /** Data format for response. */
4145
- alt?: string;
4410
+ alt?: 'json' | 'media' | 'proto';
4146
4411
  /** JSONP */
4147
4412
  callback?: string;
4148
4413
  /** Selector specifying which fields to include in a partial response. */
@@ -4169,11 +4434,11 @@ declare namespace gapi.client {
4169
4434
  /** Send a worker_message to the service. */
4170
4435
  workerMessages(request: {
4171
4436
  /** V1 error format. */
4172
- '$.xgafv'?: string;
4437
+ '$.xgafv'?: '1' | '2';
4173
4438
  /** OAuth access token. */
4174
4439
  access_token?: string;
4175
4440
  /** Data format for response. */
4176
- alt?: string;
4441
+ alt?: 'json' | 'media' | 'proto';
4177
4442
  /** JSONP */
4178
4443
  callback?: string;
4179
4444
  /** Selector specifying which fields to include in a partial response. */
@@ -4198,11 +4463,11 @@ declare namespace gapi.client {
4198
4463
  workerMessages(
4199
4464
  request: {
4200
4465
  /** V1 error format. */
4201
- '$.xgafv'?: string;
4466
+ '$.xgafv'?: '1' | '2';
4202
4467
  /** OAuth access token. */
4203
4468
  access_token?: string;
4204
4469
  /** Data format for response. */
4205
- alt?: string;
4470
+ alt?: 'json' | 'media' | 'proto';
4206
4471
  /** JSONP */
4207
4472
  callback?: string;
4208
4473
  /** Selector specifying which fields to include in a partial response. */