Merge pull request #235265 from Blackmist/registry-updates-0420

Registry updates 0420

Author: v-dirichards

articles/machine-learning/how-to-manage-registries.md

@@ -1,14 +1,14 @@
 ---
 title: Create and manage registries (preview)
 titleSuffix: Azure Machine Learning
-description: Learn how create registries with the CLI, Azure portal and Azure Machine Learning Studio 
+description: Learn how create registries with the CLI, REST API, Azure portal and Azure Machine Learning studio 
 services: machine-learning
 ms.service: machine-learning
 ms.subservice: mlops
-ms.author: mabables
-author: ManojBableshwar
+ms.author: kritifaujdar
+author: fkriti
 ms.reviewer: larryfr
-ms.date: 09/21/2022
+ms.date: 04/12/2023
 ms.topic: how-to
 ms.custom: devx-track-python, ignite-2022
 ---
@@ -22,7 +22,7 @@ Azure Machine Learning entities can be grouped into two broad categories:
 
 Assets lend themselves to being stored in a central repository and used in different workspaces, possibly in different regions. Resources are workspace specific. 
 
-Azure Machine Learning registries (preview) enable you to create and use those assets in different workspaces. Registries support multi-region replication for low latency access to assets, so you can use assets in workspaces located in different Azure regions. Creating a registry will provision Azure resources required to facilitate replication. First, Azure blob storage accounts in each supported region. Second, a single Azure Container Registry with replication enabled to each supported region. 
+Azure Machine Learning registries (preview) enable you to create and use those assets in different workspaces. Registries support multi-region replication for low latency access to assets, so you can use assets in workspaces located in different Azure regions. Creating a registry provisions Azure resources required to facilitate replication. First, Azure blob storage accounts in each supported region. Second, a single Azure Container Registry with replication enabled to each supported region. 
 
 :::image type="content" source="./media/how-to-manage-registries/machine-learning-registry-block-diagram.png" alt-text="Diagram of the relationships between assets in workspace and registry.":::
 
@@ -68,8 +68,8 @@ Create the YAML definition and name it `registry.yml`.
 
 ```YAML
 name: DemoRegistry1
-description: Basic registry with one primary region and to additional regions
 tags:
+  description: Basic registry with one primary region and to additional regions
   foo: bar
 location: eastus
 replication_locations:
@@ -120,8 +120,79 @@ You can create registries in Azure Machine Learning studio using the following s
 
 1. Review the information and select __Create__.
 
+
+
+# [REST API](#tab/rest)
+
+> [!TIP]
+> You need the **curl** utility to complete this step. The **curl** program is available in the [Windows Subsystem for Linux](/windows/wsl/install-win10) or any UNIX distribution. In PowerShell, **curl** is an alias for **Invoke-WebRequest** and `curl -d "key=val" -X POST uri` becomes `Invoke-WebRequest -Body "key=val" -Method POST -Uri uri`.  
+
+To authenticate REST API calls, you need an authentication token for your Azure user account. You can use the following command to retrieve a token:
+
+```azurecli
+az account get-access-token 
+```
+
+The response should provide an access token good for one hour. Make note of the token, as you use it to authenticate all administrative requests. The following JSON is a sample response:
+
+> [!TIP]
+> The value of the `access_token` field is the token.
+
+```json
+{
+    "access_token": "YOUR-ACCESS-TOKEN",
+    "expiresOn": "<expiration-time>",
+    "subscription": "<subscription-id>",
+    "tenant": "your-tenant-id",
+    "tokenType": "Bearer"
+}
+```
+
+To create a registry, use the following command. You can edit the JSON to change the inputs as needed. Replace the `<YOUR-ACCESS-TOKEN>` value with the access token retrieved previously:
+ 
+```bash
+curl -X PUT https://management.azure.com/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/providers/Microsoft.MachineLearningServices/registries/reg-from-rest?api-version=2022-12-01-preview -H "Authorization:Bearer <YOUR-ACCESS-TOKEN>" -H 'Content-Type: application/json' -d ' 
+{
+    "properties":
+    {
+        "regionDetails": 
+        [
+            {
+                "location": "eastus",
+                "storageAccountDetails":
+                [
+                    {
+                        "systemCreatedStorageAccount": 
+                        {
+                            "storageAccountType": "Standard_LRS"
+                        }
+                    }
+                ],
+                "acrDetails": 
+                [
+                    {
+                        "systemCreatedAcrAccount":
+                        {
+                            "acrAccountSku": "Premium"
+                        }
+                    }
+                ]
+            }
+        ]
+    },
+    "identity": {
+        "type": "SystemAssigned"
+        },
+    "location": "eastus"
+}
+'
+```
+
+You should receive a `202 Accepted` response.
+
 ---
 
+
 ## Specify storage account type and SKU (optional)
 
 > [!TIP]
@@ -134,12 +205,12 @@ Next, decide if you want to use an [Azure Blob storage](../storage/blobs/storage
 > [!NOTE]
 >The `hns` portion of `storage_account_hns` refers to the [hierarchical namespace](../storage/blobs/data-lake-storage-namespace.md) capability of Azure Data Lake Storage Gen2 accounts.
 
-Below is an example YAML that demonstrates this advanced storage configuration:
+The following example YAML file demonstrates this advanced storage configuration:
 
 ```YAML
 name: DemoRegistry2
-description: Registry with additional configuration for storage accounts
 tags:
+  description: Registry with additional configuration for storage accounts
   foo: bar
 location: eastus
 replication_locations:
@@ -191,7 +262,6 @@ Permission | Description
 Microsoft.MachineLearningServices/registries/write| Allows the user to create or update registries
 Microsoft.MachineLearningServices/registries/delete | Allows the user to delete registries
 
----
 
 ## Next steps