Update Azure documentation links

Author: mboersma

README.md

@@ -43,7 +43,7 @@ The Azure provider is able to install and manage the [versions of Kubernetes sup
 
 #### Managed Clusters (AKS)
 
-Managed Clusters (AKS) follow their own [Kubernetes version support policy](https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#kubernetes-version-support-policy). Please use the Azure portal or CLI to [find the versions supported in your cluster's location](https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#azure-portal-and-cli-versions).
+Managed Clusters (AKS) follow their own [Kubernetes version support policy](https://learn.microsoft.com/azure/aks/supported-kubernetes-versions?tabs=azure-cli#kubernetes-version-support-policy). Please use the Azure portal or CLI to [find the versions supported in your cluster's location](https://learn.microsoft.com/azure/aks/supported-kubernetes-versions?tabs=azure-cli#azure-portal-and-cli-versions).
 
 For more information on Kubernetes version support, see the [Cluster API book](https://cluster-api.sigs.k8s.io/reference/versions.html).
 

api/v1beta1/azurecluster_validation.go

@@ -35,11 +35,11 @@ const (
 	// not using . in the name to avoid issues when the name is part of DNS name.
 	clusterNameRegex = `^[a-z0-9][a-z0-9-]{0,42}[a-z0-9]$`
 	// max length of 44 to allow for cluster name to be used as a prefix for VMs and other resources that
-	// have limitations as outlined here https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/resource-name-rules.
+	// have limitations as outlined here https://learn.microsoft.com/azure/azure-resource-manager/management/resource-name-rules.
 	clusterNameMaxLength = 44
-	// obtained from https://docs.microsoft.com/en-us/rest/api/resources/resourcegroups/createorupdate#uri-parameters.
+	// obtained from https://learn.microsoft.com/rest/api/resources/resourcegroups/createorupdate#uri-parameters.
 	resourceGroupRegex = `^[-\w\._\(\)]+$`
-	// described in https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/resource-name-rules.
+	// described in https://learn.microsoft.com/azure/azure-resource-manager/management/resource-name-rules.
 	subnetRegex       = `^[-\w\._]+$`
 	loadBalancerRegex = `^[-\w\._]+$`
 	// MaxLoadBalancerOutboundIPs is the maximum number of outbound IPs in a Standard LoadBalancer frontend configuration.
@@ -49,14 +49,14 @@ const (
 	// MaxLBIdleTimeoutInMinutes is the maximum number of minutes for the LB idle timeout.
 	MaxLBIdleTimeoutInMinutes = 30
 	// Network security rules should be a number between 100 and 4096.
-	// https://docs.microsoft.com/en-us/azure/virtual-network/network-security-groups-overview#security-rules
+	// https://learn.microsoft.com/azure/virtual-network/network-security-groups-overview#security-rules
 	minRulePriority = 100
 	maxRulePriority = 4096
 	// Must start with 'Microsoft.', then an alpha character, then can include alnum.
 	serviceEndpointServiceRegexPattern = `^Microsoft\.[a-zA-Z]{1,42}[a-zA-Z0-9]{0,42}$`
 	// Must start with an alpha character and then can include alnum OR be only *.
 	serviceEndpointLocationRegexPattern = `^([a-z]{1,42}\d{0,5}|[*])$`
-	// described in https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/resource-name-rules.
+	// described in https://learn.microsoft.com/azure/azure-resource-manager/management/resource-name-rules.
 	privateEndpointRegex = `^[-\w\._]+$`
 	// resource ID Pattern.
 	resourceIDPattern = `(?i)subscriptions/(.+)/resourceGroups/(.+)/providers/(.+?)/(.+?)/(.+)`

api/v1beta1/azuremachine_types.go

@@ -62,7 +62,7 @@ type AzureMachineSpec struct {
 	// UserAssignedIdentities is a list of standalone Azure identities provided by the user
 	// The lifecycle of a user-assigned identity is managed separately from the lifecycle of
 	// the AzureMachine.
-	// See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
+	// See https://learn.microsoft.com/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
 	// +optional
 	UserAssignedIdentities []UserAssignedIdentity `json:"userAssignedIdentities,omitempty"`
 

api/v1beta1/types.go

@@ -392,7 +392,7 @@ const (
 	// Canceled represents an action which was initiated but terminated by the user before completion.
 	Canceled ProvisioningState = "Canceled"
 	// Deleted represents a deleted VM
-	// NOTE: This state is specific to capz, and does not have corresponding mapping in Azure API (https://docs.microsoft.com/en-us/azure/virtual-machines/states-billing#provisioning-states)
+	// NOTE: This state is specific to capz, and does not have corresponding mapping in Azure API (https://learn.microsoft.com/azure/virtual-machines/states-billing#provisioning-states)
 	Deleted ProvisioningState = "Deleted"
 )
 
@@ -677,7 +677,7 @@ type DiskEncryptionSetParameters struct {
 // DiffDiskSettings describe ephemeral disk settings for the os disk.
 type DiffDiskSettings struct {
 	// Option enables ephemeral OS when set to "Local"
-	// See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details
+	// See https://learn.microsoft.com/azure/virtual-machines/ephemeral-os-disks for full details
 	// +kubebuilder:validation:Enum=Local
 	Option string `json:"option"`
 }

azure/defaults.go

@@ -285,7 +285,7 @@ func ManagedClusterID(subscriptionID, resourceGroup, managedClusterName string)
 
 // GetBootstrappingVMExtension returns the CAPZ Bootstrapping VM extension.
 // The CAPZ Bootstrapping extension is a simple clone of https://github.com/Azure/custom-script-extension-linux for Linux or
-// https://docs.microsoft.com/en-us/azure/virtual-machines/extensions/custom-script-windows for Windows.
+// https://learn.microsoft.com/azure/virtual-machines/extensions/custom-script-windows for Windows.
 // This extension allows running arbitrary scripts on the VM.
 // Its role is to detect and report Kubernetes bootstrap failure or success.
 func GetBootstrappingVMExtension(osType string, cloud string, vmName string) *ExtensionSpec {

azure/services/loadbalancers/spec.go

@@ -215,7 +215,7 @@ func getOutboundRules(lbSpec LBSpec, frontendIDs []network.SubResource) []networ
 func getLoadBalancingRules(lbSpec LBSpec, frontendIDs []network.SubResource) []network.LoadBalancingRule {
 	if lbSpec.Role == infrav1.APIServerRole {
 		// We disable outbound SNAT explicitly in the HTTPS LB rule and enable TCP and UDP outbound NAT with an outbound rule.
-		// For more information on Standard LB outbound connections see https://docs.microsoft.com/en-us/azure/load-balancer/load-balancer-outbound-connections.
+		// For more information on Standard LB outbound connections see https://learn.microsoft.com/azure/load-balancer/load-balancer-outbound-connections.
 		var frontendIPConfig network.SubResource
 		if len(frontendIDs) != 0 {
 			frontendIPConfig = frontendIDs[0]

azure/services/managedclusters/spec.go

@@ -144,7 +144,7 @@ type LoadBalancerProfile struct {
 	// Load balancer profile must specify at most one of ManagedOutboundIPs, OutboundIPPrefixes and OutboundIPs.
 	// By default the AKS cluster automatically creates a public IP in the AKS-managed infrastructure resource group and assigns it to the load balancer outbound pool.
 	// Alternatively, you can assign your own custom public IP or public IP prefix at cluster creation time.
-	// See https://docs.microsoft.com/en-us/azure/aks/load-balancer-standard#provide-your-own-outbound-public-ips-or-prefixes
+	// See https://learn.microsoft.com/azure/aks/load-balancer-standard#provide-your-own-outbound-public-ips-or-prefixes
 
 	// ManagedOutboundIPs are the desired managed outbound IPs for the cluster load balancer.
 	ManagedOutboundIPs *int32

azure/services/virtualmachineimages/client.go

@@ -56,7 +56,7 @@ func (ac *AzureClient) List(ctx context.Context, location, publisher, offer, sku
 	ctx, _, done := tele.StartSpanWithLogger(ctx, "virtualmachineimages.AzureClient.List")
 	defer done()
 
-	// See https://docs.microsoft.com/en-us/odata/concepts/queryoptions-overview for how to use these query options.
+	// See https://learn.microsoft.com/odata/concepts/queryoptions-overview for how to use these query options.
 	expand, orderby := "", ""
 	var top *int32
 	return ac.images.List(ctx, location, publisher, offer, sku, expand, top, orderby)

config/crd/bases/infrastructure.cluster.x-k8s.io_azuremachinepools.yaml

@@ -581,7 +581,7 @@ spec:
                         properties:
                           option:
                             description: Option enables ephemeral OS when set to "Local"
-                              See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks
+                              See https://learn.microsoft.com/azure/virtual-machines/ephemeral-os-disks
                               for full details
                             enum:
                             - Local
@@ -766,7 +766,7 @@ spec:
                     type: array
                   vmSize:
                     description: VMSize is the size of the Virtual Machine to build.
-                      See https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines/createorupdate#virtualmachinesizetypes
+                      See https://learn.microsoft.com/rest/api/compute/virtualmachines/createorupdate#virtualmachinesizetypes
                     type: string
                 required:
                 - osDisk
@@ -776,7 +776,7 @@ spec:
                 description: UserAssignedIdentities is a list of standalone Azure
                   identities provided by the user The lifecycle of a user-assigned
                   identity is managed separately from the lifecycle of the AzureMachinePool.
-                  See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
+                  See https://learn.microsoft.com/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
                 items:
                   description: UserAssignedIdentity defines the user-assigned identities
                     provided by the user to be assigned to Azure resources.

config/crd/bases/infrastructure.cluster.x-k8s.io_azuremachines.yaml

@@ -478,7 +478,7 @@ spec:
                     properties:
                       option:
                         description: Option enables ephemeral OS when set to "Local"
-                          See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks
+                          See https://learn.microsoft.com/azure/virtual-machines/ephemeral-os-disks
                           for full details
                         enum:
                         - Local
@@ -648,7 +648,7 @@ spec:
                 description: UserAssignedIdentities is a list of standalone Azure
                   identities provided by the user The lifecycle of a user-assigned
                   identity is managed separately from the lifecycle of the AzureMachine.
-                  See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
+                  See https://learn.microsoft.com/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
                 items:
                   description: UserAssignedIdentity defines the user-assigned identities
                     provided by the user to be assigned to Azure resources.