Merge pull request #287769 from shikhagarg1/main

Update info on default country codes

Author: Jill Grant

articles/energy-data-services/how-to-manage-legal-tags.md

@@ -10,12 +10,14 @@ ms.custom: template-how-to
 ---
 
 # How to manage legal tags
-In this article, you'll know how to manage legal tags in your Azure Data Manager for Energy instance. A Legal tag is the entity that represents the legal status of data in the Azure Data Manager for Energy instance. Legal tag is a collection of properties that governs how data can be ingested and consumed. A legal tag is required for data to be [ingested](concepts-csv-parser-ingestion.md) into your Azure Data Manager for Energy instance. It's also required for the [consumption](concepts-index-and-search.md) of the data from your Azure Data Manager for Energy instance. Legal tags are defined at a data partition level individually.
+In this article, you'll know what legal tags are and how to manage them in your Azure Data Manager for Energy instance. 
 
-While in Azure Data Manager for Energy instance, [entitlement service](concepts-entitlements.md) defines access to data for a given user(s), legal tag defines the overall access to the data across users. A user may have access to manage the data within a data partition however, they may not be able to do so-until certain legal requirements are fulfilled.
+A [legal tag](https://osdu.pages.opengroup.org/platform/security-and-compliance/legal/) is the entity that represents the legal status of data ingestion and  [entitlement service](concepts-entitlements.md) defines user access to data. A user may have access to manage the data using entitlements but need to fulfill certain legal requirements using legal tags. Legal tag is a collection of required properties that governs how data can be [ingested](concepts-csv-parser-ingestion.md) into your Azure Data Manager for Energy instance.
+
+The Azure Data Manager for Energy instance allows creation of legal tags only for `countryOfOrigin` that are allowed as per the configuration file [DefaultCountryCodes.json](https://community.opengroup.org/osdu/platform/security-and-compliance/legal/-/blob/master/legal-core/src/main/resources/DefaultCountryCode.json?ref_type=heads) at a data partition level. OSDU has defined this file and you can't edit it.
 
 ## Create a legal tag
-Run the below curl command in Azure Cloud Bash to create a legal tag for a given data partition of your Azure Data Manager for Energy instance.
+Run the curl command in Azure Cloud Bash to create a legal tag for a given data partition of your Azure Data Manager for Energy instance.
 
 ```bash
     curl --location --request POST 'https://<URI>/api/legal/v1/legaltags' \
@@ -40,7 +42,7 @@ Run the below curl command in Azure Cloud Bash to create a legal tag for a given
 ```
 
 ### Sample request
-Consider an Azure Data Manager for Energy instance named "medstest" with a data partition named "dp1"
+Consider an Azure Data Manager for Energy instance named `medstest` with a data partition named "dp1":
 
 ```bash
     curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
@@ -87,7 +89,7 @@ Consider an Azure Data Manager for Energy instance named "medstest" with a data
 
 The country of origin should follow [ISO Alpha2 format](https://www.nationsonline.org/oneworld/country_code_list.htm).
 
-The Create Legal Tag api, internally appends data-partition-id to legal tag name if it isn't already present. For instance, if request has name as: ```legal-tag```, then the create legal tag name would be ```<instancename>-<data-partition-id>-legal-tag``` 
+This API internally appends `data-partition-id` to legal tag name if it isn't already present. For instance, if request has name as: ```legal-tag```, then the create legal tag name would be ```<instancename>-<data-partition-id>-legal-tag```. 
 
 ```bash
     curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
@@ -110,7 +112,7 @@ The Create Legal Tag api, internally appends data-partition-id to legal tag name
     }'
 
 ```
-The sample response will have data-partition-id appended to the legal tag name and sample response will be:
+The sample response has `data-partition-id` appended to the legal tag name.
 
 
 ```JSON
@@ -133,7 +135,7 @@ The sample response will have data-partition-id appended to the legal tag name a
 ```
 
 ## Get a legal tag
-Run the below curl command in Azure Cloud Bash to get the legal tag associated with a data partition of your Azure Data Manager for Energy instance.
+Run the curl command in Azure Cloud Bash to get the legal tag associated with a data partition of your Azure Data Manager for Energy instance.
 
 ```bash
     curl --location --request GET 'https://<URI>/api/legal/v1/legaltags/<legal-tag-name>' \
@@ -142,7 +144,7 @@ Run the below curl command in Azure Cloud Bash to get the legal tag associated w
 ```
 
 ### Sample request
-Consider an Azure Data Manager for Energy instance named "medstest" with a data partition named "dp1"
+Consider an Azure Data Manager for Energy instance named `medstest` with a data partition named "dp1":
 
 ```bash
     curl --location --request GET 'https://medstest.energy.azure.com/api/legal/v1/legaltags/medstest-dp1-legal-tag' \