Administración de etiquetas legales
En este artículo, sabrá qué son las etiquetas legales y cómo administrarlas en la instancia de Azure Data Manager for Energy.
Una etiqueta legal es la entidad que representa el estado legal de la ingesta de datos y el servicio de derechos define el acceso de usuario a los datos. Un usuario puede tener acceso para administrar los datos mediante derechos, pero debe cumplir ciertos requisitos legales mediante etiquetas legales. La etiqueta legal es una colección de propiedades necesarias que rigen cómo se pueden ingerir datos en la instancia de Azure Data Manager for Energy.
La instancia de Azure Data Manager for Energy solo permite la creación de etiquetas legales para countryOfOrigin que se permiten según el archivo de configuración DefaultCountryCodes.json en un nivel de partición de datos. OSDU ha definido este archivo y no se puede editar.
Creación de una etiqueta legal
Ejecute el 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 o la región de origen deben seguir el formato ISO Alpha2.
Esta API anexa data-partition-id internamente al nombre de etiqueta legal si aún no está presente. 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 tiene data-partition-id anexado al nombre de etiqueta 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"
}
}
Obtener una etiqueta legal
Ejecute el 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"
}
}