Verwalten von rechtlichen Tags
In diesem Artikel erfahren Sie, was rechtliche Tags sind und wie Sie sie in Ihrer Instanz von Azure Data Manager for Energy verwalten.
Ein rechtliches Tag ist die Entität, die den rechtlichen Status der Datenerfassung darstellt. Der Berechtigungsdienst definiert den Benutzerzugriff auf Daten. Ein Benutzer hat möglicherweise über Berechtigungen Zugriff für die Verwaltung der Daten, muss jedoch bestimmte gesetzliche Anforderungen mithilfe von rechtlichen Tags erfüllen. Ein rechtliches Tag ist eine Sammlung erforderlicher Eigenschaften, die steuern, wie Daten in Ihrer Instanz von Azure Data Manager for Energy erfasst werden können.
Die Instanz von Azure Data Manager for Energy ermöglicht die Erstellung rechtlicher Tags nur für countryOfOrigin, die gemäß der Konfigurationsdatei DefaultCountryCodes.json auf Datenpartitionsebene zulässig sind. OSDU hat diese Datei definiert. Sie können sie nicht bearbeiten.
Erstellen eines rechtlichen Tags
Führen Sie den curl-Befehl in Azure Cloud Bash aus, um ein rechtliches Tag für eine bestimmte Datenpartition Ihrer Instanz von Azure Data Manager for Energy zu erstellen.
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"
}
}'
Beispielanforderung
Nehmen wir als Beispiel eine Instanz von Azure Data Manager for Energy namens medstest mit einer Datenpartition namens „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"
}
}'
Beispiel für eine Antwort
{
"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"
}
}
Das Ursprungsland bzw. die Ursprungsregion sollte im ISO-Alpha2-Format angegeben werden.
Die API fügt intern data-partition-id an den Namen des rechtlichen Tags an, wenn nicht bereits vorhanden. Wenn die Anforderung beispielsweise den Namen legal-tag hat, lautet der zu erstellende Tagname <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 der Beispielantwort wird data-partition-id an den Namen des rechtlichen Tags angefügt.
{
"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"
}
}
Abrufen eines rechtlichen Tags
Führen Sie den curl-Befehl in Azure Cloud Bash aus, um das rechtliche Tag einer Datenpartition Ihrer Instanz von Azure Data Manager for Energy zuzuweisen.
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>'
Beispielanforderung
Nehmen wir als Beispiel eine Instanz von Azure Data Manager for Energy namens medstest mit einer Datenpartition namens „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.........................'
Beispiel für eine Antwort
{
"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"
}
}