Управление юридическими тегами
В этой статье вы узнаете, какие юридические теги и как управлять ими в экземпляре Azure Data Manager для энергетики.
Юридический тег — это сущность, представляющая юридическое состояние приема данных и службы прав, определяет доступ пользователей к данным. У пользователя может быть доступ к управлению данными с помощью прав, но необходимо выполнить определенные юридические требования с помощью юридических тегов. Юридический тег — это коллекция обязательных свойств, которые управляют способом приема данных в экземпляр Azure Data Manager для энергетики.
Экземпляр Azure Data Manager для энергетики позволяет создавать юридические теги только для countryOfOrigin тех, которые разрешены в DefaultCountryCodes.json файла конфигурации на уровне секции данных. OSDU определил этот файл и его невозможно изменить.
Создание юридического тега
Выполните команду 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"
}
}'
Образец запроса
Рассмотрим экземпляр medstest Azure Data Manager для энергетики с разделом данных с именем 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 внутренне добавляется data-partition-id к имени юридического тега, если он еще не присутствует. Например, если запрос имеет имя: 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"
}
}'
Пример ответа data-partition-id добавлен к имени юридического тега.
{
"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>'
Образец запроса
Рассмотрим экземпляр medstest Azure Data Manager для энергетики с разделом данных с именем 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"
}
}