Comment gérer les balises juridiques
Dans cet article, vous allez savoir quelles étiquettes légales sont et comment les gérer dans votre instance Azure Data Manager for Energy.
Une étiquette légale est l’entité qui représente l’état juridique de l’ingestion des données et service de droits d’utilisation définit l’accès utilisateur aux données. Un(e) utilisateur(-trice) peut avoir accès à la gestion des données à l’aide de droits d’utilisation, mais doit respecter certaines exigences légales à l’aide d’étiquettes légales. L’étiquette légale est une collection de propriétés requises qui régissent la façon dont les données peuvent être ingérées dans votre instance Azure Data Manager for Energy.
L’instance Azure Data Manager for Energy autorise la création d’étiquettes légales uniquement pour les countryOfOrigin autorisées conformément au fichier de configuration DefaultCountryCodes.json au niveau d’une partition de données. OSDU a défini ce fichier et vous ne pouvez pas le modifier.
Créer une étiquette juridique
Exécutez la commande curl dans Azure Cloud Bash pour créer une étiquette légale pour une partition de données spécifique de votre instance.
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.
Cette API ajoute en interne l’data-partition-id au nom de l’étiquette légale s’il n’est pas déjà présent. Par exemple, si la requête a le nom legal-tag, le nom de l’étiquette légale 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 a data-partition-id ajouté au nom d’étiquette légale.
{
"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 dans Azure Cloud Bash pour obtenir l’étiquette légale associée avec une partition de données de votre instance.
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"
}
}