linodeapi 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 20a479c17b644b53b3a30f2ab0bde78f208a927c
4
- data.tar.gz: 50fe1be948698cb2799856bbab81962c61a8eaea
3
+ metadata.gz: 2bb89d05c98ea7f75197a191ff416262b6264c32
4
+ data.tar.gz: cb9ee0b2f15d1fbd7c5434502e4d37c126be1edd
5
5
  SHA512:
6
- metadata.gz: f917e9aa3306e452c8cde8d6a00a8af61e8533eec2bf4ad5b38bfdeb2b71c2c944f146b05431ea7a0affd66ef705ecc3317e9bd23601e2b0fe288548f176f971
7
- data.tar.gz: d40d46c444681a38c52e71dd3f29ec801996e1fd235f700e4967e83d1d6fbd03b760c5404282077e0a22f54b1e2dabc2e4ff9d26a4cc26685352e868faff4b1b
6
+ metadata.gz: 4cbd8c6355395392e01ddae32c7392cee3950bbbbd2b00c59b8085cc86c5047b5eb2e750e09795767f952f9832e4289ab9b068d2afd6c4479570496c521fb036
7
+ data.tar.gz: 4dc00e59bbb2d9186f9e33bbf969d290ecd5002d7db33292c4c6f1286d998355079d3c66865dfafc2191b26f2cde2f539184f5ef739e8a97815a253ef5c1fd04
data/.travis.yml CHANGED
@@ -2,8 +2,10 @@ language: ruby
2
2
  cache: bundler
3
3
  sudo: false
4
4
  rvm:
5
+ - 2.2.2
6
+ - 2.2.1
5
7
  - 2.2.0
6
- - 2.1.5
8
+ - 2.1.6
7
9
  - 2.0.0-p598
8
10
  - 1.9.3-p551
9
11
  notifications:
