discovery/googleapis/container__v1.json - Issue 1268013003: Api-roll 21: 2015-08-04

Side by Side Diff: discovery/googleapis/container__v1.json

Issue 1268013003: Api-roll 21: 2015-08-04 (Closed) Base URL: git@github.com:dart-lang/googleapis.git@master

Patch Set: Created 5 years, 4 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:

OLD	NEW
1 {	1 {

2 "auth": {	2 "auth": {

3 "oauth2": {	3 "oauth2": {

4 "scopes": {	4 "scopes": {

5 "https://www.googleapis.com/auth/cloud-platform": {	5 "https://www.googleapis.com/auth/cloud-platform": {

6 "description": "View and manage your data across Google Clou d Platform services"	6 "description": "View and manage your data across Google Clou d Platform services"

7 }	7 }

8 }	8 }

9 }	9 }

10 },	10 },

11 "basePath": "/container/v1beta1/projects/",	11 "basePath": "",

12 "baseUrl": "https://www.googleapis.com/container/v1beta1/projects/",	12 "baseUrl": "https://container.googleapis.com/",

13 "batchPath": "batch",	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.",	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",	15 "discoveryVersion": "v1",

16 "documentationLink": "https://cloud.google.com/container-engine/docs/v1beta1 /",	16 "documentationLink": "https://cloud.google.com/container-engine/",

17 "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/jvQWc8RdAvx_0wc81-C9InNwieA\"",	17 "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/6g1NnM2JgMMXgWbO_PX25Eu0zKs\"",

18 "icons": {	18 "icons": {

19 "x16": "http://www.google.com/images/icons/product/search-16.gif",	19 "x16": "http://www.google.com/images/icons/product/search-16.gif",

20 "x32": "http://www.google.com/images/icons/product/search-32.gif"	20 "x32": "http://www.google.com/images/icons/product/search-32.gif"

21 },	21 },

22 "id": "container:v1beta1",	22 "id": "container:v1",

23 "kind": "discovery#restDescription",	23 "kind": "discovery#restDescription",

24 "name": "container",	24 "name": "container",

25 "ownerDomain": "google.com",	25 "ownerDomain": "google.com",

26 "ownerName": "Google",	26 "ownerName": "Google",

27 "parameters": {	27 "parameters": {

	28 "access_token": {

	29 "description": "OAuth access token.",

	30 "location": "query",

	31 "type": "string"

	32 },

28 "alt": {	33 "alt": {

29 "default": "json",	34 "default": "json",

30 "description": "Data format for the response.",	35 "description": "Data format for response.",

31 "enum": [	36 "enumDescriptions": [

32 "json"	37 "Responses with Content-Type of application/json",

	38 "Media download with context-dependent Content-Type",

	39 "Responses with Content-Type of application/x-protobuf"

33 ],	40 ],

34 "enumDescriptions": [	41 "location": "query",

35 "Responses with Content-Type of application/json"	42 "type": "string"

36 ],	43 },

	44 "bearer_token": {

	45 "description": "OAuth bearer token.",

	46 "location": "query",

	47 "type": "string"

	48 },

	49 "callback": {

	50 "description": "JSONP",

37 "location": "query",	51 "location": "query",

38 "type": "string"	52 "type": "string"

39 },	53 },

40 "fields": {	54 "fields": {

41 "description": "Selector specifying which fields to include in a par tial response.",	55 "description": "Selector specifying which fields to include in a par tial response.",

42 "location": "query",	56 "location": "query",

43 "type": "string"	57 "type": "string"

44 },	58 },

45 "key": {	59 "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.",	60 "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",	61 "location": "query",

48 "type": "string"	62 "type": "string"

49 },	63 },

50 "oauth_token": {	64 "oauth_token": {

51 "description": "OAuth 2.0 token for the current user.",	65 "description": "OAuth 2.0 token for the current user.",

52 "location": "query",	66 "location": "query",

53 "type": "string"	67 "type": "string"

54 },	68 },

	69 "pp": {

	70 "default": "true",

	71 "description": "Pretty-print response.",

	72 "location": "query",

	73 "type": "boolean"

	74 },

55 "prettyPrint": {	75 "prettyPrint": {

56 "default": "true",	76 "default": "true",

57 "description": "Returns response with indentations and line breaks." ,	77 "description": "Returns response with indentations and line breaks." ,

58 "location": "query",	78 "location": "query",

59 "type": "boolean"	79 "type": "boolean"

60 },	80 },

61 "quotaUser": {	81 "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.",	82 "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.",

63 "location": "query",	83 "location": "query",

64 "type": "string"	84 "type": "string"

65 },	85 },

66 "userIp": {	86 "upload_protocol": {

67 "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",	87 "description": "Upload protocol for media (e.g. \"raw\", \"multipart \").",

	88 "location": "query",

	89 "type": "string"

	90 },

	91 "uploadType": {

	92 "description": "Legacy upload protocol for media (e.g. \"media\", \" multipart\").",

	93 "location": "query",

	94 "type": "string"

	95 },

	96 "$.xgafv": {

	97 "description": "V1 error format.",

	98 "enumDescriptions": [

	99 "v1 error format",

	100 "v2 error format"

	101 ],

68 "location": "query",	102 "location": "query",

69 "type": "string"	103 "type": "string"

70 }	104 }

71 },	105 },

