Управление юридическими тегами
В этой статье вы узнаете, как управлять юридическими тегами в экземпляре Azure Data Manager для энергетики. Юридический тег — это сущность, представляющая юридическое состояние данных в экземпляре Azure Data Manager для энергетики. Тег Legal является коллекцией свойств, которые определяют возможности для приема и потребления данных. Для приема данных в экземпляр Azure Data Manager для энергетики требуется юридический тег. Это также необходимо для потребления данных из экземпляра Azure Data Manager для энергетики. Юридические теги определяются на уровне секции данных по отдельности.
Хотя в экземпляре Azure Data Manager для энергетики служба прав определяет доступ к данным для заданных пользователей, юридический тег определяет общий доступ к данным между пользователями. Однако у пользователя может быть доступ к управлению данными в разделе данных, но они могут не выполнять это до тех пор, пока не будут выполнены определенные юридические требования.
Создание юридического тега
Выполните приведенную ниже команду curl в Azure Cloud Bash, чтобы создать юридический тег для заданной секции данных экземпляра Azure Data Manager для энергетики.
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"
}
}'
Образец запроса
Рассмотрим экземпляр Azure Data Manager для энергетики с именем medstest с разделом данных с именем 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"
}
}'
Пример ответа
{
"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"
}
}
Страна происхождения должна соответствовать формату ISO Alpha2.
Api создания юридического тега внутренне добавляет идентификатор секции данных к имени юридического тега, если он еще не присутствует. Например, если запрос имеет имя: legal-tag, то будет создано имя юридического тега. <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"
}
}'
Пример ответа будет содержать идентификатор секции данных, добавленный к имени юридического тега, а пример ответа будет следующим:
{
"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"
}
}
Получение юридического тега
Выполните приведенную ниже команду curl в Azure Cloud Bash, чтобы получить юридический тег, связанный с разделом данных экземпляра Azure Data Manager для энергетики.
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>'
Образец запроса
Рассмотрим экземпляр Azure Data Manager для энергетики с именем medstest с разделом данных с именем 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.........................'
Пример ответа
{
"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"
}
}