Verwalten von rechtlichen Tags
In diesem Artikel wissen Sie, wie Sie rechtliche Tags in Ihrem Azure Data Manager für Energieinstanz verwalten. Ein Juristisches Tag ist die Entität, die den rechtlichen Status von Daten im Azure Data Manager für Energieinstanz darstellt. Das rechtliche Tag ist eine Sammlung von Eigenschaften, die steuern, wie Daten erfasst und verwendet werden können. Für daten, die in Ihrem Azure Data Manager für Energieinstanzen aufgenommen werden, ist ein rechtliches Tag erforderlich. Es ist auch für den Verbrauch der Daten aus Ihrem Azure Data Manager für Energieinstanz erforderlich. Rechtliche Tags werden auf der Ebene der einzelnen Datenpartitionen definiert.
In Azure Data Manager für Energieinstanz definiert der Berechtigungsdienst den Zugriff auf Daten für einen bestimmten Benutzer, ein rechtliches Tag definiert den gesamten Zugriff auf die Daten für alle Benutzer. Ein Benutzer kann zwar Zugriff auf die Verwaltung der Daten innerhalb einer Datenpartition erhalten, darf diese Möglichkeit jedoch nicht nutzen, solange nicht bestimmte rechtliche Anforderungen erfüllt sind.
Erstellen eines rechtlichen Tags
Führen Sie den folgenden curl-Befehl in Azure Cloud Bash aus, um ein rechtliches Tag für eine bestimmte Datenpartition Ihres Azure Data Manager für Energieinstanz 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"
}
}'
Beispiel für eine Anforderung
Betrachten Sie einen Azure Data Manager für Energieinstanz 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"
}
}'
Beispielantwort
{
"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 Herkunftsland sollte im ISO-Alpha2-Format angegeben werden.
Die API zum Erstellen von rechtlichen Tags fügt intern die Datenpartitions-ID an den Namen des rechtlichen Tags an, wenn sie nicht bereits vorhanden ist. 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"
}
}'
Bei der Beispielantwort wird die Datenpartitions-ID an den rechtlichen Tagnamen angefügt und die Beispielantwort lautet:
{
"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 folgenden curl-Befehl in Azure Cloud Bash aus, um das rechtliche Tag abzurufen, das einer Datenpartition Ihres Azure Data Manager für Energieinstanz zugeordnet ist.
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>'
Beispiel für eine Anforderung
Betrachten Sie einen Azure Data Manager für Energieinstanz 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"
}
}