Skip to content

Commit ac90f1e

Browse files
feat(dataflow): update the api
#### dataflow:v1b3 The following keys were added: - schemas.FlexTemplateRuntimeEnvironment.properties.streamingMode.type (Total Keys: 1) - schemas.RuntimeEnvironment.properties.streamingMode.type (Total Keys: 1) - schemas.StreamingScalingReport.properties.activeBundleCount.deprecated (Total Keys: 1) - schemas.StreamingScalingReport.properties.maximumBytes (Total Keys: 3) - schemas.StreamingScalingReport.properties.outstandingBundleCount (Total Keys: 2) - schemas.StreamingScalingReport.properties.outstandingBytes (Total Keys: 3)
1 parent a23804b commit ac90f1e

6 files changed

+68
-13
lines changed

docs/dyn/dataflow_v1b3.projects.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -195,12 +195,15 @@ <h3>Method Details</h3>
195195
],
196196
},
197197
&quot;streamingScalingReport&quot;: { # Contains per-user worker telemetry used in streaming autoscaling. # Contains per-user worker telemetry used in streaming autoscaling.
198-
&quot;activeBundleCount&quot;: 42, # Current acive bundle count.
198+
&quot;activeBundleCount&quot;: 42,
199199
&quot;activeThreadCount&quot;: 42, # Current acive thread count.
200-
&quot;maximumBundleCount&quot;: 42, # Maximum bundle count limit.
201-
&quot;maximumBytesCount&quot;: 42, # Maximum bytes count limit.
200+
&quot;maximumBundleCount&quot;: 42, # Maximum bundle count.
201+
&quot;maximumBytes&quot;: &quot;A String&quot;, # Maximum bytes.
202+
&quot;maximumBytesCount&quot;: 42,
202203
&quot;maximumThreadCount&quot;: 42, # Maximum thread count limit.
203-
&quot;outstandingBytesCount&quot;: 42, # Current outstanding bytes count.
204+
&quot;outstandingBundleCount&quot;: 42, # Current outstanding bundle count.
205+
&quot;outstandingBytes&quot;: &quot;A String&quot;, # Current outstanding bytes.
206+
&quot;outstandingBytesCount&quot;: 42,
204207
},
205208
&quot;time&quot;: &quot;A String&quot;, # The timestamp of the worker_message.
206209
&quot;workerHealthReport&quot;: { # WorkerHealthReport contains information about the health of a worker. The VM should be identified by the labels attached to the WorkerMessage that this health ping belongs to. # The health of a worker.

docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,7 @@ <h3>Method Details</h3>
123123
&quot;sdkContainerImage&quot;: &quot;A String&quot;, # Docker registry location of container image to use for the &#x27;worker harness. Default is the container for the version of the SDK. Note this field is only valid for portable pipelines.
124124
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # The email address of the service account to run the job as.
125125
&quot;stagingLocation&quot;: &quot;A String&quot;, # The Cloud Storage path for staging local files. Must be a valid Cloud Storage URL, beginning with `gs://`.
126+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
126127
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
127128
&quot;tempLocation&quot;: &quot;A String&quot;, # The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
128129
&quot;workerRegion&quot;: &quot;A String&quot;, # The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.
@@ -195,6 +196,7 @@ <h3>Method Details</h3>
195196
&quot;sdkContainerImage&quot;: &quot;A String&quot;, # Docker registry location of container image to use for the &#x27;worker harness. Default is the container for the version of the SDK. Note this field is only valid for portable pipelines.
196197
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # The email address of the service account to run the job as.
197198
&quot;stagingLocation&quot;: &quot;A String&quot;, # The Cloud Storage path for staging local files. Must be a valid Cloud Storage URL, beginning with `gs://`.
199+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
198200
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
199201
&quot;tempLocation&quot;: &quot;A String&quot;, # The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
200202
&quot;workerRegion&quot;: &quot;A String&quot;, # The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.

docs/dyn/dataflow_v1b3.projects.locations.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -173,12 +173,15 @@ <h3>Method Details</h3>
173173
],
174174
},
175175
&quot;streamingScalingReport&quot;: { # Contains per-user worker telemetry used in streaming autoscaling. # Contains per-user worker telemetry used in streaming autoscaling.
176-
&quot;activeBundleCount&quot;: 42, # Current acive bundle count.
176+
&quot;activeBundleCount&quot;: 42,
177177
&quot;activeThreadCount&quot;: 42, # Current acive thread count.
178-
&quot;maximumBundleCount&quot;: 42, # Maximum bundle count limit.
179-
&quot;maximumBytesCount&quot;: 42, # Maximum bytes count limit.
178+
&quot;maximumBundleCount&quot;: 42, # Maximum bundle count.
179+
&quot;maximumBytes&quot;: &quot;A String&quot;, # Maximum bytes.
180+
&quot;maximumBytesCount&quot;: 42,
180181
&quot;maximumThreadCount&quot;: 42, # Maximum thread count limit.
181-
&quot;outstandingBytesCount&quot;: 42, # Current outstanding bytes count.
182+
&quot;outstandingBundleCount&quot;: 42, # Current outstanding bundle count.
183+
&quot;outstandingBytes&quot;: &quot;A String&quot;, # Current outstanding bytes.
184+
&quot;outstandingBytesCount&quot;: 42,
182185
},
183186
&quot;time&quot;: &quot;A String&quot;, # The timestamp of the worker_message.
184187
&quot;workerHealthReport&quot;: { # WorkerHealthReport contains information about the health of a worker. The VM should be identified by the labels attached to the WorkerMessage that this health ping belongs to. # The health of a worker.

docs/dyn/dataflow_v1b3.projects.locations.templates.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,7 @@ <h3>Method Details</h3>
120120
&quot;network&quot;: &quot;A String&quot;, # Optional. Network to which VMs will be assigned. If empty or unspecified, the service will use the network &quot;default&quot;.
121121
&quot;numWorkers&quot;: 42, # Optional. The initial number of Google Compute Engine instances for the job. The default value is 11.
122122
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # Optional. The email address of the service account to run the job as.
123+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
123124
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
124125
&quot;tempLocation&quot;: &quot;A String&quot;, # Required. The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
125126
&quot;workerRegion&quot;: &quot;A String&quot;, # Required. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.
@@ -594,6 +595,7 @@ <h3>Method Details</h3>
594595
&quot;network&quot;: &quot;A String&quot;, # Optional. Network to which VMs will be assigned. If empty or unspecified, the service will use the network &quot;default&quot;.
595596
&quot;numWorkers&quot;: 42, # Optional. The initial number of Google Compute Engine instances for the job. The default value is 11.
596597
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # Optional. The email address of the service account to run the job as.
598+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
597599
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
598600
&quot;tempLocation&quot;: &quot;A String&quot;, # Required. The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
599601
&quot;workerRegion&quot;: &quot;A String&quot;, # Required. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.

docs/dyn/dataflow_v1b3.projects.templates.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,7 @@ <h3>Method Details</h3>
119119
&quot;network&quot;: &quot;A String&quot;, # Optional. Network to which VMs will be assigned. If empty or unspecified, the service will use the network &quot;default&quot;.
120120
&quot;numWorkers&quot;: 42, # Optional. The initial number of Google Compute Engine instances for the job. The default value is 11.
121121
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # Optional. The email address of the service account to run the job as.
122+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
122123
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
123124
&quot;tempLocation&quot;: &quot;A String&quot;, # Required. The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
124125
&quot;workerRegion&quot;: &quot;A String&quot;, # Required. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.
@@ -592,6 +593,7 @@ <h3>Method Details</h3>
592593
&quot;network&quot;: &quot;A String&quot;, # Optional. Network to which VMs will be assigned. If empty or unspecified, the service will use the network &quot;default&quot;.
593594
&quot;numWorkers&quot;: 42, # Optional. The initial number of Google Compute Engine instances for the job. The default value is 11.
594595
&quot;serviceAccountEmail&quot;: &quot;A String&quot;, # Optional. The email address of the service account to run the job as.
596+
&quot;streamingMode&quot;: &quot;A String&quot;, # 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.
595597
&quot;subnetwork&quot;: &quot;A String&quot;, # 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 &quot;https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK&quot; or &quot;regions/REGION/subnetworks/SUBNETWORK&quot;. If the subnetwork is located in a Shared VPC network, you must use the complete URL.
596598
&quot;tempLocation&quot;: &quot;A String&quot;, # Required. The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with `gs://`.
597599
&quot;workerRegion&quot;: &quot;A String&quot;, # Required. The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. &quot;us-west1&quot;. Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane&#x27;s region.

googleapiclient/discovery_cache/documents/dataflow.v1b3.json

Lines changed: 48 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2221,7 +2221,7 @@
22212221
}
22222222
}
22232223
},
2224-
"revision": "20240107",
2224+
"revision": "20240113",
22252225
"rootUrl": "https://dataflow.googleapis.com/",
22262226
"schemas": {
22272227
"ApproximateProgress": {
@@ -3577,6 +3577,20 @@
35773577
"description": "The Cloud Storage path for staging local files. Must be a valid Cloud Storage URL, beginning with `gs://`.",
35783578
"type": "string"
35793579
},
3580+
"streamingMode": {
3581+
"description": "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.",
3582+
"enum": [
3583+
"STREAMING_MODE_UNSPECIFIED",
3584+
"STREAMING_MODE_EXACTLY_ONCE",
3585+
"STREAMING_MODE_AT_LEAST_ONCE"
3586+
],
3587+
"enumDescriptions": [
3588+
"Run in the default mode.",
3589+
"In this mode, message deduplication is performed against persistent state to make sure each message is processed and committed to storage exactly once.",
3590+
"Message deduplication is not performed. Messages might be processed multiple times, and the results are applied multiple times. Note: Setting this value also enables Streaming Engine and Streaming Engine resource-based billing."
3591+
],
3592+
"type": "string"
3593+
},
35803594
"subnetwork": {
35813595
"description": "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.",
35823596
"type": "string"
@@ -5504,6 +5518,20 @@
55045518
"description": "Optional. The email address of the service account to run the job as.",
55055519
"type": "string"
55065520
},
5521+
"streamingMode": {
5522+
"description": "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.",
5523+
"enum": [
5524+
"STREAMING_MODE_UNSPECIFIED",
5525+
"STREAMING_MODE_EXACTLY_ONCE",
5526+
"STREAMING_MODE_AT_LEAST_ONCE"
5527+
],
5528+
"enumDescriptions": [
5529+
"Run in the default mode.",
5530+
"In this mode, message deduplication is performed against persistent state to make sure each message is processed and committed to storage exactly once.",
5531+
"Message deduplication is not performed. Messages might be processed multiple times, and the results are applied multiple times. Note: Setting this value also enables Streaming Engine and Streaming Engine resource-based billing."
5532+
],
5533+
"type": "string"
5534+
},
55075535
"subnetwork": {
55085536
"description": "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.",
55095537
"type": "string"
@@ -6694,7 +6722,7 @@
66946722
"id": "StreamingScalingReport",
66956723
"properties": {
66966724
"activeBundleCount": {
6697-
"description": "Current acive bundle count.",
6725+
"deprecated": true,
66986726
"format": "int32",
66996727
"type": "integer"
67006728
},
@@ -6704,12 +6732,17 @@
67046732
"type": "integer"
67056733
},
67066734
"maximumBundleCount": {
6707-
"description": "Maximum bundle count limit.",
6735+
"description": "Maximum bundle count.",
67086736
"format": "int32",
67096737
"type": "integer"
67106738
},
6739+
"maximumBytes": {
6740+
"description": "Maximum bytes.",
6741+
"format": "int64",
6742+
"type": "string"
6743+
},
67116744
"maximumBytesCount": {
6712-
"description": "Maximum bytes count limit.",
6745+
"deprecated": true,
67136746
"format": "int32",
67146747
"type": "integer"
67156748
},
@@ -6718,8 +6751,18 @@
67186751
"format": "int32",
67196752
"type": "integer"
67206753
},
6754+
"outstandingBundleCount": {
6755+
"description": "Current outstanding bundle count.",
6756+
"format": "int32",
6757+
"type": "integer"
6758+
},
6759+
"outstandingBytes": {
6760+
"description": "Current outstanding bytes.",
6761+
"format": "int64",
6762+
"type": "string"
6763+
},
67216764
"outstandingBytesCount": {
6722-
"description": "Current outstanding bytes count.",
6765+
"deprecated": true,
67236766
"format": "int32",
67246767
"type": "integer"
67256768
}

0 commit comments

Comments
 (0)