Como gerenciar marcas legais
Neste artigo, você saberá o que são marcas de informações legais e como gerenciá-las em sua instância do Gerenciador de Dados de Energia do Azure.
Uma marca de informações legais é a entidade que representa o status jurídico da ingestão de dados e o serviço de direito define o acesso do usuário aos dados. Um usuário pode ter acesso para gerenciar os dados usando direitos, mas precisa atender a determinados requisitos legais usando marcas de informações legais. A marca de informações legais é uma coleção de propriedades necessárias que regem como os dados podem ser ingeridos na instância do Gerenciador de Dados de Energia do Azure.
A instância do Gerenciador de Dados de Energia do Azure permite a criação de marcas de informações legais somente para countryOfOrigin que são permitidos de acordo com o arquivo de configuração DefaultCountryCodes.json em um nível de partição de dados. O OSDU definiu esse arquivo e não é possível editá-lo.
Criar uma marca legal
Execute o comando curl no Bash da Nuvem do Azure para criar uma marca de informações legais para uma determinada partição de dados da instância do Gerenciador de Dados de Energia do Azure.
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 Gerenciador de Dados de Energia do Azure 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 exemplo
{
"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/região de origem deve seguir o formato ISO Alpha2.
Essa API acrescenta data-partition-id internamente ao nome da marca de informações legais se ela ainda não estiver presente. Por exemplo, se a solicitação tiver um nome como: legal-tag, o nome da marca de informações legais 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 tem data-partition-id acrescentada ao nome da marca de informações legais.
{
"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 no Bash da Nuvem do Azure para obter a marca de informações legais associada a uma partição de dados da instância do Gerenciador de Dados de Energia do Azure.
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 Gerenciador de Dados de Energia do Azure 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"
}
}