법적 태그를 관리하는 방법
이 문서에서는 법적 태그가 무엇이며 Azure Data Manager for Energy 인스턴스에서 태그를 관리하는 방법을 알아봅니다.
법적 태그는 데이터 수집의 법적 상태를 나타내는 엔터티이며 권한 서비스는 데이터에 대한 사용자 액세스를 정의합니다. 사용자는 자격을 사용하여 데이터를 관리할 수 있지만 법적 태그를 사용하여 특정 법적 요구 사항을 충족해야 합니다. 법적 태그는 Azure Data Manager for Energy 인스턴스에 데이터를 수집하는 방법을 제어하는 필수 속성의 컬렉션입니다.
에너지용 Azure Data Manager 인스턴스를 사용하면 데이터 파티션 수준에서 DefaultCountryCodes.json 구성 파일에 따라 허용되는 경우에만 법적 태그 countryOfOrigin 를 만들 수 있습니다. OSDU에서 이 파일을 정의했으며 편집할 수 없습니다.
법적 태그 만들기
Azure Cloud Bash에서 curl 명령을 실행하여 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"
}
}'
샘플 요청
"dp1"이라는 데이터 파티션으로 명명된 medstest 에너지용 Azure Data Manager 인스턴스를 고려합니다.
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"
}
}
법적 태그 가져오기
Azure Cloud Bash에서 curl 명령을 실행하여 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>'
샘플 요청
"dp1"이라는 데이터 파티션으로 명명된 medstest 에너지용 Azure Data Manager 인스턴스를 고려합니다.
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"
}
}