Skip to content

Commit 9471242

Browse files
feat(datastream): update the api
#### datastream:v1 The following keys were added: - resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess (Total Keys: 2) - schemas.EventFilter (Total Keys: 3) - schemas.ListOperationsResponse.properties.unreachable (Total Keys: 2) - schemas.StartBackfillJobRequest.properties.eventFilter.$ref (Total Keys: 1) #### datastream:v1alpha1 The following keys were added: - resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess (Total Keys: 2) - schemas.ListOperationsResponse.properties.unreachable (Total Keys: 2)
1 parent 46ecc1b commit 9471242

File tree

6 files changed

+60
-9
lines changed

6 files changed

+60
-9
lines changed

docs/dyn/datastream_v1.projects.locations.operations.html

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
8787
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
8888
<p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
8989
<p class="toc_element">
90-
<code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
90+
<code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
9191
<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.</p>
9292
<p class="toc_element">
9393
<code><a href="#list_next">list_next()</a></code></p>
@@ -176,14 +176,15 @@ <h3>Method Details</h3>
176176
</div>
177177

178178
<div class="method">
179-
<code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
179+
<code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
180180
<pre>Lists operations that match the specified filter in the request. If the server doesn&#x27;t support this method, it returns `UNIMPLEMENTED`.
181181

182182
Args:
183183
name: string, The name of the operation&#x27;s parent resource. (required)
184184
filter: string, The standard list filter.
185185
pageSize: integer, The standard list page size.
186186
pageToken: string, The standard list page token.
187+
returnPartialSuccess: boolean, When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `&quot;projects/example/locations/-&quot;`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
187188
x__xgafv: string, V1 error format.
188189
Allowed values
189190
1 - v1 error format
@@ -215,6 +216,9 @@ <h3>Method Details</h3>
215216
},
216217
},
217218
],
219+
&quot;unreachable&quot;: [ # Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
220+
&quot;A String&quot;,
221+
],
218222
}</pre>
219223
</div>
220224

docs/dyn/datastream_v1.projects.locations.streams.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2318,7 +2318,7 @@ <h3>Method Details</h3>
23182318
},
23192319
&quot;specificStartPosition&quot;: { # CDC strategy to start replicating from a specific position in the source. # Optional. Start replicating from a specific position in the source.
23202320
&quot;mongodbChangeStreamPosition&quot;: { # MongoDB change stream position # MongoDB change stream position to start replicating from.
2321-
&quot;startTime&quot;: &quot;A String&quot;, # Required. The timestamp (in epoch seconds) to start change stream from.
2321+
&quot;startTime&quot;: &quot;A String&quot;, # Required. The timestamp to start change stream from.
23222322
},
23232323
&quot;mysqlGtidPosition&quot;: { # MySQL GTID position # MySQL GTID set to start replicating from.
23242324
&quot;gtidSet&quot;: &quot;A String&quot;, # Required. The gtid set to start replication from.

docs/dyn/datastream_v1.projects.locations.streams.objects.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -388,6 +388,9 @@ <h3>Method Details</h3>
388388
The object takes the form of:
389389

390390
{ # Request for manually initiating a backfill job for a specific stream object.
391+
&quot;eventFilter&quot;: { # Represents a filter for included data on a stream object. # Optional. Optional event filter. If not set, or empty, the backfill will be performed on the entire object. This is currently used for partial backfill and only supported for SQL Server sources.
392+
&quot;sqlWhereClause&quot;: &quot;A String&quot;, # An SQL-query Where clause selecting which data should be included, not including the &quot;WHERE&quot; keyword. E.g., &quot;t.key1 = &#x27;value1&#x27; AND t.key2 = &#x27;value2&#x27;&quot;.
393+
},
391394
}
392395

393396
x__xgafv: string, V1 error format.

docs/dyn/datastream_v1alpha1.projects.locations.operations.html

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
8787
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
8888
<p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
8989
<p class="toc_element">
90-
<code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
90+
<code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
9191
<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.</p>
9292
<p class="toc_element">
9393
<code><a href="#list_next">list_next()</a></code></p>
@@ -176,14 +176,15 @@ <h3>Method Details</h3>
176176
</div>
177177

178178
<div class="method">
179-
<code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
179+
<code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
180180
<pre>Lists operations that match the specified filter in the request. If the server doesn&#x27;t support this method, it returns `UNIMPLEMENTED`.
181181

182182
Args:
183183
name: string, The name of the operation&#x27;s parent resource. (required)
184184
filter: string, The standard list filter.
185185
pageSize: integer, The standard list page size.
186186
pageToken: string, The standard list page token.
187+
returnPartialSuccess: boolean, When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `&quot;projects/example/locations/-&quot;`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
187188
x__xgafv: string, V1 error format.
188189
Allowed values
189190
1 - v1 error format
@@ -215,6 +216,9 @@ <h3>Method Details</h3>
215216
},
216217
},
217218
],
219+
&quot;unreachable&quot;: [ # Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
220+
&quot;A String&quot;,
221+
],
218222
}</pre>
219223
</div>
220224