72 "protocol": "rest",	106 "protocol": "rest",

73 "resources": {	107 "resources": {

74 "projects": {	108 "projects": {

75 "resources": {	109 "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": {	110 "zones": {

131 "resources": {	111 "resources": {

132 "clusters": {	112 "clusters": {

133 "methods": {	113 "methods": {

134 "create": {	114 "list": {

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.",	115 "description": "Lists all clusters owned by a project in either the specified zone or all zones.",

136 "httpMethod": "POST",	116 "httpMethod": "GET",

137 "id": "container.projects.zones.clusters.cre ate",	117 "id": "container.projects.zones.clusters.lis t",

138 "parameterOrder": [	118 "parameterOrder": [

139 "projectId",	119 "projectId",

140 "zoneId"	120 "zone"

141 ],	121 ],

142 "parameters": {	122 "parameters": {

143 "projectId": {	123 "projectId": {

144 "description": "The Google Developer s Console project ID or project number.",	124 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

145 "location": "path",	125 "location": "path",

146 "required": true,	126 "required": true,

147 "type": "string"	127 "type": "string"

148 },	128 },

149 "zoneId": {	129 "zone": {

150 "description": "The name of the Goog le Compute Engine zone in which the cluster resides.",	130 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides, or \"-\" for all zones.",

151 "location": "path",	131 "location": "path",

152 "required": true,	132 "required": true,

153 "type": "string"	133 "type": "string"

154 }	134 }

155 },	135 },

156 "path": "{projectId}/zones/{zoneId}/clusters ",	136 "path": "v1/projects/{projectId}/zones/{zone }/clusters",

	137 "response": {

	138 "$ref": "ListClustersResponse"

	139 },

	140 "scopes": [

	141 "https://www.googleapis.com/auth/cloud-p latform"

	142 ]

	143 },

	144 "get": {

	145 "description": "Gets a specific cluster.",

	146 "httpMethod": "GET",

	147 "id": "container.projects.zones.clusters.get ",

	148 "parameterOrder": [

	149 "projectId",

	150 "zone",

	151 "clusterId"

	152 ],

	153 "parameters": {

	154 "projectId": {

	155 "description": "The Google Developer s Console A [project ID](https://console.developers.google.com/project) or [proj ect number](https://developers.google.com/console/help/project-number)",

	156 "location": "path",

	157 "required": true,

	158 "type": "string"

	159 },

	160 "zone": {

	161 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides.",

	162 "location": "path",

	163 "required": true,

	164 "type": "string"

	165 },

	166 "clusterId": {

	167 "description": "The name of the clus ter to retrieve.",

	168 "location": "path",

	169 "required": true,

	170 "type": "string"

	171 }

	172 },

	173 "path": "v1/projects/{projectId}/zones/{zone }/clusters/{clusterId}",

	174 "response": {

	175 "$ref": "Cluster"

	176 },

	177 "scopes": [

	178 "https://www.googleapis.com/auth/cloud-p latform"

	179 ]

	180 },

	181 "create": {

	182 "description": "Creates a cluster, consistin g of the specified number and type of Google Compute Engine instances, plus a Ku bernetes master endpoint. By default, the cluster is created in the project's [d efault network]('/compute/docs/networking#networks_1'). One firewall is added fo r the cluster. After cluster creation, the cluster creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster. Finally, an entry is added to the project's global metadata indicat ing which CIDR range is being used by the cluster.",

	183 "httpMethod": "POST",

	184 "id": "container.projects.zones.clusters.cre ate",

	185 "parameterOrder": [

	186 "projectId",

	187 "zone"

	188 ],

	189 "parameters": {

	190 "projectId": {

	191 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

	192 "location": "path",

	193 "required": true,

	194 "type": "string"

	195 },

	196 "zone": {

	197 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides.",

	198 "location": "path",

	199 "required": true,

	200 "type": "string"

	201 }

	202 },

	203 "path": "v1/projects/{projectId}/zones/{zone }/clusters",

157 "request": {	204 "request": {

158 "$ref": "CreateClusterRequest"	205 "$ref": "CreateClusterRequest"

159 },	206 },

160 "response": {	207 "response": {

161 "$ref": "Operation"	208 "$ref": "Operation"

162 },	209 },

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": [	210 "scopes": [

201 "https://www.googleapis.com/auth/cloud-p latform"	211 "https://www.googleapis.com/auth/cloud-p latform"

202 ]	212 ]

203 },	213 },

204 "get": {	214 "update": {

205 "description": "Gets a specific cluster.",	215 "description": "Update settings of a specifi c cluster.",

206 "httpMethod": "GET",	216 "httpMethod": "PUT",

207 "id": "container.projects.zones.clusters.get ",	217 "id": "container.projects.zones.clusters.upd ate",

208 "parameterOrder": [	218 "parameterOrder": [

209 "projectId",	219 "projectId",

210 "zoneId",	220 "zone",

211 "clusterId"	221 "clusterId"

212 ],	222 ],

213 "parameters": {	223 "parameters": {

214 "clusterId": {	224 "projectId": {

215 "description": "The name of the clus ter to retrieve.",	225 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

216 "location": "path",	226 "location": "path",

217 "required": true,	227 "required": true,

218 "type": "string"	228 "type": "string"

219 },	229 },

220 "projectId": {	230 "zone": {

221 "description": "The Google Developer s Console project ID or project number.",	231 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides.",

222 "location": "path",	232 "location": "path",

223 "required": true,	233 "required": true,

224 "type": "string"	234 "type": "string"

225 },	235 },

226 "zoneId": {	236 "clusterId": {

227 "description": "The name of the Goog le Compute Engine zone in which the cluster resides.",	237 "description": "The name of the clus ter to upgrade.",

228 "location": "path",	238 "location": "path",

229 "required": true,	239 "required": true,

230 "type": "string"	240 "type": "string"

231 }	241 }

232 },	242 },

233 "path": "{projectId}/zones/{zoneId}/clusters /{clusterId}",	243 "path": "v1/projects/{projectId}/zones/{zone }/clusters/{clusterId}",

	244 "request": {

	245 "$ref": "UpdateClusterRequest"

	246 },

234 "response": {	247 "response": {

235 "$ref": "Cluster"	248 "$ref": "Operation"

236 },	249 },

237 "scopes": [	250 "scopes": [

238 "https://www.googleapis.com/auth/cloud-p latform"	251 "https://www.googleapis.com/auth/cloud-p latform"

239 ]	252 ]

240 },	253 },

241 "list": {	254 "delete": {

242 "description": "Lists all clusters owned by a project in the specified zone.",	255 "description": "Deletes the cluster, includi ng the Kubernetes endpoint and all worker nodes. Firewalls and routes that were configured during cluster creation are also deleted.",

243 "httpMethod": "GET",	256 "httpMethod": "DELETE",

244 "id": "container.projects.zones.clusters.lis t",	257 "id": "container.projects.zones.clusters.del ete",

245 "parameterOrder": [	258 "parameterOrder": [

246 "projectId",	259 "projectId",

247 "zoneId"	260 "zone",

	261 "clusterId"

248 ],	262 ],

249 "parameters": {	263 "parameters": {

250 "projectId": {	264 "projectId": {

251 "description": "The Google Developer s Console project ID or project number.",	265 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

252 "location": "path",	266 "location": "path",

253 "required": true,	267 "required": true,

254 "type": "string"	268 "type": "string"

255 },	269 },

256 "zoneId": {	270 "zone": {

257 "description": "The name of the Goog le Compute Engine zone in which the cluster resides.",	271 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides.",

	272 "location": "path",

	273 "required": true,

	274 "type": "string"

	275 },

	276 "clusterId": {

	277 "description": "The name of the clus ter to delete.",

258 "location": "path",	278 "location": "path",

259 "required": true,	279 "required": true,

260 "type": "string"	280 "type": "string"

261 }	281 }

262 },	282 },

263 "path": "{projectId}/zones/{zoneId}/clusters ",	283 "path": "v1/projects/{projectId}/zones/{zone }/clusters/{clusterId}",

264 "response": {	284 "response": {

265 "$ref": "ListClustersResponse"	285 "$ref": "Operation"

266 },	286 },

267 "scopes": [	287 "scopes": [

268 "https://www.googleapis.com/auth/cloud-p latform"	288 "https://www.googleapis.com/auth/cloud-p latform"

269 ]	289 ]

270 }	290 }

271 }	291 }

272 },	292 },

273 "operations": {	293 "operations": {

274 "methods": {	294 "methods": {

	295 "list": {

	296 "description": "Lists all operations in a pr oject in a specific zone or all zones.",

	297 "httpMethod": "GET",

	298 "id": "container.projects.zones.operations.l ist",

	299 "parameterOrder": [

	300 "projectId",

	301 "zone"

	302 ],

	303 "parameters": {

	304 "projectId": {

	305 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

	306 "location": "path",

	307 "required": true,

	308 "type": "string"

	309 },

	310 "zone": {

	311 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) to return operations for , or \"-\" for all zones.",

	312 "location": "path",

	313 "required": true,

	314 "type": "string"

	315 }

	316 },

	317 "path": "v1/projects/{projectId}/zones/{zone }/operations",

	318 "response": {

	319 "$ref": "ListOperationsResponse"

	320 },

	321 "scopes": [

	322 "https://www.googleapis.com/auth/cloud-p latform"

	323 ]

	324 },

275 "get": {	325 "get": {

276 "description": "Gets the specified operation .",	326 "description": "Gets the specified operation .",

277 "httpMethod": "GET",	327 "httpMethod": "GET",

278 "id": "container.projects.zones.operations.g et",	328 "id": "container.projects.zones.operations.g et",

279 "parameterOrder": [	329 "parameterOrder": [

280 "projectId",	330 "projectId",

281 "zoneId",	331 "zone",

282 "operationId"	332 "operationId"

283 ],	333 ],

284 "parameters": {	334 "parameters": {

285 "operationId": {	335 "projectId": {

286 "description": "The server-assigned name of the operation.",	336 "description": "The Google Developer s Console [project ID](https://console.developers.google.com/project) or [projec t number](https://developers.google.com/console/help/project-number)",

287 "location": "path",	337 "location": "path",

288 "required": true,	338 "required": true,

289 "type": "string"	339 "type": "string"

290 },	340 },

291 "projectId": {	341 "zone": {

292 "description": "The Google Developer s Console project ID or project number.",	342 "description": "The name of the Goog le Compute Engine [zone](/compute/docs/zones#available) in which the cluster res ides.",

293 "location": "path",	343 "location": "path",

294 "required": true,	344 "required": true,

295 "type": "string"	345 "type": "string"

296 },	346 },

297 "zoneId": {	347 "operationId": {

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.",	348 "description": "The server-assigned `name` of the operation.",

299 "location": "path",	349 "location": "path",

300 "required": true,	350 "required": true,

301 "type": "string"	351 "type": "string"

302 }	352 }

303 },	353 },

304 "path": "{projectId}/zones/{zoneId}/operatio ns/{operationId}",	354 "path": "v1/projects/{projectId}/zones/{zone }/operations/{operationId}",

305 "response": {	355 "response": {

306 "$ref": "Operation"	356 "$ref": "Operation"

307 },	357 },

308 "scopes": [	358 "scopes": [

309 "https://www.googleapis.com/auth/cloud-p latform"	359 "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 ]	360 ]

341 }	361 }

342 }	362 }

343 }	363 }

344 }	364 }

345 }	365 }

346 }	366 }

347 }	367 }

