Hantera juridiska taggar

I den här artikeln får du veta vilka juridiska taggar som är och hur du hanterar dem i din Azure Data Manager for Energy-instans.

En juridisk tagg är den enhet som representerar den juridiska statusen för datainmatning och berättigandetjänsten definierar användaråtkomst till data. En användare kan ha åtkomst till att hantera data med hjälp av rättigheter men måste uppfylla vissa juridiska krav med hjälp av juridiska taggar. Juridisk tagg är en samling obligatoriska egenskaper som styr hur data kan matas in i din Azure Data Manager for Energy-instans.

Azure Data Manager for Energy-instansen tillåter endast skapande av juridiska taggar för countryOfOrigin som tillåts enligt konfigurationsfilen DefaultCountryCodes.json på datapartitionsnivå. OSDU har definierat den här filen och du kan inte redigera den.

Skapa en juridisk tagg

Kör curl-kommandot i Azure Cloud Bash för att skapa en juridisk tagg för en viss datapartition av din Azure Data Manager for Energy-instans.

    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"
        }
    }'

Exempelbegäran

Överväg en Azure Data Manager for Energy-instans med namnet medstest med en datapartition med namnet "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"
        }
    }'

Exempelsvar

    {
        "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"
    }
}

Ursprungslandet/ursprungsregionen bör följa ISO Alpha2-format.

Det här API:et lägger internt till data-partition-id det juridiska taggnamnet om det inte redan finns. Om begäran till exempel har namnet: legal-tagblir <instancename>-<data-partition-id>-legal-tagnamnet på skapa den juridiska taggen .

    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"
        }
    }'

Exempelsvaret har data-partition-id lagts till i det juridiska taggnamnet.

    {
        "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"
    }
}

Hämta en juridisk tagg

Kör curl-kommandot i Azure Cloud Bash för att hämta den juridiska taggen som är associerad med en datapartition i din Azure Data Manager for Energy-instans.

    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>'

Exempelbegäran

Överväg en Azure Data Manager for Energy-instans med namnet medstest med en datapartition med namnet "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.........................'

Exempelsvar

    {
    "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"
    }
    }

Nästa steg