data/dev/cache_spec.rb ADDED
@@ -0,0 +1,25 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require 'linodeapi'
4
+ require 'yaml'
5
+
6
+ SPEC_FILE = $ARGV.first || 'dev/spec.yml'
7
+
8
+ def parse_node(node)
9
+ return clean_node(node) if node[:type] == :call
10
+ Hash[node[:subs].sort.map { |k, v| [k.to_s, parse_node(v)] }]
11
+ end
12
+
13
+ def clean_node(node)
14
+ node.delete(:type)
15
+ hash_to_array(node)
16
+ end
17
+
18
+ def hash_to_array(hash)
19
+ return hash unless hash.is_a? Hash
20
+ hash.to_a.sort.map { |x| Hash[x.first.to_s, hash_to_array(x.last)] }
21
+ end
22
+
23
+ result = parse_node(LinodeAPI.spec)
24
+
25
+ File.open(SPEC_FILE, 'w') { |fh| fh << YAML.dump(result) }
data/dev/spec.yml ADDED
@@ -0,0 +1,1563 @@
1
+ ---
2
+ account:
3
+ estimateinvoice:
4
+ - desc: 'Estimates the invoice for adding a new Linode or NodeBalancer as well as
5
+ resizing a Linode. This returns two fields: PRICE which is the estimated cost
6
+ of the invoice, and INVOICE_TO which is the date invoice would be though with
7
+ timezone set to America/New_York'
8
+ - params:
9
+ - linodeid:
10
+ - desc: This is the LinodeID you want to resize and is required for mode 'linode_resize'.
11
+ - required: false
12
+ - type: :numeric
13
+ - mode:
14
+ - desc: 'This is one of the following options: ''linode_new'', ''linode_resize'',
15
+ or ''nodebalancer_new''.'
16
+ - required: true
17
+ - type: :string
18
+ - paymentterm:
19
+ - desc: 'Subscription term in months. One of: 1, 12, or 24. This is required
20
+ for modes ''linode_new'' and ''nodebalancer_new''.'
21
+ - required: false
22
+ - type: :numeric
23
+ - planid:
24
+ - desc: The desired PlanID available from avail.LinodePlans(). This is required
25
+ for modes 'linode_new' and 'linode_resize'.
26
+ - required: false
27
+ - type: :numeric
28
+ - throws:
29
+ - VALIDATION
30
+ info:
31
+ - desc: Shows information about your account such as the date your account was opened
32
+ as well as your network utilization for the current month in gigabytes.
33
+ - params: []
34
+ - throws: []
35
+ paybalance:
36
+ - desc: Pays current balance on file, returning it in the response.
37
+ - params: []
38
+ - throws:
39
+ - CCEXPIRED
40
+ - CCFAILED
41
+ - NOACCESS
42
+ - PAYMENTLIMITER
43
+ - VALIDATION
44
+ updatecard:
45
+ - desc: ''
46
+ - params:
47
+ - ccexpmonth:
48
+ - desc: ''
49
+ - required: true
50
+ - type: :numeric
51
+ - ccexpyear:
52
+ - desc: ''
53
+ - required: true
54
+ - type: :numeric
55
+ - ccnumber:
56
+ - desc: ''
57
+ - required: true
58
+ - type: :numeric
59
+ - throws: []
60
+ api:
61
+ spec:
62
+ - desc: 'Returns a data structure of the entire Linode API specification. This
63
+ method does not require authorization.<br><br>For example: <a target="_blank"
64
+ href="https://api.linode.com/?api_action=api.spec">https://api.linode.com/?api_action=api.spec</a>'
65
+ - params: []
66
+ - throws: []
67
+ avail:
68
+ datacenters:
69
+ - desc: Returns a list of Linode data center facilities.
70
+ - params: []
71
+ - throws: []
72
+ distributions:
73
+ - desc: Returns a list of available Linux Distributions.
74
+ - params:
75
+ - distributionid:
76
+ - desc: Limits the results to the specified DistributionID
77
+ - required: false
78
+ - type: :numeric
79
+ - throws: []
80
+ kernels:
81
+ - desc: List available kernels.
82
+ - params:
83
+ - isxen:
84
+ - desc: Limits the results to show only Xen kernels
85
+ - required: false
86
+ - type: :boolean
87
+ - kernelid:
88
+ - desc: ''
89
+ - required: false
90
+ - type: :numeric
91
+ - throws: []
92
+ linodeplans:
93
+ - desc: Returns a structure of Linode PlanIDs containing the Plan label and the
94
+ availability in each Datacenter.
95
+ - params:
96
+ - planid:
97
+ - desc: Limits the list to the specified PlanID
98
+ - required: false
99
+ - type: :numeric
100
+ - throws: []
101
+ nodebalancers:
102
+ - desc: Returns NodeBalancer pricing information.
103
+ - params: []
104
+ - throws: []
105
+ stackscripts:
106
+ - desc: Returns a list of available public StackScripts.
107
+ - params:
108
+ - distributionid:
109
+ - desc: Limit the results to StackScripts that can be applied to this DistributionID
110
+ - required: false
111
+ - type: :numeric
112
+ - distributionvendor:
113
+ - desc: Debian, Ubuntu, Fedora, etc.
114
+ - required: false
115
+ - type: :string
116
+ - keywords:
117
+ - desc: Search terms
118
+ - required: false
119
+ - type: :string
120
+ - throws: []
121
+ domain:
122
+ create:
123
+ - desc: Create a domain record.
124
+ - params:
125
+ - axfr_ips:
126
+ - desc: IP addresses allowed to AXFR the entire zone, semicolon separated
127
+ - required: false
128
+ - type: :string
129
+ - description:
130
+ - desc: Currently undisplayed.
131
+ - required: false
132
+ - type: :string
133
+ - domain:
134
+ - desc: The zone's name
135
+ - required: true
136
+ - type: :string
137
+ - expire_sec:
138
+ - desc: ''
139
+ - required: false
140
+ - type: :numeric
141
+ - lpm_displaygroup:
142
+ - desc: Display group in the Domain list inside the Linode DNS Manager
143
+ - required: false
144
+ - type: :string
145
+ - master_ips:
146
+ - desc: 'When type=slave, the zone''s master DNS servers list, semicolon separated '
147
+ - required: false
148
+ - type: :string
149
+ - refresh_sec:
150
+ - desc: ''
151
+ - required: false
152
+ - type: :numeric
153
+ - retry_sec:
154
+ - desc: ''
155
+ - required: false
156
+ - type: :numeric
157
+ - soa_email:
158
+ - desc: Required when type=master
159
+ - required: false
160
+ - type: :string
161
+ - status:
162
+ - desc: 0, 1, or 2 (disabled, active, edit mode)
163
+ - required: false
164
+ - type: :numeric
165
+ - ttl_sec:
166
+ - desc: ''
167
+ - required: false
168
+ - type: :numeric
169
+ - type:
170
+ - desc: master or slave
171
+ - required: true
172
+ - type: :string
173
+ - throws:
174
+ - NOACCESS
175
+ - VALIDATION
176
+ delete:
177
+ - desc: ''
178
+ - params:
179
+ - domainid:
180
+ - desc: ''
181
+ - required: true
182
+ - type: :numeric
183
+ - throws:
184
+ - NOTFOUND
185
+ list:
186
+ - desc: Lists domains you have access to.
187
+ - params:
188
+ - domainid:
189
+ - desc: Limits the list to the specified DomainID
190
+ - required: false
191
+ - type: :numeric
192
+ - throws: []
193
+ resource:
194
+ create:
195
+ - desc: Create a domain record.
196
+ - params:
197
+ - domainid:
198
+ - desc: ''
199
+ - required: true
200
+ - type: :numeric
201
+ - name:
202
+ - desc: The hostname or FQDN. When Type=MX the subdomain to delegate to the
203
+ Target MX server.
204
+ - required: false
205
+ - type: :string
206
+ - port:
207
+ - desc: ''
208
+ - required: false
209
+ - type: :numeric
210
+ - priority:
211
+ - desc: Priority for MX and SRV records, 0-255
212
+ - required: false
213
+ - type: :numeric
214
+ - protocol:
215
+ - desc: The protocol to append to an SRV record. Ignored on other record
216
+ types.
217
+ - required: false
218
+ - type: :string
219
+ - target:
220
+ - desc: When Type=MX the hostname. When Type=CNAME the target of the alias. When
221
+ Type=TXT the value of the record. When Type=A or AAAA the token of '[remote_addr]'
222
+ will be substituted with the IP address of the request.
223
+ - required: false
224
+ - type: :string
225
+ - ttl_sec:
226
+ - desc: TTL. Leave as 0 to accept our default.
227
+ - required: false
228
+ - type: :numeric
229
+ - type:
230
+ - desc: 'One of: NS, MX, A, AAAA, CNAME, TXT, or SRV'
231
+ - required: true
232
+ - type: :string
233
+ - weight:
234
+ - desc: ''
235
+ - required: false
236
+ - type: :numeric
237
+ - throws:
238
+ - NOACCESS
239
+ - VALIDATION
240
+ delete:
241
+ - desc: ''
242
+ - params:
243
+ - domainid:
244
+ - desc: ''
245
+ - required: true
246
+ - type: :numeric
247
+ - resourceid:
248
+ - desc: ''
249
+ - required: true
250
+ - type: :numeric
251
+ - throws:
252
+ - NOTFOUND
253
+ list:
254
+ - desc: ''
255
+ - params:
256
+ - domainid:
257
+ - desc: ''
258
+ - required: true
259
+ - type: :numeric
260
+ - resourceid:
261
+ - desc: ''
262
+ - required: false
263
+ - type: :numeric
264
+ - throws: []
265
+ update:
266
+ - desc: Update a domain record.
267
+ - params:
268
+ - domainid:
269
+ - desc: ''
270
+ - required: false
271
+ - type: :numeric
272
+ - name:
273
+ - desc: The hostname or FQDN. When Type=MX the subdomain to delegate to the
274
+ Target MX server.
275
+ - required: false
276
+ - type: :string
277
+ - port:
278
+ - desc: ''
279
+ - required: false
280
+ - type: :numeric
281
+ - priority:
282
+ - desc: Priority for MX and SRV records, 0-255
283
+ - required: false
284
+ - type: :numeric
285
+ - protocol:
286
+ - desc: The protocol to append to an SRV record. Ignored on other record
287
+ types.
288
+ - required: false
289
+ - type: :string
290
+ - resourceid:
291
+ - desc: ''
292
+ - required: true
293
+ - type: :numeric
294
+ - target:
295
+ - desc: When Type=MX the hostname. When Type=CNAME the target of the alias. When
296
+ Type=TXT the value of the record. When Type=A or AAAA the token of '[remote_addr]'
297
+ will be substituted with the IP address of the request.
298
+ - required: false
299
+ - type: :string
300
+ - ttl_sec:
301
+ - desc: TTL. Leave as 0 to accept our default.
302
+ - required: false
303
+ - type: :numeric
304
+ - weight:
305
+ - desc: ''
306
+ - required: false
307
+ - type: :numeric
308
+ - throws:
309
+ - NOTFOUND
310
+ - VALIDATION
311
+ update:
312
+ - desc: Update a domain record.
313
+ - params:
314
+ - axfr_ips:
315
+ - desc: IP addresses allowed to AXFR the entire zone, semicolon separated
316
+ - required: false
317
+ - type: :string
318
+ - description:
319
+ - desc: Currently undisplayed.
320
+ - required: false
321
+ - type: :string
322
+ - domain:
323
+ - desc: The zone's name
324
+ - required: false
325
+ - type: :string
326
+ - domainid:
327
+ - desc: ''
328
+ - required: true
329
+ - type: :numeric
330
+ - expire_sec:
331
+ - desc: ''
332
+ - required: false
333
+ - type: :numeric
334
+ - lpm_displaygroup:
335
+ - desc: Display group in the Domain list inside the Linode DNS Manager
336
+ - required: false
337
+ - type: :string
338
+ - master_ips:
339
+ - desc: 'When type=slave, the zone''s master DNS servers list, semicolon separated '
340
+ - required: false
341
+ - type: :string
342
+ - refresh_sec:
343
+ - desc: ''
344
+ - required: false
345
+ - type: :numeric
346
+ - retry_sec:
347
+ - desc: ''
348
+ - required: false
349
+ - type: :numeric
350
+ - soa_email:
351
+ - desc: Required when type=master
352
+ - required: false
353
+ - type: :string
354
+ - status:
355
+ - desc: 0, 1, or 2 (disabled, active, edit mode)
356
+ - required: false
357
+ - type: :numeric
358
+ - ttl_sec:
359
+ - desc: ''
360
+ - required: false
361
+ - type: :numeric
362
+ - type:
363
+ - desc: master or slave
364
+ - required: false
365
+ - type: :string
366
+ - throws:
367
+ - NOTFOUND
368
+ - VALIDATION
369
+ image:
370
+ delete:
371
+ - desc: Deletes a gold-master image
372
+ - params:
373
+ - imageid:
374
+ - desc: The ID of the gold-master image to delete
375
+ - required: true
376
+ - type: :numeric
377
+ - throws:
378
+ - NOTFOUND
379
+ list:
380
+ - desc: Lists available gold-master images
381
+ - params:
382
+ - imageid:
383
+ - desc: Request information for a specific gold-master image
384
+ - required: false
385
+ - type: :numeric
386
+ - pending:
387
+ - desc: Show images currently being created.
388
+ - required: false
389
+ - type: :numeric
390
+ - throws:
391
+ - NOTFOUND
392
+ update:
393
+ - desc: Update an Image record.
394
+ - params:
395
+ - description:
396
+ - desc: An optional description of the Image.
397
+ - required: false
398
+ - type: :string
399
+ - imageid:
400
+ - desc: The ID of the Image to modify.
401
+ - required: true
402
+ - type: :numeric
403
+ - label:
404
+ - desc: The label of the Image.
405
+ - required: false
406
+ - type: :string
407
+ - throws:
408
+ - NOTFOUND
409
+ - VALIDATION
410
+ linode:
411
+ boot:
412
+ - desc: Issues a boot job for the provided ConfigID. If no ConfigID is provided
413
+ boots the last used configuration profile, or the first configuration profile
414
+ if this Linode has never been booted.
415
+ - params:
416
+ - configid:
417
+ - desc: The ConfigID to boot, available from linode.config.list().
418
+ - required: false
419
+ - type: :numeric
420
+ - linodeid:
421
+ - desc: ''
422
+ - required: true
423
+ - type: :numeric
424
+ - throws:
425
+ - NOTFOUND
426
+ clone:
427
+ - desc: Creates a new Linode, assigns you full privileges, and then clones the specified
428
+ LinodeID to the new Linode. There is a limit of 5 active clone operations per
429
+ source Linode. It is recommended that the source Linode be powered down during
430
+ the clone.
431
+ - params:
432
+ - datacenterid:
433
+ - desc: The DatacenterID from avail.datacenters() where you wish to place this
434
+ new Linode
435
+ - required: true
436
+ - type: :numeric
437
+ - linodeid:
438
+ - desc: The LinodeID that you want cloned
439
+ - required: true
440
+ - type: :numeric
441
+ - paymentterm:
442
+ - desc: 'Subscription term in months for prepaid customers. One of: 1, 12,
443
+ or 24'
444
+ - required: false
445
+ - type: :numeric
446
+ - planid:
447
+ - desc: The desired PlanID available from avail.LinodePlans()
448
+ - required: true
449
+ - type: :numeric
450
+ - throws:
451
+ - NOACCESS
452
+ - NOTFOUND
453
+ - CCFAILED
454
+ - VALIDATION
455
+ - LINODELIMITER
456
+ - ACCOUNTLIMIT
457
+ config:
458
+ create:
459
+ - desc: Creates a Linode Configuration Profile.
460
+ - params:
461
+ - comments:
462
+ - desc: Comments you wish to save along with this profile
463
+ - required: false
464
+ - type: :string
465
+ - devtmpfs_automount:
466
+ - desc: 'Controls if pv_ops kernels should automount devtmpfs at boot. '
467
+ - required: false
468
+ - type: :boolean
469
+ - disklist:
470
+ - desc: A comma delimited list of DiskIDs; position reflects device node. The
471
+ 9th element for specifying the initrd.
472
+ - required: true
473
+ - type: :string
474
+ - helper_depmod:
475
+ - desc: 'Creates an empty modprobe file for the kernel you''re booting. '
476
+ - required: false
477
+ - type: :boolean
478
+ - helper_disableupdatedb:
479
+ - desc: Enable the disableUpdateDB filesystem helper
480
+ - required: false
481
+ - type: :boolean
482
+ - helper_network:
483
+ - desc: Automatically creates network configuration files for your distro
484
+ and places them into your filesystem.
485
+ - required: false
486
+ - type: :boolean
487
+ - helper_xen:
488
+ - desc: Enable the Xen filesystem helper. Corrects fstab and inittab/upstart
489
+ entries depending on the kernel you're booting. You want this.
490
+ - required: false
491
+ - type: :boolean
492
+ - kernelid:
493
+ - desc: The KernelID for this profile. Found in avail.kernels()
494
+ - required: true
495
+ - type: :numeric
496
+ - label:
497
+ - desc: The Label for this profile
498
+ - required: true
499
+ - type: :string
500
+ - linodeid:
501
+ - desc: ''
502
+ - required: true
503
+ - type: :numeric
504
+ - ramlimit:
505
+ - desc: RAMLimit in MB. 0 for max.
506
+ - required: false
507
+ - type: :numeric
508
+ - rootdevicecustom:
509
+ - desc: A custom root device setting.
510
+ - required: false
511
+ - type: :string
512
+ - rootdevicenum:
513
+ - desc: Which device number (1-8) that contains the root partition. 0 to
514
+ utilize RootDeviceCustom.
515
+ - required: false
516
+ - type: :numeric
517
+ - rootdevicero:
518
+ - desc: 'Enables the ''ro'' kernel flag. Modern distros want this. '
519
+ - required: false
520
+ - type: :boolean
521
+ - runlevel:
522
+ - desc: 'One of ''default'', ''single'', ''binbash'' '
523
+ - required: false
524
+ - type: :string
525
+ - throws:
526
+ - NOTFOUND
527
+ - VALIDATION
528
+ delete:
529
+ - desc: Deletes a Linode Configuration Profile.
530
+ - params:
531
+ - configid:
532
+ - desc: ''
533
+ - required: true
534
+ - type: :numeric
535
+ - linodeid:
536
+ - desc: ''
537
+ - required: true
538
+ - type: :numeric
539
+ - throws:
540
+ - NOTFOUND
541
+ - VALIDATION
542
+ list:
543
+ - desc: Lists a Linode's Configuration Profiles.
544
+ - params:
545
+ - configid:
546
+ - desc: ''
547
+ - required: false
548
+ - type: :numeric
549
+ - linodeid:
550
+ - desc: ''
551
+ - required: true
552
+ - type: :numeric
553
+ - throws:
554
+ - NOTFOUND
555
+ update:
556
+ - desc: Updates a Linode Configuration Profile.
557
+ - params:
558
+ - comments:
559
+ - desc: Comments you wish to save along with this profile
560
+ - required: false
561
+ - type: :string
562
+ - configid:
563
+ - desc: ''
564
+ - required: true
565
+ - type: :numeric
566
+ - devtmpfs_automount:
567
+ - desc: 'Controls if pv_ops kernels should automount devtmpfs at boot. '
568
+ - required: false
569
+ - type: :boolean
570
+ - disklist:
571
+ - desc: A comma delimited list of DiskIDs; position reflects device node. The
572
+ 9th element for specifying the initrd.
573
+ - required: false
574
+ - type: :string
575
+ - helper_depmod:
576
+ - desc: 'Creates an empty modprobe file for the kernel you''re booting. '
577
+ - required: false
578
+ - type: :boolean
579
+ - helper_disableupdatedb:
580
+ - desc: Enable the disableUpdateDB filesystem helper
581
+ - required: false
582
+ - type: :boolean
583
+ - helper_network:
584
+ - desc: Automatically creates network configuration files for your distro
585
+ and places them into your filesystem.
586
+ - required: false
587
+ - type: :boolean
588
+ - helper_xen:
589
+ - desc: Enable the Xen filesystem helper. Corrects fstab and inittab/upstart
590
+ entries depending on the kernel you're booting. You want this.
591
+ - required: false
592
+ - type: :boolean
593
+ - kernelid:
594
+ - desc: The KernelID for this profile. Found in avail.kernels()
595
+ - required: false
596
+ - type: :numeric
597
+ - label:
598
+ - desc: The Label for this profile
599
+ - required: false
600
+ - type: :string
601
+ - linodeid:
602
+ - desc: ''
603
+ - required: false
604
+ - type: :numeric
605
+ - ramlimit:
606
+ - desc: RAMLimit in MB. 0 for max.
607
+ - required: false
608
+ - type: :numeric
609
+ - rootdevicecustom:
610
+ - desc: A custom root device setting.
611
+ - required: false
612
+ - type: :string
613
+ - rootdevicenum:
614
+ - desc: Which device number (1-8) that contains the root partition. 0 to
615
+ utilize RootDeviceCustom.
616
+ - required: false
617
+ - type: :numeric
618
+ - rootdevicero:
619
+ - desc: 'Enables the ''ro'' kernel flag. Modern distros want this. '
620
+ - required: false
621
+ - type: :boolean
622
+ - runlevel:
623
+ - desc: 'One of ''default'', ''single'', ''binbash'' '
624
+ - required: false
625
+ - type: :string
626
+ - throws:
627
+ - NOTFOUND
628
+ - VALIDATION
629
+ create:
630
+ - desc: Creates a Linode and assigns you full privileges. There is a 75-linodes-per-hour
631
+ limiter.
632
+ - params:
633
+ - datacenterid:
634
+ - desc: The DatacenterID from avail.datacenters() where you wish to place this
635
+ new Linode
636
+ - required: true
637
+ - type: :numeric
638
+ - paymentterm:
639
+ - desc: 'Subscription term in months for prepaid customers. One of: 1, 12,
640
+ or 24'
641
+ - required: false
642
+ - type: :numeric
643
+ - planid:
644
+ - desc: The desired PlanID available from avail.LinodePlans()
645
+ - required: true
646
+ - type: :numeric
647
+ - throws:
648
+ - NOACCESS
649
+ - CCFAILED
650
+ - VALIDATION
651
+ - LINODELIMITER
652
+ - ACCOUNTLIMIT
653
+ delete:
654
+ - desc: Immediately removes a Linode from your account and issues a pro-rated credit
655
+ back to your account, if applicable. To prevent accidental deletes, this requires
656
+ the Linode has no Disk images. You must first delete its disk images."
657
+ - params:
658
+ - linodeid:
659
+ - desc: The LinodeID to delete
660
+ - required: true
661
+ - type: :numeric
662
+ - skipchecks:
663
+ - desc: Skips the safety checks and will always delete the Linode
664
+ - required: false
665
+ - type: :boolean
666
+ - throws:
667
+ - NOTFOUND
668
+ - LINODENOTEMPTY
669
+ disk:
670
+ create:
671
+ - desc: ''
672
+ - params:
673
+ - fromdistributionid:
674
+ - desc: ''
675
+ - required: false
676
+ - type: :numeric
677
+ - isreadonly:
678
+ - desc: Enable forced read-only for this Disk
679
+ - required: false
680
+ - type: :boolean
681
+ - label:
682
+ - desc: The display label for this Disk
683
+ - required: true
684
+ - type: :string
685
+ - linodeid:
686
+ - desc: ''
687
+ - required: true
688
+ - type: :numeric
689
+ - rootpass:
690
+ - desc: ''
691
+ - required: false
692
+ - type: :string
693
+ - rootsshkey:
694
+ - desc: ''
695
+ - required: false
696
+ - type: :string
697
+ - size:
698
+ - desc: The size in MB of this Disk.
699
+ - required: true
700
+ - type: :numeric
701
+ - type:
702
+ - desc: 'The formatted type of this disk. Valid types are: ext3, ext4, swap,
703
+ raw'
704
+ - required: true
705
+ - type: :string
706
+ - throws:
707
+ - NOTFOUND
708
+ - VALIDATION
709
+ createfromdistribution:
710
+ - desc: ''
711
+ - params:
712
+ - distributionid:
713
+ - desc: The DistributionID to create this disk from. Found in avail.distributions()
714
+ - required: true
715
+ - type: :numeric
716
+ - label:
717
+ - desc: The label of this new disk image
718
+ - required: true
719
+ - type: :string
720
+ - linodeid:
721
+ - desc: ''
722
+ - required: true
723
+ - type: :numeric
724
+ - rootpass:
725
+ - desc: The root user's password
726
+ - required: true
727
+ - type: :string
728
+ - rootsshkey:
729
+ - desc: Optionally sets this string into /root/.ssh/authorized_keys upon distribution
730
+ configuration.
731
+ - required: false
732
+ - type: :string
733
+ - size:
734
+ - desc: Size of this disk image in MB
735
+ - required: true
736
+ - type: :numeric
737
+ - throws:
738
+ - NOTFOUND
739
+ - VALIDATION
740
+ createfromimage:
741
+ - desc: Creates a new disk from a previously imagized disk.
742
+ - params:
743
+ - imageid:
744
+ - desc: The ID of the frozen image to deploy from
745
+ - required: true
746
+ - type: :numeric
747
+ - label:
748
+ - desc: The label of this new disk image
749
+ - required: false
750
+ - type: :string
751
+ - linodeid:
752
+ - desc: Specifies the Linode to deploy on to
753
+ - required: true
754
+ - type: :numeric
755
+ - rootpass:
756
+ - desc: Optionally sets the root password at deployment time. If a password
757
+ is not provided the existing root password of the frozen image will not
758
+ be modified
759
+ - required: false
760
+ - type: :string
761
+ - rootsshkey:
762
+ - desc: Optionally sets this string into /root/.ssh/authorized_keys upon image
763
+ deployment
764
+ - required: false
765
+ - type: :string
766
+ - size:
767
+ - desc: The size of the disk image to creates. Defaults to the minimum size
768
+ required for the requested image
769
+ - required: false
770
+ - type: :numeric
771
+ - throws: []
772
+ createfromstackscript:
773
+ - desc: ''
774
+ - params:
775
+ - distributionid:
776
+ - desc: Which Distribution to apply this StackScript to. Must be one from
777
+ the script's DistributionIDList
778
+ - required: true
779
+ - type: :numeric
780
+ - label:
781
+ - desc: The label of this new disk image
782
+ - required: true
783
+ - type: :string
784
+ - linodeid:
785
+ - desc: ''
786
+ - required: true
787
+ - type: :numeric
788
+ - rootpass:
789
+ - desc: The root user's password
790
+ - required: true
791
+ - type: :string
792
+ - rootsshkey:
793
+ - desc: Optionally sets this string into /root/.ssh/authorized_keys upon distribution
794
+ configuration.
795
+ - required: false
796
+ - type: :string
797
+ - size:
798
+ - desc: Size of this disk image in MB
799
+ - required: true
800
+ - type: :numeric
801
+ - stackscriptid:
802
+ - desc: The StackScript to create this image from
803
+ - required: true
804
+ - type: :numeric
805
+ - stackscriptudfresponses:
806
+ - desc: JSON encoded name/value pairs, answering this StackScript's User Defined
807
+ Fields
808
+ - required: true
809
+ - type: :string
810
+ - throws:
811
+ - NOTFOUND
812
+ - VALIDATION
813
+ delete:
814
+ - desc: ''
815
+ - params:
816
+ - diskid:
817
+ - desc: ''
818
+ - required: true
819
+ - type: :numeric
820
+ - linodeid:
821
+ - desc: ''
822
+ - required: true
823
+ - type: :numeric
824
+ - throws:
825
+ - NOTFOUND
826
+ - VALIDATION
827
+ duplicate:
828
+ - desc: Performs a bit-for-bit copy of a disk image.
829
+ - params:
830
+ - diskid:
831
+ - desc: ''
832
+ - required: true
833
+ - type: :numeric
834
+ - linodeid:
835
+ - desc: ''
836
+ - required: true
837
+ - type: :numeric
838
+ - throws:
839
+ - NOTFOUND
840
+ - VALIDATION
841
+ imagize:
842
+ - desc: Creates a gold-master image for future deployments
843
+ - params:
844
+ - description:
845
+ - desc: An optional description of the created image
846
+ - required: false
847
+ - type: :string
848
+ - diskid:
849
+ - desc: Specifies the source Disk to create the image from
850
+ - required: true
851
+ - type: :numeric
852
+ - label:
853
+ - desc: Sets the name of the image shown in the base image list, defaults
854
+ to the source image label
855
+ - required: false
856
+ - type: :string
857
+ - linodeid:
858
+ - desc: Specifies the source Linode to create the image from
859
+ - required: true
860
+ - type: :numeric
861
+ - throws: []
862
+ list:
863
+ - desc: 'Status values are 1: Ready and 2: Being Deleted.'
864
+ - params:
865
+ - diskid:
866
+ - desc: ''
867
+ - required: false
868
+ - type: :numeric
869
+ - linodeid:
870
+ - desc: ''
871
+ - required: true
872
+ - type: :numeric
873
+ - throws: []
874
+ resize:
875
+ - desc: ''
876
+ - params:
877
+ - diskid:
878
+ - desc: ''
879
+ - required: true
880
+ - type: :numeric
881
+ - linodeid:
882
+ - desc: ''
883
+ - required: true
884
+ - type: :numeric
885
+ - size:
886
+ - desc: The requested new size of this Disk in MB
887
+ - required: true
888
+ - type: :numeric
889
+ - throws:
890
+ - NOTFOUND
891
+ - VALIDATION
892
+ update:
893
+ - desc: ''
894
+ - params:
895
+ - diskid:
896
+ - desc: ''
897
+ - required: true
898
+ - type: :numeric
899
+ - isreadonly:
900
+ - desc: Enable forced read-only for this Disk
901
+ - required: false
902
+ - type: :boolean
903
+ - label:
904
+ - desc: The display label for this Disk
905
+ - required: false
906
+ - type: :string
907
+ - linodeid:
908
+ - desc: ''
909
+ - required: false
910
+ - type: :numeric
911
+ - throws:
912
+ - NOTFOUND
913
+ - VALIDATION
914
+ ip:
915
+ addprivate:
916
+ - desc: Assigns a Private IP to a Linode. Returns the IPAddressID that was added.
917
+ - params:
918
+ - linodeid:
919
+ - desc: ''
920
+ - required: true
921
+ - type: :numeric
922
+ - throws:
923
+ - NOTFOUND
924
+ addpublic:
925
+ - desc: Assigns a Public IP to a Linode. Returns the IPAddressID and IPAddress
926
+ that was added.
927
+ - params:
928
+ - linodeid:
929
+ - desc: The LinodeID of the Linode that will be assigned an additional public
930
+ IP address
931
+ - required: true
932
+ - type: :numeric
933
+ - throws:
934
+ - NOTFOUND
935
+ - VALIDATION
936
+ list:
937
+ - desc: Returns the IP addresses of all Linodes you have access to.
938
+ - params:
939
+ - ipaddressid:
940
+ - desc: If specified, limits the result to this IPAddressID
941
+ - required: false
942
+ - type: :numeric
943
+ - linodeid:
944
+ - desc: If specified, limits the result to this LinodeID
945
+ - required: false
946
+ - type: :numeric
947
+ - throws:
948
+ - NOTFOUND
949
+ setrdns:
950
+ - desc: Sets the rDNS name of a Public IP. Returns the IPAddressID and IPAddress
951
+ that were updated.
952
+ - params:
953
+ - hostname:
954
+ - desc: The hostname to set the reverse DNS to
955
+ - required: true
956
+ - type: :string
957
+ - ipaddressid:
958
+ - desc: The IPAddressID of the address to update
959
+ - required: true
960
+ - type: :numeric
961
+ - throws:
962
+ - NOTFOUND
963
+ - VALIDATION
964
+ swap:
965
+ - desc: Exchanges Public IP addresses between two Linodes within a Datacenter. The
966
+ destination of the IP Address can be designated by either the toLinodeID or
967
+ withIPAddressID parameter. Returns the resulting relationship of the Linode
968
+ and IP Address parameters. When performing a one directional swap, the source
969
+ is represented by the first of the two resultant array members.
970
+ - params:
971
+ - ipaddressid:
972
+ - desc: The IPAddressID of an IP Address to transfer or swap
973
+ - required: true
974
+ - type: :numeric
975
+ - tolinodeid:
976
+ - desc: The LinodeID of the Linode where IPAddressID will be transfered
977
+ - required: false
978
+ - type: :numeric
979
+ - withipaddressid:
980
+ - desc: The IP Address ID to swap
981
+ - required: false
982
+ - type: :numeric
983
+ - throws:
984
+ - NOTFOUND
985
+ - VALIDATION
986
+ job:
987
+ list:
988
+ - desc: ''
989
+ - params:
990
+ - jobid:
991
+ - desc: Limits the list to the specified JobID
992
+ - required: false
993
+ - type: :numeric
994
+ - linodeid:
995
+ - desc: ''
996
+ - required: true
997
+ - type: :numeric
998
+ - pendingonly:
999
+ - desc: ''
1000
+ - required: false
1001
+ - type: :boolean
1002
+ - throws: []
1003
+ list:
1004
+ - desc: 'Returns a list of all Linodes user has access or delete to, including some
1005
+ properties. Status values are -1: Being Created, 0: Brand New, 1: Running,
1006
+ and 2: Powered Off.'
1007
+ - params:
1008
+ - linodeid:
1009
+ - desc: Limits the list to the specified LinodeID
1010
+ - required: false
1011
+ - type: :numeric
1012
+ - throws: []
1013
+ mutate:
1014
+ - desc: Upgrades a Linode to its next generation.
1015
+ - params:
1016
+ - linodeid:
1017
+ - desc: ''
1018
+ - required: true
1019
+ - type: :numeric
1020
+ - throws:
1021
+ - NOTFOUND
1022
+ - VALIDATION
1023
+ reboot:
1024
+ - desc: Issues a shutdown, and then boot job for a given LinodeID.
1025
+ - params:
1026
+ - configid:
1027
+ - desc: ''
1028
+ - required: false
1029
+ - type: :numeric
1030
+ - linodeid:
1031
+ - desc: ''
1032
+ - required: true
1033
+ - type: :numeric
1034
+ - throws:
1035
+ - NOTFOUND
1036
+ resize:
1037
+ - desc: Resizes a Linode from one plan to another. Immediately shuts the Linode
1038
+ down, charges/credits the account, and issue a migration to another host server.
1039
+ - params:
1040
+ - linodeid:
1041
+ - desc: ''
1042
+ - required: true
1043
+ - type: :numeric
1044
+ - planid:
1045
+ - desc: The desired PlanID available from avail.LinodePlans()
1046
+ - required: true
1047
+ - type: :numeric
1048
+ - throws:
1049
+ - NOTFOUND
1050
+ - CCFAILED
1051
+ - VALIDATION
1052
+ shutdown:
1053
+ - desc: Issues a shutdown job for a given LinodeID.
1054
+ - params:
1055
+ - linodeid:
1056
+ - desc: ''
1057
+ - required: true
1058
+ - type: :numeric
1059
+ - throws:
1060
+ - NOTFOUND
1061
+ update:
1062
+ - desc: Updates a Linode's properties.
1063
+ - params:
1064
+ - alert_bwin_enabled:
1065
+ - desc: Enable the incoming bandwidth email alert
1066
+ - required: false
1067
+ - type: :boolean
1068
+ - alert_bwin_threshold:
1069
+ - desc: Mb/sec
1070
+ - required: false
1071
+ - type: :numeric
1072
+ - alert_bwout_enabled:
1073
+ - desc: Enable the outgoing bandwidth email alert
1074
+ - required: false
1075
+ - type: :boolean
1076
+ - alert_bwout_threshold:
1077
+ - desc: Mb/sec
1078
+ - required: false
1079
+ - type: :numeric
1080
+ - alert_bwquota_enabled:
1081
+ - desc: Enable the bw quote email alert
1082
+ - required: false
1083
+ - type: :boolean
1084
+ - alert_bwquota_threshold:
1085
+ - desc: Percentage of monthly bw quota
1086
+ - required: false
1087
+ - type: :numeric
1088
+ - alert_cpu_enabled:
1089
+ - desc: Enable the cpu usage email alert
1090
+ - required: false
1091
+ - type: :boolean
1092
+ - alert_cpu_threshold:
1093
+ - desc: CPU Alert threshold, percentage 0-800
1094
+ - required: false
1095
+ - type: :numeric
1096
+ - alert_diskio_enabled:
1097
+ - desc: Enable the disk IO email alert
1098
+ - required: false
1099
+ - type: :boolean
1100
+ - alert_diskio_threshold:
1101
+ - desc: IO ops/sec
1102
+ - required: false
1103
+ - type: :numeric
1104
+ - backupweeklyday:
1105
+ - desc: ''
1106
+ - required: false
1107
+ - type: :numeric
1108
+ - backupwindow:
1109
+ - desc: ''
1110
+ - required: false
1111
+ - type: :numeric
1112
+ - label:
1113
+ - desc: This Linode's label
1114
+ - required: false
1115
+ - type: :string
1116
+ - linodeid:
1117
+ - desc: ''
1118
+ - required: true
1119
+ - type: :numeric
1120
+ - lpm_displaygroup:
1121
+ - desc: Display group in the Linode list inside the Linode Manager
1122
+ - required: false
1123
+ - type: :string
1124
+ - ms_ssh_disabled:
1125
+ - desc: ''
1126
+ - required: false
1127
+ - type: :boolean
1128
+ - ms_ssh_ip:
1129
+ - desc: ''
1130
+ - required: false
1131
+ - type: :string
1132
+ - ms_ssh_port:
1133
+ - desc: ''
1134
+ - required: false
1135
+ - type: :numeric
1136
+ - ms_ssh_user:
1137
+ - desc: ''
1138
+ - required: false
1139
+ - type: :string
1140
+ - watchdog:
1141
+ - desc: Enable the Lassie shutdown watchdog
1142
+ - required: false
1143
+ - type: :boolean
1144
+ - throws:
1145
+ - NOTFOUND
1146
+ - VALIDATION
1147
+ webconsoletoken:
1148
+ - desc: Generates a console token starting a web console LISH session for the requesting
1149
+ IP
1150
+ - params:
1151
+ - linodeid:
1152
+ - desc: ''
1153
+ - required: true
1154
+ - type: :numeric
1155
+ - throws:
1156
+ - NOTFOUND
1157
+ - VALIDATION
1158
+ nodebalancer:
1159
+ config:
1160
+ create:
1161
+ - desc: ''
1162
+ - params:
1163
+ - algorithm:
1164
+ - desc: Balancing algorithm. One of 'roundrobin', 'leastconn', 'source'
1165
+ - required: false
1166
+ - type: :string
1167
+ - check:
1168
+ - desc: Perform active health checks on the backend nodes. One of 'connection',
1169
+ 'http', 'http_body'
1170
+ - required: false
1171
+ - type: :string
1172
+ - check_attempts:
1173
+ - desc: Number of failed probes before taking a node out of rotation. 1-30
1174
+ - required: false
1175
+ - type: :string
1176
+ - check_body:
1177
+ - desc: When check=http_body, a regex against the expected result body
1178
+ - required: false
1179
+ - type: :string
1180
+ - check_interval:
1181
+ - desc: Seconds between health check probes. 2-3600
1182
+ - required: false
1183
+ - type: :numeric
1184
+ - check_path:
1185
+ - desc: When check=http, the path to request
1186
+ - required: false
1187
+ - type: :string
1188
+ - check_timeout:
1189
+ - desc: Seconds to wait before considering the probe a failure. 1-30. Must
1190
+ be less than check_interval.
1191
+ - required: false
1192
+ - type: :string
1193
+ - nodebalancerid:
1194
+ - desc: The parent NodeBalancer's ID
1195
+ - required: true
1196
+ - type: :numeric
1197
+ - port:
1198
+ - desc: Port to bind to on the public interfaces. 1-65534
1199
+ - required: false
1200
+ - type: :numeric
1201
+ - protocol:
1202
+ - desc: Either 'tcp', 'http', or 'https'
1203
+ - required: false
1204
+ - type: :string
1205
+ - ssl_cert:
1206
+ - desc: SSL certificate served by the NodeBalancer when the protocol is 'https'
1207
+ - required: false
1208
+ - type: :string
1209
+ - ssl_key:
1210
+ - desc: Unpassphrased private key for the SSL certificate when protocol is
1211
+ 'https'
1212
+ - required: false
1213
+ - type: :string
1214
+ - stickiness:
1215
+ - desc: Session persistence. One of 'none', 'table', 'http_cookie'
1216
+ - required: false
1217
+ - type: :string
1218
+ - throws:
1219
+ - NOTFOUND
1220
+ - VALIDATION
1221
+ delete:
1222
+ - desc: Deletes a NodeBalancer's Config
1223
+ - params:
1224
+ - configid:
1225
+ - desc: The ConfigID to delete
1226
+ - required: true
1227
+ - type: :numeric
1228
+ - nodebalancerid:
1229
+ - desc: ''
1230
+ - required: true
1231
+ - type: :numeric
1232
+ - throws:
1233
+ - NOTFOUND
1234
+ list:
1235
+ - desc: Returns a list of NodeBalancers this user has access or delete to, including
1236
+ their properties
1237
+ - params:
1238
+ - configid:
1239
+ - desc: Limits the list to the specified ConfigID
1240
+ - required: false
1241
+ - type: :numeric
1242
+ - nodebalancerid:
1243
+ - desc: ''
1244
+ - required: true
1245
+ - type: :numeric
1246
+ - throws: []
1247
+ update:
1248
+ - desc: Updates a Config's properties
1249
+ - params:
1250
+ - algorithm:
1251
+ - desc: Balancing algorithm. One of 'roundrobin', 'leastconn', 'source'
1252
+ - required: false
1253
+ - type: :string
1254
+ - check:
1255
+ - desc: Perform active health checks on the backend nodes. One of 'connection',
1256
+ 'http', 'http_body'
1257
+ - required: false
1258
+ - type: :string
1259
+ - check_attempts:
1260
+ - desc: Number of failed probes before taking a node out of rotation. 1-30
1261
+ - required: false
1262
+ - type: :string
1263
+ - check_body:
1264
+ - desc: When check=http_body, a regex against the expected result body
1265
+ - required: false
1266
+ - type: :string
1267
+ - check_interval:
1268
+ - desc: Seconds between health check probes. 2-3600
1269
+ - required: false
1270
+ - type: :numeric
1271
+ - check_path:
1272
+ - desc: When check=http, the path to request
1273
+ - required: false
1274
+ - type: :string
1275
+ - check_timeout:
1276
+ - desc: Seconds to wait before considering the probe a failure. 1-30. Must
1277
+ be less than check_interval.
1278
+ - required: false
1279
+ - type: :string
1280
+ - configid:
1281
+ - desc: ''
1282
+ - required: true
1283
+ - type: :numeric
1284
+ - port:
1285
+ - desc: Port to bind to on the public interfaces. 1-65534
1286
+ - required: false
1287
+ - type: :numeric
1288
+ - protocol:
1289
+ - desc: Either 'tcp', 'http', or 'https'
1290
+ - required: false
1291
+ - type: :string
1292
+ - ssl_cert:
1293
+ - desc: SSL certificate served by the NodeBalancer when the protocol is 'https'
1294
+ - required: false
1295
+ - type: :string
1296
+ - ssl_key:
1297
+ - desc: Unpassphrased private key for the SSL certificate when protocol is
1298
+ 'https'
1299
+ - required: false
1300
+ - type: :string
1301
+ - stickiness:
1302
+ - desc: Session persistence. One of 'none', 'table', 'http_cookie'
1303
+ - required: false
1304
+ - type: :string
1305
+ - throws:
1306
+ - NOTFOUND
1307
+ - VALIDATION
1308
+ create:
1309
+ - desc: ''
1310
+ - params:
1311
+ - clientconnthrottle:
1312
+ - desc: To help mitigate abuse, throttle connections per second, per client
1313
+ IP. 0 to disable. Max of 20.
1314
+ - required: false
1315
+ - type: :numeric
1316
+ - datacenterid:
1317
+ - desc: The DatacenterID from avail.datacenters() where you wish to place this
1318
+ new NodeBalancer
1319
+ - required: true
1320
+ - type: :numeric
1321
+ - label:
1322
+ - desc: This NodeBalancer's label
1323
+ - required: false
1324
+ - type: :string
1325
+ - throws:
1326
+ - NOACCESS
1327
+ - CCFAILED
1328
+ - VALIDATION
1329
+ delete:
1330
+ - desc: Immediately removes a NodeBalancer from your account and issues a pro-rated
1331
+ credit back to your account, if applicable.
1332
+ - params:
1333
+ - nodebalancerid:
1334
+ - desc: The NodeBalancerID to delete
1335
+ - required: true
1336
+ - type: :numeric
1337
+ - throws:
1338
+ - NOTFOUND
1339
+ list:
1340
+ - desc: Returns a list of NodeBalancers this user has access or delete to, including
1341
+ their properties
1342
+ - params:
1343
+ - nodebalancerid:
1344
+ - desc: Limits the list to the specified NodeBalancerID
1345
+ - required: false
1346
+ - type: :numeric
1347
+ - throws: []
1348
+ node:
1349
+ create:
1350
+ - desc: ''
1351
+ - params:
1352
+ - address:
1353
+ - desc: The address:port combination used to communicate with this Node
1354
+ - required: true
1355
+ - type: :string
1356
+ - configid:
1357
+ - desc: The parent ConfigID to attach this Node to
1358
+ - required: true
1359
+ - type: :numeric
1360
+ - label:
1361
+ - desc: This backend Node's label
1362
+ - required: true
1363
+ - type: :string
1364
+ - mode:
1365
+ - desc: The connections mode for this node. One of 'accept', 'reject', or
1366
+ 'drain'
1367
+ - required: false
1368
+ - type: :string
1369
+ - weight:
1370
+ - desc: Load balancing weight, 1-255. Higher means more connections.
1371
+ - required: false
1372
+ - type: :numeric
1373
+ - throws:
1374
+ - NOTFOUND
1375
+ - VALIDATION
1376
+ delete:
1377
+ - desc: Deletes a Node from a NodeBalancer Config
1378
+ - params:
1379
+ - nodeid:
1380
+ - desc: The NodeID to delete
1381
+ - required: true
1382
+ - type: :numeric
1383
+ - throws:
1384
+ - NOTFOUND
1385
+ list:
1386
+ - desc: Returns a list of Nodes associated with a NodeBalancer Config
1387
+ - params:
1388
+ - configid:
1389
+ - desc: ''
1390
+ - required: true
1391
+ - type: :numeric
1392
+ - nodeid:
1393
+ - desc: Limits the list to the specified NodeID
1394
+ - required: false
1395
+ - type: :numeric
1396
+ - throws: []
1397
+ update:
1398
+ - desc: Updates a Node's properties
1399
+ - params:
1400
+ - address:
1401
+ - desc: The address:port combination used to communicate with this Node
1402
+ - required: false
1403
+ - type: :string
1404
+ - label:
1405
+ - desc: This backend Node's label
1406
+ - required: false
1407
+ - type: :string
1408
+ - mode:
1409
+ - desc: The connections mode for this node. One of 'accept', 'reject', or
1410
+ 'drain'
1411
+ - required: false
1412
+ - type: :string
1413
+ - nodeid:
1414
+ - desc: ''
1415
+ - required: true
1416
+ - type: :numeric
1417
+ - weight:
1418
+ - desc: Load balancing weight, 1-255. Higher means more connections.
1419
+ - required: false
1420
+ - type: :numeric
1421
+ - throws:
1422
+ - NOTFOUND
1423
+ - VALIDATION
1424
+ update:
1425
+ - desc: Updates a NodeBalancer's properties
1426
+ - params:
1427
+ - clientconnthrottle:
1428
+ - desc: To help mitigate abuse, throttle connections per second, per client
1429
+ IP. 0 to disable. Max of 20.
1430
+ - required: false
1431
+ - type: :numeric
1432
+ - label:
1433
+ - desc: This NodeBalancer's label
1434
+ - required: false
1435
+ - type: :string
1436
+ - nodebalancerid:
1437
+ - desc: ''
1438
+ - required: true
1439
+ - type: :numeric
1440
+ - throws:
1441
+ - NOTFOUND
1442
+ - VALIDATION
1443
+ stackscript:
1444
+ create:
1445
+ - desc: Create a StackScript.
1446
+ - params:
1447
+ - description:
1448
+ - desc: ''
1449
+ - required: false
1450
+ - type: :string
1451
+ - distributionidlist:
1452
+ - desc: 'Comma delimited list of DistributionIDs that this script works on '
1453
+ - required: true
1454
+ - type: :string
1455
+ - ispublic:
1456
+ - desc: Whether this StackScript is published in the Library, for everyone to
1457
+ use
1458
+ - required: false
1459
+ - type: :boolean
1460
+ - label:
1461
+ - desc: The Label for this StackScript
1462
+ - required: true
1463
+ - type: :string
1464
+ - rev_note:
1465
+ - desc: ''
1466
+ - required: false
1467
+ - type: :string
1468
+ - script:
1469
+ - desc: The actual script
1470
+ - required: true
1471
+ - type: :string
1472
+ - throws:
1473
+ - NOACCESS
1474
+ - VALIDATION
1475
+ delete:
1476
+ - desc: ''
1477
+ - params:
1478
+ - stackscriptid:
1479
+ - desc: ''
1480
+ - required: true
1481
+ - type: :numeric
1482
+ - throws:
1483
+ - NOTFOUND
1484
+ list:
1485
+ - desc: Lists StackScripts you have access to.
1486
+ - params:
1487
+ - stackscriptid:
1488
+ - desc: Limits the list to the specified StackScriptID
1489
+ - required: false
1490
+ - type: :numeric
1491
+ - throws: []
1492
+ update:
1493
+ - desc: Update a StackScript.
1494
+ - params:
1495
+ - description:
1496
+ - desc: ''
1497
+ - required: false
1498
+ - type: :string
1499
+ - distributionidlist:
1500
+ - desc: 'Comma delimited list of DistributionIDs that this script works on '
1501
+ - required: false
1502
+ - type: :string
1503
+ - ispublic:
1504
+ - desc: Whether this StackScript is published in the Library, for everyone to
1505
+ use
1506
+ - required: false
1507
+ - type: :boolean
1508
+ - label:
1509
+ - desc: The Label for this StackScript
1510
+ - required: false
1511
+ - type: :string
1512
+ - rev_note:
1513
+ - desc: ''
1514
+ - required: false
1515
+ - type: :string
1516
+ - script:
1517
+ - desc: The actual script
1518
+ - required: false
1519
+ - type: :string
1520
+ - stackscriptid:
1521
+ - desc: ''
1522
+ - required: true
1523
+ - type: :numeric
1524
+ - throws:
1525
+ - NOTFOUND
1526
+ - VALIDATION
1527
+ test:
1528
+ echo:
1529
+ - desc: Echos back parameters that were passed in.
1530
+ - params: []
1531
+ - throws: []
1532
+ user:
1533
+ getapikey:
1534
+ - desc: Authenticates a Linode Manager user against their username, password, and
1535
+ two-factor token (when enabled), and then returns a new API key, which can be
1536
+ used until it expires. The number of active keys is limited to 20.
1537
+ - params:
1538
+ - expires:
1539
+ - desc: Number of hours the key will remain valid, between 0 and 8760. 0 means
1540
+ no expiration. Defaults to 168.
1541
+ - required: false
1542
+ - type: :numeric
1543
+ - label:
1544
+ - desc: An optional label for this key.
1545
+ - required: false
1546
+ - type: :string
1547
+ - password:
1548
+ - desc: ''
1549
+ - required: true
1550
+ - type: :string
1551
+ - token:
1552
+ - desc: Required when two-factor authentication is enabled.
1553
+ - required: false
1554
+ - type: :string
1555
+ - username:
1556
+ - desc: ''
1557
+ - required: true
1558
+ - type: :string
1559
+ - throws:
1560
+ - AUTHFAIL
1561
+ - " NEEDTOKEN"
1562
+ - " PASSWORDEXPIRED"
1563
+ - " KEYLIMIT"