docs: Update various API reference links

Signed-off-by: Doug MacEachern <[email protected]>

Author: dougm

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

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 {

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 {

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 {

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 {

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

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

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 {

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

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)