googleapiclient/discovery_cache/documents/datastream.v1.json

Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -560,6 +560,11 @@
560560
"description": "The standard list page token.",
561561
"location": "query",
562562
"type": "string"
563+
},
564+
"returnPartialSuccess": {
565+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
566+
"location": "query",
567+
"type": "boolean"
563568
}
564569
},
565570
"path": "v1/{+name}/operations",
@@ -1261,7 +1266,7 @@
12611266
}
12621267
}
12631268
},
1264-
"revision": "20250827",
1269+
"revision": "20251021",
12651270
"rootUrl": "https://datastream.googleapis.com/",
12661271
"schemas": {
12671272
"AppendOnly": {
@@ -1782,6 +1787,17 @@
17821787
},
17831788
"type": "object"
17841789
},
1790+
"EventFilter": {
1791+
"description": "Represents a filter for included data on a stream object.",
1792+
"id": "EventFilter",
1793+
"properties": {
1794+
"sqlWhereClause": {
1795+
"description": "An SQL-query Where clause selecting which data should be included, not including the \"WHERE\" keyword. E.g., \"t.key1 = 'value1' AND t.key2 = 'value2'\".",
1796+
"type": "string"
1797+
}
1798+
},
1799+
"type": "object"
1800+
},
17851801
"FetchStaticIpsResponse": {
17861802
"description": "Response message for a 'FetchStaticIps' response.",
17871803
"id": "FetchStaticIpsResponse",
@@ -1986,6 +2002,13 @@
19862002
"$ref": "Operation"
19872003
},
19882004
"type": "array"
2005+
},
2006+
"unreachable": {
2007+
"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
2008+
"items": {
2009+
"type": "string"
2010+
},
2011+
"type": "array"
19892012
}
19902013
},
19912014
"type": "object"
@@ -2160,7 +2183,7 @@
21602183
"id": "MongodbChangeStreamPosition",
21612184
"properties": {
21622185
"startTime": {
2163-
"description": "Required. The timestamp (in epoch seconds) to start change stream from.",
2186+
"description": "Required. The timestamp to start change stream from.",
21642187
"format": "google-datetime",
21652188
"type": "string"
21662189
}
@@ -3821,7 +3844,12 @@
38213844
"StartBackfillJobRequest": {
38223845
"description": "Request for manually initiating a backfill job for a specific stream object.",
38233846
"id": "StartBackfillJobRequest",
3824-
"properties": {},
3847+
"properties": {
3848+
"eventFilter": {
3849+
"$ref": "EventFilter",
3850+
"description": "Optional. Optional event filter. If not set, or empty, the backfill will be performed on the entire object. This is currently used for partial backfill and only supported for SQL Server sources."
3851+
}
3852+
},
38253853
"type": "object"
38263854
},
38273855
"StartBackfillJobResponse": {

googleapiclient/discovery_cache/documents/datastream.v1alpha1.json

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -553,6 +553,11 @@
553553
"description": "The standard list page token.",
554554
"location": "query",
555555
"type": "string"
556+
},
557+
"returnPartialSuccess": {
558+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
559+
"location": "query",
560+
"type": "boolean"
556561
}
557562
},
558563
"path": "v1alpha1/{+name}/operations",
@@ -1230,7 +1235,7 @@
12301235
}
12311236
}
12321237
},
1233-
"revision": "20250817",
1238+
"revision": "20251021",
12341239
"rootUrl": "https://datastream.googleapis.com/",
12351240
"schemas": {
12361241
"AvroFileFormat": {
@@ -1711,6 +1716,13 @@
17111716
"$ref": "Operation"
17121717
},
17131718
"type": "array"
1719+
},
1720+
"unreachable": {
1721+
"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
1722+
"items": {
1723+
"type": "string"
1724+
},
1725+
"type": "array"
17141726
}
17151727
},
17161728
"type": "object"

0 commit comments

Comments
 (0)