v0.47.0

Release v0.47.0

Release Date: 2025-01-02

🐞 Fix

• [3793a5b] govc fix field.info name (-n flag) validation
• [8adeb8b] SOAP vcSessionCookie value must be from vim25.Client
• [2271a78] toolbox: add freebsd stub for fileExtendedInfoFormat (#3620)
• [f08496e] vcsim: swap order of xsi type attribute (#2114)
• [973a224] assert Entity interface in mo.Value()
• [ad24cb4] Property Collector updates should be triggered on the empty FilterSet (#3631)
• [29de346] vcsim: output signed byte in ByteSlice.MarshalXML (#3615)
• [71b9c76] govc: wire up flags for namespace service create
• [5e9a140] vcsim: avoid possible panic when applying PropertyFilter

💫 API Changes

• [a447f4d] Fix OVF param to use interface
• [17b5c08] Generate bindings for 9.0.0.0.rc1
• [77de0b5] Generate API with Broadcom header
• [4b7d0c5] Specify ruby bundler for api gen
• [f238201] Update gen/gen.sh for 9.0.0.0.rc1
• [05a6d57] Support podman for building api
• [3d8b026] Build api with Go 1.23.2
• [aa8279b] Support returning DS info when resolving lib stor
• [64ca62f] Support DC for ResolveLibItemStor
• [0af06a3] Support encode/decode OVF to JSON
• [7598ae9] Fix object.VirtualDiskManager::Copy
• [b2bde00] Update OVF ToConfigSpec to handled unknown types
• [5bb9901] A generic copy function for vim25/types
• [1918984] add override mechanism for SOAP Header.Cookie
• [495a820] OVF to ConfigSpec
• [e9f9eb0] Support OVF ResourceType enum
• [42bf813] Update OVF parser to conform to spec
• [05482c0] move cli/host/esxcli.Command to cli/esx package

💫 govc (CLI)

• [ad5c90a] Update govc usage doc
• [ca2e6ff] add datastore.download -json support
• [18a3019] add -b flag to volume.ls
• [e02de72] add disk.ls '-a' flag (#3639)
• [c60f498] add datastore.ls -H option
• [228b445] remove minimum API version check (#3643)
• [7e17885] Move govc commands into cli pkg

💫 vcsim (Simulator)

• [10e9bc7] create cls vmdk descriptor and backing files
• [dd6bf66] Improve sim for pub/sub content libs
• [b7d4f00] make QueryVirtualDiskUuid() result stable
• [f398e78] add VirtualDiskManager.QueryVirtualDiskInfo (#3000) (#2555)
• [a9488e0] fix object.save when run directly against ESX
• [c0b5944] LicenseManager enhancements
• [5db2637] add UpdateAssignedLicense method
• [9322377] add esxcli support
• [53d31e9] Lock alpine image tag to non-latest tag

🧹 Chore

• [95396cd] Update version.go for v0.47.0
• [e1f1db4] update copyright header
• [538dbef] Minimum version selection

⚠️ BREAKING

Support returning DS info when resolving lib stor [aa8279b]:
This change updates the signature for the
ResolveLibraryItemStorage function.

Signed-off-by: akutz <akutz@vmware.com>

Support DC for ResolveLibItemStor [64ca62f]:
This change requires updating the use of the
ResolveLibraryItemStorage function to account for
its signature change.

Support OVF ResourceType enum [e9f9eb0]:
Users of the ovf package may need to cast ResourceType
to a uint16 depending on how they have used the value.

Signed-off-by: akutz <akutz@vmware.com>

Update OVF parser to conform to spec [42bf813]:
Users of the ovf package will need to update their
sources to conform to the changes from this patch. It
should be a fairly simple change.

move cli/host/esxcli.Command to cli/esx package [05482c0]:
Package "github.com/vmware/govmomi/govc/host/esxcli" is now "github.com/vmware/govmomi/cli/esx"
A 'context.Context' param has also been added to the package's methods.
See cli/esx/example_test.go for usage.

Move govc commands into cli pkg [7e17885]:
All packages ./govc/* (except ./govc/test) have been
relocated under the ./cli package.

Minimum version selection [538dbef]:
The go install command may no longer be used to install
govc and vcsim directly from GitHub.

This is because both packages are now distinct sub-modules that still
depend on the other packages in this project. Therefore these sub-mods
use the following replace directive:

replace github.com/vmware/govmomi -> ../

This teaches govc and vcsim where to look for the imported GoVmomi
packages. This ensures that building these binaries will pick up any
local changes to the rest of the project.

However, the go install command does not support installing modules
from a remote location if the module contains a replace directive.
This means users will need to either clone all of
github.com/vmware/govmomi before running go -C govc install or
go -C vcsim install, or they can download the released binaries
directly.

📖 Commits

• [95396cd] chore: Update version.go for v0.47.0
• [ad5c90a] govc: Update govc usage doc
• [a447f4d] api: Fix OVF param to use interface
• [17b5c08] api: Generate bindings for 9.0.0.0.rc1
• [77de0b5] api: Generate API with Broadcom header
• [4b7d0c5] api: Specify ruby bundler for api gen
• [f238201] api: Update gen/gen.sh for 9.0.0.0.rc1
• [05a6d57] api: Support podman for building api
• [3d8b026] api: Build api with Go 1.23.2
• [ca2e6ff] govc: add datastore.download -json support
• [e1f1db4] chore: update copyright header
• [10e9bc7] vcsim: create cls vmdk descriptor and backing files
• [dd6bf66] vcsim: Improve sim for pub/sub content libs
• [18a3019] govc: add -b flag to volume.ls
• [cd78f76] cns: add json tags (#3007) (#3247)
• [aa8279b] api: Support returning DS info when resolving lib stor
• [64ca62f] api: Support DC for ResolveLibItemStor
• [e02de72] govc: add disk.ls '-a' flag (#3639)
• [0af06a3] api: Support encode/decode OVF to JSON
• [c60f498] govc: add datastore.ls -H option
• [3793a5b] fix: govc fix field.info name (-n flag) validation
• [8adeb8b] fix: SOAP vcSessionCookie value must be from vim25.Client
• [7598ae9] api: Fix object.VirtualDiskManager::Copy
• [b7d4f00] vcsim: make QueryVirtualDiskUuid() result stable
• [f398e78] vcsim: add VirtualDiskManager.QueryVirtualDiskInfo (#3000) (#2555)
• [a9488e0] vcsim: fix object.save when run directly against ESX
• [c0b5944] vcsim: LicenseManager enhancements
• [b2bde00] api: Update OVF ToConfigSpec to handled unknown types
• [5bb9901] api: A generic copy function for vim25/types
• [228b445] govc: remove minimum API version check (#3643)
• [1918984] api: add override mechanism for SOAP Header.Cookie
• [495a820] api: OVF to ConfigSpec
• [83aab93] Deprecate haproxy with vSphere 9.0
• [2271a78] fix: toolbox: add freebsd stub for fileExtendedInfoFormat (#3620)
• [3a15139] build(deps): bump golang.org/x/text from 0.18.0 to 0.21.0
• [f08496e] fix: vcsim: swap order of xsi type attribute (#2114)
• [e9f9eb0] api: Support OVF ResourceType enum
• [42bf813] api: Update OVF parser to conform to spec
• [5db2637] vcsim: add UpdateAssignedLicense method
• [973a224] fix: assert Entity interface in mo.Value()
• [05482c0] api: move cli/host/esxcli.Command to cli/esx package
• [87e4e6a] build(deps): bump github.com/stretchr/testify from 1.9.0 to 1.10.0
• [9322377] vcsim: add esxcli support
• [ad24cb4] fix: Property Collector updates should be triggered on the empty FilterSet (#3631)
• [29de346] fix: vcsim: output signed byte in ByteSlice.MarshalXML (#3615)
• [7e17885] govc: Move govc commands into cli pkg
• [71b9c76] fix: govc: wire up flags for namespace service create
• [53d31e9] vcsim: Lock alpine image tag to non-latest tag
• [5e9a140] fix: vcsim: avoid possible panic when applying PropertyFilter
• [538dbef] chore: Minimum version selection
• [3e8e2e5] cns: Support encryption/re-encryption of volumes

v0.46.3

Release v0.46.3

Release Date: 2024-12-12

🐞 Fix

• [0ef1c70] toolbox: add freebsd stub for fileExtendedInfoFormat (#3620)
• [675534a] vcsim: swap order of xsi type attribute (#2114)
• [1481d91] assert Entity interface in mo.Value()
• [3f5f887] Property Collector updates should be triggered on the empty FilterSet (#3631)

💫 govc (CLI)

• [211be90] remove minimum API version check (#3643)

💫 vcsim (Simulator)

• [7bde166] fix object.save when run directly against ESX
• [4aae3ca] LicenseManager enhancements
• [9ec310a] add UpdateAssignedLicense method

🧹 Chore

• [e5dcb5f] Update version.go for v0.46.3

⚠️ BREAKING

📖 Commits

• [e5dcb5f] chore: Update version.go for v0.46.3
• [0ef1c70] fix: toolbox: add freebsd stub for fileExtendedInfoFormat (#3620)
• [7bde166] vcsim: fix object.save when run directly against ESX
• [4aae3ca] vcsim: LicenseManager enhancements
• [675534a] fix: vcsim: swap order of xsi type attribute (#2114)
• [211be90] govc: remove minimum API version check (#3643)
• [9ec310a] vcsim: add UpdateAssignedLicense method
• [1481d91] fix: assert Entity interface in mo.Value()
• [3f5f887] fix: Property Collector updates should be triggered on the empty FilterSet (#3631)

v0.46.2

Release v0.46.2

Release Date: 2024-11-20

🐞 Fix

• [2f0120b] vcsim: output signed byte in ByteSlice.MarshalXML (#3615)

🧹 Chore

• [c3916ff] Update version.go for v0.46.2

⚠️ BREAKING

📖 Commits

• [c3916ff] chore: Update version.go for v0.46.2
• [2f0120b] fix: vcsim: output signed byte in ByteSlice.MarshalXML (#3615)

v0.46.1

Release v0.46.1

Release Date: 2024-11-15

🐞 Fix

• [6f7bceb] vcsim: avoid possible panic when applying PropertyFilter

🧹 Chore

• [0ded546] Update version.go for v0.46.1

⚠️ BREAKING

📖 Commits

• [0ded546] chore: Update version.go for v0.46.1
• [6f7bceb] fix: vcsim: avoid possible panic when applying PropertyFilter
• [d51c0a3] cns: Support encryption/re-encryption of volumes

v0.46.0

Release v0.46.0

Release Date: 2024-11-06

🐞 Fix

• [f9d093b] Set DuplicateName Object to duplicate object (#3610)
• [60d4b04] CreateSATAController to return error when no bus numbers
• [fe93450] vcsim: avoid race in DestroyPropertyFilter

💫 API Changes

• [ae55823] Support CnsBlockCreateSpec
• [a9d5985] support MOID conversion in Finder methods
• [5c54c3f] change ManagerKmip.IsValidKey to use QueryCryptoKeyStatus
• [6ecb208] add crypto.ManagerKmip.QueryCryptoKeyStatus
• [6e84b72] Fetch crypto key in GetVirtualDiskInfoByUUID

💫 govc (CLI)

• [fdb091c] add vm.change -migrate-encryption and -ft-encryption-mode options (#3493)
• [8f3b0a3] add '-I' flag to ls and find commands
• [66fc63a] add kms.key commands

💫 vcsim (Simulator)

• [ca05e10] add QueryCryptoKeyStatus

🧹 Chore

• [35c4569] Update version.go for v0.46.0
• [34ca8c8] skip tests unless running docker on linux (#3604)

⚠️ BREAKING

change ManagerKmip.IsValidKey to use QueryCryptoKeyStatus [5c54c3f]:
IsValidKey now requires a key providerID param.

📖 Commits

• [35c4569] chore: Update version.go for v0.46.0
• [fdb091c] govc: add vm.change -migrate-encryption and -ft-encryption-mode options (#3493)
• [ae55823] api: Support CnsBlockCreateSpec
• [a9d5985] api: support MOID conversion in Finder methods
• [8f3b0a3] govc: add '-I' flag to ls and find commands
• [f9d093b] fix: Set DuplicateName Object to duplicate object (#3610)
• [34ca8c8] chore: skip tests unless running docker on linux (#3604)
• [60d4b04] fix: CreateSATAController to return error when no bus numbers
• [5c54c3f] api: change ManagerKmip.IsValidKey to use QueryCryptoKeyStatus
• [ca05e10] vcsim: add QueryCryptoKeyStatus
• [66fc63a] govc: add kms.key commands
• [6ecb208] api: add crypto.ManagerKmip.QueryCryptoKeyStatus
• [fe93450] fix: vcsim: avoid race in DestroyPropertyFilter
• [6e84b72] api: Fetch crypto key in GetVirtualDiskInfoByUUID
• [0206f07] Fix error assertion in IsCertificateUntrusted

v0.45.1

Release v0.45.1

Release Date: 2024-10-23

🧹 Chore

• [af51f76] Update version.go for v0.45.1

⚠️ BREAKING

📖 Commits

• [af51f76] chore: Update version.go for v0.45.1
• [0ed140e] Fix error assertion in IsCertificateUntrusted

v0.45.0

Release v0.45.0

Release Date: 2024-10-21

🐞 Fix

• [8446478] Add missing privileges in simulator role
• [36ee9a1] Cross-platform path handling (#3555)
• [71378bc] check controller type in simulator configureDevice
• [c44199a] update controller's device list in AssignController
• [17f6966] ensure proper vSAN URI format in ResolveLibraryItemStorage
• [60f2a6e] Use absolute path for reading manifest (#3550)
• [36cac69] Abort lease on upload failure (#3554)

💫 API Changes

• [d14cbf3] tags error handling (#3112)

💫 govc (CLI)

• [407da6c] rename 'object.collect' -> 'collect'
• [aec1122] display default provider in kms.ls output
• [831b722] Add an unreleased folder.place command for PlaceVMsXCluster
• [2bbc6d8] support use of service version via GOVC_VIM_VERSION env var

🧹 Chore

• [888548b] Update version.go for v0.45.0

⚠️ BREAKING

📖 Commits

• [888548b] chore: Update version.go for v0.45.0
• [407da6c] govc: rename 'object.collect' -> 'collect'
• [aec1122] govc: display default provider in kms.ls output
• [8446478] fix: Add missing privileges in simulator role
• [36ee9a1] fix: Cross-platform path handling (#3555)
• [0083eae] bug: Do not panic on fault.In for valid errs
• [831b722] govc: Add an unreleased folder.place command for PlaceVMsXCluster
• [71378bc] fix: check controller type in simulator configureDevice
• [c44199a] fix: update controller's device list in AssignController
• [2bbc6d8] govc: support use of service version via GOVC_VIM_VERSION env var
• [17f6966] fix: ensure proper vSAN URI format in ResolveLibraryItemStorage
• [d14cbf3] api: tags error handling (#3112)
• [60f2a6e] fix: Use absolute path for reading manifest (#3550)
• [36cac69] fix: Abort lease on upload failure (#3554)

v0.44.1

Release v0.44.1

Release Date: 2024-10-09

🐞 Fix

• [05544f7] ensure proper vSAN URI format in ResolveLibraryItemStorage

🧹 Chore

• [8234db4] Update version.go for v0.44.1

⚠️ BREAKING

📖 Commits

• [8234db4] chore: Update version.go for v0.44.1
• [05544f7] fix: ensure proper vSAN URI format in ResolveLibraryItemStorage

v0.44.0

Release v0.44.0

Release Date: 2024-10-07

🐞 Fix

• [bf6e162] synchronize access to session.Manager.userSession (#3571)

💡 Examples

• [da37212] add ExampleListView_ofContainerView

💫 API Changes

• [733f1c0] Update folder.PlaceVMsXCluster to support several placement types
• [4665dff] disable http.Transport.ForceAttemptHTTP2 by default (#3564)
• [d95d350] add vapi/crypto package with support for native KMS
• [d2ccadf] add rest.Client.DownloadAttachment method
• [cb0453c] extract NewDatastoreURL from Datastore.NewURL method
• [9a02a4a] Support querying PBM profile for IOFILTERS
• [92797d4] Helpers for key management servers

💫 govc (CLI)

• [844fa1c] update help url
• [7daac37] add vm.change -managed-by flag
• [2613278] add storage.policy.info flag to query IO filters
• [108e4fd] add native kms provider support
• [ccf449e] add kms commands

💫 vcsim (Simulator)

• [5a9567f] lock ViewManager in RegisterObject callbacks
• [6267644] add *Context param to UpdateObject interface method
• [3ba044c] support clearing ManagedBy field (#3572)
• [2c49326] handle traversal spec object updates
• [fc91180] ModifyListView 'remove' does not return unresolved objects
• [1f0838e] override response namespace from struct tag
• [6cea86e] fix RelocateVM_Task related races (#3565)
• [f81e83d] support cluster registration in RegisterKmipServer
• [cddbe1f] Gen enc key w default provider on createvm

📃 Documentation

• [707acb8] sync CHANGELOG (#3286)
• [582eefa] various updates

🧹 Chore

• [ff95505] Update version.go for v0.44.0
• [f807c48] fixup internal version
• [70edf99] bump default ClientVersion
• [e6bfadb] bump Go versions
• [4d0e69d] fix GH Action tag output param
• [796892a] rename crypto.Manager RegisterKmipCluster > RegisterKmsCluster
• [2b65990] simplify error handling by using the new fault package

⚠️ BREAKING

📖 Commits

• [ff95505] chore: Update version.go for v0.44.0
• [f807c48] chore: fixup internal version
• [5a9567f] vcsim: lock ViewManager in RegisterObject callbacks
• [844fa1c] govc: update help url
• [d0278e2] build(deps): bump golang.org/x/text from 0.18.0 to 0.19.0
• [6267644] vcsim: add *Context param to UpdateObject interface method
• [7daac37] govc: add vm.change -managed-by flag
• [3ba044c] vcsim: support clearing ManagedBy field (#3572)
• [bf6e162] fix: synchronize access to session.Manager.userSession (#3571)
• [da37212] examples: add ExampleListView_ofContainerView
• [2c49326] vcsim: handle traversal spec object updates
• [fc91180] vcsim: ModifyListView 'remove' does not return unresolved objects
• [70edf99] chore: bump default ClientVersion
• [707acb8] docs: sync CHANGELOG (#3286)
• [e6bfadb] chore: bump Go versions
• [4d0e69d] chore: fix GH Action tag output param
• [582eefa] docs: various updates
• [2613278] govc: add storage.policy.info flag to query IO filters
• [da340f5] Use internalpbm namespace for PbmQueryIOFiltersFromProfileId
• [1f0838e] vcsim: override response namespace from struct tag
• [733f1c0] api: Update folder.PlaceVMsXCluster to support several placement types
• [4665dff] api: disable http.Transport.ForceAttemptHTTP2 by default (#3564)
• [6cea86e] vcsim: fix RelocateVM_Task related races (#3565)
• [108e4fd] govc: add native kms provider support
• [d95d350] api: add vapi/crypto package with support for native KMS
• [d2ccadf] api: add rest.Client.DownloadAttachment method
• [cb0453c] api: extract NewDatastoreURL from Datastore.NewURL method
• [9a02a4a] api: Support querying PBM profile for IOFILTERS
• [ccf449e] govc: add kms commands
• [796892a] chore: rename crypto.Manager RegisterKmipCluster > RegisterKmsCluster
• [f81e83d] vcsim: support cluster registration in RegisterKmipServer
• [cddbe1f] vcsim: Gen enc key w default provider on createvm
• [92797d4] api: Helpers for key management servers
• [2b65990] chore: simplify error handling by using the new fault package

v0.43.0

Release v0.43.0

Release Date: 2024-09-10

🐞 Fix

• [97aa721] vcsim: avoid possible race when encoding PropertyCollector response (#3533)
• [ad2d357] use complete InventoryPath in Datacenter.Folders (#3523)

💫 API Changes

• [476704a] Fault helpers
• [caad54a] add VirtualMachine.AddDeviceWithProfile method
• [a316da5] VirtualMachine.AttachDisk unitNumber param is optional
• [8491321] ToString for vim types
• [6461021] add namespace.RegisterVM binding
• [e602029] Fix panic when encoding nil iface ptrs to JSON

💫 govc (CLI)

• [8fd8691] add disk.create '-profile' flag
• [ea3cf25] add vm.disk.create '-profile' flag
• [e73c34f] add vm.disk.attach '-profile' flag
• [06dcf31] Add '-size' flag to datastore.create (#3519)
• [23390c2] add namespace.registervm command
• [1892eec] Support thick/eager disk opts on vm.create (#3526)

💫 vcsim (Simulator)

• [8421b67] Support PlaceVm with relocate placement type
• [9234233] Support PlaceVm with reconfigure placement type
• [f06d083] add VirtualMachine AttachDisk and DetachDisk methods
• [35dc193] Support VM crypto spec in vC Sim
• [0517b87] add namespace/registervm implementation

🧹 Chore

• [b17abb2] Update version.go for v0.43.0
• [93da4a2] sync generated govc/USAGE.md
• [51105db] govc: add common StorageProfileFlag

⚠️ BREAKING

VirtualMachine.AttachDisk unitNumber param is optional [a316da5]:
switching from int32 to *int32, otherwise the client must choose a valid unitNumber.
vCenter will choose a unitNumber when not provided.

📖 Commits

• [b17abb2] chore: Update version.go for v0.43.0
• [476704a] api: Fault helpers
• [8421b67] vcsim: Support PlaceVm with relocate placement type
• [93b97e1] Update library state info to content library API
• [9234233] vcsim: Support PlaceVm with reconfigure placement type
• [a2cbe10] build(deps): bump golang.org/x/text from 0.17.0 to 0.18.0
• [93da4a2] chore: sync generated govc/USAGE.md
• [8fd8691] govc: add disk.create '-profile' flag
• [ea3cf25] govc: add vm.disk.create '-profile' flag
• [e73c34f] govc: add vm.disk.attach '-profile' flag
• [51105db] chore: govc: add common StorageProfileFlag
• [caad54a] api: add VirtualMachine.AddDeviceWithProfile method
• [f06d083] vcsim: add VirtualMachine AttachDisk and DetachDisk methods
• [97aa721] fix: vcsim: avoid possible race when encoding PropertyCollector response (#3533)
• [014a150] build(deps): bump peter-evans/create-pull-request from 6 to 7
• [35dc193] vcsim: Support VM crypto spec in vC Sim
• [a56e33d] Add BackingDiskPath to BackingObjectDetails
• [06dcf31] govc: Add '-size' flag to datastore.create (#3519)
• [f881d9b] govc add disk.attach and disk.detach commands
• [a316da5] api: VirtualMachine.AttachDisk unitNumber param is optional
• [8491321] api: ToString for vim types
• [0517b87] vcsim: add namespace/registervm implementation
• [23390c2] govc: add namespace.registervm command
• [6461021] api: add namespace.RegisterVM binding
• [e602029] api: Fix panic when encoding nil iface ptrs to JSON
• [1892eec] govc: Support thick/eager disk opts on vm.create (#3526)
• [ad2d357] fix: use complete InventoryPath in Datacenter.Folders (#3523)