Juridische tags beheren
In dit artikel weet u wat juridische tags zijn en hoe u deze kunt beheren in uw Azure Data Manager for Energy-exemplaar.
Een juridische tag is de entiteit die de juridische status van gegevensopname en rechtenservice vertegenwoordigt, definieert gebruikerstoegang tot gegevens. Een gebruiker heeft mogelijk toegang om de gegevens te beheren met rechten, maar moet voldoen aan bepaalde wettelijke vereisten met behulp van juridische tags. Juridische tag is een verzameling vereiste eigenschappen die bepalen hoe gegevens kunnen worden opgenomen in uw Azure Data Manager for Energy-exemplaar.
Met het Azure Data Manager for Energy-exemplaar kunnen alleen countryOfOrigin juridische tags worden gemaakt die zijn toegestaan volgens het configuratiebestand DefaultCountryCodes.json op gegevenspartitieniveau. OSDU heeft dit bestand gedefinieerd en u kunt het niet bewerken.
Een juridische tag maken
Voer de curl-opdracht uit in Azure Cloud Bash om een juridische tag te maken voor een bepaalde gegevenspartitie van uw Azure Data Manager for Energy-exemplaar.
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"
}
}'
Voorbeeldaanvraag
Overweeg een Azure Data Manager for Energy-exemplaar met de naam medstest gegevenspartitie '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"
}
}'
Voorbeeldrespons
{
"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"
}
}
Het land van herkomst moet de ISO Alpha2-indeling volgen.
Deze API voegt intern toe data-partition-id aan de juridische tagnaam als deze nog niet aanwezig is. Als de aanvraag bijvoorbeeld een naam heeft als: legal-tag, dan is <instancename>-<data-partition-id>-legal-tagde juridische tagnaam maken .
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"
}
}'
Het voorbeeldantwoord is data-partition-id toegevoegd aan de juridische tagnaam.
{
"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"
}
}
Een juridische tag ophalen
Voer de curl-opdracht uit in Azure Cloud Bash om de juridische tag op te halen die is gekoppeld aan een gegevenspartitie van uw Azure Data Manager for Energy-exemplaar.
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>'
Voorbeeldaanvraag
Overweeg een Azure Data Manager for Energy-exemplaar met de naam medstest gegevenspartitie '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.........................'
Voorbeeldrespons
{
"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"
}
}