Skip to content

Commit 3bb1937

Browse files
yoshi-automationyoshi-automation
committed
feat(datapipelines): update the api
#### datapipelines:v1 The following keys were added: - resources.projects.resources.locations.resources.pipelines.resources.jobs.methods.list (Total Keys: 16) - schemas.GoogleCloudDatapipelinesV1ListJobsResponse (Total Keys: 5)
1 parent 91979d4 commit 3bb1937

File tree

3 files changed

+222
-1
lines changed

3 files changed

+222
-1
lines changed

‎docs/dyn/datapipelines_v1.projects.locations.pipelines.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,11 @@
7474

7575
<h1><a href="datapipelines_v1.html">Data pipelines API</a> . <a href="datapipelines_v1.projects.html">projects</a> . <a href="datapipelines_v1.projects.locations.html">locations</a> . <a href="datapipelines_v1.projects.locations.pipelines.html">pipelines</a></h1>
7676
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="datapipelines_v1.projects.locations.pipelines.jobs.html">jobs()</a></code>
79+
</p>
80+
<p class="firstline">Returns the jobs Resource.</p>
81+
7782
<p class="toc_element">
7883
<code><a href="#close">close()</a></code></p>
7984
<p class="firstline">Close httplib2 connections.</p>

‎docs/dyn/datapipelines_v1.projects.locations.pipelines.jobs.html

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="datapipelines_v1.html">Data pipelines API</a> . <a href="datapipelines_v1.projects.html">projects</a> . <a href="datapipelines_v1.projects.locations.html">locations</a> . <a href="datapipelines_v1.projects.locations.pipelines.html">pipelines</a> . <a href="datapipelines_v1.projects.locations.pipelines.jobs.html">jobs</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Lists jobs for a given pipeline. Throws a "FORBIDDEN" error if the caller doesn't have permission to access it.</p>
83+
<p class="toc_element">
84+
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85+
<p class="firstline">Retrieves the next page of results.</p>
86+
<h3>Method Details</h3>
87+
<div class="method">
88+
<code class="details" id="close">close()</code>
89+
<pre>Close httplib2 connections.</pre>
90+
</div>
91+
92+
<div class="method">
93+
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
94+
<pre>Lists jobs for a given pipeline. Throws a &quot;FORBIDDEN&quot; error if the caller doesn&#x27;t have permission to access it.
95+
96+
Args:
97+
parent: string, Required. The pipeline name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`. (required)
98+
pageSize: integer, The maximum number of entities to return. The service may return fewer than this value, even if there are additional pages. If unspecified, the max limit will be determined by the backend implementation.
99+
pageToken: string, A page token, received from a previous `ListJobs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListJobs` must match the call that provided the page token.
100+
x__xgafv: string, V1 error format.
101+
Allowed values
102+
1 - v1 error format
103+
2 - v2 error format
104+
105+
Returns:
106+
An object of the form:
107+
108+
{ # Response message for ListJobs
109+
&quot;jobs&quot;: [ # Results that were accessible to the caller. Results are always in descending order of job creation date.
110+
{ # Definition of the job information maintained by the pipeline. Fields in this entity are retrieved from the executor API (e.g. Dataflow API).
111+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time of job creation.
112+
&quot;dataflowJobDetails&quot;: { # Pipeline job details specific to the Dataflow API. This is encapsulated here to allow for more executors to store their specific details separately. # All the details that are specific to a Dataflow job.
113+
&quot;currentWorkers&quot;: 42, # Output only. The current number of workers used to run the jobs. Only set to a value if the job is still running.
114+
&quot;resourceInfo&quot;: { # Cached version of all the metrics of interest for the job. This value gets stored here when the job is terminated. As long as the job is running, this field is populated from the Dataflow API.
115+
&quot;a_key&quot;: 3.14,
116+
},
117+
&quot;sdkVersion&quot;: { # The version of the SDK used to run the job. # Output only. The SDK version used to run the job.
118+
&quot;sdkSupportStatus&quot;: &quot;A String&quot;, # The support status for this SDK version.
119+
&quot;version&quot;: &quot;A String&quot;, # The version of the SDK used to run the job.
120+
&quot;versionDisplayName&quot;: &quot;A String&quot;, # A readable string describing the version of the SDK.
121+
},
122+
},
123+
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time of job termination. This is absent if the job is still running.
124+
&quot;id&quot;: &quot;A String&quot;, # Output only. The internal ID for the job.
125+
&quot;name&quot;: &quot;A String&quot;, # Required. The fully qualified resource name for the job.
126+
&quot;state&quot;: &quot;A String&quot;, # The current state of the job.
127+
&quot;status&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Status capturing any error code or message related to job creation or execution.
128+
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
129+
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
130+
{
131+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
132+
},
133+
],
134+
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
135+
},
136+
},
137+
],
138+
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
139+
}</pre>
140+
</div>
141+
142+
<div class="method">
143+
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
144+
<pre>Retrieves the next page of results.
145+
146+
Args:
147+
previous_request: The request for the previous page. (required)
148+
previous_response: The response from the request for the previous page. (required)
149+
150+
Returns:
151+
A request object that you can call &#x27;execute()&#x27; on to request the next
152+
page. Returns None if there are no more items in the collection.
153+
</pre>
154+
</div>
155+
156+
</body></html>

‎googleapiclient/discovery_cache/documents/datapipelines.v1.json

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -322,14 +322,56 @@
322322
"https://www.googleapis.com/auth/cloud-platform"
323323
]
324324
}
325+
},
326+
"resources": {
327+
"jobs": {
328+
"methods": {
329+
"list": {
330+
"description": "Lists jobs for a given pipeline. Throws a \"FORBIDDEN\" error if the caller doesn't have permission to access it.",
331+
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines/{pipelinesId}/jobs",
332+
"httpMethod": "GET",
333+
"id": "datapipelines.projects.locations.pipelines.jobs.list",
334+
"parameterOrder": [
335+
"parent"
336+
],
337+
"parameters": {
338+
"pageSize": {
339+
"description": "The maximum number of entities to return. The service may return fewer than this value, even if there are additional pages. If unspecified, the max limit will be determined by the backend implementation.",
340+
"format": "int32",
341+
"location": "query",
342+
"type": "integer"
343+
},
344+
"pageToken": {
345+
"description": "A page token, received from a previous `ListJobs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListJobs` must match the call that provided the page token.",
346+
"location": "query",
347+
"type": "string"
348+
},
349+
"parent": {
350+
"description": "Required. The pipeline name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID`.",
351+
"location": "path",
352+
"pattern": "^projects/[^/]+/locations/[^/]+/pipelines/[^/]+$",
353+
"required": true,
354+
"type": "string"
355+
}
356+
},
357+
"path": "v1/{+parent}/jobs",
358+
"response": {
359+
"$ref": "GoogleCloudDatapipelinesV1ListJobsResponse"
360+
},
361+
"scopes": [
362+
"https://www.googleapis.com/auth/cloud-platform"
363+
]
364+
}
365+
}
366+
}
325367
}
326368
}
327369
}
328370
}
329371
}
330372
}
331373
},
332-
"revision": "20211203",
374+
"revision": "20220103",
333375
"rootUrl": "https://datapipelines.googleapis.com/",
334376
"schemas": {
335377
"GoogleCloudDatapipelinesV1DataflowJobDetails": {
@@ -640,6 +682,24 @@
640682
},
641683
"type": "object"
642684
},
685+
"GoogleCloudDatapipelinesV1ListJobsResponse": {
686+
"description": "Response message for ListJobs",
687+
"id": "GoogleCloudDatapipelinesV1ListJobsResponse",
688+
"properties": {
689+
"jobs": {
690+
"description": "Results that were accessible to the caller. Results are always in descending order of job creation date.",
691+
"items": {
692+
"$ref": "GoogleCloudDatapipelinesV1Job"
693+
},
694+
"type": "array"
695+
},
696+
"nextPageToken": {
697+
"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
698+
"type": "string"
699+
}
700+
},
701+
"type": "object"
702+
},
643703
"GoogleCloudDatapipelinesV1ListPipelinesResponse": {
644704
"description": "Response message for ListPipelines.",
645705
"id": "GoogleCloudDatapipelinesV1ListPipelinesResponse",

0 commit comments

Comments
 (0)