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 "etag": "\"l66ggWbucbkBw9Lpos72oziyefE/ZrZBeDfQYPqAxFURJt0IhCOLUHQ\"", |
| 17 "icons": { |
| 18 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
| 19 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
| 20 }, |
| 21 "id": "container:v1beta1", |
| 22 "kind": "discovery#restDescription", |
| 23 "name": "container", |
| 24 "ownerDomain": "google.com", |
| 25 "ownerName": "Google", |
| 26 "parameters": { |
| 27 "alt": { |
| 28 "default": "json", |
| 29 "description": "Data format for the response.", |
| 30 "enum": [ |
| 31 "json" |
| 32 ], |
| 33 "enumDescriptions": [ |
| 34 "Responses with Content-Type of application/json" |
| 35 ], |
| 36 "location": "query", |
| 37 "type": "string" |
| 38 }, |
| 39 "fields": { |
| 40 "description": "Selector specifying which fields to include in a par
tial response.", |
| 41 "location": "query", |
| 42 "type": "string" |
| 43 }, |
| 44 "key": { |
| 45 "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.", |
| 46 "location": "query", |
| 47 "type": "string" |
| 48 }, |
| 49 "oauth_token": { |
| 50 "description": "OAuth 2.0 token for the current user.", |
| 51 "location": "query", |
| 52 "type": "string" |
| 53 }, |
| 54 "prettyPrint": { |
| 55 "default": "true", |
| 56 "description": "Returns response with indentations and line breaks."
, |
| 57 "location": "query", |
| 58 "type": "boolean" |
| 59 }, |
| 60 "quotaUser": { |
| 61 "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.", |
| 62 "location": "query", |
| 63 "type": "string" |
| 64 }, |
| 65 "userIp": { |
| 66 "description": "IP address of the site where the request originates.
Use this if you want to enforce per-user limits.", |
| 67 "location": "query", |
| 68 "type": "string" |
| 69 } |
| 70 }, |
| 71 "protocol": "rest", |
| 72 "resources": { |
| 73 "projects": { |
| 74 "resources": { |
| 75 "clusters": { |
| 76 "methods": { |
| 77 "list": { |
| 78 "description": "Lists all clusters owned by a projec
t across all zones.", |
| 79 "httpMethod": "GET", |
| 80 "id": "container.projects.clusters.list", |
| 81 "parameterOrder": [ |
| 82 "projectId" |
| 83 ], |
| 84 "parameters": { |
| 85 "projectId": { |
| 86 "description": "The Google Developers Consol
e project ID or project number.", |
| 87 "location": "path", |
| 88 "required": true, |
| 89 "type": "string" |
| 90 } |
| 91 }, |
| 92 "path": "{projectId}/clusters", |
| 93 "response": { |
| 94 "$ref": "ListAggregatedClustersResponse" |
| 95 }, |
| 96 "scopes": [ |
| 97 "https://www.googleapis.com/auth/cloud-platform" |
| 98 ] |
| 99 } |
| 100 } |
| 101 }, |
| 102 "operations": { |
| 103 "methods": { |
| 104 "list": { |
| 105 "description": "Lists all operations in a project, a
cross all zones.", |
| 106 "httpMethod": "GET", |
| 107 "id": "container.projects.operations.list", |
| 108 "parameterOrder": [ |
| 109 "projectId" |
| 110 ], |
| 111 "parameters": { |
| 112 "projectId": { |
| 113 "description": "The Google Developers Consol
e project ID or project number.", |
| 114 "location": "path", |
| 115 "required": true, |
| 116 "type": "string" |
| 117 } |
| 118 }, |
| 119 "path": "{projectId}/operations", |
| 120 "response": { |
| 121 "$ref": "ListAggregatedOperationsResponse" |
| 122 }, |
| 123 "scopes": [ |
| 124 "https://www.googleapis.com/auth/cloud-platform" |
| 125 ] |
| 126 } |
| 127 } |
| 128 }, |
| 129 "zones": { |
| 130 "resources": { |
| 131 "clusters": { |
| 132 "methods": { |
| 133 "create": { |
| 134 "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, a route named k8s-iproute-10-xx-0-0 is created to track that the clust
er's 10.xx.0.0/16 CIDR has been assigned.", |
| 135 "httpMethod": "POST", |
| 136 "id": "container.projects.zones.clusters.cre
ate", |
| 137 "parameterOrder": [ |
| 138 "projectId", |
| 139 "zoneId" |
| 140 ], |
| 141 "parameters": { |
| 142 "projectId": { |
| 143 "description": "The Google Developer
s Console project ID or project number.", |
| 144 "location": "path", |
| 145 "required": true, |
| 146 "type": "string" |
| 147 }, |
| 148 "zoneId": { |
| 149 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", |
| 150 "location": "path", |
| 151 "required": true, |
| 152 "type": "string" |
| 153 } |
| 154 }, |
| 155 "path": "{projectId}/zones/{zoneId}/clusters
", |
| 156 "request": { |
| 157 "$ref": "CreateClusterRequest" |
| 158 }, |
| 159 "response": { |
| 160 "$ref": "Operation" |
| 161 }, |
| 162 "scopes": [ |
| 163 "https://www.googleapis.com/auth/cloud-p
latform" |
| 164 ] |
| 165 }, |
| 166 "delete": { |
| 167 "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.", |
| 168 "httpMethod": "DELETE", |
| 169 "id": "container.projects.zones.clusters.del
ete", |
| 170 "parameterOrder": [ |
| 171 "projectId", |
| 172 "zoneId", |
| 173 "clusterId" |
| 174 ], |
| 175 "parameters": { |
| 176 "clusterId": { |
| 177 "description": "The name of the clus
ter to delete.", |
| 178 "location": "path", |
| 179 "required": true, |
| 180 "type": "string" |
| 181 }, |
| 182 "projectId": { |
| 183 "description": "The Google Developer
s Console project ID or project number.", |
| 184 "location": "path", |
| 185 "required": true, |
| 186 "type": "string" |
| 187 }, |
| 188 "zoneId": { |
| 189 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", |
| 190 "location": "path", |
| 191 "required": true, |
| 192 "type": "string" |
| 193 } |
| 194 }, |
| 195 "path": "{projectId}/zones/{zoneId}/clusters
/{clusterId}", |
| 196 "response": { |
| 197 "$ref": "Operation" |
| 198 }, |
| 199 "scopes": [ |
| 200 "https://www.googleapis.com/auth/cloud-p
latform" |
| 201 ] |
| 202 }, |
| 203 "get": { |
| 204 "description": "Gets a specific cluster.", |
| 205 "httpMethod": "GET", |
| 206 "id": "container.projects.zones.clusters.get
", |
| 207 "parameterOrder": [ |
| 208 "projectId", |
| 209 "zoneId", |
| 210 "clusterId" |
| 211 ], |
| 212 "parameters": { |
| 213 "clusterId": { |
| 214 "description": "The name of the clus
ter to retrieve.", |
| 215 "location": "path", |
| 216 "required": true, |
| 217 "type": "string" |
| 218 }, |
| 219 "projectId": { |
| 220 "description": "The Google Developer
s Console project ID or project number.", |
| 221 "location": "path", |
| 222 "required": true, |
| 223 "type": "string" |
| 224 }, |
| 225 "zoneId": { |
| 226 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", |
| 227 "location": "path", |
| 228 "required": true, |
| 229 "type": "string" |
| 230 } |
| 231 }, |
| 232 "path": "{projectId}/zones/{zoneId}/clusters
/{clusterId}", |
| 233 "response": { |
| 234 "$ref": "Cluster" |
| 235 }, |
| 236 "scopes": [ |
| 237 "https://www.googleapis.com/auth/cloud-p
latform" |
| 238 ] |
| 239 }, |
| 240 "list": { |
| 241 "description": "Lists all clusters owned by
a project in the specified zone.", |
| 242 "httpMethod": "GET", |
| 243 "id": "container.projects.zones.clusters.lis
t", |
| 244 "parameterOrder": [ |
| 245 "projectId", |
| 246 "zoneId" |
| 247 ], |
| 248 "parameters": { |
| 249 "projectId": { |
| 250 "description": "The Google Developer
s Console project ID or project number.", |
| 251 "location": "path", |
| 252 "required": true, |
| 253 "type": "string" |
| 254 }, |
| 255 "zoneId": { |
| 256 "description": "The name of the Goog
le Compute Engine zone in which the cluster resides.", |
| 257 "location": "path", |
| 258 "required": true, |
| 259 "type": "string" |
| 260 } |
| 261 }, |
| 262 "path": "{projectId}/zones/{zoneId}/clusters
", |
| 263 "response": { |
| 264 "$ref": "ListClustersResponse" |
| 265 }, |
| 266 "scopes": [ |
| 267 "https://www.googleapis.com/auth/cloud-p
latform" |
| 268 ] |
| 269 } |
| 270 } |
| 271 }, |
| 272 "operations": { |
| 273 "methods": { |
| 274 "get": { |
| 275 "description": "Gets the specified operation
.", |
| 276 "httpMethod": "GET", |
| 277 "id": "container.projects.zones.operations.g
et", |
| 278 "parameterOrder": [ |
| 279 "projectId", |
| 280 "zoneId", |
| 281 "operationId" |
| 282 ], |
| 283 "parameters": { |
| 284 "operationId": { |
| 285 "description": "The server-assigned
name of the operation.", |
| 286 "location": "path", |
| 287 "required": true, |
| 288 "type": "string" |
| 289 }, |
| 290 "projectId": { |
| 291 "description": "The Google Developer
s Console project ID or project number.", |
| 292 "location": "path", |
| 293 "required": true, |
| 294 "type": "string" |
| 295 }, |
| 296 "zoneId": { |
| 297 "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.", |
| 298 "location": "path", |
| 299 "required": true, |
| 300 "type": "string" |
| 301 } |
| 302 }, |
| 303 "path": "{projectId}/zones/{zoneId}/operatio
ns/{operationId}", |
| 304 "response": { |
| 305 "$ref": "Operation" |
| 306 }, |
| 307 "scopes": [ |
| 308 "https://www.googleapis.com/auth/cloud-p
latform" |
| 309 ] |
| 310 }, |
| 311 "list": { |
| 312 "description": "Lists all operations in a pr
oject in a specific zone.", |
| 313 "httpMethod": "GET", |
| 314 "id": "container.projects.zones.operations.l
ist", |
| 315 "parameterOrder": [ |
| 316 "projectId", |
| 317 "zoneId" |
| 318 ], |
| 319 "parameters": { |
| 320 "projectId": { |
| 321 "description": "The Google Developer
s Console project ID or project number.", |
| 322 "location": "path", |
| 323 "required": true, |
| 324 "type": "string" |
| 325 }, |
| 326 "zoneId": { |
| 327 "description": "The name of the Goog
le Compute Engine zone to return operations for.", |
| 328 "location": "path", |
| 329 "required": true, |
| 330 "type": "string" |
| 331 } |
| 332 }, |
| 333 "path": "{projectId}/zones/{zoneId}/operatio
ns", |
| 334 "response": { |
| 335 "$ref": "ListOperationsResponse" |
| 336 }, |
| 337 "scopes": [ |
| 338 "https://www.googleapis.com/auth/cloud-p
latform" |
| 339 ] |
| 340 } |
| 341 } |
| 342 } |
| 343 } |
| 344 } |
| 345 } |
| 346 } |
| 347 }, |
| 348 "revision": "20141103", |
| 349 "rootUrl": "https://www.googleapis.com/", |
| 350 "schemas": { |
| 351 "Cluster": { |
| 352 "id": "Cluster", |
| 353 "properties": { |
| 354 "clusterApiVersion": { |
| 355 "description": "The API version of the Kubernetes master and
kubelets running in this cluster. Allowed value is 0.4.2, or leave blank to pic
k up the latest stable release.", |
| 356 "type": "string" |
| 357 }, |
| 358 "containerIpv4Cidr": { |
| 359 "description": "[Output only] The IP addresses of the contai
ner pods in this cluster, in CIDR notation (e.g. 1.2.3.4/29).", |
| 360 "type": "string" |
| 361 }, |
| 362 "creationTimestamp": { |
| 363 "description": "[Output only] The time the cluster was creat
ed, in RFC3339 text format.", |
| 364 "type": "string" |
| 365 }, |
| 366 "description": { |
| 367 "description": "An optional description of this cluster.", |
| 368 "type": "string" |
| 369 }, |
| 370 "endpoint": { |
| 371 "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.", |
| 372 "type": "string" |
| 373 }, |
| 374 "masterAuth": { |
| 375 "$ref": "MasterAuth", |
| 376 "description": "The HTTP basic authentication information fo
r accessing the master. Because the master endpoint is open to the internet, you
should create a strong password." |
| 377 }, |
| 378 "name": { |
| 379 "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.", |
| 380 "type": "string" |
| 381 }, |
| 382 "nodeConfig": { |
| 383 "$ref": "NodeConfig", |
| 384 "description": "The machine type and image to use for all no
des in this cluster. See the descriptions of the child properties of nodeConfig.
" |
| 385 }, |
| 386 "nodeRoutingPrefixSize": { |
| 387 "description": "[Output only] The size of the address space
on each node for hosting containers.", |
| 388 "format": "int32", |
| 389 "type": "integer" |
| 390 }, |
| 391 "numNodes": { |
| 392 "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.", |
| 393 "format": "int32", |
| 394 "type": "integer" |
| 395 }, |
| 396 "servicesIpv4Cidr": { |
| 397 "description": "[Output only] The IP addresses of the Kubern
etes services in this cluster, in CIDR notation (e.g. 1.2.3.4/29). Service addr
esses are always in the 10.0.0.0/16 range.", |
| 398 "type": "string" |
| 399 }, |
| 400 "status": { |
| 401 "description": "[Output only] The current status of this clu
ster.", |
| 402 "enum": [ |
| 403 "error", |
| 404 "provisioning", |
| 405 "running", |
| 406 "stopping" |
| 407 ], |
| 408 "enumDescriptions": [ |
| 409 "", |
| 410 "", |
| 411 "", |
| 412 "" |
| 413 ], |
| 414 "type": "string" |
| 415 }, |
| 416 "statusMessage": { |
| 417 "description": "[Output only] Additional information about t
he current status of this cluster, if available.", |
| 418 "type": "string" |
| 419 }, |
| 420 "zone": { |
| 421 "description": "[Output only] The name of the Google Compute
Engine zone in which the cluster resides.", |
| 422 "type": "string" |
| 423 } |
| 424 }, |
| 425 "type": "object" |
| 426 }, |
| 427 "CreateClusterRequest": { |
| 428 "id": "CreateClusterRequest", |
| 429 "properties": { |
| 430 "cluster": { |
| 431 "$ref": "Cluster", |
| 432 "description": "A cluster resource." |
| 433 } |
| 434 }, |
| 435 "type": "object" |
| 436 }, |
| 437 "ListAggregatedClustersResponse": { |
| 438 "id": "ListAggregatedClustersResponse", |
| 439 "properties": { |
| 440 "clusters": { |
| 441 "description": "A list of clusters in the project, across al
l zones.", |
| 442 "items": { |
| 443 "$ref": "Cluster" |
| 444 }, |
| 445 "type": "array" |
| 446 } |
| 447 }, |
| 448 "type": "object" |
| 449 }, |
| 450 "ListAggregatedOperationsResponse": { |
| 451 "id": "ListAggregatedOperationsResponse", |
| 452 "properties": { |
| 453 "operations": { |
| 454 "description": "A list of operations in the project, across
all zones.", |
| 455 "items": { |
| 456 "$ref": "Operation" |
| 457 }, |
| 458 "type": "array" |
| 459 } |
| 460 }, |
| 461 "type": "object" |
| 462 }, |
| 463 "ListClustersResponse": { |
| 464 "id": "ListClustersResponse", |
| 465 "properties": { |
| 466 "clusters": { |
| 467 "description": "A list of clusters in the project in the spe
cified zone.", |
| 468 "items": { |
| 469 "$ref": "Cluster" |
| 470 }, |
| 471 "type": "array" |
| 472 } |
| 473 }, |
| 474 "type": "object" |
| 475 }, |
| 476 "ListOperationsResponse": { |
| 477 "id": "ListOperationsResponse", |
| 478 "properties": { |
| 479 "operations": { |
| 480 "description": "A list of operations in the project in the s
pecified zone.", |
| 481 "items": { |
| 482 "$ref": "Operation" |
| 483 }, |
| 484 "type": "array" |
| 485 } |
| 486 }, |
| 487 "type": "object" |
| 488 }, |
| 489 "MasterAuth": { |
| 490 "id": "MasterAuth", |
| 491 "properties": { |
| 492 "password": { |
| 493 "description": "The password to use when accessing the Kuber
netes master endpoint.", |
| 494 "type": "string" |
| 495 }, |
| 496 "user": { |
| 497 "description": "The username to use when accessing the Kuber
netes master endpoint.", |
| 498 "type": "string" |
| 499 } |
| 500 }, |
| 501 "type": "object" |
| 502 }, |
| 503 "NodeConfig": { |
| 504 "id": "NodeConfig", |
| 505 "properties": { |
| 506 "machineType": { |
| 507 "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.", |
| 508 "type": "string" |
| 509 }, |
| 510 "sourceImage": { |
| 511 "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.", |
| 512 "type": "string" |
| 513 } |
| 514 }, |
| 515 "type": "object" |
| 516 }, |
| 517 "Operation": { |
| 518 "description": "Defines the operation resource. All fields are outpu
t only.", |
| 519 "id": "Operation", |
| 520 "properties": { |
| 521 "errorMessage": { |
| 522 "description": "If an error has occurred, a textual descript
ion of the error.", |
| 523 "type": "string" |
| 524 }, |
| 525 "name": { |
| 526 "description": "The server-assigned ID for this operation. I
f the operation is fulfilled upfront, it may not have a resource name.", |
| 527 "type": "string" |
| 528 }, |
| 529 "operationType": { |
| 530 "description": "The operation type.", |
| 531 "enum": [ |
| 532 "createCluster", |
| 533 "deleteCluster" |
| 534 ], |
| 535 "enumDescriptions": [ |
| 536 "", |
| 537 "" |
| 538 ], |
| 539 "type": "string" |
| 540 }, |
| 541 "status": { |
| 542 "description": "The current status of the operation.", |
| 543 "enum": [ |
| 544 "done", |
| 545 "pending", |
| 546 "running" |
| 547 ], |
| 548 "enumDescriptions": [ |
| 549 "", |
| 550 "", |
| 551 "" |
| 552 ], |
| 553 "type": "string" |
| 554 }, |
| 555 "target": { |
| 556 "description": "[Optional] The URL of the cluster resource t
hat this operation is associated with.", |
| 557 "type": "string" |
| 558 }, |
| 559 "zone": { |
| 560 "description": "The name of the Google Compute Engine zone i
n which the operation is taking place.", |
| 561 "type": "string" |
| 562 } |
| 563 }, |
| 564 "type": "object" |
| 565 } |
| 566 }, |
| 567 "servicePath": "container/v1beta1/projects/", |
| 568 "title": "Google Container Engine API", |
| 569 "version": "v1beta1" |
| 570 } |
OLD | NEW |