Como gerenciar tags legais

Neste artigo, você saberá o que são marcas legais e como gerenciá-las em sua instância do Azure Data Manager for Energy.

Uma etiqueta legal é a entidade que representa o estatuto jurídico da ingestão de dados e o serviço de direitos define o acesso do utilizador aos dados. Um usuário pode ter acesso para gerenciar os dados usando direitos, mas precisa cumprir certos requisitos legais usando tags legais. A marca legal é uma coleção de propriedades necessárias que rege como os dados podem ser ingeridos em sua instância do Azure Data Manager for Energy.

A instância do Azure Data Manager for Energy permite a criação de marcas legais apenas para countryOfOrigin as que são permitidas de acordo com o arquivo de configuração DefaultCountryCodes.json em um nível de partição de dados. OSDU definiu este arquivo e você não pode editá-lo.

Criar uma etiqueta legal

Execute o comando curl 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 nomeada 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.

Essa API anexa internamente ao nome da data-partition-id marca legal se ela ainda não estiver presente. Por exemplo, se a solicitação tiver nome como: legal-tag, 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 foi data-partition-id anexada ao nome da marca legal.

    {
        "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 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 nomeada 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"
    }
    }

Próximos passos