Como gerenciar tags legais
Neste artigo, você saberá como gerenciar marcas legais em seu Azure Data Manager for Energy por exemplo. Uma marca Legal é a entidade que representa o status legal dos dados na instância do Azure Data Manager for Energy. A etiqueta legal é uma coleção de propriedades que rege a forma como os dados podem ser ingeridos e consumidos. É necessária uma etiqueta legal para que os dados sejam ingeridos no Azure Data Manager for Energy, por exemplo. Também é necessário para o consumo dos dados do Azure Data Manager for Energy, por exemplo. As tags legais são definidas em um nível de partição de dados individualmente.
Enquanto no Azure Data Manager for Energy por exemplo, o serviço de direitos define o acesso aos dados para um determinado usuário, a marca legal define o acesso geral aos dados entre os usuários. Um usuário pode ter acesso para gerenciar os dados dentro de uma partição de dados, no entanto, eles podem não ser capazes de fazê-lo até que certos requisitos legais sejam cumpridos.
Criar uma etiqueta legal
Execute o comando curl abaixo no Azure Cloud Bash para criar uma marca legal para uma determinada partição de dados da sua instância do Azure Data Manager for Energy.
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"
}
}'
Pedido de amostra
Considere uma instância do Azure Data Manager for Energy chamada "medstest" com uma partição de dados chamada "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"
}
}'
Resposta da amostra
{
"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"
}
}
O país de origem deve seguir o formato ISO Alpha2.
A API Create Legal Tag anexa internamente data-partition-id ao nome da tag legal se ela ainda não estiver presente. Por exemplo, se a solicitação tiver nome como: legal-tag, então o nome da tag legal de criação será <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"
}
}'
A resposta de exemplo terá data-partition-id anexado ao nome da tag legal e a resposta de amostra será:
{
"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"
}
}
Obter uma etiqueta legal
Execute o comando curl abaixo no Azure Cloud Bash para obter a marca legal associada a uma partição de dados da sua instância do Azure Data Manager for Energy.
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>'
Pedido de amostra
Considere uma instância do Azure Data Manager for Energy chamada "medstest" com uma partição de dados chamada "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.........................'
Resposta da amostra
{
"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"
}
}