Update get started and migration guide to use new client factory (Azure#20604)

* Update get started and migration guide to use new client factory

* fix

* fix

* fi

* fix

* fix

* fix

Author: Alancere

documentation/MIGRATION_GUIDE.md

@@ -58,7 +58,11 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresou
 
 ```go
 credential, err := azidentity.NewClientSecretCredential("<TenantId>", "<ClientId>", "<ClientSecret>", nil)
-client, err := armresources.NewResourceGroupsClient("<SubscriptionId>", credential, nil)
+clientFactory, err := armresources.NewClientFactory(<subscription ID>, credential, &options)
+if err != nil {
+    log.Fatal(err)
+}
+client := clientFactory.NewResourceGroupsClient()
 ```
 
 For detailed information on the benefits of using the new authentication types, please refer to [this page](https://github.com/Azure/azure-sdk-for-go/blob/main/sdk/azidentity/README.md)
@@ -111,7 +115,11 @@ options := arm.ClientOptions {
         Cloud: cloud.AzureChina,
     },
 }
-client, err := armcompute.NewVirtualMachinesClient("<SubscriptionId>", credential, &options)
+clientFactory, err := armcompute.NewClientFactory(<subscription ID>, credential, &options)
+if err != nil {
+    log.Fatal(err)
+}
+client := clientFactory.NewVirtualMachinesClient()
 ```
 
 For detailed information on the cloud configuration, please refer to [this page](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azcore/cloud)
@@ -275,7 +283,11 @@ options := &arm.ClientOptions{
         Transport: &httpClient,
     },
 }
-client, err := armresources.NewResourceGroupsClient("<SubscriptionId>", credential, options)
+clientFactory, err := armresources.NewClientFactory(<subscription ID>, credential, &options)
+if err != nil {
+    log.Fatal(err)
+}
+client := clientFactory.NewResourceGroupsClient()
 ```
 
 ## Need help?

documentation/new-version-guideline.md

@@ -152,7 +152,7 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresou
 ```
 
 ```go
-rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential,
+clientFactory, err := armresources.NewClientFactory(subscriptionId, credential,
     &arm.ClientOptions{
         ClientOptions: policy.ClientOptions{
             Retry: policy.RetryOptions{
@@ -162,6 +162,10 @@ rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential
         },
     },
 )
+if err != nil {
+    log.Fatal(err)
+}
+rgClient := clientFactory.NewResourceGroupsClient()
 ```
 
 ### Customized Policy
@@ -181,13 +185,17 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresou
 ```go
 // your own implementation of HTTP client
 httpClient := NewYourOwnHTTPClient{}
-rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential,
+clientFactory, err := armresources.NewClientFactory(subscriptionId, credential,
     &arm.ClientOptions{
         ClientOptions: policy.ClientOptions{
             Transport: &httpClient,
         },
     },
 )
+if err != nil {
+    log.Fatal(err)
+}
+rgClient := clientFactory.NewResourceGroupsClient()
 ```
 
 ### Reference
@@ -210,7 +218,7 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresou
 ```
 
 ```go
-rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential,
+clientFactory, err := armresources.NewClientFactory(subscriptionId, credential,
     &arm.ClientOptions{
         ClientOptions: policy.ClientOptions{
             Logging: policy.LogOptions{
@@ -220,6 +228,10 @@ rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential
         },
     },
 )
+if err != nil {
+    log.Fatal(err)
+}
+rgClient := clientFactory.NewResourceGroupsClient()
 ```
 
 You could use the `azcore/log` package to control log event and redirect log to the desired location. For example:

documentation/new-version-quickstart.md

@@ -107,10 +107,12 @@ cred, err := azidentity.NewDefaultAzureCredential(nil)
 
 For more details on how authentication works in `azidentity`, please see the documentation for `azidentity` at [pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azidentity](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azidentity).
 
+## Client Factory
+
 
 ## Creating a Resource Management Client
 
-Once you have a credential, you will need to decide what service to use and create a client to connect to that service. In this section, we will use `Compute` as our target service. The Compute modules consist of one or more clients. A client groups a set of related APIs, providing access to its functionality within the specified subscription. You will need to create one or more clients to access the APIs you require using your `azcore.TokenCredential`.
+Once you have a credential, you will need to decide what service to use and create a client to connect to that service. We provide a client factory which could be used to create any client in one service module. In this section, we will use `Compute` as our target service. The Compute modules consist of one or more clients. A client groups a set of related APIs, providing access to its functionality within the specified subscription. You will need to create one or more clients through the client factory to access the APIs you require using your `azcore.TokenCredential`.
 
 To show an example, we will create a client to manage Virtual Machines. The code to achieve this task would be:
 
@@ -119,7 +121,8 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute
 ```
 
 ```go
-client, err := armcompute.NewVirtualMachinesClient("<subscription ID>", credential, nil)
+computeClientFactory,err := armcompute.NewClientFactory("<subscription ID>", credential, nil)
+client := computeClientFactory.NewVirtualMachinesClient()
 ```
 You can use the same pattern to connect with other Azure services that you are using. For example, in order to manage Virtual Network resources, you would install the Network package and create a `VirtualNetwork` Client:
 
@@ -129,7 +132,8 @@ import "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork
 ```
 
 ```go
-client, err := armnetwork.NewVirtualNetworksClient("<subscription ID>", credential, nil)
+networkClientFactory,err := armnetwork.NewClientFactory("<subscription ID>", credential, nil)
+client := networkClientFactory.NewVirtualNetworksClient()
 ```
 
 ## Interacting with Azure Resources
@@ -175,16 +179,13 @@ var (
     location            = "westus2"
     resourceGroupName   = "resourceGroupName"
     interval            = 5 * time.Second
+    rgClient            *armresources.ResourceGroupsClient
 )
 ```
 
 ***Write a function to create a resource group***
 ```go
-func createResourceGroup(ctx context.Context, credential azcore.TokenCredential) (*armresources.ResourceGroupsClientCreateOrUpdateResponse, error) {
-    rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential, nil)
-    if err != nil {
-        return nil, err
-    }
+func createResourceGroup(ctx context.Context) (*armresources.ResourceGroupsClientCreateOrUpdateResponse, error) {
 
     param := armresources.ResourceGroup{
         Location: to.Ptr(location),
@@ -203,8 +204,14 @@ func main() {
     if err != nil {
         log.Fatalf("authentication failure: %+v", err)
     }
-    
-    resourceGroup, err := createResourceGroup(ctx, cred)
+	
+    clientFactory, err := armresources.NewClientFactory(subscriptionId, cred, nil)
+    if err != nil {
+        log.Fatalf("cannot create client factory: %+v", err)
+    }
+    rgClient = clientFactory.NewResourceGroupsClient()
+	
+    resourceGroup, err := createResourceGroup(ctx)
     if err != nil {
         log.Fatalf("cannot create resource group: %+v", err)
     }
@@ -219,11 +226,7 @@ Let's demonstrate management client's usage by showing additional samples.
 ***Update a resource group***
 
 ```go
-func updateResourceGroup(ctx context.Context, credential azcore.TokenCredential) (*armresources.ResourceGroupsClientUpdateResponse, error) {
-    rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential, nil)
-    if err != nil {
-        return nil, err
-    }
+func updateResourceGroup(ctx context.Context) (*armresources.ResourceGroupsClientUpdateResponse, error) {
 
     update := armresources.ResourceGroupPatchable{
         Tags: map[string]*string{
@@ -240,11 +243,7 @@ func updateResourceGroup(ctx context.Context, credential azcore.TokenCredential)
 ***List all resource groups***
 
 ```go
-func listResourceGroups(ctx context.Context, credential azcore.TokenCredential) ([]*armresources.ResourceGroup, error) {
-    rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential, nil)
-    if err != nil {
-        return nil, err
-    }
+func listResourceGroups(ctx context.Context) ([]*armresources.ResourceGroup, error) {
 
     pager := rgClient.NewListPager(nil)
 
@@ -267,11 +266,7 @@ You could see there is a pattern for pageable operation here. With `NewListPager
 ***Delete a resource group***
 
 ```go
-func deleteResourceGroup(ctx context.Context, credential azcore.TokenCredential) error {
-    rgClient, err := armresources.NewResourceGroupsClient(subscriptionId, credential, nil)
-    if err != nil {
-        return err
-    }
+func deleteResourceGroup(ctx context.Context) error {
 
     poller, err := rgClient.BeginDelete(ctx, resourceGroupName, nil)
     if err != nil {
@@ -291,25 +286,31 @@ func main() {
         log.Fatalf("authentication failure: %+v", err)
     }
 
-    resourceGroup, err := createResourceGroup(ctx, cred)
+    clientFactory, err := armresources.NewClientFactory(subscriptionId, cred, nil)
+    if err != nil {
+        log.Fatalf("cannot create client factory: %+v", err)
+    }
+    rgClient = clientFactory.NewResourceGroupsClient()
+
+    resourceGroup, err := createResourceGroup(ctx)
     if err != nil {
         log.Fatalf("cannot create resource group: %+v", err)
     }
     log.Printf("Resource Group %s created", *resourceGroup.ResourceGroup.ID)
 
-    updatedRG, err := updateResourceGroup(ctx, cred)
+    updatedRG, err := updateResourceGroup(ctx)
     if err != nil {
         log.Fatalf("cannot update resource group: %+v", err)
     }
     log.Printf("Resource Group %s updated", *updatedRG.ResourceGroup.ID)
 
-    rgList, err := listResourceGroups(ctx, cred)
+    rgList, err := listResourceGroups(ctx)
     if err != nil {
         log.Fatalf("cannot list resource group: %+v", err)
     }
     log.Printf("We totally have %d resource groups", len(rgList))
 
-    if err := deleteResourceGroup(ctx, cred); err != nil {
+    if err := deleteResourceGroup(ctx); err != nil {
         log.Fatalf("cannot delete resource group: %+v", err)
     }
     log.Printf("Resource Group deleted")