/
Changes
294 lines (208 loc) · 8.95 KB
/
Changes
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
Revision history for VMware::vCloud
NB: Skipped version numbers were never released.
VERSIONTAG DATETAG
Added:
POD test
Improved:
'use warnings' on all modules
2.401 2014/03/06
Added:
LICENSE is part of the distribution now
Improved:
Better handling of connection timeouts
examples/compose-vapp.pl - Now uses Term::Prompt fully.
examples/create-vapp-from-template.pl - Now uses Term::Prompt fully.
examples/poweron-vapp.pl - Now uses Term::Prompt fully.
RCS 'Revisison' based version info removed from examples
Directly declared VERSION variables
Autogenerating META data for the modules
2.400 2013-05-03
Improved:
All examples are now actually bundled with distribution.
v2.390 2013-05-03
Added:
examples/list-datastores.pl
VMware::vCloud - list_datastores(), progress_of_task()
VMware::API::vCloud - datastore_list()
2.380 2013-04-17
Added:
examples/get-template.pl
Improved:
examples/list-templates.pl - Better variable names for the example.
Added 'Which "name" is which' to POD on VMware::API::vCloud
Using Term::Prompt to ask for auth on example scripts.
Fixed:
VMware::API::vCloud - template_get(), vdc_get() - Missing match target on ternary.*
* Problem found by David Gress
2.370 2013-04-15
Added:
VMware::API::vCloud - vapp_recompose_add_vm()
Improved:
VMware::vCloud - get_template() - now returns hash or hashref in context
VMware::API::vCloud - admin(), admin_extension_get(),
admin_extension_vimServer_get(), catalog_get(), catalog_get_access(),
org_get(), org_list(), pvdc_get(), task_get(), template_get(),
template_get_metadata(), vdc_get(), vdc_list(), vapp_get(),
vapp_get_metadata() - now use the core get() method
2.360 2013-04-09
Added:
VMware::vCloud - delete_vapp(), create_vapp_from_sources()
VMware::API::vCloud - vapp_create_from_sources(), vapp_create_from_template()
Improved:
Error's now die() with the returned "message" as well as the HTTP code.
VMware::vCloud - Cache is automatically purged on delete actions.
VMware::API::vCloud - org_get(), org_list(), vapp_get(), vdc_get() - now use the core get() method
VMware::API::vCloud - get() now has level-3 debug of the request header
2.32 2013-03-29
Added:
VMware::vCloud - get_task(), list_pvdcs(), wait_on_task()
VMware::API::vCloud - org_vdc_update(), put(), task_get()
Improved:
examples/list-pvds.pl - Now using VMware::vCloud
VMware::vCloud - get_vdc() now retruns hash or hashref.
VMware::API::vCloud - added debug levels 2 and 3
Date format in documentation is now in ISO 8601 format.
2.29 2013-03-25
Added:
Acknowledgement of David Gress as a contributor.
VMware::vCloud - create_catalog(), delete_catalog()
VMware::API::vCloud - catalog_create(), catalog_get_access(),
catalog_set_access(), logout()*
VMware::API::vCloud - POD noting the LoginUrl error.
Improved:
Automatic call of logout() on DESTROY if needed.
* Provided by David Gress
2.26 2013-03-19
Added:
VMware::API::vCloud - template_get_metadata(), vapp_get_metadata()
VMware::API::vCloud - Started adding API documentation URLs as comments in
front of each method.
Improved:
VMware::vCloud - list_vapps() & list_templates() - Now uses the current login
org a a parameter to list_vapps() to avoid pemission errors when logged in
as an Org Admin.
VMware::vCloud - org_create() improved POD, added ldap_mode as a parameter.
2.22 2013-03-14
Added:
VMware::vCloud - admin_urls(), debug(), delete_org(), delete_org_network(),
delete_vdc(), disable_org(), disable_vdc(), enable_org(), enable_vdc(),
extensions(), get_pvdc(), list_external_networks(), list_portgroups(),
purge(), vimserver(), webclienturl()
Improved:
VMware::vCloud - get_org() - now returns hash or hashref depending on context.
VMware::vCloud - Improved and reorganized POD.
POD cleanup and formatting.
2.19 2013-03-13
Added:
VMware::vCloud - create_external_network()
VMware::API::vCloud - admin(), admin_extension_get(),
admin_extension_vimServer_get(), delete(), get_raw(), org_create(),
org_list(), org_network_create(), org_vdc_create(), pvdc_get(), vdc_list()
API version information is now read directly from offered versions.
Learned variables and Raw responses now attached to $VMware::API::vCloud::self
When Debug is on, learned variables are displayed on exit.
Improved:
Now working with API version v5.1
Removed the 1.0 and 1.5 schema from the MANIFEST until necessary.
Most recent version is used.
Login URL is now directed by Version response.
VMware::API::vCloud - org_list() now generated with caching.
Fixed:
Version now included in accept header for authentication.
2.12 2011-10-27
Added:
XML schema descriptors for 1.0 and 1.5 included in distribution.
VMware::API::vCloud - "Template name validation" to "BUGS and LIMITATIONS" POD.
VMware::vCloud - create_vapp_from_template(), get_template(),
list_networks(), list_vdcs()
VMware::API::vCloud - template_get()
examples/list-templates.pl - Example of how to list templates.
examples/create-vapp-from-template.pl - Instantiate a template with defaults.
Improved:
examples/poweron-vapp.pl - Corrected documentation.
VMware::vCloud & VMware::vCloud::vApp - now used bless() with two arguments.
VMware::API::vCloud
_fault() now pushes a Dumper() of the HTTP object on error. That gives
more detail on a fault when debug is enabled.
post() now has optional parameters for content and content type.
Fixed:
examples/poweron-vappl.pl - Now actually included in the distribution
2.07 2011-10-06
Improved:
VMware::API::vCloud: Error handling now recognizes an HTTP::Response object.
Synopsis documentation on VMware::vCloud.
Fixed:
Included VMware::vCloud::vApp in MANIFEST
2.06 2011-10-05
Added:
VMware::vCloud::vApp - An object representation of a vApp.
examples/poweron-vapp.pl - Powering a vApp on.
Improved:
Documentation now matches all methods.
2.04 2011-10-03
Added:
Caching of data with Cache::Bounded.
list_templates() & examples/list-vms.pl - List templates
Improved:
examples/list-vms.pl - Removed commented-out code from 1.x version.
2.01 2011-09-30
This is a major change in philosophy. Previously this module emulated the API
in the name of method and returned data structures.
This does not match most conceptual and desired usage for automation. People
do not "think" in a collection of REST API calls. They think in actions like
"deploy a VM."
Consequently I have moved the direct API implementation to
VMware::API::vCloud. It offers an unadulterated pure-perl based view of the
API and its transactions.
In VMware::vCloud, I am going to try and present a more human friendly view.
Added:
lib/VMware/API/vCloud.pm - Raw API calls and returns.
Fixed:
Session ID is now handled via HTTP header, not cookies. This matches the published API docs.
1.600.08 2011-08-02
Added:
examples/list-vms.pl - List all vApps and their VMs
Improved:
Added POD to the examples: get_org.pl, login.pl
Fixed double "v" on new Version in POD
1.600.07 2011-07-29
Added:
vdc_get() - List the contents of a Virtual Datacenter
vapp_get() - List the contents of a vApp
Fixed:
Moved to multidigit CPAN-compatible version to work around single-digit subversion numbers.
1.6 2011-07-14
Added:
catalog_get() - List a catalogs contents
NB: Release created and submitted from the air on cross-country flight. :)
1.5 2011-07-01
Improved:
Tests now skip() and don't report fail when connection info is not
provided. The first test reports visual details of this.
1.4 2011-06-25
Added:
org_get() - List an organizations contents
examples/org_get.pl - Usage of the org_get() method
Improved:
login() - Returned data structure is now only the Org branch of the content.
t/02-header.t - Added a dummy "ok" to avoid "dubious" warnings until test is expanded.
Corrected:
Removed POD references to VMware::API::LabManager
1.3 2011-06-25
Corrected:
Error calling Data::Dumper on _fault()
Syntax error in META.yml
1.2 2011-06-23
The server is now properly queried for the API version.
XML to data structure translation of server responses is now in place.
Added:
api_versions() - Method to check API version supported by server
Improved:
login() - Now returns a data structure of accessible organizations upon successful login.
1.1 2011-06-16
Initial connection seed from sample code from hosting.com with comments from
the VMware communities.
- http://mylhat.com/blog/2009/09/hosting-com-vcloud-express-api-example-in-perl/
- http://communities.vmware.com/thread/284659
Added:
login() - Basic method to get a login token from the server.