348 },	368 },

349 "revision": "20150624",	369 "revision": "20150605",

350 "rootUrl": "https://www.googleapis.com/",	370 "rootUrl": "https://container.googleapis.com/",

351 "schemas": {	371 "schemas": {

352 "Cluster": {	372 "ListClustersResponse": {

353 "id": "Cluster",	373 "description": "ListClustersResponse is the result of ListClustersRe quest.",

354 "properties": {	374 "id": "ListClustersResponse",

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 or 172.16.0.0/12.",

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": {	375 "properties": {

464 "clusters": {	376 "clusters": {

465 "description": "A list of clusters in the project, across al l zones.",	377 "description": "A list of clusters in the project in the spe cified zone, or across all ones.",

466 "items": {	378 "items": {

467 "$ref": "Cluster"	379 "$ref": "Cluster"

468 },	380 },

469 "type": "array"	381 "type": "array"

470 }	382 }

471 },	383 },

472 "type": "object"	384 "type": "object"

473 },	385 },

474 "ListAggregatedOperationsResponse": {	386 "Cluster": {

475 "id": "ListAggregatedOperationsResponse",	387 "description": "A Google Container Engine cluster.",

	388 "id": "Cluster",

476 "properties": {	389 "properties": {

477 "operations": {	390 "name": {

478 "description": "A list of operations in the project, across all zones.",	391 "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: * Lowercase letters, numbers, and hyphens only. * Must start with a letter. * Must end with a number or a letter.",

	392 "type": "string"

	393 },

	394 "description": {

	395 "description": "An optional description of this cluster.",

	396 "type": "string"

	397 },

	398 "initialNodeCount": {

	399 "description": "The number of nodes to create in this cluste r. You must ensure that your Compute Engine [resource quota](/compute/docs/resou rce-quotas) is sufficient for this number of instances. You must also have avail able firewall and routes quota.",

	400 "format": "int32",

	401 "type": "integer"

	402 },

	403 "nodeConfig": {

	404 "$ref": "NodeConfig",

	405 "description": "Parameters used in creating the cluster's no des. See the descriptions of the child properties of `nodeConfig`."

	406 },

	407 "masterAuth": {

	408 "$ref": "MasterAuth",

	409 "description": "The authentication information for accessing the master."

	410 },

	411 "loggingService": {

	412 "description": "The logging service that the cluster should write logs to. Currently available options: * \"logging.googleapis.com\" - the G oogle Cloud Logging service * \"none\" - no logs will be exported from the clust er * \"\" - default value; the default is \"logging.googleapis.com\"",

	413 "type": "string"

	414 },

	415 "monitoringService": {

	416 "description": "The monitoring service that the cluster shou ld write metrics to. Currently available options: * \"monitoring.googleapis.com\ " - the Google Cloud Monitoring service * \"none\" - no metrics will be exported from the cluster * \"\" - default value; the default is \"monitoring.googleapis .com\"",

	417 "type": "string"

	418 },

	419 "network": {

	420 "description": "The name of the Google Compute Engine [netwo rk](/compute/docs/networking#networks_1) to which the cluster is connected. If l eft unspecified, the \"default\" network will be used.",

	421 "type": "string"

	422 },

	423 "clusterIpv4Cidr": {

	424 "description": "The IP address range of the container pods i n this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Ro uting) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically cho sen or specify a `/14` block in `10.0.0.0/8` or `172.16.0.0/12`.",

	425 "type": "string"

	426 },

	427 "selfLink": {

	428 "description": "[Output only] Server-defined URL for the res ource. @OutputOnly.",

	429 "type": "string"

	430 },

	431 "zone": {

	432 "description": "[Output only] The name of the Google Compute Engine [zone](/compute/docs/zones#available) in which the cluster resides. @Out putOnly.",

	433 "type": "string"

	434 },

	435 "endpoint": {

	436 "description": "[Output only] The IP address of this cluster 's Kubernetes master endpoint. The endpoint can be accessed from the internet at `https://username:password@endpoint/`. @OutputOnly. See the `masterAuth` proper ty of this resource for username and password information.",

	437 "type": "string"

	438 },

	439 "initialClusterVersion": {

	440 "description": "[Output only] The software version of Kubern etes master and kubelets used in the cluster when it was first created. The vers ion can be upgraded over time. @OutputOnly.",

	441 "type": "string"

	442 },

	443 "currentMasterVersion": {

	444 "description": "[Output only] The current software version o f the master endpoint. @OutputOnly.",

	445 "type": "string"

	446 },

	447 "currentNodeVersion": {

	448 "description": "[Output only] The current version of the nod e software components. If they are currently at different versions because they' re in the process of being upgraded, this reflects the minimum version of any of them. @OutputOnly.",

	449 "type": "string"

	450 },

	451 "createTime": {

	452 "description": "[Output only] The time the cluster was creat ed, in [RFC3339](href='https://www.ietf.org/rfc/rfc3339.txt) text format. @Outpu tOnly.",

	453 "type": "string"

	454 },

	455 "status": {

	456 "description": "[Output only] The current status of this clu ster. @OutputOnly.",

	457 "enum": [

	458 "STATUS_UNSPECIFIED",

	459 "PROVISIONING",

	460 "RUNNING",

	461 "RECONCILING",

	462 "STOPPING",

	463 "ERROR"

	464 ],

	465 "type": "string"

	466 },

	467 "statusMessage": {

	468 "description": "[Output only] Additional information about t he current status of this cluster, if available. @OutputOnly.",

	469 "type": "string"

	470 },

	471 "nodeIpv4CidrSize": {

	472 "description": "[Output only] The size of the address space on each node for hosting containers. This is provisioned from within the contain er_ipv4_cidr range. @OutputOnly.",

	473 "format": "int32",

	474 "type": "integer"

	475 },

	476 "servicesIpv4Cidr": {

	477 "description": "[Output only] The IP address range of the Ku bernetes services in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classl ess_Inter-Domain_Routing) notation (e.g. `1.2.3.4/29`). Service addresses are ty pically put in the last /16 from the container CIDR. @OutputOnly.",

	478 "type": "string"

	479 },

	480 "instanceGroupUrls": {

	481 "description": "[Output only] The resource URLs of [instance groups](/compute/docs/instance-groups/) associated with this cluster. @OutputOn ly.",

479 "items": {	482 "items": {

480 "$ref": "Operation"	483 "type": "string"

481 },	484 },

482 "type": "array"	485 "type": "array"

483 }	486 }

484 },	487 },

485 "type": "object"	488 "type": "object"

486 },	489 },

487 "ListClustersResponse": {	490 "NodeConfig": {

488 "id": "ListClustersResponse",	491 "description": "Per-node parameters.",

	492 "id": "NodeConfig",

489 "properties": {	493 "properties": {

490 "clusters": {	494 "machineType": {

491 "description": "A list of clusters in the project in the spe cified zone.",	495 "description": "The name of a Google Compute Engine [machine type](/compute/docs/machine-types) (e.g. `n1-standard-1`). If unspecified, the default machine type is `n1-standard-1`.",

	496 "type": "string"

	497 },

	498 "diskSizeGb": {

	499 "description": "Size of the disk attached to each node, spec ified in GB. The smallest allowed disk size is 10GB, and the default is 100GB.",

	500 "format": "int32",

	501 "type": "integer"

	502 },

	503 "oauthScopes": {

	504 "description": "The set of Google API scopes to be made avai lable on all of the node VMs under the \"default\" service account. Currently, t he following scopes are necessary to ensure the correct functioning of the clust er: * \"https://www.googleapis.com/auth/compute\" * \"https://www.googleapis.com /auth/devstorage.read_only\"",

492 "items": {	505 "items": {

493 "$ref": "Cluster"	506 "type": "string"

494 },	507 },

495 "type": "array"	508 "type": "array"

496 }	509 }

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 },	510 },

511 "type": "object"	511 "type": "object"

512 },	512 },

513 "MasterAuth": {	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.",	514 "description": "The authentication information for accessing the mas ter endpoint. Authentication can be done using HTTP basic auth or using client c ertificates.",

515 "id": "MasterAuth",	515 "id": "MasterAuth",

516 "properties": {	516 "properties": {

517 "bearerToken": {	517 "username": {

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 \".",	518 "description": "The username to use for HTTP basic authentic ation when accessing the Kubernetes master endpoint.",

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"	519 "type": "string"

532 },	520 },

533 "password": {	521 "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.",	522 "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"	523 "type": "string"

536 },	524 },

537 "user": {	525 "clusterCaCertificate": {

538 "description": "The username to use for HTTP basic authentic ation when accessing the Kubernetes master endpoint.",	526 "description": "[Output only] Base64 encoded public certific ate that is the root of trust for the cluster. @OutputOnly.",

	527 "type": "string"

	528 },

	529 "clientCertificate": {

	530 "description": "[Output only] Base64 encoded public certific ate used by clients to authenticate to the cluster endpoint. @OutputOnly.",

	531 "type": "string"

	532 },

	533 "clientKey": {

	534 "description": "[Output only] Base64 encoded private key use d by clients to authenticate to the cluster endpoint. @OutputOnly.",

539 "type": "string"	535 "type": "string"

540 }	536 }

541 },	537 },

542 "type": "object"	538 "type": "object"

543 },	539 },

