Merge pull request #273057 from vac0224/vc-resources-acs-2024-04-26

Updates

Author: v-regandowner

articles/communication-services/quickstarts/create-communication-resource.md

@@ -16,12 +16,12 @@ ms.devlang: azurecli
 ---
 # Quickstart: Create and manage Communication Services resources
 
-Get started with Azure Communication Services by provisioning your first Communication Services resource. Communication Services resources can be provisioned through the [Azure portal](https://portal.azure.com) or with the .NET management SDK. The management SDK and the Azure portal enable you to create, configure, update, and delete your resources and interface with [Azure Resource Manager](../../azure-resource-manager/management/overview.md), Azure's deployment and management service. All functions available in the SDKs are available in the Azure portal.
+Get started with Azure Communication Services by provisioning your first Communication Services resource. Communication Services resources can be provisioned through the [Azure portal](https://portal.azure.com) or using the .NET management SDK. The management SDK and the Azure portal enable you to create, configure, update, and delete your resources and interface using the new deployment and management service: [Azure Resource Manager](../../azure-resource-manager/management/overview.md). All functions available in the SDKs are available in the Azure portal.
 
 >[!VIDEO https://www.youtube.com/embed/3In3o5DhOHU]
 
 > [!WARNING]
-> Note that it is not possible to create a resource group at the same time as a resource for Azure Communication Services. When creating a resource, a resource group that has been created already, must be used.
+> Note that you can't create a resource group at the same time as a resource for Azure Communication Services. Before creating a resource, you need to first create a resource group.
 
 ::: zone pivot="platform-azp"
 [!INCLUDE [Azure portal](./includes/create-resource-azp.md)]
@@ -41,7 +41,7 @@ Get started with Azure Communication Services by provisioning your first Communi
 
 ## Access your connection strings and service endpoints
 
-Connection strings allow the Communication Services SDKs to connect and authenticate to Azure. You can access your Communication Services connection strings and service endpoints from the Azure portal or programmatically with Azure Resource Manager APIs.
+Connection strings enable the Communication Services SDKs to connect and authenticate to Azure. You can access your Communication Services connection strings and service endpoints from the Azure portal or programmatically with Azure Resource Manager APIs.
 
 After navigating to your Communication Services resource, select **Keys** from the navigation menu and copy the **Connection string** or **Endpoint** values for usage by the Communication Services SDKs. You have access to primary and secondary keys. This can be useful when you would like to provide temporary access to your Communication Services resources to a third-party or staging environment.
 
@@ -84,7 +84,7 @@ Communication Services SDKs use connection strings to authorize requests made to
 
 ### Store your connection string in an environment variable
 
-To configure an environment variable, open a console window and select your operating system from the below tabs. Replace `<yourconnectionstring>` with your actual connection string.
+To configure an environment variable, open a console window and select your operating system from the following tabs. Replace `<yourconnectionstring>` with your actual connection string.
 
 #### [Windows](#tab/windows)
 
@@ -98,29 +98,29 @@ After you add the environment variable, you may need to restart any running prog
 
 #### [macOS](#tab/unix)
 
-Edit your **`.zshrc`**, and add the environment variable:
+Edit your **`.zshrc`** file, and add the environment variable:
 
 ```bash
 export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell to access the variable.
 
 #### [Linux](#tab/linux)
 
-Edit your **`.bash_profile`**, and add the environment variable:
+Edit your **`.bash_profile`** file, and add the environment variable:
 
 ```bash
 export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell to access the variable.
 
 ---
 
 ## Clean up resources
 
-If you want to clean up and remove a Communication Services subscription, you can delete the resource or resource group. You can delete your communication resource by running the following command.
+If you want to clean up and remove a Communication Services subscription, you can delete the resource or resource group. To delete your communication resource, run the following command.
 
 ```azurecli-interactive
 az communication delete --name "acsResourceName" --resource-group "resourceGroup"

articles/communication-services/quickstarts/includes/create-resource-az-cli.md

@@ -16,7 +16,7 @@ If you're planning on using phone numbers, you can't use the free trial account.
 
 ## Create Azure Communication Services resource
 
-To create an Azure Communication Services resource, [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and providing your credentials. Run the following command to create the resource:
+To create an Azure Communication Services resource, [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and provide your credentials. Run the following command to create the resource:
 
 ```azurepowershell-interactive
 az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"
@@ -31,9 +31,9 @@ You can configure your Communication Services resource with the following option
 
 * The [resource group](../../../azure-resource-manager/management/manage-resource-groups-cli.md)
 * The name of the Communication Services resource
-* The geography the resource will be associated with
+* The geography associated with the resource
 
-In the next step, you can assign tags to the resource. Tags can be used to organize your Azure resources. For more information about tags, see the [resource tagging documentation](../../../azure-resource-manager/management/tag-resources.md).
+In the next step, you can assign tags to the resource. You can use tags to organize your Azure resources. For more information about tags, see [Use tags to organize your Azure resources and management hierarchy](../../../azure-resource-manager/management/tag-resources.md).
 
 ## Manage your Communication Services resource
 

articles/communication-services/quickstarts/includes/create-resource-azp.md

@@ -10,13 +10,13 @@ ms.author: rifox
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 
-Note that if you're planning on using phone numbers, you can't use the free trial account. Check that your subscription meets all the [requirements](../../concepts/telephony/plan-solution.md) if you plan to purchase phone numbers before creating your resource. 
+If you're planning to use phone numbers, you can't use the free trial account. Check that your subscription meets all the [requirements](../../concepts/telephony/plan-solution.md) if you plan to purchase phone numbers before creating your resource. 
 
 ## Create Azure Communication Services resource
 
 To create an Azure Communication Services resource, first sign in to the [Azure portal](https://portal.azure.com). In the upper-left corner of the page, select **+ Create a resource**. 
 
-:::image type="content" source="../media/create-a-communication-resource/create-resource-plus-sign.png" alt-text="Screenshot highlighting the create a resource button in the Azure portal.":::
+:::image type="content" source="../media/create-a-communication-resource/create-resource-plus-sign.png" alt-text="Screenshot highlighting the Create a resource button in the Azure portal.":::
 
 Enter **Communication** into either the **Search the Marketplace** input or the search bar at the top of the portal.
 
@@ -26,21 +26,21 @@ Select **Communication Services** in the results, and then select **Create**.
 
 :::image type="content" source="../media/create-a-communication-resource/create-communication-portal.png" alt-text="Screenshot showing the Communication Services panel, highlighting the Create button.":::
 
-You can now configure your Communication Services resource. On the first page in the create process, you'll be asked to specify:
+You can now configure your Communication Services resource. On the first page of the create process, you need to specify:
 
 * The subscription
 * The [resource group](../../../azure-resource-manager/management/manage-resource-groups-portal.md) (you can create a new one or choose an existing resource group)
 * The name of the Communication Services resource
-* The geography the resource will be associated with
+* The geography associated with the resource
 
-In the next step, you can assign tags to the resource. Tags can be used to organize your Azure resources. See the [resource tagging documentation](../../../azure-resource-manager/management/tag-resources.md) for more information about tags.
+In the next step, you can assign tags to the resource. You can use tags to organize your Azure resources. For more information about tags, see [Use tags to organize your Azure resources and management hierarchy](../../../azure-resource-manager/management/tag-resources.md).
 
-Finally, you can review your configuration and **Create** the resource. Note that the deployment will take a few minutes to complete.
+Finally, you can review your configuration and **Create** the resource. Deployment takes a few minutes to complete.
 
 ## Manage your Communication Services resource
 
-To manage your Communication Services resource, go to the [Azure portal](https://portal.azure.com), and search for and select **Azure Communication Services**.
+To manage your Communication Services resource, sign in to the [Azure portal](https://portal.azure.com), and search for and select **Azure Communication Services**.
 
 On the **Communication Services** page, select the name of your resource.
 
-The **Overview** page for your resource contains options for basic management like browse, stop, start, restart, and delete. You can find more configuration options in the left menu of your resource page.
+The **Overview** page for your resource contains options for basic management like browse, stop, start, restart, and delete. For more configuration options, see the left menu of your resource page.

articles/communication-services/quickstarts/includes/create-resource-net.md

@@ -13,7 +13,7 @@ ms.author: rifox
 - Get the latest version of the [.NET Identity SDK](/dotnet/api/azure.identity).
 - Get the latest version of the [.NET Management SDK](../../concepts/sdk-options.md).
 
-Note that if you're planning on using phone numbers, you can't use the free trial account. Check that your subscription meets all the [requirements](../../concepts/telephony/plan-solution.md) if you plan to purchase phone numbers before creating your resource. 
+If you're planning on using phone numbers, you can't use the free trial account. Check that your subscription meets all the [requirements](../../concepts/telephony/plan-solution.md) if you plan to purchase phone numbers before creating your resource. 
 
 ## Installing the SDK
 
@@ -25,27 +25,29 @@ using Azure.ResourceManager.Communication;
 
 ## Subscription ID
 
-You'll need to know the ID of your Azure subscription. This can be acquired from the portal:
+You need to know the ID of your Azure subscription. This can be acquired from the portal:
 
-1.  Login into your Azure account
-2.  Select Subscriptions in the left sidebar
-3.  Select whichever subscription is needed
-4.  Click on Overview
-5.  Select your Subscription ID
+1.  Sign in into your account on the [Azure portal](https://portal.azure.com).
+2.  From the left sidebar, select **Subscriptions**.
+3.  Select the subscription you want to use.
+4.  Click **Overview**.
+5.  Select your Subscription ID.
 
-In this quickstart, we'll assume that you've stored the subscription ID in an environment variable called `AZURE_SUBSCRIPTION_ID`.
+For the examples in this quickstart to work, you need to store your subscription ID in an environment variable called `AZURE_SUBSCRIPTION_ID`.
 
 ## Authentication
 
 To communicate with Azure Communication Services, you must first authenticate yourself to Azure. You'll usually do this using a service principal identity.
 
 ### Option 1: Managed Identity
 
-If your code is running as a service in Azure, the easiest way to authenticate is to acquire a managed identity from Azure. Learn more about [managed identities](/entra/identity/managed-identities-azure-resources/overview).
+If your code is running as a service in Azure, the easiest way to authenticate is to acquire a managed identity from Azure. For more information, see:
 
-[Azure services that support Managed Identities](/entra/identity/managed-identities-azure-resources/managed-identities-status)
+- [Managed identities overview](/entra/identity/managed-identities-azure-resources/overview)
 
-[How to use managed identities for App Service and Azure Functions](../../../app-service/overview-managed-identity.md?tabs=dotnet)
+- [Azure services that support Managed Identities](/entra/identity/managed-identities-azure-resources/managed-identities-status)
+
+- [How to use managed identities for App Service and Azure Functions](../../../app-service/overview-managed-identity.md?tabs=dotnet)
 
 #### [System-assigned Managed Identity](../../../app-service/overview-managed-identity.md?tabs=dotnet#add-a-system-assigned-identity)
 
@@ -76,15 +78,15 @@ var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentit
 
 ### Option 2: Service Principal
 
-Instead of using a managed identity, you may want to authenticate to Azure using a service principal that you manage yourself. Learn more using documentation on [creating and managing a service principal in Microsoft Entra ID](/entra/identity-platform/howto-create-service-principal-portal).
+Instead of using a managed identity, you may want to authenticate to Azure using a service principal that you manage yourself. For more information, see [creating and managing a service principal in Microsoft Entra ID](/entra/identity-platform/howto-create-service-principal-portal).
 
-After you've created your service principal, you'll need to collect the following information about it from the Azure portal:
+After you create your service principal, you need to collect the following information about it from the Azure portal:
 
 - **Client ID**
 - **Client Secret**
 - **Tenant ID**
 
-Store these values in environment variables named `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, and `AZURE_TENANT_ID` respectively. You can then create a Communication Services management client like this:
+Store these values as environment variables named `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, and `AZURE_TENANT_ID`, respectively. You can then create a Communication Services management client like this:
 
 ```csharp
 using Azure.Identity;
@@ -98,7 +100,7 @@ var acsClient = new CommunicationManagementClient(subscriptionId, new Environmen
 
 ### Option 3: User Identity
 
-If you want to call Azure on behalf of an interactive user, rather than using a service identity, you can use the following code to create an Azure Communication Services Management client. This will open a browser window to prompt the user for their MSA or Microsoft Entra credentials.
+If you want to call Azure on behalf of an interactive user, rather than using a service identity, you can use the following code to create an Azure Communication Services Management client. This opens a browser window to prompt the user for their MSA or Microsoft Entra credentials.
 
 ```csharp
 using Azure.Identity;
@@ -116,17 +118,17 @@ var communicationServiceClient = new CommunicationManagementClient(subscriptionI
 
 Now that you're authenticated, you can use your management client to make API calls.
 
-For each of the following examples, we'll be assigning our Communication Services resources to an existing resource group.
+For each of the following examples, we assign our Communication Services resources to an existing resource group.
 
 If you need to create a resource group, you can do so by using the [Azure portal](../../../azure-resource-manager/management/manage-resource-groups-portal.md) or the [Azure Resource Manager SDK](https://github.com/Azure/azure-sdk-for-net/blob/master/doc/mgmt_preview_quickstart.md).
 
 ### Create and manage a Communication Services resource
 
-Our instance of the Communication Services Management SDK client (``Azure.ResourceManager.Communication.CommunicationManagementClient``) can be used to perform operations on Communication Services resources.
+You can use the instance of the Communication Services Management SDK client (``Azure.ResourceManager.Communication.CommunicationManagementClient``) to perform operations on Communication Services resources.
 
 #### Create a Communication Services resource
 
-When creating a Communication Services resource, you'll specify the resource group name and resource name. Note that the `Location` property will always be `global`, and during public preview the `DataLocation` value must be `UnitedStates`.
+When creating a Communication Services resource, specify the resource group name and resource name. The `Location` property is always `global`, and during public preview the `DataLocation` value must be `UnitedStates`.
 
 ```csharp
 var resourceGroupName = "myResourceGroupName";
@@ -170,7 +172,7 @@ await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourc
 
 ## Managing keys and connection strings
 
-Every Communication Services resource has a pair of access keys and corresponding connection strings. These keys can be accessed with the Management SDK and then used by other Communication Services SDKs to authenticate themselves to Azure Communication Services.
+Every Communication Services resource has a pair of access keys and corresponding connection strings. You can access these keys using the Management SDK and then make them available to other Communication Services SDKs to authenticate themselves to Azure Communication Services.
 
 #### Get access keys for a Communication Services resource