github.com/vmware/govmomi

Release Date: 2025-08-18

🐞 Fix

• [5c16d3fb] vcsim: Avoid panic in QueryAvailablePerfMetric if VM has no Datastore

💫 API Changes

• [2278e0e4] Update folder.PlaceVMsXCluster to return available candidate networks
• [28eeab9a] fix comments and doc links
• [7a3647c2] fix action parameters
• [8ee99953] update drafts bindings
• [37dd0c84] bindings for esx/settings/clusters/cluster/configuration/drafts
• [70746555] Placement policy WSDL names changed
• [55501e2b] add bindings for recent tasks and schema
• [32307656] add bindings for esx/settings/cluster/configuration
• [74eea104] add bindings for esx/settings/cluster/enablement/configuration/transition
• [e61ad354] Update folder.PlaceVMsXCluster to filter clusters based on candidate networks availability - Add GoVmomi Bindings to CandidateNetworks - Made changes suggested by Shengjie
• [8784335c] Add "lsilogicsas" alias for "lsilogic-sas" in CreateSCSIController

💫 govc (CLI)

• [0b0e0cc3] Add vmclass configSpec options

💫 vcsim (Simulator)

• [3efce106] add SearchIndex.FindAllByUuid() support
• [5a50d408] Fault injection
• [2fed3413] CreateVm should allow existing nvram files
• [38a84889] Resolve NSX OpaqueBacking to the DistributedVirtualPortgroup
• [25ce2a12] Avoid panic if VM NIC is removed after CustomizeVM

📃 Documentation