544 "NodeConfig": {	540 "CreateClusterRequest": {

545 "id": "NodeConfig",	541 "description": "CreateClusterRequest creates a cluster.",

	542 "id": "CreateClusterRequest",

546 "properties": {	543 "properties": {

547 "machineType": {	544 "cluster": {

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.",	545 "$ref": "Cluster",

549 "type": "string"	546 "description": "A [cluster resource](/container-engine/docs/ v1/projects/zones/clusters)"

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 }	547 }

562 },	548 },

563 "type": "object"	549 "type": "object"

564 },	550 },

565 "Operation": {	551 "Operation": {

566 "description": "Defines the operation resource. All fields are outpu t only.",	552 "description": "Defines the operation resource. All fields are outpu t only.",

567 "id": "Operation",	553 "id": "Operation",

568 "properties": {	554 "properties": {

569 "errorMessage": {	555 "name": {

570 "description": "If an error has occurred, a textual descript ion of the error.",	556 "description": "The server-assigned ID for the operation. @O utputOnly.",

571 "type": "string"	557 "type": "string"

572 },	558 },

573 "name": {	559 "zone": {

574 "description": "The server-assigned ID for the operation.",	560 "description": "The name of the Google Compute Engine [zone] (/compute/docs/zones#available) in which the operation is taking place. @OutputO nly.",

575 "type": "string"	561 "type": "string"

576 },	562 },

577 "operationType": {	563 "operationType": {

578 "description": "The operation type.",	564 "description": "The operation type. @OutputOnly.",

579 "enum": [	565 "enum": [

580 "createCluster",	566 "TYPE_UNSPECIFIED",

581 "deleteCluster"	567 "CREATE_CLUSTER",

582 ],	568 "DELETE_CLUSTER",

583 "enumDescriptions": [	569 "UPGRADE_MASTER",

584 "",	570 "UPGRADE_NODES",

585 ""	571 "REPAIR_CLUSTER"

586 ],	572 ],

587 "type": "string"	573 "type": "string"

588 },	574 },

589 "selfLink": {

590 "description": "Server-defined URL for the resource.",

591 "type": "string"

592 },

593 "status": {	575 "status": {

594 "description": "The current status of the operation.",	576 "description": "The current status of the operation. @Output Only.",

595 "enum": [	577 "enum": [

596 "done",	578 "STATUS_UNSPECIFIED",

597 "pending",	579 "PENDING",

598 "running"	580 "RUNNING",

599 ],	581 "DONE"

600 "enumDescriptions": [

601 "",

602 "",

603 ""

604 ],	582 ],

605 "type": "string"	583 "type": "string"

606 },	584 },

607 "target": {	585 "statusMessage": {

608 "description": "[Optional] The URL of the cluster resource t hat this operation is associated with.",	586 "description": "If an error has occurred, a textual descript ion of the error. @OutputOnly.",

	587 "type": "string"

	588 },

	589 "selfLink": {

	590 "description": "Server-defined URL for the resource. @Output Only.",

609 "type": "string"	591 "type": "string"

610 },	592 },

611 "targetLink": {	593 "targetLink": {

612 "description": "Server-defined URL for the target of the ope ration.",	594 "description": "Server-defined URL for the target of the ope ration. @OutputOnly.",

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"	595 "type": "string"

618 }	596 }

619 },	597 },

620 "type": "object"	598 "type": "object"

621 },	599 },

