Releases: vmware/govmomi
v0.32.0
Release v0.32.0
Release Date: 2023-09-28
β οΈ BREAKING
camelCase json output [db5b3d8]:
This change adds camelCase (lower-case 1st character) json tags for govc types
EnvironmentBrowser improvements [524ca25]:
removed object.VirtualMachine.QueryConfigTarget method
- Use object.VirtualMachine.EnvironmentBrowser().QueryConfigTarget instead
π Fix
π‘ Examples
- [f2aaee5] add ListView example for waiting on updates to tasks
π« API Changes
- [a91eb5e] disable HTTP Keep-Alive for direct ESX connections
π« govc
(CLI)
π« vcsim
(Simulator)
π Documentation
π§Ή Chore
- [a8d705a] Update version.go for v0.32.0
π Commits
- [a8d705a] chore: Update version.go for v0.32.0
- [f2aaee5] examples: add ListView example for waiting on updates to tasks
- [a91eb5e] api: disable HTTP Keep-Alive for direct ESX connections
- [db5b3d8] govc: camelCase json output (#3007) (#3243) (#3242) (#3241)
- [524ca25] vcsim: EnvironmentBrowser improvements
- [bed9513] fix: case insensitive govc import.ova PropertyMapping (#3245)
- [6c19b99] emacs: update for v0.31.0 release (#3007)
- [258ee24] docs: update govc jq examples with correct case (#3007)
- [d49e401] vcsim: set HostSystem.Config.Host (#3221)
v0.31.0
Release v0.31.0
Release Date: 2023-09-25
β οΈ BREAKING
-
[b594bf1] Move to main
Changing GoVmomi's default branch from
master
tomain
will likely result in dependents needing to repoint their clients and other integrations to the new, default branch. -
[9920086] Generate JSON tags
Updating the
vim25/types
with camelCased, JSON tags affects the output of thegovc
command when using the-json
flag to emit results as JSON. Field names that used to be PascalCased will now be camelCased. Queries for tools that parse JSON, such asjq
, will need to be updated to use the new camelCased fields.This change was made to support marshaling the eam, pbm, sms, vim, and vslm types to/from JSON using OpenAPI JSON discriminators.
-
[4f9f126] Change
string
to*string
forItem.Description
andLibrary.Description
in library package-
Test against a VC testbed
Sending a UpdateLibraryItem request with this change, and set the new description to "". The original item description was "virtualmachinepublishrequest.vmware.com: 6b0d06ad-8e18-4881-a806-2a7c8a7e1b4b", after this UpdateLibraryItem request succeeded, the item description was set to "". While before this change, it would be a no-op for the description.
-
Test using govc
-
Update Library
Create a library: β govmomi git:(issue-3048) β govc library.create -d "description-1" cl-1 495f611a-cf74-40d6-a54a-8b239cf15406 β govmomi git:(issue-3048) β ~/go/bin/govc library.info 495f611a-cf74-40d6-a54a-8b239cf15406 Name: cl-1 ID: 495f611a-cf74-40d6-a54a-8b239cf15406 Path: /cl-1 Description: description-1 Version: 2 Created: Fri Feb 17 19:18:22 2023 Security Policy ID StorageBackings: DatastoreID: sharedVmfs-0 Type: DATASTORE Update the library description with new string: β govmomi git:(issue-3048) β ~/go/bin/govc library.update -d "new description" 495f611a-cf74-40d6-a54a-8b239cf15406 β govmomi git:(issue-3048) β ~/go/bin/govc library.info 495f611a-cf74-40d6-a54a-8b239cf15406 Name: cl-1 ID: 495f611a-cf74-40d6-a54a-8b239cf15406 Path: /cl-1 Description: new description Version: 3 Created: Fri Feb 17 19:18:22 2023 Security Policy ID StorageBackings: DatastoreID: sharedVmfs-0 Type: DATASTORE Update the item name, description is not erased. β govmomi git:(issue-3048) β ~/go/bin/govc library.update -n "cl-1-new" 495f611a-cf74-40d6-a54a-8b239cf15406 β govmomi git:(issue-3048) β ~/go/bin/govc library.info 495f611a-cf74-40d6-a54a-8b239cf15406 Name: cl-1-new ID: 495f611a-cf74-40d6-a54a-8b239cf15406 Path: /cl-1-new Description: new description Version: 4 Created: Fri Feb 17 19:18:22 2023 Security Policy ID StorageBackings: DatastoreID: sharedVmfs-0 Type: DATASTORE Update the library description with empty string: β govmomi git:(issue-3048) β ~/go/bin/govc library.update -d "" 495f611a-cf74-40d6-a54a-8b239cf15406 β govmomi git:(issue-3048) β ~/go/bin/govc library.info 495f611a-cf74-40d6-a54a-8b239cf15406 Name: cl-1-new ID: 495f611a-cf74-40d6-a54a-8b239cf15406 Path: /cl-1-new Description: Version: 5 Created: Fri Feb 17 19:18:22 2023 Security Policy ID StorageBackings: DatastoreID: sharedVmfs-0 Type: DATASTORE
-
Update Library Item
β govmomi git:(issue-3048) β ~/go/bin/govc library.update -d "item-2" /cl-1/image-2 β govmomi git:(issue-3048) β ~/go/bin/govc library.info /cl-1/image-2 Name: image-2 ID: 0dc7df56-31e0-47dc-8b0a-6a33279ddccc Path: /cl-1/image-2 Description: item-2 Type: ovf Size: 2.0GB Created: Wed Feb 15 23:05:15 2023 Modified: Fri Feb 17 19:29:54 2023 Version: 3 Security Compliance: true Certificate Status: INTERNAL Update item name: govmomi git:(issue-3048) β ~/go/bin/govc library.update -n "image-2-new" /cl-1/image-2 β govmomi git:(issue-3048) β ~/go/bin/govc library.info /cl-1/image-2-new Name: image-2-new ID: 0dc7df56-31e0-47dc-8b0a-6a33279ddccc Path: /cl-1/image-2-new Description: item-2 Type: ovf Size: 2.0GB Created: Wed Feb 15 23:05:15 2023 Modified: Fri Feb 17 19:31:44 2023 Version: 4 Security Compliance: true Certificate Status: INTERNAL Update item description to empty string β govmomi git:(issue-3048) β ~/go/bin/govc library.update -d "" /cl-1/image-2-new β govmomi git:(issue-3048) β ~/go/bin/govc library.info /cl-1/image-2-new Name: image-2-new ID: 0dc7df56-31e0-47dc-8b0a-6a33279ddccc Path: /cl-1/image-2-new Description: Type: ovf Size: 2.0GB Created: Wed Feb 15 23:05:15 2023 Modified: Fri Feb 17 19:32:56 2023 Version: 5 Security Compliance: true Certificate Status: INTERNAL
-
-
π Fix
- [8f9e549] govc vm.clone failure when using 'cluster' option (#3208)
- [b22f730] govc datacenter.info VM count with multiple DCs
- [65814f0] Update some goreleaser deprecated fields (#3181)
- [b4eac19] check the error chain when validating if it's x509 error (#3174)
- [86cadf2] Fix the gorelease
- [1711a84] avoid modifying client transport outside of NewClient (#3161)
- [313aa85] share http.Transport with service clients (#3039)
- [f81f3b3] grep warnings during generating usage documentation
- [2d11115] support
binary
anddateTime
in JSON (#3127) - [c4ffe46] add esxcli.Fault and revert Error() string (#3072)
- [93cb079] byte, float and int (de) serialization (#3121)
- [8bc2caa] avoid govc -verbose flag panic if an UpdateSet is nil (#3088)
- [9ba1b85] include StoragePod Datastore children in ContainerView (#3094)
- [8b00a93] only limit the number of samples generated to maxSample when maxSample is greater than 0 and the number of samples to generate is greater than maxSample Closes: #3097 (#3097)
- [4ed0763] support govc ls -xml flag (#3053)
- [8554329] Pin the result limit of ssoadmin client to its MAX (#3004)
π‘ Examples
π« API Changes
- [a03f473] Fix errors w 8.0U2 GA update
- [515df5d] Update generated types to vSphere 8.0U2 GA
- [b7ceede] Prep to update types to vSphere 8.0U2 GA
- [ccd07a0] Update generated types to vSphere 8.0U1c GA
- [4c00586] Prep to update types to vSphere 8.0U1c GA
- [5431c33] Type/field comments for data structures; API versions
- [4b2de28] Add SDK support for VM data sets (#3050)
- [25865e5] set inventory path in SearchIndex.FindByInventoryPath (#3095)
- [38d0ac0] Add JSON transport for vim25 (#3062)
- [0938fba] Add ServerGuid to gen'd MoRef
- [e09a412] support find.NetworkList by ID (#2626)
- [e8fa981] support find.Network by cluster path
- [4e6d642] JSON Discriminators for vim25/types
- [9920086] Generate JSON tags
π« govc
(CLI)
- [c4d851b] Add CLI support for VM data sets (#3050)
- [02f353d] Command to print device/backings model as tree
- [af7833b] Fix memory aliasing in for loop (gosec G601)
- [e17d884] add -file flag for cluster.module.rm
- [e34c721] Add CLI device protocol support for vm.network.add (#3167)
- [48bdfad] Add --help
- [28014f9] Add general usage message (#3054)
- [e5f3cd0] add detail error message for host.esxcli commands (#3073)
- [81733d0] add cluster.mv command (#2524)
- [daaaca0] Add support for CNS volume snapshots
- [477bf69] Support JSON protocol using environment variable (#3062)
- [b8007c4] dont check poweredOn for vm.console vmrc requests (#2127)
- [6b34770] add sso.idp.ldap.update command (#3057)
- [e5b2aa3] Add feature VM IOMMU enablement support (#3055)
- [f4c678a] Add checksum validation to govc import.ova (#1978)
- [e935b5a] Add feature to get and set default idp (#3023)
π« vcsim
(Simulator)
- [35ec7c3] Add simulator support for VM data sets (#3050)
- [c77de71] Introduce separation btw new service instance & infra creation
- [2b5c457] add interactive debug github action stage
- [9b2ef98] use docker event for efficient monitoring
- [6f34f13] container backing respects changes via reconfigure
- [6248cbf] create underlay network for pNICs in container-backed hosts
- [6b7b0df] per-host OptionManager instances and differentiated roles
- [387dc6e] support container backing for hosts
- [fdb4d84] untangle container/VM to allow reuse of container logic for hosts
- [9d8380c] Fix ...
v0.30.7
Release v0.30.7
Release Date: 2023-08-04
π Fix
π« vcsim
(Simulator)
- [3dac2e7] Fix RefreshDatastore to return a valid response (#3198)
- [fe7a0ac] add PerformanceManager counter values
π§Ή Chore
- [46fd9d2] Update version.go for v0.30.7
β οΈ BREAKING
π Commits
- [46fd9d2] chore: Update version.go for v0.30.7
- [3dac2e7] vcsim: Fix RefreshDatastore to return a valid response (#3198)
- [fe7a0ac] vcsim: add PerformanceManager counter values
- [552dfab] build: quote golang version in release file to workaround issue in github action Close #3179 (#3179)
- [cd0c259] fix: Update some goreleaser deprecated fields (#3181)
v0.30.5
Release v0.30.5
Release Date: 2023-06-27
π Fix
- [03aa9dc] avoid govc -verbose flag panic if an UpdateSet is nil (#3088)
- [b366e94] include StoragePod Datastore children in ContainerView (#3094)
- [ae6efc9] only limit the number of samples generated to maxSample when maxSample is greater than 0 and the number of samples to generate is greater than maxSample Closes: #3097 (#3097)
- [b129008] support govc ls -xml flag (#3053)
π‘ Examples
π« API Changes
π« govc
(CLI)
π« vcsim
(Simulator)
- [844274f] set StandbyMode default to "none"
- [a405207] Add RUN.env flag to inject environment variables to container-backed VM
- [3466b11] Fix FindByInventoryPath to handle root folder (#3119)
- [0473736] Add CSV format support to QueryPerf API (#3103)
- [d46fe80] add ssoadmin user and group management (#2852)
π§Ή Chore
β οΈ BREAKING
π Commits
- [5373c14] chore: Update version.go for v0.30.5
- [844274f] vcsim: set StandbyMode default to "none"
- [a405207] vcsim: Add RUN.env flag to inject environment variables to container-backed VM
- [e2f14cd] chore: add missing guest OS IDs
- [3466b11] vcsim: Fix FindByInventoryPath to handle root folder (#3119)
- [3afdbf2] Add RUN.port.xx flag to publish ports on container backed VM
- [03aa9dc] fix: avoid govc -verbose flag panic if an UpdateSet is nil (#3088)
- [0473736] vcsim: Add CSV format support to QueryPerf API (#3103)
- [b366e94] fix: include StoragePod Datastore children in ContainerView (#3094)
- [ae6efc9] fix: only limit the number of samples generated to maxSample when maxSample is greater than 0 and the number of samples to generate is greater than maxSample Closes: #3097 (#3097)
- [afd45d6] api: set inventory path in SearchIndex.FindByInventoryPath (#3095)
- [16a58c2] Make mounting DMI information optional with docker-backed vcsim
- [b129008] fix: support govc ls -xml flag (#3053)
- [ecca414] govc: dont check poweredOn for vm.console vmrc requests (#2127)
- [46bf240] examples: add rest.Client.LoginByToken
- [d4e3142] examples: add session.Manager.LoginByToken (#3037)
- [d46fe80] vcsim: add ssoadmin user and group management (#2852)
v0.30.4
Release v0.30.4
Release Date: 2023-03-16
π« API Changes
π« govc
(CLI)
π§Ή Chore
- [4561966] Update version.go for v0.30.4
β οΈ BREAKING
π Commits
v0.30.2
Release v0.30.2
Release Date: 2023-02-01
π Fix
π« vcsim
(Simulator)
- [997d9dd] add guest.net.ipConfig
π§Ή Chore
- [9078b0b] Update version.go for v0.30.2
β οΈ BREAKING
π Commits
v0.30.1
Release v0.30.1
Release Date: 2023-01-28
π§Ή Chore
- [76a194e] Update version.go for v0.30.1
β οΈ BREAKING
π Commits
v0.28.1
Release v0.28.1
Release Date: 2023-01-27
π Fix
- [c27ab6b] use correct controlflag for vslm SetControlFlags API test
β οΈ BREAKING
π Commits
v0.30.0
Release v0.30.0
Release Date: 2022-12-12
π Fix
- [1ad33d4] Heal the broken Namespace API
- [22c4814] Update $mktemp to support macOS
- [05b0b08] DialTLSContext / Go 1.18+ CertificateVerify support
π« API Changes
- [58f4112] Update types to vSphere 8.0 GA
- [ba206c5] add Content Library security compliance support (#2980)
- [4c24f82] Add SRIOV device names (#2956)
- [642156d] Adds vSphere 7.0u1-u3 support to namespace-management (Tanzu) (#2860)
π« govc
(CLI)
- [60a18c5] about.cert was not respecting -k
- [15d1181] bash completion improvements
- [0dbf717] Add sso.lpp.info and sso.lpp.update commands (#2975)
- [fe87cff] host.info: use writer instead of os.stdout (#2995)
- [a7196e4] host.info: use writer instead of os.stdout (#2995)
- [3d6de9d] fix host.esxcli runtime error occurred when no arguments specified (#2960)
- [8c7ba5e] Add feature in sso.group.ls to list groups using FindGroupsInGroup method (#2945)
- [dc3e1d7] Add feature sso.group.lsgroups using FindGroupsInGroup method (#2945)
- [bf991e6] add event key for json and plain text output
- [2017e84] Support creating content libraries with security policies (#2641)
π« vcsim
(Simulator)
- [86f9d42] Update test keys to be RSA 2048
- [cedf695] Fix duplicated name check in CloneVM_Task (#2983)
- [8f4da55] add QueryNetworkHint support for LLDP and CDP details
- [1cab325] Fix RetrieveProperties path validation to avoid panic (#2953)
- [7f42a1d] use node id for ServiceContent.InstanceUuid
- [0331949] Fix snapshot tasks to update rootSnapshot (#2912)
- [b6ebcb6] Fix disk capacity validation in ConfigureDevices (#2910)
- [61032a2] Fix StorageIOAllocationInfo of VirtualDisk (#2904)
- [cbfe0c9] support disconnect/reconnect host (#2899)
- [b44828a] Fix datastore freespace changed by ReconfigVM_Task (#2894)
π Documentation
- [813a5d8] update
README.md
π§Ή Chore
- [eabc29b] Update version.go for v0.30.0
β οΈ BREAKING
π Commits
- [eabc29b] chore: Update version.go for v0.30.0
- [1c91982] Update CONTRIBUTORS for release
- [1ad33d4] fix: Heal the broken Namespace API
- [22c4814] fix: Update $mktemp to support macOS
- [05b0b08] fix: DialTLSContext / Go 1.18+ CertificateVerify support
- [86f9d42] vcsim: Update test keys to be RSA 2048
- [60a18c5] govc: about.cert was not respecting -k
- [58f4112] api: Update types to vSphere 8.0 GA
- [15d1181] govc: bash completion improvements
- [c018f07] perms on template files
- [813a5d8] docs: update
README.md
- [0dbf717] govc: Add sso.lpp.info and sso.lpp.update commands (#2975)
- [fe87cff] govc: host.info: use writer instead of os.stdout (#2995)
- [a7196e4] govc: host.info: use writer instead of os.stdout (#2995)
- [ba206c5] api: add Content Library security compliance support (#2980)
- [cedf695] vcsim: Fix duplicated name check in CloneVM_Task (#2983)
- [8f4da55] vcsim: add QueryNetworkHint support for LLDP and CDP details
- [3b2816a] Add optional recommRequired PlaceVmsXCluster req arguments
- [f975908] build(deps): bump andstor/file-existence-action from 1 to 2
- [1373b80] build(deps): bump chuhlomin/render-template from 1.5 to 1.6
- [dc55a27] build(deps): bump nokogiri from 1.13.6 to 1.13.9 in /gen
- [63980ff] Fix: use latestPages in task HistoryCollector
- [3d6de9d] govc: fix host.esxcli runtime error occurred when no arguments specified (#2960)
- [1e9eed9] Update list of projects using govmomi
- [7f4d115] fixup! api: Add SRIOV device names
- [8f1dc57] Add API cnsreconfigpolicy bindings and static check fixes to cns/client_test.go
- [bf68e8f] fixup! api: Add SRIOV device names
- [4c24f82] api: Add SRIOV device names (#2956)
- [c1bb56d] Updated USAGE.md
- [aca677a] build(deps): bump actions/stale from 5 to 6
- [1cab325] vcsim: Fix RetrieveProperties path validation to avoid panic (#2953)
- [65a6f6b] Address review comments
- [99d1260] correct new lines in group.ls
- [4d9f6e0] correct new lines in USAGE.md
- [e5bee86] move FindUsersInGroup to users.ls (#2945)
- [8c7ba5e] govc: Add feature in sso.group.ls to list groups using FindGroupsInGroup method (#2945)
- [ee332ae] Add new query selection parameters to be used for QueryAllVolume/QueryVolumeAsync API
- [dc3e1d7] govc: Add feature sso.group.lsgroups using FindGroupsInGroup method (#2945)
- [201ae28] Add common stub for hgfs for non-linux env
- [7f42a1d] vcsim: use node id for ServiceContent.InstanceUuid
- [76e99b0] Boilerplate check requires a date range in the license.
- [bf991e6] govc: add event key for json and plain text output
- [4a29cae] add OpenBSD build constraint
- [81bc76b] toolbbox: add hgfs OpenBSD stub
- [0331949] vcsim: Fix snapshot tasks to update rootSnapshot (#2912)
- [b6ebcb6] vcsim: Fix disk capacity validation in ConfigureDevices (#2910)
- [2017e84] govc: Support creating content libraries with security policies (#2641)
- [642156d] api: Adds vSphere 7.0u1-u3 support to namespace-management (Tanzu) (#2860)
- [61032a2] vcsim: Fix StorageIOAllocationInfo of VirtualDisk (#2904)
- [cbfe0c9] vcsim: support disconnect/reconnect host (#2899)
- [b44828a] vcsim: Fix datastore freespace changed by ReconfigVM_Task (#2894)
v0.29.0
Release v0.29.0
Release Date: 2022-07-06
π Fix
- [d6dd8fb] Typos in vim25/soap/client CA tests (#2876)
- [e086dfe] generate negative device key in AssignController (#2881)
- [371a24a] Interface conversion panic in pkg simulator
- [a982c03] use correct controlflag for vslm SetControlFlags API test
- [37b3b24] avoid possible panic in govc metric commands (#2835)
- [310516e] govc: disambiguate vm/host search flags in vm.migrate (#2850) (#2849)
- [6af2cdc] govc-tests in Go v1.18 (#2865)
- [142cdca] Security update golangci-lint (#2861)
- [971079b] use correct vcenter.DeploymentSpec.VmConfigSpec json tag (#2843)
π« API Changes
- [e6b5974] Add versioned user-agent header (#2693)
- [ca7ee51] add VmConfigSpec field to content library DeploymentSpec (#2843)
- [7d3b2b3] Update generated types (#2891)
π« govc
(CLI)
- [515ca29] Use unique searchFlagKey when calling NewSearchFlag (#2849)
- [9d4ca65] add library.deploy '-config' flag
- [fc17df0] add 'device.clock.add' command (#2834)
- [11f2d45] Edit disk storage IO (#2806)
π« vcsim
(Simulator)
- [a1a36c9] Fix disk capacity fields in ReconfigVM_Task (#2889)
- [361c90c] Remove VM Guest.Net entry when removing Ethernet card
- [578b95e] Fix createVM to encode VM name (#2873)
- [3325da0] add content library VmConfigSpec support
- [8928a48] Update Dockerfile (#2841)
π Documentation
π§Ή Chore
- [69ac849] Update version.go for v0.29.0
- [80489cb] Update release automation (#2875)
- [e1f76e3] Add missing copyright header
- [6ed812f] Add Go boilerplate check (#2749) (#2713)
β οΈ BREAKING
- Several EAM bindings (types and methods) were removed (see #2891)
π Commits
- [69ac849] chore: Update version.go for v0.29.0
- [7d3b2b3] Update generated types
- [a1a36c9] vcsim: Fix disk capacity fields in ReconfigVM_Task (#2889)
- [5f5fb51] docs: Fix broken link in PR template (#2884)
- [d6dd8fb] fix: Typos in vim25/soap/client CA tests (#2876)
- [e086dfe] fix: generate negative device key in AssignController (#2881)
- [361c90c] vcsim: Remove VM Guest.Net entry when removing Ethernet card
- [80489cb] chore: Update release automation (#2875)
- [e6b5974] api: Add versioned user-agent header (#2693)
- [578b95e] vcsim: Fix createVM to encode VM name (#2873)
- [371a24a] fix: Interface conversion panic in pkg simulator
- [a982c03] fix: use correct controlflag for vslm SetControlFlags API test
- [37b3b24] fix: avoid possible panic in govc metric commands (#2835)
- [310516e] fix: govc: disambiguate vm/host search flags in vm.migrate (#2850) (#2849)
- [5929abf] correct SetControlFlags and ClearControlFlags APIs
- [6af2cdc] fix: govc-tests in Go v1.18 (#2865)
- [e1f76e3] chore: Add missing copyright header
- [6ed812f] chore: Add Go boilerplate check (#2749) (#2713)
- [142cdca] fix: Security update golangci-lint (#2861)
- [3f4993d] build(deps): bump chuhlomin/render-template from 1.4 to 1.5
- [971079b] fix: use correct vcenter.DeploymentSpec.VmConfigSpec json tag (#2843)
- [892dcfc] build(deps): bump nokogiri from 1.13.5 to 1.13.6 in /gen
- [303f0d9] build(deps): bump goreleaser/goreleaser-action from 2 to 3
- [7eef76c] build(deps): bump nokogiri from 1.13.4 to 1.13.5 in /gen
- [515ca29] govc: Use unique searchFlagKey when calling NewSearchFlag (#2849)
- [9d4ca65] govc: add library.deploy '-config' flag
- [c5ebd55] fix:fail to add ssd disk into allflash disk group Closes: #2846 (#2846)
- [88f48e0] Updated USAGE.md
- [3325da0] vcsim: add content library VmConfigSpec support
- [ca7ee51] api: add VmConfigSpec field to content library DeploymentSpec (#2843)
- [8928a48] vcsim: Update Dockerfile (#2841)
- [bf5d054] Fixed docs for govc library.info w/-json
- [2f9fab5] emacs: fix json mode
- [fc17df0] govc: add 'device.clock.add' command (#2834)
- [11f2d45] govc: Edit disk storage IO (#2806)