Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(335)

Issues Search
    My Issues | Starred     Open | Closed | All

Unified Diff: discovery/googleapis/container__v1.json

Issue 2936613002: Api-Roll 50: 2017-06-12 (Closed)
Patch Set: Created 3 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « discovery/googleapis/compute__v1.json ('k') | discovery/googleapis/content__v2.json » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: discovery/googleapis/container__v1.json
diff --git a/discovery/googleapis/container__v1.json b/discovery/googleapis/container__v1.json
index 64e2b63fc695fc1fdf1efd6d14ecdb3194d89b43..475212539438f1db62085a986d342060a11b974f 100644
--- a/discovery/googleapis/container__v1.json
+++ b/discovery/googleapis/container__v1.json
@@ -24,19 +24,8 @@
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
- "alt": {
- "default": "json",
- "description": "Data format for response.",
- "enum": [
- "json",
- "media",
- "proto"
- ],
- "enumDescriptions": [
- "Responses with Content-Type of application/json",
- "Media download with context-dependent Content-Type",
- "Responses with Content-Type of application/x-protobuf"
- ],
+ "key": {
+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
@@ -45,11 +34,6 @@
"location": "query",
"type": "string"
},
- "key": {
- "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
- "location": "query",
- "type": "string"
- },
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
@@ -82,13 +66,13 @@
"location": "query",
"type": "boolean"
},
- "uploadType": {
- "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+ "fields": {
+ "description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
- "fields": {
- "description": "Selector specifying which fields to include in a partial response.",
+ "uploadType": {
+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
@@ -109,6 +93,22 @@
"description": "JSONP",
"location": "query",
"type": "string"
+ },
+ "alt": {
+ "default": "json",
+ "description": "Data format for response.",
+ "enum": [
+ "json",
+ "media",
+ "proto"
+ ],
+ "enumDescriptions": [
+ "Responses with Content-Type of application/json",
+ "Media download with context-dependent Content-Type",
+ "Responses with Content-Type of application/x-protobuf"
+ ],
+ "location": "query",
+ "type": "string"
}
},
"protocol": "rest",
@@ -160,14 +160,14 @@
"zone"
],
"parameters": {
- "zone": {
- "description": "The name of the Google Compute Engine [zone](/compute/docs/zones#available)\nto return operations for, or `-` for all zones.",
+ "projectId": {
+ "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
"required": true,
"type": "string"
},
- "projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
+ "zone": {
+ "description": "The name of the Google Compute Engine [zone](/compute/docs/zones#available)\nto return operations for, or `-` for all zones.",
"location": "path",
"required": true,
"type": "string"
@@ -262,10 +262,10 @@
},
"clusters": {
"methods": {
- "legacyAbac": {
- "description": "Enables or disables the ABAC authorization mechanism on a cluster.",
+ "setMasterAuth": {
+ "description": "Used to set master auth materials. Currently supports :-\nChanging the admin password of a specific cluster.\nThis can be either via password generation or explicitly set the password.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.legacyAbac",
+ "id": "container.projects.zones.clusters.setMasterAuth",
"parameterOrder": [
"projectId",
"zone",
@@ -285,15 +285,15 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster to update.",
+ "description": "The name of the cluster to upgrade.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/legacyAbac",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:setMasterAuth",
"request": {
- "$ref": "SetLegacyAbacRequest"
+ "$ref": "SetMasterAuthRequest"
},
"response": {
"$ref": "Operation"
@@ -302,30 +302,30 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "get": {
- "description": "Gets the details of a specific cluster.",
- "httpMethod": "GET",
- "id": "container.projects.zones.clusters.get",
+ "delete": {
+ "description": "Deletes the cluster, including the Kubernetes endpoint and all worker\nnodes.\n\nFirewalls and routes that were configured during cluster creation\nare also deleted.\n\nOther Google Compute Engine resources that might be in use by the cluster\n(e.g. load balancer resources) will not be deleted if they weren't present\nat the initial create time.",
+ "httpMethod": "DELETE",
+ "id": "container.projects.zones.clusters.delete",
"parameterOrder": [
"projectId",
"zone",
"clusterId"
],
"parameters": {
- "projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
+ "zone": {
+ "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
"location": "path",
"required": true,
"type": "string"
},
- "zone": {
- "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
+ "clusterId": {
+ "description": "The name of the cluster to delete.",
"location": "path",
"required": true,
"type": "string"
},
- "clusterId": {
- "description": "The name of the cluster to retrieve.",
+ "projectId": {
+ "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
"required": true,
"type": "string"
@@ -333,20 +333,19 @@
},
"path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}",
"response": {
- "$ref": "Cluster"
+ "$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "update": {
- "description": "Updates the settings of a specific cluster.",
- "httpMethod": "PUT",
- "id": "container.projects.zones.clusters.update",
+ "list": {
+ "description": "Lists all clusters owned by a project in either the specified zone or all\nzones.",
+ "httpMethod": "GET",
+ "id": "container.projects.zones.clusters.list",
"parameterOrder": [
"projectId",
- "zone",
- "clusterId"
+ "zone"
],
"parameters": {
"projectId": {
@@ -356,41 +355,31 @@
"type": "string"
},
"zone": {
- "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
- "location": "path",
- "required": true,
- "type": "string"
- },
- "clusterId": {
- "description": "The name of the cluster to upgrade.",
+ "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides, or \"-\" for all zones.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}",
- "request": {
- "$ref": "UpdateClusterRequest"
- },
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters",
"response": {
- "$ref": "Operation"
+ "$ref": "ListClustersResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "startIpRotation": {
- "description": "Start master IP rotation.",
+ "create": {
+ "description": "Creates a cluster, consisting of the specified number and type of Google\nCompute Engine instances.\n\nBy default, the cluster is created in the project's\n[default network](/compute/docs/networks-and-firewalls#networks).\n\nOne firewall is added for the cluster. After cluster creation,\nthe cluster creates routes for each node to allow the containers\non that node to communicate with all other instances in the\ncluster.\n\nFinally, an entry is added to the project's global metadata indicating\nwhich CIDR range is being used by the cluster.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.startIpRotation",
+ "id": "container.projects.zones.clusters.create",
"parameterOrder": [
"projectId",
- "zone",
- "clusterId"
+ "zone"
],
"parameters": {
"projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
+ "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
"required": true,
"type": "string"
@@ -400,17 +389,11 @@
"location": "path",
"required": true,
"type": "string"
- },
- "clusterId": {
- "description": "The name of the cluster.",
- "location": "path",
- "required": true,
- "type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:startIpRotation",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters",
"request": {
- "$ref": "StartIPRotationRequest"
+ "$ref": "CreateClusterRequest"
},
"response": {
"$ref": "Operation"
@@ -419,10 +402,10 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "setMasterAuth": {
- "description": "Used to set master auth materials. Currently supports :-\nChanging the admin password of a specific cluster.\nThis can be either via password generation or explicitly set the password.",
+ "resourceLabels": {
+ "description": "Sets labels on a cluster.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.setMasterAuth",
+ "id": "container.projects.zones.clusters.resourceLabels",
"parameterOrder": [
"projectId",
"zone",
@@ -430,7 +413,7 @@
],
"parameters": {
"projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
+ "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
"location": "path",
"required": true,
"type": "string"
@@ -442,15 +425,15 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster to upgrade.",
+ "description": "The name of the cluster.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:setMasterAuth",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/resourceLabels",
"request": {
- "$ref": "SetMasterAuthRequest"
+ "$ref": "SetLabelsRequest"
},
"response": {
"$ref": "Operation"
@@ -459,10 +442,10 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "delete": {
- "description": "Deletes the cluster, including the Kubernetes endpoint and all worker\nnodes.\n\nFirewalls and routes that were configured during cluster creation\nare also deleted.\n\nOther Google Compute Engine resources that might be in use by the cluster\n(e.g. load balancer resources) will not be deleted if they weren't present\nat the initial create time.",
- "httpMethod": "DELETE",
- "id": "container.projects.zones.clusters.delete",
+ "completeIpRotation": {
+ "description": "Completes master IP rotation.",
+ "httpMethod": "POST",
+ "id": "container.projects.zones.clusters.completeIpRotation",
"parameterOrder": [
"projectId",
"zone",
@@ -470,7 +453,7 @@
],
"parameters": {
"projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
+ "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
"location": "path",
"required": true,
"type": "string"
@@ -482,13 +465,16 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster to delete.",
+ "description": "The name of the cluster.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:completeIpRotation",
+ "request": {
+ "$ref": "CompleteIPRotationRequest"
+ },
"response": {
"$ref": "Operation"
},
@@ -496,13 +482,14 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "list": {
- "description": "Lists all clusters owned by a project in either the specified zone or all\nzones.",
- "httpMethod": "GET",
- "id": "container.projects.zones.clusters.list",
+ "legacyAbac": {
+ "description": "Enables or disables the ABAC authorization mechanism on a cluster.",
+ "httpMethod": "POST",
+ "id": "container.projects.zones.clusters.legacyAbac",
"parameterOrder": [
"projectId",
- "zone"
+ "zone",
+ "clusterId"
],
"parameters": {
"projectId": {
@@ -512,24 +499,33 @@
"type": "string"
},
"zone": {
- "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides, or \"-\" for all zones.",
+ "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ },
+ "clusterId": {
+ "description": "The name of the cluster to update.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/legacyAbac",
+ "request": {
+ "$ref": "SetLegacyAbacRequest"
+ },
"response": {
- "$ref": "ListClustersResponse"
+ "$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "resourceLabels": {
- "description": "Sets labels on a cluster.",
- "httpMethod": "POST",
- "id": "container.projects.zones.clusters.resourceLabels",
+ "get": {
+ "description": "Gets the details of a specific cluster.",
+ "httpMethod": "GET",
+ "id": "container.projects.zones.clusters.get",
"parameterOrder": [
"projectId",
"zone",
@@ -543,54 +539,58 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster.",
+ "description": "The name of the cluster to retrieve.",
"location": "path",
"required": true,
"type": "string"
},
"projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
+ "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/resourceLabels",
- "request": {
- "$ref": "SetLabelsRequest"
- },
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}",
"response": {
- "$ref": "Operation"
+ "$ref": "Cluster"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "create": {
- "description": "Creates a cluster, consisting of the specified number and type of Google\nCompute Engine instances.\n\nBy default, the cluster is created in the project's\n[default network](/compute/docs/networks-and-firewalls#networks).\n\nOne firewall is added for the cluster. After cluster creation,\nthe cluster creates routes for each node to allow the containers\non that node to communicate with all other instances in the\ncluster.\n\nFinally, an entry is added to the project's global metadata indicating\nwhich CIDR range is being used by the cluster.",
- "httpMethod": "POST",
- "id": "container.projects.zones.clusters.create",
+ "update": {
+ "description": "Updates the settings of a specific cluster.",
+ "httpMethod": "PUT",
+ "id": "container.projects.zones.clusters.update",
"parameterOrder": [
"projectId",
- "zone"
+ "zone",
+ "clusterId"
],
"parameters": {
- "projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
+ "zone": {
+ "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
"location": "path",
"required": true,
"type": "string"
},
- "zone": {
- "description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
+ "clusterId": {
+ "description": "The name of the cluster to upgrade.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ },
+ "projectId": {
+ "description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}",
"request": {
- "$ref": "CreateClusterRequest"
+ "$ref": "UpdateClusterRequest"
},
"response": {
"$ref": "Operation"
@@ -599,22 +599,16 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "completeIpRotation": {
- "description": "Completes master IP rotation.",
+ "startIpRotation": {
+ "description": "Start master IP rotation.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.completeIpRotation",
+ "id": "container.projects.zones.clusters.startIpRotation",
"parameterOrder": [
"projectId",
"zone",
"clusterId"
],
"parameters": {
- "projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
- "location": "path",
- "required": true,
- "type": "string"
- },
"zone": {
"description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
"location": "path",
@@ -626,11 +620,17 @@
"location": "path",
"required": true,
"type": "string"
+ },
+ "projectId": {
+ "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
+ "location": "path",
+ "required": true,
+ "type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:completeIpRotation",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}:startIpRotation",
"request": {
- "$ref": "CompleteIPRotationRequest"
+ "$ref": "StartIPRotationRequest"
},
"response": {
"$ref": "Operation"
@@ -643,14 +643,15 @@
"resources": {
"nodePools": {
"methods": {
- "list": {
- "description": "Lists the node pools for a cluster.",
+ "get": {
+ "description": "Retrieves the node pool requested.",
"httpMethod": "GET",
- "id": "container.projects.zones.clusters.nodePools.list",
+ "id": "container.projects.zones.clusters.nodePools.get",
"parameterOrder": [
"projectId",
"zone",
- "clusterId"
+ "clusterId",
+ "nodePoolId"
],
"parameters": {
"projectId": {
@@ -670,20 +671,26 @@
"location": "path",
"required": true,
"type": "string"
+ },
+ "nodePoolId": {
+ "description": "The name of the node pool.",
+ "location": "path",
+ "required": true,
+ "type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}",
"response": {
- "$ref": "ListNodePoolsResponse"
+ "$ref": "NodePool"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "rollback": {
- "description": "Roll back the previously Aborted or Failed NodePool upgrade.\nThis will be an no-op if the last upgrade successfully completed.",
+ "setManagement": {
+ "description": "Sets the NodeManagement options for a node pool.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.nodePools.rollback",
+ "id": "container.projects.zones.clusters.nodePools.setManagement",
"parameterOrder": [
"projectId",
"zone",
@@ -704,21 +711,21 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster to rollback.",
+ "description": "The name of the cluster to update.",
"location": "path",
"required": true,
"type": "string"
},
"nodePoolId": {
- "description": "The name of the node pool to rollback.",
+ "description": "The name of the node pool to update.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}:rollback",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}/setManagement",
"request": {
- "$ref": "RollbackNodePoolUpgradeRequest"
+ "$ref": "SetNodePoolManagementRequest"
},
"response": {
"$ref": "Operation"
@@ -727,16 +734,23 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "create": {
- "description": "Creates a node pool for a cluster.",
- "httpMethod": "POST",
- "id": "container.projects.zones.clusters.nodePools.create",
+ "delete": {
+ "description": "Deletes a node pool from a cluster.",
+ "httpMethod": "DELETE",
+ "id": "container.projects.zones.clusters.nodePools.delete",
"parameterOrder": [
"projectId",
"zone",
- "clusterId"
+ "clusterId",
+ "nodePoolId"
],
"parameters": {
+ "nodePoolId": {
+ "description": "The name of the node pool to delete.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ },
"projectId": {
"description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
"location": "path",
@@ -756,10 +770,7 @@
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools",
- "request": {
- "$ref": "CreateNodePoolRequest"
- },
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}",
"response": {
"$ref": "Operation"
},
@@ -767,23 +778,16 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "get": {
- "description": "Retrieves the node pool requested.",
+ "list": {
+ "description": "Lists the node pools for a cluster.",
"httpMethod": "GET",
- "id": "container.projects.zones.clusters.nodePools.get",
+ "id": "container.projects.zones.clusters.nodePools.list",
"parameterOrder": [
"projectId",
"zone",
- "clusterId",
- "nodePoolId"
+ "clusterId"
],
"parameters": {
- "nodePoolId": {
- "description": "The name of the node pool.",
- "location": "path",
- "required": true,
- "type": "string"
- },
"projectId": {
"description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
"location": "path",
@@ -803,18 +807,18 @@
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools",
"response": {
- "$ref": "NodePool"
+ "$ref": "ListNodePoolsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "setManagement": {
- "description": "Sets the NodeManagement options for a node pool.",
+ "rollback": {
+ "description": "Roll back the previously Aborted or Failed NodePool upgrade.\nThis will be an no-op if the last upgrade successfully completed.",
"httpMethod": "POST",
- "id": "container.projects.zones.clusters.nodePools.setManagement",
+ "id": "container.projects.zones.clusters.nodePools.rollback",
"parameterOrder": [
"projectId",
"zone",
@@ -822,12 +826,6 @@
"nodePoolId"
],
"parameters": {
- "nodePoolId": {
- "description": "The name of the node pool to update.",
- "location": "path",
- "required": true,
- "type": "string"
- },
"projectId": {
"description": "The Google Developers Console [project ID or project\nnumber](https://support.google.com/cloud/answer/6158840).",
"location": "path",
@@ -841,15 +839,21 @@
"type": "string"
},
"clusterId": {
- "description": "The name of the cluster to update.",
+ "description": "The name of the cluster to rollback.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ },
+ "nodePoolId": {
+ "description": "The name of the node pool to rollback.",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}/setManagement",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}:rollback",
"request": {
- "$ref": "SetNodePoolManagementRequest"
+ "$ref": "RollbackNodePoolUpgradeRequest"
},
"response": {
"$ref": "Operation"
@@ -858,23 +862,16 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
- "delete": {
- "description": "Deletes a node pool from a cluster.",
- "httpMethod": "DELETE",
- "id": "container.projects.zones.clusters.nodePools.delete",
+ "create": {
+ "description": "Creates a node pool for a cluster.",
+ "httpMethod": "POST",
+ "id": "container.projects.zones.clusters.nodePools.create",
"parameterOrder": [
"projectId",
"zone",
- "clusterId",
- "nodePoolId"
+ "clusterId"
],
"parameters": {
- "projectId": {
- "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
- "location": "path",
- "required": true,
- "type": "string"
- },
"zone": {
"description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
"location": "path",
@@ -887,14 +884,17 @@
"required": true,
"type": "string"
},
- "nodePoolId": {
- "description": "The name of the node pool to delete.",
+ "projectId": {
+ "description": "The Google Developers Console [project ID or project\nnumber](https://developers.google.com/console/help/new/#projectnumber).",
"location": "path",
"required": true,
"type": "string"
}
},
- "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools/{nodePoolId}",
+ "path": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/nodePools",
+ "request": {
+ "$ref": "CreateNodePoolRequest"
+ },
"response": {
"$ref": "Operation"
},
@@ -911,253 +911,115 @@
}
}
},
- "revision": "20170430",
+ "revision": "20170526",
"rootUrl": "https://container.googleapis.com/",
"schemas": {
- "HttpLoadBalancing": {
- "description": "Configuration options for the HTTP (L7) load balancing controller addon,\nwhich makes it easy to set up HTTP load balancers for services in a cluster.",
- "id": "HttpLoadBalancing",
+ "ListNodePoolsResponse": {
+ "description": "ListNodePoolsResponse is the result of ListNodePoolsRequest.",
+ "id": "ListNodePoolsResponse",
"properties": {
- "disabled": {
- "description": "Whether the HTTP Load Balancing controller is enabled in the cluster.\nWhen enabled, it runs a small pod in the cluster that manages the load\nbalancers.",
- "type": "boolean"
+ "nodePools": {
+ "description": "A list of node pools for a cluster.",
+ "items": {
+ "$ref": "NodePool"
+ },
+ "type": "array"
}
},
"type": "object"
},
- "NodePoolAutoscaling": {
- "description": "NodePoolAutoscaling contains information required by cluster autoscaler to\nadjust the size of the node pool to the current cluster usage.",
- "id": "NodePoolAutoscaling",
+ "CompleteIPRotationRequest": {
+ "description": "CompleteIPRotationRequest moves the cluster master back into single-IP mode.",
+ "id": "CompleteIPRotationRequest",
+ "properties": {},
+ "type": "object"
+ },
+ "StartIPRotationRequest": {
+ "description": "StartIPRotationRequest creates a new IP for the cluster and then performs\na node upgrade on each node pool to point to the new IP.",
+ "id": "StartIPRotationRequest",
+ "properties": {},
+ "type": "object"
+ },
+ "LegacyAbac": {
+ "description": "Configuration for the legacy Attribute Based Access Control authorization\nmode.",
+ "id": "LegacyAbac",
"properties": {
- "maxNodeCount": {
- "description": "Maximum number of nodes in the NodePool. Must be >= min_node_count. There\nhas to enough quota to scale up the cluster.",
- "format": "int32",
- "type": "integer"
- },
- "minNodeCount": {
- "description": "Minimum number of nodes in the NodePool. Must be >= 1 and <=\nmax_node_count.",
- "format": "int32",
- "type": "integer"
- },
"enabled": {
- "description": "Is autoscaling enabled for this node pool.",
+ "description": "Whether the ABAC authorizer is enabled for this cluster. When enabled,\nidentities in the system, including service accounts, nodes, and\ncontrollers, will have statically granted permissions beyond those\nprovided by the RBAC configuration or IAM.",
"type": "boolean"
}
},
"type": "object"
},
- "SetMasterAuthRequest": {
- "description": "SetMasterAuthRequest updates the admin password of a cluster.",
- "id": "SetMasterAuthRequest",
+ "SetLabelsRequest": {
+ "description": "SetLabelsRequest sets the Google Cloud Platform labels on a Google Container\nEngine cluster, which will in turn set them for Google Compute Engine\nresources used by that cluster",
+ "id": "SetLabelsRequest",
"properties": {
- "update": {
- "$ref": "MasterAuth",
- "description": "A description of the update."
+ "resourceLabels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "The labels to set for that cluster.",
+ "type": "object"
},
- "action": {
- "description": "The exact form of action to be taken on the master auth",
- "enum": [
- "UNKNOWN",
- "SET_PASSWORD",
- "GENERATE_PASSWORD"
- ],
- "enumDescriptions": [
- "Operation is unknown and will error out",
- "Set the password to a user generated value.",
- "Generate a new password and set it to that."
- ],
+ "labelFingerprint": {
+ "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by\nContainer Engine and changes after every request to modify or update\nlabels. You must always provide an up-to-date fingerprint hash when\nupdating or changing labels. Make a <code>get()</code> request to the\nresource to get the latest fingerprint.",
"type": "string"
}
},
"type": "object"
},
- "ClusterUpdate": {
- "description": "ClusterUpdate describes an update to the cluster. Exactly one update can\nbe applied to a cluster with each request, so at most one field can be\nprovided.",
- "id": "ClusterUpdate",
+ "NodePool": {
+ "description": "NodePool contains the name and configuration for a cluster's node pool.\nNode pools are a set of nodes (i.e. VM's), with a common configuration and\nspecification, under the control of the cluster master. They may have a set\nof Kubernetes labels applied to them, which may be used to reference them\nduring pod scheduling. They may also be resized up or down, to accommodate\nthe workload.",
+ "id": "NodePool",
"properties": {
- "desiredLocations": {
- "description": "The desired list of Google Compute Engine\n[locations](/compute/docs/zones#available) in which the cluster's nodes\nshould be located. Changing the locations a cluster is in will result\nin nodes being either created or removed from the cluster, depending on\nwhether locations are being added or removed.\n\nThis list must always include the cluster's primary zone.",
- "items": {
- "type": "string"
- },
- "type": "array"
+ "status": {
+ "description": "[Output only] The status of the nodes in this pool instance.",
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "PROVISIONING",
+ "RUNNING",
+ "RUNNING_WITH_ERROR",
+ "RECONCILING",
+ "STOPPING",
+ "ERROR"
+ ],
+ "enumDescriptions": [
+ "Not set.",
+ "The PROVISIONING state indicates the node pool is being created.",
+ "The RUNNING state indicates the node pool has been created\nand is fully usable.",
+ "The RUNNING_WITH_ERROR state indicates the node pool has been created\nand is partially usable. Some error state has occurred and some\nfunctionality may be impaired. Customer may need to reissue a request\nor trigger a new update.",
+ "The RECONCILING state indicates that some work is actively being done on\nthe node pool, such as upgrading node software. Details can\nbe found in the `statusMessage` field.",
+ "The STOPPING state indicates the node pool is being deleted.",
+ "The ERROR state indicates the node pool may be unusable. Details\ncan be found in the `statusMessage` field."
+ ],
+ "type": "string"
},
- "desiredNodePoolAutoscaling": {
- "$ref": "NodePoolAutoscaling",
- "description": "Autoscaler configuration for the node pool specified in\ndesired_node_pool_id. If there is only one pool in the\ncluster and desired_node_pool_id is not provided then\nthe change applies to that single node pool."
+ "config": {
+ "$ref": "NodeConfig",
+ "description": "The node configuration of the pool."
},
- "desiredMonitoringService": {
- "description": "The monitoring service the cluster should use to write metrics.\nCurrently available options:\n\n* \"monitoring.googleapis.com\" - the Google Cloud Monitoring service\n* \"none\" - no metrics will be exported from the cluster",
+ "statusMessage": {
+ "description": "[Output only] Additional information about the current status of this\nnode pool instance, if available.",
"type": "string"
},
- "desiredImageType": {
- "description": "The desired image type for the node pool.\nNOTE: Set the \"desired_node_pool\" field as well.",
+ "name": {
+ "description": "The name of the node pool.",
"type": "string"
},
- "desiredAddonsConfig": {
- "$ref": "AddonsConfig",
- "description": "Configurations for the various addons available to run in the cluster."
+ "autoscaling": {
+ "$ref": "NodePoolAutoscaling",
+ "description": "Autoscaler configuration for this NodePool. Autoscaler is enabled\nonly if a valid configuration is present."
},
- "desiredNodePoolId": {
- "description": "The node pool to be upgraded. This field is mandatory if\n\"desired_node_version\", \"desired_image_family\" or\n\"desired_node_pool_autoscaling\" is specified and there is more than one\nnode pool on the cluster.",
- "type": "string"
- },
- "desiredNodeVersion": {
- "description": "The Kubernetes version to change the nodes to (typically an\nupgrade). Use `-` to upgrade to the latest version supported by\nthe server.",
- "type": "string"
- },
- "desiredMasterVersion": {
- "description": "The Kubernetes version to change the master to. The only valid value is the\nlatest supported version. Use \"-\" to have the server automatically select\nthe latest version.",
- "type": "string"
- }
- },
- "type": "object"
- },
- "HorizontalPodAutoscaling": {
- "description": "Configuration options for the horizontal pod autoscaling feature, which\nincreases or decreases the number of replica pods a replication controller\nhas based on the resource usage of the existing pods.",
- "id": "HorizontalPodAutoscaling",
- "properties": {
- "disabled": {
- "description": "Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.\nWhen enabled, it ensures that a Heapster pod is running in the cluster,\nwhich is also used by the Cloud Monitoring service.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "Empty": {
- "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
- "id": "Empty",
- "properties": {},
- "type": "object"
- },
- "SetNodePoolManagementRequest": {
- "description": "SetNodePoolManagementRequest sets the node management properties of a node\npool.",
- "id": "SetNodePoolManagementRequest",
- "properties": {
"management": {
"$ref": "NodeManagement",
- "description": "NodeManagement configuration for the node pool."
- }
- },
- "type": "object"
- },
- "CreateClusterRequest": {
- "description": "CreateClusterRequest creates a cluster.",
- "id": "CreateClusterRequest",
- "properties": {
- "cluster": {
- "$ref": "Cluster",
- "description": "A [cluster\nresource](/container-engine/reference/rest/v1/projects.zones.clusters)"
- }
- },
- "type": "object"
- },
- "ListNodePoolsResponse": {
- "description": "ListNodePoolsResponse is the result of ListNodePoolsRequest.",
- "id": "ListNodePoolsResponse",
- "properties": {
- "nodePools": {
- "description": "A list of node pools for a cluster.",
- "items": {
- "$ref": "NodePool"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "CompleteIPRotationRequest": {
- "description": "CompleteIPRotationRequest moves the cluster master back into single-IP mode.",
- "id": "CompleteIPRotationRequest",
- "properties": {},
- "type": "object"
- },
- "StartIPRotationRequest": {
- "description": "StartIPRotationRequest creates a new IP for the cluster and then performs\na node upgrade on each node pool to point to the new IP.",
- "id": "StartIPRotationRequest",
- "properties": {},
- "type": "object"
- },
- "LegacyAbac": {
- "description": "Configuration for the legacy Attribute Based Access Control authorization\nmode.",
- "id": "LegacyAbac",
- "properties": {
- "enabled": {
- "description": "Whether the ABAC authorizer is enabled for this cluster. When enabled,\nidentities in the system, including service accounts, nodes, and\ncontrollers, will have statically granted permissions beyond those\nprovided by the RBAC configuration or IAM.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "SetLabelsRequest": {
- "description": "SetLabelsRequest sets the Google Cloud Platform labels on a Google Container\nEngine cluster, which will in turn set them for Google Compute Engine\nresources used by that cluster",
- "id": "SetLabelsRequest",
- "properties": {
- "resourceLabels": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "The labels to set for that cluster.",
- "type": "object"
- },
- "labelFingerprint": {
- "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by\nContainer Engine and changes after every request to modify or update\nlabels. You must always provide an up-to-date fingerprint hash when\nupdating or changing labels. Make a <code>get()</code> request to the\nresource to get the latest fingerprint.",
- "type": "string"
- }
- },
- "type": "object"
- },
- "NodePool": {
- "description": "NodePool contains the name and configuration for a cluster's node pool.\nNode pools are a set of nodes (i.e. VM's), with a common configuration and\nspecification, under the control of the cluster master. They may have a set\nof Kubernetes labels applied to them, which may be used to reference them\nduring pod scheduling. They may also be resized up or down, to accommodate\nthe workload.",
- "id": "NodePool",
- "properties": {
- "status": {
- "description": "[Output only] The status of the nodes in this pool instance.",
- "enum": [
- "STATUS_UNSPECIFIED",
- "PROVISIONING",
- "RUNNING",
- "RUNNING_WITH_ERROR",
- "RECONCILING",
- "STOPPING",
- "ERROR"
- ],
- "enumDescriptions": [
- "Not set.",
- "The PROVISIONING state indicates the node pool is being created.",
- "The RUNNING state indicates the node pool has been created\nand is fully usable.",
- "The RUNNING_WITH_ERROR state indicates the node pool has been created\nand is partially usable. Some error state has occurred and some\nfunctionality may be impaired. Customer may need to reissue a request\nor trigger a new update.",
- "The RECONCILING state indicates that some work is actively being done on\nthe node pool, such as upgrading node software. Details can\nbe found in the `statusMessage` field.",
- "The STOPPING state indicates the node pool is being deleted.",
- "The ERROR state indicates the node pool may be unusable. Details\ncan be found in the `statusMessage` field."
- ],
- "type": "string"
- },
- "config": {
- "$ref": "NodeConfig",
- "description": "The node configuration of the pool."
- },
- "name": {
- "description": "The name of the node pool.",
- "type": "string"
- },
- "statusMessage": {
- "description": "[Output only] Additional information about the current status of this\nnode pool instance, if available.",
- "type": "string"
- },
- "autoscaling": {
- "$ref": "NodePoolAutoscaling",
- "description": "Autoscaler configuration for this NodePool. Autoscaler is enabled\nonly if a valid configuration is present."
+ "description": "NodeManagement configuration for this NodePool."
},
"initialNodeCount": {
"description": "The initial node count for the pool. You must ensure that your\nCompute Engine <a href=\"/compute/docs/resource-quotas\">resource quota</a>\nis sufficient for this number of instances. You must also have available\nfirewall and routes quota.",
"format": "int32",
"type": "integer"
},
- "management": {
- "$ref": "NodeManagement",
- "description": "NodeManagement configuration for this NodePool."
- },
"selfLink": {
"description": "[Output only] Server-defined URL for the resource.",
"type": "string"
@@ -1216,18 +1078,44 @@
"description": "This operation resource represents operations that may have happened or are\nhappening on the cluster. All fields are output only.",
"id": "Operation",
"properties": {
- "selfLink": {
- "description": "Server-defined URL for the resource.",
+ "status": {
+ "description": "The current status of the operation.",
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "PENDING",
+ "RUNNING",
+ "DONE",
+ "ABORTING"
+ ],
+ "enumDescriptions": [
+ "Not set.",
+ "The operation has been created.",
+ "The operation is currently running.",
+ "The operation is done, either cancelled or completed.",
+ "The operation is aborting."
+ ],
"type": "string"
},
- "targetLink": {
- "description": "Server-defined URL for the target of the operation.",
+ "statusMessage": {
+ "description": "If an error has occurred, a textual description of the error.",
+ "type": "string"
+ },
+ "name": {
+ "description": "The server-assigned ID for the operation.",
+ "type": "string"
+ },
+ "selfLink": {
+ "description": "Server-defined URL for the resource.",
"type": "string"
},
"detail": {
"description": "Detailed operation progress, if available.",
"type": "string"
},
+ "targetLink": {
+ "description": "Server-defined URL for the target of the operation.",
+ "type": "string"
+ },
"operationType": {
"description": "The operation type.",
"enum": [
@@ -1267,32 +1155,6 @@
"zone": {
"description": "The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the operation\nis taking place.",
"type": "string"
- },
- "status": {
- "description": "The current status of the operation.",
- "enum": [
- "STATUS_UNSPECIFIED",
- "PENDING",
- "RUNNING",
- "DONE",
- "ABORTING"
- ],
- "enumDescriptions": [
- "Not set.",
- "The operation has been created.",
- "The operation is currently running.",
- "The operation is done, either cancelled or completed.",
- "The operation is aborting."
- ],
- "type": "string"
- },
- "name": {
- "description": "The server-assigned ID for the operation.",
- "type": "string"
- },
- "statusMessage": {
- "description": "If an error has occurred, a textual description of the error.",
- "type": "string"
}
},
"type": "object"
@@ -1333,43 +1195,89 @@
"description": "A Google Container Engine cluster.",
"id": "Cluster",
"properties": {
- "statusMessage": {
- "description": "[Output only] Additional information about the current status of this\ncluster, if available.",
+ "servicesIpv4Cidr": {
+ "description": "[Output only] The IP address range of the Kubernetes services in\nthis cluster, in\n[CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)\nnotation (e.g. `1.2.3.4/29`). Service addresses are\ntypically put in the last `/16` from the container CIDR.",
"type": "string"
},
- "masterAuth": {
- "$ref": "MasterAuth",
- "description": "The authentication information for accessing the master endpoint."
+ "enableKubernetesAlpha": {
+ "description": "Kubernetes alpha features are enabled on this cluster. This includes alpha\nAPI groups (e.g. v1alpha1) and features that may not be production ready in\nthe kubernetes version of the master and nodes.\nThe cluster has no SLA for uptime and master/node upgrades are disabled.\nAlpha enabled clusters are automatically deleted thirty days after\ncreation.",
+ "type": "boolean"
},
- "currentMasterVersion": {
- "description": "[Output only] The current software version of the master endpoint.",
+ "description": {
+ "description": "An optional description of this cluster.",
"type": "string"
},
- "nodeConfig": {
- "$ref": "NodeConfig",
- "description": "Parameters used in creating the cluster's nodes.\nSee `nodeConfig` for the description of its properties.\nFor requests, this field should only be used in lieu of a\n\"node_pool\" object, since this configuration (along with the\n\"initial_node_count\") will be used to create a \"NodePool\" object with an\nauto-generated name. Do not use this and a node_pool at the same time.\nFor responses, this field will be populated with the node configuration of\nthe first node pool.\n\nIf unspecified, the defaults are used."
+ "currentNodeCount": {
+ "description": "[Output only] The number of nodes currently in the cluster.",
+ "format": "int32",
+ "type": "integer"
},
- "addonsConfig": {
- "$ref": "AddonsConfig",
- "description": "Configurations for the various addons available to run in the cluster."
+ "monitoringService": {
+ "description": "The monitoring service the cluster should use to write metrics.\nCurrently available options:\n\n* `monitoring.googleapis.com` - the Google Cloud Monitoring service.\n* `none` - no metrics will be exported from the cluster.\n* if left as an empty string, `monitoring.googleapis.com` will be used.",
+ "type": "string"
},
- "status": {
- "description": "[Output only] The current status of this cluster.",
- "enum": [
- "STATUS_UNSPECIFIED",
- "PROVISIONING",
- "RUNNING",
- "RECONCILING",
- "STOPPING",
- "ERROR"
- ],
- "enumDescriptions": [
- "Not set.",
- "The PROVISIONING state indicates the cluster is being created.",
- "The RUNNING state indicates the cluster has been created and is fully\nusable.",
- "The RECONCILING state indicates that some work is actively being done on\nthe cluster, such as upgrading the master or node software. Details can\nbe found in the `statusMessage` field.",
- "The STOPPING state indicates the cluster is being deleted.",
- "The ERROR state indicates the cluster may be unusable. Details\ncan be found in the `statusMessage` field."
+ "network": {
+ "description": "The name of the Google Compute Engine\n[network](/compute/docs/networks-and-firewalls#networks) to which the\ncluster is connected. If left unspecified, the `default` network\nwill be used.",
+ "type": "string"
+ },
+ "labelFingerprint": {
+ "description": "The fingerprint of the set of labels for this cluster.",
+ "type": "string"
+ },
+ "zone": {
+ "description": "[Output only] The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
+ "type": "string"
+ },
+ "loggingService": {
+ "description": "The logging service the cluster should use to write logs.\nCurrently available options:\n\n* `logging.googleapis.com` - the Google Cloud Logging service.\n* `none` - no logs will be exported from the cluster.\n* if left as an empty string,`logging.googleapis.com` will be used.",
+ "type": "string"
+ },
+ "nodeIpv4CidrSize": {
+ "description": "[Output only] The size of the address space on each node for hosting\ncontainers. This is provisioned from within the `container_ipv4_cidr`\nrange.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "expireTime": {
+ "description": "[Output only] The time the cluster will be automatically\ndeleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.",
+ "type": "string"
+ },
+ "statusMessage": {
+ "description": "[Output only] Additional information about the current status of this\ncluster, if available.",
+ "type": "string"
+ },
+ "masterAuth": {
+ "$ref": "MasterAuth",
+ "description": "The authentication information for accessing the master endpoint."
+ },
+ "currentMasterVersion": {
+ "description": "[Output only] The current software version of the master endpoint.",
+ "type": "string"
+ },
+ "nodeConfig": {
+ "$ref": "NodeConfig",
+ "description": "Parameters used in creating the cluster's nodes.\nSee `nodeConfig` for the description of its properties.\nFor requests, this field should only be used in lieu of a\n\"node_pool\" object, since this configuration (along with the\n\"initial_node_count\") will be used to create a \"NodePool\" object with an\nauto-generated name. Do not use this and a node_pool at the same time.\nFor responses, this field will be populated with the node configuration of\nthe first node pool.\n\nIf unspecified, the defaults are used."
+ },
+ "addonsConfig": {
+ "$ref": "AddonsConfig",
+ "description": "Configurations for the various addons available to run in the cluster."
+ },
+ "status": {
+ "description": "[Output only] The current status of this cluster.",
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "PROVISIONING",
+ "RUNNING",
+ "RECONCILING",
+ "STOPPING",
+ "ERROR"
+ ],
+ "enumDescriptions": [
+ "Not set.",
+ "The PROVISIONING state indicates the cluster is being created.",
+ "The RUNNING state indicates the cluster has been created and is fully\nusable.",
+ "The RECONCILING state indicates that some work is actively being done on\nthe cluster, such as upgrading the master or node software. Details can\nbe found in the `statusMessage` field.",
+ "The STOPPING state indicates the cluster is being deleted.",
+ "The ERROR state indicates the cluster may be unusable. Details\ncan be found in the `statusMessage` field."
],
"type": "string"
},
@@ -1385,7 +1293,7 @@
"additionalProperties": {
"type": "string"
},
- "description": "The resource labels for the cluster to use to annotate any related GCE\nresources.",
+ "description": "The resource labels for the cluster to use to annotate any related\nGoogle Compute Engine resources.",
"type": "object"
},
"name": {
@@ -1441,52 +1349,6 @@
"type": "string"
},
"type": "array"
- },
- "servicesIpv4Cidr": {
- "description": "[Output only] The IP address range of the Kubernetes services in\nthis cluster, in\n[CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)\nnotation (e.g. `1.2.3.4/29`). Service addresses are\ntypically put in the last `/16` from the container CIDR.",
- "type": "string"
- },
- "enableKubernetesAlpha": {
- "description": "Kubernetes alpha features are enabled on this cluster. This includes alpha\nAPI groups (e.g. v1alpha1) and features that may not be production ready in\nthe kubernetes version of the master and nodes.\nThe cluster has no SLA for uptime and master/node upgrades are disabled.\nAlpha enabled clusters are automatically deleted thirty days after\ncreation.",
- "type": "boolean"
- },
- "description": {
- "description": "An optional description of this cluster.",
- "type": "string"
- },
- "currentNodeCount": {
- "description": "[Output only] The number of nodes currently in the cluster.",
- "format": "int32",
- "type": "integer"
- },
- "monitoringService": {
- "description": "The monitoring service the cluster should use to write metrics.\nCurrently available options:\n\n* `monitoring.googleapis.com` - the Google Cloud Monitoring service.\n* `none` - no metrics will be exported from the cluster.\n* if left as an empty string, `monitoring.googleapis.com` will be used.",
- "type": "string"
- },
- "network": {
- "description": "The name of the Google Compute Engine\n[network](/compute/docs/networks-and-firewalls#networks) to which the\ncluster is connected. If left unspecified, the `default` network\nwill be used.",
- "type": "string"
- },
- "labelFingerprint": {
- "description": "The fingerprint of the set of labels for this cluster.",
- "type": "string"
- },
- "zone": {
- "description": "[Output only] The name of the Google Compute Engine\n[zone](/compute/docs/zones#available) in which the cluster\nresides.",
- "type": "string"
- },
- "nodeIpv4CidrSize": {
- "description": "[Output only] The size of the address space on each node for hosting\ncontainers. This is provisioned from within the `container_ipv4_cidr`\nrange.",
- "format": "int32",
- "type": "integer"
- },
- "loggingService": {
- "description": "The logging service the cluster should use to write logs.\nCurrently available options:\n\n* `logging.googleapis.com` - the Google Cloud Logging service.\n* `none` - no logs will be exported from the cluster.\n* if left as an empty string,`logging.googleapis.com` will be used.",
- "type": "string"
- },
- "expireTime": {
- "description": "[Output only] The time the cluster will be automatically\ndeleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.",
- "type": "string"
}
},
"type": "object"
@@ -1506,17 +1368,17 @@
"description": "ListOperationsResponse is the result of ListOperationsRequest.",
"id": "ListOperationsResponse",
"properties": {
- "missingZones": {
- "description": "If any zones are listed here, the list of operations returned\nmay be missing the operations from those zones.",
+ "operations": {
+ "description": "A list of operations in the project in the specified zone.",
"items": {
- "type": "string"
+ "$ref": "Operation"
},
"type": "array"
},
- "operations": {
- "description": "A list of operations in the project in the specified zone.",
+ "missingZones": {
+ "description": "If any zones are listed here, the list of operations returned\nmay be missing the operations from those zones.",
"items": {
- "$ref": "Operation"
+ "type": "string"
},
"type": "array"
}
@@ -1527,13 +1389,6 @@
"description": "Container Engine service configuration.",
"id": "ServerConfig",
"properties": {
- "validMasterVersions": {
- "description": "List of valid master versions.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
"defaultClusterVersion": {
"description": "Version of Kubernetes the service deploys by default.",
"type": "string"
@@ -1555,33 +1410,13 @@
"type": "string"
},
"type": "array"
- }
- },
- "type": "object"
- },
- "MasterAuth": {
- "description": "The authentication information for accessing the master endpoint.\nAuthentication can be done using HTTP basic auth or using client\ncertificates.",
- "id": "MasterAuth",
- "properties": {
- "password": {
- "description": "The password to use for HTTP basic authentication to the master endpoint.\nBecause the master endpoint is open to the Internet, you should create a\nstrong password. If a password is provided for cluster creation, username\nmust be non-empty.",
- "type": "string"
- },
- "clientCertificate": {
- "description": "[Output only] Base64-encoded public certificate used by clients to\nauthenticate to the cluster endpoint.",
- "type": "string"
- },
- "username": {
- "description": "The username to use for HTTP basic authentication to the master endpoint.\nFor clusters v1.6.0 and later, you can disable basic authentication by\nproviding an empty username.",
- "type": "string"
- },
- "clientKey": {
- "description": "[Output only] Base64-encoded private key used by clients to authenticate\nto the cluster endpoint.",
- "type": "string"
},
- "clusterCaCertificate": {
- "description": "[Output only] Base64-encoded public certificate that is the root of\ntrust for the cluster.",
- "type": "string"
+ "validMasterVersions": {
+ "description": "List of valid master versions.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
}
},
"type": "object"
@@ -1590,6 +1425,25 @@
"description": "Parameters that describe the nodes in a cluster.",
"id": "NodeConfig",
"properties": {
+ "labels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "The map of Kubernetes labels (key/value pairs) to be applied to each node.\nThese will added in addition to any default label(s) that\nKubernetes may apply to the node.\nIn case of conflict in label keys, the applied set may differ depending on\nthe Kubernetes version -- it's best to assume the behavior is undefined\nand conflicts should be avoided.\nFor more information, including usage and the valid values, see:\nhttp://kubernetes.io/v1.1/docs/user-guide/labels.html",
+ "type": "object"
+ },
+ "localSsdCount": {
+ "description": "The number of local SSD disks to be attached to the node.\n\nThe limit for this value is dependant upon the maximum number of\ndisks available on a machine per zone. See:\nhttps://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits\nfor more information.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "metadata": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "The metadata key/value pairs assigned to instances in the cluster.\n\nKeys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes\nin length. These are reflected as part of a URL in the metadata server.\nAdditionally, to avoid ambiguity, keys must not conflict with any other\nmetadata keys for the project or be one of the four reserved keys:\n\"instance-template\", \"kube-env\", \"startup-script\", and \"user-data\"\n\nValues are free-form strings, and only have meaning as interpreted by\nthe image running in the instance. The only restriction placed on them is\nthat each value's size must be less than or equal to 32 KB.\n\nThe total size of all keys and values must be less than 512 KB.",
+ "type": "object"
+ },
"diskSizeGb": {
"description": "Size of the disk attached to each node, specified in GB.\nThe smallest allowed disk size is 10GB.\n\nIf unspecified, the default disk size is 100GB.",
"format": "int32",
@@ -1622,27 +1476,35 @@
"type": "array"
},
"preemptible": {
- "description": "Whether the nodes are created as preemptible VM instances. See:\nhttps://cloud.google.com/compute/docs/instances/preemptible for more\ninforamtion about preemptible VM instances.",
+ "description": "Whether the nodes are created as preemptible VM instances. See:\nhttps://cloud.google.com/compute/docs/instances/preemptible for more\ninformation about preemptible VM instances.",
"type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "MasterAuth": {
+ "description": "The authentication information for accessing the master endpoint.\nAuthentication can be done using HTTP basic auth or using client\ncertificates.",
+ "id": "MasterAuth",
+ "properties": {
+ "clientKey": {
+ "description": "[Output only] Base64-encoded private key used by clients to authenticate\nto the cluster endpoint.",
+ "type": "string"
},
- "labels": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "The map of Kubernetes labels (key/value pairs) to be applied to each node.\nThese will added in addition to any default label(s) that\nKubernetes may apply to the node.\nIn case of conflict in label keys, the applied set may differ depending on\nthe Kubernetes version -- it's best to assume the behavior is undefined\nand conflicts should be avoided.\nFor more information, including usage and the valid values, see:\nhttp://kubernetes.io/v1.1/docs/user-guide/labels.html",
- "type": "object"
+ "clusterCaCertificate": {
+ "description": "[Output only] Base64-encoded public certificate that is the root of\ntrust for the cluster.",
+ "type": "string"
},
- "localSsdCount": {
- "description": "The number of local SSD disks to be attached to the node.\n\nThe limit for this value is dependant upon the maximum number of\ndisks available on a machine per zone. See:\nhttps://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits\nfor more information.",
- "format": "int32",
- "type": "integer"
+ "password": {
+ "description": "The password to use for HTTP basic authentication to the master endpoint.\nBecause the master endpoint is open to the Internet, you should create a\nstrong password. If a password is provided for cluster creation, username\nmust be non-empty.",
+ "type": "string"
},
- "metadata": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "The metadata key/value pairs assigned to instances in the cluster.\n\nKeys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes\nin length. These are reflected as part of a URL in the metadata server.\nAdditionally, to avoid ambiguity, keys must not conflict with any other\nmetadata keys for the project or be one of the four reserved keys:\n\"instance-template\", \"kube-env\", \"startup-script\", and \"user-data\"\n\nValues are free-form strings, and only have meaning as interpreted by\nthe image running in the instance. The only restriction placed on them is\nthat each value's size must be less than or equal to 32 KB.\n\nThe total size of all keys and values must be less than 512 KB.",
- "type": "object"
+ "clientCertificate": {
+ "description": "[Output only] Base64-encoded public certificate used by clients to\nauthenticate to the cluster endpoint.",
+ "type": "string"
+ },
+ "username": {
+ "description": "The username to use for HTTP basic authentication to the master endpoint.\nFor clusters v1.6.0 and later, you can disable basic authentication by\nproviding an empty username.",
+ "type": "string"
}
},
"type": "object"
@@ -1651,13 +1513,13 @@
"description": "AutoUpgradeOptions defines the set of options for the user to control how\nthe Auto Upgrades will proceed.",
"id": "AutoUpgradeOptions",
"properties": {
- "description": {
- "description": "[Output only] This field is set when upgrades are about to commence\nwith the description of the upgrade.",
- "type": "string"
- },
"autoUpgradeStartTime": {
"description": "[Output only] This field is set when upgrades are about to commence\nwith the approximate start time for the upgrades, in\n[RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.",
"type": "string"
+ },
+ "description": {
+ "description": "[Output only] This field is set when upgrades are about to commence\nwith the description of the upgrade.",
+ "type": "string"
}
},
"type": "object"
@@ -1666,19 +1528,157 @@
"description": "ListClustersResponse is the result of ListClustersRequest.",
"id": "ListClustersResponse",
"properties": {
+ "clusters": {
+ "description": "A list of clusters in the project in the specified zone, or\nacross all ones.",
+ "items": {
+ "$ref": "Cluster"
+ },
+ "type": "array"
+ },
"missingZones": {
"description": "If any zones are listed here, the list of clusters returned\nmay be missing those zones.",
"items": {
"type": "string"
},
"type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "HttpLoadBalancing": {
+ "description": "Configuration options for the HTTP (L7) load balancing controller addon,\nwhich makes it easy to set up HTTP load balancers for services in a cluster.",
+ "id": "HttpLoadBalancing",
+ "properties": {
+ "disabled": {
+ "description": "Whether the HTTP Load Balancing controller is enabled in the cluster.\nWhen enabled, it runs a small pod in the cluster that manages the load\nbalancers.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "NodePoolAutoscaling": {
+ "description": "NodePoolAutoscaling contains information required by cluster autoscaler to\nadjust the size of the node pool to the current cluster usage.",
+ "id": "NodePoolAutoscaling",
+ "properties": {
+ "enabled": {
+ "description": "Is autoscaling enabled for this node pool.",
+ "type": "boolean"
},
- "clusters": {
- "description": "A list of clusters in the project in the specified zone, or\nacross all ones.",
+ "maxNodeCount": {
+ "description": "Maximum number of nodes in the NodePool. Must be >= min_node_count. There\nhas to enough quota to scale up the cluster.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "minNodeCount": {
+ "description": "Minimum number of nodes in the NodePool. Must be >= 1 and <=\nmax_node_count.",
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "SetMasterAuthRequest": {
+ "description": "SetMasterAuthRequest updates the admin password of a cluster.",
+ "id": "SetMasterAuthRequest",
+ "properties": {
+ "update": {
+ "$ref": "MasterAuth",
+ "description": "A description of the update."
+ },
+ "action": {
+ "description": "The exact form of action to be taken on the master auth",
+ "enum": [
+ "UNKNOWN",
+ "SET_PASSWORD",
+ "GENERATE_PASSWORD"
+ ],
+ "enumDescriptions": [
+ "Operation is unknown and will error out",
+ "Set the password to a user generated value.",
+ "Generate a new password and set it to that."
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ClusterUpdate": {
+ "description": "ClusterUpdate describes an update to the cluster. Exactly one update can\nbe applied to a cluster with each request, so at most one field can be\nprovided.",
+ "id": "ClusterUpdate",
+ "properties": {
+ "desiredAddonsConfig": {
+ "$ref": "AddonsConfig",
+ "description": "Configurations for the various addons available to run in the cluster."
+ },
+ "desiredNodePoolId": {
+ "description": "The node pool to be upgraded. This field is mandatory if\n\"desired_node_version\", \"desired_image_family\" or\n\"desired_node_pool_autoscaling\" is specified and there is more than one\nnode pool on the cluster.",
+ "type": "string"
+ },
+ "desiredNodeVersion": {
+ "description": "The Kubernetes version to change the nodes to (typically an\nupgrade). Use `-` to upgrade to the latest version supported by\nthe server.",
+ "type": "string"
+ },
+ "desiredMasterVersion": {
+ "description": "The Kubernetes version to change the master to. The only valid value is the\nlatest supported version. Use \"-\" to have the server automatically select\nthe latest version.",
+ "type": "string"
+ },
+ "desiredLocations": {
+ "description": "The desired list of Google Compute Engine\n[locations](/compute/docs/zones#available) in which the cluster's nodes\nshould be located. Changing the locations a cluster is in will result\nin nodes being either created or removed from the cluster, depending on\nwhether locations are being added or removed.\n\nThis list must always include the cluster's primary zone.",
"items": {
- "$ref": "Cluster"
+ "type": "string"
},
"type": "array"
+ },
+ "desiredNodePoolAutoscaling": {
+ "$ref": "NodePoolAutoscaling",
+ "description": "Autoscaler configuration for the node pool specified in\ndesired_node_pool_id. If there is only one pool in the\ncluster and desired_node_pool_id is not provided then\nthe change applies to that single node pool."
+ },
+ "desiredMonitoringService": {
+ "description": "The monitoring service the cluster should use to write metrics.\nCurrently available options:\n\n* \"monitoring.googleapis.com\" - the Google Cloud Monitoring service\n* \"none\" - no metrics will be exported from the cluster",
+ "type": "string"
+ },
+ "desiredImageType": {
+ "description": "The desired image type for the node pool.\nNOTE: Set the \"desired_node_pool\" field as well.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "HorizontalPodAutoscaling": {
+ "description": "Configuration options for the horizontal pod autoscaling feature, which\nincreases or decreases the number of replica pods a replication controller\nhas based on the resource usage of the existing pods.",
+ "id": "HorizontalPodAutoscaling",
+ "properties": {
+ "disabled": {
+ "description": "Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.\nWhen enabled, it ensures that a Heapster pod is running in the cluster,\nwhich is also used by the Cloud Monitoring service.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "SetNodePoolManagementRequest": {
+ "description": "SetNodePoolManagementRequest sets the node management properties of a node\npool.",
+ "id": "SetNodePoolManagementRequest",
+ "properties": {
+ "management": {
+ "$ref": "NodeManagement",
+ "description": "NodeManagement configuration for the node pool."
+ }
+ },
+ "type": "object"
+ },
+ "Empty": {
+ "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
+ "id": "Empty",
+ "properties": {},
+ "type": "object"
+ },
+ "CreateClusterRequest": {
+ "description": "CreateClusterRequest creates a cluster.",
+ "id": "CreateClusterRequest",
+ "properties": {
+ "cluster": {
+ "$ref": "Cluster",
+ "description": "A [cluster\nresource](/container-engine/reference/rest/v1/projects.zones.clusters)"
}
},
"type": "object"
« no previous file with comments | « discovery/googleapis/compute__v1.json ('k') | discovery/googleapis/content__v2.json » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698