Compartir a través de


Administración de etiquetas legales

En este artículo, sabrá cómo administrar etiquetas legales en la instancia de Azure Data Manager for Energy. Una etiqueta Legal es la entidad que representa el estado legal de los datos en la instancia de Azure Data Manager for Energy. La etiqueta legal es una colección de propiedades que rigen cómo se pueden ingerir y consumir datos. Se requiere una etiqueta legal para que los datos se ingieren en la instancia de Azure Data Manager for Energy. También es necesario para el consumo de los datos de la instancia de Azure Data Manager for Energy. Las etiquetas legales se definen individualmente en un nivel de partición de datos.

Mientras que en Azure Data Manager for Energy, el servicio de derechos define el acceso a los datos de un usuario determinado, la etiqueta legal define el acceso general a los datos entre los usuarios. Un usuario puede tener acceso para administrar los datos dentro de una partición de datos, pero es posible que no pueda hacerlo hasta que se cumplan ciertos requisitos legales.

Ejecute el siguiente comando curl en Azure Cloud Bash para crear una etiqueta legal para una partición de datos determinada de la instancia de 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"
        }
    }'

Solicitud de ejemplo

Considere una instancia de Azure Data Manager for Energy denominada "medstest" con una partición de datos denominada "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"
        }
    }'

Respuesta de muestra

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

El país de origen debe seguir el formato ISO Alpha2.

La API Create Legal Tag anexa internamente data-partition-id al nombre de la etiqueta legal si aún no existe. Por ejemplo, si la solicitud tiene el nombre como: legal-tag, el nombre de la etiqueta legal de creación sería <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 respuesta de ejemplo tendrá data-partition-id anexado al nombre de la etiqueta legal y la respuesta de ejemplo 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"
    }
}

Ejecute el siguiente comando curl en Azure Cloud Bash para obtener la etiqueta legal asociada a una partición de datos de la instancia de 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>'

Solicitud de ejemplo

Considere una instancia de Azure Data Manager for Energy denominada "medstest" con una partición de datos denominada "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.........................'

Respuesta de muestra

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

Pasos siguientes