-
Notifications
You must be signed in to change notification settings - Fork 4
/
instanceGroupManagers.clj
560 lines (477 loc) · 22.6 KB
/
instanceGroupManagers.clj
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
(ns happygapi.compute.instanceGroupManagers
"Compute Engine API: instanceGroupManagers.
Creates and runs virtual machines on Google Cloud Platform.
See: https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers"
(:require [cheshire.core :as json]
[clj-http.client :as http]
[happy.util :as util]))
(defn listManagedInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/listManagedInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: filter, maxResults, order_by, pageToken
Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"
"https://www.googleapis.com/auth/compute.readonly"]}
[auth args]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn setInstanceTemplate$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/setInstanceTemplate
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:instanceTemplate string}
Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn get$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/get
Required parameters: instanceGroupManager, project, zone
Optional parameters: none
Returns all of the details about the specified managed instance group. Gets a list of available managed instance groups by making a list() request."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"
"https://www.googleapis.com/auth/compute.readonly"]}
[auth args]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/get
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn insert$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/insert
Required parameters: project, zone
Optional parameters: requestId
Body:
{:description string,
:updatePolicy {:instanceRedistributionType string,
:maxSurge FixedOrPercent,
:maxUnavailable FixedOrPercent,
:minimalAction string,
:type string},
:creationTimestamp string,
:zone string,
:name string,
:selfLink string,
:targetPools [string],
:region string,
:currentActions {:recreating integer,
:restarting integer,
:creating integer,
:deleting integer,
:refreshing integer,
:abandoning integer,
:verifying integer,
:none integer,
:creatingWithoutRetries integer},
:autoHealingPolicies [{:healthCheck string, :initialDelaySec integer}],
:status {:isStable boolean,
:versionTarget InstanceGroupManagerStatusVersionTarget},
:instanceGroup string,
:id string,
:kind string,
:distributionPolicy {:zones [DistributionPolicyZoneConfiguration]},
:baseInstanceName string,
:versions [{:instanceTemplate string,
:name string,
:targetSize FixedOrPercent}],
:targetSize integer,
:instanceTemplate string,
:fingerprint string,
:namedPorts [{:name string, :port integer}]}
Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers"
#{:zone :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn abandonInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/abandonInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:instances [string]}
Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn recreateInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/recreateInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:instances [string]}
Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn applyUpdatesToInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/applyUpdatesToInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: none
Body:
{:instances [string],
:minimalAction string,
:mostDisruptiveAllowedAction string}
Apply changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn patch$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/patch
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:description string,
:updatePolicy {:instanceRedistributionType string,
:maxSurge FixedOrPercent,
:maxUnavailable FixedOrPercent,
:minimalAction string,
:type string},
:creationTimestamp string,
:zone string,
:name string,
:selfLink string,
:targetPools [string],
:region string,
:currentActions {:recreating integer,
:restarting integer,
:creating integer,
:deleting integer,
:refreshing integer,
:abandoning integer,
:verifying integer,
:none integer,
:creatingWithoutRetries integer},
:autoHealingPolicies [{:healthCheck string, :initialDelaySec integer}],
:status {:isStable boolean,
:versionTarget InstanceGroupManagerStatusVersionTarget},
:instanceGroup string,
:id string,
:kind string,
:distributionPolicy {:zones [DistributionPolicyZoneConfiguration]},
:baseInstanceName string,
:versions [{:instanceTemplate string,
:name string,
:targetSize FixedOrPercent}],
:targetSize integer,
:instanceTemplate string,
:fingerprint string,
:namedPorts [{:name string, :port integer}]}
Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/patch
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn aggregatedList$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/aggregatedList
Required parameters: project
Optional parameters: filter, maxResults, orderBy, pageToken
Retrieves the list of managed instance groups and groups them by zone."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"
"https://www.googleapis.com/auth/compute.readonly"]}
[auth args]
{:pre [(util/has-keys? args #{:project})]}
(util/get-response
(http/get
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/aggregated/instanceGroupManagers"
#{:project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn delete$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/delete
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/delete
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn resize$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/resize
Required parameters: instanceGroupManager, project, size, zone
Optional parameters: requestId
Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including:
+ The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance.
This list is subject to change.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args]
{:pre [(util/has-keys?
args
#{:zone :instanceGroupManager :size :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize"
#{:zone :instanceGroupManager :size :project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn setTargetPools$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/setTargetPools
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:fingerprint string, :targetPools [string]}
Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn list$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/list
Required parameters: project, zone
Optional parameters: filter, maxResults, orderBy, pageToken
Retrieves a list of managed instance groups that are contained within the specified project and zone."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"
"https://www.googleapis.com/auth/compute.readonly"]}
[auth args]
{:pre [(util/has-keys? args #{:zone :project})]}
(util/get-response
(http/get
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers"
#{:zone :project}
args)
(merge-with
merge
{:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn createInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/createInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:instances [{:fingerprint string, :name string}]}
Creates instances with per-instance configs in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))
(defn deleteInstances$
"https://developers.google.com/compute/docs/reference/latest/api/reference/rest/v1/instanceGroupManagers/deleteInstances
Required parameters: instanceGroupManager, project, zone
Optional parameters: requestId
Body:
{:instances [string]}
Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request."
{:scopes ["https://www.googleapis.com/auth/cloud-platform"
"https://www.googleapis.com/auth/compute"]}
[auth args body]
{:pre [(util/has-keys? args #{:zone :instanceGroupManager :project})]}
(util/get-response
(http/post
(util/get-url
"https://compute.googleapis.com/compute/v1/projects/"
"{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances"
#{:zone :instanceGroupManager :project}
args)
(merge-with
merge
{:content-type :json,
:body (json/generate-string body),
:throw-exceptions false,
:query-params args,
:accept :json,
:as :json}
auth))))