Hantera juridiska taggar
I den här artikeln vet du hur du hanterar juridiska taggar i din Azure Data Manager for Energy-instans. En juridisk tagg är den entitet som representerar den juridiska statusen för data i Azure Data Manager for Energy-instansen. Juridisk tagg är en samling egenskaper som styr hur data kan matas in och användas. En juridisk tagg krävs för att data ska matas in i din Azure Data Manager for Energy-instans. Det krävs också för förbrukning av data från din Azure Data Manager for Energy-instans. Juridiska taggar definieras individuellt på datapartitionsnivå.
I Azure Data Manager for Energy-instansen definierar berättigandetjänsten åtkomst till data för en viss användare, men den juridiska taggen definierar den övergripande åtkomsten till data mellan användare. En användare kan ha åtkomst till att hantera data i en datapartition, men de kanske inte kan göra det förrän vissa juridiska krav har uppfyllts.
Skapa en juridisk tagg
Kör curl-kommandot nedan i Azure Cloud Bash för att skapa en juridisk tagg för en viss datapartition av din Azure Data Manager for Energy-instans.
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"
}
}'
Exempelbegäran
Överväg en Azure Data Manager for Energy-instans med namnet "medstest" med en datapartition med namnet "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"
}
}'
Exempelsvar
{
"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"
}
}
Ursprungslandet bör följa ISO Alpha2-format.
Api:et Skapa juridisk tagg lägger internt till datapartitions-ID i det juridiska taggnamnet om det inte redan finns. Om begäran till exempel har namnet: legal-tag, blir namnet på den juridiska taggen skapad <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"
}
}'
Exempelsvaret innehåller datapartitions-ID som läggs till i det juridiska taggnamnet och exempelsvaret blir:
{
"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"
}
}
Hämta en juridisk tagg
Kör curl-kommandot nedan i Azure Cloud Bash för att hämta den juridiska taggen som är associerad med en datapartition i din Azure Data Manager for Energy-instans.
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>'
Exempelbegäran
Överväg en Azure Data Manager for Energy-instans med namnet "medstest" med en datapartition med namnet "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.........................'
Exempelsvar
{
"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"
}
}