docs: Update various API reference links

dougm · dougm · commit 795b56486371 · 2025-04-05T12:03:36.000-07:00
Signed-off-by: Doug MacEachern &lt;dougm@broadcom.com&gt;
diff --git a/cli/vm/create.go b/cli/vm/create.go
@@ -195,7 +195,7 @@ func (cmd *create) Description() string {
 	return `Create VM.
 
 For a list of possible '-g' IDs, use 'govc vm.option.info' or see:
-https://code.vmware.com/apis/358/vsphere/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
+https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
 
 Examples:
   govc vm.create -on=false vm-name
diff --git a/examples/datastores/main.go b/examples/datastores/main.go
@@ -35,7 +35,7 @@ func main() {
 		defer v.Destroy(ctx)
 
 		// Retrieve summary property for all datastores
-		// Reference: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.Datastore.html
+		// Reference: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.Datastore.html
 		var dss []mo.Datastore
 		err = v.Retrieve(ctx, []string{"Datastore"}, []string{"summary"}, &dss)
 		if err != nil {
diff --git a/examples/hosts/main.go b/examples/hosts/main.go
@@ -36,7 +36,7 @@ func main() {
 		defer v.Destroy(ctx)
 
 		// Retrieve summary property for all hosts
-		// Reference: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.HostSystem.html
+		// Reference: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.HostSystem.html
 		var hss []mo.HostSystem
 		err = v.Retrieve(ctx, []string{"HostSystem"}, []string{"summary"}, &hss)
 		if err != nil {
diff --git a/examples/networks/main.go b/examples/networks/main.go
@@ -26,7 +26,7 @@ func main() {
 
 		defer v.Destroy(ctx)
 
-		// Reference: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.Network.html
+		// Reference: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.Network.html
 		var networks []mo.Network
 		err = v.Retrieve(ctx, []string{"Network"}, nil, &networks)
 		if err != nil {
diff --git a/examples/virtualmachines/main.go b/examples/virtualmachines/main.go
@@ -32,7 +32,7 @@ func main() {
 		defer v.Destroy(ctx)
 
 		// Retrieve summary property for all machines
-		// Reference: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.VirtualMachine.html
+		// Reference: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.VirtualMachine.html
 		var vms []mo.VirtualMachine
 		err = v.Retrieve(ctx, []string{"VirtualMachine"}, []string{"summary"}, &vms)
 		if err != nil {
diff --git a/govc/USAGE.md b/govc/USAGE.md
@@ -6846,7 +6846,7 @@ Usage: govc vm.create [OPTIONS] NAME
 Create VM.
 
 For a list of possible '-g' IDs, use 'govc vm.option.info' or see:
-https://code.vmware.com/apis/358/vsphere/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
+https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
 
 Examples:
   govc vm.create -on=false vm-name
diff --git a/list/lister.go b/list/lister.go
@@ -30,7 +30,7 @@ func ToElement(r mo.Reference, prefix string) Element {
 
 	// Comments about types to be expected in folders copied from the
 	// documentation of the Folder managed object:
-	// http://pubs.vmware.com/vsphere-55/topic/com.vmware.wssdk.apiref.doc/vim.Folder.html
+	// https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.Folder.html
 	switch m := r.(type) {
 	case mo.Folder:
 		name = m.Name
diff --git a/object/distributed_virtual_portgroup.go b/object/distributed_virtual_portgroup.go
@@ -38,7 +38,7 @@ func (p DistributedVirtualPortgroup) EthernetCardBackingInfo(ctx context.Context
 		return nil, err
 	}
 
-	// From the docs at https://code.vmware.com/apis/196/vsphere/doc/vim.dvs.DistributedVirtualPortgroup.ConfigInfo.html:
+	// From the docs at https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.dvs.DistributedVirtualPortgroup.ConfigInfo.html:
 	// "This property should always be set unless the user's setting does not have System.Read privilege on the object referred to by this property."
 	// Note that "the object" refers to the Switch, not the PortGroup.
 	if dvp.Config.DistributedVirtualSwitch == nil {
diff --git a/property/collector.go b/property/collector.go
@@ -27,7 +27,7 @@ var ErrConcurrentCollector = fmt.Errorf(
 // Collector models the PropertyCollector managed object.
 //
 // For more information, see:
-// http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvmodl.query.PropertyCollector.html
+// https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vmodl.query.PropertyCollector.html
 type Collector struct {
 	mu           sync.Mutex
 	roundTripper soap.RoundTripper
diff --git a/simulator/virtual_machine.go b/simulator/virtual_machine.go
@@ -1147,11 +1147,10 @@ func (vm *VirtualMachine) create(ctx *Context, spec *types.VirtualMachineConfigS
 
 var vmwOUI = net.HardwareAddr([]byte{0x0, 0xc, 0x29})
 
-// From http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.vsphere.networking.doc%2FGUID-DC7478FF-DC44-4625-9AD7-38208C56A552.html
-// "The host generates generateMAC addresses that consists of the VMware OUI 00:0C:29 and the last three octets in hexadecimal
-//
-//	format of the virtual machine UUID.  The virtual machine UUID is based on a hash calculated by using the UUID of the
-//	ESXi physical machine and the path to the configuration file (.vmx) of the virtual machine."
+// From https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-networking-8-0/mac-addresses/mac-address-generation-on-esxi-hosts.html
+// > The host generates generateMAC addresses that consists of the VMware OUI 00:0C:29 and the last three octets in hexadecimal
+// > format of the virtual machine UUID.  The virtual machine UUID is based on a hash calculated by using the UUID of the
+// > ESXi physical machine and the path to the configuration file (.vmx) of the virtual machine.
 func (vm *VirtualMachine) generateMAC(unit int32) string {
 	id := []byte(vm.Config.Uuid)
 
diff --git a/toolbox/README.md b/toolbox/README.md
@@ -12,14 +12,14 @@ overridden and/or extended by consumers.
 
 Feature list from the perspective of vSphere public API interaction.  The properties, objects and methods listed are
 relative to
-the [VirtualMachine](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.VirtualMachine.html)
+the [VirtualMachine](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.VirtualMachine.html)
 managed object type.
 
 ### guest.toolsVersionStatus property
 
 The toolbox reports version as `guestToolsUnmanaged`.
 
-See [ToolsVersionStatus](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.GuestInfo.ToolsVersionStatus.html)
+See [ToolsVersionStatus](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.GuestInfo.ToolsVersionStatus.html)
 
 ### guest.toolsRunningStatus and guest.guestState properties
 
@@ -31,13 +31,13 @@ The VMX requests this value via the `Set_Option broadcastIP` RPC.
 
 The default value can be overridden by setting the `Service.PrimaryIP` function.
 
-See [vim.vm.GuestInfo](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.GuestInfo.html)
+See [vim.vm.GuestInfo](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.GuestInfo.html)
 
 ### guest.net property
 
 This data is pushed to the VMX using the `SendGuestInfo(INFO_IPADDRESS_V3)` RPC.
 
-See [GuestNicInfo](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.GuestInfo.NicInfo.html).
+See [GuestNicInfo](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.GuestInfo.NicInfo.html).
 
 ### ShutdownGuest and RebootGuest methods
 
@@ -47,7 +47,7 @@ The [PowerCommandHandler](power.go) provides power hooks for customized guest sh
 
 Not supported, but authentication can be customized.
 
-See [vim.vm.guest.AuthManager](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.guest.AuthManager.html)
+See [vim.vm.guest.AuthManager](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.guest.AuthManager.html)
 
 ### GuestFileManager object
 
@@ -67,7 +67,7 @@ See [vim.vm.guest.AuthManager](http://pubs.vmware.com/vsphere-60/index.jsp?topic
 | MoveDirectoryInGuest            | Yes       | [mv](https://github.com/vmware/govmomi/blob/main/govc/vm/guest/mv.go)             |
 | MoveFileInGuest                 | Yes       | [mv](https://github.com/vmware/govmomi/blob/main/govc/vm/guest/mv.go)             |
 
-See [vim.vm.guest.FileManager](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.guest.FileManager.html)
+See [vim.vm.guest.FileManager](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.guest.FileManager.html)
 
 ### GuestProcessManager
 
@@ -81,7 +81,7 @@ started by `StartProgramInGuest`.
 | StartProgramInGuest            | Yes       | [start](https://github.com/vmware/govmomi/blob/main/govc/vm/guest/start.go)       |
 | TerminateProcessInGuest        | Yes       | [kill](https://github.com/vmware/govmomi/blob/main/govc/vm/guest/kill.go)         |
 
-See [vim.vm.guest.ProcessManager](http://pubs.vmware.com/vsphere-60/index.jsp?topic=%2Fcom.vmware.wssdk.apiref.doc%2Fvim.vm.guest.ProcessManager.html)
+See [vim.vm.guest.ProcessManager](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.guest.ProcessManager.html)
 
 ## Extensions
 
diff --git a/toolbox/process/process.go b/toolbox/process/process.go
@@ -192,7 +192,7 @@ func (e *Error) Error() string {
 }
 
 // Manager manages processes within the guest.
-// See: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.vm.guest.Manager.html
+// See: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.guest.Manager.html
 type Manager struct {
 	wg      sync.WaitGroup
 	mu      sync.Mutex
@@ -271,7 +271,7 @@ func (m *Manager) Start(r *vix.StartProgramRequest, p *Process) (int64, error) {
 		m.wg.Done()
 		p.Kill() // cancel context for those waiting on p.ctx.Done()
 
-		// See: http://pubs.vmware.com/vsphere-65/topic/com.vmware.wssdk.apiref.doc/vim.vm.guest.ProcessManager.ProcessInfo.html
+		// See: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.vm.guest.ProcessManager.ProcessInfo.html
 		// "If the process was started using StartProgramInGuest then the process completion time
 		//  will be available if queried within 5 minutes after it completes."
 		<-time.After(m.expire)
diff --git a/vapi/tags/tag_association_test.go b/vapi/tags/tag_association_test.go
@@ -352,7 +352,7 @@ func getRef(t *testing.T, ctx context.Context, client *vim25.Client) (mo.Referen
 	defer v.Destroy(ctx)
 
 	// Retrieve summary property for all machines
-	// Reference: http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/vim.VirtualMachine.html
+	// Reference: https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.VirtualMachine.html
 	var vms []mo.VirtualMachine
 	err = v.Retrieve(ctx, []string{"VirtualMachine"}, []string{"summary"}, &vms)
 	if err != nil {
diff --git a/vcsim/README.md b/vcsim/README.md
@@ -395,7 +395,7 @@ To see the list of supported methods:
 curl -sk https://user:pass@127.0.0.1:8989/about
 ```
 
-[apiref]:https://code.vmware.com/apis/196/vsphere
+[apiref]:https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/
 
 ## Listen address
 

Original file line number	Diff line number	Diff line change
`@@ -38,7 +38,7 @@ func (p DistributedVirtualPortgroup) EthernetCardBackingInfo(ctx context.Context`
`38`	`38`	`return nil, err`
`39`	`39`	`}`
`40`	`40`
`41`		`- // From the docs at https://code.vmware.com/apis/196/vsphere/doc/vim.dvs.DistributedVirtualPortgroup.ConfigInfo.html:`
	`41`	`+ // From the docs at https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/vim.dvs.DistributedVirtualPortgroup.ConfigInfo.html:`
`42`	`42`	`// "This property should always be set unless the user's setting does not have System.Read privilege on the object referred to by this property."`
`43`	`43`	`// Note that "the object" refers to the Switch, not the PortGroup.`
`44`	`44`	`if dvp.Config.DistributedVirtualSwitch == nil {`