Správa značek z právních důvodů
V tomto článku budete vědět, jaké právní značky jsou a jak je spravovat v instanci Azure Data Manageru pro energii.
Právní značka je entita, která představuje právní stav služby pro příjem dat a nároky, definuje uživatelský přístup k datům. Uživatel může mít přístup ke správě dat pomocí nároků, ale musí splňovat určité právní požadavky pomocí právních značek. Právní značka je kolekce požadovaných vlastností, které určují způsob příjmu dat do vaší instance Azure Data Manageru pro energii.
Instance Azure Data Manageru pro energii umožňuje vytvářet právní značky pouze pro countryOfOrigin ty, které jsou povolené podle konfiguračního souboru DefaultCountryCodes.json na úrovni datového oddílu. OSDU tento soubor definoval a nemůžete ho upravovat.
Vytvoření právní značky
Spuštěním příkazu curl v Azure Cloud Bash vytvořte právní značku pro daný datový oddíl vašeho Azure Data Manageru pro energetickou instanci.
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"
}
}'
Ukázkový požadavek
Zvažte instanci Azure Data Manageru pro energii s názvem medstest datový oddíl s názvem 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"
}
}'
Ukázková odpověď
{
"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"
}
}
Země/oblast původu by měla dodržovat formát ISO Alpha2.
Toto rozhraní API interně připojí k názvu právní značky data-partition-id , pokud ještě není k dispozici. Pokud má například požadavek název: legal-tag, pak by název vytvoření právní značky byl <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"
}
}'
Ukázková odpověď se připojila data-partition-id k názvu právní značky.
{
"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"
}
}
Získání právní značky
Spuštěním příkazu curl v Azure Cloud Bash získejte právní značku přidruženou k datovému oddílu vašeho Azure Data Manageru pro energetickou instanci.
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>'
Ukázkový požadavek
Zvažte instanci Azure Data Manageru pro energii s názvem medstest datový oddíl s názvem 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.........................'
Ukázková odpověď
{
"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"
}
}