OLD | NEW |
| (Empty) |
1 { | |
2 "auth": { | |
3 "oauth2": { | |
4 "scopes": { | |
5 "https://www.googleapis.com/auth/cloud-platform": { | |
6 "description": "View and manage your data across Google Clou
d Platform services" | |
7 } | |
8 } | |
9 } | |
10 }, | |
11 "basePath": "/container/v1beta1/projects/", | |
12 "baseUrl": "https://www.googleapis.com/container/v1beta1/projects/", | |
13 "batchPath": "batch", | |
14 "description": "The Google Container Engine API is used for building and man
aging container based applications, powered by the open source Kubernetes techno
logy.", | |
15 "discoveryVersion": "v1", | |
16 "documentationLink": "https://cloud.google.com/container-engine/docs/v1beta1
/", | |
17 "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/hfLmCQ4Ut9jPERvGmAwjUd46Fc8\"", | |
18 "icons": { | |
19 "x16": "http://www.google.com/images/icons/product/search-16.gif", | |
20 "x32": "http://www.google.com/images/icons/product/search-32.gif" | |
21 }, | |
22 "id": "container:v1beta1", | |
23 "kind": "discovery#restDescription", | |
24 "name": "container", | |
25 "ownerDomain": "google.com", | |
26 "ownerName": "Google", | |
27 "parameters": { | |
28 "alt": { | |
29 "default": "json", | |
30 "description": "Data format for the response.", | |
31 "enum": [ | |
32 "json" | |
33 ], | |
34 "enumDescriptions": [ | |
35 "Responses with Content-Type of application/json" | |
36 ], | |
37 "location": "query", | |
38 "type": "string" | |
39 }, | |
40 "fields": { | |
41 "description": "Selector specifying which fields to include in a par
tial response.", | |
42 "location": "query", | |
43 "type": "string" | |
44 }, | |
45 "key": { | |
46 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | |
47 "location": "query", | |
48 "type": "string" | |
49 }, | |
50 "oauth_token": { | |
51 "description": "OAuth 2.0 token for the current user.", | |
52 "location": "query", | |
53 "type": "string" | |
54 }, | |
55 "prettyPrint": { | |
56 "default": "true", | |
57 "description": "Returns response with indentations and line breaks."
, | |
58 "location": "query", | |
59 "type": "boolean" | |
60 }, | |
61 "quotaUser": { | |
62 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters. Overrides userIp if both are provided.", | |
63 "location": "query", | |
64 "type": "string" | |
65 }, | |
66 "userIp": { | |
67 "description": "IP address of the site where the request originates.
Use this if you want to enforce per-user limits.", | |
68 "location": "query", | |
69 "type": "string" | |
70 } | |
71 }, | |
72 "protocol": "rest", | |
73 "resources": { | |
74 "projects": { | |
75 "resources": { | |
76 "clusters": { | |
77 "methods": { | |
78 "list": { | |
79 "description": "Lists all clusters owned by a projec
t across all zones.", | |
80 "httpMethod": "GET", | |
81 "id": "container.projects.clusters.list", | |
82 "parameterOrder": [ | |
83 "projectId" | |
84 ], | |
85 "parameters": { | |
86 "projectId": { | |
87 "description": "The Google Developers Consol
e project ID or project number.", | |
88 "location": "path", | |
89 "required": true, | |
90 "type": "string" | |
91 } | |
92 }, | |
93 "path": "{projectId}/clusters", | |
94 "response": { | |
95 "$ref": "ListAggregatedClustersResponse" | |
96 }, | |
97 "scopes": [ | |
98 "https://www.googleapis.com/auth/cloud-platform" | |
99 ] | |
100 } | |
101 } | |
102 }, | |
103 "operations": { | |
104 "methods": { | |
105 "list": { | |
106 "description": "Lists all operations in a project, a
cross all zones.", | |
107 "httpMethod": "GET", | |
108 "id": "container.projects.operations.list", | |
109 "parameterOrder": [ | |
110 "projectId" | |
111 ], | |
112 "parameters": { | |
113 "projectId": { | |
114 "description": "The Google Developers Consol
e project ID or project number.", | |
115 "location": "path", | |
116 "required": true, | |
117 "type": "string" | |
118 } | |
119 }, | |
120 "path": "{projectId}/operations", | |
121 "response": { | |
122 "$ref": "ListAggregatedOperationsResponse" | |
123 }, | |
124 "scopes": [ | |
125 "https://www.googleapis.com/auth/cloud-platform" | |
126 ] | |
127 } | |
128 } | |
129 }, | |
130 "zones": { | |
131 "resources": { | |
132 "clusters": { | |
133 "methods": { | |
134 "create": { | |
135 "description": "Creates a cluster, consistin
g of the specified number and type of Google Compute Engine instances, plus a Ku
bernetes master instance.\n\nThe cluster is created in the project's default net
work.\n\nA firewall is added that allows traffic into port 443 on the master, wh
ich enables HTTPS. A firewall and a route is added for each node to allow the co
ntainers on that node to communicate with all other instances in the cluster.\n\
nFinally, an entry is added to the project's global metadata indicating which CI
DR range is being used by the cluster.", | |
136 "httpMethod": "POST", | |
137 "id": "container.projects.zones.clusters.cre
ate", | |
138 "parameterOrder": [ | |
139 "projectId", | |
140 "zoneId" | |
141 ], | |
142 "parameters": { | |
143 "projectId": { | |
144 "description": "The Google Developer
s Console project ID or project number.", | |
145 "location": "path", | |
146 "required": true, | |
147 "type": "string" | |
148 }, | |
149 "zoneId": { | |
150 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", | |
151 "location": "path", | |
152 "required": true, | |
153 "type": "string" | |
154 } | |
155 }, | |
156 "path": "{projectId}/zones/{zoneId}/clusters
", | |
157 "request": { | |
158 "$ref": "CreateClusterRequest" | |
159 }, | |
160 "response": { | |
161 "$ref": "Operation" | |
162 }, | |
163 "scopes": [ | |
164 "https://www.googleapis.com/auth/cloud-p
latform" | |
165 ] | |
166 }, | |
167 "delete": { | |
168 "description": "Deletes the cluster, includi
ng the Kubernetes master and all worker nodes.\n\nFirewalls and routes that were
configured at cluster creation are also deleted.", | |
169 "httpMethod": "DELETE", | |
170 "id": "container.projects.zones.clusters.del
ete", | |
171 "parameterOrder": [ | |
172 "projectId", | |
173 "zoneId", | |
174 "clusterId" | |
175 ], | |
176 "parameters": { | |
177 "clusterId": { | |
178 "description": "The name of the clus
ter to delete.", | |
179 "location": "path", | |
180 "required": true, | |
181 "type": "string" | |
182 }, | |
183 "projectId": { | |
184 "description": "The Google Developer
s Console project ID or project number.", | |
185 "location": "path", | |
186 "required": true, | |
187 "type": "string" | |
188 }, | |
189 "zoneId": { | |
190 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", | |
191 "location": "path", | |
192 "required": true, | |
193 "type": "string" | |
194 } | |
195 }, | |
196 "path": "{projectId}/zones/{zoneId}/clusters
/{clusterId}", | |
197 "response": { | |
198 "$ref": "Operation" | |
199 }, | |
200 "scopes": [ | |
201 "https://www.googleapis.com/auth/cloud-p
latform" | |
202 ] | |
203 }, | |
204 "get": { | |
205 "description": "Gets a specific cluster.", | |
206 "httpMethod": "GET", | |
207 "id": "container.projects.zones.clusters.get
", | |
208 "parameterOrder": [ | |
209 "projectId", | |
210 "zoneId", | |
211 "clusterId" | |
212 ], | |
213 "parameters": { | |
214 "clusterId": { | |
215 "description": "The name of the clus
ter to retrieve.", | |
216 "location": "path", | |
217 "required": true, | |
218 "type": "string" | |
219 }, | |
220 "projectId": { | |
221 "description": "The Google Developer
s Console project ID or project number.", | |
222 "location": "path", | |
223 "required": true, | |
224 "type": "string" | |
225 }, | |
226 "zoneId": { | |
227 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", | |
228 "location": "path", | |
229 "required": true, | |
230 "type": "string" | |
231 } | |
232 }, | |
233 "path": "{projectId}/zones/{zoneId}/clusters
/{clusterId}", | |
234 "response": { | |
235 "$ref": "Cluster" | |
236 }, | |
237 "scopes": [ | |
238 "https://www.googleapis.com/auth/cloud-p
latform" | |
239 ] | |
240 }, | |
241 "list": { | |
242 "description": "Lists all clusters owned by
a project in the specified zone.", | |
243 "httpMethod": "GET", | |
244 "id": "container.projects.zones.clusters.lis
t", | |
245 "parameterOrder": [ | |
246 "projectId", | |
247 "zoneId" | |
248 ], | |
249 "parameters": { | |
250 "projectId": { | |
251 "description": "The Google Developer
s Console project ID or project number.", | |
252 "location": "path", | |
253 "required": true, | |
254 "type": "string" | |
255 }, | |
256 "zoneId": { | |
257 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", | |
258 "location": "path", | |
259 "required": true, | |
260 "type": "string" | |
261 } | |
262 }, | |
263 "path": "{projectId}/zones/{zoneId}/clusters
", | |
264 "response": { | |
265 "$ref": "ListClustersResponse" | |
266 }, | |
267 "scopes": [ | |
268 "https://www.googleapis.com/auth/cloud-p
latform" | |
269 ] | |
270 } | |
271 } | |
272 }, | |
273 "operations": { | |
274 "methods": { | |
275 "get": { | |
276 "description": "Gets the specified operation
.", | |
277 "httpMethod": "GET", | |
278 "id": "container.projects.zones.operations.g
et", | |
279 "parameterOrder": [ | |
280 "projectId", | |
281 "zoneId", | |
282 "operationId" | |
283 ], | |
284 "parameters": { | |
285 "operationId": { | |
286 "description": "The server-assigned
name of the operation.", | |
287 "location": "path", | |
288 "required": true, | |
289 "type": "string" | |
290 }, | |
291 "projectId": { | |
292 "description": "The Google Developer
s Console project ID or project number.", | |
293 "location": "path", | |
294 "required": true, | |
295 "type": "string" | |
296 }, | |
297 "zoneId": { | |
298 "description": "The name of the Goog
le Compute Engine zone in which the operation resides. This is always the same z
one as the cluster with which the operation is associated.", | |
299 "location": "path", | |
300 "required": true, | |
301 "type": "string" | |
302 } | |
303 }, | |
304 "path": "{projectId}/zones/{zoneId}/operatio
ns/{operationId}", | |
305 "response": { | |
306 "$ref": "Operation" | |
307 }, | |
308 "scopes": [ | |
309 "https://www.googleapis.com/auth/cloud-p
latform" | |
310 ] | |
311 }, | |
312 "list": { | |
313 "description": "Lists all operations in a pr
oject in a specific zone.", | |
314 "httpMethod": "GET", | |
315 "id": "container.projects.zones.operations.l
ist", | |
316 "parameterOrder": [ | |
317 "projectId", | |
318 "zoneId" | |
319 ], | |
320 "parameters": { | |
321 "projectId": { | |
322 "description": "The Google Developer
s Console project ID or project number.", | |
323 "location": "path", | |
324 "required": true, | |
325 "type": "string" | |
326 }, | |
327 "zoneId": { | |
328 "description": "The name of the Goog
le Compute Engine zone to return operations for.", | |
329 "location": "path", | |
330 "required": true, | |
331 "type": "string" | |
332 } | |
333 }, | |
334 "path": "{projectId}/zones/{zoneId}/operatio
ns", | |
335 "response": { | |
336 "$ref": "ListOperationsResponse" | |
337 }, | |
338 "scopes": [ | |
339 "https://www.googleapis.com/auth/cloud-p
latform" | |
340 ] | |
341 } | |
342 } | |
343 } | |
344 } | |
345 } | |
346 } | |
347 } | |
348 }, | |
349 "revision": "20150728", | |
350 "rootUrl": "https://www.googleapis.com/", | |
351 "schemas": { | |
352 "Cluster": { | |
353 "id": "Cluster", | |
354 "properties": { | |
355 "clusterApiVersion": { | |
356 "description": "The API version of the Kubernetes master and
kubelets running in this cluster. Leave blank to pick up the latest stable rele
ase, or specify a version of the form \"x.y.z\". The Google Container Engine rel
ease notes lists the currently supported versions. If an incorrect version is sp
ecified, the server returns an error listing the currently supported versions.", | |
357 "type": "string" | |
358 }, | |
359 "containerIpv4Cidr": { | |
360 "description": "The IP address range of the container pods i
n this cluster, in CIDR notation (e.g. 10.96.0.0/14). Leave blank to have one a
utomatically chosen or specify a /14 block in 10.0.0.0/8.", | |
361 "type": "string" | |
362 }, | |
363 "creationTimestamp": { | |
364 "description": "[Output only] The time the cluster was creat
ed, in RFC3339 text format.", | |
365 "type": "string" | |
366 }, | |
367 "description": { | |
368 "description": "An optional description of this cluster.", | |
369 "type": "string" | |
370 }, | |
371 "enableCloudLogging": { | |
372 "description": "Whether logs from the cluster should be made
available via the Google Cloud Logging service. This includes both logs from yo
ur applications running in the cluster as well as logs from the Kubernetes compo
nents themselves.", | |
373 "type": "boolean" | |
374 }, | |
375 "enableCloudMonitoring": { | |
376 "description": "Whether metrics from the cluster should be m
ade available via the Google Cloud Monitoring service.", | |
377 "type": "boolean" | |
378 }, | |
379 "endpoint": { | |
380 "description": "[Output only] The IP address of this cluster
's Kubernetes master. The endpoint can be accessed from the internet at https://
username:password@endpoint/.\n\nSee the masterAuth property of this resource for
username and password information.", | |
381 "type": "string" | |
382 }, | |
383 "instanceGroupUrls": { | |
384 "description": "[Output only] The resource URLs of [instance
groups](/compute/docs/instance-groups/) associated with this cluster.", | |
385 "items": { | |
386 "type": "string" | |
387 }, | |
388 "type": "array" | |
389 }, | |
390 "masterAuth": { | |
391 "$ref": "MasterAuth", | |
392 "description": "The authentication information for accessing
the master." | |
393 }, | |
394 "name": { | |
395 "description": "The name of this cluster. The name must be u
nique within this project and zone, and can be up to 40 characters with the foll
owing restrictions: \n- Lowercase letters, numbers, and hyphens only.\n- Must s
tart with a letter.\n- Must end with a number or a letter.", | |
396 "type": "string" | |
397 }, | |
398 "network": { | |
399 "description": "The name of the Google Compute Engine networ
k to which the cluster is connected.", | |
400 "type": "string" | |
401 }, | |
402 "nodeConfig": { | |
403 "$ref": "NodeConfig", | |
404 "description": "The machine type and image to use for all no
des in this cluster. See the descriptions of the child properties of nodeConfig.
" | |
405 }, | |
406 "nodeRoutingPrefixSize": { | |
407 "description": "[Output only] The size of the address space
on each node for hosting containers.", | |
408 "format": "int32", | |
409 "type": "integer" | |
410 }, | |
411 "numNodes": { | |
412 "description": "The number of nodes to create in this cluste
r. You must ensure that your Compute Engine resource quota is sufficient for thi
s number of instances plus one (to include the master). You must also have avail
able firewall and routes quota.", | |
413 "format": "int32", | |
414 "type": "integer" | |
415 }, | |
416 "selfLink": { | |
417 "description": "[Output only] Server-defined URL for the res
ource.", | |
418 "type": "string" | |
419 }, | |
420 "servicesIpv4Cidr": { | |
421 "description": "[Output only] The IP address range of the Ku
bernetes services in this cluster, in CIDR notation (e.g. 1.2.3.4/29). Service
addresses are typically put in the last /16 from the container CIDR.", | |
422 "type": "string" | |
423 }, | |
424 "status": { | |
425 "description": "[Output only] The current status of this clu
ster.", | |
426 "enum": [ | |
427 "error", | |
428 "provisioning", | |
429 "running", | |
430 "stopping" | |
431 ], | |
432 "enumDescriptions": [ | |
433 "", | |
434 "", | |
435 "", | |
436 "" | |
437 ], | |
438 "type": "string" | |
439 }, | |
440 "statusMessage": { | |
441 "description": "[Output only] Additional information about t
he current status of this cluster, if available.", | |
442 "type": "string" | |
443 }, | |
444 "zone": { | |
445 "description": "[Output only] The name of the Google Compute
Engine zone in which the cluster resides.", | |
446 "type": "string" | |
447 } | |
448 }, | |
449 "type": "object" | |
450 }, | |
451 "CreateClusterRequest": { | |
452 "id": "CreateClusterRequest", | |
453 "properties": { | |
454 "cluster": { | |
455 "$ref": "Cluster", | |
456 "description": "A cluster resource." | |
457 } | |
458 }, | |
459 "type": "object" | |
460 }, | |
461 "ListAggregatedClustersResponse": { | |
462 "id": "ListAggregatedClustersResponse", | |
463 "properties": { | |
464 "clusters": { | |
465 "description": "A list of clusters in the project, across al
l zones.", | |
466 "items": { | |
467 "$ref": "Cluster" | |
468 }, | |
469 "type": "array" | |
470 } | |
471 }, | |
472 "type": "object" | |
473 }, | |
474 "ListAggregatedOperationsResponse": { | |
475 "id": "ListAggregatedOperationsResponse", | |
476 "properties": { | |
477 "operations": { | |
478 "description": "A list of operations in the project, across
all zones.", | |
479 "items": { | |
480 "$ref": "Operation" | |
481 }, | |
482 "type": "array" | |
483 } | |
484 }, | |
485 "type": "object" | |
486 }, | |
487 "ListClustersResponse": { | |
488 "id": "ListClustersResponse", | |
489 "properties": { | |
490 "clusters": { | |
491 "description": "A list of clusters in the project in the spe
cified zone.", | |
492 "items": { | |
493 "$ref": "Cluster" | |
494 }, | |
495 "type": "array" | |
496 } | |
497 }, | |
498 "type": "object" | |
499 }, | |
500 "ListOperationsResponse": { | |
501 "id": "ListOperationsResponse", | |
502 "properties": { | |
503 "operations": { | |
504 "description": "A list of operations in the project in the s
pecified zone.", | |
505 "items": { | |
506 "$ref": "Operation" | |
507 }, | |
508 "type": "array" | |
509 } | |
510 }, | |
511 "type": "object" | |
512 }, | |
513 "MasterAuth": { | |
514 "description": "The authentication information for accessing the mas
ter. Authentication is either done using HTTP basic authentication or using a be
arer token.", | |
515 "id": "MasterAuth", | |
516 "properties": { | |
517 "bearerToken": { | |
518 "description": "The token used to authenticate API requests
to the master. The token is to be included in an HTTP Authorization Header in al
l requests to the master endpoint. The format of the header is: \"Authorization:
Bearer \".", | |
519 "type": "string" | |
520 }, | |
521 "clientCertificate": { | |
522 "description": "[Output only] Base64 encoded public certific
ate used by clients to authenticate to the cluster endpoint.", | |
523 "type": "string" | |
524 }, | |
525 "clientKey": { | |
526 "description": "[Output only] Base64 encoded private key use
d by clients to authenticate to the cluster endpoint.", | |
527 "type": "string" | |
528 }, | |
529 "clusterCaCertificate": { | |
530 "description": "[Output only] Base64 encoded public certific
ate that is the root of trust for the cluster.", | |
531 "type": "string" | |
532 }, | |
533 "password": { | |
534 "description": "The password to use for HTTP basic authentic
ation when accessing the Kubernetes master endpoint. Because the master endpoint
is open to the internet, you should create a strong password.", | |
535 "type": "string" | |
536 }, | |
537 "user": { | |
538 "description": "The username to use for HTTP basic authentic
ation when accessing the Kubernetes master endpoint.", | |
539 "type": "string" | |
540 } | |
541 }, | |
542 "type": "object" | |
543 }, | |
544 "NodeConfig": { | |
545 "id": "NodeConfig", | |
546 "properties": { | |
547 "machineType": { | |
548 "description": "The name of a Google Compute Engine machine
type (e.g. n1-standard-1).\n\nIf unspecified, the default machine type is n1-sta
ndard-1.", | |
549 "type": "string" | |
550 }, | |
551 "serviceAccounts": { | |
552 "description": "The optional list of ServiceAccounts, each w
ith their specified scopes, to be made available on all of the node VMs. In addi
tion to the service accounts and scopes specified, the \"default\" account will
always be created with the following scopes to ensure the correct functioning of
the cluster: \n- https://www.googleapis.com/auth/compute,\n- https://www.googl
eapis.com/auth/devstorage.read_only", | |
553 "items": { | |
554 "$ref": "ServiceAccount" | |
555 }, | |
556 "type": "array" | |
557 }, | |
558 "sourceImage": { | |
559 "description": "The fully-specified name of a Google Compute
Engine image. For example: https://www.googleapis.com/compute/v1/projects/debia
n-cloud/global/images/backports-debian-7-wheezy-vYYYYMMDD (where YYYMMDD is the
version date).\n\nIf specifying an image, you are responsible for ensuring its c
ompatibility with the Debian 7 backports image. We recommend leaving this field
blank to accept the default backports-debian-7-wheezy value.", | |
560 "type": "string" | |
561 } | |
562 }, | |
563 "type": "object" | |
564 }, | |
565 "Operation": { | |
566 "description": "Defines the operation resource. All fields are outpu
t only.", | |
567 "id": "Operation", | |
568 "properties": { | |
569 "errorMessage": { | |
570 "description": "If an error has occurred, a textual descript
ion of the error.", | |
571 "type": "string" | |
572 }, | |
573 "name": { | |
574 "description": "The server-assigned ID for the operation.", | |
575 "type": "string" | |
576 }, | |
577 "operationType": { | |
578 "description": "The operation type.", | |
579 "enum": [ | |
580 "createCluster", | |
581 "deleteCluster" | |
582 ], | |
583 "enumDescriptions": [ | |
584 "", | |
585 "" | |
586 ], | |
587 "type": "string" | |
588 }, | |
589 "selfLink": { | |
590 "description": "Server-defined URL for the resource.", | |
591 "type": "string" | |
592 }, | |
593 "status": { | |
594 "description": "The current status of the operation.", | |
595 "enum": [ | |
596 "done", | |
597 "pending", | |
598 "running" | |
599 ], | |
600 "enumDescriptions": [ | |
601 "", | |
602 "", | |
603 "" | |
604 ], | |
605 "type": "string" | |
606 }, | |
607 "target": { | |
608 "description": "[Optional] The URL of the cluster resource t
hat this operation is associated with.", | |
609 "type": "string" | |
610 }, | |
611 "targetLink": { | |
612 "description": "Server-defined URL for the target of the ope
ration.", | |
613 "type": "string" | |
614 }, | |
615 "zone": { | |
616 "description": "The name of the Google Compute Engine zone i
n which the operation is taking place.", | |
617 "type": "string" | |
618 } | |
619 }, | |
620 "type": "object" | |
621 }, | |
622 "ServiceAccount": { | |
623 "description": "A Compute Engine service account.", | |
624 "id": "ServiceAccount", | |
625 "properties": { | |
626 "email": { | |
627 "description": "Email address of the service account.", | |
628 "type": "string" | |
629 }, | |
630 "scopes": { | |
631 "description": "The list of scopes to be made available for
this service account.", | |
632 "items": { | |
633 "type": "string" | |
634 }, | |
635 "type": "array" | |
636 } | |
637 }, | |
638 "type": "object" | |
639 } | |
640 }, | |
641 "servicePath": "container/v1beta1/projects/", | |
642 "title": "Google Container Engine API", | |
643 "version": "v1beta1" | |
644 } | |
OLD | NEW |