법적 태그를 관리하는 방법
이 문서에서는 Azure Data Manager for Energy 인스턴스에서 법적 태그를 관리하는 방법을 알아봅니다. 법적 태그는 Azure Data Manager for Energy 인스턴스에서 데이터의 법적 상태를 나타내는 엔터티입니다. 법적 태그는 데이터 수집 및 소비 방법을 관리하는 속성의 컬렉션입니다. 데이터를 Azure Data Manager for Energy 인스턴스로 수집하려면 법적 태그가 필요합니다. 또한 Azure Data Manager for Energy 인스턴스에서 데이터의 사용량에도 필요합니다. 법적 태그는 데이터 파티션 수준에서 개별적으로 정의됩니다.
Azure Data Manager for Energy 인스턴스에서 자격 서비스는 지정된 사용자의 데이터에 대한 액세스를 정의하고 법적 태그는 사용자 전체의 데이터에 대한 전체 액세스를 정의합니다. 사용자는 데이터 파티션 내에서 데이터를 관리할 수 있는 액세스 권한이 있을 수 있지만 특정 법적 요구 사항이 충족될 때까지 그렇게 하지 못할 수 있습니다.
법적 태그 만들기
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 for Energy 인스턴스를 고려합니다.
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 for Energy 인스턴스를 고려합니다.
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"
}
}