Come gestire i tag legali
Questo articolo descrive come gestire i tag legali nell'istanza di Azure Data Manager per l'energia. Un tag legale è l'entità che rappresenta lo stato legale dei dati nell'istanza di Azure Data Manager per l'energia. Il tag legale è una raccolta di proprietà che regolano il modo in cui i dati possono essere inseriti e utilizzati. È necessario un tag legale per inserire i dati nell'istanza di Azure Data Manager per l'energia. È anche necessario per l'utilizzo dei dati dell'istanza di Azure Data Manager per l'energia. I tag legali vengono definiti singolarmente a livello di partizione dati.
Mentre nell'istanza di Azure Data Manager per l'energia, il servizio entitlement definisce l'accesso ai dati per uno o più utenti, il tag legale definisce l'accesso complessivo ai dati tra gli utenti. Un utente può avere accesso per gestire i dati all'interno di una partizione di dati, ma potrebbe non essere in grado di farlo fino a quando non vengono soddisfatti determinati requisiti legali.
Creare un tag legale
Eseguire il comando curl seguente in Azure Cloud Bash per creare un tag legale per una determinata partizione di dati dell'istanza di Azure Data Manager per l'energia.
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"
}
}'
Esempio di richiesta
Si consideri un'istanza di Azure Data Manager per l'energia denominata "medstest" con una partizione di dati denominata "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"
}
}'
Risposta di esempio
{
"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"
}
}
Il paese di origine deve seguire il formato ISO Alpha2.
L'API Crea tag legale aggiunge internamente data-partition-id al nome del tag legale, se non è già presente. Ad esempio, se la richiesta ha il nome come : legal-tag, il nome del tag di creazione legale sarà <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"
}
}'
La risposta di esempio avrà data-partition-id aggiunto al nome del tag legale e la risposta di esempio sarà:
{
"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"
}
}
Ottenere un tag legale
Eseguire il comando curl seguente in Azure Cloud Bash per ottenere il tag legale associato a una partizione di dati dell'istanza di Azure Data Manager per l'energia.
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>'
Esempio di richiesta
Si consideri un'istanza di Azure Data Manager per l'energia denominata "medstest" con una partizione di dati denominata "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.........................'
Risposta di esempio
{
"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"
}
}