Juridische tags beheren
In dit artikel leert u hoe u juridische tags beheert in uw instantie van Azure Data Manager for Energy. Een juridische tag is de entiteit die de juridische status van gegevens in de instantie van Azure Data Manager for Energy vertegenwoordigt. Een juridische tag is een verzameling eigenschappen die bepaalt hoe gegevens kunnen worden opgenomen en verbruikt. Er is een juridische tag vereist om gegevens op te nemen in uw Azure Data Manager for Energy-exemplaar. Het is ook vereist voor het verbruik van de gegevens van uw Azure Data Manager for Energy-exemplaar. Juridische tags worden afzonderlijk gedefinieerd op gegevenspartitieniveau.
In Azure Data Manager for Energy definieert de rechtenservice de toegang tot gegevens voor een bepaalde gebruiker(en), definieert de juridische tag de algemene toegang tot de gegevens tussen gebruikers. Een gebruiker heeft mogelijk toegang tot het beheren van de gegevens binnen een gegevenspartitie, maar ze kunnen dit mogelijk niet doen totdat aan bepaalde wettelijke vereisten is voldaan.
Een juridische tag maken
Voer de onderstaande 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' met een gegevenspartitie met de naam '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.
Met de Create Legal Tag-API voegt u intern gegevenspartitie-id toe aan de juridische tagnaam als deze nog niet aanwezig is. Als de aanvraag bijvoorbeeld een naam heeft als: legal-tag, dan is de juridische tagnaam maken <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"
}
}'
In het voorbeeldantwoord wordt de gegevenspartitie-id toegevoegd aan de juridische tagnaam en het voorbeeldantwoord is:
{
"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 onderstaande 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' met een gegevenspartitie met de naam '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"
}
}