Comment gérer les balises juridiques
Dans cet article, vous allez savoir comment gérer des étiquettes légales dans votre instance Azure Data Manager for Energy. Une balise juridique est l’entité qui représente l’état juridique des données dans l’instance Azure Data Manager for Energy. Une balise juridique est une collection de propriétés qui régissent la façon dont les données peuvent être ingérées et consommées. Une balise légale est requise pour que les données soient ingérées dans votre instance Azure Data Manager for Energy. Il est également nécessaire pour la consommation des données de votre instance Azure Data Manager for Energy. Les balises juridiques sont définies individuellement au niveau de la partition de données.
Dans Azure Data Manager for Energy, le service de droits d’utilisation définit l’accès aux données d’un ou plusieurs utilisateurs, mais la balise légale définit l’accès global aux données entre les utilisateurs. Un utilisateur peut avoir accès pour gérer les données au sein d’une partition de données, mais il peut ne pas être en mesure de le faire tant que certaines exigences légales ne sont pas remplies.
Créer une étiquette juridique
Exécutez la commande curl ci-dessous dans Azure Cloud Bash pour créer une balise légale pour une partition de données donnée de votre instance Azure Data Manager for Energy.
curl --location --request POST 'https://<URI>/api/legal/v1/legaltags' \
--header 'data-partition-id: <data-partition-id>' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "<legal-tag-name>",
"description": "<legal-tag-description>",
"properties": {
"contractId": "<contract-id>",
"countryOfOrigin": ["<country-of-origin>"],
"dataType": "<data-type>",
"expirationDate": "<expiration-ID>",
"exportClassification": "<export-classification>",
"originator": "<originator>",
"personalData": "<personal-data>",
"securityClassification": "Public"
}
}'
Exemple de requête
Considérez une instance Azure Data Manager for Energy nommée « medstest » avec une partition de données nommée « dp1 »
curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"contractId": "A1234",
"countryOfOrigin": ["US"],
"dataType": "Public Domain Data",
"expirationDate": "2099-01-25",
"exportClassification": "EAR99",
"originator": "MyCompany",
"personalData": "No Personal Data",
"securityClassification": "Public"
}
}'
Exemple de réponse
{
"name": "medsStest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}
Le pays d’origine doit suivre le format ISO Alpha2.
L’API Create Legal Tag ajoute en interne l’ID de partition de données au nom de balise juridique s’il n’est pas déjà présent. Par exemple, si la requête a le nom legal-tag, le nom de la balise juridique de création serait <instancename>-<data-partition-id>-legal-tag.
curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"contractId": "A1234",
"countryOfOrigin": ["US"],
"dataType": "Public Domain Data",
"expirationDate": "2099-01-25",
"exportClassification": "EAR99",
"originator": "MyCompany",
"personalData": "No Personal Data",
"securityClassification": "Public"
}
}'
L’exemple de réponse aura l’ID de partition de données ajouté au nom de la balise juridique et l’exemple de réponse sera :
{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}
Obtenir une balise juridique
Exécutez la commande curl ci-dessous dans Azure Cloud Bash pour obtenir la balise légale associée à une partition de données de votre instance Azure Data Manager for Energy.
curl --location --request GET 'https://<URI>/api/legal/v1/legaltags/<legal-tag-name>' \
--header 'data-partition-id: <data-partition-id>' \
--header 'Authorization: Bearer <access_token>'
Exemple de requête
Considérez une instance Azure Data Manager for Energy nommée « medstest » avec une partition de données nommée « dp1 »
curl --location --request GET 'https://medstest.energy.azure.com/api/legal/v1/legaltags/medstest-dp1-legal-tag' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................'
Exemple de réponse
{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}