法的タグを管理する方法
このアーティクルでは、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"
}
}