• [d0143b1a] update CHANGELOG.md (#3839) (#3839)

🧹 Chore

• [e53c30d0] Update version.go for v0.52.0

⚠️ BREAKING

📖 Commits

• [e53c30d0] chore: Update version.go for v0.52.0
• [d0143b1a] docs: update CHANGELOG.md (#3839) (#3839)
• [edf81adb] build(deps): bump golang.org/x/text from 0.26.0 to 0.28.0 (#3835) (#3835)
• [521695dc] build(deps): bump goreleaser/goreleaser-action from 6.3.0 to 6.4.0 (#3838) (#3838)
• [161b964c] build(deps): bump github.com/go-viper/mapstructure/v2 (#3811) (#3811)
• [90a7f76a] build(deps): bump nokogiri from 1.18.8 to 1.18.9 in /gen (#3822) (#3822)
• [57127bae] build(deps): bump test-unit from 3.6.8 to 3.7.0 in /gen (#3817) (#3817)
• [0e836f2b] build(deps): bump actions/cache from 4.2.3 to 4.2.4 (#3834) (#3834)
• [aa32ef3a] vcsim : Remove the single VM limitation for PlaceVmsXCluster API
• [2278e0e4] api: Update folder.PlaceVMsXCluster to return available candidate networks
• [74528cfb] Add option to GetVirtualDiskInfoByUUID for choosing exclude snapshot disks when calculating virtualdisk size
• [debe7c71] update json tags and add tests for syncvolume api
• [245af177] binding for CnsKubernetesQueryFilter
• [b74b010c] Implement bindings for CNS Unregister Volume Created new method called CnsUnregisterVolume Created CnsUnregisterVolume, CnsUnregisterVolumeRequestType and CnsUnregisterVolumeResponse types Created UnregisterVolume method on CNS Client Created TestUnregisterVolume function to test the changes
• [28eeab9a] api: fix comments and doc links
• [f12361c7] Add tests for types of meta fault (#3824) (#3824)
• [7a3647c2] api: fix action parameters
• [8ee99953] api: update drafts bindings
• [37dd0c84] api: bindings for esx/settings/clusters/cluster/configuration/drafts
• [70746555] api: Placement policy WSDL names changed
• [55501e2b] api: add bindings for recent tasks and schema
• [32307656] api: add bindings for esx/settings/cluster/configuration
• [74eea104] api: add bindings for esx/settings/cluster/enablement/configuration/transition
• [3efce106] vcsim: add SearchIndex.FindAllByUuid() support
• [e48f1ffa] Add CnsSyncVolume API bindings
• [d25f318f] Update govc/USAGE.md
• [858de8d6] Introduce Govmomi bindings to support VM placement policies
• [b67bf1a6] Added new simulator test TestPlaceVmsXClusterCreateAndPowerOnWithCandidateNetworks
• [4a142ef2] Made changes suggested in review - removed go.mod
• [915ef1e2] Fix binding generation by bumping Ruby version
• [6248951d] Updated folder.place usage
• [9822e170] Add shared disk parameters to Cns AttachDetach Spec
• [e61ad354] api: Update folder.PlaceVMsXCluster to filter clusters based on candidate networks availability - Add GoVmomi Bindings to CandidateNetworks - Made changes suggested by Shengjie
• [0c586025] Fix the quotation in the copyright header
• [281c86f0] update CnsVolumeCreateSpec and CnsVolumeOperationResult
• [109a53a8] Add SPBM internal types and methods related to K8s compliant names changes
• [cbbe8d22] handle vim25:NotSupported returned with CnsFault
• [24f4996f] skip CNS transaction tests when env CNS_RUN_TRANSACTION_TESTS is not set
• [870f1e7b] update CnsVolumeCreateSpec and CnsSnapshotCreateSpec for Transaction Support. add new fault CnsVolumeAlreadyExistsFault
• [0e4a0fa8] Added govmomi binding changes for SPBM API changes for reserve K8s compliant name feature
• [5a50d408] vcsim: Fault injection
• [2fed3413] vcsim: CreateVm should allow existing nvram files
• [8febefc0] Add linkedClone creation support for CNS volumes
• [8784335c] api: Add "lsilogicsas" alias for "lsilogic-sas" in CreateSCSIController
• [38a84889] vcsim: Resolve NSX OpaqueBacking to the DistributedVirtualPortgroup
• [0b0e0cc3] govc: Add vmclass configSpec options
• [25ce2a12] vcsim: Avoid panic if VM NIC is removed after CustomizeVM
• [5c16d3fb] fix: vcsim: Avoid panic in QueryAvailablePerfMetric if VM has no Datastore

<a name="v0.51.0"></a>

Release Date: 2025-05-23

🐞 Fix

• [e61afb1d] vcsim: Avoid possible race in SessionManager.Logout

💫 API Changes

• [2250eba3] Add option to use a filter function as value of property.Match (#3785)
• [a534f395] Add object.VirtualMachine.CreateSnapshotEx method
• [761efe91] Add object.VirtualMachine.PromoteDisks method
• [a09e0ec5] Extend vmdk.Info to include Descriptor

💫 govc (CLI)

• [59cb29b9] Add vm.disk.promote command
• [eaaeb841] Add import.vmdk '-i' flag to output vmdk info only

💫 vcsim (Simulator)

• [30750a65] Add CreateSnapshotEx for simulator
• [6af11fcf] Use OptionManager to configure session timeout duration
• [40a596c8] Add VirtualMachine.PromoteDisks_Task method
• [22c7be30] Use vmdk.Descriptor for vmdk file metadata
• [54f2b702] Avoid use of sha1 for stable UUIDs (OIDs) (#3766)

🧹 Chore

• [50196949] Update version.go for v0.51.0
• [a5f933dc] update container images
• [9002dc9e] update .goreleaser.yml to v2

⚠️ BREAKING

Use OptionManager to configure session timeout duration [6af11fcf]: var simulator.SessionIdleTimeout has been removed. Use sim25.SetSessionTimeout instead.

📖 Commits

• [50196949] chore: Update version.go for v0.51.0
• [2250eba3] api: Add option to use a filter function as value of property.Match (#3785)
• [30750a65] vcsim: Add CreateSnapshotEx for simulator
• [a534f395] api: Add object.VirtualMachine.CreateSnapshotEx method
• [6af11fcf] vcsim: Use OptionManager to configure session timeout duration
• [2bcb4c36] build(deps): bump actions/setup-go from 5.4.0 to 5.5.0
• [bf0dfcbe] chore(deps): go mod tidy
• [d41f29dc] build(deps): bump golang.org/x/text from 0.24.0 to 0.25.0
• [40a596c8] vcsim: Add VirtualMachine.PromoteDisks_Task method
• [59cb29b9] govc: Add vm.disk.promote command
• [761efe91] api: Add object.VirtualMachine.PromoteDisks method
• [22c7be30] vcsim: Use vmdk.Descriptor for vmdk file metadata
• [98ad4c12] build(deps): bump mxschmitt/action-tmate from 3.21 to 3.22
• [eaaeb841] govc: Add import.vmdk '-i' flag to output vmdk info only
• [a09e0ec5] api: Extend vmdk.Info to include Descriptor
• [e61afb1d] fix: vcsim: Avoid possible race in SessionManager.Logout
• [0cbdbf0d] emacs: Add datastore.ls '-a' flag when prefix arg is given
• [a5f933dc] chore: update container images
• [54f2b702] vcsim: Avoid use of sha1 for stable UUIDs (OIDs) (#3766)
• [49ec77a5] build(deps): bump test-unit from 3.6.7 to 3.6.8 in /gen
• [ecbccf52] build(deps): bump mxschmitt/action-tmate from 3.20 to 3.21
• [b1a3a202] build(deps): bump nokogiri in /gen in the bundler group
• [9002dc9e] chore: update .goreleaser.yml to v2

<a name="v0.50.0"></a>

Release Date: 2025-04-21

🐞 Fix

• [28b39ed2] vcsim -load Datastore summary.url property (#3705)
• [5833c6c4] vcsim: fix PropertyFilter/Collector memory leak

💫 API Changes

• [7a02bd92] Rewrite lookup service URLs on DNS error
• [eb53c23b] add PodVMOverheadInfo type and HostCapability field
• [af92671c] use crypto/rand for nonce generation
• [036a4d13] use ParseInt and add int32 bounds check
• [c99e28ca] Add optional CategoryID,TagID fields for category and tag creation (#3706)

💫 govc (CLI)

• [ab3050b1] Support Datastore Cluster in import.ova command (#1265)
• [75f2762f] Add import.ova -net flag (#3679)
• [96ad8abd] Add -lease option to import/export commands
• [aa5a378a] Support -p and -s in with single task.set
• [088003eb] Add vm.policy.ls command (#3727)
• [278ebc9b] Support snapshot.export
• [a8997d55] fix integer type conversion
• [b40a2ace] fix integer type conversion for guest.chown
• [d2b4cc7b] Add '-id' option for tags.category and tags create commands

💫 vcsim (Simulator)

• [af3bc8b7] Populate guest.ipStack property for container backed VMs
• [282553ee] Add minimal json-rpc support
• [89942b79] Use the simulator's URL.Host in NFC lease URLs
• [3040a0a9] support multiple VirtualSystemType in OvfManager.CreateImportSpec
• [ad31c4f5] fix integer type conversion
• [87e9b3e8] Add vapi support for CategoryID and TagID fields

📃 Documentation

• [4e6a5f87] remove legacy docs links
• [8a592e2e] update kb urls
• [795b5648] Update various API reference links

🧹 Chore

• [6ed9b22e] Update version.go for v0.50.0
• [d1eb5e21] vim25/xml: sync with Go 1.24 encoding/xml
• [e74e67ed] gofmt -w -r 'interface{} -> any' .
• [25e74a37] update copyright
• [e966b838] update vmware/govc and vmware/vcsim dockerfiles
• [a628d181] update codeql workflow

⚠️ BREAKING

📖 Commits

• [6ed9b22e] chore: Update version.go for v0.50.0
• [554b6d0c] chore(gh): update release
• [1891935f] build(deps): bump mxschmitt/action-tmate from 3.19 to 3.20
• [af3bc8b7] vcsim: Populate guest.ipStack property for container backed VMs
• [f02f5681] Handle the duration field as string
• [7a02bd92] api: Rewrite lookup service URLs on DNS error
• [282553ee] vcsim: Add minimal json-rpc support
• [89942b79] vcsim: Use the simulator's URL.Host in NFC lease URLs
• [ab3050b1] govc: Support Datastore Cluster in import.ova command (#1265)
• [75f2762f] govc: Add import.ova -net flag (#3679)
• [28b39ed2] fix: vcsim -load Datastore summary.url property (#3705)
• [96ad8abd] govc: Add -lease option to import/export commands
• [aa5a378a] govc: Support -p and -s in with single task.set
• [4e6a5f87] docs: remove legacy docs links
• [8a592e2e] docs: update kb urls
• [d52c1f80] chore(deps): go mod tidy
• [89c260b8] build(deps): bump golang.org/x/text from 0.23.0 to 0.24.0
• [088003eb] govc: Add vm.policy.ls command (#3727)
• [795b5648] docs: Update various API reference links
• [3040a0a9] vcsim: support multiple VirtualSystemType in OvfManager.CreateImportSpec
• [278ebc9b] govc: Support snapshot.export
• [d1eb5e21] chore: vim25/xml: sync with Go 1.24 encoding/xml
• [5833c6c4] fix: vcsim: fix PropertyFilter/Collector memory leak
• [b15bf06f] build(deps): bump goreleaser/goreleaser-action from 6.2.1 to 6.3.0
• [eb53c23b] api: add PodVMOverheadInfo type and HostCapability field
• [a790f8a9] refactor: header check
• [e74e67ed] chore: gofmt -w -r 'interface{} -> any' .
• [25e74a37] chore: update copyright
• [ad31c4f5] vcsim: fix integer type conversion
• [d1cb2a32] chore(deps): update bundler to v2 for dependabot
• [8e40bd3f] build(deps): bump actions/cache from 4.2.2 to 4.2.3
• [0a2a3b13] build(deps): bump actions/upload-artifact from 4.6.1 to 4.6.2
• [f8d2b7f0] build(deps): bump actions/setup-go from 5.3.0 to 5.4.0
• [e966b838] chore: update vmware/govc and vmware/vcsim dockerfiles
• [af92671c] api: use crypto/rand for nonce generation
• [036a4d13] api: use ParseInt and add int32 bounds check
• [a628d181] chore: update codeql workflow
• [a8997d55] govc: fix integer type conversion
• [b40a2ace] govc: fix integer type conversion for guest.chown
• [50264167] build(deps): bump actions/stale from 9.0.0 to 9.1.0
• [13746e82] build(deps): bump actions/setup-go from 5.0.0 to 5.3.0
• [1d474f48] chore(gh): update dependabot
• [69643bd7] toolbox: fix codeql go/zipslip
• [1996bca2] chore(gh): update release workflow
• [9e95e5a7] chore(gh): update unit tests workflow
• [f7ecbc9b] chore(gh): update build workflow
• [701a9511] chore(gh): update linting workflow
• [6260daaa] chore(gh): update govc tests workflow
• [cb5e9108] chore(gh): update wip workflow
• [67d10d52] chore(gh): add lock workflow
• [61147b65] chore(gh): update stale workflow
• [9edf6aad] chore(gh): update docker workflow
• [4cd16c72] chore(gh): update greeting workflow
• [14d73d64] chore(gh): update codeql workflow
• [649b4900] chore(gh): update to ubuntu-latest runner
• [87e9b3e8] vcsim: Add vapi support for CategoryID and TagID fields
• [d2b4cc7b] govc: Add '-id' option for tags.category and tags create commands
• [c99e28ca] api: Add optional CategoryID,TagID fields for category and tag creation (#3706)

<a name="v0.49.0"></a>