Merge pull request #234349 from maud-lv/ml-sc-register

Clarify initial set-up

Author: v-dirichards

articles/service-connector/quickstart-cli-app-service-connection.md

@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 09/15/2022
+ms.date: 04/13/2023
 ms.devlang: azurecli
 ms.custom: event-tier1-build-2022, devx-track-azurecli
 ---
@@ -22,18 +22,27 @@ The [Azure CLI](/cli/azure) is a set of commands used to create and manage Azure
 
 - This quickstart assumes that you already have at least an App Service running on Azure. If you don't have an App Service, [create one](../app-service/quickstart-dotnetcore.md).
 
-## View supported target service types
+## Initial set-up
 
-Use the Azure CLI [az webapp connection list](/cli/azure/webapp/connection#az-webapp-connection-list) command to get a list of supported target services for App Service.
+1. If you're using Service Connector for the first time, start by running the command [az provider register](/cli/azure/provider#az-provider-register) to register the Service Connector resource provider.
 
-```azurecli-interactive
-az provider register -n Microsoft.ServiceLinker
-az webapp connection list-support-types --output table
-```
+    ```azurecli
+    az provider register -n Microsoft.ServiceLinker
+    ```
+    
+    > [!TIP]
+    > You can check if the resource provider has already been registered by running the command  `az provider show -n "Microsoft.ServiceLinker" --query registrationState`. If the output is `Registered`, then Service Connector has already been registered.
+
+
+1. Optionally, use the Azure CLI [az webapp connection list-support-types](/cli/azure/webapp/connection#az-webapp-connection-list-support-types) command to get a list of supported target services for App Service.
 
+    ```azurecli
+    az webapp connection list-support-types --output table
+    ```
+    
 ## Create a service connection
 
-#### [Using Access Key](#tab/Using-access-key)
+#### [Using an access key](#tab/Using-access-key)
 
 Use the Azure CLI [az webapp connection create](/cli/azure/webapp/connection/create) command to create a service connection to an Azure Blob Storage with an access key, providing the following information:
 
@@ -42,14 +51,14 @@ Use the Azure CLI [az webapp connection create](/cli/azure/webapp/connection/cre
 - **Target service resource group name:** the resource group name of the Blob Storage.
 - **Storage account name:** the account name of your Blob Storage.
 
-```azurecli-interactive
+```azurecli
 az webapp connection create storage-blob --secret
 ```
 
 > [!NOTE]
 > If you don't have a Blob Storage, you can run `az webapp connection create storage-blob --new --secret` to provision a new one and directly get connected to your app service.
 
-#### [Using Managed Identity](#tab/Using-Managed-Identity)
+#### [Using a managed identity](#tab/Using-Managed-Identity)
 
 > [!IMPORTANT]
 > Using Managed Identity requires you have the permission to [Azure AD role assignment](../active-directory/managed-identities-azure-resources/howto-assign-access-portal.md). If you don't have the permission, your connection creation would fail. You can ask your subscription owner for the permission or using access key to create the connection.
@@ -61,7 +70,7 @@ Use the Azure CLI [az webapp connection](/cli/azure/webapp/connection) command t
 - **Target service resource group name:** the resource group name of the Blob Storage.
 - **Storage account name:** the account name of your Blob Storage.
 
-```azurecli-interactive
+```azurecli
 az webapp connection create storage-blob --system-identity
 ```
 
@@ -77,7 +86,7 @@ Use the Azure CLI [az webapp connection](/cli/azure/webapp/connection) command t
 - **Source compute service resource group name:** the resource group name of the App Service.
 - **App Service name:** the name of your App Service that connects to the target service.
 
-```azurecli-interactive
+```azurecli
 az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table
 ```
 

articles/service-connector/quickstart-cli-container-apps.md

@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 08/09/2022
+ms.date: 04/13/2023
 ms.devlang: azurecli
 ms.custom: devx-track-azurecli
 ---
@@ -30,17 +30,20 @@ This quickstart shows you how to connect Azure Container Apps to other Cloud res
 
 - The Container Apps extension must be installed in the Azure CLI or the Cloud Shell. To install it, run `az extension add --name containerapp`.
 
-## Prepare to create a connection
+## Initial set-up
 
-1. Run the command [az provider register](/cli/azure/provider#az-provider-register) to start using Service Connector.
+1. If you're using Service Connector for the first time, start by running the command [az provider register](/cli/azure/provider#az-provider-register) to register the Service Connector resource provider.
 
-    ```azurecli-interactive
+    ```azurecli
     az provider register -n Microsoft.ServiceLinker
     ```
 
-1. Run the command `az containerapp connection` to get a list of supported target services for Container Apps.
+    > [!TIP]
+    > You can check if the resource provider has already been registered by running the command `az provider show -n "Microsoft.ServiceLinker" --query registrationState`. If the output is `Registered`, then Service Connector has already been registered.
 
-    ```azurecli-interactive
+1. Optionally, run the command [az containerapp connection list-support-types](/cli/azure/containerapp/connection#az-containerapp-connection-list-support-types) to get a list of supported target services for Container Apps.
+
+    ```azurecli
     az containerapp connection list-support-types --output table
     ```
 
@@ -52,7 +55,7 @@ You can create a connection using an access key or a managed identity.
 
 1. Run the `az containerapp connection create` command to create a service connection between Container Apps and Azure Blob Storage with an access key.
 
-    ```azurecli-interactive
+    ```azurecli
     az containerapp connection create storage-blob --secret
     ```
 
@@ -76,7 +79,7 @@ You can create a connection using an access key or a managed identity.
 
 1. Run the `az containerapp connection create` command to create a service connection from Container Apps to a Blob Storage with a system-assigned managed identity.
 
-    ```azurecli-interactive
+    ```azurecli
     az containerapp connection create storage-blob --system-identity
     ```
 
@@ -99,7 +102,7 @@ You can create a connection using an access key or a managed identity.
 
  Use the Azure CLI command `az containerapp connection list` to list all your container app's provisioned connections. Replace the placeholders `<container-app-resource-group>` and `<container-app-name>` from the command below with the resource group and name of your container app. You can also remove the `--output table` option to view more information about your connections.
 
-```azurecli-interactive
+```azurecli
 az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table
 ```
 

articles/service-connector/quickstart-cli-spring-cloud-connection.md

@@ -6,7 +6,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 08/09/2022
+ms.date: 04/13/2022
 ms.devlang: azurecli
 ms.custom: event-tier1-build-2022, devx-track-azurecli
 ---
@@ -29,17 +29,21 @@ Service Connector lets you quickly connect compute services to cloud services, w
 
 - The Azure Spring Apps extension must be installed in the Azure CLI or the Cloud Shell. To install it, run `az extension add --name spring`.
 
-## Prepare to create a connection
+## Initial set up
 
 1. If you're using Service Connector for the first time, start by running the command [az provider register](/cli/azure/provider#az-provider-register) to register the Service Connector resource provider.
 
-    ```azurecli-interactive
+    ```azurecli
     az provider register -n Microsoft.ServiceLinker
     ```
 
-1. Run the command `az spring connection` to get a list of supported target services for Azure Spring Apps.
+    > [!TIP]
+    > You can check if the resource provider has already been registered by running the command `az provider show -n "Microsoft.ServiceLinker" --query registrationState`. If the output is `Registered`, then Service Connector has already been registered.
 
-    ```azurecli-interactive
+
+1. Optionally, run the command [az spring connection list-support-types](/cli/azure/spring/connection#az-spring-connection-list-support-types) to get a list of supported target services for Azure Spring Apps.
+
+    ```azurecli
     az spring connection list-support-types --output table
     ```
 
@@ -54,7 +58,7 @@ You can create a connection from Azure Spring Apps using an access key or a mana
 
 1. Run the `az spring connection create` command to create a service connection between Azure Spring Apps and an Azure Blob Storage with an access key.
 
-    ```azurecli-interactive
+    ```azurecli
     az spring connection create storage-blob --secret
     ```