622 "ServiceAccount": {	600 "UpdateClusterRequest": {

623 "description": "A Compute Engine service account.",	601 "description": "UpdateClusterRequest updates a cluster.",

624 "id": "ServiceAccount",	602 "id": "UpdateClusterRequest",

625 "properties": {	603 "properties": {

626 "email": {	604 "update": {

627 "description": "Email address of the service account.",	605 "$ref": "ClusterUpdate",

	606 "description": "A description of the update."

	607 }

	608 },

	609 "type": "object"

	610 },

	611 "ClusterUpdate": {

	612 "description": "ClusterUpdate describes an update to the cluster.",

	613 "id": "ClusterUpdate",

	614 "properties": {

	615 "desiredNodeVersion": {

	616 "description": "The Kubernetes version to change the nodes t o (typically an upgrade). Use \"-\" to upgrade to the latest version supported b y the server.",

628 "type": "string"	617 "type": "string"

629 },	618 }

630 "scopes": {	619 },

631 "description": "The list of scopes to be made available for this service account.",	620 "type": "object"

	621 },

	622 "ListOperationsResponse": {

	623 "description": "ListOperationsResponse is the result of ListOperatio nsRequest.",

	624 "id": "ListOperationsResponse",

	625 "properties": {

	626 "operations": {

	627 "description": "A list of operations in the project in the s pecified zone.",

632 "items": {	628 "items": {

633 "type": "string"	629 "$ref": "Operation"

634 },	630 },

635 "type": "array"	631 "type": "array"

636 }	632 }

637 },	633 },

638 "type": "object"	634 "type": "object"

639 }	635 }

640 },	636 },

641 "servicePath": "container/v1beta1/projects/",	637 "servicePath": "",

642 "title": "Google Container Engine API",	638 "title": "Google Container Engine API",

643 "version": "v1beta1"	639 "version": "v1"

644 }	640 }

OLD	NEW

« no previous file with comments | « discovery/googleapis/compute__v1.json ('k') | discovery/googleapis/content__v2.json » ('j') | discovery/googleapis/dfareporting__v2.0.json » ('J')