Como gerenciar marcas legais
Neste artigo, você saberá como gerenciar marcas legais em sua instância do Azure Data Manager for Energy. Uma marca Legal é a entidade que representa o status legal dos dados na instância do Azure Data Manager for Energy. A tag legal é uma coleção de propriedades que rege como os dados podem ser ingeridos e consumidos. Uma marca legal é necessária para que os dados sejam ingeridos em sua instância do Azure Data Manager for Energy. Ele também é necessário para o consumo dos dados da instância do Azure Data Manager for Energy. As tags legais são definidas individualmente em um nível de partição de dados.
Enquanto na instância do Azure Data Manager for Energy, o serviço de direito define o acesso aos dados para um determinado usuário(s), 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, ele pode não ser capaz de fazer isso até que determinados requisitos legais sejam atendidos.
Criar uma marca 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"
}
}'
Solicitação de exemplo
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 de 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 Criar Tag Legal acrescenta internamente data-partition-id ao nome da tag legal se ainda não estiver presente. Por exemplo, se a solicitação tiver um nome como: legal-tag, o nome da tag legal 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 acrescentado ao nome da tag legal e a resposta de exemplo 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 tag 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>'
Solicitação de exemplo
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 de exemplo
{
"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"
}
}